@arcnow/mcp 0.1.0

package/dist/format.js

@@ -0,0 +1,164 @@
+/**
+ * How numbers and addresses reach the model.
+ *
+ * # Every amount is printed with its own quote token, every time
+ *
+ * A curve is priced in one quote token for life: native USDC (18 decimals, the
+ * gas currency) or an allowlisted ERC-20 such as EURC (6 decimals). An amount
+ * is a `QuoteAmount` from the SDK, which carries the token it is denominated
+ * in, so a figure is always printed as `1.5 EURC` or `25 USDC` — the symbol of
+ * the quote it is actually in, never "USDC" for a EURC amount.
+ *
+ * On Arc, native USDC is 18-decimal and the USDC ERC-20 predeploy is the same
+ * asset at **6**. A bare `1000000` is a dollar under one reading and a
+ * millionth of a dollar under the other, which is why nothing here ever emits
+ * a bare number for money.
+ *
+ * # Text, not structured content
+ *
+ * Every tool returns one readable report. There is no parallel
+ * `structuredContent` payload, and that is a choice: two renderings of the same
+ * numbers is two places for a unit to be wrong, and only one of them is the one
+ * a person reads when they check what the assistant was told. The report
+ * carries exact decimal strings, so nothing is lost to rounding on the way.
+ *
+ * @module
+ */
+import { getAddress } from "viem";
+import { QuoteAmount, WAD } from "@arcnow/sdk";
+/** The zero address, which on Arc is a real account, not a null. */
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** `123.75 USDC`, `1.5 EURC`: always with the symbol of the quote the amount is in. */
+export function money(amount) {
+    return amount.format();
+}
+/** Money plus its raw integers, for anything that has to be exact. */
+export function moneyExact(amount) {
+    const raw = amount.isRepresentable() ? `, ${amount.toRaw()} raw at ${amount.token.decimals} decimals` : "";
+    return `${amount.format()} (${amount.wad} wad${raw})`;
+}
+export function qty(amount, symbol) {
+    return symbol === undefined ? amount.toString() : `${amount.toString()} ${symbol}`;
+}
+/** A price is the quote **per whole token**; saying so every time is the point. */
+export function price(p) {
+    return `${p.toString()} ${p.token.symbol} per token`;
+}
+/**
+ * One quote token, said in full: `EURC — ERC-20 0x89b5…, 6 decimals` or
+ * `USDC — native (the gas currency, paid as msg.value), 18 decimals`.
+ */
+export function quoteLine(token) {
+    return token.isNative
+        ? `${token.symbol} — native, the gas currency, paid as msg.value (${addr(token.address)}), `
+            + `${token.decimals} decimals`
+        : `${token.symbol} (${token.name}) — ERC-20 at ${addr(token.address)}, ${token.decimals} decimals, `
+            + "pulled with an exact ERC-20 approval";
+}
+/** Checksummed, because that is the form a person pastes back. */
+export function addr(value) {
+    try {
+        return getAddress(value);
+    }
+    catch {
+        return value;
+    }
+}
+/** A share of the fee, said both ways — the single easiest thing to misread. */
+export function share(bps, tradeFeeBps) {
+    return `${bps.bps} bps of the fee (${bps.percentOfFee()}% of the fee, `
+        + `${bps.percentOfTrade(tradeFeeBps)}% of a trade)`;
+}
+/** Graduation progress. `progressBps` is out of 10,000, not out of 100. */
+export function progress(bps) {
+    const percent = Number(bps.bps) / 100;
+    return `${percent.toFixed(2)}% (${bps.bps} / 10000 bps)`;
+}
+/**
+ * The average price a whole order actually filled at.
+ *
+ * Not the same number as `spotPrice`, which is the marginal price of the next
+ * infinitesimal token. The curve integrates price across an order, so a buyer
+ * pays a rising price over their own trade and this is what they paid.
+ */
+export function effectivePrice(spent, received) {
+    if (received.wad === 0n)
+        return undefined;
+    return QuoteAmount.fromWad(spent.token, (spent.wad * WAD) / received.wad);
+}
+/** Percentage difference between two prices in the same quote, as a signed string. */
+export function priceMove(from, to) {
+    if (from.wad === 0n)
+        return "n/a (the curve had no price to move from)";
+    const deltaBps = ((to.wad - from.wad) * 10000n) / from.wad;
+    const percent = Number(deltaBps) / 100;
+    return `${percent >= 0 ? "+" : ""}${percent.toFixed(4)}%`;
+}
+/**
+ * Which venue a migrator address is, by asking the deployment rather than
+ * assuming. A token graduates to the migrator **its own curve snapshotted at
+ * launch**, which need not be the one this network would choose today.
+ */
+export function venueOf(migrator, config) {
+    const known = [
+        [config.contracts.v4Migrator, "Uniswap v4"],
+        [config.contracts.v3Migrator, "Uniswap v3"],
+        [config.contracts.v2Migrator, "Uniswap v2"],
+        [config.contracts.escrowMigrator, "escrow (custodial)"],
+    ];
+    const lower = migrator.toLowerCase();
+    for (const [address, name] of known) {
+        if (address !== undefined && address.toLowerCase() === lower)
+            return name;
+    }
+    if (migrator.toLowerCase() === ZERO_ADDRESS) {
+        return "none — the zero address, which on Arc is a real account and not a null";
+    }
+    return "an address this deployment's preset does not name — verify it before trusting it";
+}
+// ── the curve ──────────────────────────────────────────────────────────────
+/**
+ * A curve's immutable parameters. arcnow.io has one curve, the constant-product
+ * `arcnow/bonding-curve@3.x.x`, and the SDK prices no other: `r0Wad` is its
+ * virtual quote reserve at launch, in 18-decimal WAD of its quote token, and
+ * `y0Wad` its virtual token reserve at launch.
+ */
+export function curveParamsLine(params, quote) {
+    return `r0Wad ${params.r0Wad} (the virtual ${quote.symbol} reserve at launch, in WAD), `
+        + `y0Wad ${params.y0Wad} (the virtual token reserve at launch) — immutable`;
+}
+/** A titled block of `label  value` lines. */
+export function section(title, rows) {
+    const width = rows.reduce((w, [label]) => Math.max(w, label.length), 0);
+    const body = rows.map(([label, value]) => `  ${label.padEnd(width)}  ${value}`).join("\n");
+    return `${title}\n${body}`;
+}
+/** Joins sections with a blank line, dropping the ones that had nothing to say. */
+export function report(...parts) {
+    return parts.filter((p) => p !== undefined && p !== "").join("\n\n");
+}
+/** A paragraph the model is meant to act on, set apart from the figures. */
+export function note(text) {
+    return wrap(text, 88);
+}
+function wrap(text, width) {
+    const out = [];
+    for (const paragraph of text.split("\n")) {
+        let line = "";
+        for (const word of paragraph.split(/\s+/)) {
+            if (line === "") {
+                line = word;
+            }
+            else if (line.length + 1 + word.length <= width) {
+                line += ` ${word}`;
+            }
+            else {
+                out.push(line);
+                line = word;
+            }
+        }
+        out.push(line);
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * The entry point: read the configuration, say what mode it produced, connect.
+ *
+ * # stdout belongs to the protocol
+ *
+ * An MCP stdio server speaks JSON-RPC over stdout. One stray byte there — a
+ * `console.log`, a library's banner, a warning — corrupts a frame and the
+ * client's connection with it. So **everything** this process says to a human
+ * goes to stderr, and the rule holds for the whole codebase: there is no
+ * `console.log` anywhere in `src/`, and the tools return text to the client
+ * rather than printing it.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * The entry point: read the configuration, say what mode it produced, connect.
+ *
+ * # stdout belongs to the protocol
+ *
+ * An MCP stdio server speaks JSON-RPC over stdout. One stray byte there — a
+ * `console.log`, a library's banner, a warning — corrupts a frame and the
+ * client's connection with it. So **everything** this process says to a human
+ * goes to stderr, and the rule holds for the whole codebase: there is no
+ * `console.log` anywhere in `src/`, and the tools return text to the client
+ * rather than printing it.
+ *
+ * @module
+ */
+import { createArcNowClient } from "@arcnow/sdk";
+import { clientOptionsFor } from "./client-options.js";
+import { ConfigError, loadConfig, startupBanner } from "./config.js";
+import { createSdkPort } from "./sdk-port.js";
+import { createServer } from "./server.js";
+async function main() {
+    const config = loadConfig(process.env, process.argv.slice(2));
+    process.stderr.write(`${startupBanner(config)}\n`);
+    const client = createArcNowClient(clientOptionsFor(config));
+    // Asked once, up front, and reported rather than fatal: an endpoint that is
+    // briefly unreachable should not stop the server from starting, but a client
+    // pointed at the wrong chain should find out now and not from a transaction.
+    try {
+        await client.verifyChain();
+    }
+    catch (error) {
+        process.stderr.write(`  warning     the endpoint could not be verified as chain ${config.network}: `
+            + `${error instanceof Error ? error.message : String(error)}\n`
+            + "              Tools will report this again when they are called.\n");
+    }
+    const port = createSdkPort(client, config.logScan);
+    const server = createServer(port, config);
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    await server.connect(new StdioServerTransport());
+    process.stderr.write("  ready       listening on stdio\n");
+}
+main().catch((error) => {
+    if (error instanceof ConfigError) {
+        process.stderr.write(`arcnow.io MCP server cannot start.\n\n${error.message}\n`);
+        process.exit(2);
+    }
+    process.stderr.write(`arcnow.io MCP server failed: ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5D,4EAA4E;IAC5E,6EAA6E;IAC7E,6EAA6E;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6DAA6D,MAAM,CAAC,OAAO,IAAI;cAC7E,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;cAC7D,oEAAoE,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,2CAA2C,CAC5C,CAAC;IACF,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;AAC7D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAC1G,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/sdk-port.d.ts

@@ -0,0 +1,227 @@
+/**
+ * The seam between the tools and `@arcnow/sdk`.
+ *
+ * # Why there is a seam at all
+ *
+ * Every chain interaction in this server goes through the SDK. Nothing here
+ * encodes a call, computes a curve, or knows an address: the SDK owns all of
+ * that, it is pinned to a commit in `pins.json`, and it is the thing the
+ * project's forked-chain suite actually tests. Reimplementing any of it here
+ * would produce a second, unpinned, untested copy of the most expensive code in
+ * the project to get wrong.
+ *
+ * What this file adds is a set of **interfaces the SDK's handles already
+ * satisfy**. The SDK's `Curve`, `Token`, `Trade`, `Pool`, `Launchpad` and `PlatformRegistry` are
+ * classes with private fields, which means a test cannot construct a stand-in
+ * for one — not because faking them is difficult, but because a class with a
+ * `private` member is nominally typed and nothing else is assignable to it. So
+ * the tools depend on {@link ArcNowPort}, {@link CurveHandle} and friends, and
+ * {@link createSdkPort} is the one place that mentions the SDK's classes.
+ *
+ * That buys the whole suite: a fake port drives every tool through every
+ * branch — a graduating buy, a stale quote, a cost over the ceiling, a curve
+ * that already migrated — with no chain, no container and no key. The seam is
+ * type-level only; it wraps nothing and computes nothing.
+ *
+ * The types crossing it are the SDK's own: {@link QuoteAmount}, {@link Tokens},
+ * {@link Bps}, `CurveState`, `BuyQuote`. Re-describing those would be exactly
+ * the reimplementation this file exists to avoid, and the amount types in
+ * particular are the reason an amount of EURC cannot be read as USDC, and the
+ * 18-decimal native USDC cannot be confused with the 6-decimal ERC-20 view.
+ *
+ * @module
+ */
+import type { Address, Hash } from "viem";
+import { type ArcNowClient, type Bps, type BuyQuote, type BuyRequest, type BuyResult, type CurveState, type CurveTemplateParams, type FeeConfig, type FeeSplit, type LaunchParams, type LaunchQuote, type LaunchResult, type MigrateResult, type NetworkConfig, type NewPlatform, type PlatformSettings, type PoolBuyQuote, type PoolKeyStruct, QuoteAmount, type QuoteFrom, type QuoteRegistryEntry, type QuoteTokenInfo, type RegisterPlatformResult, type SellQuote, type SellRequest, type SellResult, type SpendState, Tokens, type TradeBuyQuote, type TradeBuyRequest, type TradeBuyResult, type TradeSellQuote, type TradeSellRequest, type TradeSellResult, type Venue } from "@arcnow/sdk";
+/**
+ * One graduated token's Uniswap v4 pool: `client.pool(token)`, and the `pool`
+ * half of `client.trade(token)`.
+ *
+ * Only what the tools read or do. Notably absent: `buy` and `sell`, which the
+ * tools reach through {@link TradeHandle} so that the venue is decided by the
+ * SDK, in one place, and never by this server.
+ */
+export interface PoolHandle {
+    readonly token: Address;
+    key(): Promise<PoolKeyStruct>;
+    poolId(): Promise<`0x${string}`>;
+    /** The PoolManager the liquidity is in. A v4 pool has no address of its own. */
+    poolManager(): Promise<Address>;
+    /** False with no router configured, or when the router serves another manager. */
+    isReachable(): Promise<boolean>;
+    /**
+     * The pool's quote token: the key's currency that is not the token, whichever
+     * of `currency0` and `currency1` that is. Never assume it is `currency0`.
+     */
+    quoteToken(): Promise<QuoteTokenInfo>;
+    /** True when the quote is the key's `currency0`: always for native USDC, either for an ERC-20. */
+    quoteIsCurrency0(): Promise<boolean>;
+    quoteBuy(quoteIn: QuoteAmount, opts?: QuoteFrom): Promise<PoolBuyQuote>;
+    routerAllowance(owner: Address): Promise<Tokens>;
+    /** A separate transaction, granting the router spending rights over `amount`. */
+    approveRouter(amount: Tokens): Promise<`0x${string}`>;
+    /**
+     * What the pool's fee hook has charged and not yet paid out, in the pool's quote.
+     * `UnknownHookVersion` for a hook that is not `arcnow/arc-now-fee-hook@3.x.x`.
+     */
+    accruedHookFee(): Promise<QuoteAmount>;
+}
+/**
+ * `client.trade(token)`: a token traded wherever it currently trades.
+ *
+ * The write tools send every buy and sell through this, curve or pool, so the
+ * SDK's own refusals — a `recipient` on a curve, a `referrer`, `developer` or
+ * `gasLimit` on a pool — stand behind this server's.
+ */
+export interface TradeHandle {
+    readonly token: Address;
+    readonly pool: PoolHandle;
+    venue(): Promise<Venue>;
+    /** The quote token this token trades against for life, read off its curve. */
+    quoteToken(): Promise<QuoteTokenInfo>;
+    quoteBuy(quoteIn: QuoteAmount, opts?: {
+        readonly from?: Address | undefined;
+    }): Promise<TradeBuyQuote>;
+    quoteSell(tokensIn: Tokens, opts?: {
+        readonly from?: Address | undefined;
+    }): Promise<TradeSellQuote>;
+    buy(request: TradeBuyRequest): Promise<TradeBuyResult>;
+    sell(request: TradeSellRequest): Promise<TradeSellResult>;
+}
+/** One `Launchpad.Launched` log, decoded. */
+export interface LaunchRecord {
+    readonly token: Address;
+    readonly curve: Address;
+    readonly creator: Address;
+    readonly platform: Address;
+    readonly migrator: Address;
+    /**
+     * The quote the token launched in, from the log's own `quoteToken` field and
+     * labelled from the network's `quoteTokens` — no RPC — or, for a quote the
+     * network does not list, the SDK's per-process cached metadata read.
+     */
+    readonly quoteToken: QuoteTokenInfo;
+    readonly launchFee: QuoteAmount;
+    readonly initialBuy: QuoteAmount;
+    readonly tokensOut: Tokens;
+    readonly blockNumber: bigint;
+    readonly txHash: Hash;
+}
+/** What a launch scan looked at, so a caller is never told more than was seen. */
+export interface LaunchScan {
+    readonly launches: readonly LaunchRecord[];
+    readonly tipBlock: bigint;
+    readonly scannedFromBlock: bigint;
+    readonly scannedToBlock: bigint;
+    /** True when the scan reached the block the deployment starts at. */
+    readonly reachedDeployment: boolean;
+    /** True when the scan stopped on its chunk budget with history left unread. */
+    readonly stoppedOnBudget: boolean;
+}
+export interface ListLaunchesOptions {
+    readonly limit: number;
+    readonly creator?: Address | undefined;
+    readonly token?: Address | undefined;
+}
+export interface CurveHandle {
+    readonly address: Address;
+    state(): Promise<CurveState>;
+    quoteBuy(quoteIn: QuoteAmount): Promise<BuyQuote>;
+    quoteSell(tokensIn: Tokens): Promise<SellQuote>;
+    previewFeeSplit(fee: QuoteAmount, referrer?: Address, developer?: Address): Promise<FeeSplit>;
+    feeConfig(): Promise<FeeConfig>;
+    pendingWithdrawal(account: Address): Promise<QuoteAmount>;
+    buy(request: BuyRequest): Promise<BuyResult>;
+    sell(request: SellRequest): Promise<SellResult>;
+    migrate(): Promise<MigrateResult>;
+    withdraw(to: Address): Promise<{
+        amount: QuoteAmount;
+        txHash: Hash;
+    }>;
+}
+export interface TokenHandle {
+    readonly address: Address;
+    name(): Promise<string>;
+    symbol(): Promise<string>;
+    metadataUri(): Promise<string>;
+    totalSupply(): Promise<Tokens>;
+    balanceOf(account: Address): Promise<Tokens>;
+    creator(): Promise<Address>;
+    curve(): Promise<Address>;
+    migratedPool(): Promise<Address>;
+    canonicalRouter(): Promise<Address>;
+}
+export interface LaunchpadHandle {
+    readonly address: Address;
+    /** The flat launch fee in `quote` (native USDC when omitted), from the quote registry. */
+    launchFee(quote?: Address): Promise<QuoteAmount>;
+    quoteLaunch(params: LaunchParams): Promise<LaunchQuote>;
+    predictAddresses(creator: Address, params: LaunchParams): Promise<{
+        token: Address;
+        curve: Address;
+    }>;
+    launch(params: LaunchParams): Promise<LaunchResult>;
+}
+export interface PlatformsHandle {
+    readonly address: Address;
+    isPlatform(platform: Address): Promise<boolean>;
+    platformCount(): Promise<bigint>;
+    platformAt(index: bigint): Promise<Address>;
+    settings(platform: Address): Promise<PlatformSettings>;
+    feeConfigFor(platform: Address): Promise<FeeConfig>;
+    checkCurveTemplate(template: CurveTemplateParams, platform?: Address): Promise<void>;
+    /**
+     * The template `platform` serves launches in `quote`. `NoCurveParameters` when
+     * the platform has not enabled that quote.
+     */
+    curveParametersFor(platform: Address, quote?: Address | QuoteTokenInfo): Promise<CurveTemplateParams>;
+    registerPlatform(platform: NewPlatform): Promise<RegisterPlatformResult>;
+    protocolSummary(): Promise<{
+        protocolShareBps: Bps;
+        protocolRecipient: Address;
+        launchFee: QuoteAmount;
+    }>;
+}
+/** `client.quoteRegistry`: the allowlist of quote tokens a launch may use. */
+export interface QuoteRegistryHandle {
+    /** Every registered quote, in at most three `eth_call`s. */
+    list(): Promise<readonly QuoteRegistryEntry[]>;
+}
+/** Everything the tools are allowed to reach. */
+export interface ArcNowPort {
+    readonly config: NetworkConfig;
+    readonly canWrite: boolean;
+    readonly signerAddress: Address | undefined;
+    curve(address: Address): CurveHandle;
+    token(address: Address): TokenHandle;
+    /** The token wherever it trades: `client.trade(token)`. Every buy and sell goes through it. */
+    trade(token: Address): TradeHandle;
+    readonly launchpad: LaunchpadHandle;
+    readonly platforms: PlatformsHandle;
+    readonly quoteRegistry: QuoteRegistryHandle;
+    /**
+     * What `owner` holds of a quote token and, for an ERC-20 with a `spender`
+     * named, what it has approved that spender for — in ONE Multicall3 `eth_call`
+     * (`client.quoteToken(token).spendState`). Native USDC is the account's native
+     * balance and has no allowance.
+     */
+    quoteSpendState(token: QuoteTokenInfo, owner: Address, spender?: Address): Promise<SpendState>;
+    /**
+     * A quote token's metadata: the network's `quoteTokens` with no RPC, otherwise
+     * one cached Multicall3 read of `symbol`, `name` and `decimals`.
+     */
+    quoteTokenInfo(address: Address): Promise<QuoteTokenInfo>;
+    listLaunches(options: ListLaunchesOptions): Promise<LaunchScan>;
+    verifyChain(): Promise<void>;
+}
+/** How far back and in what steps a launch scan walks. */
+export interface ScanLimits {
+    readonly chunkBlocks: bigint;
+    readonly maxChunks: number;
+}
+/**
+ * Wrap a live {@link ArcNowClient}. The only function in this repository that
+ * names the SDK's classes.
+ */
+export declare function createSdkPort(client: ArcNowClient, limits: ScanLimits): ArcNowPort;
+//# sourceMappingURL=sdk-port.d.ts.map

package/dist/sdk-port.d.ts.map

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

package/dist/sdk-port.js

@@ -0,0 +1,144 @@
+/**
+ * The seam between the tools and `@arcnow/sdk`.
+ *
+ * # Why there is a seam at all
+ *
+ * Every chain interaction in this server goes through the SDK. Nothing here
+ * encodes a call, computes a curve, or knows an address: the SDK owns all of
+ * that, it is pinned to a commit in `pins.json`, and it is the thing the
+ * project's forked-chain suite actually tests. Reimplementing any of it here
+ * would produce a second, unpinned, untested copy of the most expensive code in
+ * the project to get wrong.
+ *
+ * What this file adds is a set of **interfaces the SDK's handles already
+ * satisfy**. The SDK's `Curve`, `Token`, `Trade`, `Pool`, `Launchpad` and `PlatformRegistry` are
+ * classes with private fields, which means a test cannot construct a stand-in
+ * for one — not because faking them is difficult, but because a class with a
+ * `private` member is nominally typed and nothing else is assignable to it. So
+ * the tools depend on {@link ArcNowPort}, {@link CurveHandle} and friends, and
+ * {@link createSdkPort} is the one place that mentions the SDK's classes.
+ *
+ * That buys the whole suite: a fake port drives every tool through every
+ * branch — a graduating buy, a stale quote, a cost over the ceiling, a curve
+ * that already migrated — with no chain, no container and no key. The seam is
+ * type-level only; it wraps nothing and computes nothing.
+ *
+ * The types crossing it are the SDK's own: {@link QuoteAmount}, {@link Tokens},
+ * {@link Bps}, `CurveState`, `BuyQuote`. Re-describing those would be exactly
+ * the reimplementation this file exists to avoid, and the amount types in
+ * particular are the reason an amount of EURC cannot be read as USDC, and the
+ * 18-decimal native USDC cannot be confused with the 6-decimal ERC-20 view.
+ *
+ * @module
+ */
+import { getAbiItem } from "viem";
+import { abi, findQuoteToken, QuoteAmount, Tokens, } from "@arcnow/sdk";
+const LAUNCHED_EVENT = getAbiItem({ abi: abi.launchpadAbi, name: "Launched" });
+/**
+ * Wrap a live {@link ArcNowClient}. The only function in this repository that
+ * names the SDK's classes.
+ */
+export function createSdkPort(client, limits) {
+    return {
+        config: client.config,
+        canWrite: client.canWrite,
+        signerAddress: client.walletClient?.account?.address,
+        curve: (address) => client.curve(address),
+        token: (address) => client.token(address),
+        trade: (address) => client.trade(address),
+        launchpad: client.launchpad,
+        platforms: client.platforms,
+        quoteRegistry: client.quoteRegistry,
+        quoteSpendState: (token, owner, spender) => client.quoteToken(token).spendState(owner, spender),
+        quoteTokenInfo: (address) => client.quoteTokenInfo(address),
+        verifyChain: () => client.verifyChain(),
+        async listLaunches(options) {
+            return scanLaunches(client, limits, options);
+        },
+    };
+}
+/**
+ * Walk `Launchpad.Launched` backwards from the tip.
+ *
+ * **This is the one thing the SDK does not do for us.** There is no enumeration
+ * anywhere in `@arcnow/sdk` — deliberately, per its `networks.json`: a token and
+ * its curve come from this log, one pair per launch, and there are as many as
+ * there have been launches, so a network preset cannot carry them. That leaves
+ * "show me the recent tokens", which is the first thing anyone asks an
+ * assistant, with nowhere to come from.
+ *
+ * So this reads the log directly — with the SDK's own pinned ABI, through the
+ * SDK's own configured client, at the SDK's own launchpad address. Nothing is
+ * re-derived; the only thing added is the scan. It is written down in the
+ * README as a gap in the SDK rather than a feature of this server, because that
+ * is what it is: a `launchpad.recentLaunches()` belongs there, where the fork
+ * suite could test it against a real chain.
+ *
+ * Backwards from the tip, in chunks, with a budget — because a public endpoint
+ * will refuse an unbounded range and the deployment starts six million blocks
+ * back. What it could not reach is reported rather than implied.
+ */
+async function scanLaunches(client, limits, options) {
+    const tip = await client.publicClient.getBlockNumber();
+    const floor = BigInt(client.config.deployedAtBlock ?? 0);
+    const found = [];
+    let upper = tip;
+    let chunks = 0;
+    let lowest = tip;
+    while (upper >= floor && chunks < limits.maxChunks && found.length < options.limit) {
+        const lower = upper + 1n > limits.chunkBlocks
+            ? bigMax(floor, upper - limits.chunkBlocks + 1n)
+            : floor;
+        const logs = await client.publicClient.getLogs({
+            address: client.config.contracts.launchpad,
+            event: LAUNCHED_EVENT,
+            args: {
+                ...(options.token === undefined ? {} : { token: options.token }),
+                ...(options.creator === undefined ? {} : { creator: options.creator }),
+            },
+            fromBlock: lower,
+            toBlock: upper,
+        });
+        // Newest first, which is the order a person means by "recent".
+        for (const log of [...logs].reverse()) {
+            const args = log.args;
+            // The quote is in the log itself: labelling it costs nothing for a quote
+            // the network lists, and one cached read per process for one it does not.
+            const quoteAddress = args.quoteToken;
+            const quoteToken = findQuoteToken(client.config, quoteAddress)
+                ?? await client.quoteTokenInfo(quoteAddress);
+            found.push({
+                token: args.token,
+                curve: args.curve,
+                creator: args.creator,
+                platform: args.platform,
+                migrator: args.migrator,
+                quoteToken,
+                launchFee: QuoteAmount.fromWad(quoteToken, args.launchFeeWad),
+                initialBuy: QuoteAmount.fromWad(quoteToken, args.initialBuyWad),
+                tokensOut: Tokens.fromWad(args.tokensOutWad),
+                blockNumber: log.blockNumber ?? 0n,
+                txHash: log.transactionHash ?? ("0x"),
+            });
+            if (found.length >= options.limit)
+                break;
+        }
+        lowest = lower;
+        chunks += 1;
+        if (lower <= floor)
+            break;
+        upper = lower - 1n;
+    }
+    return {
+        launches: found.slice(0, options.limit),
+        tipBlock: tip,
+        scannedFromBlock: lowest,
+        scannedToBlock: tip,
+        reachedDeployment: lowest <= floor,
+        stoppedOnBudget: lowest > floor && found.length < options.limit,
+    };
+}
+function bigMax(a, b) {
+    return a > b ? a : b;
+}
+//# sourceMappingURL=sdk-port.js.map

package/dist/sdk-port.js.map

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