Smart contracts

peaqOS runs on five layers. The Economics 2.0 contract set (machine registry, subscriptions, price oracle, trust validator staking) is what new machines activate against since 2026-09-01. The Tokenomics 1.0 registry and staking contracts still serve machines onboarded before that. Both sets live on as UUPS upgradeable proxies. is LayerZero V2; follow ERC-4337; and low-level , batch, and WPEAQ operations are peaq chain .

Architecture

Economics 2.0 (peaq chain, UUPS proxies, since 2026-09-01)
  InfoDesk (parameters, peers, allowlists)
  MachineStateAndSync ──activateMachine──► MachineRegistry (ERC-721, machineId == tokenId, DID document)
        │                                  MachineSubscription (tier bond, grace, runoff, credits) ◄── PriceOracle
        └──────────────────────────────►  CrossChainMirror ◄──► MachineBridgeAdapter (relocation, disabled)
  SubscriptionTokenProvisionPool (USDT settlement) · TrustValidatorStaking · CoordinationFeeCollector
  EventRegistry (2.0) · ExecutionCostReserve · MachineMigrationHub (legacy mirroring)

Tokenomics 1.0 (peaq chain, UUPS proxies, machines onboarded before 2026-09-01)
  IdentityRegistry ──owns──► IdentityStaking
        │                         ▲
        │ (gates on)              │ stakeFor()
        └─────► EventRegistry
        │
        └─────► MachineNFT

Cross-chain (peaq ↔ Base, LayerZero V2)
  MachineNFTAdapter (peaq)  ◄──► MachineNFTBase (Base)

ERC-4337 (peaq chain)
  MachineAccountFactory ──deploys──► MachineSmartAccount (BeaconProxy)

Precompiles (peaq chain, fixed addresses)
  DID (0x...800) · Batch (0x...805) · WPEAQ (0x...809)

Which set a client talks to is a configuration choice: the SDKs enter Tokenomics 2.0 mode when you pass tokenomics20: { deploymentId } (JS) or tokenomics20=Tokenomics20Config(deployment_id=...) (Python); the CLI reads TOKENOMICS_DEPLOYMENT_ID. Economics 2.0 addresses are never environment variables: they ship inside the SDK’s deployment record and are verified against InfoDesk.peer(role) before every write.
Core contracts use UUPS upgradeable proxies (OpenZeppelin 5.x) with ERC-7201 namespaced storage. Future upgrades preserve state.
( by IdentityRegistry) and (minted by MachineNFT) are separate ERC-721 spaces with independent tokenId sequences linked by machineId. See Machine NFT.
IdentityRegistry implements ERC-8004 for DID-anchored machine metadata; the JSON Machine Card is served by the .

peaq mainnet addresses

Economics 2.0 (peaq mainnet)

Deployment record peaq-mainnet (chain ID 3338), deployed 2026-09-01 at block 11,446,386. All are ERC-1967 proxies: MachineBridgeAdapter started as a plain deployment and was re-pointed by InfoDesk to a proxy on 2026-09-08 at block 11,541,867. @peaqos/peaq-os-sdk 0.7.0 and peaq-os-sdk 0.7.1 carry the new address; earlier releases fail Economics 2.0 writes at preflight with PEER_MISMATCH. The implementations behind InfoDesk, MachineStateAndSync, MachineBridgeAdapter and CrossChainMirror were upgraded on 2026-09-09; the proxy addresses below did not change. The seven marked SDK are the roles the SDK snapshot carries and verifies against InfoDesk.peer(role); the other six are read by peaq’s own services. Not environment variables.

Contract	Address	Role
InfoDesk	`0x6C7426ada37212D94477Ac4CFcA43A38177D6A82`	SDK. Parameters, peers, trust validator allowlist, PEAQ token pointer
MachineRegistry	`0x64b93Cc29b251fAFa83BD110cDB1C24207f85536`	SDK. ERC-721 machines (`machineId == tokenId`) and DID documents
MachineStateAndSync	`0xcD1917FB2a56459AcA34FDD118e08776dE0890f2`	SDK. `activateMachine`, suspend, resume, relocation orchestration
MachineSubscription	`0x9e37AD189c334C92e6B8a812Ca4c02f35Ac43895`	SDK. Tier bonds, renewals, grace and runoff, credits. Allowance spender for PEAQ
CrossChainMirror	`0x71DCB313977d6884212395505f081a2991Bfe8E5`	SDK. Home-chain records and mirrored data
MachineBridgeAdapter	`0x791087c35484b567c53f392a624d2e4BaDcC53DF`	SDK. LayerZero relocation transport (disabled)
SubscriptionTokenProvisionPool	`0x7088Cf400081428a41a4287B75AC633071c0e92A`	SDK. USDT settlement of the PEAQ bond. Allowance spender for USDT
PriceOracle	`0x96E6a3BAB0254E7f25B0cdE50C3cBF39272cd46B`	Daily PEAQ/USD stamps by the trust validator node
TrustValidatorStaking	`0x38cfa22Da649F650Cbe7278A9B5141380968920e`	Permissionless trust validator staking (not exposed in SDKs)
CoordinationFeeCollector	`0xCaD48Dc0Eb650C9a0B799e36627D9de18f5a9Dc2`	Per-tier coordination fees, x402 (fee configured at 0)
ExecutionCostReserve	`0xC2F13a8310432f27701F59f060417e986ae24e82`	Gas reserve for system functions
EventRegistry (2.0)	`0xA1e7F1d7B24dAb55Dc92491e6d9B89F6E925Ad1e`	Events for 2.0 machines (SDK event submission not wired yet)
MachineMigrationHub	`0x06EbC22B08229fb796788DB1AAE9675bfC4e22ba`	Mirrors Tokenomics 1.0 machines into 2.0 (operated by peaq)

The PEAQ token the bond is paid in is not a deployed contract: InfoDesk.peaqToken() resolves to the native-balance precompile 0x0000000000000000000000000000000000000809.

Tokenomics 1.0 (peaq mainnet)

Set these in your environment. The reads them from fromEnv() / from_env(). The SDK constructor still requires them in Tokenomics 2.0 mode, although activation reads none of them.

Core

Contract	Variable	Address
IdentityRegistry	`IDENTITY_REGISTRY_ADDRESS`	`0xb53Af985765031936311273599389b5B68aC9956`
IdentityStaking	`IDENTITY_STAKING_ADDRESS`	`0x11c05A650704136786253e8685f56879A202b1C7`
EventRegistry	`EVENT_REGISTRY_ADDRESS`	`0x43c6AF2E14dc1327dc3cc6c7117D1CD72fffEcbA`
MachineNFT	`MACHINE_NFT_ADDRESS`	`0x2943F80e9DdB11B9Dd275499C661Df78F5F691F9`

Precompiles

Contract	Variable	Address
DID	`DID_REGISTRY_ADDRESS`	`0x0000000000000000000000000000000000000800`
Batch	`BATCH_PRECOMPILE_ADDRESS`	`0x0000000000000000000000000000000000000805`
WPEAQ	n/a	`0x0000000000000000000000000000000000000809`

Optional

Contract	Variable	Address	Needed for
MachineAccountFactory	`MACHINE_ACCOUNT_FACTORY_ADDRESS`	`0x4A808d5A90A2c91739E92C70aF19924e0B3D527f`	`deploySmartAccount` / `getSmartAccountAddress`
MachineNFTAdapter	`MACHINE_NFT_ADAPTER_ADDRESS`	`0x9AD5408702EC204441A88589B99ADfC2514AFAE6`	`bridgeNft` from peaq
AdminFlags	`ADMIN_FLAGS_ADDRESS`	`0x1c5f33fBEE6BA38ed9bDE247C1Ba89A2116C25f1`	MCR API server (negative-flag reads + admin trust overrides)

Base mainnet addresses

Needed when bridging into peaq from . Pass as baseNftAddress / base_nft_address to bridgeNft / bridge_nft.

Contract	Address
MachineNFTBase (LayerZero ONFT)	`0xee8A521eA434b11F956E2402beC5eBfa753Babfa`

Solana mainnet addresses

Economics 2.0 (Solana mainnet)

First five programs deployed 2026-09-09, upgraded in place and joined by four more on 2026-09-11 (program IDs unchanged). Protocol chain ID 5, LayerZero EID 30168. Nine Anchor programs mirror the peaq contracts of the same name; all keep the deployment wallet as upgrade authority and as administrator of each program’s root account.

Program	Program ID	Counterpart on peaq
InfoDesk	`UzabYW77ox4AJzsMiiFqA89Vm5aWeyy3PSW9LtaYnjG`	`InfoDesk` subset: chain registry, currency whitelist, tokenomics parameters, bridging flags
MachineBridgeAdapter	`CEqQYLMm6WKHyvBZRU91N2kkQV1J2V3HxLW8McFQ681H`	`MachineBridgeAdapter` plus the mirror stores. LayerZero OApp; its store PDA `5MKZ41yuSg46fTt4ma29J69aCbw93eyVQ9XKW89vxJ6i` is the peer peaq’s adapter points at
MachineRegistry	`AgR8exgW2mwpf4v2PpojYuDHXVBThZtenS6XYjV4JnUD`	`MachineRegistry`: Solana-native machine identity and DID documents
CoordinationFeeCollector	`7DsHEYDpvvZY3BgCLS2wAYrftGAQuUWLibQijeYULMBh`	`CoordinationFeeCollector`: fees paid in SOL or a whitelisted SPL mint
MachineStateAndSync	`DbhzPvFghnmpw6YmZsCBuVU6u1sjbc1FfzPDqi4VjoZL`	`MachineStateAndSync` destination half: relocation state
EventRegistry	`AWMkhnccpjuMgUDqWfFG38DCiKTqC3KsLhrzivEPWb77`	`EventRegistry` (2.0): per-machine activity and revenue events for Solana machines, deployed 2026-09-11
PriceOracle	`FpfGfjbkSm5yBuV5d5HLsr6wybm1EvgHoqcTyTFZG12v`	`PriceOracle`: USD price reference for the coordination fee, deployed 2026-09-11
TreasuryPool	`EzppvStr1VorTrNEDGWwgSGnM9xum3uAc6W1vCFnr4Ey`	Treasury sink for coordination fees (native SOL and SPL), deployed 2026-09-11
TrustValidatorStaking	`BSDXwYicwx3NZdD7Mpe147jzWqUYmAzR8PptqH5NU1wM`	`TrustValidatorStaking`, home chain 1 (peaq), deployed 2026-09-11

Configuration at deployment: tier fees

0.02 /

0.20 / $40 as on peaq (a fourth tier exists in the config and is disabled), native SOL whitelisted as currency, bridging and relocation flags false. On the peaq side MachineBridgeAdapter has the Solana store PDA registered as its LayerZero peer (receive gas 400,000, maximum message size 10,000) and holds a 105 PEAQ fee reserve. Nothing in this table is reachable through the SDKs or the CLI yet, and the 2.0 MCR server does not read the Solana EventRegistry yet, so a Solana machine has no rating. Activating a machine on Solana needs PEAQ bonding for Solana machines, which is in development; see Omni-chain for the status of each capability.

Agung testnet addresses

Economics 2.0 (agung testnet)

Deployment record agung-2026-08-28 (chain ID 9990). Same seven SDK roles as mainnet. Agung has no paired 2.0 MCR, so monetization calls fail with DEPLOYMENT_UNAVAILABLE there.

Contract	Address
InfoDesk	`0x72b66AF120c55371cA6e5Ce38D4e10dF1bA30Bb1`
MachineRegistry	`0x538da35489B1F0035799a8351E67835ae4ABb377`
MachineStateAndSync	`0xA7D33726232aae30622643a18047f0Ca3e159da9`
MachineSubscription	`0xaDCc5dD8CD57E3198B881c3388F25D2fD69B5aDc`
CrossChainMirror	`0xd5F8d5944c5d488B1cD698D642FC8156a8CD0c0c`
MachineBridgeAdapter	`0x0406e7bE522AEa626aee54f6258D415215e59F76`
SubscriptionTokenProvisionPool	`0x8A3692Ad0AcF79BB89413514Af9957d95032e19B`

Tokenomics 1.0 (agung testnet)

Use these for development on . The contract surface matches mainnet; only the deployed addresses differ.

Core

Contract	Variable	Address
IdentityRegistry	`IDENTITY_REGISTRY_ADDRESS`	`0x9E9463a65c7B74623b3b6Cdc39F71be7274e5971`
IdentityStaking	`IDENTITY_STAKING_ADDRESS`	`0x55f336714aDb0749DbFE33b057a1702405564E3d`
EventRegistry	`EVENT_REGISTRY_ADDRESS`	`0x2DAD8905380993940e340C5cE6d313d5c2780040`
MachineNFT	`MACHINE_NFT_ADDRESS`	`0xB41C2A4f1c19b6B06beaAce0F5CD8439e77C4b1c`

Precompiles

Identical to mainnet: same fixed addresses on every peaq runtime.

Contract	Variable	Address
DID	`DID_REGISTRY_ADDRESS`	`0x0000000000000000000000000000000000000800`
Batch	`BATCH_PRECOMPILE_ADDRESS`	`0x0000000000000000000000000000000000000805`
WPEAQ	n/a	`0x0000000000000000000000000000000000000809`

Optional

Contract	Variable	Address	Needed for
MachineAccountFactory	`MACHINE_ACCOUNT_FACTORY_ADDRESS`	`0x65a4DfEB799dFf8CF15f13816d648a7805d6b1F9`	`deploySmartAccount` / `getSmartAccountAddress`
AdminFlags	`ADMIN_FLAGS_ADDRESS`	`0x4181a2Aa34aFb247450FfcBd65be5aBD4Cbee658`	MCR API server (negative-flag reads + admin trust overrides)

Bridging cannot be exercised on agung. LayerZero deprecated the agung endpoint (EID 40299): DVNs and executors are no longer active, so bridgeNft / bridge_nft cannot relay. No agung MachineNFTAdapter appears in peaq deployment records — the address previously listed here (0x63fD…8De22) is actually the MachineAccountFactory’s UpgradeableBeacon (verifiably the factory’s nonce-2 contract creation). Exercise the bridge on peaq mainnet ↔ Base mainnet only.

Economics 2.0 contracts

MachineRegistry

The 2.0 machine registry: one ERC-721 per machine where the token ID is the machine ID (uint256(keccak256(abi.encode(machineType, credentialSubject)))), plus the machine’s DID document (controller, verification methods, authentication, service endpoints). Standard ERC-721 transfers and approvals are how a machine changes owner. Minting happens only inside MachineStateAndSync.activateMachine; there is no public mint. SDK methods: getMachineOwner, computeMachineId, transferMachine, safeTransferMachine, approveMachine, setMachineApprovalForAll, setMachineController, setMachineVerificationMethods, setMachineAuthentication, setMachineServiceEndpoints

MachineStateAndSync

Orchestrates the one-transaction activation (activateMachine, activateMachineWithUsdt), voluntary suspend and resume, per-machine and protocol-wide pause flags, and relocation. Never holds tokens. SDK methods: activateMachine, activateMachineWithUsdt, previewMachineActivation, suspendMachine, resumeMachine, getMachineActivationState, getMachineAvailability

MachineSubscription

Prices and collects the tier bond (requiredPeaqAmount(tier)), stores each machine’s subscription (tier, period, bonded amount), applies grace and runoff, and tracks bonding reward and voucher credits. The allowance spender for PEAQ bonds. Settlement functions are called by the trust validator node. SDK methods: activateExistingMachine, renewMachine, previewMachineRenewal, getMachineSubscription

InfoDesk

Owner-set protocol parameters (tier prices in USD, grace and runoff durations, epoch length, fee rates, burn and treasury addresses), the peer registry the SDK verifies against, the trust validator allowlist, and peaqToken().

PriceOracle

Daily currency prices committed by trust validator nodes (commitPrices), read by MachineSubscription to convert USD tier prices to PEAQ. Public read: getLatestPrice(bytes32 currency).

CrossChainMirror and MachineBridgeAdapter

Record the machine’s home chain and carry relocation messages over LayerZero V2. Relocation is disabled (InfoDesk.isBridgingEnabled() false) and the SDKs expose status reads only. SDK methods: getMachineRelocationStatus

SubscriptionTokenProvisionPool

Converts USDT into the PEAQ bond when a caller settles with --payment usdt / activateMachineWithUsdt / renewMachineWithUsdt. The allowance spender for USDT.

TrustValidatorStaking, CoordinationFeeCollector, ExecutionCostReserve, EventRegistry (2.0), MachineMigrationHub

Live on mainnet, operated by peaq or reserved for later releases; none is exposed in the SDKs or the CLI today. See Economics 2.0.

Tokenomics 1.0 contracts

These serve machines onboarded before 2026-09-01. New activations do not use them.

IdentityRegistry

Central machine identity registry of Tokenomics 1.0. Mints an ERC-721 Identity NFT to each machine on and orchestrates through IdentityStaking.stakeFor(). Implements ERC-8004 so that each Identity NFT’s tokenURI resolves to the machine’s DID-anchored Machine Card. themselves live on the peaq DID precompile (W3C DID), written by the SDK via writeMachineDIDAttributes and read by the MCR API. Tracks per-machine status (None → Pending → Verified / Rejected / Deactivated). Supports self-registration and proxy registration. SDK methods: registerMachine, registerFor Key state: minBond (currently 1 PEAQ), nextMachineId, operatorOf, machineStatus

IdentityStaking

Bond token storage. Tokens are staked at registration time via stakeFor() and held permanently; no withdrawal path is exposed. Only authorized callers (IdentityRegistry) can initiate stakes. Supports pause / unpause by owner. SDK interaction: Indirect. registerMachine / registerFor route the bond through here automatically.

EventRegistry

On-chain store for revenue (type 0) and activity (type 1) . Gates event submission on (a) the machine being registered in IdentityRegistry, and (b) the machine being bonded in IdentityStaking. Authorization rule: msg.sender must be the machine or the . Stores a keccak256 of the raw data; payloads stay off-chain. SDK methods: submitEvent, batchSubmitEvents Concept: Events

MachineNFT

LayerZero V2 ONFT representing a machine’s financial profile. Minted in a separate mintNft call after registration: the Machine NFT tokenId is independent from the Identity NFT tokenId. tokenURI resolves to the MCR API’s /metadata/{token_id} endpoint, which returns the Machine Card. SDK methods: mintNft, tokenIdOf Concept: Machine NFT

Cross-chain contracts

These are the Tokenomics 1.0 Machine NFT bridge. Economics 2.0 machines relocate through MachineBridgeAdapter and CrossChainMirror instead, which is disabled today.

MachineNFTAdapter (peaq)

Wraps MachineNFT for LayerZero V2 bridging. Lock/unlock pattern: locks the on peaq while the mirror exists on the destination chain. Needed only when bridging from peaq. Peers: Base (EID 30184) and Solana (EID 30168, program HraxgdzfcAi3AnxRP5sGSrXGAb9ZT1tZTMNuh9vQLxTu). The Solana lane is live on mainnet since 2026-08-21 and operated with peaq’s tooling; the SDKs accept only "base" as a destination today. See Omni-chain: Solana. SDK methods: bridgeNft / bridge_nft when source is "peaq"

MachineNFTBase (Base)

Standard ONFT721 on Base. Burn/mint pattern: NFT is burned when bridged back to peaq. Needed when bridging from Base. SDK methods: bridgeNft / bridge_nft when source is "base" (pass the address as baseNftAddress / base_nft_address)

ERC-4337 smart accounts

MachineAccountFactory

CREATE2 factory for deploying MachineSmartAccount BeaconProxy instances. Standard ERC-4337 flow: smart accounts run through the canonical EntryPoint at 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 (same address across all networks). SDK methods: deploySmartAccount / deploy_smart_account, getSmartAccountAddress / get_smart_account_address

MachineSmartAccount

The shared BeaconProxy implementation behind deployed smart accounts. Handles owner/machine RBAC and broad machine execution authority. Users never interact with the implementation directly; calls go to the deployed proxy.

AdminFlags

Optional peaq-chain contract read by the MCR API server (not the SDK). Holds admin-set flags that modify responses: per-machine negative_flags and trust-level overrides. MCR consumers see the adjusted score in their API response. When the contract isn’t configured, contracts.admin_flags on GET /ready returns false and the service serves unmodified MCR. See API overview.

Precompiles (peaq chain)

Precompile	Address	Purpose
DID	`0x0000000000000000000000000000000000000800`	Read/write DID attributes. Used for Machine Card metadata and proxy-operator fleet attributes
Batch	`0x0000000000000000000000000000000000000805`	Atomic multi-call for bonding (registration + stake) and proxy DID writes
WPEAQ	`0x0000000000000000000000000000000000000809`	The native PEAQ ERC-20 precompile, which peaqOS contracts reference as `WPEAQ` (`IWPEAQ`); used by IdentityStaking as the staking token. Not the standalone WPEAQ ERC-20 token — see PEAQ Token Contracts

LayerZero endpoints

Used by the bridge adapters. You don’t set these directly; the SDK handles them.

Network	LayerZero V2 endpoint	EID
peaq mainnet	`0x6F475642a6e85809B1c36Fa62763669b1b48DD5B`	`30302`
Base mainnet	`0x1a44076050125825900e736c501f859c50fE728c`	`30184`
Solana mainnet	`76y77prsiCMvXMjuoZ5VRrhG5qYBrUMYTE5WgHqgjEn6`	`30168`

The SDK exports the EIDs as LAYER_ZERO_EIDS (JS) / LAYERZERO_EIDS (Python) for reference.

Upgrade pattern

All Economics 2.0 contracts (MachineBridgeAdapter since its 2026-09-08 re-point), and all Tokenomics 1.0 core contracts (IdentityRegistry, IdentityStaking, EventRegistry, MachineNFT), use OpenZeppelin UUPS upgradeable proxies with ERC-7201 namespaced storage. Implementation slots are kept distinct by namespace, so future upgrades won’t collide with existing state. MachineSmartAccount uses a BeaconProxy pattern: a single implementation upgrade simultaneously applies to every deployed smart account.

Install

Wire the contract addresses into .env for the SDK.

SDK reference

Every method that reads or writes these contracts.

API reference

Off-chain reads derived from the on-chain state.

​Architecture

​peaq mainnet addresses

​Economics 2.0 (peaq mainnet)

​Tokenomics 1.0 (peaq mainnet)

​Core

​Precompiles

​Optional

​Base mainnet addresses

​Solana mainnet addresses

​Economics 2.0 (Solana mainnet)

​Agung testnet addresses

​Economics 2.0 (agung testnet)

​Tokenomics 1.0 (agung testnet)

​Core

​Precompiles

​Optional

​Economics 2.0 contracts

​MachineRegistry

​MachineStateAndSync

​MachineSubscription

​InfoDesk

​PriceOracle

​CrossChainMirror and MachineBridgeAdapter

​SubscriptionTokenProvisionPool

​TrustValidatorStaking, CoordinationFeeCollector, ExecutionCostReserve, EventRegistry (2.0), MachineMigrationHub

​Tokenomics 1.0 contracts

​IdentityRegistry

​IdentityStaking

​EventRegistry

​MachineNFT

​Cross-chain contracts

​MachineNFTAdapter (peaq)

​MachineNFTBase (Base)

​ERC-4337 smart accounts

​MachineAccountFactory

​MachineSmartAccount

​AdminFlags

​Precompiles (peaq chain)

​LayerZero endpoints

​Upgrade pattern

​See also

Install

SDK reference

API reference

Architecture

peaq mainnet addresses

Economics 2.0 (peaq mainnet)

Tokenomics 1.0 (peaq mainnet)

Core

Precompiles

Optional

Base mainnet addresses

Solana mainnet addresses

Economics 2.0 (Solana mainnet)

Agung testnet addresses

Economics 2.0 (agung testnet)

Tokenomics 1.0 (agung testnet)

Core

Precompiles

Optional

Economics 2.0 contracts

MachineRegistry

MachineStateAndSync

MachineSubscription

InfoDesk

PriceOracle

CrossChainMirror and MachineBridgeAdapter

SubscriptionTokenProvisionPool

TrustValidatorStaking, CoordinationFeeCollector, ExecutionCostReserve, EventRegistry (2.0), MachineMigrationHub

Tokenomics 1.0 contracts

IdentityRegistry

IdentityStaking

EventRegistry

MachineNFT

Cross-chain contracts

MachineNFTAdapter (peaq)

MachineNFTBase (Base)

ERC-4337 smart accounts

MachineAccountFactory

MachineSmartAccount

AdminFlags

Precompiles (peaq chain)

LayerZero endpoints

Upgrade pattern

See also