@recoillink/tron-sdk 0.0.0-stage → 26.0.1

package/dist/utils/index.d.ts

@@ -0,0 +1,68 @@
+import { TronWeb } from 'tronweb';
+import { IABI, TronReceipt } from './types.js';
+import { providers } from 'ethers';
+export declare const TRON_EMPTY_ADDRESS = "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb";
+export declare const TRON_EMPTY_MESSAGE = "0x0000000000000000000000000000000000000000000000000000000000000000";
+export declare const EIP1967_ADMIN_SLOT = "0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103";
+export declare function decodeRevertReason(hex: string): string;
+/**
+ * Subset of a Tron transaction-info receipt needed to detect execution failure.
+ *
+ * `receipt` is optional because non-contract transfers surface no execution
+ * receipt, and the top-level `result` is what flags those as failures.
+ */
+export type TronReceiptResult = Pick<TronReceipt, 'resMessage' | 'contractResult' | 'result'> & Partial<Pick<TronReceipt, 'receipt'>>;
+/**
+ * Throws when a mined Tron transaction reverted or failed on-chain.
+ *
+ * Tron surfaces execution failures through `getTransactionInfo` rather than the
+ * broadcast result, so both the ethers-compatible wallet path (TronWallet) and
+ * the AltVM provider path (TronProvider) must inspect the receipt to fail
+ * loudly, mirroring EVM's CALL_EXCEPTION on a status-0 receipt.
+ */
+export declare function assertTronReceiptSuccess(info: TronReceiptResult, tronweb: TronWeb, txid: string): void;
+export declare function createDeploymentTransaction(tronweb: Readonly<TronWeb>, abi: IABI, signer: string, parameters: unknown[]): Promise<any>;
+/**
+ * Constructs MetaProxy bytecode that embeds metadata in the contract
+ * @param implementationAddress - Address of implementation contract
+ * @param metadata - ABI-encoded metadata to embed
+ * @returns Complete MetaProxy bytecode
+ */
+export declare function buildMetaProxyBytecode(implementationAddress: string, metadata: string): string;
+/**
+ * Deploys a contract using raw bytecode (for MetaProxy deployments)
+ * @param tronweb - TronWeb instance
+ * @param bytecode - Complete bytecode to deploy
+ * @param signer - Deployer address
+ * @param contractName - Optional name for the contract
+ * @returns Transaction object
+ */
+export declare function createRawBytecodeDeploymentTransaction(tronweb: Readonly<TronWeb>, bytecode: string, signer: string, contractName?: string): Promise<any>;
+/**
+ * Convert an address to Tron's 41-prefixed hex form.
+ *
+ * Accepts ethers 0x-hex, base58 (`T…`) or already-41-prefixed hex. Base58 is
+ * resolved through TronWeb so the checksum is validated rather than assumed.
+ */
+export declare function toTronHex(tronWeb: Readonly<TronWeb>, address: string): string;
+/**
+ * Fields required to invoke a TronWeb transactionBuilder trigger
+ * (`triggerSmartContract` write or `triggerConstantContract` read).
+ */
+export interface TronTriggerRequest {
+    contractAddress: string;
+    callValue: number;
+    input?: string;
+    issuerAddress: string;
+}
+/**
+ * Builds a Tron contract-trigger request from an ethers transaction. Response
+ * handling is left to the caller: writes assert on the build result, reads
+ * return the raw constant-call data so ethers can surface reverts itself.
+ *
+ * The empty functionSelector tells TronWeb to use the raw ABI-encoded `input`
+ * bytes directly instead of encoding named parameters.
+ */
+export declare function buildTronTriggerRequest(tronWeb: Readonly<TronWeb>, tx: providers.TransactionRequest, sender: string | undefined): TronTriggerRequest;
+export declare function convertEthersToTronTransaction(tronWeb: Readonly<TronWeb>, tx: providers.TransactionRequest, sender: string): Promise<any>;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAa,SAAS,EAAS,MAAM,QAAQ,CAAC;AAErD,eAAO,MAAM,kBAAkB,uCAAuC,CAAC;AACvE,eAAO,MAAM,kBAAkB,uEACuC,CAAC;AACvE,eAAO,MAAM,kBAAkB,uEACuC,CAAC;AAEvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWtD;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,WAAW,EACX,YAAY,GAAG,gBAAgB,GAAG,QAAQ,CAC3C,GACC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAExC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,GACX,IAAI,CAmBN;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,OAAO,EAAE,GACpB,OAAO,CAAC,GAAG,CAAC,CAWd;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CA2BR;AAED;;;;;;;GAOG;AACH,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,SAAc,GACzB,OAAO,CAAC,GAAG,CAAC,CAWd;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM7E;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,EAAE,EAAE,SAAS,CAAC,kBAAkB,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,kBAAkB,CAgBpB;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,EAAE,EAAE,SAAS,CAAC,kBAAkB,EAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,GAAG,CAAC,CAed"}

package/dist/utils/index.js

@@ -0,0 +1,141 @@
+import { assert, isNullish, strip0x } from '@recoillink/utils';
+import { BigNumber, utils } from 'ethers';
+export const TRON_EMPTY_ADDRESS = 'T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb';
+export const TRON_EMPTY_MESSAGE = '0x0000000000000000000000000000000000000000000000000000000000000000';
+export const EIP1967_ADMIN_SLOT = '0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103';
+export function decodeRevertReason(hex) {
+    try {
+        if (hex.startsWith('08c379a0')) {
+            // Standard Error(string) selector — decode the ABI-encoded string payload.
+            const data = '0x' + hex.substring(8);
+            return String(utils.defaultAbiCoder.decode(['string'], data)[0]);
+        }
+        return `Hex Error: ${hex}`;
+    }
+    catch {
+        return `Could not decode hex: ${hex}`;
+    }
+}
+/**
+ * Throws when a mined Tron transaction reverted or failed on-chain.
+ *
+ * Tron surfaces execution failures through `getTransactionInfo` rather than the
+ * broadcast result, so both the ethers-compatible wallet path (TronWallet) and
+ * the AltVM provider path (TronProvider) must inspect the receipt to fail
+ * loudly, mirroring EVM's CALL_EXCEPTION on a status-0 receipt.
+ */
+export function assertTronReceiptSuccess(info, tronweb, txid) {
+    const nested = info.receipt?.result;
+    const topLevelFailed = info.result === 'FAILED';
+    // Nested receipt.result is Tron's contractResult enum (SUCCESS/REVERT/
+    // OUT_OF_ENERGY/OUT_OF_TIME/...). Any value other than SUCCESS is a mined
+    // failure. It is absent for non-contract transfers, which are not failures.
+    const nestedFailed = !isNullish(nested) && nested !== 'SUCCESS';
+    if (!topLevelFailed && !nestedFailed) {
+        return;
+    }
+    let revertReason = 'Unknown Error';
+    if (info.resMessage) {
+        revertReason = tronweb.toUtf8(info.resMessage);
+    }
+    else if (info.contractResult && info.contractResult[0]) {
+        revertReason = decodeRevertReason(info.contractResult[0]);
+    }
+    throw new Error(`Tron Transaction Failed: ${revertReason} (txid: ${txid})`);
+}
+export async function createDeploymentTransaction(tronweb, abi, signer, parameters) {
+    return tronweb.transactionBuilder.createSmartContract({
+        feeLimit: 1_000_000_000,
+        abi: abi.abi,
+        bytecode: abi.bytecode,
+        parameters,
+        name: abi.contractName,
+    }, signer);
+}
+/**
+ * Constructs MetaProxy bytecode that embeds metadata in the contract
+ * @param implementationAddress - Address of implementation contract
+ * @param metadata - ABI-encoded metadata to embed
+ * @returns Complete MetaProxy bytecode
+ */
+export function buildMetaProxyBytecode(implementationAddress, metadata) {
+    const PREFIX = '600b380380600b3d393df3363d3d373d3d3d3d60368038038091363936013d73';
+    const SUFFIX = '5af43d3d93803e603457fd5bf3';
+    // Remove 0x prefix if present
+    const cleanMetadata = strip0x(metadata);
+    let cleanImpl = strip0x(implementationAddress);
+    // Tron addresses have 41 prefix byte - strip it to get 20 bytes
+    if (cleanImpl.startsWith('41')) {
+        cleanImpl = cleanImpl.slice(2);
+    }
+    // Validate address is exactly 20 bytes (40 hex chars)
+    if (cleanImpl.length !== 40) {
+        throw new Error(`Implementation address must be 20 bytes (40 hex chars), got ${cleanImpl.length}`);
+    }
+    // Convert metadata length to 32-byte hex (uint256)
+    const metadataLength = (cleanMetadata.length / 2)
+        .toString(16)
+        .padStart(64, '0');
+    return `0x${PREFIX}${cleanImpl}${SUFFIX}${cleanMetadata}${metadataLength}`;
+}
+/**
+ * Deploys a contract using raw bytecode (for MetaProxy deployments)
+ * @param tronweb - TronWeb instance
+ * @param bytecode - Complete bytecode to deploy
+ * @param signer - Deployer address
+ * @param contractName - Optional name for the contract
+ * @returns Transaction object
+ */
+export async function createRawBytecodeDeploymentTransaction(tronweb, bytecode, signer, contractName = 'MetaProxy') {
+    return tronweb.transactionBuilder.createSmartContract({
+        feeLimit: 1_000_000_000,
+        abi: [],
+        bytecode,
+        parameters: [],
+        name: contractName,
+    }, signer);
+}
+/**
+ * Convert an address to Tron's 41-prefixed hex form.
+ *
+ * Accepts ethers 0x-hex, base58 (`T…`) or already-41-prefixed hex. Base58 is
+ * resolved through TronWeb so the checksum is validated rather than assumed.
+ */
+export function toTronHex(tronWeb, address) {
+    if (address.startsWith('T')) {
+        return tronWeb.address.toHex(address);
+    }
+    const hex = strip0x(address).toLowerCase();
+    return hex.startsWith('41') && hex.length === 42 ? hex : `41${hex}`;
+}
+/**
+ * Builds a Tron contract-trigger request from an ethers transaction. Response
+ * handling is left to the caller: writes assert on the build result, reads
+ * return the raw constant-call data so ethers can surface reverts itself.
+ *
+ * The empty functionSelector tells TronWeb to use the raw ABI-encoded `input`
+ * bytes directly instead of encoding named parameters.
+ */
+export function buildTronTriggerRequest(tronWeb, tx, sender) {
+    assert(tx.to, 'Transaction must have a destination address');
+    const contractAddress = toTronHex(tronWeb, tx.to);
+    // A provider-connected ethers read omits `from`. Defaulting the caller to the
+    // contract itself would run the call with msg.sender == address(this), so
+    // caller-sensitive views return wrong/privileged state. Use the Tron zero
+    // address as the caller instead, mirroring eth_call's default sender.
+    const issuerAddress = isNullish(sender)
+        ? toTronHex(tronWeb, TRON_EMPTY_ADDRESS)
+        : toTronHex(tronWeb, sender);
+    const callValue = tx.value ? BigNumber.from(tx.value).toNumber() : 0;
+    const input = isNullish(tx.data)
+        ? undefined
+        : strip0x(utils.hexlify(tx.data));
+    return { contractAddress, callValue, input, issuerAddress };
+}
+export async function convertEthersToTronTransaction(tronWeb, tx, sender) {
+    const { contractAddress, callValue, input, issuerAddress } = buildTronTriggerRequest(tronWeb, tx, sender);
+    const response = await tronWeb.transactionBuilder.triggerSmartContract(contractAddress, '', { callValue, input }, [], issuerAddress);
+    assert(response.result?.result, `triggerSmartContract failed: ${response.result?.message}`);
+    return response.transaction;
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/dist/utils/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/utils/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/utils/index.test.ts"],"names":[],"mappings":""}

package/dist/utils/index.test.js

@@ -0,0 +1,85 @@
+import { expect } from 'chai';
+import { ethers } from 'ethers';
+import { TronWeb } from 'tronweb';
+import { strip0x } from '@recoillink/utils';
+import { assertTronReceiptSuccess } from './index.js';
+const TXID = 'abc123';
+// Offline instance: only toUtf8 / abi decoding are exercised, no network calls.
+const tronweb = new TronWeb({ fullHost: 'http://127.0.0.1:9090' });
+// Standard Solidity Error(string) revert payload: 08c379a0 selector + abi("boom").
+const ERROR_STRING_REVERT_DATA = '08c379a0' +
+    strip0x(ethers.utils.defaultAbiCoder.encode(['string'], ['boom']));
+function makeReceipt(fields) {
+    return {
+        // Non-contract transfers surface no execution receipt, so omit it when the
+        // nested contractResult value is not provided.
+        receipt: fields.result === undefined
+            ? undefined
+            : {
+                energy_usage: 0,
+                energy_fee: 0,
+                origin_energy_usage: 0,
+                energy_usage_total: 0,
+                net_usage: 0,
+                net_fee: 0,
+                result: fields.result,
+                energy_penalty_total: 0,
+            },
+        result: fields.topLevelResult,
+        resMessage: fields.resMessage ?? '',
+        contractResult: fields.contractResult ?? [],
+    };
+}
+const cases = [
+    {
+        name: 'throws on REVERT and decodes resMessage',
+        receipt: makeReceipt({
+            result: 'REVERT',
+            resMessage: tronweb.fromUtf8('out of energy'),
+        }),
+        expectedError: /Tron Transaction Failed: out of energy \(txid: abc123\)/,
+    },
+    {
+        name: 'throws on OUT_OF_ENERGY with a decoded contractResult reason',
+        receipt: makeReceipt({
+            result: 'OUT_OF_ENERGY',
+            contractResult: [ERROR_STRING_REVERT_DATA],
+        }),
+        expectedError: /Tron Transaction Failed: boom \(txid: abc123\)/,
+    },
+    {
+        name: 'throws on REVERT with unknown reason when no data present',
+        receipt: makeReceipt({ result: 'REVERT' }),
+        expectedError: /Tron Transaction Failed: Unknown Error \(txid: abc123\)/,
+    },
+    {
+        name: 'throws on top-level FAILED even when the nested result is SUCCESS',
+        receipt: makeReceipt({ result: 'SUCCESS', topLevelResult: 'FAILED' }),
+        expectedError: /Tron Transaction Failed: Unknown Error \(txid: abc123\)/,
+    },
+    {
+        name: 'does not throw on SUCCESS',
+        receipt: makeReceipt({ result: 'SUCCESS' }),
+    },
+    {
+        name: 'does not throw on a plain transfer with no nested result',
+        receipt: makeReceipt({}),
+    },
+    {
+        name: 'does not throw while pending',
+        receipt: makeReceipt({ topLevelResult: 'PENDING' }),
+    },
+];
+describe('assertTronReceiptSuccess', () => {
+    for (const c of cases) {
+        it(c.name, () => {
+            if (c.expectedError) {
+                expect(() => assertTronReceiptSuccess(c.receipt, tronweb, TXID)).to.throw(c.expectedError);
+            }
+            else {
+                expect(() => assertTronReceiptSuccess(c.receipt, tronweb, TXID)).to.not.throw();
+            }
+        });
+    }
+});
+//# sourceMappingURL=index.test.js.map

package/dist/utils/index.test.js.map

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

package/dist/utils/types.d.ts

@@ -0,0 +1,94 @@
+import { Address } from '@recoillink/utils';
+export type TronTransaction = {
+    visible: boolean;
+    txID: string;
+    raw_data_hex: string;
+    raw_data: {
+        contract: {
+            parameter: {
+                value: any;
+                type_url: string;
+            };
+            type: any;
+        }[];
+        ref_block_bytes: string;
+        ref_block_hash: string;
+        expiration: number;
+        timestamp: number;
+        fee_limit?: number;
+    };
+};
+type HTTPMap<T extends string | number | symbol, U> = Record<T, U>[];
+export type TronReceipt = {
+    id: string;
+    fee: number;
+    blockNumber: number;
+    blockTimeStamp: number;
+    contractResult: string[];
+    contract_address: string;
+    receipt: {
+        energy_usage: number;
+        energy_fee: number;
+        origin_energy_usage: number;
+        energy_usage_total: number;
+        net_usage: number;
+        net_fee: number;
+        result: string;
+        energy_penalty_total: number;
+    };
+    log: {
+        address: Address;
+        topics: string[];
+        data: string;
+    }[];
+    result?: 'SUCCESS' | 'PENDING' | 'FAILED';
+    resMessage: string;
+    assetIssueID: string;
+    withdraw_amount: number;
+    unfreeze_amount: number;
+    internal_transactions: {
+        hash: string;
+        caller_address: string;
+        transferTo_address: string;
+        callValueInfo: {
+            callValue: number;
+            tokenId: string;
+        }[];
+        note: string;
+        rejected: boolean;
+        extra: string;
+    }[];
+    exchange_received_amount: number;
+    exchange_inject_another_amount: number;
+    exchange_withdraw_another_amount: number;
+    shielded_transaction_fee: number;
+    withdraw_expire_amount: number;
+    cancel_unfreezeV2_amount: HTTPMap<string, number>;
+    exchange_id: string;
+    orderId: string;
+    orderDetails: {
+        makerOrderId: string;
+        takerOrderId: string;
+        fillSellQuantity: number;
+        fillBuyQuantity: number;
+    }[];
+    packingFee: number;
+};
+export interface IABI {
+    contractName: string;
+    abi: any[];
+    bytecode: string;
+    deployedBytecode: string;
+}
+export declare enum TronIsmTypes {
+    MERKLE_ROOT_MULTISIG = "MerkleRootMultisigIsm",
+    MESSAGE_ID_MULTISIG = "MessageIdMultisigIsm",
+    ROUTING_ISM = "RoutingIsm",
+    NOOP_ISM = "NoopIsm"
+}
+export declare enum TronHookTypes {
+    MERKLE_TREE = "merkleTreeHook",
+    INTERCHAIN_GAS_PAYMASTER = "interchainGasPaymaster"
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

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

package/dist/utils/types.js

@@ -0,0 +1,13 @@
+export var TronIsmTypes;
+(function (TronIsmTypes) {
+    TronIsmTypes["MERKLE_ROOT_MULTISIG"] = "MerkleRootMultisigIsm";
+    TronIsmTypes["MESSAGE_ID_MULTISIG"] = "MessageIdMultisigIsm";
+    TronIsmTypes["ROUTING_ISM"] = "RoutingIsm";
+    TronIsmTypes["NOOP_ISM"] = "NoopIsm";
+})(TronIsmTypes || (TronIsmTypes = {}));
+export var TronHookTypes;
+(function (TronHookTypes) {
+    TronHookTypes["MERKLE_TREE"] = "merkleTreeHook";
+    TronHookTypes["INTERCHAIN_GAS_PAYMASTER"] = "interchainGasPaymaster";
+})(TronHookTypes || (TronHookTypes = {}));
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAuFA,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,8DAA8C,CAAA;IAC9C,4DAA4C,CAAA;IAC5C,0CAA0B,CAAA;IAC1B,oCAAoB,CAAA;AACtB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,+CAA8B,CAAA;IAC9B,oEAAmD,CAAA;AACrD,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB"}

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@recoillink/tron-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "26.0.1",
+  "description": "Recoil Link TypeScript SDK for Tron",
+  "keywords": [
+    "blockchain",
+    "hyperlane",
+    "sdk",
+    "tron"
+  ],
+  "homepage": "https://github.com/recoil-labs/recoil-link",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/recoil-labs/recoil-link"
+  },
+  "files": [
+    "/dist",
+    "local-node"
+  ],
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "default": "./dist/runtime.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "dependencies": {
+    "@ethersproject/abi": "*",
+    "@ethersproject/providers": "*",
+    "@recoillink/core": "12.2.0",
+    "@recoillink/provider-sdk": "11.0.1",
+    "@recoillink/utils": "45.0.1",
+    "bignumber.js": "^9.1.1",
+    "ethers": "^5.8.0",
+    "tronweb": "^6.1.1"
+  },
+  "devDependencies": {
+    "@recoillink/tsconfig": "^45.0.1",
+    "@types/chai": "^4.3.11",
+    "@types/chai-as-promised": "^8",
+    "@types/mocha": "^10.0.1",
+    "@types/node": "^26.1.2",
+    "@types/unzipper": "^0",
+    "c8": "^10.1.3",
+    "chai": "^4.5.0",
+    "chai-as-promised": "^8.0.1",
+    "mocha": "^11.7.6",
+    "mocha-steps": "^1.3.0",
+    "node-fetch": "^3.3.2",
+    "testcontainers": "11.12.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.23.1",
+    "typescript": "npm:@typescript/typescript6@6.0.2"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "rm -rf ./dist && tsc",
+    "format": "oxfmt --write src/**/*.ts",
+    "lint": "oxlint -c ../../oxlint.json",
+    "clean": "rm -rf ./dist ./cache ./coverage",
+    "dev": "tsc --watch",
+    "test": "mocha --config .mocharc.json './src/**/*.test.ts'",
+    "coverage": "c8 pnpm test"
+  }
 }