@across-protocol/sdk 4.3.136 → 4.3.137-alpha.0

package/dist/cjs/src/utils/TypeGuards.d.ts

@@ -1,6 +1,8 @@
 import { SVMProvider } from "../arch/svm/types";
 import { EvmProvider } from "../arch/evm/types";
+import { TronWeb } from "tronweb";
 export declare function isPromiseFulfilled<T>(promiseSettledResult: PromiseSettledResult<T>): promiseSettledResult is PromiseFulfilledResult<T>;
 export declare function isPromiseRejected<T>(promiseSettledResult: PromiseSettledResult<T>): promiseSettledResult is PromiseRejectedResult;
 export declare function isDefined<T>(input: T | null | undefined): input is T;
-export declare function isEvmProvider(provider: EvmProvider | SVMProvider): provider is EvmProvider;
+export declare function isTvmProvider(provider: EvmProvider | SVMProvider | TronWeb): provider is TronWeb;
+export declare function isEvmProvider(provider: EvmProvider | SVMProvider | TronWeb): provider is EvmProvider;

package/dist/cjs/src/utils/TypeGuards.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPromiseFulfilled = isPromiseFulfilled;
 exports.isPromiseRejected = isPromiseRejected;
 exports.isDefined = isDefined;
+exports.isTvmProvider = isTvmProvider;
 exports.isEvmProvider = isEvmProvider;
 var ethers_1 = require("ethers");
 function isPromiseFulfilled(promiseSettledResult) {
@@ -14,6 +15,10 @@ function isPromiseRejected(promiseSettledResult) {
 function isDefined(input) {
     return input !== null && input !== undefined;
 }
+function isTvmProvider(provider) {
+    var _a;
+    return typeof ((_a = provider === null || provider === void 0 ? void 0 : provider.trx) === null || _a === void 0 ? void 0 : _a.getEnergyPrices) === "function";
+}
 function isEvmProvider(provider) {
     return provider instanceof ethers_1.providers.Provider;
 }

package/dist/cjs/src/utils/TypeGuards.js.map

@@ -1 +1 @@
-{"version":3,"file":"TypeGuards.js","sourceRoot":"","sources":["../../../../src/utils/TypeGuards.ts"],"names":[],"mappings":";;AAIA,gDAIC;AAED,8CAIC;AAED,8BAEC;AAED,sCAEC;AApBD,iCAAmC;AAEnC,SAAgB,kBAAkB,CAChC,oBAA6C;IAE7C,OAAO,oBAAoB,CAAC,MAAM,KAAK,WAAW,CAAC;AACrD,CAAC;AAED,SAAgB,iBAAiB,CAC/B,oBAA6C;IAE7C,OAAO,oBAAoB,CAAC,MAAM,KAAK,UAAU,CAAC;AACpD,CAAC;AAED,SAAgB,SAAS,CAAI,KAA2B;IACtD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,SAAgB,aAAa,CAAC,QAAmC;IAC/D,OAAO,QAAQ,YAAY,kBAAS,CAAC,QAAQ,CAAC;AAChD,CAAC"}
+{"version":3,"file":"TypeGuards.js","sourceRoot":"","sources":["../../../../src/utils/TypeGuards.ts"],"names":[],"mappings":";;AAKA,gDAIC;AAED,8CAIC;AAED,8BAEC;AAED,sCAEC;AAED,sCAEC;AAzBD,iCAAmC;AAGnC,SAAgB,kBAAkB,CAChC,oBAA6C;IAE7C,OAAO,oBAAoB,CAAC,MAAM,KAAK,WAAW,CAAC;AACrD,CAAC;AAED,SAAgB,iBAAiB,CAC/B,oBAA6C;IAE7C,OAAO,oBAAoB,CAAC,MAAM,KAAK,UAAU,CAAC;AACpD,CAAC;AAED,SAAgB,SAAS,CAAI,KAA2B;IACtD,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,SAAgB,aAAa,CAAC,QAA6C;;IACzE,OAAO,OAAO,CAAA,MAAC,QAAoB,aAApB,QAAQ,uBAAR,QAAQ,CAAc,GAAG,0CAAE,eAAe,CAAA,KAAK,UAAU,CAAC;AAC3E,CAAC;AAED,SAAgB,aAAa,CAAC,QAA6C;IACzE,OAAO,QAAQ,YAAY,kBAAS,CAAC,QAAQ,CAAC;AAChD,CAAC"}

package/dist/esm/src/arch/evm/UpgradeUtils.d.ts

@@ -0,0 +1,9 @@
+import { Contract } from "ethers";
+/**
+ * Query for EIP-1967 contract upgrade events.
+ * @param contract A contract instance (must be a UUPS or transparent proxy that emits the Upgraded event).
+ * @param startBlock Optional start of the block range (inclusive). Defaults to 0.
+ * @param endBlock Optional end of the block range (inclusive). Defaults to latest.
+ * @returns An array of block numbers at which upgrades occurred, sorted ascending.
+ */
+export declare function get1967Upgrades(contract: Contract, startBlock?: number, endBlock?: number): Promise<number[]>;

package/dist/esm/src/arch/evm/UpgradeUtils.js

@@ -0,0 +1,37 @@
+import { __awaiter, __generator } from "tslib";
+import { paginatedEventQuery } from "../../utils";
+/**
+ * Query for EIP-1967 contract upgrade events.
+ * @param contract A contract instance (must be a UUPS or transparent proxy that emits the Upgraded event).
+ * @param startBlock Optional start of the block range (inclusive). Defaults to 0.
+ * @param endBlock Optional end of the block range (inclusive). Defaults to latest.
+ * @returns An array of block numbers at which upgrades occurred, sorted ascending.
+ */
+export function get1967Upgrades(contract, startBlock, endBlock) {
+    return __awaiter(this, void 0, void 0, function () {
+        var from, to, _a, events;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    from = startBlock !== null && startBlock !== void 0 ? startBlock : 0;
+                    if (!(endBlock !== null && endBlock !== void 0)) return [3 /*break*/, 1];
+                    _a = endBlock;
+                    return [3 /*break*/, 3];
+                case 1: return [4 /*yield*/, contract.provider.getBlockNumber()];
+                case 2:
+                    _a = (_b.sent());
+                    _b.label = 3;
+                case 3:
+                    to = _a;
+                    return [4 /*yield*/, paginatedEventQuery(contract, contract.filters.Upgraded(), { from: from, to: to })];
+                case 4:
+                    events = _b.sent();
+                    return [2 /*return*/, events.map(function (_a) {
+                            var blockNumber = _a.blockNumber;
+                            return blockNumber;
+                        })];
+            }
+        });
+    });
+}
+//# sourceMappingURL=UpgradeUtils.js.map

package/dist/esm/src/arch/evm/UpgradeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpgradeUtils.js","sourceRoot":"","sources":["../../../../../src/arch/evm/UpgradeUtils.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAgB,eAAe,CAAC,QAAkB,EAAE,UAAmB,EAAE,QAAiB;;;;;;oBACxF,IAAI,GAAG,UAAU,aAAV,UAAU,cAAV,UAAU,GAAI,CAAC,CAAC;0BAClB,QAAQ,aAAR,QAAQ;oBAAR,KAAA,QAAQ,CAAA;;wBAAK,qBAAM,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAA;;oBAAzC,KAAA,CAAC,SAAwC,CAAC,CAAA;;;oBAA3D,EAAE,KAAyD;oBAElD,qBAAM,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,MAAA,EAAE,EAAE,IAAA,EAAE,CAAC,EAAA;;oBAAvF,MAAM,GAAG,SAA8E;oBAE7F,sBAAO,MAAM,CAAC,GAAG,CAAC,UAAC,EAAe;gCAAb,WAAW,iBAAA;4BAAO,OAAA,WAAW;wBAAX,CAAW,CAAC,EAAC;;;;CACrD"}

package/dist/esm/src/arch/evm/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./SpokeUtils";
 export * from "./BlockUtils";
+export * from "./UpgradeUtils";
 export * from "./utils";
 export * from "./MessageUtils";

package/dist/esm/src/arch/evm/index.js

@@ -1,5 +1,6 @@
 export * from "./SpokeUtils";
 export * from "./BlockUtils";
+export * from "./UpgradeUtils";
 export * from "./utils";
 export * from "./MessageUtils";
 //# sourceMappingURL=index.js.map

package/dist/esm/src/arch/evm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/arch/evm/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/arch/evm/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC"}

package/dist/esm/src/arch/index.d.ts

@@ -1,2 +1,3 @@
 export * as evm from "./evm";
 export * as svm from "./svm";
+export * as tvm from "./tvm";

package/dist/esm/src/arch/index.js

@@ -2,4 +2,6 @@ import * as evm_1 from "./evm";
 export { evm_1 as evm };
 import * as svm_1 from "./svm";
 export { svm_1 as svm };
+import * as tvm_1 from "./tvm";
+export { tvm_1 as tvm };
 //# sourceMappingURL=index.js.map

package/dist/esm/src/arch/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/arch/index.ts"],"names":[],"mappings":"uBAAqB,OAAO;kBAAhB,GAAG;uBACM,OAAO;kBAAhB,GAAG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/arch/index.ts"],"names":[],"mappings":"uBAAqB,OAAO;kBAAhB,GAAG;uBACM,OAAO;kBAAhB,GAAG;uBACM,OAAO;kBAAhB,GAAG"}

package/dist/esm/src/arch/tvm/BlockUtils.d.ts

@@ -0,0 +1 @@
+export { averageBlockTime, EVMBlockFinder as TVMBlockFinder } from "../evm/BlockUtils";

package/dist/esm/src/arch/tvm/BlockUtils.js

@@ -0,0 +1,2 @@
+export { averageBlockTime, EVMBlockFinder as TVMBlockFinder } from "../evm/BlockUtils";
+//# sourceMappingURL=BlockUtils.js.map

package/dist/esm/src/arch/tvm/BlockUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockUtils.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/BlockUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/src/arch/tvm/MessageUtils.d.ts

@@ -0,0 +1 @@
+export * from "../evm/MessageUtils";

package/dist/esm/src/arch/tvm/MessageUtils.js

@@ -0,0 +1,2 @@
+export * from "../evm/MessageUtils";
+//# sourceMappingURL=MessageUtils.js.map

package/dist/esm/src/arch/tvm/MessageUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageUtils.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/MessageUtils.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/esm/src/arch/tvm/ResourceUtils.d.ts

@@ -0,0 +1,32 @@
+import { TronWeb } from "tronweb";
+import type { ContractFunctionParameter } from "tronweb/lib/esm/types/TransactionBuilder";
+export interface TronResourceEstimate {
+    energyRequired: number;
+    /** Recommended feeLimit in SUN (1 TRX = 1,000,000 SUN). */
+    feeLimit: number;
+}
+export interface TronAccountResources {
+    freeNetLimit: number;
+    freeNetUsed: number;
+    energyLimit: number;
+    energyUsed: number;
+}
+/**
+ * Estimate the energy cost and recommended feeLimit for a smart contract call.
+ *
+ * @param tronWeb An authenticated TronWeb instance.
+ * @param contractAddress The target contract address (EVM hex or TRON Base58 format).
+ * @param functionSelector The Solidity function selector (e.g., "transfer(address,uint256)").
+ * @param parameters The function parameters in TronWeb's ContractFunctionParameter format.
+ * @param ownerAddress The address that will execute the transaction (EVM hex or TRON Base58).
+ * @returns The estimated energy required and recommended feeLimit in SUN.
+ */
+export declare function estimateTransactionFee(tronWeb: TronWeb, contractAddress: string, functionSelector: string, parameters: ContractFunctionParameter[], ownerAddress: string): Promise<TronResourceEstimate>;
+/**
+ * Query the current resource allocation and usage for an account.
+ *
+ * @param tronWeb A TronWeb instance.
+ * @param address The account address (EVM hex or TRON Base58 format).
+ * @returns The account's bandwidth and energy limits and usage.
+ */
+export declare function getAccountResources(tronWeb: TronWeb, address: string): Promise<TronAccountResources>;

package/dist/esm/src/arch/tvm/ResourceUtils.js

@@ -0,0 +1,88 @@
+import { __awaiter, __generator } from "tslib";
+import { evmToTronAddress } from "./utils/address";
+// Safety multiplier applied to the estimated fee limit (1.2x).
+var FEE_LIMIT_MULTIPLIER = 1.2;
+/**
+ * Query the current energy price in SUN per unit of energy.
+ * @param tronWeb A TronWeb instance.
+ * @returns The current energy price in SUN.
+ */
+function getEnergyPrice(tronWeb) {
+    return __awaiter(this, void 0, void 0, function () {
+        var pricesStr, entries, lastEntry, price;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, tronWeb.trx.getEnergyPrices()];
+                case 1:
+                    pricesStr = _a.sent();
+                    entries = pricesStr.split(",");
+                    lastEntry = entries[entries.length - 1];
+                    price = Number(lastEntry.split(":")[1]);
+                    if (!Number.isFinite(price) || price <= 0) {
+                        throw new Error("getEnergyPrice: unexpected energy price: ".concat(lastEntry));
+                    }
+                    return [2 /*return*/, price];
+            }
+        });
+    });
+}
+/**
+ * Estimate the energy cost and recommended feeLimit for a smart contract call.
+ *
+ * @param tronWeb An authenticated TronWeb instance.
+ * @param contractAddress The target contract address (EVM hex or TRON Base58 format).
+ * @param functionSelector The Solidity function selector (e.g., "transfer(address,uint256)").
+ * @param parameters The function parameters in TronWeb's ContractFunctionParameter format.
+ * @param ownerAddress The address that will execute the transaction (EVM hex or TRON Base58).
+ * @returns The estimated energy required and recommended feeLimit in SUN.
+ */
+export function estimateTransactionFee(tronWeb, contractAddress, functionSelector, parameters, ownerAddress) {
+    return __awaiter(this, void 0, void 0, function () {
+        var tronContractAddress, tronOwnerAddress, _a, estimate, energyPrice, energyRequired, feeLimit;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    tronContractAddress = contractAddress.startsWith("0x") ? evmToTronAddress(contractAddress) : contractAddress;
+                    tronOwnerAddress = ownerAddress.startsWith("0x") ? evmToTronAddress(ownerAddress) : ownerAddress;
+                    return [4 /*yield*/, Promise.all([
+                            tronWeb.transactionBuilder.estimateEnergy(tronContractAddress, functionSelector, {}, parameters, tronOwnerAddress),
+                            getEnergyPrice(tronWeb),
+                        ])];
+                case 1:
+                    _a = _b.sent(), estimate = _a[0], energyPrice = _a[1];
+                    energyRequired = estimate.energy_required;
+                    feeLimit = Math.ceil(energyRequired * energyPrice * FEE_LIMIT_MULTIPLIER);
+                    return [2 /*return*/, { energyRequired: energyRequired, feeLimit: feeLimit }];
+            }
+        });
+    });
+}
+/**
+ * Query the current resource allocation and usage for an account.
+ *
+ * @param tronWeb A TronWeb instance.
+ * @param address The account address (EVM hex or TRON Base58 format).
+ * @returns The account's bandwidth and energy limits and usage.
+ */
+export function getAccountResources(tronWeb, address) {
+    return __awaiter(this, void 0, void 0, function () {
+        var tronAddress, resources;
+        var _a, _b, _c, _d;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    tronAddress = address.startsWith("0x") ? evmToTronAddress(address) : address;
+                    return [4 /*yield*/, tronWeb.trx.getAccountResources(tronAddress)];
+                case 1:
+                    resources = _e.sent();
+                    return [2 /*return*/, {
+                            freeNetLimit: (_a = resources.freeNetLimit) !== null && _a !== void 0 ? _a : 0,
+                            freeNetUsed: (_b = resources.freeNetUsed) !== null && _b !== void 0 ? _b : 0,
+                            energyLimit: (_c = resources.NetLimit) !== null && _c !== void 0 ? _c : 0,
+                            energyUsed: (_d = resources.NetUsed) !== null && _d !== void 0 ? _d : 0,
+                        }];
+            }
+        });
+    });
+}
+//# sourceMappingURL=ResourceUtils.js.map

package/dist/esm/src/arch/tvm/ResourceUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceUtils.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/ResourceUtils.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAenD,+DAA+D;AAC/D,IAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC;;;;GAIG;AACH,SAAe,cAAc,CAAC,OAAgB;;;;;wBAG1B,qBAAM,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAA;;oBAA/C,SAAS,GAAG,SAAmC;oBAC/C,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC/B,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBACxC,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAE9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;wBAC1C,MAAM,IAAI,KAAK,CAAC,mDAA4C,SAAS,CAAE,CAAC,CAAC;oBAC3E,CAAC;oBAED,sBAAO,KAAK,EAAC;;;;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,UAAgB,sBAAsB,CAC1C,OAAgB,EAChB,eAAuB,EACvB,gBAAwB,EACxB,UAAuC,EACvC,YAAoB;;;;;;oBAGd,mBAAmB,GAAG,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;oBAC7G,gBAAgB,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;oBAEvE,qBAAM,OAAO,CAAC,GAAG,CAAC;4BAChD,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,EAAE,EAAE,UAAU,EAAE,gBAAgB,CAAC;4BAClH,cAAc,CAAC,OAAO,CAAC;yBACxB,CAAC,EAAA;;oBAHI,KAA0B,SAG9B,EAHK,QAAQ,QAAA,EAAE,WAAW,QAAA;oBAKtB,cAAc,GAAG,QAAQ,CAAC,eAAe,CAAC;oBAG1C,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,WAAW,GAAG,oBAAoB,CAAC,CAAC;oBAEhF,sBAAO,EAAE,cAAc,gBAAA,EAAE,QAAQ,UAAA,EAAE,EAAC;;;;CACrC;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,mBAAmB,CAAC,OAAgB,EAAE,OAAe;;;;;;;oBACnE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;oBACjE,qBAAM,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAA;;oBAA9D,SAAS,GAAG,SAAkD;oBAEpE,sBAAO;4BACL,YAAY,EAAE,MAAA,SAAS,CAAC,YAAY,mCAAI,CAAC;4BACzC,WAAW,EAAE,MAAA,SAAS,CAAC,WAAW,mCAAI,CAAC;4BACvC,WAAW,EAAE,MAAA,SAAS,CAAC,QAAQ,mCAAI,CAAC;4BACpC,UAAU,EAAE,MAAA,SAAS,CAAC,OAAO,mCAAI,CAAC;yBACnC,EAAC;;;;CACH"}

package/dist/esm/src/arch/tvm/SpokeUtils.d.ts

@@ -0,0 +1,48 @@
+import { Contract, providers } from "ethers";
+import { FillStatus, FillWithBlock, RelayData } from "../../interfaces";
+import { BigNumber } from "../../utils";
+type BlockTag = providers.BlockTag;
+export { populateV3Relay, getTimestampForBlock, fillStatusArray } from "../evm/SpokeUtils";
+/**
+ * @notice Retrieve the on-chain time at a specific block number.
+ * TRON does not support historical eth_call so block timestamps are used
+ * instead of SpokePool.getCurrentTime(). In production these are equivalent.
+ */
+export declare function getTimeAt(spokePool: Contract, blockNumber: number): Promise<number>;
+/**
+ * @notice Return the maximum fill deadline buffer across a block range.
+ * TRON does not support historical eth_call, so we read the current value.
+ * If a contract upgrade (EIP-1967 Upgraded event) occurred within the range,
+ * the value may have changed at the upgrade boundary. In that case, return
+ * the greater of the current value and a conservative 6-hour fallback.
+ */
+export declare function getMaxFillDeadlineInRange(spokePool: Contract, startBlock: number, endBlock: number): Promise<number>;
+/**
+ * @notice Not supported on TVM — callers should use findDepositBlock instead.
+ */
+export declare function getDepositIdAtBlock(_contract: Contract, _blockTag: number): Promise<BigNumber>;
+/**
+ * @notice Find the block at which a deposit was created.
+ * TRON does not support historical eth_call, so event queries replace the
+ * EVM binary-search over numberOfDeposits().
+ */
+export declare function findDepositBlock(spokePool: Contract, depositId: BigNumber, lowBlock: number, highBlock?: number): Promise<number | undefined>;
+/**
+ * @notice Determine the fill status of a relay at a given block.
+ * For "latest" queries, delegates to the EVM implementation (TRON's
+ * eth_call works normally for "latest"). For historical queries the
+ * status is reconstructed from on-chain events because TRON does not
+ * support eth_call with historical blockTags.
+ */
+export declare function relayFillStatus(spokePool: Contract, relayData: RelayData, blockTag?: BlockTag, destinationChainId?: number): Promise<FillStatus>;
+/**
+ * @notice Find the block at which a fill was completed.
+ * TRON does not support historical eth_call, so event queries replace the
+ * EVM binary-search over fillStatuses().
+ */
+export declare function findFillBlock(spokePool: Contract, relayData: RelayData, lowBlockNumber: number, highBlockNumber?: number): Promise<number | undefined>;
+/**
+ * @notice Find the fill event for a deposit.
+ * Queries fill events directly rather than binary-searching then re-querying.
+ */
+export declare function findFillEvent(spokePool: Contract, relayData: RelayData, lowBlockNumber: number, highBlockNumber?: number): Promise<FillWithBlock | undefined>;

package/dist/esm/src/arch/tvm/SpokeUtils.js

@@ -0,0 +1,237 @@
+import { __awaiter, __generator } from "tslib";
+import assert from "assert";
+import { CHAIN_IDs } from "../../constants";
+import { FillStatus } from "../../interfaces";
+import { get1967Upgrades } from "../evm/UpgradeUtils";
+import { relayFillStatus as evmRelayFillStatus } from "../evm/SpokeUtils";
+import { getRelayDataHash, isDefined, isUnsafeDepositId, paginatedEventQuery, spreadEventWithBlockNumber, unpackFillEvent, } from "../../utils";
+// Re-export functions that work unchanged on TRON's JSON-RPC.
+export { populateV3Relay, getTimestampForBlock, fillStatusArray } from "../evm/SpokeUtils";
+// Local implementations for functions requiring historical eth_call,
+// which TRON does not support (only "latest" blockTag is accepted).
+/**
+ * @notice Retrieve the on-chain time at a specific block number.
+ * TRON does not support historical eth_call so block timestamps are used
+ * instead of SpokePool.getCurrentTime(). In production these are equivalent.
+ */
+export function getTimeAt(spokePool, blockNumber) {
+    return __awaiter(this, void 0, void 0, function () {
+        var block;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, spokePool.provider.getBlock(blockNumber)];
+                case 1:
+                    block = _a.sent();
+                    return [2 /*return*/, block.timestamp];
+            }
+        });
+    });
+}
+// Fallback fill deadline buffer (6 hours) used when a contract upgrade is
+// detected in the query range. An upgrade implies fillDeadlineBuffer may
+// have changed and we cannot read historical state on TRON, so we use a
+// conservative upper bound.
+var FALLBACK_FILL_DEADLINE_BUFFER = 21600; // 6 hours in seconds
+/**
+ * @notice Return the maximum fill deadline buffer across a block range.
+ * TRON does not support historical eth_call, so we read the current value.
+ * If a contract upgrade (EIP-1967 Upgraded event) occurred within the range,
+ * the value may have changed at the upgrade boundary. In that case, return
+ * the greater of the current value and a conservative 6-hour fallback.
+ */
+export function getMaxFillDeadlineInRange(spokePool, startBlock, endBlock) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, fillDeadlineBuffer, upgrades, currentBuffer;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0: return [4 /*yield*/, Promise.all([
+                        spokePool.fillDeadlineBuffer(),
+                        get1967Upgrades(spokePool, startBlock, endBlock),
+                    ])];
+                case 1:
+                    _a = _b.sent(), fillDeadlineBuffer = _a[0], upgrades = _a[1];
+                    currentBuffer = Number(fillDeadlineBuffer);
+                    if (upgrades.length > 0) {
+                        return [2 /*return*/, Math.max(currentBuffer, FALLBACK_FILL_DEADLINE_BUFFER)];
+                    }
+                    return [2 /*return*/, currentBuffer];
+            }
+        });
+    });
+}
+/**
+ * @notice Not supported on TVM — callers should use findDepositBlock instead.
+ */
+export function getDepositIdAtBlock(_contract, _blockTag) {
+    throw new Error("getDepositIdAtBlock: not supported on TVM");
+}
+/**
+ * @notice Find the block at which a deposit was created.
+ * TRON does not support historical eth_call, so event queries replace the
+ * EVM binary-search over numberOfDeposits().
+ */
+export function findDepositBlock(spokePool, depositId, lowBlock, highBlock) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, events;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    if (isUnsafeDepositId(depositId)) {
+                        throw new Error("Cannot search for depositId ".concat(depositId));
+                    }
+                    if (!(highBlock !== null && highBlock !== void 0)) return [3 /*break*/, 1];
+                    _a = highBlock;
+                    return [3 /*break*/, 3];
+                case 1: return [4 /*yield*/, spokePool.provider.getBlockNumber()];
+                case 2:
+                    _a = (highBlock = _b.sent());
+                    _b.label = 3;
+                case 3:
+                    _a;
+                    assert(highBlock > lowBlock, "Block numbers out of range (".concat(lowBlock, " >= ").concat(highBlock, ")"));
+                    return [4 /*yield*/, paginatedEventQuery(spokePool, spokePool.filters.FundsDeposited(null, null, null, null, null, depositId), { from: lowBlock, to: highBlock })];
+                case 4:
+                    events = _b.sent();
+                    if (events.length === 0) {
+                        return [2 /*return*/, undefined];
+                    }
+                    return [2 /*return*/, events[0].blockNumber];
+            }
+        });
+    });
+}
+/**
+ * @notice Determine the fill status of a relay at a given block.
+ * For "latest" queries, delegates to the EVM implementation (TRON's
+ * eth_call works normally for "latest"). For historical queries the
+ * status is reconstructed from on-chain events because TRON does not
+ * support eth_call with historical blockTags.
+ */
+export function relayFillStatus(spokePool_1, relayData_1) {
+    return __awaiter(this, arguments, void 0, function (spokePool, relayData, blockTag, destinationChainId) {
+        var _a, hash, latestStatus, _b, fromBlock, toBlock, fillEvents, slowFillEvents;
+        if (blockTag === void 0) { blockTag = "latest"; }
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    if (blockTag === "latest") {
+                        return [2 /*return*/, evmRelayFillStatus(spokePool, relayData, blockTag, destinationChainId)];
+                    }
+                    if (!(destinationChainId !== null && destinationChainId !== void 0)) return [3 /*break*/, 1];
+                    _a = destinationChainId;
+                    return [3 /*break*/, 3];
+                case 1: return [4 /*yield*/, spokePool.chainId()];
+                case 2:
+                    _a = (destinationChainId = _c.sent());
+                    _c.label = 3;
+                case 3:
+                    _a;
+                    assert(isDefined(destinationChainId));
+                    hash = getRelayDataHash(relayData, destinationChainId);
+                    _b = Number;
+                    return [4 /*yield*/, spokePool.fillStatuses(hash)];
+                case 4:
+                    latestStatus = _b.apply(void 0, [_c.sent()]);
+                    if (latestStatus === FillStatus.Unfilled) {
+                        return [2 /*return*/, FillStatus.Unfilled];
+                    }
+                    fromBlock = 0;
+                    toBlock = Number(blockTag);
+                    return [4 /*yield*/, paginatedEventQuery(spokePool, spokePool.filters.FilledRelay(null, null, null, null, null, relayData.originChainId, relayData.depositId), { from: fromBlock, to: toBlock })];
+                case 5:
+                    fillEvents = _c.sent();
+                    if (fillEvents.length > 0) {
+                        return [2 /*return*/, FillStatus.Filled];
+                    }
+                    if (!(latestStatus >= FillStatus.RequestedSlowFill)) return [3 /*break*/, 7];
+                    return [4 /*yield*/, paginatedEventQuery(spokePool, spokePool.filters.RequestedSlowFill(null, null, null, null, relayData.originChainId, relayData.depositId), { from: fromBlock, to: toBlock })];
+                case 6:
+                    slowFillEvents = _c.sent();
+                    if (slowFillEvents.length > 0) {
+                        return [2 /*return*/, FillStatus.RequestedSlowFill];
+                    }
+                    _c.label = 7;
+                case 7: return [2 /*return*/, FillStatus.Unfilled];
+            }
+        });
+    });
+}
+/**
+ * @notice Find the block at which a fill was completed.
+ * TRON does not support historical eth_call, so event queries replace the
+ * EVM binary-search over fillStatuses().
+ */
+export function findFillBlock(spokePool, relayData, lowBlockNumber, highBlockNumber) {
+    return __awaiter(this, void 0, void 0, function () {
+        var provider, _a, events;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    provider = spokePool.provider;
+                    if (!(highBlockNumber !== null && highBlockNumber !== void 0)) return [3 /*break*/, 1];
+                    _a = highBlockNumber;
+                    return [3 /*break*/, 3];
+                case 1: return [4 /*yield*/, provider.getBlockNumber()];
+                case 2:
+                    _a = (highBlockNumber = _b.sent());
+                    _b.label = 3;
+                case 3:
+                    _a;
+                    assert(highBlockNumber > lowBlockNumber, "Block numbers out of range (".concat(lowBlockNumber, " >= ").concat(highBlockNumber, ")"));
+                    return [4 /*yield*/, paginatedEventQuery(spokePool, spokePool.filters.FilledRelay(null, null, null, null, null, relayData.originChainId, relayData.depositId), { from: lowBlockNumber, to: highBlockNumber })];
+                case 4:
+                    events = _b.sent();
+                    if (events.length === 0) {
+                        return [2 /*return*/, undefined];
+                    }
+                    return [2 /*return*/, events[0].blockNumber];
+            }
+        });
+    });
+}
+/**
+ * @notice Find the fill event for a deposit.
+ * Queries fill events directly rather than binary-searching then re-querying.
+ */
+export function findFillEvent(spokePool, relayData, lowBlockNumber, highBlockNumber) {
+    return __awaiter(this, void 0, void 0, function () {
+        var provider, _a, events, event, destinationChainId, _b, _c;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
+                case 0:
+                    provider = spokePool.provider;
+                    if (!(highBlockNumber !== null && highBlockNumber !== void 0)) return [3 /*break*/, 1];
+                    _a = highBlockNumber;
+                    return [3 /*break*/, 3];
+                case 1: return [4 /*yield*/, provider.getBlockNumber()];
+                case 2:
+                    _a = (highBlockNumber = _d.sent());
+                    _d.label = 3;
+                case 3:
+                    _a;
+                    return [4 /*yield*/, paginatedEventQuery(spokePool, spokePool.filters.FilledRelay(null, null, null, null, null, relayData.originChainId, relayData.depositId), { from: lowBlockNumber, to: highBlockNumber })];
+                case 4:
+                    events = _d.sent();
+                    if (events.length === 0) {
+                        return [2 /*return*/, undefined];
+                    }
+                    event = events[0];
+                    if (!Object.values(CHAIN_IDs).includes(relayData.originChainId)) return [3 /*break*/, 6];
+                    return [4 /*yield*/, spokePool.provider.getNetwork()];
+                case 5:
+                    _b = (_d.sent()).chainId;
+                    return [3 /*break*/, 8];
+                case 6:
+                    _c = Number;
+                    return [4 /*yield*/, spokePool.chainId()];
+                case 7:
+                    _b = _c.apply(void 0, [_d.sent()]);
+                    _d.label = 8;
+                case 8:
+                    destinationChainId = _b;
+                    return [2 /*return*/, unpackFillEvent(spreadEventWithBlockNumber(event), destinationChainId)];
+            }
+        });
+    });
+}
+//# sourceMappingURL=SpokeUtils.js.map

package/dist/esm/src/arch/tvm/SpokeUtils.js.map

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

package/dist/esm/src/arch/tvm/TransactionUtils.d.ts

@@ -0,0 +1,20 @@
+import { TronWeb } from "tronweb";
+import { PopulatedTransaction } from "ethers";
+export interface TronTransactionResult {
+    txid: string;
+    result: boolean;
+}
+/**
+ * Submit a populated EVM transaction to TRON via TronWeb.
+ *
+ * The EVM `populateV3Relay()` already produces correct ABI-encoded calldata.
+ * This function extracts `to` and `data` from the PopulatedTransaction,
+ * converts the target address to TRON Base58 format, and uses TronWeb's
+ * `triggerSmartContract` → `sign` → `sendRawTransaction` pipeline.
+ *
+ * @param tronWeb An authenticated TronWeb instance (with private key set).
+ * @param populatedTx The populated transaction containing `to` and `data`.
+ * @param feeLimit The maximum TRX to burn for energy consumption, in SUN (1 TRX = 1,000,000 SUN).
+ * @returns The transaction ID and result status.
+ */
+export declare function submitTransaction(tronWeb: TronWeb, populatedTx: PopulatedTransaction, feeLimit: number): Promise<TronTransactionResult>;