Integration reference // v1
Integrate BowYard before graduation.
Build launchpad-native discovery, quotes, trading, and lifecycle tracking across the bonding curve and BowYard DEX.
Network
- Chain
- Robinhood Chain
- Chain ID
- 4663
- Native gas
- ETH
- Public RPC
- https://rpc.mainnet.chain.robinhood.com
- Blockscout
- https://robinhoodchain.blockscout.com
- USDG
- 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168
- WETH
- 0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73
The public RPC is rate-limited and intended for portable reads. Production integrators should use their own provider, but must never publish provider credentials in client code or integration manifests.
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.
| Component | Deployment | Address / resolver | Source |
|---|---|---|---|
| Token Factory Token creation is one role of the core BowYard launchpad runtime. | shared-runtime | 0x0F724a…22e774 | Checking |
| Bonding Curve Quotes, buys, sells, curve accounting, and graduation state share the core runtime. | shared-runtime | 0x0F724a…22e774 | Checking |
| Graduation Manager Graduation is executed by the core launchpad; there is no separate manager deployment. | shared-runtime | 0x0F724a…22e774 | Checking |
| BowYard DEX Factory Resolves and creates the permanently locked USDG pool for a graduated token. | singleton | 0x272750…D89241 | Checking |
| BowYard DEX Router Use the router for quotes and swaps after graduation. | singleton | 0xd4A018…79190f | Checking |
| Pool implementation Each graduated token gets a direct CREATE2 pool. Resolve it with factory.pairFor(token); there is no proxy implementation address. | per-market-create2 | Resolve onchain | Dynamic |
| Launch Agent Bounded trading policy for creator-funded launch activity. | singleton | 0x821de9…0e9E37 | Checking |
| Agent Launchpad V2 Agent-native token, curve, fee-vault, and graduation coordinator. | singleton | Resolve onchain | Unpublished |
| Agent Revenue Factory Creates attributed revenue vaults; individual vaults are per agent. | singleton | Resolve onchain | Unpublished |
| Provider Adapter Factory Creates provider adapters linked to an agent revenue vault. | singleton | Resolve onchain | Unpublished |
| Identity Registry Public onchain identity coordinate used by agent policies. | singleton | Resolve onchain | Unpublished |
| Reputation Registry Public onchain reputation coordinate used by agent policies. | singleton | Resolve onchain | Unpublished |
| Validation Registry Public onchain validation coordinate used by agent policies. | singleton | Resolve onchain | Unpublished |
| Agentic Commerce USDG-denominated job and settlement policy coordinate. | singleton | Resolve onchain | Unpublished |
| Agent Revenue Vault Resolve the vault from the relevant factory or agent-market creation event. | per-agent | Resolve onchain | Dynamic |
| Agent Trade Fee Vault Resolve the fee vault from AgentTokenCreated; there is no global vault address. | per-agent | Resolve onchain | Dynamic |
Token Factory
CheckingToken creation is one role of the core BowYard launchpad runtime.
Bonding Curve
CheckingQuotes, buys, sells, curve accounting, and graduation state share the core runtime.
Graduation Manager
CheckingGraduation is executed by the core launchpad; there is no separate manager deployment.
BowYard DEX Factory
CheckingResolves and creates the permanently locked USDG pool for a graduated token.
BowYard DEX Router
CheckingUse the router for quotes and swaps after graduation.
Pool implementation
DynamicEach graduated token gets a direct CREATE2 pool. Resolve it with factory.pairFor(token); there is no proxy implementation address.
Launch Agent
CheckingBounded trading policy for creator-funded launch activity.
Agent Launchpad V2
UnpublishedAgent-native token, curve, fee-vault, and graduation coordinator.
Agent Revenue Factory
UnpublishedCreates attributed revenue vaults; individual vaults are per agent.
Provider Adapter Factory
UnpublishedCreates provider adapters linked to an agent revenue vault.
Identity Registry
UnpublishedPublic onchain identity coordinate used by agent policies.
Reputation Registry
UnpublishedPublic onchain reputation coordinate used by agent policies.
Validation Registry
UnpublishedPublic onchain validation coordinate used by agent policies.
Agentic Commerce
UnpublishedUSDG-denominated job and settlement policy coordinate.
Agent Revenue Vault
DynamicResolve the vault from the relevant factory or agent-market creation event.
Agent Trade Fee Vault
DynamicResolve the fee vault from AgentTokenCreated; there is no global vault address.
“Published” means the coordinate is part of the public runtime registry. Blockscout source-verification is reported separately and never implied when the explorer says it is pending.
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 signal | Canonical onchain source | Use |
|---|---|---|
| TokenCreated | TokenCreated · AgentTokenCreated | Discover a launch and bind token, creator, metadata, and transaction evidence. |
| Trade | CurveTrade · Swap · AgentCurveTrade · AgentDexSwap · AgentTrade | Normalize pre-graduation and post-graduation execution into one trade stream. |
| Graduated | TokenGraduated · AgentTokenGraduated | Close the curve venue and switch routing to the published USDG pool. |
| PoolCreated | PairCreated | Bind the token to its deterministic post-graduation pool. |
| AgentEnabled | AgentActivated · AgentTokenCreated | Expose the beginning of an agent-controlled market policy. |
| FeeOrRevenue | TradeFeeReleased · RevenueReleased · BudgetForwarded · RevenueSwept | Attribute public fee and revenue movements without exposing offchain operations. |
Stable event identity: chainId:blockHash:transactionHash:logIndex. Reprocess replaced blocks on reorg and retain the raw log beside normalized fields.
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.
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],
});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],
});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.
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /launches | All indexed launches. Defaults to newest first. |
| GET | /launches?sort=newest | Newest launches. |
| GET | /launches?sort=trending | Activity-weighted trending launches. |
| GET | /launches?stage=graduating | Bonding launches at or above 70% progress. |
| GET | /launches?stage=graduated | Graduated launches with a published pool. |
| GET | /tokens/{address} | Token statistics and current venue state. |
| GET | /tokens/{address}/trades | Normalized curve and DEX trades. |
| GET | /tokens/{address}/agent | Launch Agent status, or an explicit inactive state. |
| GET | /contracts | Allowlisted public deployment registry and explorer-source status. |
| GET | /abi | Integration ABIs and canonical-to-normalized event map. |
| GET | /integration-samples | Live token and transaction evidence for adapter testing. |
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"Current catalog coverage is the latest 50 onchain launches. The API declares whether that window covers the full deployment; adapters should persist events from deployment block 19285460 for an independent full history.
Canonical public identity
Brand assets
Use only these files and the exact “BowYard” spelling. Do not infer affiliation with Robinhood, and do not list unofficial Telegram, Discord, or support accounts.
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
A token listing is not enough.
Post-graduation pools are easy for a standard DEX indexer. BowYard’s primary value is earlier: GMGN, Axiom, Ave, and similar terminals need a launchpad adapter that understands the live bonding curve before a pool exists.
Named platforms are integration targets, not current partners or endorsements.
TokenCreated
Discover the launch
Bonding curve
quote · buy · sell · CurveTrade
TokenGraduated + PairCreated
Switch only on receipt evidence
BowYard DEX
Router · pool · Swap
- 01
Discover
Index TokenCreated from the core deployment block. Store token, creator, metadata, transaction hash, block hash, and log index.
- 02
Price the curve
Use quoteBuy and quoteSell against the core launchpad. Do not apply a constant-product formula to pre-graduation markets.
- 03
Normalize trades
Map CurveTrade and agent curve activity into Trade while retaining the raw event and the curve venue.
- 04
Track progression
Read getProject and expose stableRaised, curveTokensSold, progress, tradeCount, and agent status until graduation.
- 05
Switch venues
On TokenGraduated + PairCreated, bind the pool, stop curve routing, and begin Swap ingestion through the BowYard DEX.
- 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
Integration support: partnership@bowyard.fun. Send your adapter name, ingestion address, and the exact endpoint or event you are validating — never send private keys or provider credentials.