@forevermoney/sdk 0.1.0 → 0.4.0

package/dist/index.d.cts

@@ -1,10 +1,10 @@
-import { AbstractProvider, TransactionRequest } from 'ethers';
+import { Address, Hex, PublicClient, Chain } from 'viem';
 
-declare function normalizeEvmAddress(value: string): string;
+declare function normalizeEvmAddress(value: string): Address;
 declare function evmToMirrorSS58(evmAddress: string): string;
 declare function normalizeSS58(value: string): string;
 declare function isBittensorSS58(value: string): boolean;
-declare function ss58ToPublicKey(value: string): string;
+declare function ss58ToPublicKey(value: string): Hex;
 
 declare const BASIS_POINTS = 10000n;
 declare const NETWORK_FEE_BUFFER_BPS = 200n;
@@ -16,12 +16,12 @@ 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 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 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 account,address token) 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 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 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)"];
     erc20: readonly ["function allowance(address owner,address spender) view returns (uint256)", "function approve(address spender,uint256 amount) returns (bool)", "function balanceOf(address account) view returns (uint256)"];
-    spokeGateway: readonly ["function ROUTER() view returns (address)", "function BITTENSOR_SELECTOR() view returns (uint64)", "function SUBTENSOR_GATEWAY() view returns (address)", "function quoteBridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) view returns (uint256 fee)", "function bridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) payable returns (bytes32 messageId)", "event BridgedToFinney(address indexed token,address indexed sender,bytes32 indexed ss58,uint256 amount,bytes32 messageId)"];
+    spokeGateway: readonly ["function ROUTER() view returns (address)", "function BITTENSOR_SELECTOR() view returns (uint64)", "function SUBTENSOR_GATEWAY() view returns (address)", "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 bridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) 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)"];
     staking: readonly ["function allowance(address sourceAddress,address spenderAddress,uint256 netuid) view returns (uint256)", "function approve(address spenderAddress,uint256 netuid,uint256 absoluteAmount)", "function getStake(bytes32 hotkey,bytes32 coldkey,uint256 netuid) view returns (uint256)"];
     vaultFactory: readonly ["function create(address owner,bytes32 associatedMiner,address akAddress,address poolManager,address poolAddress,address positionManagerImpl,(address token,uint256 amount)[] stashTokens) payable returns (address manager)", "event SnLiquidityManagerCreated(address indexed manager,address indexed owner,bytes32 associatedMiner,address akAddress,address poolAddress,address poolManager,address positionManager)"];
     vaultManager: readonly ["function claimFees(address akAddress)", "function topUpAk(address akAddress,address token,uint256 amount) payable", "function withdrawFromAkAndPositions(address akAddress,uint256 amount0,uint256 amount1,uint256[] decreaseTokenIds,bool unwrapETH)", "function stake(address akAddress,bytes data)", "function unstake(address akAddress,bytes data)", "function owner() view returns (address)", "event AKStashTopUp(address akAddress,address token,uint256 amount)", "event AKStashWithdraw(address akAddress,address token,uint256 amount)"];
@@ -35,23 +35,26 @@ declare const ROBINHOOD_CCIP_SELECTOR = 6180753054346818345n;
 declare const SUBTENSOR_CCIP_SELECTOR = 2135107236357186872n;
 declare const RAO_PER_TAO = 1000000000n;
 declare const EVM_WEI_PER_RAO = 1000000000n;
-declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.1.0";
+declare const SN80_NETUID = 80n;
+declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.2.0";
 declare const foreverMoneyDeployment: Readonly<{
-    version: "1.1.0";
+    version: "1.2.0";
     base: Readonly<{
         key: "base";
         name: "Base";
         chainId: 8453;
         ccipSelector: 15971525489660198786n;
         contracts: Readonly<{
-            gateway: string;
-            wrappedTao: string;
-            ccipRouter: string;
-            ccipOffRampFromSubtensor: string;
-            vaultFactory: string;
-            vaultManagerImplementation: string;
-            batchLiquidityManagerQuery: string;
-            weth: string;
+            gateway: `0x${string}`;
+            legacyGateway: `0x${string}`;
+            wrappedTao: `0x${string}`;
+            wrappedSn80: `0x${string}`;
+            ccipRouter: `0x${string}`;
+            ccipOffRampFromSubtensor: `0x${string}`;
+            vaultFactory: `0x${string}`;
+            vaultManagerImplementation: `0x${string}`;
+            batchLiquidityManagerQuery: `0x${string}`;
+            weth: `0x${string}`;
         }>;
         deploymentBlock: 50098800;
     }>;
@@ -61,23 +64,26 @@ declare const foreverMoneyDeployment: Readonly<{
         chainId: 4663;
         ccipSelector: 6180753054346818345n;
         contracts: Readonly<{
-            gateway: string;
-            wrappedTao: string;
-            ccipRouter: string;
-            ccipOffRampFromSubtensor: string;
+            gateway: `0x${string}`;
+            legacyGateway: `0x${string}`;
+            wrappedTao: `0x${string}`;
+            ccipRouter: `0x${string}`;
+            ccipOffRampFromSubtensor: `0x${string}`;
         }>;
     }>;
     subtensor: Readonly<{
         chainId: 964;
         ccipSelector: 2135107236357186872n;
         contracts: Readonly<{
-            gateway: string;
-            alphaVault: string;
-            wrappedTao: string;
-            ccipRouter: string;
-            ccipOffRampFromBase: string;
-            ccipOffRampFromRobinhood: string;
-            stakingPrecompile: string;
+            gateway: `0x${string}`;
+            legacyGateway: `0x${string}`;
+            alphaVault: `0x${string}`;
+            wrappedTao: `0x${string}`;
+            wrappedSn80: `0x${string}`;
+            ccipRouter: `0x${string}`;
+            ccipOffRampFromBase: `0x${string}`;
+            ccipOffRampFromRobinhood: `0x${string}`;
+            stakingPrecompile: `0x${string}`;
         }>;
     }>;
 }>;
@@ -111,10 +117,25 @@ interface TransactionPlan {
 
 declare const MIN_LIQUID_EVM_TO_SUBTENSOR_WEI = 10000000000000000n;
 declare const MIN_LIQUID_BASE_TO_SUBTENSOR_WEI = 10000000000000000n;
+declare const MIN_LIQUID_SUBTENSOR_TO_EVM_WEI: bigint;
 type SubtensorDelivery = 'liquid' | 'staked';
 type SubtensorSource = 'liquid' | 'staked';
+type BridgeAsset = 'tao' | 'sn80';
+/**
+ * Optional partner (integrator) fee, charged ON TOP of the bridged amount and
+ * paid to `recipient` on the source chain. The full `amountWei` still crosses.
+ * `bps` is in basis points (1 = 0.01%); the gateway caps it at
+ * `maxIntegratorFeeBps`, which `prepare*` reads and enforces.
+ */
+interface PartnerFee {
+    readonly recipient: string;
+    readonly bps: number;
+}
+declare const MAX_PARTNER_FEE_BPS = 10000;
 interface EvmToSubtensorRequest {
     readonly evmChain: ForeverMoneyEvmChain;
+    readonly asset?: BridgeAsset;
+    readonly partnerFee?: PartnerFee;
     readonly sender: string;
     readonly amountWei: bigint;
     readonly destination: string;
@@ -122,6 +143,8 @@ interface EvmToSubtensorRequest {
 }
 interface SubtensorToEvmRequest {
     readonly evmChain: ForeverMoneyEvmChain;
+    readonly asset?: BridgeAsset;
+    readonly partnerFee?: PartnerFee;
     readonly sender: string;
     readonly recipient: string;
     readonly amountWei: bigint;
@@ -133,8 +156,18 @@ type SubtensorToBaseRequest = Omit<SubtensorToEvmRequest, 'evmChain'>;
 interface BridgePreparation {
     readonly exactNetworkFeeWei: bigint;
     readonly transactionValueWei: bigint;
+    /**
+     * Extra the sender pays for the partner fee, in the units of the source leg:
+     * token wei for an EVM source, alpha (as 18-decimal wei) for a staked source,
+     * TAO wei for a liquid source. Zero when no partner fee is set.
+     */
+    readonly partnerFeeWei: bigint;
     readonly plan: TransactionPlan;
 }
+/** `bps` of `amount`, rounded down: the extra token (spoke) or alpha (hub) pulled on top. */
+declare function partnerFeeCut(amount: bigint, bps: number): bigint;
+/** Extra native TAO a liquid Subtensor source carries for the partner, rounded up to a whole RAO. */
+declare function partnerFeeTaoTopUp(taoAmount: bigint, bps: number): bigint;
 interface BuildEvmToSubtensorPlanRequest extends EvmToSubtensorRequest {
     readonly allowanceWei: bigint;
     readonly exactNetworkFeeWei: bigint;
@@ -164,6 +197,11 @@ interface HttpTransportOptions {
     readonly fetch?: typeof globalThis.fetch;
 }
 declare function http(url: string, options?: HttpTransportOptions): RpcTransport;
+/** Minimal structural interface implemented by ethers JSON-RPC providers. */
+interface LegacyRpcProvider {
+    send(method: string, params: unknown[]): Promise<unknown>;
+}
+type TrackingProvider = PublicClient | LegacyRpcProvider;
 
 interface VaultStashToken {
     readonly token: string;
@@ -260,9 +298,9 @@ type BridgeSourceStatus = (BridgeSourceStatusBase & {
 });
 declare function destinationChainId(direction: BridgeDirection): number;
 declare function sourceChainId(direction: BridgeDirection): number;
-declare function getBridgeSourceStatus(provider: AbstractProvider, input: BridgeSourceStatusRequest): Promise<BridgeSourceStatus>;
-declare function getCcipDeliveryCheckpoint(provider: AbstractProvider, direction: BridgeDirection): Promise<CcipDeliveryCheckpoint>;
-declare function getCcipDeliveryStatus(provider: AbstractProvider, input: CcipDeliveryStatusRequest): Promise<CcipDeliveryStatus>;
+declare function getBridgeSourceStatus(provider: TrackingProvider, input: BridgeSourceStatusRequest): Promise<BridgeSourceStatus>;
+declare function getCcipDeliveryCheckpoint(provider: TrackingProvider, direction: BridgeDirection): Promise<CcipDeliveryCheckpoint>;
+declare function getCcipDeliveryStatus(provider: TrackingProvider, input: CcipDeliveryStatusRequest): Promise<CcipDeliveryStatus>;
 
 interface ForeverMoneyClientOptions {
     readonly transports: {
@@ -289,7 +327,7 @@ interface ForeverMoneyClient {
 }
 declare function createForeverMoneyClient(options: ForeverMoneyClientOptions): ForeverMoneyClient;
 
-type ForeverMoneyErrorCode = 'AMOUNT_BELOW_MINIMUM' | 'AMOUNT_NOT_WHOLE_RAO' | 'AMOUNT_ZERO' | 'CHAIN_MISMATCH' | 'INVALID_ADDRESS' | 'INVALID_BYTES32' | 'INVALID_PROVIDER_RESPONSE' | 'INVALID_SS58' | 'INVALID_TRANSACTION_PLAN' | 'MISSING_TRANSPORT' | 'RPC_ERROR' | 'SIMULATION_REVERTED';
+type ForeverMoneyErrorCode = 'AMOUNT_BELOW_MINIMUM' | 'AMOUNT_NOT_WHOLE_RAO' | 'AMOUNT_ZERO' | 'CHAIN_MISMATCH' | 'INVALID_ADDRESS' | 'INVALID_BYTES32' | 'INVALID_PARTNER_FEE' | 'INVALID_PROVIDER_RESPONSE' | 'INVALID_SS58' | 'INVALID_TRANSACTION_PLAN' | 'MISSING_TRANSPORT' | 'RPC_ERROR' | 'SIMULATION_REVERTED';
 declare class ForeverMoneyError extends Error {
     readonly code: ForeverMoneyErrorCode;
     readonly details: Readonly<Record<string, unknown>> | undefined;
@@ -306,6 +344,23 @@ interface Eip1193TransactionRequest {
     readonly gas?: string;
 }
 declare function toEip1193Transaction(transaction: PreparedTransaction): Eip1193TransactionRequest;
-declare function toEthersTransaction(transaction: PreparedTransaction): Readonly<TransactionRequest>;
+declare function toEthersTransaction(transaction: PreparedTransaction): Readonly<EthersCompatibleTransactionRequest>;
+interface EthersCompatibleTransactionRequest {
+    readonly chainId: number;
+    readonly to: string;
+    readonly data: string;
+    readonly value: bigint;
+    readonly gasLimit?: bigint;
+}
+interface ViemTransactionRequest {
+    readonly chain: Chain;
+    readonly account: Address;
+    readonly chainId: number;
+    readonly to: Address;
+    readonly data: Hex;
+    readonly value: bigint;
+    readonly gas?: bigint;
+}
+declare function toViemTransaction(transaction: PreparedTransaction): Readonly<ViemTransactionRequest>;
 
-export { BASE_CCIP_SELECTOR, BASE_CHAIN_ID, BASIS_POINTS, type BaseToSubtensorRequest, 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 EvmToSubtensorRequest, FOREVERMONEY_DEPLOYMENT_VERSION, type ForeverMoneyClient, type ForeverMoneyClientOptions, type ForeverMoneyDeployment, ForeverMoneyError, type ForeverMoneyErrorCode, type ForeverMoneyEvmChain, GAS_LIMIT_BUFFER_BPS, type HttpTransportOptions, MIN_LIQUID_BASE_TO_SUBTENSOR_WEI, MIN_LIQUID_EVM_TO_SUBTENSOR_WEI, NETWORK_FEE_BUFFER_BPS, type PreparedTransaction, RAO_PER_TAO, ROBINHOOD_CCIP_SELECTOR, ROBINHOOD_CHAIN_ID, type ReceiptLog, type RpcRequest, type RpcTransport, SUBTENSOR_CCIP_SELECTOR, SUBTENSOR_CHAIN_ID, type SubtensorDelivery, type SubtensorSource, type SubtensorToBaseRequest, type SubtensorToEvmRequest, type TransactionAction, type TransactionPlan, type TransactionReceiptLike, type TransactionStep, type TransactionStepKind, type VaultStashToken, type VaultTokenAllowance, 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, sourceChainId, ss58ToPublicKey, toEip1193Transaction, toEthersTransaction, 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, 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 };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { AbstractProvider, TransactionRequest } from 'ethers';
+import { Address, Hex, PublicClient, Chain } from 'viem';
 
-declare function normalizeEvmAddress(value: string): string;
+declare function normalizeEvmAddress(value: string): Address;
 declare function evmToMirrorSS58(evmAddress: string): string;
 declare function normalizeSS58(value: string): string;
 declare function isBittensorSS58(value: string): boolean;
-declare function ss58ToPublicKey(value: string): string;
+declare function ss58ToPublicKey(value: string): Hex;
 
 declare const BASIS_POINTS = 10000n;
 declare const NETWORK_FEE_BUFFER_BPS = 200n;
@@ -16,12 +16,12 @@ 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 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 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 account,address token) 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 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 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)"];
     erc20: readonly ["function allowance(address owner,address spender) view returns (uint256)", "function approve(address spender,uint256 amount) returns (bool)", "function balanceOf(address account) view returns (uint256)"];
-    spokeGateway: readonly ["function ROUTER() view returns (address)", "function BITTENSOR_SELECTOR() view returns (uint64)", "function SUBTENSOR_GATEWAY() view returns (address)", "function quoteBridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) view returns (uint256 fee)", "function bridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) payable returns (bytes32 messageId)", "event BridgedToFinney(address indexed token,address indexed sender,bytes32 indexed ss58,uint256 amount,bytes32 messageId)"];
+    spokeGateway: readonly ["function ROUTER() view returns (address)", "function BITTENSOR_SELECTOR() view returns (uint64)", "function SUBTENSOR_GATEWAY() view returns (address)", "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 bridgeToFinney(address token,uint256 amount,(bytes32 ss58,address evmFallback,bool wantLiquid,uint256 minTaoOut) exit) 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)"];
     staking: readonly ["function allowance(address sourceAddress,address spenderAddress,uint256 netuid) view returns (uint256)", "function approve(address spenderAddress,uint256 netuid,uint256 absoluteAmount)", "function getStake(bytes32 hotkey,bytes32 coldkey,uint256 netuid) view returns (uint256)"];
     vaultFactory: readonly ["function create(address owner,bytes32 associatedMiner,address akAddress,address poolManager,address poolAddress,address positionManagerImpl,(address token,uint256 amount)[] stashTokens) payable returns (address manager)", "event SnLiquidityManagerCreated(address indexed manager,address indexed owner,bytes32 associatedMiner,address akAddress,address poolAddress,address poolManager,address positionManager)"];
     vaultManager: readonly ["function claimFees(address akAddress)", "function topUpAk(address akAddress,address token,uint256 amount) payable", "function withdrawFromAkAndPositions(address akAddress,uint256 amount0,uint256 amount1,uint256[] decreaseTokenIds,bool unwrapETH)", "function stake(address akAddress,bytes data)", "function unstake(address akAddress,bytes data)", "function owner() view returns (address)", "event AKStashTopUp(address akAddress,address token,uint256 amount)", "event AKStashWithdraw(address akAddress,address token,uint256 amount)"];
@@ -35,23 +35,26 @@ declare const ROBINHOOD_CCIP_SELECTOR = 6180753054346818345n;
 declare const SUBTENSOR_CCIP_SELECTOR = 2135107236357186872n;
 declare const RAO_PER_TAO = 1000000000n;
 declare const EVM_WEI_PER_RAO = 1000000000n;
-declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.1.0";
+declare const SN80_NETUID = 80n;
+declare const FOREVERMONEY_DEPLOYMENT_VERSION: "1.2.0";
 declare const foreverMoneyDeployment: Readonly<{
-    version: "1.1.0";
+    version: "1.2.0";
     base: Readonly<{
         key: "base";
         name: "Base";
         chainId: 8453;
         ccipSelector: 15971525489660198786n;
         contracts: Readonly<{
-            gateway: string;
-            wrappedTao: string;
-            ccipRouter: string;
-            ccipOffRampFromSubtensor: string;
-            vaultFactory: string;
-            vaultManagerImplementation: string;
-            batchLiquidityManagerQuery: string;
-            weth: string;
+            gateway: `0x${string}`;
+            legacyGateway: `0x${string}`;
+            wrappedTao: `0x${string}`;
+            wrappedSn80: `0x${string}`;
+            ccipRouter: `0x${string}`;
+            ccipOffRampFromSubtensor: `0x${string}`;
+            vaultFactory: `0x${string}`;
+            vaultManagerImplementation: `0x${string}`;
+            batchLiquidityManagerQuery: `0x${string}`;
+            weth: `0x${string}`;
         }>;
         deploymentBlock: 50098800;
     }>;
@@ -61,23 +64,26 @@ declare const foreverMoneyDeployment: Readonly<{
         chainId: 4663;
         ccipSelector: 6180753054346818345n;
         contracts: Readonly<{
-            gateway: string;
-            wrappedTao: string;
-            ccipRouter: string;
-            ccipOffRampFromSubtensor: string;
+            gateway: `0x${string}`;
+            legacyGateway: `0x${string}`;
+            wrappedTao: `0x${string}`;
+            ccipRouter: `0x${string}`;
+            ccipOffRampFromSubtensor: `0x${string}`;
         }>;
     }>;
     subtensor: Readonly<{
         chainId: 964;
         ccipSelector: 2135107236357186872n;
         contracts: Readonly<{
-            gateway: string;
-            alphaVault: string;
-            wrappedTao: string;
-            ccipRouter: string;
-            ccipOffRampFromBase: string;
-            ccipOffRampFromRobinhood: string;
-            stakingPrecompile: string;
+            gateway: `0x${string}`;
+            legacyGateway: `0x${string}`;
+            alphaVault: `0x${string}`;
+            wrappedTao: `0x${string}`;
+            wrappedSn80: `0x${string}`;
+            ccipRouter: `0x${string}`;
+            ccipOffRampFromBase: `0x${string}`;
+            ccipOffRampFromRobinhood: `0x${string}`;
+            stakingPrecompile: `0x${string}`;
         }>;
     }>;
 }>;
@@ -111,10 +117,25 @@ interface TransactionPlan {
 
 declare const MIN_LIQUID_EVM_TO_SUBTENSOR_WEI = 10000000000000000n;
 declare const MIN_LIQUID_BASE_TO_SUBTENSOR_WEI = 10000000000000000n;
+declare const MIN_LIQUID_SUBTENSOR_TO_EVM_WEI: bigint;
 type SubtensorDelivery = 'liquid' | 'staked';
 type SubtensorSource = 'liquid' | 'staked';
+type BridgeAsset = 'tao' | 'sn80';
+/**
+ * Optional partner (integrator) fee, charged ON TOP of the bridged amount and
+ * paid to `recipient` on the source chain. The full `amountWei` still crosses.
+ * `bps` is in basis points (1 = 0.01%); the gateway caps it at
+ * `maxIntegratorFeeBps`, which `prepare*` reads and enforces.
+ */
+interface PartnerFee {
+    readonly recipient: string;
+    readonly bps: number;
+}
+declare const MAX_PARTNER_FEE_BPS = 10000;
 interface EvmToSubtensorRequest {
     readonly evmChain: ForeverMoneyEvmChain;
+    readonly asset?: BridgeAsset;
+    readonly partnerFee?: PartnerFee;
     readonly sender: string;
     readonly amountWei: bigint;
     readonly destination: string;
@@ -122,6 +143,8 @@ interface EvmToSubtensorRequest {
 }
 interface SubtensorToEvmRequest {
     readonly evmChain: ForeverMoneyEvmChain;
+    readonly asset?: BridgeAsset;
+    readonly partnerFee?: PartnerFee;
     readonly sender: string;
     readonly recipient: string;
     readonly amountWei: bigint;
@@ -133,8 +156,18 @@ type SubtensorToBaseRequest = Omit<SubtensorToEvmRequest, 'evmChain'>;
 interface BridgePreparation {
     readonly exactNetworkFeeWei: bigint;
     readonly transactionValueWei: bigint;
+    /**
+     * Extra the sender pays for the partner fee, in the units of the source leg:
+     * token wei for an EVM source, alpha (as 18-decimal wei) for a staked source,
+     * TAO wei for a liquid source. Zero when no partner fee is set.
+     */
+    readonly partnerFeeWei: bigint;
     readonly plan: TransactionPlan;
 }
+/** `bps` of `amount`, rounded down: the extra token (spoke) or alpha (hub) pulled on top. */
+declare function partnerFeeCut(amount: bigint, bps: number): bigint;
+/** Extra native TAO a liquid Subtensor source carries for the partner, rounded up to a whole RAO. */
+declare function partnerFeeTaoTopUp(taoAmount: bigint, bps: number): bigint;
 interface BuildEvmToSubtensorPlanRequest extends EvmToSubtensorRequest {
     readonly allowanceWei: bigint;
     readonly exactNetworkFeeWei: bigint;
@@ -164,6 +197,11 @@ interface HttpTransportOptions {
     readonly fetch?: typeof globalThis.fetch;
 }
 declare function http(url: string, options?: HttpTransportOptions): RpcTransport;
+/** Minimal structural interface implemented by ethers JSON-RPC providers. */
+interface LegacyRpcProvider {
+    send(method: string, params: unknown[]): Promise<unknown>;
+}
+type TrackingProvider = PublicClient | LegacyRpcProvider;
 
 interface VaultStashToken {
     readonly token: string;
@@ -260,9 +298,9 @@ type BridgeSourceStatus = (BridgeSourceStatusBase & {
 });
 declare function destinationChainId(direction: BridgeDirection): number;
 declare function sourceChainId(direction: BridgeDirection): number;
-declare function getBridgeSourceStatus(provider: AbstractProvider, input: BridgeSourceStatusRequest): Promise<BridgeSourceStatus>;
-declare function getCcipDeliveryCheckpoint(provider: AbstractProvider, direction: BridgeDirection): Promise<CcipDeliveryCheckpoint>;
-declare function getCcipDeliveryStatus(provider: AbstractProvider, input: CcipDeliveryStatusRequest): Promise<CcipDeliveryStatus>;
+declare function getBridgeSourceStatus(provider: TrackingProvider, input: BridgeSourceStatusRequest): Promise<BridgeSourceStatus>;
+declare function getCcipDeliveryCheckpoint(provider: TrackingProvider, direction: BridgeDirection): Promise<CcipDeliveryCheckpoint>;
+declare function getCcipDeliveryStatus(provider: TrackingProvider, input: CcipDeliveryStatusRequest): Promise<CcipDeliveryStatus>;
 
 interface ForeverMoneyClientOptions {
     readonly transports: {
@@ -289,7 +327,7 @@ interface ForeverMoneyClient {
 }
 declare function createForeverMoneyClient(options: ForeverMoneyClientOptions): ForeverMoneyClient;
 
-type ForeverMoneyErrorCode = 'AMOUNT_BELOW_MINIMUM' | 'AMOUNT_NOT_WHOLE_RAO' | 'AMOUNT_ZERO' | 'CHAIN_MISMATCH' | 'INVALID_ADDRESS' | 'INVALID_BYTES32' | 'INVALID_PROVIDER_RESPONSE' | 'INVALID_SS58' | 'INVALID_TRANSACTION_PLAN' | 'MISSING_TRANSPORT' | 'RPC_ERROR' | 'SIMULATION_REVERTED';
+type ForeverMoneyErrorCode = 'AMOUNT_BELOW_MINIMUM' | 'AMOUNT_NOT_WHOLE_RAO' | 'AMOUNT_ZERO' | 'CHAIN_MISMATCH' | 'INVALID_ADDRESS' | 'INVALID_BYTES32' | 'INVALID_PARTNER_FEE' | 'INVALID_PROVIDER_RESPONSE' | 'INVALID_SS58' | 'INVALID_TRANSACTION_PLAN' | 'MISSING_TRANSPORT' | 'RPC_ERROR' | 'SIMULATION_REVERTED';
 declare class ForeverMoneyError extends Error {
     readonly code: ForeverMoneyErrorCode;
     readonly details: Readonly<Record<string, unknown>> | undefined;
@@ -306,6 +344,23 @@ interface Eip1193TransactionRequest {
     readonly gas?: string;
 }
 declare function toEip1193Transaction(transaction: PreparedTransaction): Eip1193TransactionRequest;
-declare function toEthersTransaction(transaction: PreparedTransaction): Readonly<TransactionRequest>;
+declare function toEthersTransaction(transaction: PreparedTransaction): Readonly<EthersCompatibleTransactionRequest>;
+interface EthersCompatibleTransactionRequest {
+    readonly chainId: number;
+    readonly to: string;
+    readonly data: string;
+    readonly value: bigint;
+    readonly gasLimit?: bigint;
+}
+interface ViemTransactionRequest {
+    readonly chain: Chain;
+    readonly account: Address;
+    readonly chainId: number;
+    readonly to: Address;
+    readonly data: Hex;
+    readonly value: bigint;
+    readonly gas?: bigint;
+}
+declare function toViemTransaction(transaction: PreparedTransaction): Readonly<ViemTransactionRequest>;
 
-export { BASE_CCIP_SELECTOR, BASE_CHAIN_ID, BASIS_POINTS, type BaseToSubtensorRequest, 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 EvmToSubtensorRequest, FOREVERMONEY_DEPLOYMENT_VERSION, type ForeverMoneyClient, type ForeverMoneyClientOptions, type ForeverMoneyDeployment, ForeverMoneyError, type ForeverMoneyErrorCode, type ForeverMoneyEvmChain, GAS_LIMIT_BUFFER_BPS, type HttpTransportOptions, MIN_LIQUID_BASE_TO_SUBTENSOR_WEI, MIN_LIQUID_EVM_TO_SUBTENSOR_WEI, NETWORK_FEE_BUFFER_BPS, type PreparedTransaction, RAO_PER_TAO, ROBINHOOD_CCIP_SELECTOR, ROBINHOOD_CHAIN_ID, type ReceiptLog, type RpcRequest, type RpcTransport, SUBTENSOR_CCIP_SELECTOR, SUBTENSOR_CHAIN_ID, type SubtensorDelivery, type SubtensorSource, type SubtensorToBaseRequest, type SubtensorToEvmRequest, type TransactionAction, type TransactionPlan, type TransactionReceiptLike, type TransactionStep, type TransactionStepKind, type VaultStashToken, type VaultTokenAllowance, 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, sourceChainId, ss58ToPublicKey, toEip1193Transaction, toEthersTransaction, 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, 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 };