Reference

Contracts

Production addresses on Robinhood Chain, what each contract does, and which address integrations should use.

Using this reference

All addresses on this page are for Robinhood Chain, chain ID 4663. Use the proxy address as the stable integration endpoint. Do not send user transactions to an implementation or ProxyAdmin address.

Per-token vault, custody, stake-vault, dividend, and Lighter account identifiers are created or resolved for each launch. They are not global addresses and must be read from the registries described below.

Core protocol endpoints

ContractProxy addressPurposeUpgrade model
Launch coordinator0xdb1e79e91340B376DFc5edADf293033902e21235Atomic Flap launch, creator purchase, vault registration, custody finalization, and fee forwarding.Transparent proxy
Strategy-vault factory0x3515650CAECe5a89225C5d5E65e3654F965bE52aPredicts, creates, and registers one strategy-vault beacon proxy per token.Transparent proxy
Launch configuration0x29AA83f1069AaC1Ed9D12C59CF7979f082Edb81cPolicy source for markets, assets, keeper, routes, fees, tax bounds, treasury, and deposit limits.Transparent proxy
Revenue router0x5f17bF4D60bCF8383e805b814F79Fdab06fAe3D5Per-token USDG accounting, 75/25 revenue split, principal, loss, profit, buyback, and dividend buckets.Transparent proxy
Keeper gateway0x5ed47040C58dF92e5ff7051fB0Cf97f85F332d27Restricted typed gateway for vault, custody, settlement, buyback, dividend, and credential operations.Transparent proxy
Quote-to-USDG normalizer0xc252Ae811ca11Dc03862ebf729C0373c6Ccd5d3fConverts registered vault revenue assets into USDG through production-approved routes.Transparent proxy
Settled-profit buyback adapter0xb385F5B250c698af3DCC7Fa709823e5d9621F34FSpends settled strategy-profit USDG to purchase launched tokens and send them to the dead address.Transparent proxy
Profit-dividend adapter0x1b1B3ed2F4AE0882f83d64E155aFE28c08728c9fConverts settled strategy profit and deposits the payout asset into the token's Flap dividend contract.Transparent proxy
Lighter custody factory0x51DdcdaDbE63fBA8B803ae8903BA53E276a4326dCreates one deterministic custody beacon proxy and Lighter master account per launched token.Transparent proxy
Strategy authority hub0xBeE1DCCf8Ae601d78BAc7185D6b24e149E605674Stores portfolios and implements Fixed, DAO, and Delegated strategy control.Transparent proxy
Protocol treasury0x3c3C08499245218999A927d6c1A2f58D73822214Accounts for protocol USDG revenue, buyback and operating budgets, and native proposal fees.Self-administered transparent proxy

Implementations and ProxyAdmins

These addresses explain the upgrade graph. They are not stable application endpoints. A proxy can continue at the same address while its implementation changes.

See Custody and security for the permissions attached to these admin contracts.

Upgradeable beacons

A beacon stores the implementation used by many per-token BeaconProxy instances. Updating a beacon changes the implementation used by every vault of that type.

BeaconAddressImplementationPurpose
Strategy-vault beacon0x72Dc7444b907F5cd382848827C01c149c94c9E540x9448E4845641F8fEd7A14C515E135531AE89A4FfImplementation source for all token strategy vaults.
Custody-account beacon0xb9Ad914D4B26923Af7702e132640D5946846Fc4a0xfcf322378F1201f0A2C4F17f6A02E840aC2fAf2aImplementation source for all token-specific Lighter custody accounts.
DAO stake-vault beacon0xea176336C1f40D0215bC6fDB4Dc68587075bfa9D0x9f5D1756EA575aA88B56C8aB99f5cc0Fd8F8033BImplementation source for DAO staking and voting vaults.

Other global contracts

Flap upgrade authority

Address: 0xdA66a339998ec2cf1ff972D769ff2b50B7Da2a65

This contract manages upgrades for the Perpetuals proxy and beacon system. Its complete permissions are listed on the security page.

Protocol buyback executor

Address: 0xd6099158CD56fc6c492C2C06076e5a2704148f58

This direct V1 deployment executes signer-authorized treasury buybacks through the production Uniswap V2 and Flap route. It is replaceable by revoking its treasury permission and authorizing another executor, so integrations should not treat it as a permanent protocol entry point.

External dependencies

DependencyAddressPerpetuals usage
Flap Portal0x26605f322f7fF986f381bB9A6e3f5DAb0bEaEb09Salt locking, swaps, and token relationship checks.
Flap VaultPortal0xe9F7AB7DE8FB8756acbB6a1cd13316a43308197BCreates the Flap token and attached strategy vault.
Flap Guardian0x0000b48720d3B4ED6BC5031768B07F2b59270000Chain-defined fallback authority for selected operating policy.
Flap Tax Token V3 template0x7777C8743C88B3aff3cf262135beF2c8b2e83333Pinned token implementation used for launch prediction and creation.
Lighter0x94bAB9693Ba2f6358507eFfcbd372b0660AFfF9dDeposits, account keys, trading, and secure withdrawals.
USDG0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168Six-decimal router accounting and Lighter collateral asset.
WETH0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73Wrapped native asset used by normalization and buyback routes.
Uniswap V2 factory0x8bcEaA40B9AcdfAedF85AdF4FF01F5Ad6517937fProduction route and pool validation.
Uniswap V2 router0x89e5DB8B5aA49aA85AC63f691524311AEB649ebaProduction quote normalization, buyback, and dividend routing.

Flap Portal, VaultPortal, Guardian, Lighter, USDG, and WETH are upgradeable or externally administered dependencies. Perpetuals pins expected runtime behavior where possible, but it does not control those external upgrade systems.

Per-token contracts

Each successful launch produces or resolves these identifiers:

IdentifierHow to resolve itPurpose
Tax Token V3Launch event and Flap PortalThe transferable launched token.
Strategy vaultStrategy-vault factory token registryReceives and normalizes the token’s vault tax share.
Lighter custodyRevenue-router registration or custody factoryOwns the token’s Lighter account and collateral path.
DAO stake vaultStrategy authority hubExists for DAO mode and holds voting stake and supported rewards.
Flap dividend contractTax token configurationAccounts for direct and deposited profit dividends.
Lighter account indexCustody account getterLocates live strategy positions in Lighter explorer.

Do not derive a per-token address from a similar launch or hardcode a canary instance. Resolve it from the canonical factory, router, or authority hub for the specific token.

Principal contract interfaces

FlapVaultLaunchCoordinatorV1
Launch transaction and exact-fee validation.
FlapStrategyVaultFactoryV1
Vault prediction, creation, validation, and registration.
FlapStrategyVaultV1
Revenue receipt, normalization, and read-only vault UI.
LaunchRevenueRouterV2
USDG allocation, principal, loss, profit, and outcomes.
LighterCustodyAccountV2
Lighter deposits, keys, secure withdrawal, and settlement.
StrategyAuthorityHubV1
Portfolios, direct authority, DAO proposals, and voting.
StakeVaultV1
Non-transferable DAO stake, checkpoints, and rewards.
ProtocolTreasuryV1
Protocol USDG and proposal-fee accounting.