@ember-finance/sdk 2.5.0 → 2.6.0-pre.0

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

@@ -1,6 +1,7 @@
+import { BaseClient as SuiClient } from "@mysten/sui/client";
 import { OnChainCalls } from "./onchain-calls.js";
 import { ISuiDeployment, IVaultOptionalParams } from "../interfaces/index.js";
-import { OnChainCallResponse, Signer, SuiAddress, SuiClient, SuiTransactionBlockResponseOptions } from "@firefly-exchange/library-sui";
+import { OnChainCallResponse, Signer, SuiAddress, SuiTransactionBlockResponseOptions } from "@firefly-exchange/library-sui";
 import { NumStr } from "@firefly-exchange/library-sui";
 export declare class OperatorCalls extends OnChainCalls {
     constructor(_network: string, _suiClient: SuiClient, _deployment: ISuiDeployment, _signer?: Signer, _walletAddress?: string);
@@ -100,4 +101,131 @@ export declare class OperatorCalls extends OnChainCalls {
      * @returns OnChainCallResponse
      */
     setFeeExemptionList(vaultId: string, user: SuiAddress, status: boolean, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Process pending withdrawal requests of an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param maxRequests The maximum number of withdrawal requests to process
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicProcessWithdrawalRequests(vaultId: string, maxRequests: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Process pending withdrawal requests of an atomic vault up to a timestamp
+     * @param vaultId The id of the atomic vault
+     * @param timestamp The timestamp to process withdrawal requests up to
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicProcessWithdrawalRequestsUpToTimestamp(vaultId: string, timestamp: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Collect the platform fee of an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param loss The reported loss amount
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicCollectPlatformFee(vaultId: string, loss: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Supply collateral from an atomic vault into the Suilend strategy
+     * @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 amount The amount to supply
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicSupplyToSuilendStrategy(vaultId: string, poolCoinType: string, lendingMarketId: string, amount: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Supply collateral from an atomic vault into the AlphaLend strategy
+     * @param vaultId The id of the atomic vault
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param amount The amount to supply
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicSupplyToAlphalendStrategy(vaultId: string, lendingProtocolId: string, amount: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Withdraw collateral from the Suilend strategy back into an atomic vault
+     * @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 amount The amount to withdraw
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicWithdrawFromSuilendStrategy(vaultId: string, poolCoinType: string, lendingMarketId: string, amount: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Withdraw collateral from the AlphaLend strategy back into an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param amount The amount to withdraw
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicWithdrawFromAlphalendStrategy(vaultId: string, lendingProtocolId: string, amount: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Supply collateral from an atomic vault to one of its sub accounts
+     * @param vaultId The id of the atomic vault
+     * @param subAccount The sub account address
+     * @param amount The amount to supply
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicSupplyToSubAccount(vaultId: string, subAccount: string, amount: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Deposit collateral back into an atomic vault from a sub account
+     * @param vaultId The id of the atomic vault
+     * @param tokenId Object id of the Receiving<Coin<T>> payment to claim
+     * @param subAccount The sub account address
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicDepositFromSubAccount(vaultId: string, tokenId: string, subAccount: string, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Redeem collected ember shares from an atomic vault against a source vault
+     * @param vaultId The id of the atomic vault
+     * @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 shares to redeem
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicRedeemCollectedEmberShares(vaultId: string, sourceReceiptType: string, sourceVaultId: string, amount: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Release users' holdback for an ember share source vault
+     * @param vaultId The id of the atomic vault
+     * @param shareVaultId Id of the source ember share vault
+     * @param unwindingPercentage The unwinding percentage
+     * @param maxEntries The max entries to process
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicReleaseUsersHoldback(vaultId: string, shareVaultId: string, unwindingPercentage: NumStr, maxEntries: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Claim received collateral (a Receiving<Coin<T>>) for an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param tokenId Object id of the Receiving<Coin<T>> payment to claim
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicClaimReceivedCollateral(vaultId: string, tokenId: string, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Claim returned ember shares (a Receiving<Coin<R>>) for an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param sourceReceiptType The receipt coin type of the source vault (R)
+     * @param sourceVaultId Id of the source vault the shares belong to
+     * @param tokenId Object id of the Receiving<Coin<R>> payment to claim
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicClaimReturnedEmberShares(vaultId: string, sourceReceiptType: string, sourceVaultId: string, tokenId: string, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Update the rate of an atomic vault (rate manager role; uses operator class
+     * to mirror the receipt-vault `updateVaultRate` placement)
+     * @param vaultId The id of the atomic vault
+     * @param newRate The new rate to set for the vault
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicUpdateVaultRate(vaultId: string, newRate: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
 }

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

@@ -177,4 +177,214 @@ export class OperatorCalls extends OnChainCalls {
         });
         return this.execCall(txb, options);
     }
+    // ============================================================================
+    // Atomic Liquidity Vault (BFE-818) — operator / rate-manager methods
+    // ============================================================================
+    /**
+     * Process pending withdrawal requests of an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param maxRequests The maximum number of withdrawal requests to process
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicProcessWithdrawalRequests(vaultId, maxRequests, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicProcessWithdrawalRequests(vaultId, maxRequests, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Process pending withdrawal requests of an atomic vault up to a timestamp
+     * @param vaultId The id of the atomic vault
+     * @param timestamp The timestamp to process withdrawal requests up to
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicProcessWithdrawalRequestsUpToTimestamp(vaultId, timestamp, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicProcessWithdrawalRequestsUpToTimestamp(vaultId, timestamp, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Collect the platform fee of an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param loss The reported loss amount
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicCollectPlatformFee(vaultId, loss, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicCollectPlatformFee(vaultId, loss, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Supply collateral from an atomic vault into the Suilend strategy
+     * @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 amount The amount to supply
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicSupplyToSuilendStrategy(vaultId, poolCoinType, lendingMarketId, amount, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicSupplyToSuilendStrategy(vaultId, poolCoinType, lendingMarketId, amount, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Supply collateral from an atomic vault into the AlphaLend strategy
+     * @param vaultId The id of the atomic vault
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param amount The amount to supply
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicSupplyToAlphalendStrategy(vaultId, lendingProtocolId, amount, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicSupplyToAlphalendStrategy(vaultId, lendingProtocolId, amount, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Withdraw collateral from the Suilend strategy back into an atomic vault
+     * @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 amount The amount to withdraw
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicWithdrawFromSuilendStrategy(vaultId, poolCoinType, lendingMarketId, amount, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicWithdrawFromSuilendStrategy(vaultId, poolCoinType, lendingMarketId, amount, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Withdraw collateral from the AlphaLend strategy back into an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param amount The amount to withdraw
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicWithdrawFromAlphalendStrategy(vaultId, lendingProtocolId, amount, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicWithdrawFromAlphalendStrategy(vaultId, lendingProtocolId, amount, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Supply collateral from an atomic vault to one of its sub accounts
+     * @param vaultId The id of the atomic vault
+     * @param subAccount The sub account address
+     * @param amount The amount to supply
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicSupplyToSubAccount(vaultId, subAccount, amount, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicSupplyToSubAccount(vaultId, subAccount, amount, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Deposit collateral back into an atomic vault from a sub account
+     * @param vaultId The id of the atomic vault
+     * @param tokenId Object id of the Receiving<Coin<T>> payment to claim
+     * @param subAccount The sub account address
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicDepositFromSubAccount(vaultId, tokenId, subAccount, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicDepositFromSubAccount(vaultId, tokenId, subAccount, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Redeem collected ember shares from an atomic vault against a source vault
+     * @param vaultId The id of the atomic vault
+     * @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 shares to redeem
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicRedeemCollectedEmberShares(vaultId, sourceReceiptType, sourceVaultId, amount, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicRedeemCollectedEmberShares(vaultId, sourceReceiptType, sourceVaultId, amount, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Release users' holdback for an ember share source vault
+     * @param vaultId The id of the atomic vault
+     * @param shareVaultId Id of the source ember share vault
+     * @param unwindingPercentage The unwinding percentage
+     * @param maxEntries The max entries to process
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicReleaseUsersHoldback(vaultId, shareVaultId, unwindingPercentage, maxEntries, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicReleaseUsersHoldback(vaultId, shareVaultId, unwindingPercentage, maxEntries, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Claim received collateral (a Receiving<Coin<T>>) for an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param tokenId Object id of the Receiving<Coin<T>> payment to claim
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicClaimReceivedCollateral(vaultId, tokenId, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicClaimReceivedCollateral(vaultId, tokenId, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Claim returned ember shares (a Receiving<Coin<R>>) for an atomic vault
+     * @param vaultId The id of the atomic vault
+     * @param sourceReceiptType The receipt coin type of the source vault (R)
+     * @param sourceVaultId Id of the source vault the shares belong to
+     * @param tokenId Object id of the Receiving<Coin<R>> payment to claim
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicClaimReturnedEmberShares(vaultId, sourceReceiptType, sourceVaultId, tokenId, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicClaimReturnedEmberShares(vaultId, sourceReceiptType, sourceVaultId, tokenId, { ...options, txBlock: txb });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Update the rate of an atomic vault (rate manager role; uses operator class
+     * to mirror the receipt-vault `updateVaultRate` placement)
+     * @param vaultId The id of the atomic vault
+     * @param newRate The new rate to set for the vault
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicUpdateVaultRate(vaultId, newRate, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicUpdateVaultRate(vaultId, newRate, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
 }