@anywalletkit/wallet-tron 0.0.0-stage → 0.2.1

package/dist/history.d.ts

@@ -0,0 +1,160 @@
+import { ChainTx, HistoryPage, HistorySource, HistoryQuery } from '@anywalletkit/core';
+
+/**
+ * Activity history for Tron: a `HistorySource` over TronGrid's account
+ * endpoints (`/v1/accounts/{a}/transactions` and `/transactions/trc20`),
+ * merged into one `ChainTx` per txID, with the full-node
+ * `/wallet/gettransactionbyid` + `/wallet/gettransactioninfobyid` for a single
+ * transaction (exact fee, TRC-20 Transfer logs).
+ *
+ * Both lists page by `max_timestamp` (inclusive, ms), so a page is a time
+ * window that is complete across both lists; the cursor carries the window's
+ * lower edge plus the txIDs already emitted at exactly that timestamp. Keyless
+ * TronGrid allows ~1 request/s per endpoint; pass `apiKey` for more.
+ * `fetch` + `AbortSignal.timeout` only — Hermes-safe.
+ */
+
+/** The `fetch` shape the history source uses; pass your own for proxies or tests. */
+type HistoryFetch = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}>;
+/** Tron mainnet or the Shasta and Nile testnets. */
+type TronNetwork = 'mainnet' | 'shasta' | 'nile';
+/** Options for {@link createTronHistory}. */
+interface TronHistoryOptions {
+    /** TronGrid-compatible root. Default by network: `https://api.trongrid.io`, `https://api.shasta.trongrid.io`, `https://nile.trongrid.io`. */
+    apiUrl?: string;
+    /** `TRON-PRO-API-KEY`. */
+    apiKey?: string;
+    network?: TronNetwork;
+    fetch?: HistoryFetch;
+    /** Requests per second. Default 1 without a key (TronGrid's keyless limit), 10 with one. */
+    rateLimit?: number;
+    /** Per request, ms. Default 15 000. */
+    timeoutMs?: number;
+}
+interface TronHistoryRaw {
+    /** The `/transactions` row (absent when only a TRC-20 transfer to the address was indexed). */
+    tx?: unknown;
+    /** `/transactions/trc20` rows for this txID. */
+    trc20: unknown[];
+    /** `/wallet/gettransactioninfobyid` (single-transaction reads only). */
+    info?: unknown;
+    spam?: true;
+    spamReason?: string;
+}
+interface TronChainTx extends ChainTx {
+    raw: TronHistoryRaw;
+}
+interface TronHistoryPage extends HistoryPage {
+    items: TronChainTx[];
+}
+/**
+ * Tron history from TronGrid's account endpoints (TRX and TRC-20). Build it with {@link
+ * createTronHistory}.
+ */
+interface TronHistorySource extends HistorySource {
+    listActivity(address: string, query?: HistoryQuery): Promise<TronHistoryPage>;
+    getTransaction(hash: string, address: string): Promise<TronChainTx | undefined>;
+}
+/** Every configured TronGrid endpoint failed. */
+declare class HistoryUnavailableError extends Error {
+    readonly chain: string;
+    readonly reason: string;
+    readonly attempts: readonly string[];
+    constructor(chain: string, reason: string, attempts?: readonly string[]);
+}
+/** keccak256("Transfer(address,address,uint256)") */
+declare const TRANSFER_TOPIC = "ddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";
+interface TronHistoryCursor {
+    v: 1;
+    /** `max_timestamp` (ms, inclusive) for the next page. */
+    w: number;
+    /** txIDs already emitted at exactly `w`. */
+    x: string[];
+    /** Lists that returned their last row. */
+    e: Array<'tx' | 'trc20'>;
+}
+declare function encodeCursor(c: TronHistoryCursor): string;
+declare function decodeCursor(s: string): TronHistoryCursor;
+interface Contract {
+    type: string;
+    parameter: {
+        value: Record<string, unknown>;
+    };
+}
+interface TronGridTx {
+    txID: string;
+    ret?: Array<{
+        contractRet?: string;
+        fee?: number;
+    }>;
+    net_fee?: number;
+    energy_fee?: number;
+    blockNumber?: number;
+    block_timestamp?: number;
+    internal_transactions?: Array<{
+        caller_address?: string;
+        transferTo_address?: string;
+        callValueInfo?: Array<{
+            callValue?: number;
+            tokenId?: string;
+        }>;
+        rejected?: boolean;
+    }>;
+    raw_data: {
+        contract: Contract[];
+        data?: string;
+        timestamp?: number;
+    };
+}
+interface TronGridTrc20 {
+    transaction_id: string;
+    token_info: {
+        symbol?: string;
+        address: string;
+        decimals?: number;
+        name?: string;
+    };
+    block_timestamp: number;
+    from: string;
+    to: string;
+    type: string;
+    value: string;
+}
+interface FullNodeTxInfo {
+    id?: string;
+    fee?: number;
+    blockNumber?: number;
+    blockTimeStamp?: number;
+    receipt?: {
+        result?: string;
+        net_fee?: number;
+        energy_fee?: number;
+    };
+    log?: Array<{
+        address: string;
+        topics: string[];
+        data?: string;
+    }>;
+}
+/** Decode what a TronGrid / full-node transaction row says on its own (no TRC-20 list rows yet). */
+declare function mapTransactionRow(chain: string, address: string, tx: TronGridTx, extra?: {
+    trc20?: TronGridTrc20[];
+    info?: FullNodeTxInfo;
+}): TronChainTx;
+/** A transaction seen only through the TRC-20 list (someone else's call that moved tokens to / from the address). */
+declare function mapTrc20Only(chain: string, address: string, rows: TronGridTrc20[]): TronChainTx;
+/** Tronscan link for a transaction. */
+declare function tronExplorerTxUrl(hash: string, network?: TronNetwork): string;
+/** A history source for Tron addresses backed by TronGrid or a compatible API. */
+declare function createTronHistory(options?: TronHistoryOptions): TronHistorySource;
+
+export { type FullNodeTxInfo, type HistoryFetch, HistoryUnavailableError, TRANSFER_TOPIC, type TronChainTx, type TronGridTrc20, type TronGridTx, type TronHistoryCursor, type TronHistoryOptions, type TronHistoryPage, type TronHistoryRaw, type TronHistorySource, type TronNetwork, createTronHistory, decodeCursor, encodeCursor, mapTransactionRow, mapTrc20Only, tronExplorerTxUrl };

package/dist/history.js

@@ -0,0 +1,21 @@
+import {
+  HistoryUnavailableError,
+  TRANSFER_TOPIC,
+  createTronHistory,
+  decodeCursor,
+  encodeCursor,
+  mapTransactionRow,
+  mapTrc20Only,
+  tronExplorerTxUrl
+} from "./chunk-4XN4VJDG.js";
+export {
+  HistoryUnavailableError,
+  TRANSFER_TOPIC,
+  createTronHistory,
+  decodeCursor,
+  encodeCursor,
+  mapTransactionRow,
+  mapTrc20Only,
+  tronExplorerTxUrl
+};
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}