@across-protocol/sdk 4.3.165 → 4.3.166

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

@@ -0,0 +1,6 @@
+import { RelayData, SpeedUpCommon } from "../../interfaces";
+import { BigNumber } from "../../utils";
+export declare function getAuxiliaryNativeTokenCost(deposit: RelayData & Partial<SpeedUpCommon> & {
+    speedUpSignature?: string;
+}): BigNumber;
+export declare const tvmBandwidthCostZero: BigNumber;

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tvmBandwidthCostZero = void 0;
+exports.getAuxiliaryNativeTokenCost = getAuxiliaryNativeTokenCost;
+const utils_1 = require("../../utils");
+const TVM_BANDWIDTH_SUN_PER_BYTE = 1000;
+const TVM_RAW_DATA_OVERHEAD_BYTES = 290;
+const TVM_FILL_RELAY_FIXED_CALLDATA_BYTES = 4 + 96 + 384 + 32;
+const TVM_SPEED_UP_FIXED_CALLDATA_EXTRA_BYTES = 128 + 32 + 32 + 96;
+function paddedMessageByteLength(message) {
+    if (!(0, utils_1.isDefined)(message) || (0, utils_1.isMessageEmpty)(message))
+        return 0;
+    const bytes = Math.max(0, Math.floor((message.length - 2) / 2));
+    return Math.ceil(bytes / 32) * 32;
+}
+function getAuxiliaryNativeTokenCost(deposit) {
+    const paddedMessageBytes = paddedMessageByteLength(deposit.message);
+    let speedUpExtraBytes = 0;
+    if ((0, utils_1.isDefined)(deposit.speedUpSignature) && deposit.speedUpSignature !== "0x") {
+        speedUpExtraBytes = TVM_SPEED_UP_FIXED_CALLDATA_EXTRA_BYTES + paddedMessageByteLength(deposit.updatedMessage);
+    }
+    const calldataBytes = TVM_FILL_RELAY_FIXED_CALLDATA_BYTES + paddedMessageBytes + speedUpExtraBytes;
+    const txBytes = TVM_RAW_DATA_OVERHEAD_BYTES + calldataBytes;
+    return (0, utils_1.toBN)(txBytes).mul(TVM_BANDWIDTH_SUN_PER_BYTE);
+}
+exports.tvmBandwidthCostZero = utils_1.bnZero;
+//# sourceMappingURL=MessageUtils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessageUtils.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/MessageUtils.ts"],"names":[],"mappings":";;;AAsDA,kEAcC;AAnED,uCAAiF;AAKjF,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAKxC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAQxC,MAAM,mCAAmC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;AAW9D,MAAM,uCAAuC,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEnE,SAAS,uBAAuB,CAAC,OAA2B;IAC1D,IAAI,CAAC,IAAA,iBAAS,EAAC,OAAO,CAAC,IAAI,IAAA,sBAAc,EAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AACpC,CAAC;AAkBD,SAAgB,2BAA2B,CACzC,OAA2E;IAE3E,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,IAAA,iBAAS,EAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC7E,iBAAiB,GAAG,uCAAuC,GAAG,uBAAuB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,aAAa,GAAG,mCAAmC,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;IACnG,MAAM,OAAO,GAAG,2BAA2B,GAAG,aAAa,CAAC;IAE5D,OAAO,IAAA,YAAI,EAAC,OAAO,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACvD,CAAC;AAGY,QAAA,oBAAoB,GAAG,cAAM,CAAC"}

package/dist/cjs/src/arch/tvm/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./SpokeUtils";
 export * from "./TransactionUtils";
+export * from "./MessageUtils";

package/dist/cjs/src/arch/tvm/index.js

@@ -3,4 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./SpokeUtils"), exports);
 tslib_1.__exportStar(require("./TransactionUtils"), exports);
+tslib_1.__exportStar(require("./MessageUtils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/src/arch/tvm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,6DAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,6DAAmC;AACnC,yDAA+B"}

package/dist/cjs/src/relayFeeCalculator/chain-queries/factory.js

@@ -12,6 +12,7 @@ const baseQuery_1 = require("./baseQuery");
 const relayFeeCalculator_1 = require("../relayFeeCalculator");
 const customGasToken_1 = require("./customGasToken");
 const svmQuery_1 = require("./svmQuery");
+const tvmQuery_1 = require("./tvmQuery");
 const fixedGasPrice = {
     [constants_1.CHAIN_IDs.BOBA]: 1e9,
 };
@@ -21,7 +22,8 @@ class QueryBase__factory {
         const customGasTokenSymbol = constants_2.CUSTOM_GAS_TOKENS[chainId];
         if ((0, utils_1.chainIsEvm)(chainId) && (0, utils_1.isDefined)(customGasTokenSymbol)) {
             (0, assert_1.default)(relayerAddress.isEVM());
-            return new customGasToken_1.CustomGasTokenQueries({
+            const QueryCtor = (0, utils_1.chainIsTvm)(chainId) ? tvmQuery_1.TvmQuery : customGasToken_1.CustomGasTokenQueries;
+            return new QueryCtor({
                 queryBaseArgs: [
                     provider,
                     symbolMapping,

package/dist/cjs/src/relayFeeCalculator/chain-queries/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/factory.ts"],"names":[],"mappings":";;;;AAAA,4DAA4B;AAC5B,0DAA0E;AAC1E,0DAAgE;AAChE,2CAAiD;AAEjD,+CAAoD;AACpD,uCAA4F;AAC5F,2CAAwC;AAExC,8DAAkF;AAClF,qDAAyD;AACzD,yCAAsC;AAMtC,MAAM,aAAa,GAAG;IACpB,CAAC,qBAAS,CAAC,IAAI,CAAC,EAAE,GAAG;CACtB,CAAC;AAEF,MAAa,kBAAkB;IAC7B,MAAM,CAAC,MAAM,CACX,OAAe,EACf,QAA0C,EAC1C,aAAa,GAAG,6BAAiB,EACjC,gBAAgB,GAAG,IAAA,8BAAkB,EAAC,WAAW,EAAE,OAAO,CAAC,EAC3D,cAAc,GAAG,IAAA,sCAAiB,EAAC,OAAO,CAAC,EAC3C,kBAA2B,EAC3B,SAAiB,mCAAc,EAC/B,qBAAqB,GAAG,KAAK;QAE7B,IAAA,gBAAM,EAAC,IAAA,iBAAS,EAAC,gBAAgB,CAAC,CAAC,CAAC;QAEpC,MAAM,oBAAoB,GAAG,6BAAiB,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,IAAA,kBAAU,EAAC,OAAO,CAAC,IAAI,IAAA,iBAAS,EAAC,oBAAoB,CAAC,EAAE,CAAC;YAC3D,IAAA,gBAAM,EAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,sCAAqB,CAAC;gBAC/B,aAAa,EAAE;oBACb,QAA8B;oBAC9B,aAAa;oBACb,gBAAgB;oBAChB,cAAc;oBACd,MAAM;oBACN,kBAAkB;oBAClB,aAAa,CAAC,OAAO,CAAC;oBACtB,KAAK;iBACN;gBACD,oBAAoB;aACrB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAA,kBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAA,gBAAM,EAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,mBAAQ,CACjB,QAAuB,EACvB,aAAa,EACb,kBAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,EACjC,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;QACJ,CAAC;QAGD,QAAQ,GAAG,IAAA,sBAAc,EAAC,OAAO,CAAC;YAChC,CAAC,CAAC,IAAA,kBAAY,EAAC,QAA8B,CAAC;YAC9C,CAAC,CAAE,QAA+B,CAAC;QAErC,IAAA,gBAAM,EAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,OAAO,IAAI,qBAAS,CAClB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;IACJ,CAAC;CACF;AA7DD,gDA6DC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/factory.ts"],"names":[],"mappings":";;;;AAAA,4DAA4B;AAC5B,0DAA0E;AAC1E,0DAAgE;AAChE,2CAAiD;AAEjD,+CAAoD;AACpD,uCAAwG;AACxG,2CAAwC;AAExC,8DAAkF;AAClF,qDAAyD;AACzD,yCAAsC;AACtC,yCAAsC;AAMtC,MAAM,aAAa,GAAG;IACpB,CAAC,qBAAS,CAAC,IAAI,CAAC,EAAE,GAAG;CACtB,CAAC;AAEF,MAAa,kBAAkB;IAC7B,MAAM,CAAC,MAAM,CACX,OAAe,EACf,QAA0C,EAC1C,aAAa,GAAG,6BAAiB,EACjC,gBAAgB,GAAG,IAAA,8BAAkB,EAAC,WAAW,EAAE,OAAO,CAAC,EAC3D,cAAc,GAAG,IAAA,sCAAiB,EAAC,OAAO,CAAC,EAC3C,kBAA2B,EAC3B,SAAiB,mCAAc,EAC/B,qBAAqB,GAAG,KAAK;QAE7B,IAAA,gBAAM,EAAC,IAAA,iBAAS,EAAC,gBAAgB,CAAC,CAAC,CAAC;QAEpC,MAAM,oBAAoB,GAAG,6BAAiB,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,IAAA,kBAAU,EAAC,OAAO,CAAC,IAAI,IAAA,iBAAS,EAAC,oBAAoB,CAAC,EAAE,CAAC;YAC3D,IAAA,gBAAM,EAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAK/B,MAAM,SAAS,GAAG,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAQ,CAAC,CAAC,CAAC,sCAAqB,CAAC;YACzE,OAAO,IAAI,SAAS,CAAC;gBACnB,aAAa,EAAE;oBACb,QAA8B;oBAC9B,aAAa;oBACb,gBAAgB;oBAChB,cAAc;oBACd,MAAM;oBACN,kBAAkB;oBAClB,aAAa,CAAC,OAAO,CAAC;oBACtB,KAAK;iBACN;gBACD,oBAAoB;aACrB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAA,kBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAA,gBAAM,EAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,mBAAQ,CACjB,QAAuB,EACvB,aAAa,EACb,kBAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,EACjC,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;QACJ,CAAC;QAGD,QAAQ,GAAG,IAAA,sBAAc,EAAC,OAAO,CAAC;YAChC,CAAC,CAAC,IAAA,kBAAY,EAAC,QAA8B,CAAC;YAC9C,CAAC,CAAE,QAA+B,CAAC;QAErC,IAAA,gBAAM,EAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,OAAO,IAAI,qBAAS,CAClB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;IACJ,CAAC;CACF;AAlED,gDAkEC"}

package/dist/cjs/src/relayFeeCalculator/chain-queries/index.d.ts

@@ -2,3 +2,4 @@ export * from "./baseQuery";
 export * from "./factory";
 export * from "./customGasToken";
 export * from "./svmQuery";
+export * from "./tvmQuery";

package/dist/cjs/src/relayFeeCalculator/chain-queries/index.js

@@ -5,4 +5,5 @@ tslib_1.__exportStar(require("./baseQuery"), exports);
 tslib_1.__exportStar(require("./factory"), exports);
 tslib_1.__exportStar(require("./customGasToken"), exports);
 tslib_1.__exportStar(require("./svmQuery"), exports);
+tslib_1.__exportStar(require("./tvmQuery"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/src/relayFeeCalculator/chain-queries/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,oDAA0B;AAC1B,2DAAiC;AACjC,qDAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,oDAA0B;AAC1B,2DAAiC;AACjC,qDAA2B;AAC3B,qDAA2B"}

package/dist/cjs/src/relayFeeCalculator/chain-queries/tvmQuery.d.ts

@@ -0,0 +1,6 @@
+import { RelayData } from "../../interfaces";
+import { BigNumber } from "../../utils";
+import { CustomGasTokenQueries } from "./customGasToken";
+export declare class TvmQuery extends CustomGasTokenQueries {
+    getAuxiliaryNativeTokenCost(deposit: RelayData): BigNumber;
+}

package/dist/cjs/src/relayFeeCalculator/chain-queries/tvmQuery.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TvmQuery = void 0;
+const __1 = require("../..");
+const customGasToken_1 = require("./customGasToken");
+class TvmQuery extends customGasToken_1.CustomGasTokenQueries {
+    getAuxiliaryNativeTokenCost(deposit) {
+        return __1.arch.tvm.getAuxiliaryNativeTokenCost(deposit);
+    }
+}
+exports.TvmQuery = TvmQuery;
+//# sourceMappingURL=tvmQuery.js.map

package/dist/cjs/src/relayFeeCalculator/chain-queries/tvmQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tvmQuery.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/tvmQuery.ts"],"names":[],"mappings":";;;AAAA,6BAA6B;AAG7B,qDAAyD;AAYzD,MAAa,QAAS,SAAQ,sCAAqB;IACxC,2BAA2B,CAAC,OAAkB;QACrD,OAAO,QAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;CACF;AAJD,4BAIC"}

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

@@ -0,0 +1,22 @@
+import { RelayData, SpeedUpCommon } from "../../interfaces";
+import { BigNumber } from "../../utils";
+/**
+ * Estimate the bandwidth cost (in SUN) of a Tron fill for `deposit`.
+ *
+ * On Tron, transaction bytes consume bandwidth — distinct from energy (paid via the tx
+ * fee limit and modeled in `nativeGasCost`). When the relayer has no free bandwidth
+ * staked, every byte burns 1,000 SUN. For message-bearing fills this is non-trivial:
+ * the message dominates calldata size, so the cost scales linearly with message length.
+ *
+ * Sped-up deposits (those carrying a `speedUpSignature`) are filled via
+ * `fillRelayWithUpdatedDeposit`, which carries the original `V3RelayData` *and*
+ * `updatedMessage`/`speedUpSignature` as additional ABI args. Both messages are charged.
+ *
+ * The estimate is conservative — it assumes zero free bandwidth (worst case). Relayers
+ * that stake TRX for bandwidth pay 0 onchain; this still represents the true marginal
+ * cost of consuming that staked allowance.
+ */
+export declare function getAuxiliaryNativeTokenCost(deposit: RelayData & Partial<SpeedUpCommon> & {
+    speedUpSignature?: string;
+}): BigNumber;
+export declare const tvmBandwidthCostZero: BigNumber;

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

@@ -0,0 +1,61 @@
+import { bnZero, isDefined, isMessageEmpty, toBN } from "../../utils";
+// Tron prices each byte of a transaction's serialized raw_data + signature at this many
+// SUN of bandwidth when the relayer's free bandwidth allowance has been exhausted. The
+// rate is set by Tron governance; refresh from `wallet/getchainparameters` if it drifts.
+const TVM_BANDWIDTH_SUN_PER_BYTE = 1000;
+// Tron raw_data envelope (contract type, ref_block, timestamp, expiration, fee_limit)
+// plus a single ECDSA signature. Measured empirically against `fillRelay` transactions
+// emitted by the production relayer; varies by ~10 bytes between calls.
+const TVM_RAW_DATA_OVERHEAD_BYTES = 290;
+// `fillRelay(V3RelayData, uint256 repaymentChainId, bytes32 repaymentAddress)` ABI
+// encoding, excluding the `message` payload (which is dynamic).
+//   4   selector
+//  96   top-level head: offset(V3RelayData) + repaymentChainId + repaymentAddress
+// 384   V3RelayData struct head: 11 static fields inline + 1 offset(message)
+//  32   message length header
+const TVM_FILL_RELAY_FIXED_CALLDATA_BYTES = 4 + 96 + 384 + 32;
+// Extra ABI footprint when a speed-up signature is present and the relayer must call
+// `fillRelayWithUpdatedDeposit(V3RelayData, ..., uint256 updatedOutputAmount, bytes32
+// updatedRecipient, bytes updatedMessage, bytes speedUpSignature)`. The original
+// `message` still lives inside V3RelayData and is already counted above; this constant
+// captures only what's *additional* to the plain `fillRelay` encoding.
+//  128   4 extra head slots: updatedOutputAmount + updatedRecipient + offset(updatedMessage) + offset(speedUpSignature)
+//   32   updatedMessage length header (the padded body is added per-call below)
+//   32   speedUpSignature length header
+//   96   65-byte ECDSA signature padded to 3 EVM words
+const TVM_SPEED_UP_FIXED_CALLDATA_EXTRA_BYTES = 128 + 32 + 32 + 96;
+function paddedMessageByteLength(message) {
+    if (!isDefined(message) || isMessageEmpty(message))
+        return 0;
+    const bytes = Math.max(0, Math.floor((message.length - 2) / 2));
+    return Math.ceil(bytes / 32) * 32;
+}
+/**
+ * Estimate the bandwidth cost (in SUN) of a Tron fill for `deposit`.
+ *
+ * On Tron, transaction bytes consume bandwidth — distinct from energy (paid via the tx
+ * fee limit and modeled in `nativeGasCost`). When the relayer has no free bandwidth
+ * staked, every byte burns 1,000 SUN. For message-bearing fills this is non-trivial:
+ * the message dominates calldata size, so the cost scales linearly with message length.
+ *
+ * Sped-up deposits (those carrying a `speedUpSignature`) are filled via
+ * `fillRelayWithUpdatedDeposit`, which carries the original `V3RelayData` *and*
+ * `updatedMessage`/`speedUpSignature` as additional ABI args. Both messages are charged.
+ *
+ * The estimate is conservative — it assumes zero free bandwidth (worst case). Relayers
+ * that stake TRX for bandwidth pay 0 onchain; this still represents the true marginal
+ * cost of consuming that staked allowance.
+ */
+export function getAuxiliaryNativeTokenCost(deposit) {
+    const paddedMessageBytes = paddedMessageByteLength(deposit.message);
+    let speedUpExtraBytes = 0;
+    if (isDefined(deposit.speedUpSignature) && deposit.speedUpSignature !== "0x") {
+        speedUpExtraBytes = TVM_SPEED_UP_FIXED_CALLDATA_EXTRA_BYTES + paddedMessageByteLength(deposit.updatedMessage);
+    }
+    const calldataBytes = TVM_FILL_RELAY_FIXED_CALLDATA_BYTES + paddedMessageBytes + speedUpExtraBytes;
+    const txBytes = TVM_RAW_DATA_OVERHEAD_BYTES + calldataBytes;
+    return toBN(txBytes).mul(TVM_BANDWIDTH_SUN_PER_BYTE);
+}
+// Re-export so other arches can reference the zero default if needed.
+export const tvmBandwidthCostZero = bnZero;
+//# 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":"AACA,OAAO,EAAa,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEjF,wFAAwF;AACxF,uFAAuF;AACvF,yFAAyF;AACzF,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAExC,sFAAsF;AACtF,uFAAuF;AACvF,wEAAwE;AACxE,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAExC,mFAAmF;AACnF,gEAAgE;AAChE,iBAAiB;AACjB,kFAAkF;AAClF,6EAA6E;AAC7E,8BAA8B;AAC9B,MAAM,mCAAmC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;AAE9D,qFAAqF;AACrF,sFAAsF;AACtF,iFAAiF;AACjF,uFAAuF;AACvF,uEAAuE;AACvE,wHAAwH;AACxH,gFAAgF;AAChF,wCAAwC;AACxC,uDAAuD;AACvD,MAAM,uCAAuC,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEnE,SAAS,uBAAuB,CAAC,OAA2B;IAC1D,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA2E;IAE3E,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,SAAS,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC7E,iBAAiB,GAAG,uCAAuC,GAAG,uBAAuB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAChH,CAAC;IAED,MAAM,aAAa,GAAG,mCAAmC,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;IACnG,MAAM,OAAO,GAAG,2BAA2B,GAAG,aAAa,CAAC;IAE5D,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AACvD,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC"}

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

@@ -1,2 +1,3 @@
 export * from "./SpokeUtils";
 export * from "./TransactionUtils";
+export * from "./MessageUtils";

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

@@ -1,3 +1,4 @@
 export * from "./SpokeUtils";
 export * from "./TransactionUtils";
+export * from "./MessageUtils";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/arch/tvm/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/esm/src/relayFeeCalculator/chain-queries/factory.js

@@ -3,11 +3,12 @@ import { CHAIN_IDs, TOKEN_SYMBOLS_MAP } from "@across-protocol/constants";
 import { getDeployedAddress } from "@across-protocol/contracts";
 import { asL2Provider } from "@eth-optimism/sdk";
 import { CUSTOM_GAS_TOKENS } from "../../constants";
-import { chainIsEvm, chainIsOPStack, isDefined, chainIsSvm, SvmAddress } from "../../utils";
+import { chainIsEvm, chainIsOPStack, isDefined, chainIsSvm, chainIsTvm, SvmAddress } from "../../utils";
 import { QueryBase } from "./baseQuery";
 import { DEFAULT_LOGGER, getDefaultRelayer } from "../relayFeeCalculator";
 import { CustomGasTokenQueries } from "./customGasToken";
 import { SvmQuery } from "./svmQuery";
+import { TvmQuery } from "./tvmQuery";
 /**
  * Some chains have a fixed gas price that is applied to the gas estimates. We should override
  * the gas markup for these chains.
@@ -21,7 +22,12 @@ export class QueryBase__factory {
         const customGasTokenSymbol = CUSTOM_GAS_TOKENS[chainId];
         if (chainIsEvm(chainId) && isDefined(customGasTokenSymbol)) {
             assert(relayerAddress.isEVM());
-            return new CustomGasTokenQueries({
+            // TVM chains route through TvmQuery so that bandwidth — a Tron-native cost the
+            // EVM compatibility layer's `eth_estimateGas` does not surface — is included in
+            // `auxiliaryNativeTokenCost`. Otherwise fall back to the EVM-flavoured custom gas
+            // token query.
+            const QueryCtor = chainIsTvm(chainId) ? TvmQuery : CustomGasTokenQueries;
+            return new QueryCtor({
                 queryBaseArgs: [
                     provider,
                     symbolMapping,

package/dist/esm/src/relayFeeCalculator/chain-queries/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/factory.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAU,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,aAAa,GAAG;IACpB,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG;CACtB,CAAC;AAEF,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAC,MAAM,CACX,OAAe,EACf,QAA0C,EAC1C,aAAa,GAAG,iBAAiB,EACjC,gBAAgB,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,EAC3D,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAC3C,kBAA2B,EAC3B,SAAiB,cAAc,EAC/B,qBAAqB,GAAG,KAAK;QAE7B,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAEpC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,qBAAqB,CAAC;gBAC/B,aAAa,EAAE;oBACb,QAA8B;oBAC9B,aAAa;oBACb,gBAAgB;oBAChB,cAAc;oBACd,MAAM;oBACN,kBAAkB;oBAClB,aAAa,CAAC,OAAO,CAAC;oBACtB,KAAK;iBACN;gBACD,oBAAoB;aACrB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,QAAQ,CACjB,QAAuB,EACvB,aAAa,EACb,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,EACjC,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC;YAChC,CAAC,CAAC,YAAY,CAAC,QAA8B,CAAC;YAC9C,CAAC,CAAE,QAA+B,CAAC;QAErC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,OAAO,IAAI,SAAS,CAClB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/factory.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAU,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,aAAa,GAAG;IACpB,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG;CACtB,CAAC;AAEF,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAC,MAAM,CACX,OAAe,EACf,QAA0C,EAC1C,aAAa,GAAG,iBAAiB,EACjC,gBAAgB,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,EAC3D,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,EAC3C,kBAA2B,EAC3B,SAAiB,cAAc,EAC/B,qBAAqB,GAAG,KAAK;QAE7B,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAEpC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,+EAA+E;YAC/E,gFAAgF;YAChF,kFAAkF;YAClF,eAAe;YACf,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC;YACzE,OAAO,IAAI,SAAS,CAAC;gBACnB,aAAa,EAAE;oBACb,QAA8B;oBAC9B,aAAa;oBACb,gBAAgB;oBAChB,cAAc;oBACd,MAAM;oBACN,kBAAkB;oBAClB,aAAa,CAAC,OAAO,CAAC;oBACtB,KAAK;iBACN;gBACD,oBAAoB;aACrB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,QAAQ,CACjB,QAAuB,EACvB,aAAa,EACb,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,EACjC,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;QACJ,CAAC;QAED,oEAAoE;QACpE,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC;YAChC,CAAC,CAAC,YAAY,CAAC,QAA8B,CAAC;YAC9C,CAAC,CAAE,QAA+B,CAAC;QAErC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/B,OAAO,IAAI,SAAS,CAClB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,MAAM,EACN,kBAAkB,EAClB,aAAa,CAAC,OAAO,CAAC,EACtB,qBAAqB,CACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/src/relayFeeCalculator/chain-queries/index.d.ts

@@ -2,3 +2,4 @@ export * from "./baseQuery";
 export * from "./factory";
 export * from "./customGasToken";
 export * from "./svmQuery";
+export * from "./tvmQuery";

package/dist/esm/src/relayFeeCalculator/chain-queries/index.js

@@ -2,4 +2,5 @@ export * from "./baseQuery";
 export * from "./factory";
 export * from "./customGasToken";
 export * from "./svmQuery";
+export * from "./tvmQuery";
 //# sourceMappingURL=index.js.map

package/dist/esm/src/relayFeeCalculator/chain-queries/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/esm/src/relayFeeCalculator/chain-queries/tvmQuery.d.ts

@@ -0,0 +1,16 @@
+import { RelayData } from "../../interfaces";
+import { BigNumber } from "../../utils";
+import { CustomGasTokenQueries } from "./customGasToken";
+/**
+ * TVM (TRON) query implementation. Extends `CustomGasTokenQueries` to add bandwidth
+ * accounting via `getAuxiliaryNativeTokenCost`, which the base EVM path returns 0 for.
+ *
+ * Energy (Tron's analogue of gas) is already estimated by `voidSigner.estimateGas`
+ * against the EVM-compat RPC and surfaces in `tokenGasCost`. Bandwidth is a separate
+ * Tron-native resource that the EVM compatibility layer does not surface, so we
+ * estimate it here from the deposit's `message` length and a fixed `fillRelay`
+ * calldata footprint.
+ */
+export declare class TvmQuery extends CustomGasTokenQueries {
+    getAuxiliaryNativeTokenCost(deposit: RelayData): BigNumber;
+}

package/dist/esm/src/relayFeeCalculator/chain-queries/tvmQuery.js

@@ -0,0 +1,18 @@
+import { arch } from "../..";
+import { CustomGasTokenQueries } from "./customGasToken";
+/**
+ * TVM (TRON) query implementation. Extends `CustomGasTokenQueries` to add bandwidth
+ * accounting via `getAuxiliaryNativeTokenCost`, which the base EVM path returns 0 for.
+ *
+ * Energy (Tron's analogue of gas) is already estimated by `voidSigner.estimateGas`
+ * against the EVM-compat RPC and surfaces in `tokenGasCost`. Bandwidth is a separate
+ * Tron-native resource that the EVM compatibility layer does not surface, so we
+ * estimate it here from the deposit's `message` length and a fixed `fillRelay`
+ * calldata footprint.
+ */
+export class TvmQuery extends CustomGasTokenQueries {
+    getAuxiliaryNativeTokenCost(deposit) {
+        return arch.tvm.getAuxiliaryNativeTokenCost(deposit);
+    }
+}
+//# sourceMappingURL=tvmQuery.js.map

package/dist/esm/src/relayFeeCalculator/chain-queries/tvmQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tvmQuery.js","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/tvmQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAG7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,OAAO,QAAS,SAAQ,qBAAqB;IACxC,2BAA2B,CAAC,OAAkB;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+import { RelayData, SpeedUpCommon } from "../../interfaces";
+import { BigNumber } from "../../utils";
+/**
+ * Estimate the bandwidth cost (in SUN) of a Tron fill for `deposit`.
+ *
+ * On Tron, transaction bytes consume bandwidth — distinct from energy (paid via the tx
+ * fee limit and modeled in `nativeGasCost`). When the relayer has no free bandwidth
+ * staked, every byte burns 1,000 SUN. For message-bearing fills this is non-trivial:
+ * the message dominates calldata size, so the cost scales linearly with message length.
+ *
+ * Sped-up deposits (those carrying a `speedUpSignature`) are filled via
+ * `fillRelayWithUpdatedDeposit`, which carries the original `V3RelayData` *and*
+ * `updatedMessage`/`speedUpSignature` as additional ABI args. Both messages are charged.
+ *
+ * The estimate is conservative — it assumes zero free bandwidth (worst case). Relayers
+ * that stake TRX for bandwidth pay 0 onchain; this still represents the true marginal
+ * cost of consuming that staked allowance.
+ */
+export declare function getAuxiliaryNativeTokenCost(deposit: RelayData & Partial<SpeedUpCommon> & {
+    speedUpSignature?: string;
+}): BigNumber;
+export declare const tvmBandwidthCostZero: BigNumber;
+//# sourceMappingURL=MessageUtils.d.ts.map

package/dist/types/src/arch/tvm/MessageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageUtils.d.ts","sourceRoot":"","sources":["../../../../../src/arch/tvm/MessageUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAA2C,MAAM,aAAa,CAAC;AAqCjF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E,SAAS,CAYX;AAGD,eAAO,MAAM,oBAAoB,WAAS,CAAC"}

package/dist/types/src/arch/tvm/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./SpokeUtils";
 export * from "./TransactionUtils";
+export * from "./MessageUtils";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/arch/tvm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/arch/tvm/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/arch/tvm/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/types/src/relayFeeCalculator/chain-queries/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/factory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAqC,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAUtC,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,WAAW,EAC1C,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAoB,EACjC,gBAAgB,qBAA2C,EAC3D,cAAc,gCAA6B,EAC3C,kBAAkB,CAAC,EAAE,MAAM,EAC3B,MAAM,GAAE,MAAuB,EAC/B,qBAAqB,SAAQ,GAC5B,SAAS,GAAG,QAAQ;CAmDxB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/factory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAqC,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAWtC,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,MAAM,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,WAAW,EAC1C,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAoB,EACjC,gBAAgB,qBAA2C,EAC3D,cAAc,gCAA6B,EAC3C,kBAAkB,CAAC,EAAE,MAAM,EAC3B,MAAM,GAAE,MAAuB,EAC/B,qBAAqB,SAAQ,GAC5B,SAAS,GAAG,QAAQ;CAwDxB"}

package/dist/types/src/relayFeeCalculator/chain-queries/index.d.ts

@@ -2,4 +2,5 @@ export * from "./baseQuery";
 export * from "./factory";
 export * from "./customGasToken";
 export * from "./svmQuery";
+export * from "./tvmQuery";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/relayFeeCalculator/chain-queries/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/types/src/relayFeeCalculator/chain-queries/tvmQuery.d.ts

@@ -0,0 +1,17 @@
+import { RelayData } from "../../interfaces";
+import { BigNumber } from "../../utils";
+import { CustomGasTokenQueries } from "./customGasToken";
+/**
+ * TVM (TRON) query implementation. Extends `CustomGasTokenQueries` to add bandwidth
+ * accounting via `getAuxiliaryNativeTokenCost`, which the base EVM path returns 0 for.
+ *
+ * Energy (Tron's analogue of gas) is already estimated by `voidSigner.estimateGas`
+ * against the EVM-compat RPC and surfaces in `tokenGasCost`. Bandwidth is a separate
+ * Tron-native resource that the EVM compatibility layer does not surface, so we
+ * estimate it here from the deposit's `message` length and a fixed `fillRelay`
+ * calldata footprint.
+ */
+export declare class TvmQuery extends CustomGasTokenQueries {
+    getAuxiliaryNativeTokenCost(deposit: RelayData): BigNumber;
+}
+//# sourceMappingURL=tvmQuery.d.ts.map

package/dist/types/src/relayFeeCalculator/chain-queries/tvmQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tvmQuery.d.ts","sourceRoot":"","sources":["../../../../../src/relayFeeCalculator/chain-queries/tvmQuery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,qBAAqB;IACxC,2BAA2B,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS;CAGpE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@across-protocol/sdk",
   "author": "UMA Team",
-  "version": "4.3.165",
+  "version": "4.3.166",
   "license": "AGPL-3.0",
   "homepage": "https://docs.across.to/reference/sdk",
   "repository": {

package/src/arch/tvm/MessageUtils.ts

@@ -0,0 +1,72 @@
+import { RelayData, SpeedUpCommon } from "../../interfaces";
+import { BigNumber, bnZero, isDefined, isMessageEmpty, toBN } from "../../utils";
+
+// Tron prices each byte of a transaction's serialized raw_data + signature at this many
+// SUN of bandwidth when the relayer's free bandwidth allowance has been exhausted. The
+// rate is set by Tron governance; refresh from `wallet/getchainparameters` if it drifts.
+const TVM_BANDWIDTH_SUN_PER_BYTE = 1000;
+
+// Tron raw_data envelope (contract type, ref_block, timestamp, expiration, fee_limit)
+// plus a single ECDSA signature. Measured empirically against `fillRelay` transactions
+// emitted by the production relayer; varies by ~10 bytes between calls.
+const TVM_RAW_DATA_OVERHEAD_BYTES = 290;
+
+// `fillRelay(V3RelayData, uint256 repaymentChainId, bytes32 repaymentAddress)` ABI
+// encoding, excluding the `message` payload (which is dynamic).
+//   4   selector
+//  96   top-level head: offset(V3RelayData) + repaymentChainId + repaymentAddress
+// 384   V3RelayData struct head: 11 static fields inline + 1 offset(message)
+//  32   message length header
+const TVM_FILL_RELAY_FIXED_CALLDATA_BYTES = 4 + 96 + 384 + 32;
+
+// Extra ABI footprint when a speed-up signature is present and the relayer must call
+// `fillRelayWithUpdatedDeposit(V3RelayData, ..., uint256 updatedOutputAmount, bytes32
+// updatedRecipient, bytes updatedMessage, bytes speedUpSignature)`. The original
+// `message` still lives inside V3RelayData and is already counted above; this constant
+// captures only what's *additional* to the plain `fillRelay` encoding.
+//  128   4 extra head slots: updatedOutputAmount + updatedRecipient + offset(updatedMessage) + offset(speedUpSignature)
+//   32   updatedMessage length header (the padded body is added per-call below)
+//   32   speedUpSignature length header
+//   96   65-byte ECDSA signature padded to 3 EVM words
+const TVM_SPEED_UP_FIXED_CALLDATA_EXTRA_BYTES = 128 + 32 + 32 + 96;
+
+function paddedMessageByteLength(message: string | undefined): number {
+  if (!isDefined(message) || isMessageEmpty(message)) return 0;
+  const bytes = Math.max(0, Math.floor((message.length - 2) / 2));
+  return Math.ceil(bytes / 32) * 32;
+}
+
+/**
+ * Estimate the bandwidth cost (in SUN) of a Tron fill for `deposit`.
+ *
+ * On Tron, transaction bytes consume bandwidth — distinct from energy (paid via the tx
+ * fee limit and modeled in `nativeGasCost`). When the relayer has no free bandwidth
+ * staked, every byte burns 1,000 SUN. For message-bearing fills this is non-trivial:
+ * the message dominates calldata size, so the cost scales linearly with message length.
+ *
+ * Sped-up deposits (those carrying a `speedUpSignature`) are filled via
+ * `fillRelayWithUpdatedDeposit`, which carries the original `V3RelayData` *and*
+ * `updatedMessage`/`speedUpSignature` as additional ABI args. Both messages are charged.
+ *
+ * The estimate is conservative — it assumes zero free bandwidth (worst case). Relayers
+ * that stake TRX for bandwidth pay 0 onchain; this still represents the true marginal
+ * cost of consuming that staked allowance.
+ */
+export function getAuxiliaryNativeTokenCost(
+  deposit: RelayData & Partial<SpeedUpCommon> & { speedUpSignature?: string }
+): BigNumber {
+  const paddedMessageBytes = paddedMessageByteLength(deposit.message);
+
+  let speedUpExtraBytes = 0;
+  if (isDefined(deposit.speedUpSignature) && deposit.speedUpSignature !== "0x") {
+    speedUpExtraBytes = TVM_SPEED_UP_FIXED_CALLDATA_EXTRA_BYTES + paddedMessageByteLength(deposit.updatedMessage);
+  }
+
+  const calldataBytes = TVM_FILL_RELAY_FIXED_CALLDATA_BYTES + paddedMessageBytes + speedUpExtraBytes;
+  const txBytes = TVM_RAW_DATA_OVERHEAD_BYTES + calldataBytes;
+
+  return toBN(txBytes).mul(TVM_BANDWIDTH_SUN_PER_BYTE);
+}
+
+// Re-export so other arches can reference the zero default if needed.
+export const tvmBandwidthCostZero = bnZero;

package/src/arch/tvm/index.ts

@@ -1,2 +1,3 @@
 export * from "./SpokeUtils";
 export * from "./TransactionUtils";
+export * from "./MessageUtils";

package/src/relayFeeCalculator/chain-queries/factory.ts

@@ -4,12 +4,13 @@ import { getDeployedAddress } from "@across-protocol/contracts";
 import { asL2Provider } from "@eth-optimism/sdk";
 import { providers } from "ethers";
 import { CUSTOM_GAS_TOKENS } from "../../constants";
-import { chainIsEvm, chainIsOPStack, isDefined, chainIsSvm, SvmAddress } from "../../utils";
+import { chainIsEvm, chainIsOPStack, isDefined, chainIsSvm, chainIsTvm, SvmAddress } from "../../utils";
 import { QueryBase } from "./baseQuery";
 import { SVMProvider as svmProvider } from "../../arch/svm";
 import { DEFAULT_LOGGER, getDefaultRelayer, Logger } from "../relayFeeCalculator";
 import { CustomGasTokenQueries } from "./customGasToken";
 import { SvmQuery } from "./svmQuery";
+import { TvmQuery } from "./tvmQuery";
 
 /**
  * Some chains have a fixed gas price that is applied to the gas estimates. We should override
@@ -35,7 +36,12 @@ export class QueryBase__factory {
     const customGasTokenSymbol = CUSTOM_GAS_TOKENS[chainId];
     if (chainIsEvm(chainId) && isDefined(customGasTokenSymbol)) {
       assert(relayerAddress.isEVM());
-      return new CustomGasTokenQueries({
+      // TVM chains route through TvmQuery so that bandwidth — a Tron-native cost the
+      // EVM compatibility layer's `eth_estimateGas` does not surface — is included in
+      // `auxiliaryNativeTokenCost`. Otherwise fall back to the EVM-flavoured custom gas
+      // token query.
+      const QueryCtor = chainIsTvm(chainId) ? TvmQuery : CustomGasTokenQueries;
+      return new QueryCtor({
         queryBaseArgs: [
           provider as providers.Provider,
           symbolMapping,

package/src/relayFeeCalculator/chain-queries/index.ts

@@ -2,3 +2,4 @@ export * from "./baseQuery";
 export * from "./factory";
 export * from "./customGasToken";
 export * from "./svmQuery";
+export * from "./tvmQuery";

package/src/relayFeeCalculator/chain-queries/tvmQuery.ts

@@ -0,0 +1,20 @@
+import { arch } from "../..";
+import { RelayData } from "../../interfaces";
+import { BigNumber } from "../../utils";
+import { CustomGasTokenQueries } from "./customGasToken";
+
+/**
+ * TVM (TRON) query implementation. Extends `CustomGasTokenQueries` to add bandwidth
+ * accounting via `getAuxiliaryNativeTokenCost`, which the base EVM path returns 0 for.
+ *
+ * Energy (Tron's analogue of gas) is already estimated by `voidSigner.estimateGas`
+ * against the EVM-compat RPC and surfaces in `tokenGasCost`. Bandwidth is a separate
+ * Tron-native resource that the EVM compatibility layer does not surface, so we
+ * estimate it here from the deposit's `message` length and a fixed `fillRelay`
+ * calldata footprint.
+ */
+export class TvmQuery extends CustomGasTokenQueries {
+  override getAuxiliaryNativeTokenCost(deposit: RelayData): BigNumber {
+    return arch.tvm.getAuxiliaryNativeTokenCost(deposit);
+  }
+}