01 · docs/README.mdOpenPons manual

OpenPons

Pons, open to agents. Launch. Trade. Automate.

OpenPons is agent-native, non-custodial launch and trading infrastructure for Pons on Robinhood Chain (chainId 4663). Humans use the web app; developers use the REST API and TypeScript SDK; AI agents use the MCP server and SKILL.md. All four share one data layer built directly on the verified Pons V2 contracts.

OpenPons is independent. It is not affiliated with, endorsed by, or sponsored by Pons or Robinhood. "Built for Robinhood Chain" / "Pons-native infrastructure".

What works today (local milestone)

Surface Status Notes
Wallets (EIP-6963 + legacy) LIVE Any injected EVM wallet; provider isolation
Network handling LIVE detect / switch / add 4663; re-check before signing
Discover (new / active / graduated) BETA from factory + curve events
Token detail + trades BETA on-chain metadata, curve state, recent trades
Quotes BETA verified curve math, wei-exact vs eth_call
Buy / sell BETA prepared + simulated; sell uses exact approval
Launch BETA launchToken / launchAndBuy; logo must be a pinned URI
Portfolio / My launches BETA Transfer-log discovery + factory registry filter
Creator fees: detect / sweep / claim BETA escrow balanceOf / claim(); curve sweepFees
REST API /api/v1 BETA local only
TypeScript SDK BETA packages/sdk, not on npm
MCP server BETA packages/mcp, stdio, not on npm
Graduated-token trading (Uniswap V4) COMING SOON
Logo upload / IPFS pinning COMING SOON needs server-side pinning credentials
Hosted API / MCP / API keys COMING SOON / PREVIEW after deployment
USD values, holder counts UNAVAILABLE no verifiable source used

Repository map

src/app/             Next.js pages + /api/v1 route handlers
src/lib/chain.ts     Robinhood Chain config, RPC client (fallback, retry, gating)
src/lib/wallet/      EIP-6963 discovery + WalletProvider (single write path)
src/lib/pons/        addresses, ABIs, curve math, reads, prepare
src/components/      UI (TxFlow = preview → sign → receipt)
packages/sdk/        @openpons/sdk
packages/mcp/        @openpons/mcp (stdio)
public/SKILL.md      agent manual (also at repo root)
docs/                this documentation
tests/               node:test unit tests

Brand, token and socials

  • Official artwork: public/brand/ (sources in assets/brand-source/). Favicon/app icon: src/app/icon.png, src/app/apple-icon.png. OG/Twitter images are composed from the banner in src/app/opengraph-image.tsx.
  • $OPONS is not launched. Its status comes from one file: src/config/token.ts (address: null → PRE-LAUNCH, copy disabled). Set the real CA there once it exists and every surface switches to LIVE with copy + explorer.
  • Official X: @openpons — configured in src/config/social.ts.

Start with QUICKSTART.md. Protocol details: PONS-RESEARCH.md.

Independent · not affiliated with Pons or Robinhood@openpons