Integration reference // v1

Integrate BowYard before graduation.

Build launchpad-native discovery, quotes, trading, and lifecycle tracking across the bonding curve and BowYard DEX.

Robinhood Chain · 4663 · Mainnet

Network

Chain
Robinhood Chain
Chain ID
4663
Native gas
ETH
USDG
0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
WETH
0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73

Published coordinates, live source status

Contract registry

BowYard exposes roles, not fictional deployments. Token Factory, Bonding Curve, and Graduation Manager are three roles of one core launchpad runtime. Pools are direct CREATE2 deployments, not proxies.

Published fallback registry · live status loading

Token Factory

Checking

Token creation is one role of the core BowYard launchpad runtime.

shared-runtime0x0F724a…22e774

Bonding Curve

Checking

Quotes, buys, sells, curve accounting, and graduation state share the core runtime.

shared-runtime0x0F724a…22e774

Graduation Manager

Checking

Graduation is executed by the core launchpad; there is no separate manager deployment.

shared-runtime0x0F724a…22e774

BowYard DEX Factory

Checking

Resolves and creates the permanently locked USDG pool for a graduated token.

BowYard DEX Router

Checking

Use the router for quotes and swaps after graduation.

Pool implementation

Dynamic

Each graduated token gets a direct CREATE2 pool. Resolve it with factory.pairFor(token); there is no proxy implementation address.

per-market-create2Onchain resolver

Launch Agent

Checking

Bounded trading policy for creator-funded launch activity.

Agent Launchpad V2

Unpublished

Agent-native token, curve, fee-vault, and graduation coordinator.

singletonOnchain resolver

Agent Revenue Factory

Unpublished

Creates attributed revenue vaults; individual vaults are per agent.

singletonOnchain resolver

Provider Adapter Factory

Unpublished

Creates provider adapters linked to an agent revenue vault.

singletonOnchain resolver

Identity Registry

Unpublished

Public onchain identity coordinate used by agent policies.

singletonOnchain resolver

Reputation Registry

Unpublished

Public onchain reputation coordinate used by agent policies.

singletonOnchain resolver

Validation Registry

Unpublished

Public onchain validation coordinate used by agent policies.

singletonOnchain resolver

Agentic Commerce

Unpublished

USDG-denominated job and settlement policy coordinate.

singletonOnchain resolver

Agent Revenue Vault

Dynamic

Resolve the vault from the relevant factory or agent-market creation event.

per-agentOnchain resolver

Agent Trade Fee Vault

Dynamic

Resolve the fee vault from AgentTokenCreated; there is no global vault address.

per-agentOnchain resolver

Canonical logs + normalized lifecycle

ABI & events

Consume raw contract logs or the normalized indexer lifecycle. Normalized names never replace the canonical event signature, emitting contract, block hash, transaction hash, or log index.

Normalized signalCanonical onchain sourceUse
TokenCreatedTokenCreated · AgentTokenCreatedDiscover a launch and bind token, creator, metadata, and transaction evidence.
TradeCurveTrade · Swap · AgentCurveTrade · AgentDexSwap · AgentTradeNormalize pre-graduation and post-graduation execution into one trade stream.
GraduatedTokenGraduated · AgentTokenGraduatedClose the curve venue and switch routing to the published USDG pool.
PoolCreatedPairCreatedBind the token to its deterministic post-graduation pool.
AgentEnabledAgentActivated · AgentTokenCreatedExpose the beginning of an agent-controlled market policy.
FeeOrRevenueTradeFeeReleased · RevenueReleased · BudgetForwarded · RevenueSweptAttribute public fee and revenue movements without exposing offchain operations.

Venue-aware quote and calldata

Trading integration

Method reference

Before graduation

  • quoteBuy(token, maxStableIn)
  • buy(token, maxStableIn, minTokenOut, deadline)
  • quoteSell(token, tokenIn)
  • sell(token, tokenIn, minStableOut, deadline)

After graduation

  • quoteStableForToken(token, stableIn)
  • swapExactStableForTokens(token, stableIn, minTokenOut, recipient, deadline)
  • quoteTokenForStable(token, tokenIn)
  • swapExactTokensForStable(token, tokenIn, minStableOut, recipient, deadline)

Approvals. Approve USDG to the core launchpad before graduation or the router after graduation. For sells, approve the token to the active venue.

Venue-aware quote · TypeScript
const project = await client.readContract({
  address: launchpad,
  abi: launchpadAbi,
  functionName: "getProject",
  args: [token],
});

const quote = project.graduated
  ? await client.readContract({
      address: router,
      abi: dexRouterAbi,
      functionName: "quoteStableForToken",
      args: [token, stableIn],
    })
  : await client.readContract({
      address: launchpad,
      abi: launchpadAbi,
      functionName: "quoteBuy",
      args: [token, stableIn],
    });
Buy calldata · viem
const data = encodeFunctionData({
  abi: project.graduated ? dexRouterAbi : launchpadAbi,
  functionName: project.graduated
    ? "swapExactStableForTokens"
    : "buy",
  args: project.graduated
    ? [token, stableIn, minTokenOut, recipient, deadline]
    : [token, stableIn, minTokenOut, deadline],
});
Sell calldata · viem
const data = encodeFunctionData({
  abi: project.graduated ? dexRouterAbi : launchpadAbi,
  functionName: project.graduated
    ? "swapExactTokensForStable"
    : "sell",
  args: project.graduated
    ? [token, tokenIn, minStableOut, recipient, deadline]
    : [token, tokenIn, minStableOut, deadline],
});

Slippage floor

minOut = quotedOut × (10,000 − slippageBps) ÷ 10,000. Use integer math only.

Quote freshness

Refresh immediately before signing and use a short, explicit deadline.

Graduation boundary

quoteBuy may consume less than maxStableIn when the curve reaches its target. Trust returned stableIn.

Versioned JSON · CORS-enabled · public reads

Indexer API

Canonical base URL: https://bowyard.fun/api/v1. Responses include an explicit source and coverage window; unavailable data returns an error state, never synthetic activity.

MethodEndpointPurpose
GET/launchesAll indexed launches. Defaults to newest first.
GET/launches?sort=newestNewest launches.
GET/launches?sort=trendingActivity-weighted trending launches.
GET/launches?stage=graduatingBonding launches at or above 70% progress.
GET/launches?stage=graduatedGraduated launches with a published pool.
GET/tokens/{address}Token statistics and current venue state.
GET/tokens/{address}/tradesNormalized curve and DEX trades.
GET/tokens/{address}/agentLaunch Agent status, or an explicit inactive state.
GET/contractsAllowlisted public deployment registry and explorer-source status.
GET/abiIntegration ABIs and canonical-to-normalized event map.
GET/integration-samplesLive token and transaction evidence for adapter testing.
Indexer requests · curl
curl "https://bowyard.fun/api/v1/launches?sort=trending&stage=graduating"

# One normalized token snapshot
curl "https://bowyard.fun/api/v1/tokens/0x..."

# Curve + DEX trade history
curl "https://bowyard.fun/api/v1/tokens/0x.../trades"

Canonical public identity

Brand assets

NameBowYard
DescriptionA non-custodial launchpad for meme tokens, RWA projects, useful agents, and USDG markets on Robinhood Chain.
TelegramNo official channel published

Live mainnet evidence only

Sample markets

The endpoint selects three real BowYard token contracts and attaches receipts only when Blockscout or the onchain indexer can prove them. Missing buys, sells, or graduation are shown as missing — never filled with demo hashes.

The integration that matters before graduation

Launchpad adapter

  1. 01

    Discover

    Index TokenCreated from the core deployment block. Store token, creator, metadata, transaction hash, block hash, and log index.

  2. 02

    Price the curve

    Use quoteBuy and quoteSell against the core launchpad. Do not apply a constant-product formula to pre-graduation markets.

  3. 03

    Normalize trades

    Map CurveTrade and agent curve activity into Trade while retaining the raw event and the curve venue.

  4. 04

    Track progression

    Read getProject and expose stableRaised, curveTokensSold, progress, tradeCount, and agent status until graduation.

  5. 05

    Switch venues

    On TokenGraduated + PairCreated, bind the pool, stop curve routing, and begin Swap ingestion through the BowYard DEX.

  6. 06

    Reconcile evidence

    Handle reorgs by block hash, deduplicate by transaction hash + log index, and backfill from the versioned API when necessary.

Discovery

  • TokenCreated
  • Metadata
  • Deployment block

Live trading

  • Quotes
  • Buy / sell calldata
  • CurveTrade

Lifecycle

  • Progress
  • Agent status
  • Graduation → pool