Reading token state
> V3 publication draft; not yet published. Economic terms follow the unfrozen specification v2 draft. {{待冻结}} means pending reconciliation with the final frozen specification. This page does not apply to V2 or existing tokens. Available actions depend on the verified release manifest.
Verify the release manifest before project identity. Read-only eth_call needs no private key and should not prompt a transaction.
| Target | Implemented read methods | Purpose |
|---|---|---|
| Factory | project(token) | creator, vault, lock, buyback, hook, version, mode, configHash, poolId |
| Factory | graduated(token) | Graduation status |
| Token | name() / symbol() / decimals() / totalSupply() / balanceOf(account) | Onchain metadata, precision, supply and balance |
| Token | factory() / creator() / releaseId() / version() / mode() / poolId() | Cross-check project identity |
| Token | contractURI() | Fixed media JSON location |
| Registry | get(version) / configHash(version) | Full economic parameters and commitment for the selected version |
| Curve | states(token) | inventory, reserve, createdBlock, createdAt, seq, openingAvailable, trading, graduated |
| Vault | buyTax() / sellTax() / shares(index) / walletCount() / wallet(index) | Tax and purpose configuration |
| Rewards Token | minimum() / weight(account) / claimable(account) | Eligibility, weight and claimable OKB; Rewards only |
| Lock | claimable(role, asset) / totalCollected(asset) / totalPaid(role, asset) | LP receipts, claims and payments |
The correct getter is project(token), not a public projects(token). An unauthenticated contract with matching method names cannot establish creator authority. Check version, full Registry parameter hash, release and code identity together. Do not call an absent optional Buyback contract.
Pin related reads to the same canonical block hash with an EIP-1898-capable RPC and recheck canonicality. Do not combine prices, reserves and statuses from different blocks. Use the manifest’s confirmation depth; no final numeric depth is assigned here. The SDK implements LaunchReads.atBlock, verifyManifest and verifiedProject. Final ABIs must come from the formal candidate including W063, not an earlier exported digest.
contractURI() points to editable offchain JSON. Enforce the fixed host, chain and full address under media rules, then check identity fields, revision and image digest. Defaults, errors and removal do not change onchain names, symbols or balances. A getter alone proves neither service activation nor content authenticity.
When graduated=true, the curve reserve is no longer pool assets: graduation transfers it out and resets that field. Read the authenticated v4 PoolKey and position instead, and display progress as graduated.