THE DOCS
The complete documentation of SHAMBA LUV, mapped
every paper · every audit · every contract · every address
I. The research papers — live publications
The academic series, published on-site in full and mirrored as citable markdown. Read them in this order: the field defines, the measurement instruments, the arithmetic grounds.
🎓 EMOTONOMICS● live
The field paper. Attention as the source of value, emotion as its measure,
protocols as its distribution mechanism — lineage from Smith and Hayek through the techno-Marxist
horizon, five axioms, testable propositions, full bibliography.
read on-site →
markdown source ↗
🎭 MEASURED FEELING● live
The sentiment paper. Ninety years of measuring market emotion — animal spirits,
the VIX fear gauge, the Fear & Greed composites — and the emotonomic turn: native instruments
(GVI, CRD, eROI, sentiment.shift, the LUVchart), a proposed LUV sentiment dial, five falsifiable
propositions.
read on-site →
docs/SENTIMENT.md ↗
⚖️ THE WEI OF LUV● live
The arithmetic paper. ONE LUV was born at exactly ten wei. The uint112 genesis
seed, the LUV/ETH price denomination by denomination, gas measured in LUV, the sources of the pool's
ETH — every figure reproducible from the appendix.
read on-site →
docs/WEI_OF_LUV.md ↗
II. The whitepapers
The founding documents of the protocol and the token.
📜 EMOTONOMICS.md
The protocol whitepaper. The emotonomic model — gestures, attention credits,
impact points, the value-creation cycle — and the Proof of Gesture ledger, as the protocol states it
in its own voice.
read on GitHub ↗
❤ LUVPAPER.md
The token paper. The 111-quadrillion repunit supply, the 3/1/1 emotonomics fee,
reflections, and the tokenomic allocation — the economic constitution of LUV.
read on GitHub ↗
III. The living site
Documentation that runs: every page reads the chain and the mirror, not a brochure.
❤ the doorway● live
Connect, collect, trade — social + wallet login, the gesture dashboard, the LUV
indicators (GVI · CRD · eROI · sentiment.shift · LUVchart), and the roadmap with Phase 2 stated
as-built.
luv.pythai.net →
📈 LIVE VIEW● live
The measure of value. The single-line expression — 1T LUV in USDC, the
24-hour bar, the percent change — 5-minute candles over the 4-hour window, the X multiplier from the
ten-wei seed, the holders ledger with the dEaD burn, and the share rail.
open the live view →
💠 LUV — the price expression● live
The marketplace page. The kairos.oracle surface: the USDC-preset trillion buy,
actuals diagnostics straight from the pair, and the indicator chart (EMA ribbon, fib, RSI, MACD) —
price as the pool states it.
open →
💬 THE FAQ● live
Every question answered in place: the supply, the fees, the phases as they actually
happened, LUVbus, LUVLocker, the IncentiveDistributor, and the full contract ledger.
read the FAQ → the contract ledger →
IV. Protocol documentation
The engineering record — how each rail is built, configured, and kept honest.
📖 README
The front door of the repository. What SHAMBA LUV is, how the pieces fit, and
where everything lives.
the open repository ↗
📕 LUV.md
The complete contract guide. Every function, event, and parameter of the LUV
token — the reference manual for integrators.
read ↗
🔑 OAUTH_SETUP.md
Social login, self-hosted. The server-side OAuth architecture (Google + GitHub
live), provider expansion instructions, and the security posture of the doorway's login.
read ↗
🗝 SIGNER_VAULT.md
The LUVdrop signer vault. How the voucher key that signs EIP-712 airdrop
claims is held, rotated, and kept off the beaten path.
read ↗
V. The audits
Security is documentation too — findings, remediations, and the modernized vault.
🛡 AUDIT.md
The cryptosystem audit. Full audit and remediation of the SHAMBA LUV suite —
token, airdrop, distributor, and the platform rails.
read ↗
🔒 AUDIT_LUVLOCKER.md
The locker audit. Review of the extend-only lock vault, findings A1–A5, and
LUVLockerModern — the OpenZeppelin-v5 remediation. The standing priority: locking the
LUV/ETH liquidity position into the locker.
read ↗
LUVLockerModern.sol ↗
the LP-lock instructions ↗
VI. The contracts on mainnet
Every deployed address, every verified source — the documentation that cannot lie. Deployer and owner — the treasury signer: 0x10f7…D169.
| contract | mainnet address | source |
|---|---|---|
| ShambaLuv — the LUV tokenSHAMBA / LUV · 111-quadrillion repunit · verified source | 0x2711…8254 ↗ | ShambaLuv.sol ↗ |
| LUV / WETH pair — the marketUniswap V2 · seeded at the uint112 maximum, 2¹¹²−1 wei | 0x57D2…8a31 ↗ | UniswapV2Pair.sol ↗ |
| ShambaLuvAirdropsignature-gated claim · the Phase-1 gesture pool | 0xdf2C…DEf3 ↗ | ShambaLuvAirdrop.sol ↗ |
| IncentiveDistributorPhase-3 payout rail · on-chain action registry · fee-exempt | 0x607E…f806 ↗ | repository ↗ |
| LUVLockerextend-only lock vault · destination of the LP lock | 0xe07A…B898 ↗ | audit ↗ |
| LuvBatchGesture — the luvbusbatched community gifting · one tx, all riders | 0xc734…B4dD ↗ | repository ↗ |
| LuvLauncherthe genesis contract — deployed the token | 0xBAAc…7523 ↗ | repository ↗ |
| Create3ddeterministic CREATE3 factory — same address every chain | 0xa5A2…320A ↗ | repository ↗ |
| LuvAccountFactoryERC-4337 smart-account factory (EntryPoint v0.7) | 0xB8cb…1D09 ↗ | LuvAccountFactory.sol ↗ |
| LuvPaymasterERC-4337 gas paymaster | 0xa5Be…a68A ↗ | LuvPaymaster.sol ↗ |
| 🔥 the burn4.48% of supply, reflection-excluded, out of circulation forever | 0x…dEaD ↗ | the arithmetic → |
VII. Trade
The market, preset and ready.
🦄 TRADE LUV on Uniswap● live
Preset to ONE TRILLION LUV — a million millions, the measure of value and the
recommended minimum purchase. Set slippage to ~10% (LUV carries a 5% reflection fee) —
and thanks a million millions ❤.
open the preset swap ↗
what a trillion is worth →