@parabolicfamily/mcp 0.1.3 → 0.1.5

package/README.md

@@ -16,23 +16,28 @@ The ABIs ship with the package, so it works offline against any Arc RPC you poin
 
 ## Configure
 
-Nothing is required. Out of the box the server talks to **Arc Testnet** with the deployed Parabolic
-addresses already built in, so `npx -y @parabolicfamily/mcp` is a working install.
+Nothing is required. Out of the box the server talks to the newest Arc chain it has addresses for,
+with those addresses already built in, so `npx -y @parabolicfamily/mcp` is a working install. Since
+0.1.5 that is **Arc mainnet** (5042), live since 16 September 2026; set `PARABOLIC_CHAIN_ID=5042002`
+for Arc Testnet.
 
-Set `PARABOLIC_CHAIN_ID` and the RPC and contract addresses for that chain follow it. Arc mainnet
-(5042) opens on **16 September 2026**; its addresses ship in the release right after the deployment.
+Set `PARABOLIC_CHAIN_ID` and the RPC and contract addresses for that chain follow it. Every unsigned
+transaction the server builds carries its `chainId`, so a wallet cannot sign a testnet launch onto
+mainnet by mistake, and `protocol_stats` reports the chain and RPC host the server is actually using.
 
 | Variable | Meaning | Default |
 |---|---|---|
-| `PARABOLIC_CHAIN_ID` | 5042002 Arc Testnet, 5042 Arc mainnet | `5042002` |
+| `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_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_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_HOOK` | `ParabolicHook` address | read from `factory.memeHook()` |
 | `PARABOLIC_ARC_MEMO` | Arc `Memo` system contract | `0x5294E9927c3306DcBaDb03fe70b92e01cCede505` |
-| `PARABOLIC_LAUNCH_CONFIG_ID` | Factory launch-config index (0 = the $5K open / $12,500 graduation curve) | `0` |
+| `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) |
+| `PARABOLIC_LAUNCH_CONFIG_ID` | Factory launch-config index (0 = the $5K open / $8,000 graduation curve) | `0` |
 | `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`,
@@ -51,8 +56,16 @@ with source, before you sign anything:
 | `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) |
 
-Arc mainnet (5042) addresses ship in the release that follows the 16 September 2026 deployment.
+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
+reads it (and builds the registration for your wallet to sign); nothing on the launchpad depends on it.
+
+Arc mainnet (5042), deployed 16 September 2026 at block 21,105,294: factory
+`0x27EAeC564fd049E6920C73323ffA7eb6a32A4B1e`, memo router `0x7d642150A222D0F6c98e2fC6bBe86E8Bb6DC90d0`,
+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.
 
 ### Claude Code
 
@@ -110,13 +123,15 @@ Arguments are strict: a key a tool does not know fails with `Unrecognized key` i
 
 | Tool | Purpose |
 |---|---|
-| `parabolic.list_coins` | `{ status?: "climbing" \| "graduated", sort?: "trending" \| "new" \| "near_graduation" \| "market_cap", limit? }`. Subgraph when configured, otherwise Parabolic's public read API; a `TokenLaunched` log scan only when both are unavailable. |
+| `parabolic.list_coins` | `{ status?: "climbing" \| "graduated", sort?: "trending" \| "new" \| "near_graduation" \| "market_cap", limit?, pair?: "USDC" \| "EURC" \| "Agents" }`. Subgraph when configured, otherwise Parabolic's public read API; a `TokenLaunched` log scan only when both are unavailable. `pair` is the quote asset, except `"Agents"`, which means the coin's creator holds an ERC-8004 identity: that is read from Arc's registry (one `balanceOf` per creator, over the top 100 of the sort) whatever the listing source is. Without a registry for the chain the result sets `pairFilterApplied: false` and the `source` line says the filter did not run. |
 | `parabolic.get_coin` | `{ address }` (token or curve). Name, ticker, creator, curve, status/phase, raised/threshold/progress, price, market cap, holders, pool id, fee terms and 50/30/20 split, snipe-tax window and `currentSnipeTaxBps()`. |
 | `parabolic.quote_buy` | `{ address, quoteIn, buyer?, slippageBps? }`. Exact curve math on live reserves: fee, creator tax and snipe tax legs, spot vs effective price, price impact, whether the buy graduates the coin, suggested `minTokensOut`. `buyer` checks the snipe-tax exemption. |
 | `parabolic.quote_sell` | `{ address, tokensIn, slippageBps? }`. Gross, fee, creator tax, effective price, price impact, suggested `minQuoteOut`. |
 | `parabolic.build_buy_tx` | `{ address, quoteIn, minTokensOut?, recipient, buyer?, slippageBps?, memo? }` → unsigned `curve.buy(...)` (value = quote on native-USDC curves; an approval step for EURC pairs). `memo: { referral, note? }` returns the memo-routed variant instead (see below). |
 | `parabolic.build_sell_tx` | `{ address, tokensIn, minQuoteOut?, recipient, slippageBps? }` → unsigned ERC-20 approval + `curve.sell(...)`. |
 | `parabolic.build_launch_tx` | `{ name, ticker, image?, description?, socials?, pair?, devBuy?, creatorTaxBps?, creator, buybackEnabled? }`. The `TokenParams` are built exactly like the web Create form (economics pinned with `previewLaunchEconomics`, random salt). With `devBuy` and `PARABOLIC_MEMO_ROUTER` set: one unsigned `ParabolicMemoRouter.launchAndBuy` (value = launch fee + dev buy, `creatorFeeRecipient` zero, `minTokensOut` from the curve math on the launch config; `launchAndBuyWithToken` plus an approval for EURC). Otherwise: unsigned `factory.launchToken(...)` with the launch fee as value and, for a `devBuy`, the follow-up buy calldata to send to the curve from the `TokenLaunched` event. |
+| `parabolic.agent_status` | `{ address }`. Whether the wallet holds an ERC-8004 agent identity on Arc's `IdentityRegistry` (`balanceOf`), how many it holds, and the registry address and chain. On a chain where Arc has published no registry the answer is that fact, with `registered` and `identities` null. |
+| `parabolic.build_register_agent_tx` | `{ from, metadataURI? }` → unsigned `IdentityRegistry.register(metadataURI)` (no value). The registry mints the ERC-721 identity to the signer, so `from` is the wallet that sends it, and returns the agent id; read it from the `Transfer` log in the receipt. `metadataURI` is a pointer to the agent's metadata stored as `tokenURI` and may be empty. Warns when the wallet already holds an identity. |
 | `parabolic.protocol_stats` | Subgraph totals (launches, graduations, trades, volume, fees, daily series) plus the factory's live launch fee, curve preset, snipe-tax terms and contract addresses. |
 | `parabolic.docs` | The adopted parameters, curve mechanics, verified Arc facts and this server's configuration, as text. |
 
@@ -162,14 +177,38 @@ Launch a coin with a $200 dev buy:
 
 With `PARABOLIC_MEMO_ROUTER` set the result is `kind: "launch_and_buy"`: one `tx` to the router (`value` = $1 launch fee + $200), the encoded `params` (`creatorFeeRecipient` zero, as the router requires), the curve `terms` (opening and fully diluted graduation market caps, reserved / pool-seed / locked token shares, snipe-tax window) and `devBuy` (expected and minimum tokens, snipe-tax exempt). Without the router it is `kind: "launch"`: `tx` to the factory (value = the launch fee) and `devBuy` with the calldata for the second, snipe-tax-exempt transaction to the new curve. There is no exemption list: only the creator's own address is exempt from the snipe tax.
 
+Check whether a wallet is a registered agent, then register it:
+
+```json
+{ "name": "parabolic.agent_status", "arguments": { "address": "0xYourWallet" } }
+```
+```json
+{
+  "address": "0xYourWallet",
+  "chain": { "id": 5042002, "name": "Arc Testnet" },
+  "registry": { "address": "0x8004A818BFB912233c491871b3d84c89A494BD9e", "contract": "ERC-8004 IdentityRegistry", "operator": "Arc" },
+  "registered": false, "identities": 0
+}
+```
+```json
+{ "name": "parabolic.build_register_agent_tx", "arguments": { "from": "0xYourWallet", "metadataURI": "ipfs://…/agent-card.json" } }
+```
+
+The result is `kind: "register_agent"`: one unsigned `tx` to the registry carrying no value, the
+`metadataURI` as encoded, and `currentIdentities` for the wallet. Send it from `from`, because the
+registry mints to `msg.sender`. Once it lands, `parabolic.list_coins` with `pair: "Agents"` keeps the
+coins launched from that wallet, and the site tags them `[ Agent ]`.
+
 ## Notes on the mechanics
 
 - Curve math is a port of `ParabolicBondingCurve` / `ParabolicBondingCurveMath` (and of `web/lib/curve.ts`): fee legs are taken off the buy input separately, the constant product is priced on `getReserves()`, and a buy that would take more than `sellableTokens()` is clamped to the last sellable tokens, charged the grossed-up price and refunded the rest; that buy graduates the coin, so give it extra gas. Sells take the fee off the gross quote output and close once the curve is ready to graduate.
 - `minTokensOut` on the curve is a price bound (`spent × minTokensOut ≤ received × tokensOut`), so a clamped fill still honours the caller's terms.
 - The snipe tax decays per second along `remaining² / window²`; a quote in the launch window overstates the tax a later block charges. Pass `buyer` to have the exemption checked.
-- At graduation the curve still holds the reserved 28.57% of supply: ≈ 20.4% seeds the Uniswap v4 full-range position with the $12,500 raised at the same terminal price, and ≈ 8.2% is permanently locked. Fully diluted graduation market cap: $61,250.
+- At graduation the curve still holds the reserved 38.46% of supply: ≈ 23.7% seeds the Uniswap v4 full-range position with the $8,000 raised at the same terminal price, and ≈ 14.8% is permanently locked. Fully diluted graduation market cap: $33,800.
 - Fair launch: `ParabolicMemoRouter.launchAndBuy` / `launchAndBuyWithToken` put the creator's opening buy inside the launch transaction (snipe-tax exempt, before anyone else can trade). Called directly they work from any wallet; the router forwards no exemption list and rejects a `creatorFeeRecipient` other than zero or the signer.
 - A memo-routed buy (`memo: { referral }`) wraps `ParabolicMemoRouter.buy` inside Arc's `Memo.memo(...)` so the referral code is attributed on-chain. It is **EOA-only** (the Memo contract's caller must be `tx.origin`) and forwards no value, so the router pulls whole 6-decimal USDC units through the ERC-20 view (`0x3600…0000`) and needs a one-time approval; smart-account wallets should use the direct buy. Memo-wrapped launches (referral on a launch) are not built here.
+- Agent identity is ERC-8004 on Arc's own `IdentityRegistry` (an ERC-721 named `AgentIdentity`, symbol `AGENT`): `register(metadataURI)` mints one to the caller, `balanceOf` answers whether a wallet holds any. The registry is **not** ERC-721 Enumerable, so there is no way to list a wallet's agent ids without scanning `Transfer` logs, which public Arc RPCs cap and rate-limit; this server does not try. Arc can upgrade the registry behind its address (ERC-1967 proxy). Holding an identity is not an endorsement: registration is open to anyone.
+- `pair: "Agents"` is a property of the creator, not of the coin, so it is read at call time: one `balanceOf` per distinct creator over the top 100 coins of the sort, deduplicated and batched. A creator the registry will not answer for is left out rather than counted either way, and the `source` line reports how many. When the registry answers for nobody the list comes back empty and says so, because an unreachable registry and a board with no agent launches are not the same answer.
 - The factory has no enumeration function (only `getLaunchedToken(address)`), so listing comes from an indexer: `PARABOLIC_SUBGRAPH_URL` when set, otherwise Parabolic's public read API. Only if both are unavailable does it scan `TokenLaunched` logs, which public Arc RPCs rate-limit hard.
 
 ## Development
@@ -181,6 +220,7 @@ src/
   parabolic.ts  the service: reads (RPC + subgraph) and unsigned tx builders
   curve.ts      ported curve math
   tx.ts         viem encodeFunctionData builders (buy, sell, approve, launchToken, memo buy)
+  agents.ts     ERC-8004 identity registry: balanceOf / ownerOf / tokenURI reads, register builder
   chain.ts      viem RPC wrapper (batched HTTP) behind a small Rpc interface
   subgraph.ts   GraphQL client and Coin/Protocol shapes
   coins.ts      coin summaries, sorting

package/dist/agents.d.ts

@@ -0,0 +1,106 @@
+import { type Address } from "viem";
+import { type Rpc } from "./chain.js";
+import type { UnsignedTx } from "./tx.js";
+/**
+ * ERC-8004 agent identity on Arc.
+ *
+ * The registries are Arc's, not Parabolic's: Arc deploys them and documents them
+ * (https://docs.arc.io/arc/tutorials/register-your-first-ai-agent.md, which registers an agent with
+ * `register(string metadataURI)`). The IdentityRegistry is an ERC-1967 proxy, so Arc can change the
+ * implementation behind the address in DEPLOYMENTS without the address moving, and the facts recorded
+ * below hold for the implementation that answered on the date given.
+ *
+ * Verified against https://rpc.testnet.arc.io on 13 September 2026: name() = "AgentIdentity",
+ * symbol() = "AGENT", supportsInterface(0x80ac58cd) and (0x5b5e139f) true (ERC-721 and Metadata),
+ * balanceOf / ownerOf / tokenURI answer, and register(string) is in the implementation bytecode with
+ * selector 0xf2c298be.
+ *
+ * There is deliberately no "list this wallet's agent ids" function. supportsInterface(0x780e9d63) is
+ * false: the registry is not ERC-721 Enumerable and has neither totalSupply nor tokenOfOwnerByIndex,
+ * so the ids could only come from a Transfer log scan. Public Arc RPCs cap eth_getLogs near 10,000
+ * blocks and rate-limit the walk, which is the same cost that moved coin listing off the chain and
+ * onto an indexer. balanceOf answers the question the tools actually ask in one eth_call.
+ */
+export declare const identityRegistryAbi: readonly [{
+    readonly name: "register";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "string";
+        readonly name: "metadataURI";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "agentId";
+    }];
+}, {
+    readonly name: "balanceOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "owner";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "ownerOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "tokenURI";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "tokenId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "string";
+    }];
+}];
+/** Longest metadata URI this server encodes; a pointer, not a document. */
+export declare const MAX_METADATA_URI_BYTES = 512;
+export type AgentStatus = {
+    address: Address;
+    registered: boolean;
+    identities: number;
+};
+/** `balanceOf(owner)`: whether the wallet holds an agent identity, and how many it holds. */
+export declare function readAgentStatus(rpc: Rpc, registry: Address, owner: Address): Promise<AgentStatus>;
+/** Most wallets one listing checks against the registry: one eth_call each, batched by the transport. */
+export declare const AGENT_LOOKUP_MAX = 100;
+/**
+ * Which of these wallets hold an identity, as a set of lowercase addresses. This is how a coin list is
+ * filtered to agent launches: the flag is a property of the creator, not of the coin, so it is read
+ * per creator at call time.
+ *
+ * A read that fails is counted, not guessed: "the registry did not answer" is not "this wallet holds
+ * none", and the caller has to be able to say how many creators went unchecked.
+ */
+export declare function readAgentOwners(rpc: Rpc, registry: Address, owners: readonly Address[]): Promise<{
+    agents: Set<string>;
+    checked: number;
+    failed: number;
+}>;
+export type AgentIdentity = {
+    agentId: string;
+    owner: Address;
+    metadataURI: string;
+};
+/**
+ * One identity by agent id: the ERC-721 tokenId that `register` returns, also readable from the
+ * Transfer log in the registration receipt. The metadata URI comes back empty for an identity
+ * registered without one, which is common on Arc Testnet (tokenURI(1) is the empty string).
+ */
+export declare function readAgent(rpc: Rpc, registry: Address, agentId: bigint): Promise<AgentIdentity>;
+/** `registry.register(metadataURI)`: mints an identity to whoever signs and returns its agent id. Carries no value. */
+export declare function encodeRegisterAgent(registry: Address, metadataURI: string, chainId: number): UnsignedTx;

package/dist/agents.js

@@ -0,0 +1,87 @@
+import { encodeFunctionData, parseAbi, toHex } from "viem";
+import { mapLimit } from "./chain.js";
+import { addrOf, big, str } from "./format.js";
+/**
+ * ERC-8004 agent identity on Arc.
+ *
+ * The registries are Arc's, not Parabolic's: Arc deploys them and documents them
+ * (https://docs.arc.io/arc/tutorials/register-your-first-ai-agent.md, which registers an agent with
+ * `register(string metadataURI)`). The IdentityRegistry is an ERC-1967 proxy, so Arc can change the
+ * implementation behind the address in DEPLOYMENTS without the address moving, and the facts recorded
+ * below hold for the implementation that answered on the date given.
+ *
+ * Verified against https://rpc.testnet.arc.io on 13 September 2026: name() = "AgentIdentity",
+ * symbol() = "AGENT", supportsInterface(0x80ac58cd) and (0x5b5e139f) true (ERC-721 and Metadata),
+ * balanceOf / ownerOf / tokenURI answer, and register(string) is in the implementation bytecode with
+ * selector 0xf2c298be.
+ *
+ * There is deliberately no "list this wallet's agent ids" function. supportsInterface(0x780e9d63) is
+ * false: the registry is not ERC-721 Enumerable and has neither totalSupply nor tokenOfOwnerByIndex,
+ * so the ids could only come from a Transfer log scan. Public Arc RPCs cap eth_getLogs near 10,000
+ * blocks and rate-limit the walk, which is the same cost that moved coin listing off the chain and
+ * onto an indexer. balanceOf answers the question the tools actually ask in one eth_call.
+ */
+export const identityRegistryAbi = parseAbi([
+    "function register(string metadataURI) returns (uint256 agentId)",
+    "function balanceOf(address owner) view returns (uint256)",
+    "function ownerOf(uint256 tokenId) view returns (address)",
+    "function tokenURI(uint256 tokenId) view returns (string)",
+]);
+/** Longest metadata URI this server encodes; a pointer, not a document. */
+export const MAX_METADATA_URI_BYTES = 512;
+/** `balanceOf(owner)`: whether the wallet holds an agent identity, and how many it holds. */
+export async function readAgentStatus(rpc, registry, owner) {
+    const balance = big(await rpc.read({ address: registry, abi: identityRegistryAbi, functionName: "balanceOf", args: [owner] }));
+    return { address: owner, registered: balance > 0n, identities: Number(balance) };
+}
+/** Most wallets one listing checks against the registry: one eth_call each, batched by the transport. */
+export const AGENT_LOOKUP_MAX = 100;
+/**
+ * Which of these wallets hold an identity, as a set of lowercase addresses. This is how a coin list is
+ * filtered to agent launches: the flag is a property of the creator, not of the coin, so it is read
+ * per creator at call time.
+ *
+ * A read that fails is counted, not guessed: "the registry did not answer" is not "this wallet holds
+ * none", and the caller has to be able to say how many creators went unchecked.
+ */
+export async function readAgentOwners(rpc, registry, owners) {
+    const unique = [...new Set(owners.map((o) => o.toLowerCase()))].slice(0, AGENT_LOOKUP_MAX);
+    const agents = new Set();
+    let failed = 0;
+    await mapLimit(unique, 8, async (owner) => {
+        try {
+            const balance = big(await rpc.read({ address: registry, abi: identityRegistryAbi, functionName: "balanceOf", args: [owner] }));
+            if (balance > 0n)
+                agents.add(owner);
+        }
+        catch {
+            failed += 1;
+        }
+    });
+    return { agents, checked: unique.length, failed };
+}
+/**
+ * One identity by agent id: the ERC-721 tokenId that `register` returns, also readable from the
+ * Transfer log in the registration receipt. The metadata URI comes back empty for an identity
+ * registered without one, which is common on Arc Testnet (tokenURI(1) is the empty string).
+ */
+export async function readAgent(rpc, registry, agentId) {
+    const [owner, uri] = await Promise.all([
+        rpc.read({ address: registry, abi: identityRegistryAbi, functionName: "ownerOf", args: [agentId] }),
+        rpc.read({ address: registry, abi: identityRegistryAbi, functionName: "tokenURI", args: [agentId] }),
+    ]);
+    return { agentId: agentId.toString(), owner: addrOf(owner), metadataURI: str(uri) };
+}
+/** `registry.register(metadataURI)`: mints an identity to whoever signs and returns its agent id. Carries no value. */
+export function encodeRegisterAgent(registry, metadataURI, chainId) {
+    const data = encodeFunctionData({ abi: identityRegistryAbi, functionName: "register", args: [metadataURI] });
+    return {
+        to: registry,
+        data,
+        value: toHex(0n),
+        valueWei: "0",
+        chainId,
+        description: `ERC-8004 IdentityRegistry.register(metadataURI=${metadataURI === "" ? "(empty)" : metadataURI}): mints an agent identity to the wallet that signs`,
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

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

package/dist/config.d.ts

@@ -5,16 +5,14 @@ export declare const ARC_MEMO_DEFAULT: Address;
 export declare const USDC_VIEW: Address;
 /** `address(0)` as the pair token means the curve is quoted in native USDC. */
 export declare const NATIVE_QUOTE: Address;
-export declare const DEFAULT_CHAIN_ID = 5042002;
 export declare const DEFAULT_API_URL = "https://www.parabolic.family/api/v1";
 /**
  * Deployed Parabolic addresses per chain, so the server is useful with no configuration at all.
  * The source repository is private; these are the same addresses the site publishes at
  * https://www.parabolic.family/docs#contracts and that are verified on Arcscan.
  *
- * Arc mainnet (5042) opens on 16 September 2026. Its addresses ship in the release that follows the
- * deployment; until then a mainnet chain id resolves the RPC and nothing else, and any tool that
- * needs the factory says so.
+ * Arc mainnet (5042) opened on 16 September 2026; Parabolic deployed at block 21,105,294 and these are
+ * the live addresses (contracts/deployments/5042.json). With them in place the default chain is Arc.
  */
 export declare const DEPLOYMENTS: Record<number, {
     rpcUrl: string;
@@ -25,7 +23,23 @@ export declare const DEPLOYMENTS: Record<number, {
     startBlock?: number;
     /** The site API that serves this deployment. Production serves mainnet; the testnet site serves the testnet factory. */
     apiUrl?: string;
+    /**
+     * Arc's ERC-8004 IdentityRegistry, not one of ours. It is an ERC-1967 proxy, so Arc can upgrade the
+     * implementation behind this address at any time. Arc publishes one for Arc Testnet only, so a chain
+     * without an entry here has no registry to read rather than a missing configuration.
+     */
+    agentRegistry?: Address;
 }>;
+/**
+ * The chain an agent gets with no configuration at all: Arc mainnet once its addresses are in
+ * `DEPLOYMENTS`, Arc Testnet until then.
+ *
+ * This is derived rather than written down because the alternative is a second thing to remember on
+ * launch day. A hardcoded testnet default would survive the mainnet release and quietly hand every
+ * unconfigured agent a testnet factory, and a hardcoded mainnet default would break the server today,
+ * when chain 5042 has an RPC and no contracts. Filling in the 5042 entry moves the default with it.
+ */
+export declare const DEFAULT_CHAIN_ID: number;
 export declare const DEFAULT_RPC_URL: string;
 export type Config = {
     /** JSON-RPC endpoint for Arc. */
@@ -51,7 +65,9 @@ export type Config = {
     hook?: Address;
     /** Arc's Memo system contract. */
     arcMemo: Address;
-    /** Launch config index on the factory; preset 0 is the adopted $5K / $12,500 curve. */
+    /** Arc's ERC-8004 IdentityRegistry. Optional; undefined on a chain where Arc has published none. */
+    agentRegistry?: Address;
+    /** Launch config index on the factory; preset 0 is the adopted $5K / $8,000 curve. */
     launchConfigId: bigint;
     /** First block to scan for `TokenLaunched` logs when listing without a subgraph. */
     factoryStartBlock: bigint;
@@ -59,7 +75,23 @@ export type Config = {
 /** Environment variables the server reads, with their meaning (also rendered by `parabolic.docs`). */
 export declare const ENV_VARS: Array<[name: string, meaning: string]>;
 export declare function configFromEnv(env?: Record<string, string | undefined>): Config;
-export declare const chainName: (chainId: number) => string;
-/** Arcscan base URL for the chain, undefined where there is no explorer (Anvil). */
-export declare const explorerBase: (chainId: number) => string | undefined;
+export declare function chainName(chainId: number): string;
+/**
+ * The Parabolic site that serves this chain's deployment, with no trailing slash.
+ *
+ * Derived from the deployment's API URL so a coin link always points at the site where that coin
+ * actually exists: a testnet coin on the testnet site, a mainnet coin on parabolic.family. Hardcoding
+ * the mainnet host sent every testnet link to a page that has never heard of the coin.
+ */
+export declare function siteBase(chainId: number): string | undefined;
+/**
+ * Arcscan base URL for the chain, undefined where there is no explorer (Anvil).
+ *
+ * Arc mainnet's host is a guess: Circle has published an explorer for Arc Testnet only, and
+ * `https://explorer.arc.io` is Circle's published explorer (16 Sep 2026), behind a login at launch. `PARABOLIC_EXPLORER_URL` overrides it so a wrong guess
+ * costs an environment variable rather than a republish of this package. Read from `process.env`
+ * directly, unlike every other setting here, because this is called from `arcChain()` which builds a
+ * viem chain from a chain id alone and never sees a Config.
+ */
+export declare function explorerBase(chainId: number): string | undefined;
 export declare const explorerUrl: (chainId: number, kind: "address" | "tx", value: string) => string | undefined;

package/dist/config.js

@@ -5,16 +5,14 @@ export const ARC_MEMO_DEFAULT = "0x5294E9927c3306DcBaDb03fe70b92e01cCede505";
 export const USDC_VIEW = "0x3600000000000000000000000000000000000000";
 /** `address(0)` as the pair token means the curve is quoted in native USDC. */
 export const NATIVE_QUOTE = "0x0000000000000000000000000000000000000000";
-export const DEFAULT_CHAIN_ID = 5042002;
 export const DEFAULT_API_URL = "https://www.parabolic.family/api/v1";
 /**
  * Deployed Parabolic addresses per chain, so the server is useful with no configuration at all.
  * The source repository is private; these are the same addresses the site publishes at
  * https://www.parabolic.family/docs#contracts and that are verified on Arcscan.
  *
- * Arc mainnet (5042) opens on 16 September 2026. Its addresses ship in the release that follows the
- * deployment; until then a mainnet chain id resolves the RPC and nothing else, and any tool that
- * needs the factory says so.
+ * Arc mainnet (5042) opened on 16 September 2026; Parabolic deployed at block 21,105,294 and these are
+ * the live addresses (contracts/deployments/5042.json). With them in place the default chain is Arc.
  */
 export const DEPLOYMENTS = {
     5042002: {
@@ -24,26 +22,43 @@ export const DEPLOYMENTS = {
         eurc: "0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a",
         startBlock: 61736670,
         apiUrl: "https://parabolic-testnet.vercel.app/api/v1",
+        agentRegistry: "0x8004A818BFB912233c491871b3d84c89A494BD9e",
     },
     5042: {
-        rpcUrl: "https://rpc.arc.io",
+        rpcUrl: "https://rpc.mainnet.arc.io",
+        factory: "0x27EAeC564fd049E6920C73323ffA7eb6a32A4B1e",
+        memoRouter: "0x7d642150A222D0F6c98e2fC6bBe86E8Bb6DC90d0",
+        startBlock: 21105294,
         apiUrl: DEFAULT_API_URL,
+        // No EURC pair is approved at launch and Arc has published no ERC-8004 registry for mainnet.
     },
 };
+/**
+ * The chain an agent gets with no configuration at all: Arc mainnet once its addresses are in
+ * `DEPLOYMENTS`, Arc Testnet until then.
+ *
+ * This is derived rather than written down because the alternative is a second thing to remember on
+ * launch day. A hardcoded testnet default would survive the mainnet release and quietly hand every
+ * unconfigured agent a testnet factory, and a hardcoded mainnet default would break the server today,
+ * when chain 5042 has an RPC and no contracts. Filling in the 5042 entry moves the default with it.
+ */
+export const DEFAULT_CHAIN_ID = DEPLOYMENTS[5042].factory ? 5042 : 5042002;
 export const DEFAULT_RPC_URL = DEPLOYMENTS[DEFAULT_CHAIN_ID].rpcUrl;
 /** Environment variables the server reads, with their meaning (also rendered by `parabolic.docs`). */
 export const ENV_VARS = [
     ["PARABOLIC_RPC_URL", `Arc JSON-RPC endpoint (default ${DEFAULT_RPC_URL})`],
-    ["PARABOLIC_CHAIN_ID", `chain id (default ${DEFAULT_CHAIN_ID}, Arc Testnet)`],
+    ["PARABOLIC_CHAIN_ID", `chain id: 5042002 for Arc Testnet, 5042 for Arc (default ${DEFAULT_CHAIN_ID}, ${chainName(DEFAULT_CHAIN_ID)})`],
     ["PARABOLIC_FACTORY", "ParabolicLaunchFactory address (on-chain lookups, launch transactions, log-scan listing)"],
     ["PARABOLIC_MEMO_ROUTER", "ParabolicMemoRouter address (memo-routed buys carrying a referral code; EOA-only)"],
     ["PARABOLIC_SUBGRAPH_URL", "Parabolic subgraph endpoint (listing, holders, volume, protocol stats)"],
     ["PARABOLIC_EURC", "ERC-20 EURC address (EURC-quoted launches only)"],
     ["PARABOLIC_HOOK", "ParabolicHook address (optional; read from the factory when unset)"],
-    ["PARABOLIC_API_URL", `Parabolic public read API for listings (default: the site that serves the chain's deployment, ${DEPLOYMENTS[DEFAULT_CHAIN_ID].apiUrl} on Arc Testnet, ${DEFAULT_API_URL} on Arc; "" to use a log scan instead)`],
+    ["PARABOLIC_API_URL", `Parabolic public read API for listings (default: the site that serves the chain's deployment, ${DEPLOYMENTS[DEFAULT_CHAIN_ID].apiUrl} on ${chainName(DEFAULT_CHAIN_ID)}; "" to use a log scan instead)`],
     ["PARABOLIC_ARC_MEMO", `Arc Memo system contract (default ${ARC_MEMO_DEFAULT})`],
+    ["PARABOLIC_AGENT_REGISTRY", `Arc's ERC-8004 IdentityRegistry (agent_status, build_register_agent_tx and the list_coins pair "Agents" filter). Arc's, not ours, and Arc has published one for Arc Testnet only, so on ${chainName(DEFAULT_CHAIN_ID)} the default is ${DEPLOYMENTS[DEFAULT_CHAIN_ID].agentRegistry ?? "none and those tools say so instead of answering"}`],
     ["PARABOLIC_LAUNCH_CONFIG_ID", "factory launch config index (default 0)"],
     ["PARABOLIC_FACTORY_START_BLOCK", "first block for the TokenLaunched log scan (default: the factory's deployment block for this chain)"],
+    ["PARABOLIC_EXPLORER_URL", `block explorer base URL for building address and transaction links (default ${explorerBase(DEFAULT_CHAIN_ID) ?? "none for this chain"}; Arc mainnet's host is unconfirmed)`],
 ];
 function addr(name, v) {
     if (v === undefined || v.trim() === "")
@@ -79,13 +94,44 @@ export function configFromEnv(env = process.env) {
         eurc: addr("PARABOLIC_EURC", env.PARABOLIC_EURC) ?? known?.eurc,
         hook: addr("PARABOLIC_HOOK", env.PARABOLIC_HOOK),
         arcMemo: addr("PARABOLIC_ARC_MEMO", env.PARABOLIC_ARC_MEMO) ?? ARC_MEMO_DEFAULT,
+        agentRegistry: addr("PARABOLIC_AGENT_REGISTRY", env.PARABOLIC_AGENT_REGISTRY) ?? known?.agentRegistry,
         launchConfigId: BigInt(int("PARABOLIC_LAUNCH_CONFIG_ID", env.PARABOLIC_LAUNCH_CONFIG_ID, 0)),
         factoryStartBlock: BigInt(int("PARABOLIC_FACTORY_START_BLOCK", env.PARABOLIC_FACTORY_START_BLOCK, known?.startBlock ?? 0)),
     };
 }
-export const chainName = (chainId) => (chainId === 5042002 ? "Arc Testnet" : chainId === 5042 ? "Arc" : `chain ${chainId}`);
-/** Arcscan base URL for the chain, undefined where there is no explorer (Anvil). */
-export const explorerBase = (chainId) => chainId === 5042002 ? "https://testnet.arcscan.app" : chainId === 5042 ? "https://arcscan.app" : undefined;
+// A function declaration, not a const: ENV_VARS above is built at module load and calls this.
+export function chainName(chainId) {
+    return chainId === 5042002 ? "Arc Testnet" : chainId === 5042 ? "Arc" : `chain ${chainId}`;
+}
+/**
+ * The Parabolic site that serves this chain's deployment, with no trailing slash.
+ *
+ * Derived from the deployment's API URL so a coin link always points at the site where that coin
+ * actually exists: a testnet coin on the testnet site, a mainnet coin on parabolic.family. Hardcoding
+ * the mainnet host sent every testnet link to a page that has never heard of the coin.
+ */
+export function siteBase(chainId) {
+    const api = DEPLOYMENTS[chainId]?.apiUrl;
+    if (!api)
+        return undefined;
+    const at = api.indexOf("/api/");
+    return at === -1 ? api.replace(/\/+$/, "") : api.slice(0, at);
+}
+/**
+ * Arcscan base URL for the chain, undefined where there is no explorer (Anvil).
+ *
+ * Arc mainnet's host is a guess: Circle has published an explorer for Arc Testnet only, and
+ * `https://explorer.arc.io` is Circle's published explorer (16 Sep 2026), behind a login at launch. `PARABOLIC_EXPLORER_URL` overrides it so a wrong guess
+ * costs an environment variable rather than a republish of this package. Read from `process.env`
+ * directly, unlike every other setting here, because this is called from `arcChain()` which builds a
+ * viem chain from a chain id alone and never sees a Config.
+ */
+export function explorerBase(chainId) {
+    const override = process.env.PARABOLIC_EXPLORER_URL?.trim();
+    if (override && /^https?:\/\//i.test(override))
+        return override.replace(/\/+$/, "");
+    return chainId === 5042002 ? "https://testnet.arcscan.app" : chainId === 5042 ? "https://explorer.arc.io" : undefined;
+}
 export const explorerUrl = (chainId, kind, value) => {
     const base = explorerBase(chainId);
     return base ? `${base}/${kind}/${value}` : undefined;

package/dist/config.js.map

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

package/dist/curve.d.ts

@@ -67,7 +67,7 @@ export declare const reservedTokensFor: (supply: bigint, phantomQuote: bigint, g
  * Where the reserved tokens go at graduation. The v4 full-range position is seeded at the curve's terminal price
  * ((phantom + threshold) / reserved) with the real quote raised, which takes reserved × threshold / (phantom + threshold)
  * tokens; the rest, the phantom reserve's share, is permanently locked (GraduationTokensPermanentlyLocked).
- * Adopted parameters: 28.57% reserved → ≈ 20.4% of supply seeds the pool, ≈ 8.2% is locked.
+ * Adopted parameters: 38.46% reserved → ≈ 23.7% of supply seeds the pool, ≈ 14.8% is locked.
  */
 export declare const graduationSplit: (reservedTokens: bigint, phantomQuote: bigint, graduationThreshold: bigint) => {
     poolSeed: bigint;

package/dist/curve.js

@@ -80,7 +80,7 @@ export const reservedTokensFor = (supply, phantomQuote, graduationThreshold) =>
  * Where the reserved tokens go at graduation. The v4 full-range position is seeded at the curve's terminal price
  * ((phantom + threshold) / reserved) with the real quote raised, which takes reserved × threshold / (phantom + threshold)
  * tokens; the rest, the phantom reserve's share, is permanently locked (GraduationTokensPermanentlyLocked).
- * Adopted parameters: 28.57% reserved → ≈ 20.4% of supply seeds the pool, ≈ 8.2% is locked.
+ * Adopted parameters: 38.46% reserved → ≈ 23.7% of supply seeds the pool, ≈ 14.8% is locked.
  */
 export const graduationSplit = (reservedTokens, phantomQuote, graduationThreshold) => {
     const denominator = phantomQuote + graduationThreshold;

package/dist/docs.d.ts

@@ -1,3 +1,3 @@
 import { type Config } from "./config.js";
-/** Adopted product parameters (adopted 2026-09-06; published at https://www.parabolic.family/docs#parameters) and verified Arc facts, as text. */
+/** Adopted product parameters (adopted 2026-09-06, graduation threshold revised to $8,000 on 2026-09-16; published at https://www.parabolic.family/docs#parameters) and verified Arc facts, as text. */
 export declare function docsText(config: Config): string;