@ironwallet/mcp-server 1.1.0 → 1.2.0

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

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

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

@@ -0,0 +1,56 @@
+/**
+ * TonCenter v3 indexer: `/transactions` (account transactions, newest first)
+ * and `/jetton/transfers` (owner-scoped jetton moves). Offset-based. Raw
+ * `0:HEX` addresses are turned into user-friendly form via `address_book`
+ * or @ton/ton when missing.
+ */
+import type { HistoryProvider, SourceItem } from "../types.js";
+interface TonMsg {
+    source?: string | null;
+    destination?: string | null;
+    value?: string | null;
+    opcode?: string | null;
+}
+export interface TonTx {
+    hash?: string;
+    lt?: string;
+    now?: number;
+    mc_block_seqno?: number;
+    total_fees?: string;
+    description?: {
+        aborted?: boolean;
+        compute_ph?: {
+            success?: boolean;
+            exit_code?: number;
+        };
+    };
+    in_msg?: TonMsg | null;
+    out_msgs?: TonMsg[];
+}
+export interface TonJettonTransfer {
+    transaction_hash?: string;
+    transaction_now?: number;
+    transaction_aborted?: boolean;
+    source?: string | null;
+    destination?: string | null;
+    amount?: string;
+    jetton_master?: string;
+}
+type AddressBook = Record<string, {
+    user_friendly?: string;
+}>;
+type JettonMetadata = Record<string, {
+    token_info?: Array<{
+        type?: string;
+        symbol?: string;
+        extra?: {
+            decimals?: unknown;
+        };
+    }>;
+}>;
+export declare function mapTonTx(tx: TonTx, address: string, book: AddressBook | undefined): SourceItem | null;
+export declare function mapTonJettonTransfer(row: TonJettonTransfer, address: string, book: AddressBook | undefined, metadata: JettonMetadata | undefined): SourceItem | null;
+/** `…/api/v2` → `…/api/v3`; a v3 URL is used as is. */
+export declare function toncenterV3(base: string): string | null;
+export declare function toncenterProvider(v3Base: string, address: string): HistoryProvider;
+export {};

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

@@ -0,0 +1,203 @@
+/**
+ * TonCenter v3 indexer: `/transactions` (account transactions, newest first)
+ * and `/jetton/transfers` (owner-scoped jetton moves). Offset-based. Raw
+ * `0:HEX` addresses are turned into user-friendly form via `address_book`
+ * or @ton/ton when missing.
+ */
+import { Address } from "@ton/ton";
+import { httpJson } from "../../http.js";
+import { paced as pacedGate } from "../pace.js";
+import { amountOf, asString, clampDecimals, feeOf, sanitizeSymbol, timeFrom, toBigInt, tokenAsset, } from "../normalize.js";
+function tonAddr(raw, book) {
+    if (!raw)
+        return null;
+    const friendly = book?.[raw]?.user_friendly ?? book?.[raw.toUpperCase()]?.user_friendly;
+    if (friendly)
+        return friendly;
+    try {
+        return Address.parse(raw).toString({ bounceable: false });
+    }
+    catch {
+        return raw;
+    }
+}
+function tonEquals(a, b) {
+    if (!a)
+        return false;
+    try {
+        return Address.parse(a).equals(Address.parse(b));
+    }
+    catch {
+        return false;
+    }
+}
+/** Plain transfer: no opcode, or opcode 0 (text comment). */
+function isPlainOpcode(opcode) {
+    if (!opcode)
+        return true;
+    return /^0x0*$/i.test(opcode);
+}
+export function mapTonTx(tx, address, book) {
+    const hash = asString(tx.hash);
+    if (!hash)
+        return null;
+    const time = timeFrom(tx.now);
+    const aborted = tx.description?.aborted === true || tx.description?.compute_ph?.success === false;
+    const status = aborted ? "failed" : "confirmed";
+    const fees = toBigInt(tx.total_fees ?? 0);
+    const inMsg = tx.in_msg ?? null;
+    const inValue = toBigInt(inMsg?.value ?? 0);
+    const outMsgs = tx.out_msgs ?? [];
+    const outValue = outMsgs.reduce((s, m) => s + toBigInt(m.value ?? 0), 0n);
+    const block = typeof tx.mc_block_seqno === "number" ? tx.mc_block_seqno : null;
+    const asset = { symbol: "TON", contractAddress: null, decimals: 9 };
+    let item;
+    if (outValue > 0n) {
+        const first = outMsgs.find((m) => toBigInt(m.value ?? 0) > 0n) ?? outMsgs[0];
+        const to = tonAddr(first?.destination, book);
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block,
+            kind: isPlainOpcode(first?.opcode) ? "transfer" : "contract_call",
+            direction: tonEquals(first?.destination, address) ? "self" : "out",
+            status,
+            from: tonAddr(address, book) ?? address,
+            to,
+            asset,
+            amount: amountOf(outValue, 9),
+            fee: feeOf(fees, 9, "TON"),
+        };
+    }
+    else if (inValue > 0n && inMsg?.source) {
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block,
+            kind: isPlainOpcode(inMsg.opcode) ? "transfer" : "other",
+            direction: tonEquals(inMsg.source, address) ? "self" : "in",
+            status,
+            from: tonAddr(inMsg.source, book),
+            to: tonAddr(address, book) ?? address,
+            asset,
+            amount: amountOf(inValue, 9),
+            fee: null,
+        };
+    }
+    else {
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block,
+            kind: "other",
+            direction: inMsg?.source ? "in" : "out",
+            status,
+            from: tonAddr(inMsg?.source, book),
+            to: tonAddr(address, book) ?? address,
+            asset,
+            amount: amountOf(0n, 9),
+            fee: inMsg?.source ? null : feeOf(fees, 9, "TON"),
+        };
+    }
+    return { ts: time?.ts ?? 0, item };
+}
+function jettonMeta(master, metadata) {
+    const entry = master ? metadata?.[master] ?? metadata?.[master.toUpperCase()] : undefined;
+    const info = entry?.token_info?.find((t) => t.type === "jetton_masters") ?? entry?.token_info?.[0];
+    return {
+        symbol: sanitizeSymbol(info?.symbol, "JETTON"),
+        decimals: clampDecimals(info?.extra?.decimals, 9),
+    };
+}
+export function mapTonJettonTransfer(row, address, book, metadata) {
+    const hash = asString(row.transaction_hash);
+    const master = asString(row.jetton_master);
+    if (!hash || !master)
+        return null;
+    const time = timeFrom(row.transaction_now);
+    const meta = jettonMeta(master, metadata);
+    const fromSelf = tonEquals(row.source, address);
+    const toSelf = tonEquals(row.destination, address);
+    const item = {
+        hash,
+        timestamp: time?.iso ?? null,
+        block: null,
+        kind: "token_transfer",
+        direction: fromSelf && toSelf ? "self" : fromSelf ? "out" : "in",
+        status: row.transaction_aborted ? "failed" : "confirmed",
+        from: tonAddr(row.source, book),
+        to: tonAddr(row.destination, book),
+        asset: tokenAsset(meta.symbol, "JETTON", tonAddr(master, book) ?? master, meta.decimals),
+        amount: amountOf(toBigInt(row.amount), meta.decimals),
+        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 toncenter source.");
+    return n;
+}
+function apiKey() {
+    const key = process.env.IW_TON_API_KEY?.trim();
+    return key && key.length > 0 ? key : undefined;
+}
+function headers() {
+    const key = apiKey();
+    return key ? { "X-Api-Key": key } : undefined;
+}
+/**
+ * Keyless TonCenter allows about one request per second per IP and answers
+ * bursts with 429. The two sources of this provider (and their second pages)
+ * are spaced out through one process-wide gate; with an API key the gate is off.
+ */
+const KEYLESS_GAP_MS = 1100;
+function paced(fn) {
+    return apiKey() ? fn() : pacedGate("toncenter", KEYLESS_GAP_MS, fn);
+}
+/** `…/api/v2` → `…/api/v3`; a v3 URL is used as is. */
+export function toncenterV3(base) {
+    const b = base.replace(/\/$/, "");
+    if (b.endsWith("/api/v3"))
+        return b;
+    if (b.endsWith("/api/v2"))
+        return `${b.slice(0, -1)}3`;
+    return null;
+}
+export function toncenterProvider(v3Base, address) {
+    const native = {
+        name: "native",
+        async fetchPage(cursor, pageSize, ctx) {
+            const offset = offsetOf(cursor);
+            const url = `${v3Base}/transactions?account=${encodeURIComponent(address)}` +
+                `&limit=${pageSize}&offset=${offset}&sort=desc`;
+            const res = await paced(() => httpJson(url, { method: "GET", headers: headers() }, { ...ctx.http, label: "history.toncenter.transactions" }));
+            const rows = Array.isArray(res.transactions) ? res.transactions : null;
+            if (!rows)
+                throw new Error("toncenter transactions: unexpected response");
+            const items = rows.map((tx) => mapTonTx(tx, address, res.address_book)).filter((x) => x !== null);
+            return { items, next: rows.length < pageSize ? null : String(offset + rows.length) };
+        },
+    };
+    const jettons = {
+        name: "jetton",
+        async fetchPage(cursor, pageSize, ctx) {
+            const offset = offsetOf(cursor);
+            const url = `${v3Base}/jetton/transfers?owner_address=${encodeURIComponent(address)}` +
+                `&limit=${pageSize}&offset=${offset}&sort=desc`;
+            const res = await paced(() => httpJson(url, { method: "GET", headers: headers() }, { ...ctx.http, label: "history.toncenter.jettons" }));
+            const rows = Array.isArray(res.jetton_transfers) ? res.jetton_transfers : null;
+            if (!rows)
+                throw new Error("toncenter jetton/transfers: unexpected response");
+            const items = rows
+                .map((row) => mapTonJettonTransfer(row, address, res.address_book, res.metadata))
+                .filter((x) => x !== null);
+            return { items, next: rows.length < pageSize ? null : String(offset + rows.length) };
+        },
+    };
+    return { label: "toncenter", sources: [native, jettons] };
+}
+//# sourceMappingURL=toncenter.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * TronGrid `/v1/accounts/{address}/transactions` (+ `/trc20`). Independent
+ * fallback for Tron. Cursor-based via `meta.fingerprint`; addresses in the
+ * raw transaction are hex (41…) and are re-encoded to base58 here.
+ */
+import { type HistoryProvider, type SourceItem } from "../types.js";
+export interface TronGridTx {
+    txID?: string;
+    blockNumber?: number;
+    block_timestamp?: number;
+    ret?: Array<{
+        contractRet?: string;
+        fee?: number;
+    }>;
+    raw_data?: {
+        contract?: Array<{
+            type?: string;
+            parameter?: {
+                value?: {
+                    amount?: number | string;
+                    owner_address?: string;
+                    to_address?: string;
+                    contract_address?: string;
+                    asset_name?: string;
+                    call_value?: number;
+                };
+            };
+        }>;
+    };
+}
+export interface TronGridTrc20 {
+    transaction_id?: string;
+    block_timestamp?: number;
+    from?: string;
+    to?: string;
+    type?: string;
+    value?: string;
+    token_info?: {
+        symbol?: string;
+        address?: string;
+        decimals?: number;
+    };
+}
+/** 41-prefixed hex → base58check "T…" address. Returns the input when it is not hex. */
+export declare function tronHexToBase58(value: string | undefined | null): string | null;
+export declare function mapTronGridTx(tx: TronGridTx, address: string): SourceItem | null;
+export declare function mapTronGridTrc20(row: TronGridTrc20, address: string): SourceItem | null;
+export declare function trongridProvider(baseUrl: string, address: string): HistoryProvider;

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

@@ -0,0 +1,144 @@
+/**
+ * TronGrid `/v1/accounts/{address}/transactions` (+ `/trc20`). Independent
+ * fallback for Tron. Cursor-based via `meta.fingerprint`; addresses in the
+ * raw transaction are hex (41…) and are re-encoded to base58 here.
+ */
+import bs58check from "bs58check";
+import { httpJson } from "../../http.js";
+import { paced } from "../pace.js";
+import { amountOf, asString, clampDecimals, directionOf, exactAddressMatcher, feeOf, timeFrom, tokenAsset, toBigInt, toBlockNumber, } from "../normalize.js";
+import { HISTORY_MAX_LIMIT, } from "../types.js";
+/** 41-prefixed hex → base58check "T…" address. Returns the input when it is not hex. */
+export function tronHexToBase58(value) {
+    if (!value)
+        return null;
+    if (!/^(0x)?41[0-9a-fA-F]{40}$/.test(value))
+        return value;
+    try {
+        return bs58check.encode(Buffer.from(value.replace(/^0x/, ""), "hex"));
+    }
+    catch {
+        return value;
+    }
+}
+export function mapTronGridTx(tx, address) {
+    const hash = asString(tx.txID);
+    if (!hash)
+        return null;
+    const time = timeFrom(tx.block_timestamp);
+    const isSelf = exactAddressMatcher(address);
+    const contract = tx.raw_data?.contract?.[0];
+    const value = contract?.parameter?.value ?? {};
+    const type = contract?.type ?? "";
+    const from = tronHexToBase58(value.owner_address);
+    const to = tronHexToBase58(value.to_address) ?? tronHexToBase58(value.contract_address);
+    const direction = directionOf(from, to, isSelf);
+    const ret = tx.ret?.[0];
+    const status = ret?.contractRet && ret.contractRet !== "SUCCESS" ? "failed" : "confirmed";
+    const fee = direction === "in" ? null : feeOf(toBigInt(ret?.fee ?? 0), 6, "TRX");
+    const base = {
+        hash,
+        timestamp: time?.iso ?? null,
+        block: toBlockNumber(tx.blockNumber),
+        direction,
+        status,
+        from,
+        to,
+        fee,
+    };
+    let item;
+    if (type === "TransferContract") {
+        item = {
+            ...base,
+            kind: "transfer",
+            asset: { symbol: "TRX", contractAddress: null, decimals: 6 },
+            amount: amountOf(toBigInt(value.amount), 6),
+        };
+    }
+    else if (type === "TransferAssetContract") {
+        // TRC-10: TronGrid gives the asset id as hex ASCII; decimals are not in the
+        // payload, so amounts are reported in base units (decimals 0).
+        const assetId = value.asset_name ? Buffer.from(value.asset_name, "hex").toString("utf8") : null;
+        item = {
+            ...base,
+            kind: "token_transfer",
+            asset: tokenAsset(assetId, "TRC10", assetId, 0),
+            amount: amountOf(toBigInt(value.amount), 0),
+        };
+    }
+    else {
+        item = {
+            ...base,
+            kind: type === "TriggerSmartContract" ? "contract_call" : "other",
+            asset: { symbol: "TRX", contractAddress: null, decimals: 6 },
+            amount: amountOf(toBigInt(value.call_value ?? 0), 6),
+        };
+    }
+    return { ts: time?.ts ?? 0, item };
+}
+export function mapTronGridTrc20(row, address) {
+    const hash = asString(row.transaction_id);
+    const contract = asString(row.token_info?.address);
+    if (!hash || !contract)
+        return null;
+    if (row.type && row.type !== "Transfer")
+        return null; // Approval events etc.
+    const time = timeFrom(row.block_timestamp);
+    const decimals = clampDecimals(row.token_info?.decimals, 6);
+    const from = asString(row.from);
+    const to = asString(row.to);
+    const item = {
+        hash,
+        timestamp: time?.iso ?? null,
+        block: null,
+        kind: "token_transfer",
+        direction: directionOf(from, to, exactAddressMatcher(address)),
+        status: "confirmed",
+        from,
+        to,
+        asset: tokenAsset(row.token_info?.symbol, "TRC20", contract, decimals),
+        amount: amountOf(toBigInt(row.value), decimals),
+        fee: null,
+    };
+    return { ts: time?.ts ?? 0, item };
+}
+/**
+ * Keyless TronGrid advertises 3 requests per second per IP, but after a few
+ * violations it drops the IP to 1 rps and suspends it for ~5 s on each
+ * further burst. Two sources × two pages in parallel trip that on every call,
+ * so requests are spaced ≥1.1 s apart process-wide. Slower, but this is the
+ * fallback: it has to answer, not to be fast.
+ */
+const KEYLESS_GAP_MS = 1100;
+/**
+ * A TronGrid fingerprint is bound to the exact query, `limit` included, so
+ * the page size must not follow the caller's `limit`: fixed at the tool cap.
+ */
+const PAGE_SIZE = HISTORY_MAX_LIMIT;
+function makeSource(name, path, baseUrl, address, map) {
+    return {
+        name,
+        async fetchPage(cursor, _pageSize, ctx) {
+            const url = `${baseUrl}/v1/accounts/${encodeURIComponent(address)}/transactions${path}` +
+                `?limit=${PAGE_SIZE}&order_by=block_timestamp,desc&only_confirmed=true` +
+                (cursor ? `&fingerprint=${encodeURIComponent(cursor)}` : "");
+            const res = await paced("trongrid", KEYLESS_GAP_MS, () => httpJson(url, { method: "GET" }, { ...ctx.http, label: `history.trongrid${path || ".tx"}` }));
+            if (res.success === false || !Array.isArray(res.data)) {
+                throw new Error(`trongrid${path}: ${res.error ?? "unexpected response"}`);
+            }
+            const items = res.data.map((row) => map(row, address)).filter((x) => x !== null);
+            const next = res.data.length < PAGE_SIZE ? null : (res.meta?.fingerprint ?? null);
+            return { items, next };
+        },
+    };
+}
+export function trongridProvider(baseUrl, address) {
+    return {
+        label: "trongrid",
+        sources: [
+            makeSource("native", "", baseUrl, address, mapTronGridTx),
+            makeSource("trc20", "/trc20", baseUrl, address, mapTronGridTrc20),
+        ],
+    };
+}
+//# sourceMappingURL=trongrid.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * 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 type { HistoryProvider, SourceItem } from "../types.js";
+export interface TronScanTx {
+    hash?: string;
+    block?: number;
+    timestamp?: number;
+    ownerAddress?: string;
+    toAddress?: string;
+    contractType?: number;
+    confirmed?: boolean;
+    revert?: boolean;
+    contractRet?: string;
+    amount?: string | number;
+    cost?: {
+        fee?: number;
+        net_fee?: number;
+        energy_fee?: number;
+    };
+    tokenInfo?: {
+        tokenId?: string;
+        tokenAbbr?: string;
+        tokenDecimal?: number;
+        tokenType?: string;
+    };
+    trigger_info?: {
+        contract_address?: string;
+    };
+}
+export interface TronScanTrc20Transfer {
+    transaction_id?: string;
+    block?: number;
+    block_ts?: number;
+    from_address?: string;
+    to_address?: string;
+    contract_address?: string;
+    quant?: string;
+    confirmed?: boolean;
+    contractRet?: string;
+    finalResult?: string;
+    revert?: boolean;
+    tokenInfo?: {
+        tokenId?: string;
+        tokenAbbr?: string;
+        tokenDecimal?: number;
+    };
+}
+export declare function mapTronScanTx(tx: TronScanTx, address: string): SourceItem | null;
+export declare function mapTronScanTrc20(row: TronScanTrc20Transfer, address: string): SourceItem | null;
+export declare function tronscanProvider(baseUrl: string, address: string): HistoryProvider;