@ironwallet/mcp-server 1.0.0-preprod.0

package/dist/api/http.js

@@ -0,0 +1,277 @@
+/**
+ * Fetch helper with JSON handling, per-attempt timeouts and bounded retries.
+ *
+ * Timeouts: every attempt is aborted after `timeoutMs` (default from config).
+ * Retries: transient failures (network errors, timeouts, and retryable HTTP
+ * statuses like 429/5xx) are retried with exponential backoff + jitter, honoring
+ * a `Retry-After` header when present.
+ *
+ * Safety: retries default ON for idempotent methods (GET/HEAD) and OFF for others
+ * (a broadcast POST must never be silently resent). Callers can override this per
+ * request with `retry: true` for read-only POSTs (e.g. auth, Tron node reads).
+ *
+ * Every attempt is written to the JSONL file logger (see src/log.ts) with
+ * timings, status, retry decisions and undici cause chains — without secrets.
+ */
+import { getConfig } from "../config.js";
+import { errorDetails, logDebug, logError, logInfo, logWarn, newCorrelationId, redactHeaders, summarizeBody, truncate, } from "../log.js";
+const RETRYABLE_STATUS = new Set([408, 425, 429, 500, 502, 503, 504]);
+function isIdempotent(method) {
+    return method === "GET" || method === "HEAD" || method === "OPTIONS";
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Backoff for attempt N (0-based): ~0.3s, 0.6s, 1.2s … capped, plus jitter. */
+function backoffMs(attempt, retryAfter) {
+    if (retryAfter) {
+        const secs = Number(retryAfter);
+        if (Number.isFinite(secs))
+            return Math.min(30000, Math.max(0, secs * 1000));
+        const date = Date.parse(retryAfter);
+        if (!Number.isNaN(date))
+            return Math.min(30000, Math.max(0, date - Date.now()));
+    }
+    const base = Math.min(4000, 300 * 2 ** attempt);
+    return base + Math.floor(Math.random() * 250);
+}
+function pickResponseHeaders(res) {
+    const interesting = [
+        "content-type",
+        "content-length",
+        "retry-after",
+        "x-request-id",
+        "x-correlation-id",
+        "x-amzn-trace-id",
+        "cf-ray",
+        "date",
+        "server",
+    ];
+    const out = {};
+    for (const h of interesting) {
+        const v = res.headers.get(h);
+        if (v)
+            out[h] = v;
+    }
+    return out;
+}
+export async function httpJson(url, init, opts = {}) {
+    const cfg = getConfig();
+    const method = (init.method ?? "GET").toUpperCase();
+    const timeoutMs = opts.timeoutMs ?? cfg.httpTimeoutMs;
+    const retriesEnabled = opts.retry ?? isIdempotent(method);
+    const maxRetries = retriesEnabled ? opts.retries ?? cfg.httpRetries : 0;
+    const correlationId = opts.correlationId ?? newCorrelationId("http");
+    const label = opts.label ?? "http";
+    const startedAt = Date.now();
+    const bodyText = typeof init.body === "string"
+        ? init.body
+        : init.body != null
+            ? String(init.body)
+            : undefined;
+    logInfo("http.request.start", {
+        correlationId,
+        label,
+        method,
+        url,
+        timeoutMs,
+        retriesEnabled,
+        maxRetries,
+        headers: redactHeaders(init.headers),
+        body: summarizeBody(bodyText),
+    });
+    let attempt = 0;
+    for (;;) {
+        const attemptStarted = Date.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let timedOut = false;
+        controller.signal.addEventListener("abort", () => {
+            timedOut = true;
+        });
+        logDebug("http.attempt.start", {
+            correlationId,
+            label,
+            method,
+            url,
+            attempt,
+            maxRetries,
+            timeoutMs,
+            elapsedMs: Date.now() - startedAt,
+        });
+        try {
+            const res = await fetch(url, { ...init, signal: controller.signal });
+            const headersMs = Date.now() - attemptStarted;
+            const text = await res.text();
+            const totalAttemptMs = Date.now() - attemptStarted;
+            if (!res.ok) {
+                const willRetry = attempt < maxRetries && RETRYABLE_STATUS.has(res.status);
+                logWarn("http.attempt.http_error", {
+                    correlationId,
+                    label,
+                    method,
+                    url,
+                    attempt,
+                    status: res.status,
+                    statusText: res.statusText,
+                    headersMs,
+                    totalAttemptMs,
+                    responseHeaders: pickResponseHeaders(res),
+                    bodyPreview: truncate(text, 800),
+                    willRetry,
+                    retryableStatus: RETRYABLE_STATUS.has(res.status),
+                });
+                if (willRetry) {
+                    clearTimeout(timer);
+                    const wait = backoffMs(attempt, res.headers.get("retry-after"));
+                    logInfo("http.retry", {
+                        correlationId,
+                        label,
+                        attempt,
+                        nextAttempt: attempt + 1,
+                        waitMs: wait,
+                        reason: `HTTP ${res.status}`,
+                    });
+                    await delay(wait);
+                    attempt++;
+                    continue;
+                }
+                const err = new Error(`HTTP ${res.status} for ${method} ${url}: ${text.slice(0, 500)}`);
+                err.status = res.status;
+                err.body = text;
+                logError("http.request.fail", err, {
+                    correlationId,
+                    label,
+                    method,
+                    url,
+                    attempts: attempt + 1,
+                    elapsedMs: Date.now() - startedAt,
+                    kind: "http_status",
+                });
+                throw err;
+            }
+            logInfo("http.attempt.ok", {
+                correlationId,
+                label,
+                method,
+                url,
+                attempt,
+                status: res.status,
+                headersMs,
+                bodyMs: totalAttemptMs - headersMs,
+                totalAttemptMs,
+                elapsedMs: Date.now() - startedAt,
+                responseHeaders: pickResponseHeaders(res),
+                body: summarizeBody(text),
+            });
+            logInfo("http.request.ok", {
+                correlationId,
+                label,
+                method,
+                url,
+                attempts: attempt + 1,
+                elapsedMs: Date.now() - startedAt,
+                status: res.status,
+            });
+            if (!text)
+                return undefined;
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                return text;
+            }
+        }
+        catch (e) {
+            // HttpError (non-retryable status) bubbles straight up (already logged).
+            if (e instanceof Error && "status" in e)
+                throw e;
+            const attemptMs = Date.now() - attemptStarted;
+            const transient = timedOut || isTransport(e);
+            const willRetry = attempt < maxRetries && transient;
+            logWarn("http.attempt.transport_error", {
+                correlationId,
+                label,
+                method,
+                url,
+                attempt,
+                timedOut,
+                timeoutMs,
+                attemptMs,
+                elapsedMs: Date.now() - startedAt,
+                isTransport: isTransport(e),
+                willRetry,
+                error: errorDetails(e),
+            });
+            if (willRetry) {
+                const wait = backoffMs(attempt);
+                logInfo("http.retry", {
+                    correlationId,
+                    label,
+                    attempt,
+                    nextAttempt: attempt + 1,
+                    waitMs: wait,
+                    reason: timedOut ? "timeout" : "transport",
+                });
+                await delay(wait);
+                attempt++;
+                continue;
+            }
+            if (timedOut) {
+                const err = new Error(`Request timed out after ${timeoutMs}ms for ${method} ${url}` +
+                    (attempt > 0 ? ` (after ${attempt + 1} attempts)` : ""));
+                logError("http.request.fail", err, {
+                    correlationId,
+                    label,
+                    method,
+                    url,
+                    attempts: attempt + 1,
+                    elapsedMs: Date.now() - startedAt,
+                    kind: "timeout",
+                    timeoutMs,
+                    note: method === "POST" && /\/forward$/.test(url)
+                        ? "Broadcast may still have been accepted by the relay — check balances before retrying."
+                        : undefined,
+                });
+                throw err;
+            }
+            const msg = e instanceof Error ? e.message : String(e);
+            const err = new Error(`Network error for ${method} ${url}: ${msg}`);
+            logError("http.request.fail", err, {
+                correlationId,
+                label,
+                method,
+                url,
+                attempts: attempt + 1,
+                elapsedMs: Date.now() - startedAt,
+                kind: "transport",
+                cause: errorDetails(e),
+                note: method === "POST" && /\/forward$/.test(url)
+                    ? "Connection dropped after send; relay may still have processed the request — check balances before retrying."
+                    : undefined,
+            });
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+/** Transport-level failures worth retrying (DNS/connection resets, fetch failed). */
+function isTransport(e) {
+    if (!(e instanceof Error))
+        return false;
+    // undici surfaces network issues as TypeError('fetch failed') with a cause.
+    if (e.name === "TypeError")
+        return true;
+    const code = e.code;
+    if (code && ["ECONNRESET", "ECONNREFUSED", "ETIMEDOUT", "EAI_AGAIN", "ENOTFOUND", "EPIPE"].includes(code)) {
+        return true;
+    }
+    const cause = e.cause;
+    if (cause?.code && ["ECONNRESET", "ECONNREFUSED", "ETIMEDOUT", "EAI_AGAIN", "ENOTFOUND", "EPIPE", "UND_ERR_CONNECT_TIMEOUT", "UND_ERR_SOCKET"].includes(cause.code)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=http.js.map

package/dist/api/http.js.map

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

package/dist/api/relay.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Relay (forward) API client, mirroring the mobile RelayApiV2Client:
+ *   GET  {relayUrl}{ver}/{Network}/forward/estimate?fromAddress&toAddress&...
+ *   POST {relayUrl}{ver}/{Network}/forward
+ *   GET  {relayUrl}{ver}/{Network}/forward/operation/{id}/state
+ *
+ * `ver` defaults to `/v1` (gasless v1). Set IW_RELAY_VERSION= (empty) or
+ * IW_RELAY_VERSION=v0 to fall back to the legacy path without a version segment.
+ */
+import { type NetworkId } from "../config.js";
+import type { SignedTransaction, TransactionToSign } from "../signing/types.js";
+export interface EstimateResult {
+    amount?: string;
+    coinFee?: string;
+    tokenFee?: string;
+    transactionsToSign: TransactionToSign[];
+    additionalEstimates?: unknown[];
+    timeout?: number;
+}
+export interface SignedEstimate {
+    signature?: string;
+    estimateResult?: EstimateResult;
+    traceId?: string;
+}
+export interface ForwardResult {
+    txHash?: string;
+    operationId?: string;
+    chainId?: string;
+    [k: string]: unknown;
+}
+export interface EstimateParams {
+    fromAddress: string;
+    toAddress: string;
+    tokenAddress?: string;
+    amount: string;
+    memo?: string;
+    /** Required for TON (mobile IR-673): 32-byte ed25519 pubkey hex. */
+    fromPublicKey?: string;
+}
+export interface RelayCallOpts {
+    correlationId?: string;
+}
+export declare function estimate(network: NetworkId, token: string, params: EstimateParams, callOpts?: RelayCallOpts): Promise<SignedEstimate>;
+export declare function forward(network: NetworkId, token: string, params: EstimateParams, signedEstimateResult: SignedEstimate, signedTransactions: SignedTransaction[], callOpts?: RelayCallOpts): Promise<ForwardResult>;
+export declare function operationState(network: NetworkId, token: string, operationId: string, callOpts?: RelayCallOpts): Promise<{
+    state?: string;
+    reasonCode?: string;
+    [k: string]: unknown;
+}>;

package/dist/api/relay.js

@@ -0,0 +1,194 @@
+/**
+ * Relay (forward) API client, mirroring the mobile RelayApiV2Client:
+ *   GET  {relayUrl}{ver}/{Network}/forward/estimate?fromAddress&toAddress&...
+ *   POST {relayUrl}{ver}/{Network}/forward
+ *   GET  {relayUrl}{ver}/{Network}/forward/operation/{id}/state
+ *
+ * `ver` defaults to `/v1` (gasless v1). Set IW_RELAY_VERSION= (empty) or
+ * IW_RELAY_VERSION=v0 to fall back to the legacy path without a version segment.
+ */
+import { getConfig, relaySegment } from "../config.js";
+import { authHeaders } from "./auth.js";
+import { httpJson } from "./http.js";
+import { logError, logInfo, newCorrelationId } from "../log.js";
+function versionSegment() {
+    // Default to v1 (matches the mobile gaslessV1 path). Explicit empty / "v0"
+    // selects the legacy unversioned URL.
+    const raw = process.env.IW_RELAY_VERSION;
+    const v = (raw === undefined ? "v1" : raw).trim();
+    if (!v || v === "v0")
+        return "";
+    return v.startsWith("/") ? v : `/${v}`;
+}
+function baseUrl(network) {
+    const cfg = getConfig();
+    return `${cfg.relayUrl}${versionSegment()}/${relaySegment(network)}`;
+}
+export async function estimate(network, token, params, callOpts = {}) {
+    const correlationId = callOpts.correlationId ?? newCorrelationId("est");
+    const query = new URLSearchParams();
+    query.set("fromAddress", params.fromAddress);
+    query.set("toAddress", params.toAddress);
+    if (params.tokenAddress)
+        query.set("tokenAddress", params.tokenAddress);
+    query.set("amount", params.amount);
+    if (params.memo)
+        query.set("memo", params.memo);
+    if (params.fromPublicKey)
+        query.set("fromPublicKey", params.fromPublicKey);
+    const url = `${baseUrl(network)}/forward/estimate?${query.toString()}`;
+    logInfo("relay.estimate.start", {
+        correlationId,
+        network,
+        fromAddress: params.fromAddress,
+        toAddress: params.toAddress,
+        amount: params.amount,
+        tokenAddress: params.tokenAddress,
+        hasMemo: Boolean(params.memo),
+        hasFromPublicKey: Boolean(params.fromPublicKey),
+        url,
+    });
+    const started = Date.now();
+    try {
+        const result = await httpJson(url, {
+            method: "GET",
+            headers: authHeaders(token),
+        }, { correlationId, label: "relay.estimate" });
+        const er = result.estimateResult;
+        logInfo("relay.estimate.ok", {
+            correlationId,
+            network,
+            elapsedMs: Date.now() - started,
+            traceId: result.traceId,
+            amount: er?.amount,
+            coinFee: er?.coinFee,
+            tokenFee: er?.tokenFee,
+            transactionsToSign: er?.transactionsToSign?.length ?? 0,
+            timeout: er?.timeout,
+            hasSignature: typeof result.signature === "string",
+        });
+        return result;
+    }
+    catch (e) {
+        logError("relay.estimate.fail", e, {
+            correlationId,
+            network,
+            elapsedMs: Date.now() - started,
+        });
+        throw e;
+    }
+}
+export async function forward(network, token, params, signedEstimateResult, signedTransactions, callOpts = {}) {
+    const correlationId = callOpts.correlationId ?? newCorrelationId("fwd");
+    const body = {
+        fromAddress: params.fromAddress,
+        toAddress: params.toAddress,
+        amount: params.amount,
+        signedEstimateResult,
+        signedTransactions,
+    };
+    if (params.tokenAddress)
+        body.tokenAddress = params.tokenAddress;
+    const cfg = getConfig();
+    const url = `${baseUrl(network)}/forward`;
+    logInfo("relay.forward.start", {
+        correlationId,
+        network,
+        fromAddress: params.fromAddress,
+        toAddress: params.toAddress,
+        amount: params.amount,
+        tokenAddress: params.tokenAddress,
+        url,
+        timeoutMs: cfg.httpForwardTimeoutMs,
+        retries: false,
+        signedTxCount: signedTransactions.length,
+        signedTxs: signedTransactions.map((t, i) => ({
+            i,
+            transactionId: t.transactionId,
+            txID: t.txID,
+            signatureLen: t.signature?.length,
+            txDataLen: t.txData?.length,
+        })),
+        estimateTraceId: signedEstimateResult.traceId,
+        estimateAmount: signedEstimateResult.estimateResult?.amount,
+        estimateCoinFee: signedEstimateResult.estimateResult?.coinFee,
+        estimateTokenFee: signedEstimateResult.estimateResult?.tokenFee,
+    });
+    const started = Date.now();
+    try {
+        const result = await httpJson(url, {
+            method: "POST",
+            headers: { ...authHeaders(token), "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        }, 
+        // Never retry a broadcast. Use the longer forward timeout — the relay may
+        // still submit the tx even if the client would otherwise give up at 15s.
+        {
+            retry: false,
+            timeoutMs: cfg.httpForwardTimeoutMs,
+            correlationId,
+            label: "relay.forward",
+        });
+        logInfo("relay.forward.ok", {
+            correlationId,
+            network,
+            elapsedMs: Date.now() - started,
+            txHash: result.txHash,
+            operationId: result.operationId,
+            chainId: result.chainId,
+            resultKeys: Object.keys(result),
+        });
+        return result;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        const timedOut = /timed out/i.test(msg);
+        logError("relay.forward.fail", e, {
+            correlationId,
+            network,
+            elapsedMs: Date.now() - started,
+            timedOut,
+            timeoutMs: cfg.httpForwardTimeoutMs,
+            warning: "Relay may still have broadcast the transaction. Check sender/receiver balances and explorer before retrying — do not resend blindly.",
+        });
+        if (timedOut) {
+            throw new Error(`${msg}. The relay may still have broadcast the transaction — ` +
+                `check the wallet balance / explorer before retrying (do not resend blindly). ` +
+                `[correlationId=${correlationId}]`);
+        }
+        throw new Error(`${msg} [correlationId=${correlationId}]` +
+            (/fetch failed|Network error/i.test(msg)
+                ? ". Connection may have dropped after the relay accepted the request — check balances before retrying."
+                : ""));
+    }
+}
+export async function operationState(network, token, operationId, callOpts = {}) {
+    const correlationId = callOpts.correlationId ?? newCorrelationId("ops");
+    const url = `${baseUrl(network)}/forward/operation/${operationId}/state`;
+    logInfo("relay.operation_state.start", {
+        correlationId,
+        network,
+        operationId,
+        url,
+    });
+    try {
+        const result = await httpJson(url, { method: "GET", headers: authHeaders(token) }, { correlationId, label: "relay.operation_state" });
+        logInfo("relay.operation_state.ok", {
+            correlationId,
+            network,
+            operationId,
+            state: result.state,
+            reasonCode: result.reasonCode,
+        });
+        return result;
+    }
+    catch (e) {
+        logError("relay.operation_state.fail", e, {
+            correlationId,
+            network,
+            operationId,
+        });
+        throw e;
+    }
+}
+//# sourceMappingURL=relay.js.map

package/dist/api/relay.js.map

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

package/dist/api/rpc.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared ethers JsonRpcProvider factory with a bounded per-request timeout.
+ *
+ * ethers' default FetchRequest timeout is 5 minutes, which would let a stuck RPC
+ * node hang balance reads and the signing nonce/chainId lookups indefinitely. We
+ * cap it at the configured HTTP timeout and cache one provider per URL.
+ */
+import { JsonRpcProvider } from "ethers";
+import { type NetworkId } from "../config.js";
+export declare function providerFor(network: NetworkId): JsonRpcProvider;

package/dist/api/rpc.js

@@ -0,0 +1,26 @@
+/**
+ * Shared ethers JsonRpcProvider factory with a bounded per-request timeout.
+ *
+ * ethers' default FetchRequest timeout is 5 minutes, which would let a stuck RPC
+ * node hang balance reads and the signing nonce/chainId lookups indefinitely. We
+ * cap it at the configured HTTP timeout and cache one provider per URL.
+ */
+import { FetchRequest, JsonRpcProvider } from "ethers";
+import { getConfig } from "../config.js";
+const providerCache = new Map();
+export function providerFor(network) {
+    const cfg = getConfig();
+    const url = cfg.evmRpcUrls[network];
+    if (!url)
+        throw new Error(`No RPC endpoint configured for ${network}.`);
+    let provider = providerCache.get(url);
+    if (!provider) {
+        const req = new FetchRequest(url);
+        req.timeout = cfg.httpTimeoutMs;
+        // Assume a stable chain id so ethers doesn't re-detect the network on every call.
+        provider = new JsonRpcProvider(req, undefined, { staticNetwork: true });
+        providerCache.set(url, provider);
+    }
+    return provider;
+}
+//# sourceMappingURL=rpc.js.map

package/dist/api/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/api/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,SAAS,EAAkB,MAAM,cAAc,CAAC;AAEzD,MAAM,aAAa,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEzD,MAAM,UAAU,WAAW,CAAC,OAAkB;IAC5C,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,GAAG,CAAC,CAAC;IAExE,IAAI,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;QAClC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,aAAa,CAAC;QAChC,kFAAkF;QAClF,QAAQ,GAAG,IAAI,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}