@usenami/signer-mcp 0.1.0

package/dist/lib.js

@@ -0,0 +1,281 @@
+/**
+ * Core handlers and helpers for @usenami/signer-mcp.
+ *
+ * Extracted from index.ts so unit tests can exercise the gateway-call paths
+ * without booting a real MCP transport. index.ts wires these into MCP tools.
+ */
+export const PACKAGE_VERSION = "0.1.0";
+export const DEFAULT_FETCH_TIMEOUT_MS = 30_000;
+export const STATIC_VENUES = [
+    {
+        venue: "binance",
+        asset_class: "perp",
+        auth_scheme: "hmac_sha256",
+        notes: "Binance USD-M futures via REST. v0 limited to testnet until pilot " +
+            "graduates. Symbol format: BTCUSDT (no slash).",
+    },
+    {
+        venue: "okx",
+        asset_class: "perp",
+        auth_scheme: "hmac_sha256",
+        notes: "OKX perpetual swap via REST. v0 limited to testnet. Symbol format: " +
+            "BTC-USDT-SWAP.",
+    },
+    {
+        venue: "asterdex",
+        asset_class: "perp",
+        auth_scheme: "eip712",
+        network: "bsc",
+        notes: "Asterdex on-chain perp. Uses Asterdex platform-controlled API wallet " +
+            "(narrow per-asset caps enforced by Signer policy).",
+    },
+];
+// ── Gateway HTTP ──
+export class GatewayError extends Error {
+    status;
+    body;
+    endpoint;
+    constructor(status, body, endpoint) {
+        super(`gateway ${endpoint} failed (${status}): ${body.slice(0, 240)}`);
+        this.status = status;
+        this.body = body;
+        this.endpoint = endpoint;
+        this.name = "GatewayError";
+    }
+}
+/**
+ * Single chokepoint for all gateway HTTP. Tests inject a `fetchImpl` and
+ * assert against the dispatched request.
+ *
+ * Edge cases handled:
+ *  - Missing token when authRequired → thrown with actionable message.
+ *  - Empty 200 OK body → returned as undefined (rare but possible on some
+ *    venues' cancel-already-filled paths).
+ *  - Non-2xx → GatewayError carries status + body for the agent to inspect.
+ *  - Timeout → AbortController + clearTimeout via try/finally.
+ */
+export async function callGateway(path, opts, cfg) {
+    const method = opts.method ?? "GET";
+    const hasToken = Boolean(cfg.apiToken && cfg.apiToken.length > 0);
+    if (opts.authRequired && !hasToken) {
+        throw new Error(`SIGNER_API_TOKEN is required to call ${path}. Set it in your MCP ` +
+            `client config — see README. (Issue tokens at https://usenami.io/signer.)`);
+    }
+    const url = `${cfg.gatewayUrl.replace(/\/+$/, "")}${path}`;
+    const timeoutMs = cfg.fetchTimeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS;
+    const fetchFn = cfg.fetchImpl ?? fetch;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const headers = {
+            Accept: "application/json",
+            "User-Agent": `@usenami/signer-mcp@${PACKAGE_VERSION}`,
+        };
+        if (hasToken)
+            headers.Authorization = `Bearer ${cfg.apiToken}`;
+        let serialized;
+        if (opts.body !== undefined) {
+            serialized = JSON.stringify(opts.body);
+            headers["Content-Type"] = "application/json";
+        }
+        const res = await fetchFn(url, {
+            method,
+            headers,
+            body: serialized,
+            signal: controller.signal,
+        });
+        const text = await res.text();
+        if (!res.ok)
+            throw new GatewayError(res.status, text, path);
+        return text.length === 0 ? undefined : JSON.parse(text);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export function toolJson(value) {
+    // Guard: JSON.stringify(undefined) returns undefined (not a string), which
+    // breaks downstream JSON.parse. Coerce undefined → null so empty 200-OK
+    // gateway responses still produce a valid text body.
+    const safe = value === undefined ? null : value;
+    return {
+        content: [{ type: "text", text: JSON.stringify(safe, null, 2) }],
+    };
+}
+export function toolError(message, hint) {
+    const payload = JSON.stringify(hint === undefined ? { error: message } : { error: message, hint }, null, 2);
+    return { content: [{ type: "text", text: payload }], isError: true };
+}
+function isSignedRequest(x) {
+    // Hardened: reject primitives (truthy strings/bools still match !!obj),
+    // reject null headers (`typeof null === "object"`), require string venue.
+    if (x === null || typeof x !== "object")
+        return false;
+    const obj = x;
+    return (typeof obj.venue === "string" &&
+        typeof obj.method === "string" &&
+        typeof obj.url === "string" &&
+        obj.headers !== null &&
+        typeof obj.headers === "object");
+}
+/**
+ * Submit a single signed request to a venue and return parsed JSON (or text
+ * if the response isn't JSON). Errors include the venue endpoint + status so
+ * the agent can reason about which side failed.
+ */
+export async function submitSignedRequest(req, fetchImpl, timeoutMs = DEFAULT_FETCH_TIMEOUT_MS) {
+    const fetchFn = fetchImpl ?? fetch;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetchFn(req.url, {
+            method: req.method,
+            headers: req.headers,
+            body: req.body,
+            signal: controller.signal,
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new Error(`venue ${req.venue} ${req.method} ${req.url.split("?")[0]} failed ` +
+                `(${res.status}): ${text.slice(0, 240)}`);
+        }
+        if (text.length === 0)
+            return null;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            // Some venues return non-JSON on success (rare). Pass through as string.
+            return text;
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Submit a "bundle" — either a single SignedRequest or a map of named
+ * SignedRequests (`{balance: ..., positions: ...}`). Parallel for composite,
+ * returns the same shape with raw venue responses in place of each request.
+ */
+export async function submitSignedBundle(bundle, fetchImpl, timeoutMs) {
+    if (isSignedRequest(bundle)) {
+        return submitSignedRequest(bundle, fetchImpl, timeoutMs);
+    }
+    // Composite — walk own keys, submit each SignedRequest in parallel.
+    if (bundle === null || typeof bundle !== "object") {
+        throw new Error("Unexpected /account response shape: not a SignedRequest and not a " +
+            "composite object. Gateway must return {method,url,headers} or " +
+            "{key: {method,url,headers}, ...}.");
+    }
+    const obj = bundle;
+    const entries = Object.entries(obj);
+    const requests = entries.filter(([, v]) => isSignedRequest(v));
+    if (requests.length === 0) {
+        // No signed requests at all — pass through (e.g. asterdex indexer
+        // payload may be returned directly by the gateway, not as a signed req).
+        return obj;
+    }
+    const results = await Promise.all(requests.map(async ([key, req]) => {
+        const resp = await submitSignedRequest(req, fetchImpl, timeoutMs);
+        return [key, resp];
+    }));
+    const out = {};
+    // Preserve any non-request fields (e.g. venue label).
+    for (const [k, v] of entries) {
+        if (!isSignedRequest(v))
+            out[k] = v;
+    }
+    for (const [k, v] of results)
+        out[k] = v;
+    return out;
+}
+// ── Tool handlers (pure logic, no MCP coupling) ──
+export async function handleListVenues() {
+    return toolJson({ venues: STATIC_VENUES, count: STATIC_VENUES.length });
+}
+export async function handleGetAttestation(cfg) {
+    try {
+        const data = await callGateway("/attestation", {}, cfg);
+        return toolJson(data);
+    }
+    catch (err) {
+        const e = err;
+        return toolError(e.message, "If the gateway is unreachable, list_venues still works (static " +
+            "manifest, no network). Verify SIGNER_GATEWAY_URL.");
+    }
+}
+/**
+ * Option-A flow for /account:
+ *   1. POST gateway /account/<venue> → returns SignedRequest bundle
+ *   2. submitSignedBundle → fetch venue with signed headers
+ *   3. dispatch raw response to venue-specific parser
+ *   4. return NormalizedAccount
+ *
+ * If the gateway response is NOT a SignedRequest (e.g. asterdex indexer
+ * returns parsed data directly), we feed the raw payload to the parser
+ * unchanged — parser is tolerant of both shapes.
+ */
+export async function handleGetAccount(cfg, args, getParser) {
+    const parser = getParser(args.venue);
+    if (parser === undefined) {
+        return toolError(`No account parser registered for venue '${args.venue}'.`, "Call list_venues to see supported venues.");
+    }
+    try {
+        const signed = await callGateway(`/account/${encodeURIComponent(args.venue)}`, { authRequired: true }, cfg);
+        const rawVenueResponse = await submitSignedBundle(signed, cfg.fetchImpl, cfg.fetchTimeoutMs);
+        const normalized = parser(rawVenueResponse);
+        return toolJson(normalized);
+    }
+    catch (err) {
+        return toolError(err.message);
+    }
+}
+/**
+ * Option-A flow for /sign/order:
+ *   1. POST gateway /sign/order with intent body → returns SignedRequest
+ *   2. submitSignedRequest → fetch venue, return raw venue receipt
+ *   3. agent sees venue's native response (order_id format etc)
+ *
+ * No parser layer here — order receipts are per-venue and we don't normalize
+ * them in v0. Agent inspects raw response to decide next action.
+ */
+export async function handlePlaceOrder(cfg, args) {
+    if (args.type === "limit" && args.price === undefined) {
+        return toolError("price is required when type=limit", "For market orders, omit price and set type=market.");
+    }
+    // type=market with price set is NOT rejected — some venues silently ignore,
+    // others use as limit-on-fail. We pass through so the venue decides.
+    try {
+        // Per CTO 2026-05-31T2240 decision: PER-VENUE endpoints (not a generic
+        // /sign/order). Each venue puts policy-relevant fields (symbol/qty/side)
+        // in a different location — Binance in query string, OKX in JSON body,
+        // Asterdex inside the EIP-712 message. Per-venue handlers enforce policy
+        // on the actual fields; a generic endpoint would muddy that.
+        const signed = await callGateway(`/sign/${encodeURIComponent(args.venue)}-order`, { method: "POST", body: args, authRequired: true }, cfg);
+        const venueResponse = await submitSignedBundle(signed, cfg.fetchImpl, cfg.fetchTimeoutMs);
+        return toolJson({ venue: args.venue, response: venueResponse });
+    }
+    catch (err) {
+        return toolError(err.message);
+    }
+}
+/**
+ * Option-A flow for /sign/cancel — same as place_order.
+ *
+ * Note: Binance + OKX cancel routes require `symbol` on top of `order_id`.
+ * The MCP tool exposes optional `symbol` to support these (and ignores it
+ * for venues that don't need it).
+ */
+export async function handleCancelOrder(cfg, args) {
+    try {
+        // Per-venue endpoint per CTO decision (same rationale as place_order).
+        const signed = await callGateway(`/sign/${encodeURIComponent(args.venue)}-cancel`, { method: "POST", body: args, authRequired: true }, cfg);
+        const venueResponse = await submitSignedBundle(signed, cfg.fetchImpl, cfg.fetchTimeoutMs);
+        return toolJson({ venue: args.venue, response: venueResponse });
+    }
+    catch (err) {
+        return toolError(err.message);
+    }
+}
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

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

package/dist/parsers/asterdex.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Asterdex account parser — v0 stub.
+ *
+ * Asterdex is a BSC on-chain perp DEX. Account state lives on-chain (margin
+ * vault + position records), so the "account" read isn't a single REST call
+ * — it's reading contract state via JSON-RPC or their indexer.
+ *
+ * For v0, we expect signer's gateway to return a combined payload from the
+ * indexer (the signer worker handles this — it's their decision how to
+ * shape it). Our parser is tolerant: if the shape matches the expected v0
+ * draft, we parse; otherwise return zeros with the raw timestamp.
+ *
+ * Expected v0 shape (subject to signer worker confirming):
+ *   {
+ *     "wallet": "0x...",
+ *     "equity_usd": "10000.0",       // already USD from the indexer
+ *     "available_margin_usd": "8500.0",
+ *     "positions": [
+ *       {
+ *         "market": "BTC-USD",
+ *         "size": "0.001",            // signed
+ *         "entry_price": "67000.0",
+ *         "mark_price": "67200.0",
+ *         "unrealized_pnl_usd": "0.2"
+ *       }
+ *     ],
+ *     "block_timestamp": 1717180800
+ *   }
+ *
+ * If the signer worker chooses a different shape, this parser is the only
+ * file that needs to change to absorb it — the public NormalizedAccount
+ * contract stays stable.
+ */
+import type { AccountParser } from "./types.js";
+export declare const parseAsterdexAccount: AccountParser;

package/dist/parsers/asterdex.js

@@ -0,0 +1,79 @@
+/**
+ * Asterdex account parser — v0 stub.
+ *
+ * Asterdex is a BSC on-chain perp DEX. Account state lives on-chain (margin
+ * vault + position records), so the "account" read isn't a single REST call
+ * — it's reading contract state via JSON-RPC or their indexer.
+ *
+ * For v0, we expect signer's gateway to return a combined payload from the
+ * indexer (the signer worker handles this — it's their decision how to
+ * shape it). Our parser is tolerant: if the shape matches the expected v0
+ * draft, we parse; otherwise return zeros with the raw timestamp.
+ *
+ * Expected v0 shape (subject to signer worker confirming):
+ *   {
+ *     "wallet": "0x...",
+ *     "equity_usd": "10000.0",       // already USD from the indexer
+ *     "available_margin_usd": "8500.0",
+ *     "positions": [
+ *       {
+ *         "market": "BTC-USD",
+ *         "size": "0.001",            // signed
+ *         "entry_price": "67000.0",
+ *         "mark_price": "67200.0",
+ *         "unrealized_pnl_usd": "0.2"
+ *       }
+ *     ],
+ *     "block_timestamp": 1717180800
+ *   }
+ *
+ * If the signer worker chooses a different shape, this parser is the only
+ * file that needs to change to absorb it — the public NormalizedAccount
+ * contract stays stable.
+ */
+function toNum(v, fallback = 0) {
+    if (typeof v === "number")
+        return Number.isFinite(v) ? v : fallback;
+    if (typeof v === "string" && v.length > 0) {
+        const n = parseFloat(v);
+        return Number.isFinite(n) ? n : fallback;
+    }
+    return fallback;
+}
+export const parseAsterdexAccount = (raw) => {
+    const obj = raw ?? {};
+    const positionsRaw = Array.isArray(obj.positions) ? obj.positions : [];
+    const positions = [];
+    for (const p of positionsRaw) {
+        const r = p ?? {};
+        const qty = toNum(r.size);
+        if (qty === 0)
+            continue;
+        const symbol = String(r.market ?? "");
+        if (symbol === "")
+            continue;
+        const out = {
+            symbol,
+            qty,
+            entry_price: toNum(r.entry_price),
+            unrealized_pnl: toNum(r.unrealized_pnl_usd),
+        };
+        if (r.mark_price !== undefined)
+            out.mark_price = toNum(r.mark_price);
+        positions.push(out);
+    }
+    let updated_at = new Date(0).toISOString();
+    if (typeof obj.block_timestamp === "number" && Number.isFinite(obj.block_timestamp)) {
+        // Block timestamps are typically seconds, not ms.
+        const ms = obj.block_timestamp > 1e12 ? obj.block_timestamp : obj.block_timestamp * 1000;
+        updated_at = new Date(ms).toISOString();
+    }
+    return {
+        venue: "asterdex",
+        equity_usd: toNum(obj.equity_usd),
+        free_margin_usd: toNum(obj.available_margin_usd),
+        positions,
+        updated_at,
+    };
+};
+//# sourceMappingURL=asterdex.js.map

package/dist/parsers/asterdex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asterdex.js","sourceRoot":"","sources":["../../src/parsers/asterdex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,SAAS,KAAK,CAAC,CAAU,EAAE,QAAQ,GAAG,CAAC;IACrC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpE,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAkB,CAAC,GAAG,EAAqB,EAAE;IAC5E,MAAM,GAAG,GAAI,GAA+B,IAAI,EAAE,CAAC;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,MAAM,SAAS,GAAyB,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAI,CAA6B,IAAI,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,GAAG,KAAK,CAAC;YAAE,SAAS;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,EAAE;YAAE,SAAS;QAC5B,MAAM,GAAG,GAAuB;YAC9B,MAAM;YACN,GAAG;YACH,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;YACjC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC;SAC5C,CAAC;QACF,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS;YAAE,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACrE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACpF,kDAAkD;QAClD,MAAM,EAAE,GAAG,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC;QACzF,UAAU,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC;IAED,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QACjC,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAChD,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC,CAAC"}

package/dist/parsers/binance.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Binance USD-M Futures account parser.
+ *
+ * Endpoint: GET /fapi/v2/account
+ * Docs: https://developers.binance.com/docs/derivatives/usds-margined-futures/account/rest-api/Account-Information-V2
+ *
+ * Schema (only the fields we use):
+ *   {
+ *     "totalMarginBalance": "10000.00",   // total equity
+ *     "totalUnrealizedProfit": "12.34",
+ *     "availableBalance": "8500.00",      // free margin
+ *     "updateTime": 1717180800000,
+ *     "positions": [
+ *       {
+ *         "symbol": "BTCUSDT",
+ *         "positionAmt": "0.002",         // signed: + long, - short
+ *         "entryPrice": "67120.5",
+ *         "unrealizedProfit": "1.23",
+ *         "markPrice": "67200.0"          // not in /v2/account; we leave undefined
+ *       }
+ *     ]
+ *   }
+ *
+ * Notes on quirks:
+ *   - Binance returns numbers as strings — parseFloat with NaN guards.
+ *   - positionAmt "0" rows appear for every symbol the account has ever
+ *     traded; we filter them out so the agent only sees real positions.
+ *   - markPrice isn't on /v2/account — it's on /v1/premiumIndex per-symbol.
+ *     Leave undefined; agent uses get_orderbook or similar if needed.
+ */
+import type { AccountParser } from "./types.js";
+export declare const parseBinanceAccount: AccountParser;

package/dist/parsers/binance.js

@@ -0,0 +1,72 @@
+/**
+ * Binance USD-M Futures account parser.
+ *
+ * Endpoint: GET /fapi/v2/account
+ * Docs: https://developers.binance.com/docs/derivatives/usds-margined-futures/account/rest-api/Account-Information-V2
+ *
+ * Schema (only the fields we use):
+ *   {
+ *     "totalMarginBalance": "10000.00",   // total equity
+ *     "totalUnrealizedProfit": "12.34",
+ *     "availableBalance": "8500.00",      // free margin
+ *     "updateTime": 1717180800000,
+ *     "positions": [
+ *       {
+ *         "symbol": "BTCUSDT",
+ *         "positionAmt": "0.002",         // signed: + long, - short
+ *         "entryPrice": "67120.5",
+ *         "unrealizedProfit": "1.23",
+ *         "markPrice": "67200.0"          // not in /v2/account; we leave undefined
+ *       }
+ *     ]
+ *   }
+ *
+ * Notes on quirks:
+ *   - Binance returns numbers as strings — parseFloat with NaN guards.
+ *   - positionAmt "0" rows appear for every symbol the account has ever
+ *     traded; we filter them out so the agent only sees real positions.
+ *   - markPrice isn't on /v2/account — it's on /v1/premiumIndex per-symbol.
+ *     Leave undefined; agent uses get_orderbook or similar if needed.
+ */
+function toNum(v, fallback = 0) {
+    if (typeof v === "number")
+        return Number.isFinite(v) ? v : fallback;
+    if (typeof v === "string") {
+        const n = parseFloat(v);
+        return Number.isFinite(n) ? n : fallback;
+    }
+    return fallback;
+}
+function toIso(updateTime) {
+    if (typeof updateTime === "number" && Number.isFinite(updateTime)) {
+        return new Date(updateTime).toISOString();
+    }
+    return new Date(0).toISOString(); // epoch sentinel — caller can detect
+}
+export const parseBinanceAccount = (raw) => {
+    const obj = raw ?? {};
+    const positionsRaw = Array.isArray(obj.positions) ? obj.positions : [];
+    const positions = positionsRaw
+        .map((p) => {
+        const r = p ?? {};
+        const qty = toNum(r.positionAmt);
+        if (qty === 0)
+            return null;
+        return {
+            symbol: String(r.symbol ?? ""),
+            qty,
+            entry_price: toNum(r.entryPrice),
+            unrealized_pnl: toNum(r.unrealizedProfit),
+            // markPrice intentionally undefined — not on /v2/account
+        };
+    })
+        .filter((p) => p !== null && p.symbol !== "");
+    return {
+        venue: "binance",
+        equity_usd: toNum(obj.totalMarginBalance),
+        free_margin_usd: toNum(obj.availableBalance),
+        positions,
+        updated_at: toIso(obj.updateTime),
+    };
+};
+//# sourceMappingURL=binance.js.map

package/dist/parsers/binance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binance.js","sourceRoot":"","sources":["../../src/parsers/binance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,SAAS,KAAK,CAAC,CAAU,EAAE,QAAQ,GAAG,CAAC;IACrC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACpE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,KAAK,CAAC,UAAmB;IAChC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,qCAAqC;AACzE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAkB,CAAC,GAAG,EAAqB,EAAE;IAC3E,MAAM,GAAG,GAAI,GAA+B,IAAI,EAAE,CAAC;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,MAAM,SAAS,GAAyB,YAAY;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,CAAC,GAAI,CAA6B,IAAI,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;YAC9B,GAAG;YACH,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;YAChC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC;YACzC,yDAAyD;SAC7B,CAAC;IACjC,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAA2B,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IAEzE,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACzC,eAAe,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC5C,SAAS;QACT,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;KAClC,CAAC;AACJ,CAAC,CAAC"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Venue parser dispatcher.
+ *
+ * Under the Option-A architecture (per signer 2026-05-31T2150 schema doc),
+ * signer-mcp:
+ *   1. calls signer gateway /account/<venue> → gets a signed read request
+ *   2. fetches the venue URL with the signed headers
+ *   3. dispatches the raw response to the venue-specific parser here
+ *   4. returns a NormalizedAccount to the agent
+ *
+ * Adding a venue = adding a parser file + entry below. Pure TS, no enclave
+ * involvement.
+ */
+import type { AccountParser } from "./types.js";
+export declare function getAccountParser(venue: string): AccountParser | undefined;
+export type { NormalizedAccount, NormalizedPosition, SignedRequest } from "./types.js";

package/dist/parsers/index.js

@@ -0,0 +1,25 @@
+/**
+ * Venue parser dispatcher.
+ *
+ * Under the Option-A architecture (per signer 2026-05-31T2150 schema doc),
+ * signer-mcp:
+ *   1. calls signer gateway /account/<venue> → gets a signed read request
+ *   2. fetches the venue URL with the signed headers
+ *   3. dispatches the raw response to the venue-specific parser here
+ *   4. returns a NormalizedAccount to the agent
+ *
+ * Adding a venue = adding a parser file + entry below. Pure TS, no enclave
+ * involvement.
+ */
+import { parseAsterdexAccount } from "./asterdex.js";
+import { parseBinanceAccount } from "./binance.js";
+import { parseOkxAccount } from "./okx.js";
+const PARSERS = {
+    binance: parseBinanceAccount,
+    okx: parseOkxAccount,
+    asterdex: parseAsterdexAccount,
+};
+export function getAccountParser(venue) {
+    return PARSERS[venue];
+}
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,MAAM,OAAO,GAAkC;IAC7C,OAAO,EAAE,mBAAmB;IAC5B,GAAG,EAAE,eAAe;IACpB,QAAQ,EAAE,oBAAoB;CAC/B,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/parsers/okx.d.ts

@@ -0,0 +1,34 @@
+/**
+ * OKX v5 account parser.
+ *
+ * OKX splits balance and positions across TWO endpoints:
+ *   GET /api/v5/account/balance   → equity + free margin
+ *   GET /api/v5/account/positions → open positions
+ *
+ * For the Option-A architecture this means signer's `/account/<venue>` for
+ * OKX may need to return TWO signed requests (or one composite). For v0 we
+ * accept a combined raw payload:
+ *
+ *   {
+ *     "balance":   { ...OKX /balance response... },
+ *     "positions": { ...OKX /positions response... }
+ *   }
+ *
+ * If only `balance` is present (positions response missing), we still emit
+ * a valid NormalizedAccount with empty positions — the agent can decide.
+ *
+ * OKX response wrapper: { "code": "0", "msg": "", "data": [ {...} ] }
+ * Single-element data arrays are typical for these endpoints.
+ *
+ * Docs:
+ *   https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-balance
+ *   https://www.okx.com/docs-v5/en/#trading-account-rest-api-get-positions
+ *
+ * Quirks:
+ *   - OKX returns numbers as strings (like Binance).
+ *   - Empty equity field returns "" not null.
+ *   - Positions array can include zeroed-out rows after closes; filter them.
+ *   - `instId` is OKX's symbol field (e.g. "BTC-USDT-SWAP").
+ */
+import type { AccountParser } from "./types.js";
+export declare const parseOkxAccount: AccountParser;