@forevermoney/sdk 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.5.1 — 2026-09-16
+
+- Added optional `minAmountOutWei` to Subtensor-to-EVM bridge requests. Callers can explicitly bound output slippage, including staking rounding dust. Defaults to the input amount; rejects zero, negative, non-bigint, and above-input minima before RPC calls. The same minimum is used for gas estimation and final calldata, for single- and multi-validator routes with or without partner fees.
+
 ## 0.5.0 — 2026-09-16
 
 - Staked bridges from Subtensor can pull from several validators. Pass

package/README.md

@@ -438,3 +438,7 @@ testing are documented in [`docs/testing.md`](./docs/testing.md).
 
 Security reports should follow [`SECURITY.md`](./SECURITY.md). Maintainer release
 steps are in [`docs/releasing.md`](./docs/releasing.md).
+
+### Minimum bridge output
+
+Subtensor-to-EVM builders and preparation methods accept optional `minAmountOutWei` (destination token units, 18 decimals, after partner fees). It must be positive and no greater than `amountWei`; omission preserves the exact-output default. Choose the minimum explicitly to cover your acceptable slippage or native staking rounding dust. The SDK uses the same value for gas estimation and final transaction calldata. For example, `minAmountOutWei: amountWei - 4n * EVM_WEI_PER_RAO` allows four native RAO of dust when the amount exceeds that budget. This does not change the input amount or approval amount.

package/dist/index.cjs

@@ -721,6 +721,17 @@ function stakePullsFor(input, amountRao) {
   }
   return resolveStakePulls(input.stakePulls, amountRao);
 }
+function minimumSubtensorOutput(input) {
+  const minimum = input.minAmountOutWei ?? input.amountWei;
+  assertNonNegativeAmount(minimum, "Minimum output");
+  if (minimum === 0n || minimum > input.amountWei) {
+    throw new ForeverMoneyError(
+      "INVALID_TRANSACTION_PLAN",
+      "Minimum output must be positive and no greater than the input amount."
+    );
+  }
+  return minimum;
+}
 function assertDelivery(value) {
   if (value !== "liquid" && value !== "staked") {
     throw new ForeverMoneyError(
@@ -999,6 +1010,7 @@ function buildSubtensorToEvmPlan(input) {
   assertAssetMode(input.asset, input.source);
   const netuid = sourceNetuid(input);
   assertSubtensorToEvmAmount(input.amountWei, input.source);
+  const minAmountOutWei = minimumSubtensorOutput(input);
   assertNonNegativeAmount(input.exactNetworkFeeWei, "Network fee");
   const { subtensor } = foreverMoneyDeployment;
   const evm = getForeverMoneyEvmDeployment(input.evmChain);
@@ -1063,7 +1075,7 @@ function buildSubtensorToEvmPlan(input) {
         recipient,
         taoAmount,
         stakedAlphaRao,
-        input.amountWei,
+        minAmountOutWei,
         partnerFee,
         pulls
       ),
@@ -1163,6 +1175,7 @@ async function prepareSubtensorToEvm(provider, input) {
   assertAssetMode(input.asset, input.source);
   const netuid = sourceNetuid(input);
   assertSubtensorToEvmAmount(input.amountWei, input.source);
+  const minAmountOutWei = minimumSubtensorOutput(input);
   const { subtensor } = foreverMoneyDeployment;
   const evm = getForeverMoneyEvmDeployment(input.evmChain);
   const partnerFee = resolvePartnerFee(
@@ -1216,7 +1229,7 @@ async function prepareSubtensorToEvm(provider, input) {
         recipient,
         taoAmount,
         stakedAlphaRao,
-        input.amountWei,
+        minAmountOutWei,
         partnerFee,
         stakePullsFor(input, stakedAlphaRao)
       ),