Documentation

How StockPairs works.

An Arc-native TOKEN/USDC launch architecture with a stock-price reference layer—without inventing stock tokens or unofficial bridges.

01 · Product model

One USDC market, one stock index.

A creator token trades in a single TOKEN/USDC pool on Arc. The creator also selects one immutable stock ticker such as NVDA. The interface expresses the token's USDC price as a fraction of that stock's current indicative price.

Important:The ticker is a reference unit only. It is not an issuer-backed stock token, collateral, custody arrangement, share, dividend, voting right, or redemption claim.

02 · Launch flow

Resolve, calculate, validate.

  1. The wallet connects and switches to Arc chain ID 5042.
  2. The creator supplies image, metadata, social links, fixed supply, and a starting USDC price.
  3. The creator selects one of ten active stock references.
  4. The app shows the ticker, reference ID, live indicative quote, source, USDC settlement address, and indexed starting value.
  5. The image digest and metadata are hashed and the hash is included in the launch call.
  6. The transaction is simulated against the configured factory. Invalid references, settlement configuration, terms, or pool initialization stop the flow.
  7. The wallet signs directly; StockPairs never handles private keys.
  8. The receipt exposes the token, initialized USDC pool, reference ID, factory, metadata hash, and explorer links. Liquidity is supplied separately.

03 · Stock registry

Ticker identity is deterministic.

Each stock has a stable bytes32 ID derived from its ticker, together with source documentation, market hours, feed configuration, heartbeat, enabled state, and verification time. It deliberately contains no field that purports to be an Arc stock-token contract.

Production ownership is designed for a timelock controlled by a separate multisig. A frontend label cannot change an onchain record.

04 · Indexed pricing

USDC price divided by stock price.

If a token trades at 0.01 USDC and the selected stock reference is 200 USD, its display value is 0.00005 stock units. The external quote is indicative and can be temporarily unavailable; StockPairs never fills that gap with synthetic data.

Onchain graduation can use the TOKEN/USDC reserves directly for USD-denominated thresholds while still requiring a fresh stock feed to keep the selected reference healthy.

05 · Arc settlement

No stock-token route is required.

The pool quote asset is always Arc's USDC ERC-20 interface at 0x3600000000000000000000000000000000000000. That removes dependence on an unofficial stock bridge, an issuer deployment on Arc, or a thin stock/USDC route.

Users pay, trade, receive proceeds, and account for fees in USDC. The stock layer affects presentation and reference validation, not custody or settlement.

06 · Contract suite

Small modules, explicit authority.

  • ArcIndexFactory: creates fixed-supply launch tokens, initializes one TOKEN/USDC v4 pool, stores the selected reference ID, and enforces 0% fee-on-transfer behavior.
  • ArcLaunchToken: fixed supply, EIP-2612 permit, no owner mint, blacklist, pause, confiscation, or transfer tax.
  • Planned liquidity module: a separate reviewed flow will add and optionally lock v4 positions; factory initialization alone does not imply liquidity.
View known addresses

07 · Indexer

Factory events become product data.

The production backend reads TokenLaunched logs from the configured factory, enriches each token with onchain metadata, and exposes only those verified events. The first indexed block is pinned to the deployment block so earlier chain history is not scanned. A persistent database and reorganization worker are a later scaling step.

08 · Release gates

The index layer and execution gate are separate.

ENABLE_STOCK_INDEXED_MARKETS=true
NEXT_PUBLIC_ENABLE_STOCK_INDEXED_MARKETS=true
ENABLE_MAINNET_LAUNCH=false
NEXT_PUBLIC_FACTORY_ADDRESS=

The reference catalog, live quote API, conversion logic, and launch validation are active. Wallet execution turns on only after a factory is deployed, its source and bytecode are checked, its deployment block is configured, and the production flag is deliberately enabled.

The current factory has automated tests but no independent security audit. An audit, multisig/timelock ownership, liquidity review, and legal review remain necessary before encouraging broad public value at risk.

Primary references: Arc network , Uniswap v4 , and price API .