@parabolicfamily/mcp 0.1.8 → 0.2.0

package/README.md

@@ -22,6 +22,44 @@ and whether `<ticker>.parabolic.family` is free. It is advice and not a gate —
 unique symbol — and the hostname is the one exclusive thing, held by the oldest coin with that ticker. The
 ticker is normalised the way the site normalises it, so an impossible one is refused before a request is spent.
 
+## What changed in 0.2.0
+
+Five tools for coins made on **other launchpads** (pons on Robinhood Chain, SolonPad on Arc), traded through
+Parabolic's aggregator router; every call that worked in 0.1.9 works unchanged.
+
+- `parabolic.list_venue_coins` reads that launchpad's subgraph when `PARABOLIC_SUBGRAPH_URL_PONS_RHC` (or
+  `..._SOLONPAD_ARC`) is set.
+- `parabolic.quote_routed_buy` / `quote_routed_sell` and `build_routed_buy_tx` / `build_routed_sell_tx` encode
+  `ParabolicAggregatorRouter.buy` / `sell` byte for byte as the site does, with no fee voucher and, for an ERC-20
+  input, an exact-amount approval of the router in place of the site's Permit2 signature. The coin lives on the
+  other launchpad's contracts; the router charges Parabolic's routed fee (its `defaultFeeBps`, 60 bps at deploy)
+  on top of that launchpad's own, and every answer shows both.
+- They refuse, by name, until the chain's deployment record carries the router under `aggregator`, when the
+  router has the launchpad switched off, when the coin is not that launchpad's, and when any read fails.
+
+## What changed in 0.1.9
+
+0.1.9 makes **Robinhood Chain (4663) a chain this server serves**. Every call that worked before works
+unchanged and means the same chain it meant: an unqualified address is still Arc, permanently.
+
+- **Set `PARABOLIC_CHAIN_ID=4663` and nothing else.** The chain's public RPC, its factory and its start
+  block ship with the package, read from the deploy's own record rather than typed in. Until 0.1.9 the
+  server answered `chain: "rhc"` with "Parabolic is not deployed on Robinhood Chain yet", which had been
+  false since 19 September 2026, and an operator who set the chain id got Arc's RPC and no factory.
+- **`list_coins` reaches that board.** One site serves both, and it answers for its own chain when nothing
+  names one, so the listing now names the chain (`?chain=rhc`) the way the Telegram bot does. Arc's URLs
+  are byte-identical to what they have always been, because Arc's prefix is empty.
+- **No routed buy there yet.** The chain deploys `ParabolicRouter`, which takes the referral code and the
+  note as arguments; `ParabolicMemoRouter` is Arc's and the two share no function selector, so this
+  package encodes no routed call on chain 4663. `build_buy_tx` goes straight to the curve and
+  `build_launch_tx` to the factory, which is the same call on every chain. The referral share itself is
+  paid on that chain, credited by the indexer through the same ledger as Arc's memo, so what is missing
+  here is the encoder and not the payout: `parabolic.docs` and the buy payload both say so, and passing
+  `memo` is refused by name rather than by asking for a variable that must stay unset.
+- **`parabolic.docs` states Arc mainnet as live.** It described chain 5042 as "unofficial until Circle
+  publishes it" and Arc's launch fee as 1e18; mainnet has been public since 16 September 2026 and the fee
+  has been 0 since the 19th. The fee is read from the factory and never written down.
+
 ## What changed in 0.1.7 (for an existing consumer: nothing has to)
 
 0.1.7 makes the server chain-aware. **Every call that worked in 0.1.6 works unchanged and means the same
@@ -52,13 +90,13 @@ mainnet by mistake, and `protocol_stats` reports the chain and RPC host the serv
 
 | Variable | Meaning | Default |
 |---|---|---|
-| `PARABOLIC_CHAIN_ID` | 5042002 Arc Testnet, 5042 Arc mainnet | `5042` |
-| `PARABOLIC_RPC_URL` | Arc JSON-RPC endpoint | the public endpoint for the chain id |
+| `PARABOLIC_CHAIN_ID` | 5042 Arc mainnet, 5042002 Arc Testnet, 4663 Robinhood Chain | `5042` |
+| `PARABOLIC_RPC_URL` | JSON-RPC endpoint | the public endpoint for the chain id |
 | `PARABOLIC_FACTORY` | `ParabolicLaunchFactory`: coin lookups and launch transactions | the deployment for the chain id |
-| `PARABOLIC_MEMO_ROUTER` | `ParabolicMemoRouter`: the atomic launch-and-buy and the referral-carrying buy | the deployment for the chain id |
+| `PARABOLIC_MEMO_ROUTER` | `ParabolicMemoRouter`: the atomic launch-and-buy and the referral-carrying buy. Refused on a chain whose record deploys `ParabolicRouter` and no memo router, because the two share no function selector and a routed build against that address would revert | the deployment for the chain id |
 | `PARABOLIC_EURC` | EURC address, only for EURC-quoted coins | the deployment for the chain id |
 | `PARABOLIC_SUBGRAPH_URL` | Subgraph endpoint: richer listings, holders, 24h volume, protocol stats | unset (the public API is used instead) |
-| `PARABOLIC_EXPLORER_URL` | Block explorer the address and transaction links are built from | Arcscan for the chain id; Arc mainnet's host is unconfirmed |
+| `PARABOLIC_EXPLORER_URL` | Block explorer the address and transaction links are built from | the explorer for the chain id |
 | `PARABOLIC_HOOK` | `ParabolicHook` address | read from `factory.memeHook()` |
 | `PARABOLIC_ARC_MEMO` | Arc `Memo` system contract | `0x5294E9927c3306DcBaDb03fe70b92e01cCede505` |
 | `PARABOLIC_AGENT_REGISTRY` | Arc's ERC-8004 `IdentityRegistry`: `agent_status`, `build_register_agent_tx` and the `pair: "Agents"` listing filter | the registry Arc publishes for the chain id (Arc Testnet only, today) |
@@ -66,7 +104,8 @@ mainnet by mistake, and `protocol_stats` reports the chain and RPC host the serv
 | `PARABOLIC_FACTORY_START_BLOCK` | First block of the `TokenLaunched` scan, used only when neither a subgraph nor the API is available | the factory's deployment block |
 
 The API default follows the chain: Arc Testnet reads the testnet site (`https://parabolic-testnet.vercel.app/api/v1`,
-live testnet data), Arc reads `https://www.parabolic.family/api/v1`. Running against a fork or your own
+live testnet data), Arc and Robinhood Chain both read `https://www.parabolic.family/api/v1`, which serves
+both boards and is asked for the right one by name. Running against a fork or your own
 factory: the server skips the site's API automatically whenever `PARABOLIC_FACTORY` differs from the
 built-in address for the chain or `PARABOLIC_RPC_URL` points anywhere but the chain's own endpoint, and
 reads the chain instead. To force that for any other reason, set `PARABOLIC_API_URL=""`.
@@ -77,11 +116,11 @@ with source, before you sign anything:
 
 | Contract | Arc Testnet (5042002) |
 |---|---|
-| `ParabolicLaunchFactory` | [`0x2E06eD99bD7D164458847D186B282B23700b2C63`](https://testnet.arcscan.app/address/0x2E06eD99bD7D164458847D186B282B23700b2C63) |
-| `ParabolicMemoRouter` | [`0x1381567ea31a094e64f6B39Bd880d0b59c48e08F`](https://testnet.arcscan.app/address/0x1381567ea31a094e64f6B39Bd880d0b59c48e08F) |
-| EURC (test token) | [`0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a`](https://testnet.arcscan.app/address/0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a) |
-| Arc `Memo` (system) | [`0x5294E9927c3306DcBaDb03fe70b92e01cCede505`](https://testnet.arcscan.app/address/0x5294E9927c3306DcBaDb03fe70b92e01cCede505) |
-| ERC-8004 `IdentityRegistry` (Arc's) | [`0x8004A818BFB912233c491871b3d84c89A494BD9e`](https://testnet.arcscan.app/address/0x8004A818BFB912233c491871b3d84c89A494BD9e) |
+| `ParabolicLaunchFactory` | [`0x2E06eD99bD7D164458847D186B282B23700b2C63`](https://explorer.testnet.arc.io/address/0x2E06eD99bD7D164458847D186B282B23700b2C63) |
+| `ParabolicMemoRouter` | [`0x1381567ea31a094e64f6B39Bd880d0b59c48e08F`](https://explorer.testnet.arc.io/address/0x1381567ea31a094e64f6B39Bd880d0b59c48e08F) |
+| EURC (test token) | [`0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a`](https://explorer.testnet.arc.io/address/0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a) |
+| Arc `Memo` (system) | [`0x5294E9927c3306DcBaDb03fe70b92e01cCede505`](https://explorer.testnet.arc.io/address/0x5294E9927c3306DcBaDb03fe70b92e01cCede505) |
+| ERC-8004 `IdentityRegistry` (Arc's) | [`0x8004A818BFB912233c491871b3d84c89A494BD9e`](https://explorer.testnet.arc.io/address/0x8004A818BFB912233c491871b3d84c89A494BD9e) |
 
 The identity registry is **Arc's contract, not ours**: Arc deploys it, documents it and can change it.
 It is an ERC-1967 proxy, so the implementation behind that address is upgradeable by Arc. Parabolic only
@@ -92,6 +131,12 @@ Arc mainnet (5042), deployed 16 September 2026 at block 21,105,294: factory
 source verified on Sourcify. Arc has published no identity registry for mainnet, so on chain 5042
 `agent_status` says there is no registry rather than reporting a wallet as unregistered.
 
+Robinhood Chain (4663), deployed 19 September 2026: factory
+`0x25c9cFa179256A29f84b9Fd0DcF7cB2ff24b473d`, quoted in USDG (`0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168`,
+six decimals, Paxos), gas paid in ETH, source verified on Sourcify. Gas there is not a dollar, so a launch
+fee or a balance on that chain is never a figure in dollars, and no identity registry exists. The chain's
+`ParabolicRouter` is deliberately not configured here; see 0.1.9 above.
+
 ### Claude Code
 
 ```sh