@antseed/cli 0.1.178 → 0.1.180

package/dist/gateway/console-api/handlers/status.test.js

@@ -0,0 +1,82 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { CONSOLE_LOCATION_SETTING } from '../../console-location.js';
+import { DEFAULT_WORKSPACE_ID } from '../../store.js';
+import { FakeConsoleAuth, addActiveMember, call, memberPrincipal, startConsole, tempDataDir, testDeps } from '../test-support.js';
+import { registerStatusRoutes } from './status.js';
+const LAPTOP = { platform: 'darwin', systemd: false, container: false };
+const SERVER = { platform: 'linux', systemd: true, container: false };
+const NO_LIMITS = { daily: null, weekly: null, monthly: null, total: null };
+async function harness(overrides) {
+    const { dir, store, cleanup } = tempDataDir();
+    const auth = new FakeConsoleAuth();
+    const owner = store.createOwner({ label: 'Owner', email: 'owner@example.test' });
+    const admin = addActiveMember(store, 'Admin', { orgRole: 'admin' });
+    const member = addActiveMember(store, 'Member', { workspaces: [{ workspaceId: DEFAULT_WORKSPACE_ID, role: 'member' }] });
+    const key = store.createKey({ label: 'k', workspaceId: DEFAULT_WORKSPACE_ID, ownerMemberId: member.id, limits: NO_LIMITS, expiresAt: null });
+    auth.as('owner', memberPrincipal(store, owner.id));
+    auth.as('admin', memberPrincipal(store, admin.id));
+    auth.as('member', memberPrincipal(store, member.id));
+    auth.as('keyholder', { kind: 'key', keyId: key.key.id, sessionId: 'ks' });
+    const deps = { ...testDeps(store, dir), ...overrides };
+    const server = await startConsole(deps, auth, [registerStatusRoutes]);
+    const status = async (who) => {
+        const result = await call(server.port, 'GET', '/console/api/status', { who });
+        assert.equal(result.status, 200);
+        return result.body;
+    };
+    return { store, status, close: async () => { await server.close(); cleanup(); } };
+}
+test('GET /status: a laptop gateway on loopback is local; admins see why, others only the mode', async () => {
+    const h = await harness({ publicUrl: null, listenHost: '127.0.0.1', hostFacts: LAPTOP });
+    try {
+        for (const who of ['owner', 'admin']) {
+            const { exposure } = await h.status(who);
+            assert.equal(exposure?.mode, 'local', who);
+            assert.equal(exposure?.reachableFromInternet, false);
+            assert.equal(exposure?.personalComputer, true);
+            assert.equal(exposure?.listenHost, '127.0.0.1');
+            assert.ok((exposure?.reasons.length ?? 0) > 0);
+        }
+        for (const who of ['member', 'keyholder']) {
+            const { exposure } = await h.status(who);
+            assert.equal(exposure?.mode, 'local', who);
+            assert.equal(exposure?.listenHost, null, `${who} does not learn the listen address`);
+            assert.deepEqual(exposure?.reasons, []);
+        }
+    }
+    finally {
+        await h.close();
+    }
+});
+test('GET /status: a server with a public URL is public', async () => {
+    const h = await harness({ publicUrl: 'https://llm.example.com', listenHost: '127.0.0.1', hostFacts: SERVER });
+    try {
+        const { exposure, publicUrl } = await h.status('owner');
+        assert.equal(publicUrl, 'https://llm.example.com');
+        assert.equal(exposure?.mode, 'public');
+        assert.equal(exposure?.reachableFromInternet, true);
+        assert.equal(exposure?.personalComputer, false);
+    }
+    finally {
+        await h.close();
+    }
+});
+test('GET /status: a quick tunnel URL saved after start-up counts as public; 0.0.0.0 without one is lan', async () => {
+    const h = await harness({ publicUrl: null, hostFacts: SERVER });
+    try {
+        h.store.setSetting(CONSOLE_LOCATION_SETTING, { publicUrl: null, port: 8379, host: '0.0.0.0' });
+        const lan = await h.status('owner');
+        assert.equal(lan.exposure?.mode, 'lan');
+        assert.equal(lan.exposure?.listenHost, '0.0.0.0', 'falls back to the saved listen address');
+        assert.equal(lan.exposure?.reachableFromInternet, null);
+        h.store.setSetting(CONSOLE_LOCATION_SETTING, { publicUrl: 'https://quick-fox.trycloudflare.com', port: 8379 });
+        const tunnel = await h.status('owner');
+        assert.equal(tunnel.exposure?.mode, 'public');
+        assert.equal(tunnel.exposure?.publicUrl, 'https://quick-fox.trycloudflare.com');
+    }
+    finally {
+        await h.close();
+    }
+});
+//# sourceMappingURL=status.test.js.map

package/dist/gateway/console-api/handlers/status.test.js.map

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

package/dist/gateway/console-api/handlers/usage.d.ts

@@ -0,0 +1,10 @@
+import type { ConsoleDeps } from '../deps.js';
+import { type ConsoleRouter } from '../router.js';
+/**
+ * Usage reports, the request log and its CSV export (see
+ * `services/usage.ts`). Every query is limited to the keys the caller may
+ * see: all for org admins and tokens, a workspace's keys for its admins, a
+ * member's own keys otherwise, and the one key for an API-key session.
+ */
+export declare function registerUsageRoutes(router: ConsoleRouter, deps: ConsoleDeps): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/gateway/console-api/handlers/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../../src/gateway/console-api/handlers/usage.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAgB,KAAK,aAAa,EAAkB,MAAM,cAAc,CAAA;AA6B/E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAmClF"}

package/dist/gateway/console-api/handlers/usage.js

@@ -0,0 +1,68 @@
+import { decodeCursor, listRequestPage, parseGrouping, parseSearch, parseStatusFilter, parseTime, requestCsvChunks, requestDetail, usageReport, } from '../../services/usage.js';
+import { canSeeWorkspace, visibleKeyIds } from '../access.js';
+import { ConsoleError } from '../router.js';
+/** Filters from the query, limited to what the caller may see. */
+function scopedFilter(store, principal, query) {
+    const workspaceId = query.get('workspace');
+    if (workspaceId && principal?.kind !== 'key' && !canSeeWorkspace(store, principal, workspaceId)) {
+        throw new ConsoleError(403, 'forbidden', 'You are not a member of this workspace');
+    }
+    return {
+        keyIds: visibleKeyIds(store, principal),
+        workspaceId: workspaceId || null,
+        keyId: query.get('key') || null,
+        memberId: query.get('member') || null,
+        model: query.get('model') || null,
+    };
+}
+/** The request-log filters shared by `/requests` and the CSV export. */
+function requestFilter(store, principal, query) {
+    const q = parseSearch(query.get('q'));
+    return {
+        ...scopedFilter(store, principal, query),
+        from: parseTime(query.get('from'), 'from'),
+        to: parseTime(query.get('to'), 'to'),
+        status: parseStatusFilter(query.get('status')),
+        q,
+    };
+}
+/**
+ * Usage reports, the request log and its CSV export (see
+ * `services/usage.ts`). Every query is limited to the keys the caller may
+ * see: all for org admins and tokens, a workspace's keys for its admins, a
+ * member's own keys otherwise, and the one key for an API-key session.
+ */
+export function registerUsageRoutes(router, deps) {
+    const { store } = deps;
+    const allow = ['member', 'token', 'key'];
+    router.add('GET', '/usage', async ({ principal, query }) => {
+        const filter = scopedFilter(store, principal, query);
+        const to = parseTime(query.get('to'), 'to');
+        const from = parseTime(query.get('from'), 'from');
+        return usageReport(store, filter, { from, to, ...parseGrouping(query.get('groupBy'), query.get('splitBy')), now: deps.now() });
+    }, { allow });
+    router.add('GET', '/requests', async ({ principal, query }) => {
+        const filter = requestFilter(store, principal, query);
+        return listRequestPage(store, filter, { before: decodeCursor(query.get('before')), limit: Number(query.get('limit') ?? 50) });
+    }, { allow });
+    router.add('GET', '/requests/:tag', async ({ principal, params }) => {
+        return requestDetail(store, params['tag'], visibleKeyIds(store, principal));
+    }, { allow });
+    /** Streams the export page by page (cursor order), so memory stays flat however many rows match. */
+    router.add('GET', '/usage/export.csv', async ({ principal, query, res }) => {
+        const filter = requestFilter(store, principal, query);
+        const before = decodeCursor(query.get('before'));
+        res.writeHead(200, {
+            'content-type': 'text/csv; charset=utf-8',
+            'content-disposition': `attachment; filename="antseed-usage-${new Date(deps.now()).toISOString().slice(0, 10)}.csv"`,
+            'cache-control': 'no-store',
+        });
+        for (const chunk of requestCsvChunks(store, filter, { before, stopped: () => res.destroyed })) {
+            if (!res.write(chunk))
+                await new Promise((resolve) => { res.once('drain', resolve); res.once('close', resolve); });
+        }
+        res.end();
+        return undefined;
+    }, { allow });
+}
+//# sourceMappingURL=usage.js.map

package/dist/gateway/console-api/handlers/usage.js.map

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

package/dist/gateway/console-api/handlers/wallet-card-link.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Signed Antseed Pay funding links for a workspace wallet. The link itself
+ * is built by `@antseed/payments/card-link`, the same code the desktop uses
+ * (`payments:open-card-provider`), so both produce the same bytes; this
+ * module adds the gateway's amount bounds and pay-page URL setting.
+ */
+import { antseedPayMessage, DEFAULT_ANTSEED_PAY_URL, type AntseedPayIntegration } from '@antseed/payments/card-link';
+export type CardProvider = AntseedPayIntegration;
+export declare const CARD_PROVIDERS: readonly CardProvider[];
+export { DEFAULT_ANTSEED_PAY_URL };
+export declare function antseedPayBaseUrl(env?: NodeJS.ProcessEnv): string;
+/**
+ * The amount as the desktop writes it, `String(Number(input))` ("10.50" →
+ * "10.5"); throws a user-facing message when it is out of bounds or has
+ * more than 2 decimals, which the pay page rejects as a malformed link.
+ */
+export declare function cardAmountString(input: unknown): string;
+/** The signed message (the pay page's wire format). */
+export declare const cardLinkMessage: typeof antseedPayMessage;
+export declare function buildCardLink(input: {
+    baseUrl: string;
+    wallet: {
+        address: string;
+        signMessage(message: string): Promise<string>;
+    };
+    amountUsd: unknown;
+    provider: CardProvider;
+}): Promise<string>;
+//# sourceMappingURL=wallet-card-link.d.ts.map

package/dist/gateway/console-api/handlers/wallet-card-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-card-link.d.ts","sourceRoot":"","sources":["../../../../src/gateway/console-api/handlers/wallet-card-link.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAA4B,iBAAiB,EAAuB,uBAAuB,EAAE,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAEnK,MAAM,MAAM,YAAY,GAAG,qBAAqB,CAAA;AAEhD,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAA6B,CAAA;AAC/E,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAOlC,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUvD;AAED,uDAAuD;AACvD,eAAO,MAAM,eAAe,0BAAoB,CAAA;AAEhD,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;IAC1E,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,YAAY,CAAA;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlB"}

package/dist/gateway/console-api/handlers/wallet-card-link.js

@@ -0,0 +1,46 @@
+/**
+ * Signed Antseed Pay funding links for a workspace wallet. The link itself
+ * is built by `@antseed/payments/card-link`, the same code the desktop uses
+ * (`payments:open-card-provider`), so both produce the same bytes; this
+ * module adds the gateway's amount bounds and pay-page URL setting.
+ */
+import { ANTSEED_PAY_INTEGRATIONS, antseedPayMessage, buildAntseedPayLink, DEFAULT_ANTSEED_PAY_URL } from '@antseed/payments/card-link';
+export const CARD_PROVIDERS = ANTSEED_PAY_INTEGRATIONS;
+export { DEFAULT_ANTSEED_PAY_URL };
+/** Deposits take at least 1 USDC on a first deposit; the pay page refuses links above $200. */
+const CARD_MIN_USD = 1;
+const CARD_MAX_USD = 200;
+/** The pay page's link amount format: whole dollars or up to 2 decimals ("20", "12.5"). */
+const CARD_AMOUNT_RE = /^\d+(\.\d{1,2})?$/;
+export function antseedPayBaseUrl(env = process.env) {
+    return env['ANTSEED_PAY_URL']?.trim() || DEFAULT_ANTSEED_PAY_URL;
+}
+/**
+ * The amount as the desktop writes it, `String(Number(input))` ("10.50" →
+ * "10.5"); throws a user-facing message when it is out of bounds or has
+ * more than 2 decimals, which the pay page rejects as a malformed link.
+ */
+export function cardAmountString(input) {
+    let amount = Number.NaN;
+    if (typeof input === 'number')
+        amount = input;
+    else if (typeof input === 'string' && input.trim() !== '')
+        amount = Number(input);
+    if (!Number.isFinite(amount) || amount <= 0)
+        throw new Error('amountUsd must be a positive number.');
+    if (amount < CARD_MIN_USD)
+        throw new Error(`The minimum card deposit is $${CARD_MIN_USD}.`);
+    if (amount > CARD_MAX_USD)
+        throw new Error(`The maximum card deposit is $${CARD_MAX_USD}.`);
+    const text = String(amount);
+    if (!CARD_AMOUNT_RE.test(text))
+        throw new Error('The card deposit amount can have at most 2 decimals (cents).');
+    return text;
+}
+/** The signed message (the pay page's wire format). */
+export const cardLinkMessage = antseedPayMessage;
+export async function buildCardLink(input) {
+    const amount = cardAmountString(input.amountUsd);
+    return buildAntseedPayLink({ baseUrl: input.baseUrl, wallet: input.wallet, amount, integration: input.provider });
+}
+//# sourceMappingURL=wallet-card-link.js.map

package/dist/gateway/console-api/handlers/wallet-card-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-card-link.js","sourceRoot":"","sources":["../../../../src/gateway/console-api/handlers/wallet-card-link.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,uBAAuB,EAA8B,MAAM,6BAA6B,CAAA;AAInK,MAAM,CAAC,MAAM,cAAc,GAA4B,wBAAwB,CAAA;AAC/E,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAClC,+FAA+F;AAC/F,MAAM,YAAY,GAAG,CAAC,CAAA;AACtB,MAAM,YAAY,GAAG,GAAG,CAAA;AACxB,2FAA2F;AAC3F,MAAM,cAAc,GAAG,mBAAmB,CAAA;AAE1C,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,OAAO,GAAG,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,IAAI,uBAAuB,CAAA;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAA;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,GAAG,KAAK,CAAA;SACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACjF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACpG,IAAI,MAAM,GAAG,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,GAAG,CAAC,CAAA;IAC3F,IAAI,MAAM,GAAG,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,GAAG,CAAC,CAAA;IAC3F,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;IAC/G,OAAO,IAAI,CAAA;AACb,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAA;AAEhD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAKnC;IACC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAChD,OAAO,mBAAmB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;AACnH,CAAC"}

package/dist/gateway/console-api/handlers/wallet-chain.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Chain reads the gateway makes itself (buyer rewards, operator reads)
+ * through the process's one rate-aware provider per chain, instead of a new
+ * provider (and an endpoint-probing burst) per request. Balances are not
+ * read here: they come from the buyer's cached `GET /_antseed/balances`.
+ */
+import { type AntsChainConfig, type RewardsView } from '@antseed/ants';
+import { type ChainRpcProvider } from '../../../proxy/chain-rpc.js';
+import type { ChannelChainState } from './wallet-mapping.js';
+/** Rewards move once per epoch; five minutes keeps a page refresh from re-reading them. */
+export declare const REWARDS_TTL_MS: number;
+/** The gateway process's provider for a chain (`ANTSEED_BASE_RPC_URL` is already applied by `resolveAntsChain`). */
+export declare function gatewayChainProvider(chain: Pick<AntsChainConfig, 'evmChainId' | 'rpcUrl' | 'fallbackRpcUrls'>): ChainRpcProvider;
+/**
+ * Buyer rewards for one address, read-only (no signer, the zero address as
+ * the connected wallet). One context per chain is kept, so the protocol
+ * stack (registry pointers, epoch config) is resolved once per TTL rather
+ * than per request; reads run one at a time because the context carries the
+ * buyer address.
+ */
+export declare function createRewardsReader(): (chain: AntsChainConfig, address: string) => Promise<RewardsView & {
+    legacyEpochs: number[];
+}>;
+/** On-chain records for `channelIds` in one Multicall3 read; ids it could not read are left out. */
+export declare function readChannelStates(chain: AntsChainConfig, channelIds: string[]): Promise<Map<string, ChannelChainState>>;
+//# sourceMappingURL=wallet-chain.d.ts.map

package/dist/gateway/console-api/handlers/wallet-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-chain.d.ts","sourceRoot":"","sources":["../../../../src/gateway/console-api/handlers/wallet-chain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAwB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAG5F,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,2FAA2F;AAC3F,eAAO,MAAM,cAAc,QAAa,CAAA;AAExC,oHAAoH;AACpH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,YAAY,GAAG,QAAQ,GAAG,iBAAiB,CAAC,GAAG,gBAAgB,CAEhI;AAiBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqBpI;AAMD,oGAAoG;AACpG,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAc7H"}

package/dist/gateway/console-api/handlers/wallet-chain.js

@@ -0,0 +1,80 @@
+/**
+ * Chain reads the gateway makes itself (buyer rewards, operator reads)
+ * through the process's one rate-aware provider per chain, instead of a new
+ * provider (and an endpoint-probing burst) per request. Balances are not
+ * read here: they come from the buyer's cached `GET /_antseed/balances`.
+ */
+import { AntsContext, rewards } from '@antseed/ants';
+import { multicallRead } from '@antseed/node/payments';
+import { Interface, ZeroAddress } from 'ethers';
+import { sharedChainProvider } from '../../../proxy/chain-rpc.js';
+/** Rewards move once per epoch; five minutes keeps a page refresh from re-reading them. */
+export const REWARDS_TTL_MS = 5 * 60_000;
+/** The gateway process's provider for a chain (`ANTSEED_BASE_RPC_URL` is already applied by `resolveAntsChain`). */
+export function gatewayChainProvider(chain) {
+    return sharedChainProvider({ evmChainId: chain.evmChainId, rpcUrl: chain.rpcUrl, ...(chain.fallbackRpcUrls ? { fallbackRpcUrls: chain.fallbackRpcUrls } : {}) });
+}
+/**
+ * An ANTS read context on the shared provider. It skips `selectRpc`'s
+ * probing burst (eight `eth_call`s per endpoint): the shared provider already
+ * moves off an endpoint that throttles.
+ */
+class SharedAntsContext extends AntsContext {
+    selectRpc() {
+        return Promise.resolve();
+    }
+    provider() {
+        return gatewayChainProvider(this.chain);
+    }
+}
+/**
+ * Buyer rewards for one address, read-only (no signer, the zero address as
+ * the connected wallet). One context per chain is kept, so the protocol
+ * stack (registry pointers, epoch config) is resolved once per TTL rather
+ * than per request; reads run one at a time because the context carries the
+ * buyer address.
+ */
+export function createRewardsReader() {
+    const contexts = new Map();
+    let queue = Promise.resolve();
+    return (chain, address) => {
+        const key = `${chain.evmChainId}|${chain.rpcUrl}|${chain.registryContractAddress ?? ''}`;
+        let context = contexts.get(key);
+        if (!context) {
+            context = new SharedAntsContext({ chain, address: ZeroAddress, buyerAddress: address, stackTtlMs: REWARDS_TTL_MS });
+            contexts.set(key, context);
+        }
+        const ctx = context;
+        const run = queue.then(async () => {
+            ctx.buyerAddress = address;
+            const view = await rewards(ctx);
+            // The epochs a legacy buyer claim may name (finalized, before the current program took over).
+            const legacyEpochs = BigInt(view.legacy.buyer || '0') > 0n ? (await ctx.claimableEpochs()).legacy : [];
+            return { ...view, legacyEpochs };
+        });
+        queue = run.catch(() => { });
+        return run;
+    };
+}
+const CHANNELS_READ_IFACE = new Interface([
+    'function channels(bytes32 channelId) view returns (address buyer, address seller, uint128 deposit, uint128 settled, bytes32 metadataHash, uint256 deadline, uint256 settledAt, uint256 closeRequestedAt, uint8 status)',
+]);
+/** On-chain records for `channelIds` in one Multicall3 read; ids it could not read are left out. */
+export async function readChannelStates(chain, channelIds) {
+    const states = new Map();
+    if (!chain.channelsContractAddress || channelIds.length === 0)
+        return states;
+    const results = await multicallRead(gatewayChainProvider(chain), channelIds.map((channelId) => ({
+        target: chain.channelsContractAddress,
+        iface: CHANNELS_READ_IFACE,
+        method: 'channels',
+        args: [channelId],
+    })));
+    results.forEach((result, index) => {
+        if (!result)
+            return;
+        states.set(channelIds[index], { deposit: result[2], settled: result[3], closeRequestedAt: result[7], status: Number(result[8]) });
+    });
+    return states;
+}
+//# sourceMappingURL=wallet-chain.js.map

package/dist/gateway/console-api/handlers/wallet-chain.js.map

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

package/dist/gateway/console-api/handlers/wallet-mapping.d.ts

@@ -0,0 +1,45 @@
+/** Pure mapping from buyer-daemon and chain responses to the console's wallet shapes. */
+import type { AntsChainConfig, RewardsView } from '@antseed/ants';
+import { type Channel, type ChainInfo, type DepositWatch, type Rewards, type Usdc, type Wallet } from '../types.js';
+export declare function record(value: unknown): Record<string, unknown>;
+/** USDC base units ("1500000") as a decimal string ("1.500000"); bigint-safe. */
+export declare function baseUnitsToUsdc(value: unknown): Usdc;
+/** A decimal USDC string from the buyer, normalized to 6 decimals; numbers are accepted too. */
+export declare function decimalUsdc(value: unknown): Usdc;
+/** `GET /_antseed/balances` → the balance half of `Wallet`. */
+export declare function mapBalances(body: unknown): Omit<Wallet, 'buyerIdentity' | 'deposit'>;
+/**
+ * `GET /_antseed/deposits/status` → `DepositWatch` for one wallet. The buyer
+ * exposes a single watcher (the default identity's); other wallets are
+ * auto-swept by watchers it does not expose, so they read as `off` here.
+ */
+export declare function mapDepositWatch(body: unknown, walletAddress: string | null): DepositWatch;
+/** One row of `GET /_antseed/channels` → `Channel`; null for a row without an id. */
+export declare function mapChannel(value: unknown): Channel | null;
+/** A channel's on-chain record (AntseedChannels `channels(id)`); status 0 = no record, 1 active, 2 settled, 3 timed out. */
+export interface ChannelChainState {
+    status: number;
+    deposit: bigint;
+    settled: bigint;
+    closeRequestedAt: bigint;
+}
+/**
+ * The buyer's channel store can lag the chain (a seller-side settle or close
+ * is not always observed), and its `reserveCeiling` falls back to the
+ * configured per-channel maximum for a channel it has not touched since it
+ * started. Where the chain answered, its status and locked deposit win.
+ * Status 0 (no record yet, e.g. a reserve still landing) keeps the local row.
+ */
+export declare function applyChannelChainState(channel: Channel, state: ChannelChainState | undefined, nowSeconds: number): Channel;
+export declare function mapChannels(body: unknown): Channel[];
+/** Buyer-side rewards only, like the desktop's VPR summary: usage rewards plus legacy buyer emissions, each claimable on its own. */
+export declare function mapRewards(view: RewardsView & {
+    legacyEpochs?: number[];
+}, address: string): Rewards;
+/**
+ * `ChainInfo` for the browser. The RPC URL is the chain's public default,
+ * never the operator's configured endpoint, which often embeds an API key
+ * or reaches a private node; a chain without a known default gets none.
+ */
+export declare function chainInfo(chain: AntsChainConfig): ChainInfo;
+//# sourceMappingURL=wallet-mapping.d.ts.map

package/dist/gateway/console-api/handlers/wallet-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-mapping.d.ts","sourceRoot":"","sources":["../../../../src/gateway/console-api/handlers/wallet-mapping.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGjE,OAAO,EAA0B,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAM3I,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9D;AAeD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAQpD;AAED,gGAAgG;AAChG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAMhD;AAMD,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAgBzF;AAkBD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAoBzD;AAED,4HAA4H;AAC5H,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAGD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,iBAAiB,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAe1H;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAGpD;AAED,qIAAqI;AACrI,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAepG;AAOD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAoB3D"}