@aspan/sdk 0.1.7 → 0.2.0

package/dist/index.d.ts

@@ -71,21 +71,29 @@ interface StabilityMode2Info {
 interface MintApUSDParams {
     lstToken: Address;
     lstAmount: bigint;
+    /** Minimum apUSD output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for redeeming apUSD */
 interface RedeemApUSDParams {
     lstToken: Address;
     apUSDAmount: bigint;
+    /** Minimum LST output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for minting xBNB */
 interface MintXBNBParams {
     lstToken: Address;
     lstAmount: bigint;
+    /** Minimum xBNB output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for redeeming xBNB */
 interface RedeemXBNBParams {
     lstToken: Address;
     xBNBAmount: bigint;
+    /** Minimum LST output for slippage protection (default: 0n) */
+    minOut?: bigint;
 }
 /** Parameters for depositing to stability pool */
 interface DepositParams {
@@ -189,6 +197,200 @@ interface TransactionReceipt {
     transactionHash: Hash;
     status: "success" | "reverted";
 }
+/** Router swap parameters */
+interface RouterSwapParams {
+    /** Input token address (address(0) for native BNB) */
+    inputToken: Address;
+    /** Amount of input token */
+    inputAmount: bigint;
+    /** Target LST address (address(0) uses default LST) */
+    targetLST: Address;
+    /** Minimum LST to receive from swap (slippage protection) */
+    minLSTOut: bigint;
+    /** PancakeSwap V3 pool fee tier (500, 2500, 10000) */
+    poolFee: number;
+    /** true = PancakeSwap V2, false = V3 */
+    useV2: boolean;
+}
+/** Router mint parameters */
+interface RouterMintParams {
+    /** true = mint xBNB, false = mint apUSD */
+    mintXBNB: boolean;
+    /** Minimum output to receive (slippage protection) */
+    minMintOut: bigint;
+    /** Recipient of minted tokens (address(0) = msg.sender) */
+    recipient: Address;
+    /** Transaction deadline timestamp */
+    deadline: bigint;
+}
+/** Parameters for swapAndMint functions */
+interface SwapAndMintParams {
+    swapParams: RouterSwapParams;
+    mintParams: RouterMintParams;
+}
+/** Parameters for stakeAndMint function */
+interface StakeAndMintParams {
+    /** Target LST (slisBNB, asBNB, wclisBNB) */
+    targetLST: Address;
+    /** true = mint xBNB, false = mint apUSD */
+    mintXBNB: boolean;
+    /** Minimum output to receive */
+    minMintOut: bigint;
+    /** Transaction deadline timestamp */
+    deadline: bigint;
+    /** Native BNB amount to stake */
+    value: bigint;
+}
+/** Parameters for simplified swap and mint functions */
+interface SwapAndMintDefaultParams {
+    /** Input token address (address(0) for native BNB) */
+    inputToken: Address;
+    /** Amount of input token */
+    inputAmount: bigint;
+    /** Minimum output to receive */
+    minMintOut: bigint;
+    /** Transaction deadline timestamp */
+    deadline: bigint;
+    /** Native BNB amount (if inputToken is address(0)) */
+    value?: bigint;
+}
+/** Parameters for router direct mint functions */
+interface RouterMintApUSDParams {
+    /** LST token address */
+    lst: Address;
+    /** Amount of LST to deposit */
+    lstAmount: bigint;
+    /** Minimum apUSD to receive */
+    minOut?: bigint;
+}
+/** Parameters for router direct mint xBNB functions */
+interface RouterMintXBNBParams {
+    /** LST token address */
+    lst: Address;
+    /** Amount of LST to deposit */
+    lstAmount: bigint;
+    /** Minimum xBNB to receive */
+    minOut?: bigint;
+}
+/** Parameters for router redeem apUSD functions */
+interface RouterRedeemApUSDParams {
+    /** LST token to receive */
+    lst: Address;
+    /** Amount of apUSD to redeem */
+    apUSDAmount: bigint;
+    /** Minimum LST to receive */
+    minOut?: bigint;
+}
+/** Parameters for router redeem xBNB functions */
+interface RouterRedeemXBNBParams {
+    /** LST token to receive */
+    lst: Address;
+    /** Amount of xBNB to redeem */
+    xBNBAmount: bigint;
+    /** Minimum LST to receive */
+    minOut?: bigint;
+}
+/** Parameters for redeemAndSwap functions */
+interface RouterRedeemAndSwapParams {
+    /** LST to redeem */
+    lst: Address;
+    /** Amount to redeem (apUSD or xBNB) */
+    amount: bigint;
+    /** Output token (address(0) for native BNB) */
+    outputToken: Address;
+    /** Minimum output to receive */
+    minOut: bigint;
+    /** Transaction deadline timestamp */
+    deadline: bigint;
+    /** true = PancakeSwap V2, false = V3 */
+    useV2: boolean;
+    /** V3 pool fee tier (ignored if useV2) */
+    poolFee: number;
+}
+/** Parameters for redeemAndUnstake functions */
+interface RouterRedeemAndUnstakeParams {
+    /** LST to redeem */
+    lst: Address;
+    /** Amount to redeem (apUSD or xBNB) */
+    amount: bigint;
+    /** Minimum BNB to receive */
+    minBNBOut: bigint;
+    /** Transaction deadline timestamp */
+    deadline: bigint;
+}
+/** Withdrawal request status */
+interface WithdrawalRequestInfo {
+    /** Whether the request can be claimed */
+    isClaimable: boolean;
+    /** Amount of BNB to receive */
+    bnbAmount: bigint;
+}
+/** Expected output from swap and mint */
+interface ExpectedOutput {
+    /** Expected LST from swap */
+    expectedLST: bigint;
+    /** Expected apUSD/xBNB from mint */
+    expectedMint: bigint;
+}
+/** SwapAndMint event */
+interface SwapAndMintEvent {
+    user: Address;
+    inputToken: Address;
+    inputAmount: bigint;
+    targetLST: Address;
+    lstAmount: bigint;
+    mintedToken: Address;
+    mintedAmount: bigint;
+}
+/** StakeAndMint event */
+interface StakeAndMintEvent {
+    user: Address;
+    bnbAmount: bigint;
+    targetLST: Address;
+    lstAmount: bigint;
+    mintedToken: Address;
+    mintedAmount: bigint;
+}
+/** Router Mint event */
+interface RouterMintEvent {
+    user: Address;
+    lst: Address;
+    lstAmount: bigint;
+    mintedToken: Address;
+    mintedAmount: bigint;
+}
+/** Router Redeem event */
+interface RouterRedeemEvent {
+    user: Address;
+    redeemedToken: Address;
+    redeemedAmount: bigint;
+    lst: Address;
+    lstAmount: bigint;
+}
+/** RedeemAndSwap event */
+interface RedeemAndSwapEvent {
+    user: Address;
+    redeemedToken: Address;
+    redeemedAmount: bigint;
+    lst: Address;
+    lstAmount: bigint;
+    outputToken: Address;
+    outputAmount: bigint;
+}
+/** UnstakeRequested event */
+interface UnstakeRequestedEvent {
+    user: Address;
+    requestIndex: bigint;
+    redeemedToken: Address;
+    redeemedAmount: bigint;
+    slisBNBAmount: bigint;
+}
+/** UnstakeClaimed event */
+interface UnstakeClaimedEvent {
+    user: Address;
+    requestIndex: bigint;
+    bnbAmount: bigint;
+}
 
 interface AspanClientConfig {
     /** Diamond contract address */
@@ -350,6 +552,165 @@ declare function createAspanTestnetReadClient(diamondAddress: Address, rpcUrl?:
  */
 declare function createAspanTestnetClient(diamondAddress: Address, account: Account, rpcUrl?: string): AspanClient;
 
+interface AspanRouterClientConfig {
+    /** Router contract address */
+    routerAddress: Address;
+    /** Chain to connect to */
+    chain?: Chain;
+    /** RPC URL (optional, uses default if not provided) */
+    rpcUrl?: string;
+}
+interface AspanRouterWriteClientConfig extends AspanRouterClientConfig {
+    /** Account for signing transactions (required if walletClient not provided) */
+    account?: Account;
+    /** External wallet client (for browser environments with wagmi/rainbowkit) */
+    walletClient?: WalletClient<Transport, Chain, Account>;
+}
+/**
+ * Read-only client for querying AspanRouter state
+ */
+declare class AspanRouterReadClient {
+    protected readonly publicClient: PublicClient;
+    protected readonly routerAddress: Address;
+    protected readonly chain: Chain;
+    constructor(config: AspanRouterClientConfig);
+    /**
+     * Get the default LST address
+     */
+    getDefaultLST(): Promise<Address>;
+    /**
+     * Check if an input token is supported
+     */
+    isSupportedInputToken(token: Address): Promise<boolean>;
+    /**
+     * Check if an LST is supported
+     */
+    isSupportedLST(lst: Address): Promise<boolean>;
+    /**
+     * Get the Diamond contract address
+     */
+    getDiamond(): Promise<Address>;
+    /**
+     * Get expected output from a swap and mint operation
+     */
+    getExpectedOutput(inputToken: Address, inputAmount: bigint, targetLST: Address, mintXBNB: boolean): Promise<ExpectedOutput>;
+    /**
+     * Get user's withdrawal request indices
+     */
+    getUserWithdrawalIndices(user: Address): Promise<bigint[]>;
+    /**
+     * Get withdrawal request status
+     */
+    getWithdrawalStatus(requestIndex: bigint): Promise<WithdrawalRequestInfo>;
+    getWBNB(): Promise<Address>;
+    getUSDT(): Promise<Address>;
+    getUSDC(): Promise<Address>;
+    getSlisBNB(): Promise<Address>;
+    getAsBNB(): Promise<Address>;
+    getWclisBNB(): Promise<Address>;
+    getApUSD(): Promise<Address>;
+    getXBNB(): Promise<Address>;
+}
+/**
+ * Full client with write capabilities for AspanRouter
+ */
+declare class AspanRouterClient extends AspanRouterReadClient {
+    private readonly walletClient;
+    constructor(config: AspanRouterWriteClientConfig);
+    /**
+     * Swap input token to LST and mint apUSD
+     */
+    swapAndMintApUSD(params: SwapAndMintParams): Promise<Hash>;
+    /**
+     * Swap input token to LST and mint xBNB
+     */
+    swapAndMintXBNB(params: SwapAndMintParams): Promise<Hash>;
+    /**
+     * Stake native BNB directly to LST and mint
+     */
+    stakeAndMint(params: StakeAndMintParams): Promise<Hash>;
+    /**
+     * Swap input token and mint apUSD using default LST
+     */
+    swapAndMintApUSDDefault(params: SwapAndMintDefaultParams): Promise<Hash>;
+    /**
+     * Swap input token and mint xBNB using default LST
+     */
+    swapAndMintXBNBDefault(params: SwapAndMintDefaultParams): Promise<Hash>;
+    /**
+     * Stake native BNB and mint apUSD using default LST
+     */
+    stakeAndMintApUSD(minMintOut: bigint, value: bigint): Promise<Hash>;
+    /**
+     * Stake native BNB and mint xBNB using default LST
+     */
+    stakeAndMintXBNB(minMintOut: bigint, value: bigint): Promise<Hash>;
+    /**
+     * Mint apUSD by providing LST directly (no swap)
+     */
+    mintApUSD(params: RouterMintApUSDParams): Promise<Hash>;
+    /**
+     * Mint xBNB by providing LST directly (no swap)
+     */
+    mintXBNB(params: RouterMintXBNBParams): Promise<Hash>;
+    /**
+     * Redeem apUSD for LST (no swap)
+     */
+    redeemApUSD(params: RouterRedeemApUSDParams): Promise<Hash>;
+    /**
+     * Redeem xBNB for LST (no swap)
+     */
+    redeemXBNB(params: RouterRedeemXBNBParams): Promise<Hash>;
+    /**
+     * Redeem apUSD and swap LST to output token
+     */
+    redeemApUSDAndSwap(params: RouterRedeemAndSwapParams): Promise<Hash>;
+    /**
+     * Redeem xBNB and swap LST to output token
+     */
+    redeemXBNBAndSwap(params: RouterRedeemAndSwapParams): Promise<Hash>;
+    /**
+     * Redeem apUSD and instantly unstake LST to native BNB via DEX
+     */
+    redeemApUSDAndUnstake(params: RouterRedeemAndUnstakeParams): Promise<Hash>;
+    /**
+     * Redeem xBNB and instantly unstake LST to native BNB via DEX
+     */
+    redeemXBNBAndUnstake(params: RouterRedeemAndUnstakeParams): Promise<Hash>;
+    /**
+     * Redeem apUSD and request native unstake from Lista (starts unbonding period)
+     */
+    redeemApUSDAndRequestUnstake(apUSDAmount: bigint): Promise<Hash>;
+    /**
+     * Redeem xBNB and request native unstake from Lista (starts unbonding period)
+     */
+    redeemXBNBAndRequestUnstake(xBNBAmount: bigint): Promise<Hash>;
+    /**
+     * Claim BNB after unbonding period completes
+     */
+    claimUnstake(requestIndex: bigint): Promise<Hash>;
+    /**
+     * Wait for transaction confirmation
+     */
+    waitForTransaction(hash: Hash): Promise<viem.TransactionReceipt>;
+}
+/**
+ * Create a read-only router client for BSC mainnet
+ */
+declare function createRouterReadClient(routerAddress: Address, rpcUrl?: string): AspanRouterReadClient;
+/**
+ * Create a full router client for BSC mainnet
+ */
+declare function createRouterClient(routerAddress: Address, account: Account, rpcUrl?: string): AspanRouterClient;
+/**
+ * Create a read-only router client for BSC testnet
+ */
+declare function createRouterTestnetReadClient(routerAddress: Address, rpcUrl?: string): AspanRouterReadClient;
+/**
+ * Create a full router client for BSC testnet
+ */
+declare function createRouterTestnetClient(routerAddress: Address, account: Account, rpcUrl?: string): AspanRouterClient;
+
 /**
  * Combined Diamond ABI - includes all facet functions
  * This ABI is used to interact with the Aspan Diamond contract
@@ -365,6 +726,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_lstAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "apUSDAmount";
@@ -383,6 +748,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_apUSDAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "lstAmount";
@@ -401,6 +770,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_lstAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "xBNBAmount";
@@ -419,6 +792,10 @@ declare const DiamondABI: readonly [{
         readonly name: "_xBNBAmount";
         readonly type: "uint256";
         readonly internalType: "uint256";
+    }, {
+        readonly name: "_minOut";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
     }];
     readonly outputs: readonly [{
         readonly name: "lstAmount";
@@ -1273,6 +1650,835 @@ declare const DiamondABI: readonly [{
     readonly stateMutability: "view";
 }];
 
+/**
+ * AspanRouter ABI
+ * Periphery contract for one-click swap+mint operations
+ */
+declare const RouterABI: readonly [{
+    readonly type: "function";
+    readonly name: "swapAndMintApUSD";
+    readonly inputs: readonly [{
+        readonly name: "swapParams";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "inputToken";
+            readonly type: "address";
+        }, {
+            readonly name: "inputAmount";
+            readonly type: "uint256";
+        }, {
+            readonly name: "targetLST";
+            readonly type: "address";
+        }, {
+            readonly name: "minLSTOut";
+            readonly type: "uint256";
+        }, {
+            readonly name: "poolFee";
+            readonly type: "uint24";
+        }, {
+            readonly name: "useV2";
+            readonly type: "bool";
+        }];
+    }, {
+        readonly name: "mintParams";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "mintXBNB";
+            readonly type: "bool";
+        }, {
+            readonly name: "minMintOut";
+            readonly type: "uint256";
+        }, {
+            readonly name: "recipient";
+            readonly type: "address";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "swapAndMintXBNB";
+    readonly inputs: readonly [{
+        readonly name: "swapParams";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "inputToken";
+            readonly type: "address";
+        }, {
+            readonly name: "inputAmount";
+            readonly type: "uint256";
+        }, {
+            readonly name: "targetLST";
+            readonly type: "address";
+        }, {
+            readonly name: "minLSTOut";
+            readonly type: "uint256";
+        }, {
+            readonly name: "poolFee";
+            readonly type: "uint24";
+        }, {
+            readonly name: "useV2";
+            readonly type: "bool";
+        }];
+    }, {
+        readonly name: "mintParams";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "mintXBNB";
+            readonly type: "bool";
+        }, {
+            readonly name: "minMintOut";
+            readonly type: "uint256";
+        }, {
+            readonly name: "recipient";
+            readonly type: "address";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "stakeAndMint";
+    readonly inputs: readonly [{
+        readonly name: "targetLST";
+        readonly type: "address";
+    }, {
+        readonly name: "mintXBNB";
+        readonly type: "bool";
+    }, {
+        readonly name: "minMintOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "mintedAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "swapAndMintApUSDDefault";
+    readonly inputs: readonly [{
+        readonly name: "inputToken";
+        readonly type: "address";
+    }, {
+        readonly name: "inputAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minMintOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "swapAndMintXBNBDefault";
+    readonly inputs: readonly [{
+        readonly name: "inputToken";
+        readonly type: "address";
+    }, {
+        readonly name: "inputAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minMintOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "stakeAndMintApUSD";
+    readonly inputs: readonly [{
+        readonly name: "minMintOut";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "stakeAndMintXBNB";
+    readonly inputs: readonly [{
+        readonly name: "minMintOut";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "payable";
+}, {
+    readonly type: "function";
+    readonly name: "mintApUSD";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minOut";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "mintXBNB";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minOut";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemApUSD";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minOut";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemXBNB";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minOut";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemApUSDAndSwap";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "outputToken";
+        readonly type: "address";
+    }, {
+        readonly name: "minOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "useV2";
+        readonly type: "bool";
+    }, {
+        readonly name: "poolFee";
+        readonly type: "uint24";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "outputAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemXBNBAndSwap";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "outputToken";
+        readonly type: "address";
+    }, {
+        readonly name: "minOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "useV2";
+        readonly type: "bool";
+    }, {
+        readonly name: "poolFee";
+        readonly type: "uint24";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "outputAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemApUSDAndUnstake";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minBNBOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "bnbAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemXBNBAndUnstake";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }, {
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "minBNBOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "bnbAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemApUSDAndRequestUnstake";
+    readonly inputs: readonly [{
+        readonly name: "apUSDAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "requestIndex";
+        readonly type: "uint256";
+    }, {
+        readonly name: "slisBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "redeemXBNBAndRequestUnstake";
+    readonly inputs: readonly [{
+        readonly name: "xBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "requestIndex";
+        readonly type: "uint256";
+    }, {
+        readonly name: "slisBNBAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "claimUnstake";
+    readonly inputs: readonly [{
+        readonly name: "requestIndex";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "bnbAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "defaultLST";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "supportedInputTokens";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "supportedLSTs";
+    readonly inputs: readonly [{
+        readonly name: "lst";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "diamond";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getExpectedOutput";
+    readonly inputs: readonly [{
+        readonly name: "inputToken";
+        readonly type: "address";
+    }, {
+        readonly name: "inputAmount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "targetLST";
+        readonly type: "address";
+    }, {
+        readonly name: "mintXBNB";
+        readonly type: "bool";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "expectedLST";
+        readonly type: "uint256";
+    }, {
+        readonly name: "expectedMint";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getUserWithdrawalIndices";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "getWithdrawalStatus";
+    readonly inputs: readonly [{
+        readonly name: "requestIndex";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "isClaimable";
+        readonly type: "bool";
+    }, {
+        readonly name: "bnbAmount";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "wbnb";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "usdt";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "usdc";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "slisBNB";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "asBNB";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "wclisBNB";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "apUSD";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "xBNB";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "event";
+    readonly name: "SwapAndMint";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "inputToken";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "inputAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "targetLST";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "mintedToken";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "mintedAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "StakeAndMint";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "bnbAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "targetLST";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "mintedToken";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "mintedAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Mint";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "lst";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "mintedToken";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "mintedAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "Redeem";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "redeemedToken";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "redeemedAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "lst";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "RedeemAndSwap";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "redeemedToken";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "redeemedAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "lst";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "lstAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "outputToken";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "outputAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "UnstakeRequested";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "requestIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "redeemedToken";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "redeemedAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }, {
+        readonly name: "slisBNBAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "UnstakeClaimed";
+    readonly inputs: readonly [{
+        readonly name: "user";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "requestIndex";
+        readonly type: "uint256";
+        readonly indexed: true;
+    }, {
+        readonly name: "bnbAmount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "DefaultLSTUpdated";
+    readonly inputs: readonly [{
+        readonly name: "oldLST";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "newLST";
+        readonly type: "address";
+        readonly indexed: true;
+    }];
+}, {
+    readonly type: "error";
+    readonly name: "UnsupportedInputToken";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "UnsupportedLST";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "DeadlineExpired";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InsufficientOutput";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ZeroAmount";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidRecipient";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "SwapFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "MintFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "NativeTransferFailed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidPoolFee";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "DefaultLSTNotSet";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidWithdrawalRequest";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "WithdrawalNotClaimable";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "WithdrawalAlreadyClaimed";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "OnlySlisBNBSupported";
+    readonly inputs: readonly [];
+}];
+
 /**
  * Aspan SDK
  * TypeScript SDK for interacting with the Aspan Protocol on BNB Chain
@@ -1304,8 +2510,8 @@ declare function parseAmount(amount: string): bigint;
 declare function formatFeeBPS(bps: number): string;
 /**
  * Format collateral ratio to percentage string
- * @param cr Collateral ratio (18 decimals, 1e18 = 100%)
- * @returns Percentage string (e.g., "150%")
+ * @param cr Collateral ratio in BPS (10000 = 100%, contract format)
+ * @returns Percentage string (e.g., "150.00%")
  */
 declare function formatCR(cr: bigint): string;
 /**
@@ -1323,4 +2529,4 @@ declare function formatPriceUSD(price: bigint): string;
  */
 declare function calculateAPY(previousRate: bigint, currentRate: bigint, periodDays: number): number;
 
-export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, type AspanWriteClientConfig, BPS_PRECISION, type BigIntString, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemApUSDParams, type RedeemXBNBParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UserStabilityPoolPosition, type WithdrawAssetsParams, type WithdrawParams, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanReadClient, createAspanTestnetClient, createAspanTestnetReadClient, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, parseAmount };
+export { type ApUSDMintedEvent, type ApUSDRedeemedEvent, AspanClient, type AspanClientConfig, AspanReadClient, AspanRouterClient, type AspanRouterClientConfig, AspanRouterReadClient, type AspanRouterWriteClientConfig, type AspanWriteClientConfig, BPS_PRECISION, type BigIntString, type CurrentFeeTier, type CurrentFees, type DepositParams, type DepositedEvent, DiamondABI, type ExpectedOutput, type FeeTier, type LSTInfo, type LSTYieldInfo, type MintApUSDParams, type MintXBNBParams, type OracleBounds, PRECISION, PRICE_PRECISION, type ProtocolStats, type RedeemAndSwapEvent, type RedeemApUSDParams, type RedeemXBNBParams, RouterABI, type RouterMintApUSDParams, type RouterMintEvent, type RouterMintParams, type RouterMintXBNBParams, type RouterRedeemAndSwapParams, type RouterRedeemAndUnstakeParams, type RouterRedeemApUSDParams, type RouterRedeemEvent, type RouterRedeemXBNBParams, type RouterSwapParams, type StabilityMode2Info, type StabilityModeInfo, type StabilityPoolStats, type StakeAndMintEvent, type StakeAndMintParams, type SwapAndMintDefaultParams, type SwapAndMintEvent, type SwapAndMintParams, type TokenAddresses, type TransactionReceipt, type TransactionResult, type UnstakeClaimedEvent, type UnstakeRequestedEvent, type UserStabilityPoolPosition, type WithdrawAssetsParams, type WithdrawParams, type WithdrawalRequestInfo, type WithdrawnEvent, type XBNBMintedEvent, type XBNBRedeemedEvent, type YieldHarvestedEvent, type YieldStats, calculateAPY, createAspanClient, createAspanReadClient, createAspanTestnetClient, createAspanTestnetReadClient, createRouterClient, createRouterReadClient, createRouterTestnetClient, createRouterTestnetReadClient, formatAmount, formatCR, formatFeeBPS, formatPriceUSD, parseAmount };