LPsLux Proposals
Markets & DeFi
All Proposals
LP-3000

Lux Standard Library Registry

Implemented

Comprehensive registry of all contracts, forks, library dependencies, and deployed addresses in the Lux Standard Library

Created
2025-12-23
registrycontractsstandard-librarydefi
DiscussionsEdit on GitHub

LP-3000: Lux Standard Library Registry

Abstract

This LP provides a comprehensive registry of all contracts, forks, library dependencies, and deployed addresses in the Lux Standard Library (~/work/lux/standard). It serves as the canonical reference for all DeFi protocol contracts deployed across Lux, Zoo, and Hanzo chains.

Motivation

The Lux ecosystem requires a single source of truth for:

  • Library dependencies and their versions
  • Deployed contract addresses across all chains
  • Token registries for each network
  • Bridge and vault infrastructure
  • Precompile addresses

Standard Library Overview

Repository: https://github.com/luxfi/standard Solidity Version: 0.8.31 Framework: Foundry Test Coverage: 751 tests passing (100%)

Contract Categories

CategoryPathDescription
AMMcontracts/amm/Uniswap V2/V3 interfaces, router adapters
AIcontracts/ai/AI token and mining contracts
Bridgecontracts/bridge/Bridged stablecoins (USDC, USDT, DAI, WETH)
Governancecontracts/governance/DAO, voting, timelock contracts
Liquiditycontracts/liquidity/Oracle precompiles, price aggregation
NFTcontracts/nft/ERC721, ERC1155, marketplace contracts
Perpscontracts/perps/GMX-style perpetuals (Vault, Router, GLP)
Synthscontracts/synths/Alchemix-style synthetics (alUSD, alETH, alBTC)
Tokenscontracts/tokens/WLUX, LUX, governance tokens
Utilscontracts/utils/Libraries, helpers, abstract contracts

Library Dependencies (Git Submodules)

DeFi Protocols

LibraryPathVersionURL
Uniswap V2 Corelib/v2-coremaingithub.com/Uniswap/v2-core
Uniswap V3 Corelib/v3-coremaingithub.com/Uniswap/v3-core
Uniswap V3 Peripherylib/v3-peripherymaingithub.com/Uniswap/v3-periphery
Uniswap Liblib/uniswap-libmaingithub.com/Uniswap/uniswap-lib
Aave V3lib/aave-v3v1.19.4github.com/aave/aave-v3-core
Alchemix V2lib/alchemix-v2mastergithub.com/alchemix-finance/v2-foundry
Compoundlib/compoundv2.6-rc3github.com/compound-finance/compound-protocol
GMX Contractslib/gmx-contractsGlpManager-v2github.com/gmx-io/gmx-contracts
GMX Syntheticslib/gmx-syntheticsv2.2github.com/gmx-io/gmx-synthetics

Security & Infrastructure

LibraryPathVersionURL
OpenZeppelin Contractslib/openzeppelin-contractsv4.8.0+github.com/OpenZeppelin/openzeppelin-contracts
OpenZeppelin Upgradeablelib/openzeppelin-contracts-upgradeablev5.1.0github.com/OpenZeppelin/openzeppelin-contracts-upgradeable
Safe Smart Accountlib/safe-smart-accountv1.1.0+github.com/safe-global/safe-smart-account
Safe Moduleslib/safe-modulesallowance/v0.1.1github.com/safe-global/safe-modules
Account Abstractionlib/account-abstractionv0.9.0github.com/eth-infinitism/account-abstraction
Chainlink Contractslib/chainlink-contracts1.3.0github.com/smartcontractkit/chainlink-brownie-contracts
LayerZero V2lib/layerzero-v2anchor-v0.31.1github.com/LayerZero-Labs/LayerZero-v2

Utilities

LibraryPathVersionURL
Forge Stdlib/forge-stdmastergithub.com/foundry-rs/forge-std
Solmatelib/solmatev6+github.com/rari-capital/solmate
PRB Mathlib/prb-mathv4.1.0github.com/PaulRBerg/prb-math
Base64lib/base64v1.1.0github.com/Brechtpd/base64
Clones with Immutable Argslib/clones-with-immutable-argsmastergithub.com/wighawag/clones-with-immutable-args
Manifold XYZlib/manifoldxyzmaingithub.com/manifoldxyz/royalty-registry-solidity

Chain Configuration

Network Details

ChainChain IDNative TokenRPCExplorer
Lux Mainnet96369LUXhttps://api.lux.networkhttps://explore.lux.network
Lux Testnet96368LUXhttps://api.lux-test.networkhttps://explore.lux-test.network
Zoo Mainnet200200ZOOhttps://api.zoo.networkhttps://explore.zoo.network
Zoo Testnet200201ZOOhttps://api.zoo-test.networkhttps://explore.zoo-test.network
Hanzo Mainnet36963HANZOhttps://api.hanzo.networkhttps://explore.hanzo.network
Hanzo Testnet36962HANZOhttps://api.hanzo-test.networkhttps://explore.hanzo-test.network

Genesis Configuration (Lux Mainnet)

{
  "chainId": 96369,
  "baseFeePerGas": "0x0",
  "gasLimit": 15000000,
  "feeConfig": {
    "minBaseFee": 25000000000,
    "targetBlockRate": 2,
    "targetGas": 15000000
  },
  "treasury": "0x9011E888251AB053B7bD1cdB598Db4f9DEd94714"
}

Deployed Contracts: Lux Mainnet (96369)

Core Tokens

TokenSymbolDecimalsAddress
Wrapped LUXWLUX180x4888E4a2Ee0F03051c72D2BD3ACf755eD3498B3E
Liquid ETHLETH180x60E0a8167FC13dE89348978860466C9ceC24B9ba
Liquid USDLUSD180x848Cff46eb323f323b6Bbe1Df274E40793d7f2c2
Liquid BTCLBTC180x1E48D32a4F5e9f08DB9aE4959163300FaF8A6C8e
Liquid BNBLBNB180x6EdcF3645DeF09DB45050638c41157D8B9FEa1cf
Liquid POLLPOL180x28BfC5DD4B7E15659e41190983e5fE3df1132bB9
Liquid CELOLCELO180x3078847F879A33994cDa2Ec1540ca52b5E0eE2e5
Liquid FTMLFTM180x8B982132d639527E8a0eAAD385f97719af8f5e04
Liquid XDAILXDAI180x7dfb3cBf7CF9c96fd56e3601FBA50AF45C731211
Liquid SOLLSOL180x26B40f650156C7EbF9e087Dd0dca181Fe87625B7
Liquid TONLTON180x3141b94b89691009b950c96e97Bff48e0C543E3C
Liquid BLASTLBLAST180x94f49D0F4C62bbE4238F4AaA9200287bea9F2976
Liquid AVAXLAVAX180x0e4bD0DD67c15dECfBBBdbbE07FC9d51D737693D
Liquid ZOOLZOO180x5E5290f350352768bD2bfC59c2DA15DD04A7cB88

Uniswap V2 (AMM)

ContractAddress
V2 Factory0xD173926A10A0C4eCd3A51B1422270b65Df0551c1
V2 Router0xAe2cf1E403aAFE6C05A5b8Ef63EB19ba591d8511

Uniswap V3 (Concentrated Liquidity)

ContractAddress
V3 Factory0x80bBc7C4C7a59C899D1B37BC14539A22D5830a84
V3 Router0x939bC0Bca6F9B9c52E6e3AD8A3C590b5d9B9D10E
Quoter0x12e2B76FaF4dDA5a173a4532916bb6Bfa3645275
NonfungiblePositionManager0x7a4C48B9dae0b7c396569b34042fcA604150Ee28
TickLens0x57A22965AdA0e52D785A9Aa155beF423D573b879
Multicall0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F

Deployed Contracts: Lux Testnet (96368)

Core Tokens

TokenSymbolAddress
Liquid USDLUSD0xb84112ac9318a0b2319aa11d4d10e9762b25f7f4

Uniswap V2/V3

Same addresses as mainnet (CREATE2 deterministic deployment):

ContractAddress
V2 Factory0xD173926A10A0C4eCd3A51B1422270b65Df0551c1
V2 Router0xAe2cf1E403aAFE6C05A5b8Ef63EB19ba591d8511
V3 Factory0x80bBc7C4C7a59C899D1B37BC14539A22D5830a84
V3 Router0x939bC0Bca6F9B9c52E6e3AD8A3C590b5d9B9D10E

Deployed Contracts: Zoo Mainnet (200200)

Core Tokens

TokenSymbolDecimalsAddress
Wrapped ZOOWZOO180x4888E4a2Ee0F03051c72D2BD3ACf755eD3498B3E
Zoo ETHZETH180x60E0a8167FC13dE89348978860466C9ceC24B9ba
Zoo USDZUSD180x848Cff46eb323f323b6Bbe1Df274E40793d7f2c2
Zoo BTCZBTC180x1E48D32a4F5e9f08DB9aE4959163300FaF8A6C8e
Zoo LUXZLUX180x5E5290f350352768bD2bfC59c2DA15DD04A7cB88
Zoo BNBZBNB180x6EdcF3645DeF09DB45050638c41157D8B9FEa1cf
Zoo POLZPOL180x28BfC5DD4B7E15659e41190983e5fE3df1132bB9
Zoo CELOZCELO180x3078847F879A33994cDa2Ec1540ca52b5E0eE2e5
Zoo FTMZFTM180x8B982132d639527E8a0eAAD385f97719af8f5e04
Zoo xDAIZXDAI180x7dfb3cBf7CF9c96fd56e3601FBA50AF45C731211
Zoo SOLZSOL180x26B40f650156C7EbF9e087Dd0dca181Fe87625B7
Zoo TONZTON180x3141b94b89691009b950c96e97Bff48e0C543E3C
Zoo ADAZADA180x8b34152832b8ab4a3274915675754AA61eC113F0
Zoo AVAXZAVAX180x0EE4602429bFCEf8aEB1012F448b23532f9855Bd
Zoo BLASTZBLAST180x7a56c769C50F2e73CFB70b401409Ad1F1a5000cd

Meme Tokens (Zoo Ecosystem)

TokenSymbolDecimalsAddress
Zoo BONKZBONK180x8a873ad8CfF8ba640D71274d33a85AB1B2d53b62
Zoo WIFZWIF180x4586D49f3a32c3BeCA2e09802e0aB1Da705B011D
Zoo PopcatZPOPCAT180x68Cd9b8Df6E86dA02ef030c2F1e5a3Ad6B6d747F
Zoo PNUTZPNUT180x0e4bD0DD67c15dECfBBBdbbE07FC9d51D737693D
Zoo MEWZMEW180x94f49D0F4C62bbE4238F4AaA9200287bea9F2976
Zoo BOMEZBOME180xEf770a556430259d1244F2A1384bd1A672cE9e7F
Zoo GIGAZGIGA180xBBd222BD7dADd241366e6c2CbD5979F678598A85
Zoo AI16ZZAI16Z180x273196F2018D61E31510D1Aa1e6644955880D122
Zoo FWOGZFWOG180xd8ab3C445d81D78E7DC2d60FeC24f8C7328feF2f
Zoo MOODENGZMOODENG180xe6cd610aD16C8Fe5BCeDFff7dAB2e3d461089261
Zoo PONKEZPONKE180xDF7740fCC9B244c192CfFF7b6553a3eEee0f4898
Zoo NOTZNOT180xdfCAdda48DbbA09f5678aE31734193F7CCA7f20d
Zoo DOGSZDOGS180x0b0FF795d0A1C162b44CdC35D8f4DCbC2b4B9170
Zoo MRBZMRB180x3FfA9267739C04554C1fe640F79651333A2040e1
Zoo REDOZREDO180x137747A15dE042Cd01fCB41a5F3C7391d932750B
SlogSLOG60xED15C23B27a69b5bd50B1eeF5B8f1C8D849462b7

Uniswap V2/V3 (Zoo)

Same CREATE2 addresses as Lux:

ContractAddress
V2 Factory0xD173926A10A0C4eCd3A51B1422270b65Df0551c1
V2 Router0xAe2cf1E403aAFE6C05A5b8Ef63EB19ba591d8511
V3 Factory0x80bBc7C4C7a59C899D1B37BC14539A22D5830a84
V3 Router0x939bC0Bca6F9B9c52E6e3AD8A3C590b5d9B9D10E
Quoter0x12e2B76FaF4dDA5a173a4532916bb6Bfa3645275
NonfungiblePositionManager0x7a4C48B9dae0b7c396569b34042fcA604150Ee28
TickLens0x57A22965AdA0e52D785A9Aa155beF423D573b879
Multicall0xd25F88CBdAe3c2CCA3Bb75FC4E723b44C0Ea362F

Bridge Infrastructure

Bridge Contract Architecture

The Lux Bridge uses MPC-signed messages for cross-chain token transfers.

Core Contracts:

ContractPurposeSource
Bridge.solMain bridge contract with MPC verification~/work/lux/bridge/src/contracts/Bridge.sol
LuxVault.solERC4626 vault for Lux chain assets~/work/lux/bridge/src/contracts/LuxVault.sol
ZooVault.solERC4626 vault for Zoo chain assets~/work/lux/bridge/src/contracts/ZooVault.sol
ETHVault.solNative ETH vault~/work/lux/bridge/src/contracts/ETHVault.sol
ERC20B.solBridge-enabled ERC20 base~/work/lux/bridge/src/contracts/ERC20B.sol
LERC4626.solERC4626 tokenized vault~/work/lux/bridge/src/contracts/LERC4626.sol

Bridge Token Contracts (Lux Chain)

TokenContractSource
LETHLETH.sol~/work/lux/bridge/src/contracts/lux/LETH.sol
LUSDLUSD.sol~/work/lux/bridge/src/contracts/lux/LUSD.sol
LBTCLBTC.sol~/work/lux/bridge/src/contracts/lux/LBTC.sol
LBNBLBNB.sol~/work/lux/bridge/src/contracts/lux/LBNB.sol
LPOLLPOL.sol~/work/lux/bridge/src/contracts/lux/LPOL.sol
LCELOLCELO.sol~/work/lux/bridge/src/contracts/lux/LCELO.sol
LFTMLFTM.sol~/work/lux/bridge/src/contracts/lux/LFTM.sol
LXDAILXDAI.sol~/work/lux/bridge/src/contracts/lux/LXDAI.sol
LSOLLSOL.sol~/work/lux/bridge/src/contracts/lux/LSOL.sol
LTONLTON.sol~/work/lux/bridge/src/contracts/lux/LTON.sol
LAVAXLAVAX.sol~/work/lux/bridge/src/contracts/lux/LAVAX.sol
LBLASTLBLAST.sol~/work/lux/bridge/src/contracts/lux/LBLAST.sol
LZOOLZOO.sol~/work/lux/bridge/src/contracts/lux/LZOO.sol
LADALADA.sol~/work/lux/bridge/src/contracts/lux/LADA.sol
LAI16ZLAI16Z.sol~/work/lux/bridge/src/contracts/lux/LAI16Z.sol

Bridge Token Contracts (Zoo Chain)

TokenContractSource
ZETHZETH.sol~/work/lux/bridge/src/contracts/zoo/ZETH.sol
ZUSDZUSD.sol~/work/lux/bridge/src/contracts/zoo/ZUSD.sol
ZBTCZBTC.sol~/work/lux/bridge/src/contracts/zoo/ZBTC.sol
ZLUXZLUX.sol~/work/lux/bridge/src/contracts/zoo/ZLUX.sol
ZBNBZBNB.sol~/work/lux/bridge/src/contracts/zoo/ZBNB.sol
ZPOLZPOL.sol~/work/lux/bridge/src/contracts/zoo/ZPOL.sol
ZCELOZCELO.sol~/work/lux/bridge/src/contracts/zoo/ZCELO.sol
ZFTMZFTM.sol~/work/lux/bridge/src/contracts/zoo/ZFTM.sol
ZXDAIZXDAI.sol~/work/lux/bridge/src/contracts/zoo/ZXDAI.sol
ZSOLZSOL.sol~/work/lux/bridge/src/contracts/zoo/ZSOL.sol
ZTONZTON.sol~/work/lux/bridge/src/contracts/zoo/ZTON.sol
ZAVAXZAVAX.sol~/work/lux/bridge/src/contracts/zoo/ZAVAX.sol
ZBLASTZBLAST.sol~/work/lux/bridge/src/contracts/zoo/ZBLAST.sol
ZADAZADA.sol~/work/lux/bridge/src/contracts/zoo/ZADA.sol
ZAI16ZZAI16Z.sol~/work/lux/bridge/src/contracts/zoo/ZAI16Z.sol
ZBONKZBONK.sol~/work/lux/bridge/src/contracts/zoo/ZBONK.sol
ZWIFZWIF.sol~/work/lux/bridge/src/contracts/zoo/ZWIF.sol
ZPOPCATZPOPCAT.sol~/work/lux/bridge/src/contracts/zoo/ZPOPCAT.sol
ZPNUTZPNUT.sol~/work/lux/bridge/src/contracts/zoo/ZPNUT.sol
ZMEWZMEW.sol~/work/lux/bridge/src/contracts/zoo/ZMEW.sol
ZBOMEZBOME.sol~/work/lux/bridge/src/contracts/zoo/ZBOME.sol
ZGIGAZGIGA.sol~/work/lux/bridge/src/contracts/zoo/ZGIGA.sol
ZFWOGZFWOG.sol~/work/lux/bridge/src/contracts/zoo/ZFWOG.sol
ZMOODENGZMOODENG.sol~/work/lux/bridge/src/contracts/zoo/ZMOODENG.sol
ZPONKEZPONKE.sol~/work/lux/bridge/src/contracts/zoo/ZPONKE.sol
ZNOTZNOT.sol~/work/lux/bridge/src/contracts/zoo/ZNOT.sol
ZDOGSZDOGS.sol~/work/lux/bridge/src/contracts/zoo/ZDOGS.sol
SLOGSLOG.sol~/work/lux/bridge/src/contracts/zoo/SLOG.sol
TRUMPTRUMP.sol~/work/lux/bridge/src/contracts/zoo/TRUMP.sol
MELANIAMELANIA.sol~/work/lux/bridge/src/contracts/zoo/MELANIA.sol
CYRUSCYRUS.sol~/work/lux/bridge/src/contracts/zoo/CYRUS.sol

Bridge Key Addresses

ItemAddress
Treasury/Payout0x9011E888251AB053B7bD1cdB598Db4f9DEd94714
Bridge Fee Rate1% (100 basis points)

EVM Precompiles

Lux Standard Precompiles

PrecompileAddressDescription
ContractDeployerAllowList0x0200000000000000000000000000000000000400Deployer permissions
FeeManager0x0200000000000000000000000000000000000401Fee configuration
NativeMinter0x0200000000000000000000000000000000000402Native token minting
TxAllowList0x0200000000000000000000000000000000000403Transaction permissions
Warp0x0200000000000000000000000000000000000005Cross-chain messaging

Cryptography Precompiles

PrecompileAddressDescription
ML-DSA0x0200000000000000000000000000000000000006Post-quantum signatures
SLH-DSA0x0200000000000000000000000000000000000007Stateless hash signatures
PQCrypto0x0200000000000000000000000000000000000009Multi-PQ operations
Quasar0x020000000000000000000000000000000000000AQuantum consensus
Ringtail0x020000000000000000000000000000000000000BThreshold lattice signatures
FROST0x020000000000000000000000000000000000000CSchnorr threshold
CGGMP210x020000000000000000000000000000000000000DECDSA threshold

Oracle Precompile

PrecompileAddressDescription
Oracle0x0200000000000000000000000000000000000011Native price oracle

Oracle Sources Supported:

  • NATIVE - Lux native prices
  • CHAINLINK - Chainlink feeds
  • PYTH - Pyth Network
  • BINANCE - Binance API
  • KRAKEN - Kraken API
  • UNISWAP_V3 - TWAP from V3 pools
  • AGGREGATE - Multi-source aggregation

Standard Library Test Coverage

Total: 751 tests passing across 35 test suites (100% pass rate)

Protocol Test Suites

Test SuiteTestsStatusDescription
AITest15✅ PassAI token functionality
AIMiningTest26✅ PassGPU attestation mining
AITokenTest41✅ PassMulti-chain AI token
AMMV2Test30✅ PassUniswap V2 AMM
AMMV3Test14✅ PassConcentrated liquidity AMM
AdaptersTest31✅ PassAave/Compound/Yearn adapters
BridgeTokensTest47✅ PassL*/Z* bridge tokens
GovernanceTest37✅ PassDAO, voting, timelock
IdentityTest69✅ PassW3C DID registry
LSSVMTest32✅ PassNFT AMM (sudoswap-style)
LUXTest10✅ PassCore LUX token
LamportFoundryTest6✅ PassPost-quantum signatures
MarketsTest47✅ PassLending/borrowing markets
MarketTest26✅ PassNFT marketplace
OmnichainTest36✅ PassCross-chain messaging
PerpsTest17✅ PassPerpetual futures core
PerpsPositionTest20✅ PassPosition management
PerpsEdgeCaseTest20✅ PassEdge case coverage
StakingTest43✅ PasssLUX staking
SynthsTest14✅ PassSelf-repaying synths
SynthsEdgeCaseTest3✅ PassSynth edge cases
TreasuryTest39✅ PassFee distribution
YieldStrategiesTest30✅ PassAave/Yearn strategies
LRC1155Test22✅ PassMulti-token standard

CI/CD Status

  • GitHub Actions: ✅ Passing
  • Workflow: ci.yml (Build, Lint, Test)
  • Last Updated: 2025-12-25

Deployment Scripts

ScriptPurpose
DeployAll.s.solMaster deployment (tokens, synths, perps)
DeployAI.s.solAI token deployment
DeploySafe.s.solSafe multisig deployment
DeploySynths.s.solAlchemix synths deployment
DeployPerps.s.solGMX perps deployment
ComputeAddresses.s.solCREATE2 address prediction
Create2Deployer.solDeterministic deployment factory

LRC Token Standards Index

LRC (Lux Request for Comments) standards are Lux-native equivalents of ERC standards, optimized for the Lux ecosystem with cross-chain compatibility.

LP-3000 Series Organization

RangeCategoryDescription
3000-3019Registry & MetaStandard library registry, DeFi integrations
3020-3079LRC-20 ExtensionsFungible token standard and extensions
3080-3099ReservedFuture LRC-20 extensions
3155-3199Core StandardsLRC-165, LRC-173, LRC-1155, LRC-1271, etc.
3200-3299Storage & NFT UtilitiesNamespaced storage, NFT staking, media
3300-3399Account AbstractionSafe, AA, paymasters
3500-3599PrecompilesCryptography and VM precompiles
3600-3699VM & ChainVirtual machine, rollups, gas
3700-3799State & LRC-721Verkle, state sync, NFT standard
3800-3899Bridge & TeleportCross-chain asset standards
3900-3999Advanced StandardsMulti-token, royalties, proxies

LRC-20: Fungible Token Standard

LPStandardERC EquivalentDescription
LP-3020LRC-20ERC-20Base fungible token standard
LP-3021LRC-20-BurnableERC20BurnableToken burning capability
LP-3022LRC-20-MintableERC20MintableToken minting capability
LP-3023LRC-20-Bridgable-Cross-chain bridge support
LP-3024LRC-20-CappedERC20CappedMaximum supply cap
LP-3025LRC-20-VotesERC20VotesGovernance voting power
LP-3026LRC-20-Permit-Gasless approvals (see LP-3612)
LP-3027LRC-20-FlashMintERC20FlashMintFlash minting capability
LP-3028x402 PaymentHTTP 402Payment protocol standard
LP-3029Adoption Guide-Token standards migration guide
LP-3030LRC-20-WrapperERC20WrapperToken wrapping capability
LPStandardERC EquivalentDescription
LP-3009LRC-3009ERC-3009Transfer with authorization
LP-3612LRC-2612EIP-2612Permit extension (gasless approvals)
LP-3363LRC-1363ERC-1363Payable token callbacks
LP-3777LRC-777ERC-777Advanced token with hooks

LRC-721: Non-Fungible Token Standard

LPStandardERC EquivalentDescription
LP-3721LRC-721ERC-721Base NFT standard
LP-3722LRC-721-BurnableERC721BurnableNFT burning capability
LP-3723LRC-721-EnumerableERC721EnumerableEnumeration support
LP-3981LRC-2981ERC-2981NFT royalty standard
LP-3675LRC-4675ERC-4675Multi-fractional NFT
LP-3551LRC-6551ERC-6551Token-bound accounts

NFT Utilities

LPStandardDescription
LP-3210NFT StakingNFT staking mechanics
LP-3211Media Content NFTMedia/content NFT standard

LRC-1155: Multi-Token Standard

LPStandardERC EquivalentDescription
LP-3155LRC-1155ERC-1155Multi-token standard
LP-3157LRC-1155-SupplyERC1155SupplySupply tracking extension
LP-3909LRC-6909ERC-6909Minimal multi-token
LP-3525LRC-3525ERC-3525Semi-fungible token

LRC-4626: Tokenized Vault Standard

LPStandardERC EquivalentDescription
LP-3626LRC-4626ERC-4626Tokenized vault standard
LP-3627LRC-4626-Multi-Multi-vault extensions

Core Infrastructure Standards

LPStandardERC EquivalentDescription
LP-3165LRC-165ERC-165Interface detection
LP-3173LRC-173ERC-173Contract ownership
LP-3156LRC-3156ERC-3156Flash loans
LP-3271LRC-1271ERC-1271Signature validation
LP-3201LRC-7201ERC-7201Namespaced storage layout
LP-3967LRC-1967ERC-1967Proxy storage slots
LP-3169LRC-5169ERC-5169Client script URI
LP-3572LRC-7572ERC-7572Contract-level metadata
LP-3528LRC-5528ERC-5528Refundable token

Account Abstraction Standards

LPStandardERC EquivalentDescription
LP-3337LRC-4337ERC-4337Account abstraction
LP-3338PaymasterERC-4337Paymaster standard
LP-3579LRC-7579ERC-7579Modular smart accounts
LP-3310Safe Multisig-Safe multisig standard
LP-3320Lamport-Safe-Post-quantum Safe signatures

Soulbound & Identity Standards

LPStandardERC EquivalentDescription
LP-3192LRC-5192ERC-5192Soulbound tokens
LP-10093DIDW3C DIDDecentralized identity

Bridge & Cross-Chain Standards

LPStandardDescription
LP-3800Bridged AssetBridge token standard (L*/Z* tokens)
LP-3810Teleport TokenWarp-based cross-chain tokens
LP-3820L2 AscensionL2 to sovereign L1 migration

Precompile Standards

LPStandardAddressDescription
LP-3500ML-DSA0x...0006Post-quantum signatures
LP-3501SLH-DSA0x...0007Stateless hash signatures
LP-3502ML-DSA-2-Extended PQ signatures
LP-3503Quasar0x...000AQuantum consensus
LP-3510Warp0x...0005Cross-chain messaging
LP-3511Fee Manager0x...0401Dynamic fees
LP-3512Warp-2-Enhanced Warp messaging
LP-3520Suite Overview-Precompile suite index
LP-3550Verkle Proof-Verkle tree proofs
LP-3651secp256r1-P-256 curve support
LP-3652secp256k1-ECDSA precompile
LP-3653BLS12-381-BLS cryptography
LP-3654Ed25519-EdDSA signatures
LP-3655SHA3/Keccak-Hash functions
LP-3656BLAKE2/3-BLAKE hash family
LP-3657VRF-Verifiable random function
LP-3658Poseidon-ZK-friendly hash
LP-3659ChaCha20-Symmetric encryption
LP-3662HPKE-Hybrid public key encryption
LP-3663ECIES-Elliptic curve encryption
LP-3664Ring Signatures-Privacy signatures
LP-3665KZG-4844-Blob commitments

VM & Execution Standards

LPStandardDescription
LP-3600VM EnvironmentVirtual machine specification
LP-3601VM SDKVM development kit
LP-3610AIVMAI virtual machine
LP-3620Rollup PluginC-Chain rollup architecture
LP-3621Stage SyncSync pipeline for Coreth
LP-3630RNGRandom number generation
LP-3640Upgrade MappingC-Chain upgrade mapping
LP-3641ChainVM CompatChainVM compatibility
LP-3650Dynamic GasDynamic gas pricing
LP-3652Min Block TimesDynamic minimum block times
LP-3653Gas LimitDynamic EVM gas limits
LP-3660State MigrationNetwork upgrade migration
LP-3661BadgerDB VerkleDatabase optimization
LP-3670EOA CodeEOA account code
LP-3671EL RequestsExecution layer requests
LP-3672Max BalanceMax effective balance
LP-3673Calldata CostCalldata cost increase
LP-3674Blob ThroughputBlob throughput increase
LP-3680CLZ OpcodeCount leading zeros

State Management Standards

LPStandardDescription
LP-3700State SyncState sync and pruning
LP-3701Verkle TreesVerkle state management
LP-3702Verkle TransitionVerkle state transition
LP-3703Stateless GasStatelessness gas costs
LP-3704Block HashesHistorical block hashes
LPTitle
LP-6016Teleport Cross-Chain Protocol
LP-6332Teleport Bridge Architecture
LP-7325KMS Hardware Security Module Integration
LP-9000DEX Core Specification
LP-9011Oracle Precompile
LP-9100QuantumSwap DEX Standard

Historical Notes

Chain ID History

  • Original Chain ID: 7777 (Lux mainnet launch)
  • 2024 Reboot: Changed to 96369 due to EIP overlap
  • Historical Data: Preserved at github.com/luxfi/state

State Repository

The ~/work/lux/state repository contains:

  • Genesis configurations for all networks
  • Historical block data exports
  • Database configs (PebbleDB format)
  • Migration scripts and tools

Appendix: Full Submodule Commit Hashes

782f5191 lib/aave-v3 (v1.19.4-1)
b36a1ed5 lib/account-abstraction (v0.9.0)
8915ef7b lib/alchemix-v2 (heads/master)
dcbf852b lib/base64 (v1.1.0)
67887b84 lib/chainlink-contracts (1.3.0-8)
196f1ecc lib/clones-with-immutable-args (heads/master)
a3214f67 lib/compound (v2.6-rc3-45)
3f999523 lib/forge-std (heads/master)
fe55c4ba lib/gmx-contracts (GlpManager-v2-676)
3b9e1399 lib/gmx-synthetics (v2.2-533)
ab9b0834 lib/layerzero-v2 (anchor-v0.31.1-3)
8e3ade55 lib/manifoldxyz (heads/main)
69c8def5 lib/openzeppelin-contracts (v4.8.0-743)
fa525310 lib/openzeppelin-contracts-upgradeable (v5.1.0)
130e0b93 lib/prb-math (v4.1.0-23)
88629b3d lib/safe-modules (allowance/v0.1.1-12)
02276647 lib/safe-smart-account (v1.1.0-751)
89365b88 lib/solmate (v6-207)
c01640b0 lib/uniswap-lib (heads/master)
ee547b17 lib/v2-core (heads/master)
d8b1c635 lib/v3-core (heads/main)
06823871 lib/v3-periphery (heads/main)

Document Maintainer: Lux Industries Last Updated: 2025-12-25

LP-1136: X-Chain Order-Book DEX API & RPC Addendu...

Previous Page

LP-9109: Compound Lending Protocol Standard

Next Page

On this page

AbstractMotivationStandard Library OverviewContract CategoriesLibrary Dependencies (Git Submodules)DeFi ProtocolsSecurity & InfrastructureUtilitiesChain ConfigurationNetwork DetailsGenesis Configuration (Lux Mainnet)Deployed Contracts: Lux Mainnet (96369)Core TokensUniswap V2 (AMM)Uniswap V3 (Concentrated Liquidity)Deployed Contracts: Lux Testnet (96368)Core TokensUniswap V2/V3Deployed Contracts: Zoo Mainnet (200200)Core TokensMeme Tokens (Zoo Ecosystem)Uniswap V2/V3 (Zoo)Bridge InfrastructureBridge Contract ArchitectureBridge Token Contracts (Lux Chain)Bridge Token Contracts (Zoo Chain)Bridge Key AddressesEVM PrecompilesLux Standard PrecompilesCryptography PrecompilesOracle PrecompileStandard Library Test CoverageProtocol Test SuitesCI/CD StatusDeployment ScriptsLRC Token Standards IndexLP-3000 Series OrganizationLRC-20: Fungible Token StandardLRC-20 Related StandardsLRC-721: Non-Fungible Token StandardNFT UtilitiesLRC-1155: Multi-Token StandardLRC-4626: Tokenized Vault StandardCore Infrastructure StandardsAccount Abstraction StandardsSoulbound & Identity StandardsBridge & Cross-Chain StandardsPrecompile StandardsVM & Execution StandardsState Management StandardsRelated LPs (Cross-References)Historical NotesChain ID HistoryState RepositoryAppendix: Full Submodule Commit Hashes