Skip documentation navigation

Index Module Mode launches

Index the launch contract, then attach its module configuration. The same identity rules apply to base coins and configured coins.

This reference covers module-native-v1 on Robinhood Chain. A new module using this source version keeps the same launch interface. A new source version requires its published adapter and deployment binding.

Complete indexing reference · JSON contract and ABI

Discovery

Read the indexer contract for the ABI, event topics and record fields. Read Module Mode availability for the current release. Require the supported schema, chain, source version and an active, enabled release.

Use the launcher address, runtime hash, dependencies and start block from that release. Retain its digest and source commit with the checkpoint. Historical releases keep their own bindings when a new release becomes available.

Verify a launch

  1. Verify chain 4663 and the launcher's deployed runtime. Scan ModuleNativeLaunched from that launcher in complete, bounded block ranges.
  2. Check the successful receipt and event coordinates. At the same canonical block, compare the event with getLaunch(token) and getLaunchIdentity(token). Require launchIdentityVersion() to return 1.
  3. Verify the matching program, configuration and token identity events. Bind the pool, runtime, module revisions, instances and code hashes using the source version's verifier.
  4. Establish the L2 block's batch membership and finalized Ethereum posting under robinhood-ethereum-finalized-v1. A sequencer receipt is insufficient.
  5. Commit the records and checkpoint together after the full range passes. Recheck saved block hashes on restart and rescan from the last matching checkpoint after a reorganization.

The complete reference specifies provider agreement, commitments, retry handling and integration checks. A consistency check over supplied JSON still requires the collector to authenticate the underlying chain evidence.

Record identity

Coin
chainId + tokenAddress
Pool
chainId + poolManager + poolId
Launch
chainId + sourceAddress + launchId
Event
chainId + blockHash + transactionHash + logIndex

The creator is the verified launchWallet. A relayer, module author or fee recipient does not replace that identity.

Native records use sourceKind: module-native-v1, with routerAddress and stampHash set to null. Custom Launches use the separate Custom terminal integration. Both sources can share a token index using the keys above.

Module configuration

Store package and family IDs as opaque identifiers. Preserve selected revisions, configuration bytes, instances and commitments in their recorded order. Empty selections are valid. A module name or category is never a condition for recognizing a launch.

Display names, icons and controls are optional metadata. An unfamiliar module or unavailable trading adapter does not remove a verified coin. Read revision evidence at the launch block; disabling a module for new launches does not erase existing coins.

Images and social links

Call metadata() on the verified token address to read description, website, image, extraData. An omitted image becomes the Programmable logo at launch. A selected image keeps its own URL.

Decode extraData as UTF-8 JSON with v: 1 and optional x, telegram, discord, github, gitbook fields. Empty bytes and absent fields are valid. Each social URL has a 512-byte limit; the complete JSON has a 1,200-byte limit. Validate HTTPS URLs and platform hosts before rendering links. GitBook may use a custom public HTTPS domain.

For launch-time proof, compare keccak256(abi.encode(name, symbol, metadata)) with ModuleNativeConfigurationBound.metadataHash. The complete reference includes the format and presentation endpoint. Missing artwork or links never remove a verified coin.

Public reads

The Explore API returns website records with status, timestamp and pagination. Filter with mode=all|module|custom; pageSize=10|50 selects the page size. The default is 50. It applies presentation filters. Use contract event scanning for a complete independent archive.

For creator records, read /api/profile/robinhood?account={launchWallet} and traverse all pages. Preserve previously verified rows during a temporary outage and report freshness separately from identity and market support.