HoodFlow

HoodFlow is an independent, self-custody execution interface for Robinhood Chain. It discovers Stock Token and community-token markets, separates launchpad bonding curves from graduated DEX liquidity, compares executable routes, and lets the connected wallet sign each transaction directly.

Live product: hoodflow.app

Stock Tokens are not shares and may be restricted in your jurisdiction.

Virtuals on Robinhood Chain

HoodFlow indexes the official Virtuals Robinhood Chain launch feed and keeps bonding markets separate from graduated DEX liquidity. Graduated tokens can be quoted through USDG, VIRTUAL, or WETH; bonding tokens remain linked to their official Virtuals market until a reviewed Robinhood Chain write adapter is available.

• Open the live Virtuals Agents market
• Review the integration boundary and maintainer questions
• Inspect a block-pinned USDG → VIRTUAL → KARMA route proof
• Read the adapter implementation notes

What works today

• WalletConnect and injected-wallet connections to Robinhood Chain mainnet.
• Live onchain reference prices and history for the canonical Stock Token registry.
• Protected direct buy and sell routes through reviewed Uniswap V2, V3, and V4 liquidity.
• Community market discovery from GeckoTerminal and DEX Screener.
• Official Virtuals Robinhood Chain discovery with explicit bonding and graduated lifecycle states.
• Contract-address lookup, native quote-asset detection, minimum output, bounded slippage, and self-custody settlement.
• Durable referral profiles, verified first-trade points, and shareable links. Public Season 0 rankings are marked Coming Soon until the leaderboard opens.
• Selectable USDG, VIRTUAL, and WETH settlement with atomic V2 routing through a market's native quote token when needed.
• RAGRET 24-hour scenario receipts comparing the same hypothetical USDG notional across a Stock Token and one exact community-token contract, with shareable PNG output and no wallet or LLM dependency.

Agent execution API

HoodFlow exposes a public, read-only market resource and a bounded quote-preflight action for agents. The preflight reads the reviewed Robinhood Chain route and live oracle state, rejects excessive DEX/oracle deviation, and returns a short-lived handoff that preserves the asset, side, exact input, and slippage choice. It never submits a transaction or signs for the user; HoodFlow requests a fresh execution-bound quote before the connected wallet confirms anything.

• Open the Agents workspace
• GET /api/agents/markets — reviewed USDG markets and execution policy.
• POST /api/agents/ragret — deterministic, rate-limited RAGRET scenario receipt. It does not inspect a wallet or claim to reproduce a transaction.
• POST /api/agents/quote — indicative, rate-limited preflight with oracle-deviation protection.
• GET /api/agents/hoodflow — capability manifest and input schema.

The API surface is ready for provider onboarding, but HoodFlow is not yet published as a live Virtuals ACP provider. Registry publication, commercial terms, and any future scoped agent signer remain separate release gates.

Why the launchpad adapter exists

A launchpad token can have a pair address while still trading on a bonding curve. Treating that empty pair as a normal DEX market produces the misleading “no route” state that originally affected CLUSTY and other Virtuals prototypes.

HoodFlow fixes the general case:

1. Read the official Virtuals listing for Robinhood Chain.
2. Identify the token as bonding or graduated.
3. Keep bonding trades on the official Virtuals market.
4. Probe V2, V3, and V4 only after verifiable DEX liquidity exists.

The read adapter is in lib/launchpads/virtuals.ts. Robinhood Chain write support is deliberately not copied from Base-only SDK constants or inferred from unverified proxy calldata.

Architecture

Virtuals API ─┐
GeckoTerminal ├─ market normalization ─ lifecycle gate ─ route probe ─ wallet signature
DEX Screener ─┘                               │
                                             └─ official launchpad link (bonding)

• app/api/community-markets/route.ts — server-side discovery and normalization.
• lib/launchpads/virtuals.ts — pure Virtuals lifecycle adapter.
• app/community-tokens.tsx — market terminal and wallet-signed execution.
• lib/hoodflow-mainnet.ts — canonical addresses, ABIs, and calldata builders.
• contracts/ — bounded recurring engine and adapters; still pre-audit and gated.
• tests/ and test/ — application, release, adapter, and contract tests.

See docs/ARCHITECTURE.md and docs/VIRTUALS_ADAPTER.md for deeper notes.

Local development

Requirements: Node.js 22.13+ and npm 10.9+.

npm ci
npm run dev

Quality gates:

npm run lint
npm test
npm run contracts:compile

RPC and wallet configuration is documented in .env.example. Never commit a private key, seed phrase, production RPC secret, or funded keeper credential.

Security status

The direct swap interface is self-custodial, but the recurring contracts are pre-audit. Passing tests and fork simulations are not an audit. Known blockers and disclosure instructions are in SECURITY.md.

Contributing

Bug reports, new launchpad read adapters, route fixtures, documentation improvements, and reproducible Robinhood Chain research are welcome. Read CONTRIBUTING.md before opening a pull request.

License

MIT — see LICENSE.