@ironwallet/mcp-server 1.0.3 → 1.2.0

package/dist/api/history/providers/tronscan.js

@@ -0,0 +1,153 @@
+/**
+ * TronScan API (apilist.tronscanapi.com shape), reached through the team's
+ * keyless caching proxy at tronscanner.org/api/tron. Two sources:
+ * `/transaction` (all transactions of the address, newest first) and
+ * `/token_trc20/transfers`. Offset-based (`start` / `limit`), TronScan caps
+ * `limit` at 50 — same as the tool's max.
+ */
+import { httpJson } from "../../http.js";
+import { amountOf, asString, clampDecimals, directionOf, exactAddressMatcher, feeOf, timeFrom, tokenAsset, toBigInt, toBlockNumber, } from "../normalize.js";
+/** TRON contract types that move TRX or TRC-10 (protocol.Transaction.Contract.ContractType). */
+const TRANSFER_CONTRACT = 1;
+const TRANSFER_ASSET_CONTRACT = 2;
+const TRIGGER_SMART_CONTRACT = 31;
+/**
+ * TronScan's `confirmed:false` means "not yet solid" (~1 minute), the tx is
+ * already in a block. Only rows without a block are reported as pending.
+ */
+function tronStatus(block, ret, revert) {
+    if (revert || (ret && ret !== "SUCCESS"))
+        return "failed";
+    return typeof block === "number" && block > 0 ? "confirmed" : "pending";
+}
+export function mapTronScanTx(tx, address) {
+    const hash = asString(tx.hash);
+    if (!hash)
+        return null;
+    const time = timeFrom(tx.timestamp);
+    const isSelf = exactAddressMatcher(address);
+    const from = asString(tx.ownerAddress);
+    const to = asString(tx.toAddress) ?? asString(tx.trigger_info?.contract_address);
+    const direction = directionOf(from, to, isSelf);
+    const status = tronStatus(tx.block, tx.contractRet, tx.revert);
+    const feeRaw = toBigInt(tx.cost?.fee ?? 0);
+    const amount = toBigInt(tx.amount);
+    const contractType = tx.contractType;
+    let item;
+    if (contractType === TRANSFER_CONTRACT) {
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block: toBlockNumber(tx.block),
+            kind: "transfer",
+            direction,
+            status,
+            from,
+            to,
+            asset: { symbol: "TRX", contractAddress: null, decimals: 6 },
+            amount: amountOf(amount, 6),
+            fee: direction === "in" ? null : feeOf(feeRaw, 6, "TRX"),
+        };
+    }
+    else if (contractType === TRANSFER_ASSET_CONTRACT) {
+        const decimals = clampDecimals(tx.tokenInfo?.tokenDecimal, 6);
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block: toBlockNumber(tx.block),
+            kind: "token_transfer",
+            direction,
+            status,
+            from,
+            to,
+            asset: tokenAsset(tx.tokenInfo?.tokenAbbr, "TRC10", asString(tx.tokenInfo?.tokenId), decimals),
+            amount: amountOf(amount, decimals),
+            fee: direction === "in" ? null : feeOf(feeRaw, 6, "TRX"),
+        };
+    }
+    else {
+        // TriggerSmartContract and everything else. TRC-20 amounts come from the
+        // dedicated transfers source; here we only record the call (and TRX sent
+        // along with it via call_value, which TronScan reports as `amount`).
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block: toBlockNumber(tx.block),
+            kind: contractType === TRIGGER_SMART_CONTRACT ? "contract_call" : "other",
+            direction,
+            status,
+            from,
+            to,
+            asset: { symbol: "TRX", contractAddress: null, decimals: 6 },
+            amount: amountOf(amount, 6),
+            fee: direction === "in" ? null : feeOf(feeRaw, 6, "TRX"),
+        };
+    }
+    return { ts: time?.ts ?? 0, item };
+}
+export function mapTronScanTrc20(row, address) {
+    const hash = asString(row.transaction_id);
+    const contract = asString(row.contract_address) ?? asString(row.tokenInfo?.tokenId);
+    if (!hash || !contract)
+        return null;
+    const time = timeFrom(row.block_ts);
+    const isSelf = exactAddressMatcher(address);
+    const from = asString(row.from_address);
+    const to = asString(row.to_address);
+    const decimals = clampDecimals(row.tokenInfo?.tokenDecimal, 6);
+    const item = {
+        hash,
+        timestamp: time?.iso ?? null,
+        block: toBlockNumber(row.block),
+        kind: "token_transfer",
+        direction: directionOf(from, to, isSelf),
+        status: tronStatus(row.block, row.finalResult ?? row.contractRet, row.revert),
+        from,
+        to,
+        asset: tokenAsset(row.tokenInfo?.tokenAbbr, "TRC20", contract, decimals),
+        amount: amountOf(toBigInt(row.quant), decimals),
+        // The TRX fee sits on the transaction row (same hash) in the "native" source.
+        fee: null,
+    };
+    return { ts: time?.ts ?? 0, item };
+}
+function offsetOf(cursor) {
+    if (cursor === null)
+        return 0;
+    const n = Number.parseInt(cursor, 10);
+    if (!Number.isInteger(n) || n < 0)
+        throw new Error("Invalid cursor for tronscan source.");
+    return n;
+}
+export function tronscanProvider(baseUrl, address) {
+    const native = {
+        name: "native",
+        async fetchPage(cursor, pageSize, ctx) {
+            const start = offsetOf(cursor);
+            const url = `${baseUrl}/transaction?address=${encodeURIComponent(address)}` +
+                `&limit=${pageSize}&start=${start}&sort=-timestamp&count=true`;
+            const res = await httpJson(url, { method: "GET" }, { ...ctx.http, label: "history.tronscan.transaction" });
+            const rows = Array.isArray(res.data) ? res.data : null;
+            if (!rows)
+                throw new Error("tronscan transaction: unexpected response");
+            const items = rows.map((tx) => mapTronScanTx(tx, address)).filter((x) => x !== null);
+            return { items, next: rows.length < pageSize ? null : String(start + rows.length) };
+        },
+    };
+    const trc20 = {
+        name: "trc20",
+        async fetchPage(cursor, pageSize, ctx) {
+            const start = offsetOf(cursor);
+            const url = `${baseUrl}/token_trc20/transfers?relatedAddress=${encodeURIComponent(address)}` +
+                `&limit=${pageSize}&start=${start}`;
+            const res = await httpJson(url, { method: "GET" }, { ...ctx.http, label: "history.tronscan.trc20" });
+            const rows = Array.isArray(res.token_transfers) ? res.token_transfers : null;
+            if (!rows)
+                throw new Error("tronscan token_trc20/transfers: unexpected response");
+            const items = rows.map((row) => mapTronScanTrc20(row, address)).filter((x) => x !== null);
+            return { items, next: rows.length < pageSize ? null : String(start + rows.length) };
+        },
+    };
+    return { label: "tronscan", sources: [native, trc20] };
+}
+//# sourceMappingURL=tronscan.js.map

package/dist/api/history/providers/tronscan.js.map

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

package/dist/api/history/providers/xrp.d.ts

@@ -0,0 +1,39 @@
+/**
+ * XRP Ledger `account_tx` (rippled JSON-RPC). Newest first with `forward:false`;
+ * the page cursor is the JSON `marker`. Payments in XRP report drops; issued
+ * currencies (IOUs) are decimal strings on the ledger, so for them `raw` and
+ * `formatted` are the same decimal value with `decimals: 0`. Memos are not
+ * surfaced (free-form text from strangers).
+ */
+import type { HistoryProvider, SourceItem } from "../types.js";
+type XrpAmount = string | {
+    currency?: string;
+    issuer?: string;
+    value?: string;
+};
+interface XrpTxJson {
+    TransactionType?: string;
+    Account?: string;
+    Destination?: string;
+    Amount?: XrpAmount;
+    DeliverMax?: XrpAmount;
+    Fee?: string;
+    date?: number;
+    hash?: string;
+    ledger_index?: number;
+}
+export interface XrpAccountTxEntry {
+    tx?: XrpTxJson;
+    tx_json?: XrpTxJson;
+    hash?: string;
+    ledger_index?: number;
+    close_time_iso?: string;
+    validated?: boolean;
+    meta?: {
+        TransactionResult?: string;
+        delivered_amount?: XrpAmount;
+    };
+}
+export declare function mapXrpEntry(entry: XrpAccountTxEntry, address: string): SourceItem | null;
+export declare function xrpProvider(rpcUrl: string, address: string): HistoryProvider;
+export {};

package/dist/api/history/providers/xrp.js

@@ -0,0 +1,150 @@
+/**
+ * XRP Ledger `account_tx` (rippled JSON-RPC). Newest first with `forward:false`;
+ * the page cursor is the JSON `marker`. Payments in XRP report drops; issued
+ * currencies (IOUs) are decimal strings on the ledger, so for them `raw` and
+ * `formatted` are the same decimal value with `decimals: 0`. Memos are not
+ * surfaced (free-form text from strangers).
+ */
+import { httpJson } from "../../http.js";
+import { amountOf, asString, feeOf, sanitizeSymbol, toBigInt, tokenAsset } from "../normalize.js";
+/** Seconds between the Unix epoch and the Ripple epoch (2000-01-01). */
+const RIPPLE_EPOCH_OFFSET = 946684800;
+/** 160-bit hex currency codes are ASCII padded with zeros. */
+function currencyCode(code) {
+    if (!code)
+        return "IOU";
+    if (/^[0-9A-F]{40}$/i.test(code)) {
+        const ascii = Buffer.from(code, "hex").toString("latin1").replace(/\0+$/, "");
+        return sanitizeSymbol(ascii, "IOU");
+    }
+    return sanitizeSymbol(code, "IOU");
+}
+export function mapXrpEntry(entry, address) {
+    const tx = entry.tx ?? entry.tx_json;
+    if (!tx)
+        return null;
+    const hash = asString(tx.hash) ?? asString(entry.hash);
+    if (!hash)
+        return null;
+    let ts = null;
+    let iso = null;
+    if (typeof tx.date === "number") {
+        ts = (tx.date + RIPPLE_EPOCH_OFFSET) * 1000;
+        iso = new Date(ts).toISOString();
+    }
+    else if (entry.close_time_iso) {
+        const parsed = Date.parse(entry.close_time_iso);
+        if (!Number.isNaN(parsed)) {
+            ts = parsed;
+            iso = new Date(parsed).toISOString();
+        }
+    }
+    const result = entry.meta?.TransactionResult;
+    const status = entry.validated === false ? "pending" : result && result !== "tesSUCCESS" ? "failed" : "confirmed";
+    const from = asString(tx.Account);
+    const to = asString(tx.Destination);
+    const fromSelf = from === address;
+    const toSelf = to === address;
+    const direction = fromSelf && toSelf ? "self" : fromSelf ? "out" : "in";
+    const fee = fromSelf ? feeOf(toBigInt(tx.Fee ?? 0), 6, "XRP") : null;
+    const ledger = tx.ledger_index ?? entry.ledger_index ?? null;
+    let item;
+    if (tx.TransactionType === "Payment") {
+        const delivered = entry.meta?.delivered_amount ?? tx.Amount ?? tx.DeliverMax;
+        if (typeof delivered === "string" || delivered === undefined) {
+            item = {
+                hash,
+                timestamp: iso,
+                block: ledger,
+                kind: "transfer",
+                direction,
+                status,
+                from,
+                to,
+                asset: { symbol: "XRP", contractAddress: null, decimals: 6 },
+                amount: amountOf(toBigInt(delivered ?? "0"), 6),
+                fee,
+            };
+        }
+        else {
+            const value = typeof delivered.value === "string" && /^-?\d+(\.\d+)?([eE][-+]?\d+)?$/.test(delivered.value)
+                ? delivered.value.replace(/^-/, "")
+                : "0";
+            item = {
+                hash,
+                timestamp: iso,
+                block: ledger,
+                kind: "token_transfer",
+                direction,
+                status,
+                from,
+                to,
+                asset: tokenAsset(currencyCode(delivered.currency), "IOU", asString(delivered.issuer), 0),
+                amount: { raw: value, formatted: value },
+                fee,
+            };
+        }
+    }
+    else {
+        item = {
+            hash,
+            timestamp: iso,
+            block: ledger,
+            kind: "other",
+            direction: fromSelf ? "out" : "in",
+            status,
+            from,
+            to: to ?? (fromSelf ? null : address),
+            asset: { symbol: "XRP", contractAddress: null, decimals: 6 },
+            amount: amountOf(0n, 6),
+            fee,
+        };
+    }
+    return { ts: ts ?? 0, item };
+}
+export function xrpProvider(rpcUrl, address) {
+    const source = {
+        name: "xrp",
+        async fetchPage(cursor, pageSize, ctx) {
+            let marker;
+            if (cursor !== null) {
+                try {
+                    marker = JSON.parse(cursor);
+                }
+                catch {
+                    throw new Error("Invalid cursor for xrp source.");
+                }
+            }
+            const res = await httpJson(rpcUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    method: "account_tx",
+                    params: [
+                        {
+                            account: address,
+                            limit: pageSize,
+                            ledger_index_min: -1,
+                            ledger_index_max: -1,
+                            forward: false,
+                            ...(marker !== undefined ? { marker } : {}),
+                        },
+                    ],
+                }),
+            }, { ...ctx.http, label: "history.xrp.account_tx", retry: true });
+            const result = res.result ?? {};
+            if (result.error === "actNotFound")
+                return { items: [], next: null };
+            if (result.status !== "success" || !Array.isArray(result.transactions)) {
+                throw new Error(`xrp account_tx: ${result.error_message ?? result.error ?? "unexpected response"}`);
+            }
+            const items = result.transactions
+                .map((entry) => mapXrpEntry(entry, address))
+                .filter((x) => x !== null);
+            const next = result.marker !== undefined && result.marker !== null ? JSON.stringify(result.marker) : null;
+            return { items, next };
+        },
+    };
+    return { label: "xrpl", sources: [source] };
+}
+//# sourceMappingURL=xrp.js.map

package/dist/api/history/providers/xrp.js.map

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

package/dist/api/history/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Transaction history: one normalized shape for every chain.
+ *
+ * Every provider (Blockscout, NodeReal, TronScan, Esplora, …) is exposed as one
+ * or more `HistorySource`s — newest-first paged streams of `SourceItem`s. The
+ * merge engine (merge.ts) interleaves the sources of a network by timestamp and
+ * keeps an opaque cursor so the agent can page further without duplicates.
+ *
+ * Strings copied from indexers (token symbols, addresses) are untrusted input;
+ * providers must pass them through normalize.ts before they reach the agent.
+ */
+import type { NetworkId } from "../../networks.js";
+export type HistoryDirection = "in" | "out" | "self";
+/**
+ * transfer        — native coin moved (ETH, BNB, TRX, BTC, …)
+ * token_transfer  — fungible token moved (ERC-20 / TRC-20 / SPL / jetton / IOU)
+ * contract_call   — the wallet called a contract; no recognised value transfer
+ * other           — anything else the indexer returned for this address
+ */
+export type HistoryKind = "transfer" | "token_transfer" | "contract_call" | "other";
+export type HistoryStatus = "confirmed" | "failed" | "pending";
+export interface HistoryAsset {
+    symbol: string;
+    /** Token contract / mint / jetton master. Null for the native coin. */
+    contractAddress: string | null;
+    decimals: number;
+    /**
+     * Set when the symbol looks like an unsolicited / spam token (contains a
+     * link, unusual characters, or mimics another ticker). Indexer data only —
+     * never a guarantee either way.
+     */
+    warning?: string;
+}
+export interface HistoryAmount {
+    /** Smallest unit as a decimal string (wei, sun, satoshi, lamports, …). */
+    raw: string;
+    /** Human readable, formatted with `asset.decimals`. */
+    formatted: string;
+}
+export interface HistoryFee extends HistoryAmount {
+    /** Native coin symbol the fee was paid in. */
+    symbol: string;
+}
+export interface HistoryItem {
+    /** Transaction hash / signature. */
+    hash: string;
+    /** ISO 8601 timestamp; null when the indexer did not return one (pending). */
+    timestamp: string | null;
+    /** Block height / slot / ledger index; null when pending or unknown. */
+    block: number | null;
+    kind: HistoryKind;
+    direction: HistoryDirection;
+    status: HistoryStatus;
+    from: string | null;
+    to: string | null;
+    asset: HistoryAsset;
+    amount: HistoryAmount;
+    /** Fee paid by this wallet; null when the counterparty paid it or it is unknown. */
+    fee: HistoryFee | null;
+}
+/** A normalized item plus the millisecond sort key the merge engine orders by. */
+export interface SourceItem {
+    /** Milliseconds since epoch. Pending items use Date.now() so they sort first. */
+    ts: number;
+    item: HistoryItem;
+}
+export interface SourcePage {
+    /** Newest first. */
+    items: SourceItem[];
+    /** Opaque cursor for the following page; null when this was the last page. */
+    next: string | null;
+}
+export interface SourceContext {
+    correlationId: string;
+    /**
+     * Base options for every indexer call: correlation id plus a tighter
+     * timeout / retry budget than the general HTTP defaults, so a dead primary
+     * hands over to the fallback provider quickly.
+     */
+    http: {
+        correlationId: string;
+        timeoutMs: number;
+        retries: number;
+    };
+}
+/** One newest-first paged stream for a wallet address. */
+export interface HistorySource {
+    /** Stable id used inside cursors, e.g. "native", "erc20". */
+    name: string;
+    fetchPage(pageCursor: string | null, pageSize: number, ctx: SourceContext): Promise<SourcePage>;
+}
+/** A provider bundles the sources of one indexer for one network/address. */
+export interface HistoryProvider {
+    /** Label reported to the agent, e.g. "blockscout", "tronscan", "trongrid". */
+    label: string;
+    sources: HistorySource[];
+}
+export type HistoryApiKind = "etherscan" | "nodereal" | "tronscan" | "trongrid" | "esplora" | "blockcypher" | "solana-rpc" | "toncenter" | "xrp-rpc";
+/** One entry of the per-network provider chain in the baked profile. */
+export interface HistoryApiSpec {
+    kind: HistoryApiKind;
+    /**
+     * API base URL. Omit to reuse the network's existing endpoint from the
+     * profile (tronApiUrl, bitcoinApiUrl, solanaRpcUrl, tonApiUrl, xrpRpcUrl, …).
+     */
+    url?: string;
+}
+export type HistoryApis = Partial<Record<NetworkId, HistoryApiSpec[]>>;
+/** Rows per page: the default is also the cap — one page is one screen of history. */
+export declare const HISTORY_MAX_LIMIT = 20;
+export declare const HISTORY_DEFAULT_LIMIT = 20;
+export declare const HISTORY_API_KINDS: readonly HistoryApiKind[];

package/dist/api/history/types.js

@@ -0,0 +1,26 @@
+/**
+ * Transaction history: one normalized shape for every chain.
+ *
+ * Every provider (Blockscout, NodeReal, TronScan, Esplora, …) is exposed as one
+ * or more `HistorySource`s — newest-first paged streams of `SourceItem`s. The
+ * merge engine (merge.ts) interleaves the sources of a network by timestamp and
+ * keeps an opaque cursor so the agent can page further without duplicates.
+ *
+ * Strings copied from indexers (token symbols, addresses) are untrusted input;
+ * providers must pass them through normalize.ts before they reach the agent.
+ */
+/** Rows per page: the default is also the cap — one page is one screen of history. */
+export const HISTORY_MAX_LIMIT = 20;
+export const HISTORY_DEFAULT_LIMIT = 20;
+export const HISTORY_API_KINDS = [
+    "etherscan",
+    "nodereal",
+    "tronscan",
+    "trongrid",
+    "esplora",
+    "blockcypher",
+    "solana-rpc",
+    "toncenter",
+    "xrp-rpc",
+];
+//# sourceMappingURL=types.js.map

package/dist/api/history/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/history/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwHH,sFAAsF;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,MAAM,CAAC,MAAM,iBAAiB,GAA8B;IAC1D,WAAW;IACX,UAAU;IACV,UAAU;IACV,UAAU;IACV,SAAS;IACT,aAAa;IACb,YAAY;IACZ,WAAW;IACX,SAAS;CACV,CAAC"}

package/dist/api/swap.d.ts

@@ -75,6 +75,8 @@ export declare function estimateSwap(token: string, params: {
     to: SwapSide;
     maxMode?: boolean;
 }, opts?: SwapCallOpts): Promise<SwapEstimateResult>;
+export declare function slimSwapDetails(details: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+export declare function slimSwapPayload(json: Record<string, unknown>): Record<string, unknown>;
 export interface SwapTxToSign {
     txId?: string;
     txData?: string;

package/dist/api/swap.js

@@ -255,8 +255,19 @@ function mapEstimate(json) {
         raw: json,
     };
 }
-/** Agent-facing swap fees: network / tokenFee / coinFee only. */
-const SWAP_FEE_KEYS = ["network", "tokenFee", "coinFee"];
+/** Agent-facing swap fees: tokenFee / coinFee only (no network fee). */
+const SWAP_FEE_KEYS = ["tokenFee", "coinFee"];
+/** Provider extras that confuse agents and are not needed to execute a swap. */
+const SWAP_DROP_KEYS = ["slippage", "slippagePercent", "slippageBps", "networkFee"];
+function omitDroppedKeys(src) {
+    const out = {};
+    for (const [k, v] of Object.entries(src)) {
+        if (SWAP_DROP_KEYS.includes(k))
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
 function pickSwapFees(fees) {
     if (!fees || typeof fees !== "object" || Array.isArray(fees))
         return undefined;
@@ -268,17 +279,16 @@ function pickSwapFees(fees) {
     }
     return Object.keys(out).length > 0 ? out : undefined;
 }
-function slimSwapDetails(details) {
+export function slimSwapDetails(details) {
     if (!details)
         return undefined;
-    if (!("fees" in details))
-        return details;
-    const { fees, ...rest } = details;
+    const { fees, ...rest } = omitDroppedKeys(details);
     const slim = pickSwapFees(fees);
-    return slim ? { ...rest, fees: slim } : rest;
+    const next = slim ? { ...rest, fees: slim } : rest;
+    return Object.keys(next).length > 0 ? next : undefined;
 }
-function slimSwapPayload(json) {
-    const next = { ...json };
+export function slimSwapPayload(json) {
+    const next = omitDroppedKeys(json);
     if ("fees" in next) {
         const slim = pickSwapFees(next.fees);
         if (slim)
@@ -287,7 +297,11 @@ function slimSwapPayload(json) {
             delete next.fees;
     }
     if (next.details && typeof next.details === "object" && !Array.isArray(next.details)) {
-        next.details = slimSwapDetails(next.details);
+        const slim = slimSwapDetails(next.details);
+        if (slim)
+            next.details = slim;
+        else
+            delete next.details;
     }
     return next;
 }