@recoillink/tron-sdk 0.0.0-stage → 26.0.1

package/dist/ethers/urlUtils.js

@@ -0,0 +1,67 @@
+/**
+ * Parse custom_rpc_header query params from a URL into a headers object.
+ * e.g. "https://api.trongrid.io?custom_rpc_header=TRON-PRO-API-KEY:abc"
+ * returns { "TRON-PRO-API-KEY": "abc" }
+ */
+export function parseCustomHeaders(url) {
+    const headers = {};
+    try {
+        const parsed = new URL(url);
+        for (const [key, value] of parsed.searchParams) {
+            if (key !== 'custom_rpc_header')
+                continue;
+            const colonIdx = value.indexOf(':');
+            if (colonIdx > 0) {
+                headers[value.slice(0, colonIdx)] = value.slice(colonIdx + 1);
+            }
+        }
+    }
+    catch {
+        // Not a valid URL, return empty headers
+    }
+    return headers;
+}
+/**
+ * Strip custom_rpc_header query params from a URL and return the clean URL
+ * along with the extracted headers.
+ *
+ * e.g. "https://host/jsonrpc?custom_rpc_header=x-api-key:abc&other=1"
+ * returns { url: "https://host/jsonrpc?other=1", headers: { "x-api-key": "abc" } }
+ *
+ * If no custom_rpc_header params are present, returns the original URL unchanged.
+ */
+export function stripCustomRpcHeaders(url) {
+    const headers = parseCustomHeaders(url);
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return { url, headers };
+    }
+    if (!parsed.searchParams.has('custom_rpc_header')) {
+        return { url, headers };
+    }
+    parsed.searchParams.delete('custom_rpc_header');
+    return { url: parsed.toString(), headers };
+}
+/**
+ * Derive the Tron HTTP API base host from an RPC URL.
+ *
+ * TronWeb needs the base HTTP API host (serving `/wallet/*`), which differs
+ * from the ethers JSON-RPC endpoint. This strips any `custom_rpc_header` query
+ * params (they are auth headers, not part of the host) and a trailing
+ * `/jsonrpc` path segment.
+ *
+ * e.g. "https://node.example.com/jsonrpc?custom_rpc_header=x-api-key:abc"
+ * returns "https://node.example.com/"
+ */
+export function toHttpApiUrl(url) {
+    const { url: clean } = stripCustomRpcHeaders(url);
+    const parsed = new URL(clean);
+    if (parsed.pathname.endsWith('/jsonrpc')) {
+        parsed.pathname = parsed.pathname.slice(0, -'/jsonrpc'.length);
+    }
+    return parsed.toString();
+}
+//# sourceMappingURL=urlUtils.js.map

package/dist/ethers/urlUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlUtils.js","sourceRoot":"","sources":["../../src/ethers/urlUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAC/C,IAAI,GAAG,KAAK,mBAAmB;gBAAE,SAAS;YAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAI/C,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAChD,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/dist/ethers/urlUtils.test.d.ts

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

package/dist/ethers/urlUtils.test.d.ts.map

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

package/dist/ethers/urlUtils.test.js

@@ -0,0 +1,106 @@
+import { expect } from 'chai';
+import { parseCustomHeaders, stripCustomRpcHeaders, toHttpApiUrl, } from './urlUtils.js';
+describe('parseCustomHeaders', () => {
+    it('extracts a single custom_rpc_header', () => {
+        const url = 'https://api.trongrid.io?custom_rpc_header=TRON-PRO-API-KEY:abc123';
+        expect(parseCustomHeaders(url)).to.deep.equal({
+            'TRON-PRO-API-KEY': 'abc123',
+        });
+    });
+    it('extracts multiple custom_rpc_header params', () => {
+        const url = 'https://host?custom_rpc_header=x-api-key:key1&custom_rpc_header=Authorization:Bearer%20token';
+        expect(parseCustomHeaders(url)).to.deep.equal({
+            'x-api-key': 'key1',
+            Authorization: 'Bearer token',
+        });
+    });
+    it('handles header values with colons', () => {
+        const url = 'https://host?custom_rpc_header=x-api-key:token:with:colons';
+        expect(parseCustomHeaders(url)).to.deep.equal({
+            'x-api-key': 'token:with:colons',
+        });
+    });
+    it('returns empty object for URL without custom_rpc_header', () => {
+        const url = 'https://api.trongrid.io/jsonrpc';
+        expect(parseCustomHeaders(url)).to.deep.equal({});
+    });
+    it('returns empty object for invalid URL', () => {
+        expect(parseCustomHeaders('not-a-url')).to.deep.equal({});
+    });
+    it('ignores malformed header values without colon', () => {
+        const url = 'https://host?custom_rpc_header=nocolon';
+        expect(parseCustomHeaders(url)).to.deep.equal({});
+    });
+});
+describe('stripCustomRpcHeaders', () => {
+    it('strips custom_rpc_header and returns clean URL with headers', () => {
+        const url = 'https://tron-mainnet.gateway.tatum.io/jsonrpc?custom_rpc_header=x-api-key:abc123';
+        const result = stripCustomRpcHeaders(url);
+        expect(result.url).to.equal('https://tron-mainnet.gateway.tatum.io/jsonrpc');
+        expect(result.headers).to.deep.equal({ 'x-api-key': 'abc123' });
+    });
+    it('preserves non-custom_rpc_header query params', () => {
+        const url = 'https://host/jsonrpc?custom_rpc_header=x-api-key:abc&other=1';
+        const result = stripCustomRpcHeaders(url);
+        expect(result.url).to.equal('https://host/jsonrpc?other=1');
+        expect(result.headers).to.deep.equal({ 'x-api-key': 'abc' });
+    });
+    it('returns original URL unchanged when no custom_rpc_header', () => {
+        const url = 'https://api.trongrid.io/jsonrpc';
+        const result = stripCustomRpcHeaders(url);
+        expect(result.url).to.equal(url);
+        expect(result.headers).to.deep.equal({});
+    });
+    it('returns original URL unchanged when xApiKey query param is used', () => {
+        const url = 'https://tron-mainnet.gateway.tatum.io/jsonrpc?xApiKey=abc123';
+        const result = stripCustomRpcHeaders(url);
+        expect(result.url).to.equal(url);
+        expect(result.headers).to.deep.equal({});
+    });
+    it('strips malformed custom_rpc_header without colon', () => {
+        const url = 'https://host/jsonrpc?custom_rpc_header=nocolon';
+        const result = stripCustomRpcHeaders(url);
+        expect(result.url).to.equal('https://host/jsonrpc');
+        expect(result.headers).to.deep.equal({});
+    });
+});
+describe('toHttpApiUrl', () => {
+    it('strips a trailing /jsonrpc path', () => {
+        expect(toHttpApiUrl('https://node.example.com:8090/jsonrpc')).to.equal('https://node.example.com:8090/');
+    });
+    it('strips custom_rpc_header query params', () => {
+        expect(toHttpApiUrl('https://node.example.com/jsonrpc?custom_rpc_header=x-api-key:abc')).to.equal('https://node.example.com/');
+    });
+    it('preserves a private/custom host', () => {
+        const result = toHttpApiUrl('https://my-tron-node.example.com/jsonrpc');
+        expect(result).to.contain('my-tron-node.example.com');
+        expect(result).to.not.contain('trongrid');
+    });
+    it('leaves a plain host without /jsonrpc unchanged', () => {
+        expect(toHttpApiUrl('https://node.example.com')).to.equal('https://node.example.com/');
+    });
+    it('returns a trongrid host as its own host', () => {
+        const result = toHttpApiUrl('https://api.trongrid.io/jsonrpc');
+        expect(result).to.contain('trongrid');
+    });
+    it('preserves non-custom_rpc_header query params', () => {
+        expect(toHttpApiUrl('https://host.example.com/jsonrpc?custom_rpc_header=x-api-key:abc&foo=bar')).to.equal('https://host.example.com/?foo=bar');
+    });
+    it('leaves a non-trailing /jsonrpc path segment intact', () => {
+        expect(toHttpApiUrl('https://host.example.com/jsonrpc/v1')).to.equal('https://host.example.com/jsonrpc/v1');
+    });
+    it('throws on invalid (non-URL) input', () => {
+        expect(() => toHttpApiUrl('not-a-url')).to.throw();
+    });
+    // Provider-style URLs that carry the API key in the path (e.g. Alchemy:
+    // https://tron-mainnet.g.alchemy.com/v2/<key>) must keep the host and path
+    // verbatim, since the provider serves both eth JSON-RPC and the Tron HTTP API
+    // under that base. A generic host is used here to avoid secret scanners.
+    it('preserves a provider base URL with an api-key path segment (no /jsonrpc)', () => {
+        expect(toHttpApiUrl('https://tron-rpc.example.com/v2/API_KEY')).to.equal('https://tron-rpc.example.com/v2/API_KEY');
+    });
+    it('strips only a trailing /jsonrpc from such a provider URL', () => {
+        expect(toHttpApiUrl('https://tron-rpc.example.com/v2/API_KEY/jsonrpc')).to.equal('https://tron-rpc.example.com/v2/API_KEY');
+    });
+});
+//# sourceMappingURL=urlUtils.test.js.map

package/dist/ethers/urlUtils.test.js.map

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

package/dist/factories/index.d.ts

@@ -0,0 +1,2 @@
+export * from '@recoillink/core/tron/typechain';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AAMA,cAAc,iCAAiC,CAAC"}

package/dist/factories/index.js

@@ -0,0 +1,8 @@
+// Re-export all typechain types and factories (flattened).
+// These factories are generated from the same Solidity source as @recoillink/core
+// via the tron-solc compiler. They have identical ABIs and deploy signatures, differing
+// only in bytecode (TVM-compiled with 0x41 Create2 prefix). This 1:1 correspondence
+// with core factory class names is relied upon by the SDK's MultiProvider.handleDeploy
+// to dynamically resolve the correct factory at deploy time.
+export * from '@recoillink/core/tron/typechain';
+//# sourceMappingURL=index.js.map

package/dist/factories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,kFAAkF;AAClF,wFAAwF;AACxF,oFAAoF;AACpF,uFAAuF;AACvF,6DAA6D;AAC7D,cAAc,iCAAiC,CAAC"}

package/dist/hook/hook-query.d.ts

@@ -0,0 +1,41 @@
+import { TronWeb } from 'tronweb';
+import { TronHookTypes } from '../utils/types.js';
+/**
+ * Type alias for query client with ISM extension.
+ * Used throughout ISM readers to ensure type safety.
+ */
+export type TronHookQueryClient = TronWeb;
+export declare function getHookType(query: TronHookQueryClient, hookAddress: string): Promise<TronHookTypes>;
+/**
+ * Query IGP hook configuration from chain.
+ *
+ * @param query - Query client with PostDispatchExtension
+ * @param hookId - ID of the IGP hook to query
+ * @returns IGP hook configuration with address, owner, and destination gas configs
+ * @throws Error if IGP hook not found
+ */
+export declare function getIgpHookConfig(query: TronHookQueryClient, hookId: string): Promise<{
+    address: string;
+    owner: string;
+    destinationGasConfigs: {
+        [domainId: string]: {
+            gasOracle: {
+                tokenExchangeRate: string;
+                gasPrice: string;
+            };
+            gasOverhead: string;
+        };
+    };
+}>;
+/**
+ * Query MerkleTree hook configuration from chain.
+ *
+ * @param query - Query client with PostDispatchExtension
+ * @param hookId - ID of the MerkleTree hook to query
+ * @returns MerkleTree hook configuration with address
+ * @throws Error if MerkleTree hook not found
+ */
+export declare function getMerkleTreeHookConfig(query: TronHookQueryClient, hookId: string): Promise<{
+    address: string;
+}>;
+//# sourceMappingURL=hook-query.d.ts.map

package/dist/hook/hook-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-query.d.ts","sourceRoot":"","sources":["../../src/hook/hook-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAQlC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE1C,wBAAsB,WAAW,CAC/B,KAAK,EAAE,mBAAmB,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CAaxB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB,EAAE;QACrB,CAAC,QAAQ,EAAE,MAAM,GAAG;YAClB,SAAS,EAAE;gBACT,iBAAiB,EAAE,MAAM,CAAC;gBAC1B,QAAQ,EAAE,MAAM,CAAC;aAClB,CAAC;YACF,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH,CAAC,CAqDD;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAeD"}

package/dist/hook/hook-query.js

@@ -0,0 +1,79 @@
+import { assert } from '@recoillink/utils';
+import IPostDispatchHookAbi from '@recoillink/core/tron/abi/contracts/interfaces/hooks/IPostDispatchHook.sol/IPostDispatchHook.json' with { type: 'json' };
+import InterchainGasPaymasterAbi from '@recoillink/core/tron/abi/contracts/hooks/igp/InterchainGasPaymaster.sol/InterchainGasPaymaster.json' with { type: 'json' };
+import MerkleTreeHookAbi from '@recoillink/core/tron/abi/contracts/hooks/MerkleTreeHook.sol/MerkleTreeHook.json' with { type: 'json' };
+import StorageGasOracleAbi from '@recoillink/core/tron/abi/contracts/hooks/igp/StorageGasOracle.sol/StorageGasOracle.json' with { type: 'json' };
+import { TronHookTypes } from '../utils/types.js';
+export async function getHookType(query, hookAddress) {
+    const contract = query.contract(IPostDispatchHookAbi.abi, hookAddress);
+    const hookType = Number(await contract.hookType().call());
+    switch (hookType) {
+        case 3:
+            return TronHookTypes.MERKLE_TREE;
+        case 4:
+            return TronHookTypes.INTERCHAIN_GAS_PAYMASTER;
+        default:
+            throw new Error(`Unknown Hook type for address: ${hookAddress}`);
+    }
+}
+/**
+ * Query IGP hook configuration from chain.
+ *
+ * @param query - Query client with PostDispatchExtension
+ * @param hookId - ID of the IGP hook to query
+ * @returns IGP hook configuration with address, owner, and destination gas configs
+ * @throws Error if IGP hook not found
+ */
+export async function getIgpHookConfig(query, hookId) {
+    try {
+        const igp = query.contract(InterchainGasPaymasterAbi.abi, hookId);
+        const hookType = await igp.hookType().call();
+        assert(Number(hookType) === 4, `hook type does not equal INTERCHAIN_GAS_PAYMASTER`);
+        const domainIds = await igp.domains().call();
+        const destinationGasConfigs = {};
+        for (const domainId of domainIds) {
+            const c = await igp.destinationGasConfigs(domainId).call();
+            const gasOracle = query.contract(StorageGasOracleAbi.abi, query.address.fromHex(c.gasOracle));
+            const { tokenExchangeRate, gasPrice } = await gasOracle
+                .remoteGasData(domainId)
+                .call();
+            destinationGasConfigs[domainId.toString()] = {
+                gasOracle: {
+                    tokenExchangeRate: tokenExchangeRate.toString(),
+                    gasPrice: gasPrice.toString(),
+                },
+                gasOverhead: c.gasOverhead.toString(),
+            };
+        }
+        return {
+            address: hookId,
+            owner: query.address.fromHex(await igp.owner().call()),
+            destinationGasConfigs,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to query IGP hook config at ${hookId}: ${error.message}`);
+    }
+}
+/**
+ * Query MerkleTree hook configuration from chain.
+ *
+ * @param query - Query client with PostDispatchExtension
+ * @param hookId - ID of the MerkleTree hook to query
+ * @returns MerkleTree hook configuration with address
+ * @throws Error if MerkleTree hook not found
+ */
+export async function getMerkleTreeHookConfig(query, hookId) {
+    try {
+        const contract = query.contract(MerkleTreeHookAbi.abi, hookId);
+        const hookType = await contract.hookType().call();
+        assert(Number(hookType) === 3, `hook type does not equal MERKLE_TREE`);
+        return {
+            address: hookId,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to query MerkleTree hook config at ${hookId}: ${error.message}`);
+    }
+}
+//# sourceMappingURL=hook-query.js.map

package/dist/hook/hook-query.js.map

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

package/dist/hook/hook-tx.d.ts

@@ -0,0 +1,39 @@
+import { TronWeb } from 'tronweb';
+import { TronTransaction } from '../utils/types.js';
+export declare function getCreateMerkleTreeHookTx(tronweb: Readonly<TronWeb>, fromAddress: string, mailboxAddress: string): Promise<TronTransaction>;
+export declare function getCreateIgpTx(tronweb: Readonly<TronWeb>, fromAddress: string): Promise<TronTransaction>;
+export declare function getCreateProxyTx(tronweb: Readonly<TronWeb>, fromAddress: string, implAddress: string, proxyAdminAddress: string): Promise<TronTransaction>;
+export declare function getInitIgpTx(tronweb: Readonly<TronWeb>, fromAddress: string, config: {
+    igpAddress: string;
+}): Promise<TronTransaction>;
+export declare function getCreateOracleTx(tronweb: Readonly<TronWeb>, fromAddress: string): Promise<TronTransaction>;
+export declare function getSetOracleTx(tronweb: Readonly<TronWeb>, fromAddress: string, config: {
+    igpAddress: string;
+    oracleAddress: string;
+}): Promise<TronTransaction>;
+export declare function getSetRemoteGasTx(tronweb: Readonly<TronWeb>, fromAddress: string, config: {
+    igpAddress: string;
+    destinationGasConfigs: {
+        remoteDomainId: number;
+        gasOracle: {
+            tokenExchangeRate: string;
+            gasPrice: string;
+        };
+    }[];
+}): Promise<TronTransaction>;
+export declare function getSetIgpOwnerTx(tronweb: Readonly<TronWeb>, fromAddress: string, config: {
+    igpAddress: string;
+    newOwner: string;
+}): Promise<TronTransaction>;
+export declare function getSetIgpDestinationGasConfigTx(tronweb: Readonly<TronWeb>, fromAddress: string, config: {
+    igpAddress: string;
+    destinationGasConfigs: {
+        remoteDomainId: number;
+        gasOverhead: string;
+    }[];
+}): Promise<TronTransaction>;
+export declare function getRemoveIgpDestinationGasConfigTx(tronweb: Readonly<TronWeb>, fromAddress: string, config: {
+    igpAddress: string;
+    remoteDomainIds: number[];
+}): Promise<TronTransaction>;
+//# sourceMappingURL=hook-tx.d.ts.map

package/dist/hook/hook-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-tx.d.ts","sourceRoot":"","sources":["../../src/hook/hook-tx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AASlC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC,CAI1B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAO1B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,eAAe,CAAC,CAO1B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,eAAe,CAAC,CAmB1B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CAO1B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,eAAe,CAAC,CAe1B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE;YACT,iBAAiB,EAAE,MAAM,CAAC;YAC1B,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,EAAE,CAAC;CACL,GACA,OAAO,CAAC,eAAe,CAAC,CA0B1B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,eAAe,CAAC,CAe1B;AAED,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;CACL,GACA,OAAO,CAAC,eAAe,CAAC,CAkC1B;AAED,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,GACA,OAAO,CAAC,eAAe,CAAC,CAe1B"}

package/dist/hook/hook-tx.js

@@ -0,0 +1,95 @@
+import { assert } from '@recoillink/utils';
+import InterchainGasPaymasterAbi from '@recoillink/core/tron/abi/contracts/hooks/igp/InterchainGasPaymaster.sol/InterchainGasPaymaster.json' with { type: 'json' };
+import MerkleTreeHookAbi from '@recoillink/core/tron/abi/contracts/hooks/MerkleTreeHook.sol/MerkleTreeHook.json' with { type: 'json' };
+import StorageGasOracleAbi from '@recoillink/core/tron/abi/contracts/hooks/igp/StorageGasOracle.sol/StorageGasOracle.json' with { type: 'json' };
+import TransparentUpgradeableProxyAbi from '@recoillink/core/tron/abi/@openzeppelin/contracts/proxy/transparent/TransparentUpgradeableProxy.sol/TransparentUpgradeableProxy.json' with { type: 'json' };
+import { createDeploymentTransaction } from '../utils/index.js';
+export async function getCreateMerkleTreeHookTx(tronweb, fromAddress, mailboxAddress) {
+    return createDeploymentTransaction(tronweb, MerkleTreeHookAbi, fromAddress, [
+        mailboxAddress,
+    ]);
+}
+export async function getCreateIgpTx(tronweb, fromAddress) {
+    return createDeploymentTransaction(tronweb, InterchainGasPaymasterAbi, fromAddress, []);
+}
+export async function getCreateProxyTx(tronweb, fromAddress, implAddress, proxyAdminAddress) {
+    return createDeploymentTransaction(tronweb, TransparentUpgradeableProxyAbi, fromAddress, [implAddress, proxyAdminAddress, '0x']);
+}
+export async function getInitIgpTx(tronweb, fromAddress, config) {
+    const { transaction } = await tronweb.transactionBuilder.triggerSmartContract(config.igpAddress, 'initialize(address,address)', {}, [
+        {
+            type: 'address',
+            value: fromAddress,
+        },
+        {
+            type: 'address',
+            value: fromAddress,
+        },
+    ], tronweb.address.toHex(fromAddress));
+    return transaction;
+}
+export async function getCreateOracleTx(tronweb, fromAddress) {
+    return createDeploymentTransaction(tronweb, StorageGasOracleAbi, fromAddress, []);
+}
+export async function getSetOracleTx(tronweb, fromAddress, config) {
+    const { transaction } = await tronweb.transactionBuilder.triggerSmartContract(config.igpAddress, 'setGasOracle(address)', {}, [
+        {
+            type: 'address',
+            value: config.oracleAddress,
+        },
+    ], tronweb.address.toHex(fromAddress));
+    return transaction;
+}
+export async function getSetRemoteGasTx(tronweb, fromAddress, config) {
+    const igp = tronweb.contract(InterchainGasPaymasterAbi.abi, config.igpAddress);
+    const oracleAddress = tronweb.address.fromHex(await igp.gasOracle().call());
+    const { transaction } = await tronweb.transactionBuilder.triggerSmartContract(oracleAddress, 'setRemoteGasDataConfigs((uint32,uint128,uint128)[])', {}, [
+        {
+            type: 'tuple(uint32 remoteDomain, uint128 tokenExchangeRate, uint128 gasPrice)[]',
+            value: config.destinationGasConfigs.map((c) => ({
+                remoteDomain: c.remoteDomainId,
+                tokenExchangeRate: c.gasOracle.tokenExchangeRate,
+                gasPrice: c.gasOracle.gasPrice,
+            })),
+        },
+    ], tronweb.address.toHex(fromAddress));
+    return transaction;
+}
+export async function getSetIgpOwnerTx(tronweb, fromAddress, config) {
+    const { transaction } = await tronweb.transactionBuilder.triggerSmartContract(config.igpAddress, 'transferOwnership(address)', {}, [
+        {
+            type: 'address',
+            value: config.newOwner,
+        },
+    ], tronweb.address.toHex(fromAddress));
+    return transaction;
+}
+export async function getSetIgpDestinationGasConfigTx(tronweb, fromAddress, config) {
+    const igp = tronweb.contract(InterchainGasPaymasterAbi.abi, config.igpAddress);
+    const hookType = await igp.hookType().call();
+    assert(Number(hookType) === 4, `hook type does not equal INTERCHAIN_GAS_PAYMASTER`);
+    const gasOracle = await igp.gasOracle().call();
+    const { transaction } = await tronweb.transactionBuilder.triggerSmartContract(config.igpAddress, 'setDestinationGasConfigs((uint32,(address,uint96))[])', {}, [
+        {
+            type: 'tuple(uint32 remoteDomain, tuple(address gasOracle, uint96 gasOverhead) config)[]',
+            value: config.destinationGasConfigs.map((c) => ({
+                remoteDomain: c.remoteDomainId,
+                config: {
+                    gasOracle: gasOracle.replace('41', '0x'), // tron address format requires 0x prefix here
+                    gasOverhead: c.gasOverhead,
+                },
+            })),
+        },
+    ], tronweb.address.toHex(fromAddress));
+    return transaction;
+}
+export async function getRemoveIgpDestinationGasConfigTx(tronweb, fromAddress, config) {
+    const { transaction } = await tronweb.transactionBuilder.triggerSmartContract(config.igpAddress, 'removeDestinationGasConfigs(uint32[])', {}, [
+        {
+            type: 'uint32[]',
+            value: config.remoteDomainIds,
+        },
+    ], tronweb.address.toHex(fromAddress));
+    return transaction;
+}
+//# sourceMappingURL=hook-tx.js.map

package/dist/hook/hook-tx.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './ethers/index.js';
+export * from './factories/index.js';
+export { TronProvider } from './clients/provider.js';
+export { TronSigner } from './clients/signer.js';
+export { TronProtocolProvider } from './clients/protocol.js';
+export { TronReceipt } from './utils/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Ethers-compatible adapters (primary interface)
+export * from './ethers/index.js';
+// Contract factories (typechain re-exports)
+export * from './factories/index.js';
+// AltVM clients (provider-sdk pattern)
+export { TronProvider } from './clients/provider.js';
+export { TronSigner } from './clients/signer.js';
+export { TronProtocolProvider } from './clients/protocol.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,cAAc,mBAAmB,CAAC;AAElC,4CAA4C;AAC5C,cAAc,sBAAsB,CAAC;AAErC,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/ism/ism-query.d.ts

@@ -0,0 +1,70 @@
+import { TronWeb } from 'tronweb';
+import { TronIsmTypes } from '../utils/types.js';
+/**
+ * Type alias for query client with ISM extension.
+ * Used throughout ISM readers to ensure type safety.
+ */
+export type TronIsmQueryClient = TronWeb;
+/**
+ * Query ISM type from address.
+ *
+ * @param query - Query client
+ * @param ismAddress - Address of the ISM to query
+ * @returns The AltVM ISM type
+ * @throws Error if ISM not found or unknown type
+ */
+export declare function getIsmType(query: TronIsmQueryClient, ismAddress: string): Promise<TronIsmTypes>;
+/**
+ * Query NoopIsm configuration.
+ *
+ * @param query - Query client
+ * @param ismAddress - Address of the NoopIsm to query
+ * @returns NoopIsm configuration with address
+ * @throws Error if NoopIsm not found
+ */
+export declare function getNoopIsmConfig(query: TronIsmQueryClient, ismAddress: string): Promise<{
+    address: string;
+}>;
+/**
+ * Query Message ID Multisig ISM configuration.
+ *
+ * @param query - Query client
+ * @param ismAddress - Address of the Message ID Multisig ISM to query
+ * @returns Message ID Multisig ISM configuration with address, validators, and threshold
+ * @throws Error if Message ID Multisig ISM not found
+ */
+export declare function getMessageIdMultisigIsmConfig(query: TronIsmQueryClient, ismAddress: string): Promise<{
+    address: string;
+    validators: string[];
+    threshold: number;
+}>;
+/**
+ * Query Merkle Root Multisig ISM configuration.
+ *
+ * @param query - Query client
+ * @param ismAddress - Address of the Merkle Root Multisig ISM to query
+ * @returns Merkle Root Multisig ISM configuration with address, validators, and threshold
+ * @throws Error if Merkle Root Multisig ISM not found
+ */
+export declare function getMerkleRootMultisigIsmConfig(query: TronIsmQueryClient, ismAddress: string): Promise<{
+    address: string;
+    validators: string[];
+    threshold: number;
+}>;
+/**
+ * Query routing ISM configuration.
+ *
+ * @param query - Query client
+ * @param ismAddress - Address of the routing ISM to query
+ * @returns Routing ISM configuration with address, owner, and routes
+ * @throws Error if routing ISM not found
+ */
+export declare function getRoutingIsmConfig(query: TronIsmQueryClient, ismAddress: string): Promise<{
+    address: string;
+    owner: string;
+    routes: Array<{
+        domainId: number;
+        ismAddress: string;
+    }>;
+}>;
+//# sourceMappingURL=ism-query.d.ts.map

package/dist/ism/ism-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ism-query.d.ts","sourceRoot":"","sources":["../../src/ism/ism-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAUlC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEzC;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CA0BvB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAe9B;AAED;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAqBD;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAqBD;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,CAAC,CA4BD"}