@parabolicfamily/mcp 0.1.7 → 0.2.0

package/abi/deployments.json

@@ -0,0 +1,258 @@
+{
+  "4663": {
+    "chainId": 4663,
+    "network": "robinhood-chain",
+    "timestamp": "2026-09-19T12:47:28.224Z",
+    "commit": "1667bd5",
+    "contracts": {
+      "ParabolicFeeEscrow": {
+        "address": "0x7b255064d4A26933484f376f2e4003c5AA94aBDC",
+        "block": 67093041
+      },
+      "ParabolicHook": {
+        "address": "0xD1311168793C0807B7C2Da26AC2B711E6a43E044",
+        "block": 67093085
+      },
+      "ParabolicBuybackVault": {
+        "address": "0xBD9Eb0F2F8393D52E3DF6a961d86F78A066e7B84",
+        "block": 67093110
+      },
+      "ParabolicLaunchLocker": {
+        "address": "0xEeF91089eFFFc74f4B2A19777a65a63dE8056eCB",
+        "block": 67093137
+      },
+      "ParabolicLaunchFactory": {
+        "address": "0x25c9cFa179256A29f84b9Fd0DcF7cB2ff24b473d",
+        "block": 67093163
+      },
+      "ParabolicGraduationGuard": {
+        "address": "0xe38AC7BdefF4Aace9BbAE9Be0bd8f0D2cDEFc445",
+        "block": 67093163
+      },
+      "ParabolicLaunchDeployer": {
+        "address": "0x3415976305c0Ed5DF788296Aa7DDaEDd82F57F78",
+        "block": 67093190
+      },
+      "ParabolicGraduationExecutor": {
+        "address": "0x08a828C314295CdD839c1CEfe93ccC673b2A40a9",
+        "block": 67093216
+      },
+      "ParabolicRouter": {
+        "address": "0xBa478578D8DF17ad3aaFaF9419B98CAd71321634",
+        "block": 67094134
+      }
+    },
+    "config": {
+      "launchConfigId": 0,
+      "launchForwarder": "0xBa478578D8DF17ad3aaFaF9419B98CAd71321634",
+      "quoteToken": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
+      "quoteEconomics": {
+        "phantomQuote": "5000000000",
+        "graduationThreshold": "8000000000",
+        "decimals": 6
+      },
+      "eurc": null,
+      "arcMemo": null,
+      "nativeDecimals": 18,
+      "quoteAssets": [
+        {
+          "address": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
+          "symbol": "USDG",
+          "decimals": 6
+        },
+        {
+          "address": "0x322F0929c4625eD5bAd873c95208D54E1c003b2d",
+          "symbol": "TSLA",
+          "decimals": 18
+        },
+        {
+          "address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",
+          "symbol": "NVDA",
+          "decimals": 18
+        },
+        {
+          "address": "0xaF3D76f1834A1d425780943C99Ea8A608f8a93f9",
+          "symbol": "AAPL",
+          "decimals": 18
+        }
+      ]
+    },
+    "v2": null,
+    "v4": {
+      "poolManager": {
+        "address": "0x8366a39CC670B4001A1121B8F6A443A643e40951"
+      },
+      "positionManager": {
+        "address": "0x58daec3116aae6D93017bAAea7749052E8a04fA7"
+      },
+      "permit2": {
+        "address": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
+      },
+      "stateView": {
+        "address": "0xf3334192d15450cdd385c8b70e03f9a6bd9e673b"
+      },
+      "v4Quoter": {
+        "address": "0x8dc178efb8111bb0973dd9d722ebeff267c98f94"
+      },
+      "universalRouter": {
+        "address": "0x8876789976decbfcbbbe364623c63652db8c0904"
+      }
+    }
+  },
+  "5042": {
+    "chainId": 5042,
+    "network": "arc-mainnet",
+    "timestamp": "2026-09-16T05:10:17.218Z",
+    "commit": "2c25ff2",
+    "contracts": {
+      "ParabolicFeeEscrow": {
+        "address": "0xfEd2BED46F5006f81B44f486AfbD1d9223F38A28",
+        "block": 21105294
+      },
+      "ParabolicHook": {
+        "address": "0x6B815a529598653AaF77742B04176957CeAf2044",
+        "block": 21105297
+      },
+      "ParabolicBuybackVault": {
+        "address": "0x8B2b249d70F81e839Ad47618abD8168f4F64AAb0",
+        "block": 21105301
+      },
+      "ParabolicLaunchLocker": {
+        "address": "0x14e0D76BC31a49Da950f558e91344a2bd7AA0B54",
+        "block": 21105305
+      },
+      "ParabolicLaunchFactory": {
+        "address": "0x27EAeC564fd049E6920C73323ffA7eb6a32A4B1e",
+        "block": 21105308
+      },
+      "ParabolicGraduationGuard": {
+        "address": "0x5CF0266Fb18Af98529BB62A043B6Ca813F999288",
+        "block": 21105308
+      },
+      "ParabolicLaunchDeployer": {
+        "address": "0xF74253981fCf3D08Fd01FE1c4eBbb861AfA4A115",
+        "block": 21105312
+      },
+      "ParabolicGraduationExecutor": {
+        "address": "0xb77eFe34345a699539A139743aA4173b20af80c6",
+        "block": 21105315
+      },
+      "ParabolicMemoRouter": {
+        "address": "0x7d642150A222D0F6c98e2fC6bBe86E8Bb6DC90d0",
+        "block": 21105373
+      }
+    },
+    "config": {
+      "launchConfigId": 0,
+      "launchForwarder": null,
+      "quoteToken": null,
+      "quoteEconomics": null,
+      "eurc": null,
+      "arcMemo": "0x5294E9927c3306DcBaDb03fe70b92e01cCede505",
+      "nativeDecimals": null,
+      "quoteAssets": null
+    },
+    "v2": null,
+    "v4": {
+      "poolManager": {
+        "address": "0x8366a39CC670B4001A1121B8F6A443A643e40951"
+      },
+      "positionManager": {
+        "address": "0x6049c9a0e26405C0985f9E3685C87d0aE917f82B"
+      },
+      "permit2": {
+        "address": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
+      },
+      "stateView": {
+        "address": "0xF3334192D15450CdD385c8B70e03f9A6bD9E673b"
+      },
+      "v4Quoter": {
+        "address": "0x8Dc178eFB8111BB0973Dd9d722ebeFF267c98F94"
+      },
+      "universalRouter": {
+        "address": "0x4fcA4a51Ab4F23A7447b3284fBd7D73289A89Fb1"
+      }
+    }
+  },
+  "5042002": {
+    "chainId": 5042002,
+    "network": "arc-testnet",
+    "timestamp": "2026-09-12T13:31:37.222Z",
+    "commit": "3ed705d",
+    "contracts": {
+      "ParabolicFeeEscrow": {
+        "address": "0xC372B9D7A5c35840437213D21fc80B85E0Edb96b",
+        "block": 61736654
+      },
+      "ParabolicHook": {
+        "address": "0x8c66F61C339B0adedbc33866152196256D62E044",
+        "block": 61736658
+      },
+      "ParabolicBuybackVault": {
+        "address": "0xe5fA2De1984B42f98BAEF6eb276E44111B277C8D",
+        "block": 61736662
+      },
+      "ParabolicLaunchLocker": {
+        "address": "0xb3c71648b3429414140B16a0603989E0678Aff2f",
+        "block": 61736666
+      },
+      "ParabolicLaunchFactory": {
+        "address": "0x2E06eD99bD7D164458847D186B282B23700b2C63",
+        "block": 61736670
+      },
+      "ParabolicGraduationGuard": {
+        "address": "0x8e68F53a86B6f40931B564728131F981977c7A16",
+        "block": 61736670
+      },
+      "ParabolicLaunchDeployer": {
+        "address": "0xdd0927daE105a939806e03420b91476556F16acc",
+        "block": 61736674
+      },
+      "ParabolicGraduationExecutor": {
+        "address": "0xF5654351f15c5677f9373A104c9a1dAC2106c1C0",
+        "block": 61736677
+      },
+      "ParabolicMemoRouter": {
+        "address": "0x1381567ea31a094e64f6B39Bd880d0b59c48e08F",
+        "block": 61736742
+      }
+    },
+    "config": {
+      "launchConfigId": 0,
+      "launchForwarder": null,
+      "quoteToken": null,
+      "quoteEconomics": null,
+      "eurc": "0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a",
+      "arcMemo": "0x5294E9927c3306DcBaDb03fe70b92e01cCede505",
+      "nativeDecimals": null,
+      "quoteAssets": null
+    },
+    "v2": null,
+    "v4": {
+      "poolManager": {
+        "address": "0x9536D5b6c015F3e237552215750C85D645AbA551"
+      },
+      "positionManager": {
+        "address": "0xfEd2BED46F5006f81B44f486AfbD1d9223F38A28"
+      },
+      "permit2": {
+        "address": "0x000000000022D473030F116dDEE9F6B43aC78BA3"
+      },
+      "positionDescriptor": {
+        "address": "0xa0036f24aebf61C0B4FD6Adafe045a89cD104009"
+      },
+      "stateView": {
+        "address": "0x62926aDAFaEa3D720f22f7a57E60Fde9DF5b8630"
+      },
+      "v4Quoter": {
+        "address": "0x8B2b249d70F81e839Ad47618abD8168f4F64AAb0"
+      },
+      "poolSwapTest": {
+        "address": "0x14e0D76BC31a49Da950f558e91344a2bd7AA0B54"
+      },
+      "poolModifyLiquidityTest": {
+        "address": "0x27EAeC564fd049E6920C73323ffA7eb6a32A4B1e"
+      }
+    }
+  }
+}

package/dist/abi.d.ts

@@ -6,12 +6,14 @@ import type { Abi } from "viem";
  * Override with PARABOLIC_ABI_DIR when the package is bundled elsewhere.
  */
 export declare const ABI_DIR: string;
-export declare const ABI_NAMES: readonly ["ParabolicLaunchFactory", "ParabolicBondingCurve", "ParabolicLauncherToken", "ParabolicMemoRouter"];
+export declare const ABI_NAMES: readonly ["ParabolicLaunchFactory", "ParabolicBondingCurve", "ParabolicLauncherToken", "ParabolicMemoRouter", "ParabolicAggregatorRouter"];
 export type AbiName = (typeof ABI_NAMES)[number];
 export declare function loadAbi(name: AbiName): Abi;
 export declare const factoryAbi: Abi;
 export declare const curveAbi: Abi;
 export declare const tokenAbi: Abi;
 export declare const memoRouterAbi: Abi;
+/** docs/33 §A: routed trades on another launchpad's coin (src/routed.ts). */
+export declare const aggregatorRouterAbi: Abi;
 /** Names of all functions in an ABI (used to document what the factory can and cannot enumerate). */
 export declare const functionNames: (abi: Abi) => string[];

package/dist/abi.js

@@ -8,7 +8,7 @@ import { fileURLToPath } from "node:url";
  * Override with PARABOLIC_ABI_DIR when the package is bundled elsewhere.
  */
 export const ABI_DIR = process.env.PARABOLIC_ABI_DIR ?? resolve(dirname(fileURLToPath(import.meta.url)), "..", "abi");
-export const ABI_NAMES = ["ParabolicLaunchFactory", "ParabolicBondingCurve", "ParabolicLauncherToken", "ParabolicMemoRouter"];
+export const ABI_NAMES = ["ParabolicLaunchFactory", "ParabolicBondingCurve", "ParabolicLauncherToken", "ParabolicMemoRouter", "ParabolicAggregatorRouter"];
 const cache = new Map();
 export function loadAbi(name) {
     const hit = cache.get(name);
@@ -32,6 +32,8 @@ export const factoryAbi = loadAbi("ParabolicLaunchFactory");
 export const curveAbi = loadAbi("ParabolicBondingCurve");
 export const tokenAbi = loadAbi("ParabolicLauncherToken");
 export const memoRouterAbi = loadAbi("ParabolicMemoRouter");
+/** docs/33 §A: routed trades on another launchpad's coin (src/routed.ts). */
+export const aggregatorRouterAbi = loadAbi("ParabolicAggregatorRouter");
 /** Names of all functions in an ABI (used to document what the factory can and cannot enumerate). */
 export const functionNames = (abi) => abi.flatMap((e) => (e.type === "function" ? [e.name] : []));
 //# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -1 +1 @@
-{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEtH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,wBAAwB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,qBAAqB,CAAU,CAAC;AAGvI,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;AAEtC,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC3C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,8GAA+G,CAAW,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5L,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,MAAa,CAAC;IAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAQ,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,QAAQ,GAAQ,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAQ,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAQ,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEjE,qGAAqG;AACrG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAQ,EAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEtH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,wBAAwB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,2BAA2B,CAAU,CAAC;AAGpK,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;AAEtC,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC3C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,8GAA+G,CAAW,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5L,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,MAAa,CAAC;IAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAQ,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,QAAQ,GAAQ,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAQ,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAQ,OAAO,CAAC,qBAAqB,CAAC,CAAC;AACjE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAQ,OAAO,CAAC,2BAA2B,CAAC,CAAC;AAE7E,qGAAqG;AACrG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAQ,EAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/chain.d.ts

@@ -23,8 +23,19 @@ export interface Rpc {
     read(a: ReadArgs): Promise<unknown>;
     logs(a: LogsArgs): Promise<DecodedLog[]>;
     blockNumber(): Promise<bigint>;
+    /**
+     * The head block's timestamp: the chain's clock, which a routed trade's deadline is counted from (src/routed.ts).
+     * Optional so an in-memory Rpc written before it existed still type-checks; a routed build without it refuses
+     * rather than falling back to this machine's clock, which is not the clock the router checks.
+     */
+    blockTimestamp?(): Promise<bigint>;
 }
-/** Arc chain definition for viem: native USDC with 18-decimal native accounting. */
+/**
+ * The viem chain for `chainId`, from the registry (src/chains.ts): its own gas token and explorer. It was Arc's for
+ * every id, native USDC and an explorer called Arcscan, so Robinhood Chain was defined as a chain whose gas is USDC
+ * (CON-45, 30 Sep 2026). Internal, never emitted, which is why it was wrong for eleven days with nothing red. A chain
+ * the registry has no gas token for keeps Arc's shape, the one this server was written against.
+ */
 export declare function arcChain(chainId: number, rpcUrl: string): Chain;
 /** viem-backed Rpc. HTTP batching folds the many small reads of get_coin / list_coins into a few JSON-RPC requests. */
 export declare function viemRpc(rpcUrl: string, chainId: number): Rpc;

package/dist/chain.js

@@ -1,15 +1,23 @@
 import { createPublicClient, defineChain, getAbiItem, http } from "viem";
+import { chainFor } from "./chains.js";
 import { chainName, explorerBase } from "./config.js";
-/** Arc chain definition for viem: native USDC with 18-decimal native accounting. */
+/**
+ * The viem chain for `chainId`, from the registry (src/chains.ts): its own gas token and explorer. It was Arc's for
+ * every id, native USDC and an explorer called Arcscan, so Robinhood Chain was defined as a chain whose gas is USDC
+ * (CON-45, 30 Sep 2026). Internal, never emitted, which is why it was wrong for eleven days with nothing red. A chain
+ * the registry has no gas token for keeps Arc's shape, the one this server was written against.
+ */
 export function arcChain(chainId, rpcUrl) {
+    const info = chainFor(chainId);
     const explorer = explorerBase(chainId);
+    const gas = info?.native ?? { name: "USDC", symbol: "USDC", decimals: 18 };
     return defineChain({
         id: chainId,
         name: chainName(chainId),
-        nativeCurrency: { name: "USDC", symbol: "USDC", decimals: 18 },
+        nativeCurrency: { name: gas.name, symbol: gas.symbol, decimals: gas.decimals },
         rpcUrls: { default: { http: [rpcUrl] } },
-        ...(explorer ? { blockExplorers: { default: { name: "Arcscan", url: explorer } } } : {}),
-        testnet: chainId !== 5042,
+        ...(explorer ? { blockExplorers: { default: { name: info?.explorerName ?? "Explorer", url: explorer } } } : {}),
+        testnet: info?.testnet ?? chainId !== 5042,
     });
 }
 /** viem-backed Rpc. HTTP batching folds the many small reads of get_coin / list_coins into a few JSON-RPC requests. */
@@ -32,6 +40,7 @@ export function viemRpc(rpcUrl, chainId) {
         // viem caches the block number for four seconds by default; the log scan uses it as the top of
         // its newest window, so a coin launched in that window was missed. Always read the real head.
         blockNumber: () => client.getBlockNumber({ cacheTime: 0 }),
+        blockTimestamp: async () => (await client.getBlock({ blockTag: "latest" })).timestamp,
     };
 }
 /** Runs `fn` over `items` with at most `limit` in flight, preserving order. */

package/dist/chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}

package/dist/chains.d.ts

@@ -9,9 +9,9 @@ import { type Address } from "viem";
  * published tool's input without a version break.
  *
  * The registry is small on purpose. It carries what a *reference* needs — an id, a prefix, a name, an
- * explorer — while the deployed addresses stay in `DEPLOYMENTS` (src/config.ts), keyed by the same chain
- * id and written from `contracts/deployments/<chainId>.json`. A chain can be nameable here long before
- * anything of ours is deployed on it, which is exactly the state Robinhood Chain is in.
+ * explorer — while the deployed addresses stay in `DEPLOYMENTS` (src/config.ts), which reads them out of
+ * `abi/deployments.json` (src/deployed.ts) rather than carrying them as literals. A chain can be nameable
+ * here long before anything of ours is deployed on it, which is the state Base, Ethereum and BNB are in.
  */
 /**
  * A chain's stable name in configuration, logs and the `chain` field of an answer. The same set
@@ -35,19 +35,26 @@ export type ChainInfo = {
         decimals: number;
         dollar: boolean;
     };
+    /** What the explorer calls itself (Arcscan, Blockscout), for viem's `blockExplorers.default.name`; bot/src/chains.ts carries the same. */
+    explorerName?: string;
     explorer?: string;
     testnet: boolean;
-    /** Whether Parabolic is deployed and served there today. */
+    /**
+     * Whether Parabolic is deployed and served there today. **Derived, never written** (23 Sep 2026, F50):
+     * it is true when this package ships that chain's factory address in `abi/deployments.json`, which is
+     * what makes an unconfigured server able to read the chain. Typed by hand it stayed false on Robinhood
+     * Chain for four days after the deploy, and `assertChain` told every agent so in those words.
+     */
     live: boolean;
 };
 /**
- * Arc mainnet and Arc Testnet, with the explorer hosts this package has always used (Arc mainnet's is
- * Circle's `explorer.arc.io`, published 16 Sep 2026, behind a login at launch; `PARABOLIC_EXPLORER_URL`
- * still overrides both).
+ * Arc mainnet and Arc Testnet, with the explorer hosts each chain answers on today (Arc mainnet's is
+ * Circle's `explorer.arc.io`, published 16 Sep 2026, behind a login at launch; the testnet's moved on
+ * 23 Sep 2026, see the entry below; `PARABOLIC_EXPLORER_URL` still overrides both).
  *
- * Robinhood Chain (4663, from docs/20-multichain.md §1, verified 18 Sep 2026 against chain docs) is here
- * so a reference and an error message can name it. It has no gas token and no explorer written down,
- * because neither has been read in this repo, and nothing here invents either.
+ * Robinhood Chain (4663) is served since 23 Sep 2026, the day this package stopped writing `live` by hand.
+ * Base, Ethereum, BNB and Anvil are here so a reference and an error message can name them, and carry no
+ * gas token, because nothing in this repo has read one and nothing here invents one.
  */
 export declare const CHAINS: Record<number, ChainInfo>;
 /** Arc mainnet: the chain an unqualified identifier means. */

package/dist/chains.js

@@ -1,21 +1,33 @@
 import { getAddress, isAddress } from "viem";
+import { isDeployedOn } from "./deployed.js";
+/** A chain is live because its deployment record says so; see `ChainInfo.live`. */
+const served = (chainId) => isDeployedOn(chainId);
 /**
- * Arc mainnet and Arc Testnet, with the explorer hosts this package has always used (Arc mainnet's is
- * Circle's `explorer.arc.io`, published 16 Sep 2026, behind a login at launch; `PARABOLIC_EXPLORER_URL`
- * still overrides both).
+ * Arc mainnet and Arc Testnet, with the explorer hosts each chain answers on today (Arc mainnet's is
+ * Circle's `explorer.arc.io`, published 16 Sep 2026, behind a login at launch; the testnet's moved on
+ * 23 Sep 2026, see the entry below; `PARABOLIC_EXPLORER_URL` still overrides both).
  *
- * Robinhood Chain (4663, from docs/20-multichain.md §1, verified 18 Sep 2026 against chain docs) is here
- * so a reference and an error message can name it. It has no gas token and no explorer written down,
- * because neither has been read in this repo, and nothing here invents either.
+ * Robinhood Chain (4663) is served since 23 Sep 2026, the day this package stopped writing `live` by hand.
+ * Base, Ethereum, BNB and Anvil are here so a reference and an error message can name them, and carry no
+ * gas token, because nothing in this repo has read one and nothing here invents one.
  */
 export const CHAINS = {
-    5042: { id: 5042, key: "arc", prefix: "", name: "Arc", native: { name: "USDC", symbol: "USDC", decimals: 18, dollar: true }, explorer: "https://explorer.arc.io", testnet: false, live: true },
-    5042002: { id: 5042002, key: "arc-testnet", prefix: "", name: "Arc Testnet", native: { name: "USDC", symbol: "USDC", decimals: 18, dollar: true }, explorer: "https://testnet.arcscan.app", testnet: true, live: true },
-    4663: { id: 4663, key: "rhc", prefix: "rhc", name: "Robinhood Chain", testnet: false, live: false },
-    8453: { id: 8453, key: "base", prefix: "base", name: "Base", testnet: false, live: false },
-    1: { id: 1, key: "eth", prefix: "eth", name: "Ethereum", testnet: false, live: false },
-    56: { id: 56, key: "bnb", prefix: "bnb", name: "BNB Chain", testnet: false, live: false },
-    31337: { id: 31337, key: "anvil", prefix: "anvil", name: "Anvil", testnet: true, live: false },
+    5042: { id: 5042, key: "arc", prefix: "", name: "Arc", native: { name: "USDC", symbol: "USDC", decimals: 18, dollar: true }, explorer: "https://explorer.arc.io", explorerName: "Arcscan", testnet: false, live: served(5042) },
+    // The testnet's host moved: `testnet.arcscan.app` answers 301 to `explorer.testnet.arc.io` (measured
+    // 23 Sep 2026, F49). Every `links.token` this package publishes followed the redirect and still landed, so
+    // nothing was broken; it is written as the host that answers because web/lib/chains.ts and bot/src/chains.ts
+    // moved the same day, and one chain named two ways in three registries is how a stale host survives.
+    5042002: { id: 5042002, key: "arc-testnet", prefix: "", name: "Arc Testnet", native: { name: "USDC", symbol: "USDC", decimals: 18, dollar: true }, explorer: "https://explorer.testnet.arc.io", explorerName: "Arcscan", testnet: true, live: served(5042002) },
+    // Deployed 19 Sep 2026 (contracts/deployments/4663.json), and its gas asset filled in here on 20 Sep. ETH
+    // at 18 decimals is the scale the deploy MEASURED against the WETH9 that chain's own PositionManager names
+    // and wrote into `config.nativeDecimals`, not a figure taken from a doc; `dollar: false` is why no balance
+    // or launch fee on this chain may be reported as money in dollars. The Blockscout instance is the one the
+    // chain lists and the one contracts/scripts/verify-arcscan.sh has on record.
+    4663: { id: 4663, key: "rhc", prefix: "rhc", name: "Robinhood Chain", native: { name: "Ether", symbol: "ETH", decimals: 18, dollar: false }, explorer: "https://robinhoodchain.blockscout.com", explorerName: "Blockscout", testnet: false, live: served(4663) },
+    8453: { id: 8453, key: "base", prefix: "base", name: "Base", testnet: false, live: served(8453) },
+    1: { id: 1, key: "eth", prefix: "eth", name: "Ethereum", testnet: false, live: served(1) },
+    56: { id: 56, key: "bnb", prefix: "bnb", name: "BNB Chain", testnet: false, live: served(56) },
+    31337: { id: 31337, key: "anvil", prefix: "anvil", name: "Anvil", testnet: true, live: served(31337) },
 };
 /** Arc mainnet: the chain an unqualified identifier means. */
 export const ARC = 5042;

package/dist/chains.js.map

@@ -1 +1 @@
-{"version":3,"file":"chains.js","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"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"}

package/dist/coins.d.ts

@@ -1,4 +1,5 @@
 import { type Address } from "viem";
+import { type QuoteBlock } from "./quote-unit.js";
 import type { GqlCoin } from "./subgraph.js";
 export type StatusKey = "climbing" | "graduated";
 export declare const SORT_KEYS: readonly ["trending", "new", "near_graduation", "market_cap"];
@@ -9,9 +10,19 @@ export type CoinSummary = {
     name: string;
     ticker: string;
     creator: Address;
-    pair: "USDC" | "EURC";
+    /**
+     * What the coin's money is called — the asset's own symbol, whatever it is.
+     *
+     * It was the literal union `"USDC" | "EURC"` until 20 September 2026, which is Arc's two answers written
+     * into a type: every coin on any other chain was reported to an agent as an EURC while every figure beside
+     * it was right, and src/restapi.ts had to cast a real symbol back through it to compile.
+     */
+    pair: string;
     pairToken: Address;
+    /** Read from the asset's own `decimals()`, or from the chain's gas asset. Never derived from `pairToken`. */
     quoteDecimals: number;
+    /** What the money IS: whether it is a dollar, what kind of asset it is, who issues it. See src/quote-unit.ts. */
+    quote: QuoteBlock;
     status: StatusKey;
     /** Quote raised on the curve (net of fees), whole units; for a graduated coin the threshold it crossed. */
     raised: string;
@@ -36,7 +47,22 @@ export type CoinSummary = {
     source: "subgraph" | "api" | "chain";
 };
 export declare const isNative: (pairToken: string) => boolean;
-export declare const quoteDecimalsOf: (pairToken: string) => number;
+/**
+ * The scale a coin's quote amounts are written at, from the only two sources that have ever read it.
+ *
+ * This was `isNative(pairToken) ? 18 : 6` — Arc's own two answers, typed out, and the same pair of literals
+ * web/lib/data.ts and bot/src/chain.ts carried until 18 September 2026. The 18 is right only where the gas
+ * token is an 18-decimal dollar, and the 6 is right only for EURC on Arc: USDC is a **6-decimal ERC-20** on
+ * Base, Ethereum and BNB, all three of them chains on the plan, so every `raisedRaw` and `thresholdRaw` this
+ * produced there was out by a factor of a trillion — inside calldata an agent signs, with nothing to say so.
+ *
+ * `indexed` is the coin's own `Coin.quoteDecimals`, which the indexer writes at launch from the factory's
+ * re-read of the asset's `decimals()` — the chain's answer for *that launch*. Without it, a gas-asset quote
+ * falls back to the chain registry, whose figures were read off the chain when the chain was added. Neither
+ * available means **nothing is returned**: a caller must refuse a figure it cannot scale rather than pick a
+ * number (docs/20-multichain.md §3).
+ */
+export declare function quoteDecimalsOf(pairToken: string, indexed: number | null | undefined, chainId: number): number | undefined;
 /** Curve progress in percent with three decimals, capped at 100. */
 export declare const progressPct: (raised: bigint, threshold: bigint) => number;
 /**
@@ -47,6 +73,15 @@ export declare function dayStats(g: GqlCoin, now: number, quoteDecimals: number)
     volume24h: number;
     change24h: number;
 };
-export declare function summaryFromGql(g: GqlCoin, now?: number): CoinSummary;
+/**
+ * A subgraph row as a coin summary.
+ *
+ * `chainId` is the chain the subgraph is indexing, and it is required because the scale of the row's amounts
+ * is not inferable from the row: `Coin.quoteDecimals` when the endpoint carries it (subgraph 0.3.0 and later),
+ * and otherwise that chain's gas asset for a native-quoted coin. A row nothing can scale **throws**, because
+ * every figure below it — raised, threshold, price, volume — would be wrong by orders of magnitude and would
+ * look entirely ordinary.
+ */
+export declare function summaryFromGql(g: GqlCoin, now?: number, chainId?: number, knownDecimals?: number): CoinSummary;
 /** Pure sort used by list_coins; `near_graduation` ranks climbing coins by progress and puts graduated ones last. */
 export declare function sortCoins(list: CoinSummary[], sort: SortKey): CoinSummary[];