@forevermoney/sdk 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.5.3 — 2026-09-19
+
+- Increased EVM-to-Subtensor CCIP destination execution gas from the spoke
+  gateways' 300,000 default to an explicit 3,500,000. A 900,000 manual
+  execution reached the gateway but still fell back to a claimable booking;
+  the same live liquid claim path estimates near 2,560,000 gas. Quotes and
+  transaction calldata now use the same exported
+  `EVM_TO_SUBTENSOR_DESTINATION_GAS_LIMIT` for zero-fee and partner-fee
+  bridges. Callers can override it per transaction with the optional
+  `destinationGasLimit` request field, without changing or republishing the
+  SDK.
+- Added the explicit-gas `quoteBridgeToFinney` and `bridgeToFinney` overloads
+  to the public SpokeGateway ABI.
+
 ## 0.5.2 — 2026-09-16
 
 - Added opt-in stake rounding adjustment to Subtensor bridge preparation, with an explicit disable option and adjusted amount/plan metadata. Searches only on `StrandedStake`, preserves minimum output, requotes candidates and checks source balances, minimum remainders and partner-fee allocations. Approval-required plans are explicitly marked as not yet simulated.

package/README.md

@@ -6,10 +6,10 @@ vault contracts.
 The SDK owns the canonical production deployment: chain IDs, CCIP selectors,
 contract addresses, ABIs, and protocol-specific amount conversion. An
 integrator supplies only RPC transports and user input. The SDK never accepts a
-private key, signs a transaction, or broadcasts a transaction. Bridge principal
-is transferred 1:1 and the network fee is charged separately, so the SDK fixes
-the contract's minimum destination output to the bridged principal instead of
-exposing configurable slippage.
+private key, signs a transaction, or broadcasts a transaction. Network fees are
+charged separately. Subtensor-to-EVM requests accept an explicit minimum output
+to account for native staking rounding; exact output remains the default.
+SDK 0.5.2 also provides opt-in stake rounding preparation (see below).
 
 Bridge plans use the current gateways in `contracts.gateway`. Retired gateways
 remain under `contracts.legacyGateways` only so receipts and deliveries of
@@ -101,6 +101,11 @@ Liquid Base-to-Subtensor delivery requires at least `0.01 TAO` because the
 destination vault must unstake the bridged position. The SDK rejects smaller
 liquid deliveries with `AMOUNT_BELOW_MINIMUM` before quoting or planning them;
 staked delivery does not use this liquid-unstaking minimum.
+EVM-to-Subtensor plans quote and encode an explicit 3,500,000 destination gas
+limit so the variable-cost Subtensor exit path can auto-execute through CCIP.
+The policy is exported as `EVM_TO_SUBTENSOR_DESTINATION_GAS_LIMIT`. Pass a
+positive bigint as `destinationGasLimit` to override it for one preparation or
+plan; the SDK uses that value for both the fee quote and transaction calldata.
 The network-fee buffer is 2% and the estimated-gas buffer is 50%; both policies
 are exported as bigint basis-point constants and covered by property tests.
 

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   BASE_CCIP_SELECTOR: () => BASE_CCIP_SELECTOR,
   BASE_CHAIN_ID: () => BASE_CHAIN_ID,
   BASIS_POINTS: () => BASIS_POINTS,
+  EVM_TO_SUBTENSOR_DESTINATION_GAS_LIMIT: () => EVM_TO_SUBTENSOR_DESTINATION_GAS_LIMIT,
   EVM_WEI_PER_RAO: () => EVM_WEI_PER_RAO,
   FOREVERMONEY_DEPLOYMENT_VERSION: () => FOREVERMONEY_DEPLOYMENT_VERSION,
   ForeverMoneyError: () => ForeverMoneyError,
@@ -645,7 +646,9 @@ var SPOKE_GATEWAY_ABI = Object.freeze([
   "function maxIntegratorFeeBps() view returns (uint16)",
   "function bridgeFeeBps() view returns (uint16)",
   "function quoteBridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) view returns (uint256 fee)",
+  "function quoteBridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit,uint256 gasLimit) view returns (uint256 fee)",
   "function bridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) payable returns (bytes32 messageId)",
+  "function bridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit,uint256 gasLimit) payable returns (bytes32 messageId)",
   "function quoteBridgeToFinneyWithFee(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit,uint256 gasLimit,(address recipient,uint16 bps) integrator) view returns (uint256 fee,uint256 cut,uint256 amountCrossing)",
   "function bridgeToFinneyWithFee(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit,uint256 gasLimit,(address recipient,uint16 bps) integrator) payable returns (bytes32 messageId)",
   "event BridgedToFinney(address indexed token,address indexed sender,bytes32 indexed ss58,uint256 amount,bytes32 messageId)"
@@ -663,7 +666,6 @@ var ALPHA_GATEWAY_ABI = Object.freeze([
   "function bridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 taoAmount,uint256 stakedAlphaRao,uint256 minTokenOut,(address recipient,uint16 bps) integrator) payable returns (bytes32 messageId)",
   "function bridgeOutFromValidators(uint64 destSelector,address token,address recipient,uint256 taoAmount,(bytes32 validator,uint256 alphaRao)[] sources,uint256 minTokenOut) payable returns (bytes32 messageId)",
   "function bridgeOutFromValidatorsWithFee(uint64 destSelector,address token,address recipient,uint256 taoAmount,(bytes32 validator,uint256 alphaRao)[] sources,uint256 minTokenOut,(address recipient,uint16 bps) integrator) payable returns (bytes32 messageId)",
-  "function minStakeRequired() view returns (uint256)",
   "function MAX_STAKE_SOURCES() view returns (uint256)",
   "function GATEWAY_COLDKEY() view returns (bytes32)",
   "function claimLiquid(address token,uint256 minTaoOut,address to)",
@@ -750,6 +752,18 @@ var stakingAbi = (0, import_viem6.parseAbi)(STAKING_ABI);
 var MIN_LIQUID_EVM_TO_SUBTENSOR_WEI = 10000000000000000n;
 var MIN_LIQUID_BASE_TO_SUBTENSOR_WEI = MIN_LIQUID_EVM_TO_SUBTENSOR_WEI;
 var MIN_LIQUID_SUBTENSOR_TO_EVM_WEI = 2000000n * EVM_WEI_PER_RAO;
+var EVM_TO_SUBTENSOR_DESTINATION_GAS_LIMIT = 3500000n;
+function resolveDestinationGasLimit(value) {
+  const gasLimit = value ?? EVM_TO_SUBTENSOR_DESTINATION_GAS_LIMIT;
+  if (typeof gasLimit !== "bigint" || gasLimit <= 0n) {
+    throw new ForeverMoneyError(
+      "INVALID_TRANSACTION_PLAN",
+      "Destination gas limit must be a positive bigint.",
+      { destinationGasLimit: String(gasLimit) }
+    );
+  }
+  return gasLimit;
+}
 var MAX_PARTNER_FEE_BPS = 1e4;
 var MAX_STAKE_PULLS = 16;
 var NO_PARTNER_FEE = {
@@ -926,15 +940,15 @@ function partnerFeeSummary(charged, unit, fee) {
   if (fee.bps === 0) return "";
   return ` Partner fee: ${charged} wei of ${unit} (${fee.bps} bps) on top, paid to ${fee.recipient}.`;
 }
-function encodeSpokeBridge(token, amountWei, exit, fee) {
+function encodeSpokeBridge(token, amountWei, exit, destinationGasLimit, fee) {
   return fee.bps === 0 ? (0, import_viem6.encodeFunctionData)({
     abi: spokeAbi,
     functionName: "bridgeToFinney",
-    args: [token, amountWei, exit]
+    args: [token, amountWei, exit, destinationGasLimit]
   }) : (0, import_viem6.encodeFunctionData)({
     abi: spokeAbi,
     functionName: "bridgeToFinneyWithFee",
-    args: [token, amountWei, exit, 0n, fee]
+    args: [token, amountWei, exit, destinationGasLimit, fee]
   });
 }
 function resolveStakePulls(pulls, amountRao) {
@@ -1021,7 +1035,7 @@ function encodeHubBridge(destSelector, token, recipient, taoAmount, stakedAlphaR
     args: [...args, fee]
   });
 }
-async function quoteSpokeWithFee(provider, gateway, token, amountWei, exit, fee) {
+async function quoteSpokeWithFee(provider, gateway, token, amountWei, exit, destinationGasLimit, fee) {
   const maxBps = await provider.readContract({
     address: gateway,
     abi: spokeAbi,
@@ -1032,7 +1046,7 @@ async function quoteSpokeWithFee(provider, gateway, token, amountWei, exit, fee)
     address: gateway,
     abi: spokeAbi,
     functionName: "quoteBridgeToFinneyWithFee",
-    args: [token, amountWei, exit, 0n, fee]
+    args: [token, amountWei, exit, destinationGasLimit, fee]
   });
   return networkFee;
 }
@@ -1078,6 +1092,9 @@ function buildEvmToSubtensorPlan(input) {
   assertBaseToSubtensorAmount(input.amountWei, input.delivery);
   assertNonNegativeAmount(input.allowanceWei, "Token allowance");
   assertNonNegativeAmount(input.exactNetworkFeeWei, "Network fee");
+  const destinationGasLimit = resolveDestinationGasLimit(
+    input.destinationGasLimit
+  );
   const destination = normalizeSS58(input.destination);
   const exit = {
     ss58: ss58ToPublicKey(destination),
@@ -1121,6 +1138,7 @@ function buildEvmToSubtensorPlan(input) {
         asset.evmToken,
         input.amountWei,
         exit,
+        destinationGasLimit,
         partnerFee
       ),
       value,
@@ -1236,6 +1254,9 @@ async function prepareEvmToSubtensor(provider, input) {
   assertDelivery(input.delivery);
   assertAssetMode(input.asset, input.delivery);
   assertBaseToSubtensorAmount(input.amountWei, input.delivery);
+  const destinationGasLimit = resolveDestinationGasLimit(
+    input.destinationGasLimit
+  );
   const destination = normalizeSS58(input.destination);
   const evm = getForeverMoneyEvmDeployment(input.evmChain);
   const exit = {
@@ -1260,13 +1281,19 @@ async function prepareEvmToSubtensor(provider, input) {
       address: evm.contracts.gateway,
       abi: spokeAbi,
       functionName: "quoteBridgeToFinney",
-      args: [asset.evmToken, input.amountWei, exit]
+      args: [
+        asset.evmToken,
+        input.amountWei,
+        exit,
+        destinationGasLimit
+      ]
     }) : quoteSpokeWithFee(
       provider,
       evm.contracts.gateway,
       asset.evmToken,
       input.amountWei,
       exit,
+      destinationGasLimit,
       partnerFee
     )
   ]);
@@ -1276,6 +1303,7 @@ async function prepareEvmToSubtensor(provider, input) {
       asset.evmToken,
       input.amountWei,
       exit,
+      destinationGasLimit,
       partnerFee
     );
     estimatedBridgeGas = await provider.estimateGas({