@forevermoney/sdk 0.4.0 → 0.5.1

package/dist/index.d.cts

@@ -16,7 +16,7 @@ declare function feeWithBuffer(fee: bigint): bigint;
 declare function gasLimitWithBuffer(gasLimit: bigint): bigint;
 
 declare const foreverMoneyAbis: Readonly<{
-    alphaGateway: readonly ["function ROUTER() view returns (address)", "function allowedLane(uint64 selector) view returns (bool)", "function maxIntegratorFeeBps() view returns (uint16)", "function bridgeFeeBps() view returns (uint16)", "function integratorTaoTopUp(uint256 taoAmount,uint16 bps) pure returns (uint256)", "function quoteBridgeOut(uint64 destSelector,address token,address recipient,uint256 mintedAmount) view returns (uint256 fee)", "function bridgeOut(uint64 destSelector,address token,address recipient,uint256 taoAmount,uint256 stakedAlphaRao,uint256 minTokenOut) payable returns (bytes32 messageId)", "function integratorCut(uint256 amount,uint16 bps) pure returns (uint256)", "function quoteBridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 mintedAmount,uint256 taoAmount,uint256 stakedAlphaRao,(address recipient,uint16 bps) integrator) view returns (uint256 fee,uint256 nativeTopUp,uint256 alphaTopUp,uint256 amountCrossing)", "function bridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 taoAmount,uint256 stakedAlphaRao,uint256 minTokenOut,(address recipient,uint16 bps) integrator) payable returns (bytes32 messageId)", "function claimLiquid(address token,uint256 minTaoOut,address to)", "function claimNative(address to)", "function claimStaked(address token,bytes32 destColdkey,address to)", "function claimToken(address token,address to)", "function claimableNative(address account) view returns (uint256)", "function claimableToken(address token,address account) view returns (uint256)", "event BridgedOut(uint64 destChainSelector,address indexed token,address indexed sender,address indexed recipient,uint256 minted,bytes32 messageId)", "event Claimable(address indexed token,address indexed user,uint256 native,uint256 wsn)", "event NotDelivered(uint64 indexed sourceChainSelector,address indexed token,uint256 amount,uint8 reason)", "event DeliveredLiquid(address indexed token,bytes32 indexed ss58,uint256 taoOut)", "event DeliveredStaked(address indexed token,bytes32 indexed ss58,uint256 alphaRao)"];
+    alphaGateway: readonly ["function ROUTER() view returns (address)", "function allowedLane(uint64 selector) view returns (bool)", "function maxIntegratorFeeBps() view returns (uint16)", "function bridgeFeeBps() view returns (uint16)", "function integratorTaoTopUp(uint256 taoAmount,uint16 bps) pure returns (uint256)", "function quoteBridgeOut(uint64 destSelector,address token,address recipient,uint256 mintedAmount) view returns (uint256 fee)", "function bridgeOut(uint64 destSelector,address token,address recipient,uint256 taoAmount,uint256 stakedAlphaRao,uint256 minTokenOut) payable returns (bytes32 messageId)", "function integratorCut(uint256 amount,uint16 bps) pure returns (uint256)", "function quoteBridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 mintedAmount,uint256 taoAmount,uint256 stakedAlphaRao,(address recipient,uint16 bps) integrator) view returns (uint256 fee,uint256 nativeTopUp,uint256 alphaTopUp,uint256 amountCrossing)", "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)", "function claimNative(address to)", "function claimStaked(address token,bytes32 destColdkey,address to)", "function claimToken(address token,address to)", "function claimableNative(address account) view returns (uint256)", "function claimableToken(address token,address account) view returns (uint256)", "event BridgedOut(uint64 destChainSelector,address indexed token,address indexed sender,address indexed recipient,uint256 minted,bytes32 messageId)", "event Claimable(address indexed token,address indexed user,uint256 native,uint256 wsn)", "event NotDelivered(uint64 indexed sourceChainSelector,address indexed token,uint256 amount,uint8 reason)", "event DeliveredLiquid(address indexed token,bytes32 indexed ss58,uint256 taoOut)", "event DeliveredStaked(address indexed token,bytes32 indexed ss58,uint256 alphaRao)"];
     alphaVault: readonly ["function isPaused() view returns (bool)", "function pausedUntil() view returns (uint256)", "function isListed(address token) view returns (bool)", "function backing(address token) view returns (uint256 stakedAlpha)", "function positionOf(address token) view returns (bytes32 validator,uint256 netuid)"];
     ccipExecution: readonly ["event ExecutionStateChanged(uint64 indexed sourceChainSelector,uint64 indexed sequenceNumber,bytes32 indexed messageId,bytes32 messageHash,uint8 state,bytes returnData,uint256 gasUsed)"];
     ccipRouter: readonly ["function isOffRamp(uint64 sourceChainSelector,address offRamp) view returns (bool)"];
@@ -36,9 +36,9 @@ declare const SUBTENSOR_CCIP_SELECTOR = 2135107236357186872n;
 declare const RAO_PER_TAO = 1000000000n;
 declare const EVM_WEI_PER_RAO = 1000000000n;
 declare const SN80_NETUID = 80n;
-declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.2.0";
+declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.3.0";
 declare const foreverMoneyDeployment: Readonly<{
-    version: "1.2.0";
+    version: "1.3.0";
     base: Readonly<{
         key: "base";
         name: "Base";
@@ -46,7 +46,7 @@ declare const foreverMoneyDeployment: Readonly<{
         ccipSelector: 15971525489660198786n;
         contracts: Readonly<{
             gateway: `0x${string}`;
-            legacyGateway: `0x${string}`;
+            legacyGateways: readonly `0x${string}`[];
             wrappedTao: `0x${string}`;
             wrappedSn80: `0x${string}`;
             ccipRouter: `0x${string}`;
@@ -65,7 +65,7 @@ declare const foreverMoneyDeployment: Readonly<{
         ccipSelector: 6180753054346818345n;
         contracts: Readonly<{
             gateway: `0x${string}`;
-            legacyGateway: `0x${string}`;
+            legacyGateways: readonly `0x${string}`[];
             wrappedTao: `0x${string}`;
             ccipRouter: `0x${string}`;
             ccipOffRampFromSubtensor: `0x${string}`;
@@ -76,7 +76,7 @@ declare const foreverMoneyDeployment: Readonly<{
         ccipSelector: 2135107236357186872n;
         contracts: Readonly<{
             gateway: `0x${string}`;
-            legacyGateway: `0x${string}`;
+            legacyGateways: readonly `0x${string}`[];
             alphaVault: `0x${string}`;
             wrappedTao: `0x${string}`;
             wrappedSn80: `0x${string}`;
@@ -132,6 +132,18 @@ interface PartnerFee {
     readonly bps: number;
 }
 declare const MAX_PARTNER_FEE_BPS = 10000;
+/**
+ * One staked position to pull from when bridging staked alpha from Subtensor:
+ * the validator hotkey the caller's stake sits on and how much of it to take.
+ * The gateway re-delegates every pull to the token's canonical validator
+ * before depositing, so stake with any validator can be bridged.
+ */
+interface StakePull {
+    readonly hotkey: string;
+    readonly amountRao: bigint;
+}
+/** Gateway limit on positions per bridge (`AlphaGateway.MAX_STAKE_SOURCES`). */
+declare const MAX_STAKE_PULLS = 16;
 interface EvmToSubtensorRequest {
     readonly evmChain: ForeverMoneyEvmChain;
     readonly asset?: BridgeAsset;
@@ -142,6 +154,11 @@ interface EvmToSubtensorRequest {
     readonly delivery: SubtensorDelivery;
 }
 interface SubtensorToEvmRequest {
+    /** Minimum destination-token output in 18-decimal wei, after partner fees.
+     * Defaults to amountWei. Must be positive and no greater than amountWei.
+     * Callers choose their tolerance explicitly, including staking rounding dust.
+     */
+    readonly minAmountOutWei?: bigint;
     readonly evmChain: ForeverMoneyEvmChain;
     readonly asset?: BridgeAsset;
     readonly partnerFee?: PartnerFee;
@@ -150,6 +167,14 @@ interface SubtensorToEvmRequest {
     readonly amountWei: bigint;
     readonly source: SubtensorSource;
     readonly netuid?: bigint;
+    /**
+     * For a staked source: the positions to pull, summing to `amountWei` in
+     * RAO. Omit when the stake already sits on the token's canonical validator.
+     * With a partner fee, the cut is charged on top and spread across the pulls
+     * in proportion to their amounts, so each position must hold its amount
+     * plus its share of the cut.
+     */
+    readonly stakePulls?: readonly StakePull[];
 }
 type BaseToSubtensorRequest = Omit<EvmToSubtensorRequest, 'evmChain'>;
 type SubtensorToBaseRequest = Omit<SubtensorToEvmRequest, 'evmChain'>;
@@ -363,4 +388,4 @@ interface ViemTransactionRequest {
 }
 declare function toViemTransaction(transaction: PreparedTransaction): Readonly<ViemTransactionRequest>;
 
-export { BASE_CCIP_SELECTOR, BASE_CHAIN_ID, BASIS_POINTS, type BaseToSubtensorRequest, type BridgeAsset, type BridgeDirection, type BridgePreparation, type BridgeSourceStatus, type BridgeSourceStatusRequest, type BridgeSourceTransactionStatus, type BuildBaseToSubtensorPlanRequest, type BuildEvmToSubtensorPlanRequest, type BuildSubtensorToBasePlanRequest, type BuildSubtensorToEvmPlanRequest, type CcipDeliveryCheckpoint, type CcipDeliveryStatus, type CcipDeliveryStatusRequest, type CreateVaultRequest, type DepositVaultRequest, EVM_WEI_PER_RAO, type Eip1193TransactionRequest, type EthersCompatibleTransactionRequest, type EvmToSubtensorRequest, FOREVERMONEY_DEPLOYMENT_VERSION, type ForeverMoneyClient, type ForeverMoneyClientOptions, type ForeverMoneyDeployment, ForeverMoneyError, type ForeverMoneyErrorCode, type ForeverMoneyEvmChain, GAS_LIMIT_BUFFER_BPS, type HttpTransportOptions, type LegacyRpcProvider, MAX_PARTNER_FEE_BPS, MIN_LIQUID_BASE_TO_SUBTENSOR_WEI, MIN_LIQUID_EVM_TO_SUBTENSOR_WEI, MIN_LIQUID_SUBTENSOR_TO_EVM_WEI, NETWORK_FEE_BUFFER_BPS, type PartnerFee, type PreparedTransaction, RAO_PER_TAO, ROBINHOOD_CCIP_SELECTOR, ROBINHOOD_CHAIN_ID, type ReceiptLog, type RpcRequest, type RpcTransport, SN80_NETUID, SUBTENSOR_CCIP_SELECTOR, SUBTENSOR_CHAIN_ID, type SubtensorDelivery, type SubtensorSource, type SubtensorToBaseRequest, type SubtensorToEvmRequest, type TrackingProvider, type TransactionAction, type TransactionPlan, type TransactionReceiptLike, type TransactionStep, type TransactionStepKind, type VaultStashToken, type VaultTokenAllowance, type ViemTransactionRequest, type WithdrawVaultRequest, assertWholeRao, bridgeMessageIdFromReceipt, buildBaseToSubtensorPlan, buildClaimVaultFeesPlan, buildCreateVaultPlan, buildDepositVaultPlan, buildEvmToSubtensorPlan, buildSetVaultStakingPlan, buildSubtensorToBasePlan, buildSubtensorToEvmPlan, buildWithdrawVaultPlan, createForeverMoneyClient, destinationChainId, evmChainFromBridgeDirection, evmToMirrorSS58, feeWithBuffer, foreverMoneyAbis, foreverMoneyDeployment, formatTaoAmount, gasLimitWithBuffer, getBridgeSourceStatus, getCcipDeliveryCheckpoint, getCcipDeliveryStatus, getForeverMoneyEvmDeployment, http, isBittensorSS58, isEvmToSubtensorDirection, normalizeEvmAddress, normalizeSS58, parseTaoAmount, partnerFeeCut, partnerFeeTaoTopUp, sourceChainId, ss58ToPublicKey, toEip1193Transaction, toEthersTransaction, toViemTransaction, vaultManagerFromCreationReceipt };
+export { BASE_CCIP_SELECTOR, BASE_CHAIN_ID, BASIS_POINTS, type BaseToSubtensorRequest, type BridgeAsset, type BridgeDirection, type BridgePreparation, type BridgeSourceStatus, type BridgeSourceStatusRequest, type BridgeSourceTransactionStatus, type BuildBaseToSubtensorPlanRequest, type BuildEvmToSubtensorPlanRequest, type BuildSubtensorToBasePlanRequest, type BuildSubtensorToEvmPlanRequest, type CcipDeliveryCheckpoint, type CcipDeliveryStatus, type CcipDeliveryStatusRequest, type CreateVaultRequest, type DepositVaultRequest, EVM_WEI_PER_RAO, type Eip1193TransactionRequest, type EthersCompatibleTransactionRequest, type EvmToSubtensorRequest, FOREVERMONEY_DEPLOYMENT_VERSION, type ForeverMoneyClient, type ForeverMoneyClientOptions, type ForeverMoneyDeployment, ForeverMoneyError, type ForeverMoneyErrorCode, type ForeverMoneyEvmChain, GAS_LIMIT_BUFFER_BPS, type HttpTransportOptions, type LegacyRpcProvider, MAX_PARTNER_FEE_BPS, MAX_STAKE_PULLS, MIN_LIQUID_BASE_TO_SUBTENSOR_WEI, MIN_LIQUID_EVM_TO_SUBTENSOR_WEI, MIN_LIQUID_SUBTENSOR_TO_EVM_WEI, NETWORK_FEE_BUFFER_BPS, type PartnerFee, type PreparedTransaction, RAO_PER_TAO, ROBINHOOD_CCIP_SELECTOR, ROBINHOOD_CHAIN_ID, type ReceiptLog, type RpcRequest, type RpcTransport, SN80_NETUID, SUBTENSOR_CCIP_SELECTOR, SUBTENSOR_CHAIN_ID, type StakePull, type SubtensorDelivery, type SubtensorSource, type SubtensorToBaseRequest, type SubtensorToEvmRequest, type TrackingProvider, type TransactionAction, type TransactionPlan, type TransactionReceiptLike, type TransactionStep, type TransactionStepKind, type VaultStashToken, type VaultTokenAllowance, type ViemTransactionRequest, type WithdrawVaultRequest, assertWholeRao, bridgeMessageIdFromReceipt, buildBaseToSubtensorPlan, buildClaimVaultFeesPlan, buildCreateVaultPlan, buildDepositVaultPlan, buildEvmToSubtensorPlan, buildSetVaultStakingPlan, buildSubtensorToBasePlan, buildSubtensorToEvmPlan, buildWithdrawVaultPlan, createForeverMoneyClient, destinationChainId, evmChainFromBridgeDirection, evmToMirrorSS58, feeWithBuffer, foreverMoneyAbis, foreverMoneyDeployment, formatTaoAmount, gasLimitWithBuffer, getBridgeSourceStatus, getCcipDeliveryCheckpoint, getCcipDeliveryStatus, getForeverMoneyEvmDeployment, http, isBittensorSS58, isEvmToSubtensorDirection, normalizeEvmAddress, normalizeSS58, parseTaoAmount, partnerFeeCut, partnerFeeTaoTopUp, sourceChainId, ss58ToPublicKey, toEip1193Transaction, toEthersTransaction, toViemTransaction, vaultManagerFromCreationReceipt };

package/dist/index.d.ts

@@ -16,7 +16,7 @@ declare function feeWithBuffer(fee: bigint): bigint;
 declare function gasLimitWithBuffer(gasLimit: bigint): bigint;
 
 declare const foreverMoneyAbis: Readonly<{
-    alphaGateway: readonly ["function ROUTER() view returns (address)", "function allowedLane(uint64 selector) view returns (bool)", "function maxIntegratorFeeBps() view returns (uint16)", "function bridgeFeeBps() view returns (uint16)", "function integratorTaoTopUp(uint256 taoAmount,uint16 bps) pure returns (uint256)", "function quoteBridgeOut(uint64 destSelector,address token,address recipient,uint256 mintedAmount) view returns (uint256 fee)", "function bridgeOut(uint64 destSelector,address token,address recipient,uint256 taoAmount,uint256 stakedAlphaRao,uint256 minTokenOut) payable returns (bytes32 messageId)", "function integratorCut(uint256 amount,uint16 bps) pure returns (uint256)", "function quoteBridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 mintedAmount,uint256 taoAmount,uint256 stakedAlphaRao,(address recipient,uint16 bps) integrator) view returns (uint256 fee,uint256 nativeTopUp,uint256 alphaTopUp,uint256 amountCrossing)", "function bridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 taoAmount,uint256 stakedAlphaRao,uint256 minTokenOut,(address recipient,uint16 bps) integrator) payable returns (bytes32 messageId)", "function claimLiquid(address token,uint256 minTaoOut,address to)", "function claimNative(address to)", "function claimStaked(address token,bytes32 destColdkey,address to)", "function claimToken(address token,address to)", "function claimableNative(address account) view returns (uint256)", "function claimableToken(address token,address account) view returns (uint256)", "event BridgedOut(uint64 destChainSelector,address indexed token,address indexed sender,address indexed recipient,uint256 minted,bytes32 messageId)", "event Claimable(address indexed token,address indexed user,uint256 native,uint256 wsn)", "event NotDelivered(uint64 indexed sourceChainSelector,address indexed token,uint256 amount,uint8 reason)", "event DeliveredLiquid(address indexed token,bytes32 indexed ss58,uint256 taoOut)", "event DeliveredStaked(address indexed token,bytes32 indexed ss58,uint256 alphaRao)"];
+    alphaGateway: readonly ["function ROUTER() view returns (address)", "function allowedLane(uint64 selector) view returns (bool)", "function maxIntegratorFeeBps() view returns (uint16)", "function bridgeFeeBps() view returns (uint16)", "function integratorTaoTopUp(uint256 taoAmount,uint16 bps) pure returns (uint256)", "function quoteBridgeOut(uint64 destSelector,address token,address recipient,uint256 mintedAmount) view returns (uint256 fee)", "function bridgeOut(uint64 destSelector,address token,address recipient,uint256 taoAmount,uint256 stakedAlphaRao,uint256 minTokenOut) payable returns (bytes32 messageId)", "function integratorCut(uint256 amount,uint16 bps) pure returns (uint256)", "function quoteBridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 mintedAmount,uint256 taoAmount,uint256 stakedAlphaRao,(address recipient,uint16 bps) integrator) view returns (uint256 fee,uint256 nativeTopUp,uint256 alphaTopUp,uint256 amountCrossing)", "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)", "function claimNative(address to)", "function claimStaked(address token,bytes32 destColdkey,address to)", "function claimToken(address token,address to)", "function claimableNative(address account) view returns (uint256)", "function claimableToken(address token,address account) view returns (uint256)", "event BridgedOut(uint64 destChainSelector,address indexed token,address indexed sender,address indexed recipient,uint256 minted,bytes32 messageId)", "event Claimable(address indexed token,address indexed user,uint256 native,uint256 wsn)", "event NotDelivered(uint64 indexed sourceChainSelector,address indexed token,uint256 amount,uint8 reason)", "event DeliveredLiquid(address indexed token,bytes32 indexed ss58,uint256 taoOut)", "event DeliveredStaked(address indexed token,bytes32 indexed ss58,uint256 alphaRao)"];
     alphaVault: readonly ["function isPaused() view returns (bool)", "function pausedUntil() view returns (uint256)", "function isListed(address token) view returns (bool)", "function backing(address token) view returns (uint256 stakedAlpha)", "function positionOf(address token) view returns (bytes32 validator,uint256 netuid)"];
     ccipExecution: readonly ["event ExecutionStateChanged(uint64 indexed sourceChainSelector,uint64 indexed sequenceNumber,bytes32 indexed messageId,bytes32 messageHash,uint8 state,bytes returnData,uint256 gasUsed)"];
     ccipRouter: readonly ["function isOffRamp(uint64 sourceChainSelector,address offRamp) view returns (bool)"];
@@ -36,9 +36,9 @@ declare const SUBTENSOR_CCIP_SELECTOR = 2135107236357186872n;
 declare const RAO_PER_TAO = 1000000000n;
 declare const EVM_WEI_PER_RAO = 1000000000n;
 declare const SN80_NETUID = 80n;
-declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.2.0";
+declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.3.0";
 declare const foreverMoneyDeployment: Readonly<{
-    version: "1.2.0";
+    version: "1.3.0";
     base: Readonly<{
         key: "base";
         name: "Base";
@@ -46,7 +46,7 @@ declare const foreverMoneyDeployment: Readonly<{
         ccipSelector: 15971525489660198786n;
         contracts: Readonly<{
             gateway: `0x${string}`;
-            legacyGateway: `0x${string}`;
+            legacyGateways: readonly `0x${string}`[];
             wrappedTao: `0x${string}`;
             wrappedSn80: `0x${string}`;
             ccipRouter: `0x${string}`;
@@ -65,7 +65,7 @@ declare const foreverMoneyDeployment: Readonly<{
         ccipSelector: 6180753054346818345n;
         contracts: Readonly<{
             gateway: `0x${string}`;
-            legacyGateway: `0x${string}`;
+            legacyGateways: readonly `0x${string}`[];
             wrappedTao: `0x${string}`;
             ccipRouter: `0x${string}`;
             ccipOffRampFromSubtensor: `0x${string}`;
@@ -76,7 +76,7 @@ declare const foreverMoneyDeployment: Readonly<{
         ccipSelector: 2135107236357186872n;
         contracts: Readonly<{
             gateway: `0x${string}`;
-            legacyGateway: `0x${string}`;
+            legacyGateways: readonly `0x${string}`[];
             alphaVault: `0x${string}`;
             wrappedTao: `0x${string}`;
             wrappedSn80: `0x${string}`;
@@ -132,6 +132,18 @@ interface PartnerFee {
     readonly bps: number;
 }
 declare const MAX_PARTNER_FEE_BPS = 10000;
+/**
+ * One staked position to pull from when bridging staked alpha from Subtensor:
+ * the validator hotkey the caller's stake sits on and how much of it to take.
+ * The gateway re-delegates every pull to the token's canonical validator
+ * before depositing, so stake with any validator can be bridged.
+ */
+interface StakePull {
+    readonly hotkey: string;
+    readonly amountRao: bigint;
+}
+/** Gateway limit on positions per bridge (`AlphaGateway.MAX_STAKE_SOURCES`). */
+declare const MAX_STAKE_PULLS = 16;
 interface EvmToSubtensorRequest {
     readonly evmChain: ForeverMoneyEvmChain;
     readonly asset?: BridgeAsset;
@@ -142,6 +154,11 @@ interface EvmToSubtensorRequest {
     readonly delivery: SubtensorDelivery;
 }
 interface SubtensorToEvmRequest {
+    /** Minimum destination-token output in 18-decimal wei, after partner fees.
+     * Defaults to amountWei. Must be positive and no greater than amountWei.
+     * Callers choose their tolerance explicitly, including staking rounding dust.
+     */
+    readonly minAmountOutWei?: bigint;
     readonly evmChain: ForeverMoneyEvmChain;
     readonly asset?: BridgeAsset;
     readonly partnerFee?: PartnerFee;
@@ -150,6 +167,14 @@ interface SubtensorToEvmRequest {
     readonly amountWei: bigint;
     readonly source: SubtensorSource;
     readonly netuid?: bigint;
+    /**
+     * For a staked source: the positions to pull, summing to `amountWei` in
+     * RAO. Omit when the stake already sits on the token's canonical validator.
+     * With a partner fee, the cut is charged on top and spread across the pulls
+     * in proportion to their amounts, so each position must hold its amount
+     * plus its share of the cut.
+     */
+    readonly stakePulls?: readonly StakePull[];
 }
 type BaseToSubtensorRequest = Omit<EvmToSubtensorRequest, 'evmChain'>;
 type SubtensorToBaseRequest = Omit<SubtensorToEvmRequest, 'evmChain'>;
@@ -363,4 +388,4 @@ interface ViemTransactionRequest {
 }
 declare function toViemTransaction(transaction: PreparedTransaction): Readonly<ViemTransactionRequest>;
 
-export { BASE_CCIP_SELECTOR, BASE_CHAIN_ID, BASIS_POINTS, type BaseToSubtensorRequest, type BridgeAsset, type BridgeDirection, type BridgePreparation, type BridgeSourceStatus, type BridgeSourceStatusRequest, type BridgeSourceTransactionStatus, type BuildBaseToSubtensorPlanRequest, type BuildEvmToSubtensorPlanRequest, type BuildSubtensorToBasePlanRequest, type BuildSubtensorToEvmPlanRequest, type CcipDeliveryCheckpoint, type CcipDeliveryStatus, type CcipDeliveryStatusRequest, type CreateVaultRequest, type DepositVaultRequest, EVM_WEI_PER_RAO, type Eip1193TransactionRequest, type EthersCompatibleTransactionRequest, type EvmToSubtensorRequest, FOREVERMONEY_DEPLOYMENT_VERSION, type ForeverMoneyClient, type ForeverMoneyClientOptions, type ForeverMoneyDeployment, ForeverMoneyError, type ForeverMoneyErrorCode, type ForeverMoneyEvmChain, GAS_LIMIT_BUFFER_BPS, type HttpTransportOptions, type LegacyRpcProvider, MAX_PARTNER_FEE_BPS, MIN_LIQUID_BASE_TO_SUBTENSOR_WEI, MIN_LIQUID_EVM_TO_SUBTENSOR_WEI, MIN_LIQUID_SUBTENSOR_TO_EVM_WEI, NETWORK_FEE_BUFFER_BPS, type PartnerFee, type PreparedTransaction, RAO_PER_TAO, ROBINHOOD_CCIP_SELECTOR, ROBINHOOD_CHAIN_ID, type ReceiptLog, type RpcRequest, type RpcTransport, SN80_NETUID, SUBTENSOR_CCIP_SELECTOR, SUBTENSOR_CHAIN_ID, type SubtensorDelivery, type SubtensorSource, type SubtensorToBaseRequest, type SubtensorToEvmRequest, type TrackingProvider, type TransactionAction, type TransactionPlan, type TransactionReceiptLike, type TransactionStep, type TransactionStepKind, type VaultStashToken, type VaultTokenAllowance, type ViemTransactionRequest, type WithdrawVaultRequest, assertWholeRao, bridgeMessageIdFromReceipt, buildBaseToSubtensorPlan, buildClaimVaultFeesPlan, buildCreateVaultPlan, buildDepositVaultPlan, buildEvmToSubtensorPlan, buildSetVaultStakingPlan, buildSubtensorToBasePlan, buildSubtensorToEvmPlan, buildWithdrawVaultPlan, createForeverMoneyClient, destinationChainId, evmChainFromBridgeDirection, evmToMirrorSS58, feeWithBuffer, foreverMoneyAbis, foreverMoneyDeployment, formatTaoAmount, gasLimitWithBuffer, getBridgeSourceStatus, getCcipDeliveryCheckpoint, getCcipDeliveryStatus, getForeverMoneyEvmDeployment, http, isBittensorSS58, isEvmToSubtensorDirection, normalizeEvmAddress, normalizeSS58, parseTaoAmount, partnerFeeCut, partnerFeeTaoTopUp, sourceChainId, ss58ToPublicKey, toEip1193Transaction, toEthersTransaction, toViemTransaction, vaultManagerFromCreationReceipt };
+export { BASE_CCIP_SELECTOR, BASE_CHAIN_ID, BASIS_POINTS, type BaseToSubtensorRequest, type BridgeAsset, type BridgeDirection, type BridgePreparation, type BridgeSourceStatus, type BridgeSourceStatusRequest, type BridgeSourceTransactionStatus, type BuildBaseToSubtensorPlanRequest, type BuildEvmToSubtensorPlanRequest, type BuildSubtensorToBasePlanRequest, type BuildSubtensorToEvmPlanRequest, type CcipDeliveryCheckpoint, type CcipDeliveryStatus, type CcipDeliveryStatusRequest, type CreateVaultRequest, type DepositVaultRequest, EVM_WEI_PER_RAO, type Eip1193TransactionRequest, type EthersCompatibleTransactionRequest, type EvmToSubtensorRequest, FOREVERMONEY_DEPLOYMENT_VERSION, type ForeverMoneyClient, type ForeverMoneyClientOptions, type ForeverMoneyDeployment, ForeverMoneyError, type ForeverMoneyErrorCode, type ForeverMoneyEvmChain, GAS_LIMIT_BUFFER_BPS, type HttpTransportOptions, type LegacyRpcProvider, MAX_PARTNER_FEE_BPS, MAX_STAKE_PULLS, MIN_LIQUID_BASE_TO_SUBTENSOR_WEI, MIN_LIQUID_EVM_TO_SUBTENSOR_WEI, MIN_LIQUID_SUBTENSOR_TO_EVM_WEI, NETWORK_FEE_BUFFER_BPS, type PartnerFee, type PreparedTransaction, RAO_PER_TAO, ROBINHOOD_CCIP_SELECTOR, ROBINHOOD_CHAIN_ID, type ReceiptLog, type RpcRequest, type RpcTransport, SN80_NETUID, SUBTENSOR_CCIP_SELECTOR, SUBTENSOR_CHAIN_ID, type StakePull, type SubtensorDelivery, type SubtensorSource, type SubtensorToBaseRequest, type SubtensorToEvmRequest, type TrackingProvider, type TransactionAction, type TransactionPlan, type TransactionReceiptLike, type TransactionStep, type TransactionStepKind, type VaultStashToken, type VaultTokenAllowance, type ViemTransactionRequest, type WithdrawVaultRequest, assertWholeRao, bridgeMessageIdFromReceipt, buildBaseToSubtensorPlan, buildClaimVaultFeesPlan, buildCreateVaultPlan, buildDepositVaultPlan, buildEvmToSubtensorPlan, buildSetVaultStakingPlan, buildSubtensorToBasePlan, buildSubtensorToEvmPlan, buildWithdrawVaultPlan, createForeverMoneyClient, destinationChainId, evmChainFromBridgeDirection, evmToMirrorSS58, feeWithBuffer, foreverMoneyAbis, foreverMoneyDeployment, formatTaoAmount, gasLimitWithBuffer, getBridgeSourceStatus, getCcipDeliveryCheckpoint, getCcipDeliveryStatus, getForeverMoneyEvmDeployment, http, isBittensorSS58, isEvmToSubtensorDirection, normalizeEvmAddress, normalizeSS58, parseTaoAmount, partnerFeeCut, partnerFeeTaoTopUp, sourceChainId, ss58ToPublicKey, toEip1193Transaction, toEthersTransaction, toViemTransaction, vaultManagerFromCreationReceipt };

package/dist/index.js

@@ -93,7 +93,7 @@ var SUBTENSOR_CCIP_SELECTOR = 2135107236357186872n;
 var RAO_PER_TAO = 1000000000n;
 var EVM_WEI_PER_RAO = 1000000000n;
 var SN80_NETUID = 80n;
-var FOREVERMONEY_DEPLOYMENT_VERSION = "1.2.0";
+var FOREVERMONEY_DEPLOYMENT_VERSION = "1.3.0";
 var foreverMoneyDeployment = Object.freeze({
   version: FOREVERMONEY_DEPLOYMENT_VERSION,
   base: Object.freeze({
@@ -103,9 +103,11 @@ var foreverMoneyDeployment = Object.freeze({
     ccipSelector: BASE_CCIP_SELECTOR,
     contracts: Object.freeze({
       gateway: getAddress2("0x1da2415229b614C787e145D1D7346eb496319C52"),
-      legacyGateway: getAddress2(
-        "0x5EF3d7D19e4b233a1A169DA0d5CB02ec6b160a2C"
-      ),
+      // Retired gateways, oldest first; kept only to track transfers sent
+      // through them.
+      legacyGateways: [
+        getAddress2("0x5EF3d7D19e4b233a1A169DA0d5CB02ec6b160a2C")
+      ],
       wrappedTao: getAddress2(
         "0xf3081494b87e8d5fb7960f066e931d1d0e6e3d67"
       ),
@@ -138,9 +140,9 @@ var foreverMoneyDeployment = Object.freeze({
     ccipSelector: ROBINHOOD_CCIP_SELECTOR,
     contracts: Object.freeze({
       gateway: getAddress2("0xf27fdA637131E25B2A1b4865ED9597d881980c7E"),
-      legacyGateway: getAddress2(
-        "0x53Dcc4FE04193e489BE537F722F65317DB1E65d8"
-      ),
+      legacyGateways: [
+        getAddress2("0x53Dcc4FE04193e489BE537F722F65317DB1E65d8")
+      ],
       wrappedTao: getAddress2(
         "0xf3081494B87e8D5fb7960f066E931D1D0e6E3d67"
       ),
@@ -156,10 +158,14 @@ var foreverMoneyDeployment = Object.freeze({
     chainId: SUBTENSOR_CHAIN_ID,
     ccipSelector: SUBTENSOR_CCIP_SELECTOR,
     contracts: Object.freeze({
-      gateway: getAddress2("0xcd0C6d98D0A126B1c113d15b4c28F38321437787"),
-      legacyGateway: getAddress2(
-        "0x998f20Fea90bF7792774dECc7f994716442B1705"
-      ),
+      // V5.1 AlphaGateway: multi-validator staked input (tao-bridge 485c898).
+      gateway: getAddress2("0xd5Fa238aa4177f6c1341491969d9cBeec94EEd69"),
+      // V4 and V5 hubs. The spokes still deliver to the V5 hub (their hub
+      // pointer is immutable), so it stays here for delivery tracking.
+      legacyGateways: [
+        getAddress2("0x998f20Fea90bF7792774dECc7f994716442B1705"),
+        getAddress2("0xcd0C6d98D0A126B1c113d15b4c28F38321437787")
+      ],
       alphaVault: getAddress2(
         "0x11837459896D96F821a8D88eC93a3C8D152033D4"
       ),
@@ -368,6 +374,11 @@ var ALPHA_GATEWAY_ABI = Object.freeze([
   "function integratorCut(uint256 amount,uint16 bps) pure returns (uint256)",
   "function quoteBridgeOutWithFee(uint64 destSelector,address token,address recipient,uint256 mintedAmount,uint256 taoAmount,uint256 stakedAlphaRao,(address recipient,uint16 bps) integrator) view returns (uint256 fee,uint256 nativeTopUp,uint256 alphaTopUp,uint256 amountCrossing)",
   "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)",
   "function claimNative(address to)",
   "function claimStaked(address token,bytes32 destColdkey,address to)",
@@ -536,6 +547,7 @@ 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 MAX_PARTNER_FEE_BPS = 1e4;
+var MAX_STAKE_PULLS = 16;
 var NO_PARTNER_FEE = {
   recipient: "0x0000000000000000000000000000000000000000",
   bps: 0
@@ -629,6 +641,27 @@ function sourceNetuid(input) {
   }
   return netuid;
 }
+function stakePullsFor(input, amountRao) {
+  if (input.stakePulls === void 0) return void 0;
+  if (input.source !== "staked") {
+    throw new ForeverMoneyError(
+      "INVALID_TRANSACTION_PLAN",
+      "Stake pulls are only valid for a staked source."
+    );
+  }
+  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(
@@ -700,7 +733,72 @@ function encodeSpokeBridge(token, amountWei, exit, fee) {
     args: [token, amountWei, exit, 0n, fee]
   });
 }
-function encodeHubBridge(destSelector, token, recipient, taoAmount, stakedAlphaRao, minTokenOut, fee) {
+function resolveStakePulls(pulls, amountRao) {
+  if (pulls.length === 0 || pulls.length > MAX_STAKE_PULLS) {
+    throw new ForeverMoneyError(
+      "INVALID_TRANSACTION_PLAN",
+      `Between 1 and ${MAX_STAKE_PULLS} stake pulls are required.`,
+      { count: pulls.length }
+    );
+  }
+  const seen = /* @__PURE__ */ new Set();
+  let total = 0n;
+  const resolved = pulls.map((pull) => {
+    const validator = normalizeBytes32(pull.hotkey, "Stake pull hotkey");
+    if (validator === `0x${"0".repeat(64)}`) {
+      throw new ForeverMoneyError(
+        "INVALID_TRANSACTION_PLAN",
+        "Stake pull hotkey must not be zero."
+      );
+    }
+    const key = validator.toLowerCase();
+    if (seen.has(key)) {
+      throw new ForeverMoneyError(
+        "INVALID_TRANSACTION_PLAN",
+        "Stake pulls must not repeat a hotkey.",
+        { hotkey: validator }
+      );
+    }
+    seen.add(key);
+    if (typeof pull.amountRao !== "bigint" || pull.amountRao <= 0n) {
+      throw new ForeverMoneyError(
+        "INVALID_TRANSACTION_PLAN",
+        "Each stake pull must take a positive amount of RAO.",
+        { hotkey: validator }
+      );
+    }
+    total += pull.amountRao;
+    return { validator, alphaRao: pull.amountRao };
+  });
+  if (total !== amountRao) {
+    throw new ForeverMoneyError(
+      "INVALID_TRANSACTION_PLAN",
+      "Stake pulls must sum to the bridged amount.",
+      { pulledRao: total.toString(), amountRao: amountRao.toString() }
+    );
+  }
+  return resolved;
+}
+function encodeHubBridge(destSelector, token, recipient, taoAmount, stakedAlphaRao, minTokenOut, fee, pulls) {
+  if (pulls !== void 0) {
+    const args2 = [
+      destSelector,
+      token,
+      recipient,
+      taoAmount,
+      pulls,
+      minTokenOut
+    ];
+    return fee.bps === 0 ? encodeFunctionData({
+      abi: alphaAbi,
+      functionName: "bridgeOutFromValidators",
+      args: args2
+    }) : encodeFunctionData({
+      abi: alphaAbi,
+      functionName: "bridgeOutFromValidatorsWithFee",
+      args: [...args2, fee]
+    });
+  }
   const args = [
     destSelector,
     token,
@@ -842,6 +940,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);
@@ -890,6 +989,7 @@ function buildSubtensorToEvmPlan(input) {
   }
   const taoAmount = input.source === "liquid" ? input.amountWei : 0n;
   const stakedAlphaRao = input.source === "staked" ? amountRao : 0n;
+  const pulls = stakePullsFor(input, amountRao);
   const value = taoAmount + taoTopUp + feeWithBuffer(input.exactNetworkFeeWei);
   assertNonNegativeAmount(value, "Transaction value");
   steps.push(
@@ -905,8 +1005,9 @@ function buildSubtensorToEvmPlan(input) {
         recipient,
         taoAmount,
         stakedAlphaRao,
-        input.amountWei,
-        partnerFee
+        minAmountOutWei,
+        partnerFee,
+        pulls
       ),
       value,
       input.estimatedBridgeGas === void 0 ? void 0 : gasLimitWithBuffer(input.estimatedBridgeGas)
@@ -1004,6 +1105,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(
@@ -1057,8 +1159,9 @@ async function prepareSubtensorToEvm(provider, input) {
         recipient,
         taoAmount,
         stakedAlphaRao,
-        input.amountWei,
-        partnerFee
+        minAmountOutWei,
+        partnerFee,
+        stakePullsFor(input, stakedAlphaRao)
       ),
       value
     });
@@ -1673,12 +1776,12 @@ function bridgeMessageIdFromReceipt(direction, receipt) {
   );
   const evmToSubtensor = isEvmToSubtensorDirection(direction);
   const [addresses, contractAbi, eventName] = evmToSubtensor ? [
-    [evm.contracts.legacyGateway, evm.contracts.gateway],
+    [...evm.contracts.legacyGateways, evm.contracts.gateway],
     spokeGatewayAbi,
     "BridgedToFinney"
   ] : [
     [
-      foreverMoneyDeployment.subtensor.contracts.legacyGateway,
+      ...foreverMoneyDeployment.subtensor.contracts.legacyGateways,
       foreverMoneyDeployment.subtensor.contracts.gateway
     ],
     alphaGatewayAbi,
@@ -1840,7 +1943,7 @@ async function getCcipDeliveryStatus(provider, input) {
     );
   }
   const subtensorGateways = [
-    foreverMoneyDeployment.subtensor.contracts.legacyGateway,
+    ...foreverMoneyDeployment.subtensor.contracts.legacyGateways,
     foreverMoneyDeployment.subtensor.contracts.gateway
   ];
   for (const log of receipt.logs) {
@@ -2142,6 +2245,7 @@ export {
   ForeverMoneyError,
   GAS_LIMIT_BUFFER_BPS,
   MAX_PARTNER_FEE_BPS,
+  MAX_STAKE_PULLS,
   MIN_LIQUID_BASE_TO_SUBTENSOR_WEI,
   MIN_LIQUID_EVM_TO_SUBTENSOR_WEI,
   MIN_LIQUID_SUBTENSOR_TO_EVM_WEI,