@ironwallet/mcp-server 1.1.0 → 1.2.1

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/ton-shared.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Address and opcode helpers shared by the TON history providers (TonCenter,
+ * TonAPI). Both indexers emit raw `0:HEX` addresses; the agent gets the
+ * user-friendly non-bounceable form.
+ */
+export type TonAddressBook = Record<string, {
+    user_friendly?: string;
+}>;
+/** Raw or friendly TON address → user-friendly form; `book` wins when it has the entry. */
+export declare function tonAddr(raw: string | null | undefined, book?: TonAddressBook): string | null;
+export declare function tonEquals(a: string | null | undefined, b: string): boolean;
+/** Plain transfer: no opcode, or opcode 0 (text comment). */
+export declare function isPlainOpcode(opcode: string | null | undefined): boolean;
+export declare const TON_NATIVE_ASSET: {
+    readonly symbol: "TON";
+    readonly contractAddress: null;
+    readonly decimals: 9;
+};

package/dist/api/history/providers/ton-shared.js

@@ -0,0 +1,38 @@
+/**
+ * Address and opcode helpers shared by the TON history providers (TonCenter,
+ * TonAPI). Both indexers emit raw `0:HEX` addresses; the agent gets the
+ * user-friendly non-bounceable form.
+ */
+import { Address } from "@ton/ton";
+/** Raw or friendly TON address → user-friendly form; `book` wins when it has the entry. */
+export 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;
+    }
+}
+export 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). */
+export function isPlainOpcode(opcode) {
+    if (!opcode)
+        return true;
+    return /^0x0*$/i.test(opcode);
+}
+export const TON_NATIVE_ASSET = { symbol: "TON", contractAddress: null, decimals: 9 };
+//# sourceMappingURL=ton-shared.js.map

package/dist/api/history/providers/ton-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ton-shared.js","sourceRoot":"","sources":["../../../../src/api/history/providers/ton-shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAInC,2FAA2F;AAC3F,MAAM,UAAU,OAAO,CACrB,GAA8B,EAC9B,IAAqB;IAErB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,QAAQ,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,aAAa,CAAC;IACxF,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAA4B,EAAE,CAAS;IAC/D,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,MAAiC;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAW,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * TonAPI v2 (tonapi.io) — fallback indexer for TON when TonCenter is rate
+ * limited or down. `/blockchain/accounts/{a}/transactions` for native moves
+ * and `/accounts/{a}/jettons/history` for jetton moves; both page by
+ * `before_lt` (exclusive), so the cursor is the last logical time seen.
+ *
+ * Keyless access is about one request per second per IP; `IW_TONAPI_KEY`
+ * (Bearer) lifts that. Amounts come as JSON numbers: exact below 2^53
+ * nanotons (~9 million TON), which covers a hot wallet.
+ */
+import type { HistoryProvider, SourceItem } from "../types.js";
+interface TonapiAccount {
+    address?: string;
+}
+interface TonapiMsg {
+    value?: number | string;
+    source?: TonapiAccount | null;
+    destination?: TonapiAccount | null;
+    op_code?: string | null;
+}
+export interface TonapiTx {
+    hash?: string;
+    lt?: number | string;
+    utime?: number;
+    success?: boolean;
+    aborted?: boolean;
+    total_fees?: number | string;
+    /** "(workchain,shard,seqno)" */
+    block?: string;
+    in_msg?: TonapiMsg | null;
+    out_msgs?: TonapiMsg[];
+}
+export interface TonapiJettonOp {
+    operation?: string;
+    utime?: number;
+    lt?: number | string;
+    transaction_hash?: string;
+    source?: TonapiAccount | null;
+    destination?: TonapiAccount | null;
+    amount?: string | number;
+    jetton?: {
+        address?: string;
+        symbol?: string;
+        decimals?: unknown;
+    };
+}
+/** "(0,8000000000000000,94053862)" → 94053862 */
+export declare function tonapiBlockSeqno(block: string | undefined): number | null;
+export declare function mapTonapiTx(tx: TonapiTx, address: string): SourceItem | null;
+export declare function mapTonapiJettonOp(row: TonapiJettonOp, address: string): SourceItem | null;
+export declare function tonapiProvider(base: string, address: string): HistoryProvider;
+export {};

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

@@ -0,0 +1,183 @@
+/**
+ * TonAPI v2 (tonapi.io) — fallback indexer for TON when TonCenter is rate
+ * limited or down. `/blockchain/accounts/{a}/transactions` for native moves
+ * and `/accounts/{a}/jettons/history` for jetton moves; both page by
+ * `before_lt` (exclusive), so the cursor is the last logical time seen.
+ *
+ * Keyless access is about one request per second per IP; `IW_TONAPI_KEY`
+ * (Bearer) lifts that. Amounts come as JSON numbers: exact below 2^53
+ * nanotons (~9 million TON), which covers a hot wallet.
+ */
+import { httpJson } from "../../http.js";
+import { logInfo } from "../../../log.js";
+import { paced as pacedGate, retryRateLimited } from "../pace.js";
+import { amountOf, asString, clampDecimals, feeOf, sanitizeSymbol, timeFrom, toBigInt, tokenAsset, } from "../normalize.js";
+import { TON_NATIVE_ASSET, isPlainOpcode, tonAddr, tonEquals } from "./ton-shared.js";
+/** "(0,8000000000000000,94053862)" → 94053862 */
+export function tonapiBlockSeqno(block) {
+    if (!block)
+        return null;
+    const m = /,(\d+)\)$/.exec(block);
+    return m ? Number.parseInt(m[1], 10) : null;
+}
+export function mapTonapiTx(tx, address) {
+    const hash = asString(tx.hash);
+    if (!hash)
+        return null;
+    const time = timeFrom(tx.utime);
+    const status = tx.aborted === true || tx.success === false ? "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 = tonapiBlockSeqno(tx.block);
+    const asset = { ...TON_NATIVE_ASSET };
+    const self = tonAddr(address) ?? address;
+    let item;
+    if (outValue > 0n) {
+        const first = outMsgs.find((m) => toBigInt(m.value ?? 0) > 0n) ?? outMsgs[0];
+        const dest = first?.destination?.address;
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block,
+            kind: isPlainOpcode(first?.op_code) ? "transfer" : "contract_call",
+            direction: tonEquals(dest, address) ? "self" : "out",
+            status,
+            from: self,
+            to: tonAddr(dest),
+            asset,
+            amount: amountOf(outValue, 9),
+            fee: feeOf(fees, 9, "TON"),
+        };
+    }
+    else if (inValue > 0n && inMsg?.source?.address) {
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block,
+            kind: isPlainOpcode(inMsg.op_code) ? "transfer" : "other",
+            direction: tonEquals(inMsg.source.address, address) ? "self" : "in",
+            status,
+            from: tonAddr(inMsg.source.address),
+            to: self,
+            asset,
+            amount: amountOf(inValue, 9),
+            fee: null,
+        };
+    }
+    else {
+        const src = inMsg?.source?.address;
+        item = {
+            hash,
+            timestamp: time?.iso ?? null,
+            block,
+            kind: "other",
+            direction: src ? "in" : "out",
+            status,
+            from: tonAddr(src),
+            to: self,
+            asset,
+            amount: amountOf(0n, 9),
+            fee: src ? null : feeOf(fees, 9, "TON"),
+        };
+    }
+    return { ts: time?.ts ?? 0, item };
+}
+export function mapTonapiJettonOp(row, address) {
+    const hash = asString(row.transaction_hash);
+    const master = asString(row.jetton?.address);
+    if (!hash || !master)
+        return null;
+    const time = timeFrom(row.utime);
+    const src = row.source?.address;
+    const dst = row.destination?.address;
+    const fromSelf = tonEquals(src, address);
+    const toSelf = tonEquals(dst, address);
+    const symbol = sanitizeSymbol(row.jetton?.symbol, "JETTON");
+    const decimals = clampDecimals(row.jetton?.decimals, 9);
+    const item = {
+        hash,
+        timestamp: time?.iso ?? null,
+        block: null,
+        kind: "token_transfer",
+        direction: fromSelf && toSelf ? "self" : fromSelf ? "out" : "in",
+        status: "confirmed",
+        from: tonAddr(src),
+        to: tonAddr(dst),
+        asset: tokenAsset(symbol, "JETTON", tonAddr(master) ?? master, decimals),
+        amount: amountOf(toBigInt(row.amount), decimals),
+        fee: null,
+    };
+    return { ts: time?.ts ?? 0, item };
+}
+/** Cursor is the `lt` of the last row; tonapi's `before_lt` is exclusive. */
+function beforeLt(cursor) {
+    if (cursor === null)
+        return "";
+    if (!/^\d+$/.test(cursor))
+        throw new Error("Invalid cursor for tonapi source.");
+    return `&before_lt=${cursor}`;
+}
+function nextFrom(rows, pageSize) {
+    if (rows.length < pageSize)
+        return null;
+    const last = rows[rows.length - 1]?.lt;
+    return last === undefined ? null : String(last);
+}
+function apiKey() {
+    const key = process.env.IW_TONAPI_KEY?.trim();
+    return key && key.length > 0 ? key : undefined;
+}
+function headers() {
+    const key = apiKey();
+    return key ? { Authorization: `Bearer ${key}` } : undefined;
+}
+const KEYLESS_GAP_MS = 1100;
+const RATE_LIMIT_WAIT_MS = 2500;
+const RATE_LIMIT_ATTEMPTS = 2;
+function paced(fn, ctx) {
+    const call = () => (apiKey() ? fn() : pacedGate("tonapi", KEYLESS_GAP_MS, fn));
+    return retryRateLimited(call, {
+        waitMs: RATE_LIMIT_WAIT_MS,
+        attempts: RATE_LIMIT_ATTEMPTS,
+        onRetry: (attempt) => logInfo("history.tonapi.rate_limited", {
+            correlationId: ctx.correlationId,
+            attempt,
+            waitMs: RATE_LIMIT_WAIT_MS,
+        }),
+    });
+}
+export function tonapiProvider(base, address) {
+    const acct = encodeURIComponent(address);
+    const native = {
+        name: "native",
+        async fetchPage(cursor, pageSize, ctx) {
+            const url = `${base}/blockchain/accounts/${acct}/transactions?limit=${pageSize}&sort_order=desc` +
+                beforeLt(cursor);
+            const res = await paced(() => httpJson(url, { method: "GET", headers: headers() }, { ...ctx.http, label: "history.tonapi.transactions" }), ctx);
+            const rows = Array.isArray(res?.transactions) ? res.transactions : null;
+            if (!rows)
+                throw new Error("tonapi transactions: unexpected response");
+            const items = rows.map((tx) => mapTonapiTx(tx, address)).filter((x) => x !== null);
+            return { items, next: nextFrom(rows, pageSize) };
+        },
+    };
+    const jettons = {
+        name: "jetton",
+        async fetchPage(cursor, pageSize, ctx) {
+            const url = `${base}/accounts/${acct}/jettons/history?limit=${pageSize}` + beforeLt(cursor);
+            const res = await paced(() => httpJson(url, { method: "GET", headers: headers() }, { ...ctx.http, label: "history.tonapi.jettons" }), ctx);
+            const rows = Array.isArray(res?.operations) ? res.operations : null;
+            if (!rows)
+                throw new Error("tonapi jettons/history: unexpected response");
+            const items = rows
+                .map((row) => mapTonapiJettonOp(row, address))
+                .filter((x) => x !== null);
+            return { items, next: nextFrom(rows, pageSize) };
+        },
+    };
+    return { label: "tonapi", sources: [native, jettons] };
+}
+//# sourceMappingURL=tonapi.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * 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";
+import { type TonAddressBook } from "./ton-shared.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 = TonAddressBook;
+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,191 @@
+/**
+ * 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 { httpJson } from "../../http.js";
+import { logInfo } from "../../../log.js";
+import { paced as pacedGate, retryRateLimited } from "../pace.js";
+import { amountOf, asString, clampDecimals, feeOf, sanitizeSymbol, timeFrom, toBigInt, tokenAsset, } from "../normalize.js";
+import { TON_NATIVE_ASSET, isPlainOpcode, tonAddr, tonEquals } from "./ton-shared.js";
+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 = { ...TON_NATIVE_ASSET };
+    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.
+ *
+ * Measured: a third request within a second gets 429 and the IP stays
+ * suspended for ~2 s, without Retry-After. Traffic from another MCP process
+ * or another machine behind the same NAT eats the same budget, so on 429 we
+ * wait past the suspension and try again instead of failing the provider.
+ */
+const KEYLESS_GAP_MS = 1100;
+const RATE_LIMIT_WAIT_MS = 2500;
+const RATE_LIMIT_ATTEMPTS = 2;
+function paced(fn, ctx) {
+    const call = () => (apiKey() ? fn() : pacedGate("toncenter", KEYLESS_GAP_MS, fn));
+    return retryRateLimited(call, {
+        waitMs: RATE_LIMIT_WAIT_MS,
+        attempts: RATE_LIMIT_ATTEMPTS,
+        onRetry: (attempt) => logInfo("history.toncenter.rate_limited", {
+            correlationId: ctx.correlationId,
+            attempt,
+            waitMs: RATE_LIMIT_WAIT_MS,
+        }),
+    });
+}
+/** `…/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" }), ctx);
+            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" }), ctx);
+            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;