@ember-finance/sdk 2.13.0 → 2.14.0

package/dist/src/sui-vaults/on-chain-calls/user.d.ts

@@ -125,10 +125,16 @@ export declare class UserCalls extends OnChainCalls {
      * @param sourceReceiptType The receipt coin type of the source vault (R)
      * @param sourceVaultId Object id of the source Vault<T, R>
      * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    atomicSwapEmberShares(vaultId: string, sourceReceiptType: string, sourceVaultId: string, amount: NumStr, options?: IVaultOptionalParams & {
+    atomicSwapEmberShares(vaultId: string, sourceReceiptType: string, sourceVaultId: string, amount: NumStr, minNetOut: NumStr, options?: IVaultOptionalParams & {
         coinId?: string;
         receiver?: SuiAddress;
     } & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
@@ -140,10 +146,16 @@ export declare class UserCalls extends OnChainCalls {
      * @param sourceVaultId Object id of the source Vault<T, R>
      * @param lendingMarketId Object id of the Suilend LendingMarket<P>
      * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    atomicSwapEmberSharesWithSuilend(vaultId: string, sourceReceiptType: string, poolCoinType: string, sourceVaultId: string, lendingMarketId: string, amount: NumStr, options?: IVaultOptionalParams & {
+    atomicSwapEmberSharesWithSuilend(vaultId: string, sourceReceiptType: string, poolCoinType: string, sourceVaultId: string, lendingMarketId: string, amount: NumStr, minNetOut: NumStr, options?: IVaultOptionalParams & {
         coinId?: string;
         receiver?: SuiAddress;
     } & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
@@ -154,11 +166,78 @@ export declare class UserCalls extends OnChainCalls {
      * @param sourceVaultId Object id of the source Vault<T, R>
      * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
      * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    atomicSwapEmberSharesWithAlphalend(vaultId: string, sourceReceiptType: string, sourceVaultId: string, lendingProtocolId: string, amount: NumStr, options?: IVaultOptionalParams & {
+    atomicSwapEmberSharesWithAlphalend(vaultId: string, sourceReceiptType: string, sourceVaultId: string, lendingProtocolId: string, amount: NumStr, minNetOut: NumStr, options?: IVaultOptionalParams & {
         coinId?: string;
         receiver?: SuiAddress;
     } & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Swap ember shares into a SUI-collateral atomic vault via Suilend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param sourceReceiptType The receipt coin type of the source vault (R)
+     * @param poolCoinType The Suilend pool coin type (P)
+     * @param sourceVaultId Object id of the source Vault<SUI, R>
+     * @param lendingMarketId Object id of the Suilend LendingMarket<P>
+     * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicSwapEmberSharesWithSuilendSui(vaultId: string, sourceReceiptType: string, poolCoinType: string, sourceVaultId: string, lendingMarketId: string, amount: NumStr, minNetOut: NumStr, options?: IVaultOptionalParams & {
+        coinId?: string;
+        receiver?: SuiAddress;
+    } & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Swap ember shares into a SUI-collateral atomic vault via AlphaLend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param sourceReceiptType The receipt coin type of the source vault (R)
+     * @param sourceVaultId Object id of the source Vault<SUI, R>
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units (A-9 guard)
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicSwapEmberSharesWithAlphalendSui(vaultId: string, sourceReceiptType: string, sourceVaultId: string, lendingProtocolId: string, amount: NumStr, minNetOut: NumStr, options?: IVaultOptionalParams & {
+        coinId?: string;
+        receiver?: SuiAddress;
+    } & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Instant withdraw from a SUI-collateral atomic vault, pulling liquidity
+     * from Suilend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param poolCoinType The Suilend pool coin type (P)
+     * @param lendingMarketId Object id of the Suilend LendingMarket<P>
+     * @param shares The number of atomic shares to burn
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicInstantWithdrawWithSuilendSui(vaultId: string, poolCoinType: string, lendingMarketId: string, shares: NumStr, options?: IVaultOptionalParams & {
+        receiver?: SuiAddress;
+    } & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Instant withdraw from a SUI-collateral atomic vault, pulling liquidity
+     * from AlphaLend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param shares The number of atomic shares to burn
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicInstantWithdrawWithAlphalendSui(vaultId: string, lendingProtocolId: string, shares: NumStr, options?: IVaultOptionalParams & {
+        receiver?: SuiAddress;
+    } & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
 }

package/dist/src/sui-vaults/on-chain-calls/user.js

@@ -233,10 +233,16 @@ export class UserCalls extends OnChainCalls {
      * @param sourceReceiptType The receipt coin type of the source vault (R)
      * @param sourceVaultId Object id of the source Vault<T, R>
      * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    async atomicSwapEmberShares(vaultId, sourceReceiptType, sourceVaultId, amount, options) {
+    async atomicSwapEmberShares(vaultId, sourceReceiptType, sourceVaultId, amount, minNetOut, options) {
         let coinId = options?.coinId;
         const txb = options?.txBlock || new TransactionBlock();
         let split;
@@ -249,7 +255,7 @@ export class UserCalls extends OnChainCalls {
             [split, merged] = await CoinUtils.validateCoinBalance(this.suiClient, txb, bigNumber(amount).toFixed(0), coinId);
             coinId = split;
         }
-        this.txBuilder.atomicSwapEmberShares(vaultId, sourceReceiptType, sourceVaultId, coinId, options?.receiver ?? null, { ...options, txBlock: txb });
+        this.txBuilder.atomicSwapEmberShares(vaultId, sourceReceiptType, sourceVaultId, coinId, options?.receiver ?? null, minNetOut, { ...options, txBlock: txb });
         if (merged) {
             txb.transferObjects([merged], this.walletAddress);
         }
@@ -263,10 +269,16 @@ export class UserCalls extends OnChainCalls {
      * @param sourceVaultId Object id of the source Vault<T, R>
      * @param lendingMarketId Object id of the Suilend LendingMarket<P>
      * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    async atomicSwapEmberSharesWithSuilend(vaultId, sourceReceiptType, poolCoinType, sourceVaultId, lendingMarketId, amount, options) {
+    async atomicSwapEmberSharesWithSuilend(vaultId, sourceReceiptType, poolCoinType, sourceVaultId, lendingMarketId, amount, minNetOut, options) {
         let coinId = options?.coinId;
         const txb = options?.txBlock || new TransactionBlock();
         let split;
@@ -279,7 +291,7 @@ export class UserCalls extends OnChainCalls {
             [split, merged] = await CoinUtils.validateCoinBalance(this.suiClient, txb, bigNumber(amount).toFixed(0), coinId);
             coinId = split;
         }
-        this.txBuilder.atomicSwapEmberSharesWithSuilend(vaultId, sourceReceiptType, poolCoinType, sourceVaultId, lendingMarketId, coinId, options?.receiver ?? null, { ...options, txBlock: txb });
+        this.txBuilder.atomicSwapEmberSharesWithSuilend(vaultId, sourceReceiptType, poolCoinType, sourceVaultId, lendingMarketId, coinId, options?.receiver ?? null, minNetOut, { ...options, txBlock: txb });
         if (merged) {
             txb.transferObjects([merged], this.walletAddress);
         }
@@ -292,10 +304,16 @@ export class UserCalls extends OnChainCalls {
      * @param sourceVaultId Object id of the source Vault<T, R>
      * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
      * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    async atomicSwapEmberSharesWithAlphalend(vaultId, sourceReceiptType, sourceVaultId, lendingProtocolId, amount, options) {
+    async atomicSwapEmberSharesWithAlphalend(vaultId, sourceReceiptType, sourceVaultId, lendingProtocolId, amount, minNetOut, options) {
         let coinId = options?.coinId;
         const txb = options?.txBlock || new TransactionBlock();
         let split;
@@ -308,10 +326,115 @@ export class UserCalls extends OnChainCalls {
             [split, merged] = await CoinUtils.validateCoinBalance(this.suiClient, txb, bigNumber(amount).toFixed(0), coinId);
             coinId = split;
         }
-        this.txBuilder.atomicSwapEmberSharesWithAlphalend(vaultId, sourceReceiptType, sourceVaultId, lendingProtocolId, coinId, options?.receiver ?? null, { ...options, txBlock: txb });
+        this.txBuilder.atomicSwapEmberSharesWithAlphalend(vaultId, sourceReceiptType, sourceVaultId, lendingProtocolId, coinId, options?.receiver ?? null, minNetOut, { ...options, txBlock: txb });
         if (merged) {
             txb.transferObjects([merged], this.walletAddress);
         }
         return this.execCall(txb, options);
     }
+    // === Vault<SUI> variants ===
+    //
+    // For a SUI-collateral atomic vault the lending protocols must unwrap and
+    // rewrap SUI through the system state, so these are separate monomorphic
+    // entry functions rather than the generic ones above.
+    //
+    // The SUILEND variants take a bare `address` receiver on chain, not an
+    // Option, so there is no "default to sender" behaviour to inherit — these
+    // wrappers fall back to the SDK's wallet address explicitly. The ALPHALEND
+    // variants do take an Option and keep the usual on-chain default.
+    /**
+     * Swap ember shares into a SUI-collateral atomic vault via Suilend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param sourceReceiptType The receipt coin type of the source vault (R)
+     * @param poolCoinType The Suilend pool coin type (P)
+     * @param sourceVaultId Object id of the source Vault<SUI, R>
+     * @param lendingMarketId Object id of the Suilend LendingMarket<P>
+     * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units. The swap
+     *   aborts below it. This is the A-9 slippage guard: the payout is
+     *   gross - fee - holdback, and both the fee multiplier (which moves with
+     *   utilization) and the source rate can change between quoting and
+     *   landing. Pass the value from `previewSwapInstantWithdraw`; 0 disables
+     *   the guard entirely.
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicSwapEmberSharesWithSuilendSui(vaultId, sourceReceiptType, poolCoinType, sourceVaultId, lendingMarketId, amount, minNetOut, options) {
+        let coinId = options?.coinId;
+        const txb = options?.txBlock || new TransactionBlock();
+        let split;
+        let merged;
+        if (!coinId) {
+            [split, merged] = await CoinUtils.createCoinWithBalance(this.suiClient, txb, bigNumber(amount).toFixed(0), sourceReceiptType, this.walletAddress);
+            coinId = split;
+        }
+        else {
+            [split, merged] = await CoinUtils.validateCoinBalance(this.suiClient, txb, bigNumber(amount).toFixed(0), coinId);
+            coinId = split;
+        }
+        this.txBuilder.atomicSwapEmberSharesWithSuilendSui(vaultId, sourceReceiptType, poolCoinType, sourceVaultId, lendingMarketId, coinId, options?.receiver ?? this.walletAddress, minNetOut, { ...options, txBlock: txb });
+        if (merged) {
+            txb.transferObjects([merged], this.walletAddress);
+        }
+        return this.execCall(txb, options);
+    }
+    /**
+     * Swap ember shares into a SUI-collateral atomic vault via AlphaLend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param sourceReceiptType The receipt coin type of the source vault (R)
+     * @param sourceVaultId Object id of the source Vault<SUI, R>
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param amount The amount of source shares to swap
+     * @param minNetOut Minimum collateral to receive, in base units (A-9 guard)
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicSwapEmberSharesWithAlphalendSui(vaultId, sourceReceiptType, sourceVaultId, lendingProtocolId, amount, minNetOut, options) {
+        let coinId = options?.coinId;
+        const txb = options?.txBlock || new TransactionBlock();
+        let split;
+        let merged;
+        if (!coinId) {
+            [split, merged] = await CoinUtils.createCoinWithBalance(this.suiClient, txb, bigNumber(amount).toFixed(0), sourceReceiptType, this.walletAddress);
+            coinId = split;
+        }
+        else {
+            [split, merged] = await CoinUtils.validateCoinBalance(this.suiClient, txb, bigNumber(amount).toFixed(0), coinId);
+            coinId = split;
+        }
+        this.txBuilder.atomicSwapEmberSharesWithAlphalendSui(vaultId, sourceReceiptType, sourceVaultId, lendingProtocolId, coinId, options?.receiver ?? null, minNetOut, { ...options, txBlock: txb });
+        if (merged) {
+            txb.transferObjects([merged], this.walletAddress);
+        }
+        return this.execCall(txb, options);
+    }
+    /**
+     * Instant withdraw from a SUI-collateral atomic vault, pulling liquidity
+     * from Suilend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param poolCoinType The Suilend pool coin type (P)
+     * @param lendingMarketId Object id of the Suilend LendingMarket<P>
+     * @param shares The number of atomic shares to burn
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicInstantWithdrawWithSuilendSui(vaultId, poolCoinType, lendingMarketId, shares, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicInstantWithdrawWithSuilendSui(vaultId, poolCoinType, lendingMarketId, shares, options?.receiver ?? this.walletAddress, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Instant withdraw from a SUI-collateral atomic vault, pulling liquidity
+     * from AlphaLend
+     * @param vaultId The id of the atomic vault (collateral must be SUI)
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param shares The number of atomic shares to burn
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicInstantWithdrawWithAlphalendSui(vaultId, lendingProtocolId, shares, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicInstantWithdrawWithAlphalendSui(vaultId, lendingProtocolId, shares, options?.receiver ?? null, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
 }

package/dist/src/sui-vaults/on-chain-calls/vault-admin.d.ts

@@ -278,13 +278,21 @@ export declare class VaultAdminCalls extends OnChainCalls {
      */
     atomicSetDepositUserList(vaultId: string, user: SuiAddress, status: boolean, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
     /**
-     * Set the Suilend strategy for an atomic vault
+     * Step 1 of 2 for Suilend activation. Commits the reserve index, market
+     * object and collateral type; step 2 is `atomicOpenSuilendObligation` on
+     * the operator client, without which every supply aborts.
+     *
+     * `poolCoinType` and `lendingMarketId` became required in the I-11 fix —
+     * previously only the reserve index was committed, so a wrong market was
+     * undetectable on chain.
      * @param vaultId The id of the atomic vault
+     * @param poolCoinType The Suilend pool coin type (P)
+     * @param lendingMarketId Object id of the Suilend LendingMarket<P>
      * @param reserveArrayIndex The Suilend reserve array index
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    atomicSetStrategySuilend(vaultId: string, reserveArrayIndex: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    atomicSetStrategySuilend(vaultId: string, poolCoinType: string, lendingMarketId: string, reserveArrayIndex: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
     /**
      * Set the AlphaLend strategy for an atomic vault
      * @param vaultId The id of the atomic vault

package/dist/src/sui-vaults/on-chain-calls/vault-admin.js

@@ -483,18 +483,23 @@ export class VaultAdminCalls extends OnChainCalls {
         return this.execCall(txb, options);
     }
     /**
-     * Set the Suilend strategy for an atomic vault
+     * Step 1 of 2 for Suilend activation. Commits the reserve index, market
+     * object and collateral type; step 2 is `atomicOpenSuilendObligation` on
+     * the operator client, without which every supply aborts.
+     *
+     * `poolCoinType` and `lendingMarketId` became required in the I-11 fix —
+     * previously only the reserve index was committed, so a wrong market was
+     * undetectable on chain.
      * @param vaultId The id of the atomic vault
+     * @param poolCoinType The Suilend pool coin type (P)
+     * @param lendingMarketId Object id of the Suilend LendingMarket<P>
      * @param reserveArrayIndex The Suilend reserve array index
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    async atomicSetStrategySuilend(vaultId, reserveArrayIndex, options) {
+    async atomicSetStrategySuilend(vaultId, poolCoinType, lendingMarketId, reserveArrayIndex, options) {
         const txb = options?.txBlock || new TransactionBlock();
-        this.txBuilder.atomicSetStrategySuilend(vaultId, reserveArrayIndex, {
-            ...options,
-            txBlock: txb
-        });
+        this.txBuilder.atomicSetStrategySuilend(vaultId, poolCoinType, lendingMarketId, reserveArrayIndex, { ...options, txBlock: txb });
         return this.execCall(txb, options);
     }
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@ember-finance/sdk",
     "description": "Ember Protocol SDK",
-    "version": "2.13.0",
+    "version": "2.14.0",
     "type": "module",
     "module": "./dist/index.js",
     "main": "./dist/index.js",