Public smart-contract mirror for Neverland Protocol.
This repository contains the first-party Solidity contracts, interfaces, public tests, architecture context, and public address book needed to review the Neverland tokenomics, vote-escrow, revenue, oracle, leaderboard, and self-repaying vault surfaces. Operational deployment scripts, Hardhat deployment tasks, Ignition modules, generated Safe payloads, Tenderly runbooks, private audit workpapers, and hotfix workflow artifacts are intentionally outside this repository.
Monad mainnet:
- Chain ID:
143 - Network name:
monadMainnet - Address book:
deployments/mainnet/addresses.json
| Contract | Address | Purpose |
|---|---|---|
Dust proxy |
0xAD96C3dffCD6374294e2573A7fBBA96097CC8d7c |
Protocol token |
DustLock proxy |
0xBB4738D05AD1b3Da57a4881baE62Ce9bb1eEeD6C |
Vote-escrow veDUST NFT |
RevenueReward proxy |
0xff20ac10eb808B1e31F5CfCa58D80eDE2Ba71c43 |
Epoch-based revenue distribution |
DustRewardsController |
0x57ea245cCbFAb074baBb9d01d1F0c60525E52cec |
Aave-style DUST emissions controller |
DustLockTransferStrategy |
0xa966190d7BD099718110103d1778bb232Bd1661E |
DUST claim delivery and lock strategy |
UserVaultRegistry |
0x794CCdb375Ab08C340528a71Ba433a9016c657A5 |
Executor, aggregator, and slippage policy |
UserVaultFactory proxy |
0xe82f2fa836BC5DB42a36C66027c0113BcAA28143 |
Per-user vault factory |
UserVaultBeacon |
0xc9Fe3Db9b14A538FaB2eeBa33a8FeaB6ED7DdCeb |
Beacon for UserVault instances |
UserVaultImplementation |
0x0904B276a467CfCBD7B2F900aDaAAD783AEeC98F |
Current vault implementation |
NeverlandDustHelper |
0x4b80e62364Ee452e8C9d3ea342E445f515A2CD9b |
Read-only DUST price helper |
NeverlandUiProvider |
0x13B0de0a5ff282143B8777F0426F1C549D1BfFa3 |
Read-only protocol/user aggregation |
NeverlandUiEmissionLibrary |
0x8320dDcd559E5e9CA7438F11Ae8578ef99594819 |
Linked read-only emission helpers for NeverlandUiProvider |
NeverlandProfileItemsSeller |
0xcEE8d6d42a37a9d721B41CeFa16DaB7F0d0a14EB |
DUST seller for profile shop items |
DustLockLegendaryLedger |
0x367973382fa8Fc9508B5C8f4B0F9EEd462aF3185 |
Legendary-ledger lock gateway |
| Contract / Feed | Address | Purpose |
|---|---|---|
EpochManager |
0xdA27A7745CBE958B0d00268cf63394A0d09c0216 |
Leaderboard epoch lifecycle |
LeaderboardConfig |
0xDff18C7a928544449eF2Bb84c609f95427d7fcc8 |
Dynamic scoring configuration |
NFTPartnershipRegistry |
0xAB71Ce6910F255CC61fAf78EBd69A2B3dbC26Cd9 |
Partner NFT multiplier registry |
VotingPowerMultiplier |
0x9b203C61d03e64550BFbC17EF56438D1a67D80b7 |
veDUST voting-power multiplier tiers |
LeaderboardKeeper |
0x550eAaD1Ddc5Fd13Bc9818D99f985E7367D5D2B9 |
Automated leaderboard state verification and settlement |
SpecialEditionRegistry |
0x9A0231CeaB25EA0D820cfE73bFC3cd2D7681d532 |
Token-bound special edition multiplier registry |
RatioOracleAggregator-SMON |
0xF285a4B6e38151E27bBb846197707C8B9BAf8D55 |
sMON price adapter |
RatioOracleAggregator-SHMON |
0x39B76F22dcf8A93b68C72Fe2e63B3530168D0579 |
shMON price adapter |
RatioOracleAggregator-GMON |
0xbFc4Fc9376a0DA7929475379EB37DFCb9C553B9c |
gMON price adapter |
RatioOracleAggregator-EARNAUSD |
0xF25c84187a7608036b6660205B6068DBc9560dB6 |
earnAUSD price adapter |
YieldBearingOracleAdapter-LOAZND |
0x72e994F1EC71a0cdc74913534690510257e895F0 |
loAZND yield-bearing price adapter |
RatioOracleAggregator-SYZUSD |
0x4D89F82C66b8B711B9f41f8152F5AaC1694B2F6D |
sYZUSD price adapter |
HardcodedPriceOracle-loAZND-103500000 |
0x63B54daC13CD84bb92Ef24007F4E41c188f28424 |
Fixed-price loAZND feed |
PendlePtDiscountOracleAdapter-AUSD-8OCT2026 |
0x1Df73A14709FeEAc83386fd1b8099dEc4B00f789 |
Pendle PT AUSD discount oracle |
| Role / Contract | Address | Notes |
|---|---|---|
| Governance Timelock | 0x3e4749D9Df7EC5ecd9184c301592bAc058a6F82f |
Delayed lending governance and tokenomics upgrade lane |
| Risk Timelock | 0x7fa9e0E4dA21d5e92c70815B1B25F39726fD963b |
Lending RISK_ADMIN lane |
| Governance Safe | 0x57976e192C45461F5958045a0bC57102e90440eD |
Governance proposer / executor / canceller |
| Sentinel Safe | 0x06Fe1d4F4B7cA7D3d1fB3164968F0F7383D02e0E |
Direct emergency admin |
| Core ProxyAdmin | 0x6400650cED1eD7179143D40b4431c3cC8c068D90 |
Core tokenomics proxy-admin surface |
| Leaderboard ProxyAdmin | 0x400916532d9298acfFD49B826258738115CF23f1 |
Leaderboard proxy-admin surface |
| UserVaultBeacon | 0xc9Fe3Db9b14A538FaB2eeBa33a8FeaB6ED7DdCeb |
Beacon owner / upgrade surface |
| StaticAToken ProxyAdmin | 0x0cBe49645BCC84eD90A6aA4D93dfEb2Cc836F721 |
Static aToken proxy-admin surface |
git submodule update --init --recursive
yarn install
forge build
forge test
yarn hardhat compilePublic CI runs:
forge fmt --check
forge build --sizes
forge test -vvv --no-match-contract '.*Fork.*'Useful local commands:
yarn tests:foundry
forge test -v --no-match-contract '.*Fork.*'
forge test --match-contract DustLock -vv
yarn test:claim-reform:predeploy
yarn test:invariants:deep
yarn coverage
yarn tsc --noEmit --pretty falseHardhat is present for compilation and TypeChain generation only. Deployment tasks and operational scripts are not part of this public mirror.
This public mirror exposes the canonical Monad mainnet address book and the contract/test surface needed for review. Production deployment, upgrade execution, governance payload generation, Safe batch export, Tenderly simulation, and hotfix workflows are maintained outside this repository.
The repository should be read as a public architecture and validation package:
src/: first-party contract implementations and interfaces.test/: public Foundry validation surface.deployments/mainnet/addresses.json: public live-address context.ARCHITECTURE.mdandCONTEXT.md: reviewer notes for topology, trust boundaries, and production assumptions.
src/: Neverland Solidity contracts and interfaces, includingsrc/leaderboard/SpecialEditionRegistry.sol,src/oracles/HardcodedPriceOracle.sol,src/oracles/PendlePtDiscountOracleAdapter.sol,src/utils/NeverlandProfileItemsSeller.sol, andsrc/utils/libraries/NeverlandUiEmissionLibrary.sol.test/: Foundry tests organized as_utils,claim-reform,emissions,governance,leaderboard,leaderboard-keeper-coverage,libraries,oracles/{coverage,e2e,fork,invariant,unit},revenue,self-repaying-loans,tokens, andutils.config/: public read-only TypeScript configuration helpers.deployments/: public Monad mainnet address book..github/workflows/: public Foundry CI workflow.lib/: Git submodules for Foundry, OpenZeppelin, Aave, Chainlink, PRB Math, and Uniswap dependencies.ARCHITECTURE.md: protocol topology and integration-boundary overview.CONTEXT.md: durable context for humans, reviewers, and scanners.
Private deployment, upgrade, Safe, Tenderly, audit-workpaper, and hotfix operations remain outside this repository.
See LICENSE. SPDX identifiers in individual files are authoritative.
Neverland-authored code is generally licensed under Business Source License 1.1 and changes to MIT on 2028-07-20. Aave-derived reward surfaces, Uniswap-dependent helper/oracle surfaces, interfaces, tests, and upstream submodules retain their respective SPDX and upstream licenses.
Security researchers should responsibly disclose vulnerabilities to security@neverland.money.
Note: This repository is the public Neverland contracts mirror for review, testing, and architecture context. Production deployment and upgrade execution workflows are maintained outside this repository.
