@ember-finance/sdk 2.19.0 → 2.20.0

package/dist/src/sui-vaults/interfaces/index.d.ts

@@ -70,6 +70,20 @@ export interface IVaultOptionalParams extends ITxBuilderOptionalParams {
     dryRun?: boolean;
     returnTxb?: boolean;
 }
+/**
+ * Operations that can be paused individually on a vault.
+ *
+ * The values are the exact `vector<u8>` the Move entry points compare against
+ * (`OP_DEPOSITS` and friends in `vault.move`), shared by the regular and atomic
+ * vault flavours. Note `privileged_operations` is snake_case here and
+ * `privilegedOperations` in EVM's `VaultPauseOperation` — consumers serving both
+ * chains have to map, which is why this enum exists rather than a bare string.
+ */
+export declare enum SuiVaultPauseOperation {
+    Deposits = "deposits",
+    Withdrawals = "withdrawals",
+    PrivilegedOperations = "privileged_operations"
+}
 /** `version` and the protocol-wide pause flag from the shared ProtocolConfig. */
 export interface IProtocolConfigState {
     /** The package VERSION the protocol currently accepts, as a decimal string. */

package/dist/src/sui-vaults/interfaces/index.js

@@ -1 +1,15 @@
-export {};
+/**
+ * Operations that can be paused individually on a vault.
+ *
+ * The values are the exact `vector<u8>` the Move entry points compare against
+ * (`OP_DEPOSITS` and friends in `vault.move`), shared by the regular and atomic
+ * vault flavours. Note `privileged_operations` is snake_case here and
+ * `privilegedOperations` in EVM's `VaultPauseOperation` — consumers serving both
+ * chains have to map, which is why this enum exists rather than a bare string.
+ */
+export var SuiVaultPauseOperation;
+(function (SuiVaultPauseOperation) {
+    SuiVaultPauseOperation["Deposits"] = "deposits";
+    SuiVaultPauseOperation["Withdrawals"] = "withdrawals";
+    SuiVaultPauseOperation["PrivilegedOperations"] = "privileged_operations";
+})(SuiVaultPauseOperation || (SuiVaultPauseOperation = {}));

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

@@ -1,5 +1,5 @@
 import { SuiDeploymentParser } from "../utils/index.js";
-import { ISuiDeployment, ITxBuilderOptionalParams } from "../interfaces/index.js";
+import { ISuiDeployment, ITxBuilderOptionalParams, SuiVaultPauseOperation } from "../interfaces/index.js";
 import { Address, NumStr, TransactionBlock } from "@firefly-exchange/library-sui";
 export declare class TxBuilder {
     parser: SuiDeploymentParser;
@@ -45,6 +45,32 @@ export declare class TxBuilder {
      * @returns TransactionBlock
      */
     setGuardian(newGuardian: Address, options?: ITxBuilderOptionalParams): TransactionBlock;
+    /**
+     * Guardian fast-path to pause / unpause one operation on a regular vault.
+     * Callable directly by the guardian address — no AdminCap.
+     *
+     * Per-operation, unlike the AdminCap-gated {@link updateVaultPausedStatus},
+     * which flips the vault's single legacy `paused` flag. On chain the effective
+     * answer is `vault.paused || <this operation's flag>`, so clearing an
+     * operation here does not un-pause a vault the admin stopped wholesale.
+     * @param vaultId Id of the vault
+     * @param operation Operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx building params; `packageId` routes through a retired package
+     * @returns TransactionBlock
+     */
+    guardianSetVaultPausedStatus(vaultId: string, operation: SuiVaultPauseOperation, paused: boolean, options?: ITxBuilderOptionalParams): TransactionBlock;
+    /**
+     * Guardian fast-path to pause / unpause one operation on an atomic liquidity
+     * vault. Same vocabulary as the regular-vault variant; separate entry point
+     * because the vault type differs and takes only the collateral type.
+     * @param vaultId Id of the atomic vault
+     * @param operation Operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx building params; `packageId` routes through a retired package
+     * @returns TransactionBlock
+     */
+    atomicGuardianSetPauseStatus(vaultId: string, operation: SuiVaultPauseOperation, paused: boolean, options?: ITxBuilderOptionalParams): TransactionBlock;
     /**
      * Asserts `ProtocolConfig.version` equals the VERSION compiled into the target
      * package, aborting EUnsupportedPackage (1000) otherwise.

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

@@ -94,6 +94,69 @@ export class TxBuilder {
             txb.setSenderIfNotSet(options.sender);
         return txb;
     }
+    /**
+     * Guardian fast-path to pause / unpause one operation on a regular vault.
+     * Callable directly by the guardian address — no AdminCap.
+     *
+     * Per-operation, unlike the AdminCap-gated {@link updateVaultPausedStatus},
+     * which flips the vault's single legacy `paused` flag. On chain the effective
+     * answer is `vault.paused || <this operation's flag>`, so clearing an
+     * operation here does not un-pause a vault the admin stopped wholesale.
+     * @param vaultId Id of the vault
+     * @param operation Operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx building params; `packageId` routes through a retired package
+     * @returns TransactionBlock
+     */
+    guardianSetVaultPausedStatus(vaultId, operation, paused, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        txb.moveCall({
+            arguments: [
+                txb.object(vaultId),
+                txb.object(this.parser.getProtocolConfig()),
+                txb.pure.vector("u8", Array.from(Buffer.from(operation, "utf8"))),
+                txb.pure.bool(paused)
+            ],
+            typeArguments: [
+                this.parser.getDepositCoinType(vaultId),
+                this.parser.getReceiptCoinType(vaultId)
+            ],
+            target: `${this.targetPackageId(options)}::gateway::guardian_set_vault_paused_status`
+        });
+        if (options?.gasBudget)
+            txb.setGasBudget(options.gasBudget);
+        if (options?.sender)
+            txb.setSenderIfNotSet(options.sender);
+        return txb;
+    }
+    /**
+     * Guardian fast-path to pause / unpause one operation on an atomic liquidity
+     * vault. Same vocabulary as the regular-vault variant; separate entry point
+     * because the vault type differs and takes only the collateral type.
+     * @param vaultId Id of the atomic vault
+     * @param operation Operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx building params; `packageId` routes through a retired package
+     * @returns TransactionBlock
+     */
+    atomicGuardianSetPauseStatus(vaultId, operation, paused, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        txb.moveCall({
+            arguments: [
+                txb.object(vaultId),
+                txb.object(this.parser.getProtocolConfig()),
+                txb.pure.vector("u8", Array.from(Buffer.from(operation, "utf8"))),
+                txb.pure.bool(paused)
+            ],
+            typeArguments: [this.parser.getAtomicCollateralType(vaultId)],
+            target: `${this.targetPackageId(options)}::gateway::atomic_guardian_set_pause_status`
+        });
+        if (options?.gasBudget)
+            txb.setGasBudget(options.gasBudget);
+        if (options?.sender)
+            txb.setSenderIfNotSet(options.sender);
+        return txb;
+    }
     /**
      * Asserts `ProtocolConfig.version` equals the VERSION compiled into the target
      * package, aborting EUnsupportedPackage (1000) otherwise.

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

@@ -1,6 +1,6 @@
 import { BaseClient as SuiClient } from "@mysten/sui/client";
 import { OnChainCalls } from "./onchain-calls.js";
-import { ISuiDeployment, IVaultOptionalParams } from "../interfaces/index.js";
+import { ISuiDeployment, IVaultOptionalParams, SuiVaultPauseOperation } from "../interfaces/index.js";
 import { NumStr } from "@firefly-exchange/library-sui";
 import { OnChainCallResponse, Signer, SuiAddress, SuiTransactionBlockResponseOptions } from "@firefly-exchange/library-sui";
 export declare class VaultAdminCalls extends OnChainCalls {
@@ -46,6 +46,34 @@ export declare class VaultAdminCalls extends OnChainCalls {
      * @returns OnChainCallResponse
      */
     updateVaultPausedStatus(vaultId: string, paused: boolean, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Guardian fast-path to pause / unpause one operation on a regular vault.
+     * Needs no AdminCap — the signer must be the address `set_guardian` recorded.
+     *
+     * Per-operation, unlike {@link updateVaultPausedStatus}, which flips the
+     * vault's single legacy `paused` flag. The chain reads
+     * `vault.paused || <operation flag>`, so resuming an operation here does not
+     * revive a vault the admin paused wholesale.
+     *
+     * Version-gated like every guarded call: pass `options.packageId` to route
+     * through a retired package while an upgrade is half-applied.
+     * @param vaultId The id of the vault
+     * @param operation The operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    guardianSetVaultPausedStatus(vaultId: string, operation: SuiVaultPauseOperation, paused: boolean, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    /**
+     * Guardian fast-path to pause / unpause one operation on an atomic liquidity
+     * vault. Same vocabulary as the regular-vault variant.
+     * @param vaultId The id of the atomic vault
+     * @param operation The operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    atomicGuardianSetPauseStatus(vaultId: string, operation: SuiVaultPauseOperation, paused: boolean, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
     /**
      * Update vault rate update interval
      * @param vaultId The id of the vault to update the rate update interval for

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

@@ -80,6 +80,48 @@ export class VaultAdminCalls extends OnChainCalls {
         });
         return this.execCall(txb, options);
     }
+    /**
+     * Guardian fast-path to pause / unpause one operation on a regular vault.
+     * Needs no AdminCap — the signer must be the address `set_guardian` recorded.
+     *
+     * Per-operation, unlike {@link updateVaultPausedStatus}, which flips the
+     * vault's single legacy `paused` flag. The chain reads
+     * `vault.paused || <operation flag>`, so resuming an operation here does not
+     * revive a vault the admin paused wholesale.
+     *
+     * Version-gated like every guarded call: pass `options.packageId` to route
+     * through a retired package while an upgrade is half-applied.
+     * @param vaultId The id of the vault
+     * @param operation The operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async guardianSetVaultPausedStatus(vaultId, operation, paused, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.guardianSetVaultPausedStatus(vaultId, operation, paused, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
+    /**
+     * Guardian fast-path to pause / unpause one operation on an atomic liquidity
+     * vault. Same vocabulary as the regular-vault variant.
+     * @param vaultId The id of the atomic vault
+     * @param operation The operation to pause or resume
+     * @param paused True to pause, false to resume
+     * @param options Optional tx execution params
+     * @returns OnChainCallResponse
+     */
+    async atomicGuardianSetPauseStatus(vaultId, operation, paused, options) {
+        const txb = options?.txBlock || new TransactionBlock();
+        this.txBuilder.atomicGuardianSetPauseStatus(vaultId, operation, paused, {
+            ...options,
+            txBlock: txb
+        });
+        return this.execCall(txb, options);
+    }
     /**
      * Update vault rate update interval
      * @param vaultId The id of the vault to update the rate update interval for

package/package.json

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