@ember-finance/sdk 2.14.0 → 2.15.0

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

@@ -1,8 +1,8 @@
 import { bcs } from "@mysten/sui/bcs";
+import { tableIdOf, unwrapMoveFields } from "../utils/common.js";
 import { computeSwapQuote, computePlainInstantQuote } from "../../atomic/instant-withdraw.js";
 /** Sui fixed-point scale (1e9) used by the Atomic Liquidity Vault Move math. */
 const SUI_SCALE = 1000000000n;
-const unwrapMoveFields = (value) => value?.fields ?? value;
 const toBig = (v) => v === undefined || v === null ? 0n : BigInt(v);
 /** `math::div(a, b)` = floor(a * scale / b). */
 const divFloor = (a, b) => (b === 0n ? 0n : (a * SUI_SCALE) / b);
@@ -73,7 +73,7 @@ export class SuiAtomicLiquidityReader {
     /** Per-source-share EmberShare config from the `ember_share_configs` table. */
     async getEmberShareConfig(vaultId, sourceVaultId) {
         const fields = await this.vaultFields(vaultId);
-        const tableId = unwrapMoveFields(fields.ember_share_configs)?.id?.id;
+        const tableId = tableIdOf(fields.ember_share_configs);
         if (!tableId)
             return null;
         {
@@ -102,7 +102,7 @@ export class SuiAtomicLiquidityReader {
     /** Caller's ALV (non-transferable) share balance from the `shares` table. */
     async shareOf(vaultId, account) {
         const fields = await this.vaultFields(vaultId);
-        const tableId = unwrapMoveFields(fields.shares)?.id?.id;
+        const tableId = tableIdOf(fields.shares);
         if (!tableId)
             return 0n;
         return toBig(await this.readTableValue(tableId, "address", account));

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

@@ -466,7 +466,7 @@ export declare class TxBuilder {
      * @param options Optional tx building params
      * @returns TransactionBlock
      */
-    atomicSetEmberShareWhitelist(vaultId: string, shareVaultId: string, whitelisted: boolean, feePercentage: NumStr, maxCapacityPercentage: NumStr, holdbackPercentage: NumStr, maxUtilizationPercentage: NumStr, options?: ITxBuilderOptionalParams): TransactionBlock;
+    atomicSetEmberShareWhitelist(vaultId: string, shareVaultId: string, whitelisted: boolean, feePercentage: NumStr, maxCapacityPercentage: NumStr, holdbackPercentage: NumStr, maxUtilizationPercentage: NumStr, minSwapGross: NumStr, maxHeldValueAbsolute: NumStr, options?: ITxBuilderOptionalParams): TransactionBlock;
     /**
      * Sets the max utilization percentage of an ember share source vault
      * @param vaultId Id of the atomic vault
@@ -556,7 +556,7 @@ export declare class TxBuilder {
      * @param options Optional tx building params
      * @returns TransactionBlock
      */
-    atomicSetStrategyNoneFromAlphalend(vaultId: string, lendingProtocolId: string, options?: ITxBuilderOptionalParams): TransactionBlock;
+    atomicSetStrategyNoneFromAlphalend(vaultId: string, lendingProtocolId: string, acceptResidual: boolean, options?: ITxBuilderOptionalParams): TransactionBlock;
     /**
      * Step 1 of 2 for Suilend activation: commits the reserve index, the market
      * object and the collateral type. Step 2 is `atomicOpenSuilendObligation`,

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

@@ -1452,7 +1452,7 @@ export class TxBuilder {
      * @param options Optional tx building params
      * @returns TransactionBlock
      */
-    atomicSetEmberShareWhitelist(vaultId, shareVaultId, whitelisted, feePercentage, maxCapacityPercentage, holdbackPercentage, maxUtilizationPercentage, options) {
+    atomicSetEmberShareWhitelist(vaultId, shareVaultId, whitelisted, feePercentage, maxCapacityPercentage, holdbackPercentage, maxUtilizationPercentage, minSwapGross, maxHeldValueAbsolute, options) {
         const txb = options?.txBlock || new TransactionBlock();
         txb.moveCall({
             arguments: [
@@ -1463,7 +1463,9 @@ export class TxBuilder {
                 txb.pure.u64(feePercentage),
                 txb.pure.u64(maxCapacityPercentage),
                 txb.pure.u64(holdbackPercentage),
-                txb.pure.u64(maxUtilizationPercentage)
+                txb.pure.u64(maxUtilizationPercentage),
+                txb.pure.u64(minSwapGross),
+                txb.pure.u64(maxHeldValueAbsolute)
             ],
             typeArguments: [this.parser.getAtomicCollateralType(vaultId)],
             target: `${this.parser.getPackageId()}::gateway::atomic_set_ember_share_whitelist`
@@ -1715,13 +1717,14 @@ export class TxBuilder {
      * @param options Optional tx building params
      * @returns TransactionBlock
      */
-    atomicSetStrategyNoneFromAlphalend(vaultId, lendingProtocolId, options) {
+    atomicSetStrategyNoneFromAlphalend(vaultId, lendingProtocolId, acceptResidual, options) {
         const txb = options?.txBlock || new TransactionBlock();
         txb.moveCall({
             arguments: [
                 txb.object(vaultId),
                 txb.object(this.parser.getProtocolConfig()),
                 txb.object(lendingProtocolId),
+                txb.pure.bool(acceptResidual),
                 txb.object(SUI_CLOCK_OBJECT_ID)
             ],
             typeArguments: [this.parser.getAtomicCollateralType(vaultId)],
@@ -2383,7 +2386,11 @@ export class TxBuilder {
             arguments: [
                 txb.object(vaultId),
                 txb.object(this.parser.getProtocolConfig()),
-                txb.pure.id(sourceVaultId),
+                // `source_vault: &Vault<T, R>` — a shared-object reference, not an
+                // id. Its sibling `atomic_redeem_collected_ember_shares` takes the
+                // same vault the same way; sending a pure ID here cannot resolve to
+                // the object the Move side wants.
+                txb.object(sourceVaultId),
                 txb.object(tokenId)
             ],
             typeArguments: [

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

@@ -193,10 +193,15 @@ export declare class VaultAdminCalls extends OnChainCalls {
      * @param maxCapacityPercentage The max capacity percentage
      * @param holdbackPercentage The holdback percentage
      * @param maxUtilizationPercentage The max utilization percentage
+     * @param minSwapGross Minimum gross swap size, in collateral base units. 0 means
+     *   no floor. Below it `swap_ember_shares` aborts, which is what keeps dust swaps
+     *   from walking the fee curve for free.
+     * @param maxHeldValueAbsolute Absolute ceiling on the collateral value this vault
+     *   will custody for the source. 0 means no cap — the percentage caps still apply.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    atomicSetEmberShareWhitelist(vaultId: string, shareVaultId: string, whitelisted: boolean, feePercentage: NumStr, maxCapacityPercentage: NumStr, holdbackPercentage: NumStr, maxUtilizationPercentage: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    atomicSetEmberShareWhitelist(vaultId: string, shareVaultId: string, whitelisted: boolean, feePercentage: NumStr, maxCapacityPercentage: NumStr, holdbackPercentage: NumStr, maxUtilizationPercentage: NumStr, minSwapGross: NumStr, maxHeldValueAbsolute: NumStr, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
     /**
      * Set the max utilization percentage of an ember share source vault
      * @param vaultId The id of the atomic vault
@@ -317,8 +322,11 @@ export declare class VaultAdminCalls extends OnChainCalls {
      * draining the full position collateral back into the vault balance
      * @param vaultId The id of the atomic vault
      * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param acceptResidual Abandon a dust residual rather than aborting the exit.
+     *   Only pass true deliberately: the residual is forfeited, and the exit burns the
+     *   PositionCap that could otherwise reach it.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    atomicSetStrategyNoneFromAlphalend(vaultId: string, lendingProtocolId: string, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
+    atomicSetStrategyNoneFromAlphalend(vaultId: string, lendingProtocolId: string, acceptResidual: boolean, options?: IVaultOptionalParams & SuiTransactionBlockResponseOptions): Promise<OnChainCallResponse>;
 }

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

@@ -340,12 +340,17 @@ export class VaultAdminCalls extends OnChainCalls {
      * @param maxCapacityPercentage The max capacity percentage
      * @param holdbackPercentage The holdback percentage
      * @param maxUtilizationPercentage The max utilization percentage
+     * @param minSwapGross Minimum gross swap size, in collateral base units. 0 means
+     *   no floor. Below it `swap_ember_shares` aborts, which is what keeps dust swaps
+     *   from walking the fee curve for free.
+     * @param maxHeldValueAbsolute Absolute ceiling on the collateral value this vault
+     *   will custody for the source. 0 means no cap — the percentage caps still apply.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    async atomicSetEmberShareWhitelist(vaultId, shareVaultId, whitelisted, feePercentage, maxCapacityPercentage, holdbackPercentage, maxUtilizationPercentage, options) {
+    async atomicSetEmberShareWhitelist(vaultId, shareVaultId, whitelisted, feePercentage, maxCapacityPercentage, holdbackPercentage, maxUtilizationPercentage, minSwapGross, maxHeldValueAbsolute, options) {
         const txb = options?.txBlock || new TransactionBlock();
-        this.txBuilder.atomicSetEmberShareWhitelist(vaultId, shareVaultId, whitelisted, feePercentage, maxCapacityPercentage, holdbackPercentage, maxUtilizationPercentage, { ...options, txBlock: txb });
+        this.txBuilder.atomicSetEmberShareWhitelist(vaultId, shareVaultId, whitelisted, feePercentage, maxCapacityPercentage, holdbackPercentage, maxUtilizationPercentage, minSwapGross, maxHeldValueAbsolute, { ...options, txBlock: txb });
         return this.execCall(txb, options);
     }
     /**
@@ -537,15 +542,15 @@ export class VaultAdminCalls extends OnChainCalls {
      * draining the full position collateral back into the vault balance
      * @param vaultId The id of the atomic vault
      * @param lendingProtocolId Object id of the AlphaLend LendingProtocol
+     * @param acceptResidual Abandon a dust residual rather than aborting the exit.
+     *   Only pass true deliberately: the residual is forfeited, and the exit burns the
+     *   PositionCap that could otherwise reach it.
      * @param options Optional tx execution params
      * @returns OnChainCallResponse
      */
-    async atomicSetStrategyNoneFromAlphalend(vaultId, lendingProtocolId, options) {
+    async atomicSetStrategyNoneFromAlphalend(vaultId, lendingProtocolId, acceptResidual, options) {
         const txb = options?.txBlock || new TransactionBlock();
-        this.txBuilder.atomicSetStrategyNoneFromAlphalend(vaultId, lendingProtocolId, {
-            ...options,
-            txBlock: txb
-        });
+        this.txBuilder.atomicSetStrategyNoneFromAlphalend(vaultId, lendingProtocolId, acceptResidual, { ...options, txBlock: txb });
         return this.execCall(txb, options);
     }
 }

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

@@ -1,6 +1,6 @@
 import { bcs } from "@mysten/sui/bcs";
 import { BcsUpdateVaultStrategyRequest } from "../interfaces/bcs.js";
-const unwrapMoveFields = (value) => value?.fields ?? value;
+import { tableIdOf, unwrapMoveFields } from "../utils/common.js";
 export class Vault {
     /**
      * Fetches the vault rate from on-chain
@@ -65,9 +65,7 @@ export class Vault {
         });
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const fields = unwrapMoveFields(objDetails.object?.json);
-        const accounts = unwrapMoveFields(fields?.accounts);
-        const accountTableId = unwrapMoveFields(accounts?.id);
-        const userTable = accountTableId?.id || accounts?.id;
+        const userTable = tableIdOf(fields?.accounts);
         try {
             const userData = await suiClient.core.getDynamicObjectField({
                 parentId: userTable,

package/dist/src/sui-vaults/utils/common.d.ts

@@ -1,3 +1,23 @@
 import { BaseClient as SuiClient } from "@mysten/sui/client";
 import { TransactionBlock } from "@firefly-exchange/library-sui";
 export declare const getTxBytes: (tx: TransactionBlock, client: SuiClient) => Promise<string>;
+/**
+ * Strip the JSON-RPC `{ fields: {...} }` wrapper from a Move value.
+ *
+ * gRPC returns the fields directly, JSON-RPC nests them one level down, so this
+ * makes a read work on either transport.
+ */
+export declare const unwrapMoveFields: (value: any) => any;
+/**
+ * The object id of a `Table` / `Bag` / `ObjectTable` field, whichever way the
+ * transport rendered its `UID`.
+ *
+ * The two disagree: over gRPC a UID comes back flattened to a string, so the
+ * field reads `{ id: "0x...", size: "1" }`, while JSON-RPC keeps the nesting and
+ * gives `{ id: { id: "0x..." }, size: "1" }`. Reaching straight for `.id.id`
+ * therefore yields `undefined` on gRPC — and because every caller treats a
+ * missing table id as "no such table", the read fails CLOSED: a whitelisted
+ * source vault reads as not whitelisted, a real share balance reads as zero.
+ * Silent, and wrong in the direction that looks like ordinary empty state.
+ */
+export declare const tableIdOf: (field: any) => string | undefined;

package/dist/src/sui-vaults/utils/common.js

@@ -2,3 +2,27 @@ import { toBase64 } from "@mysten/sui/utils";
 export const getTxBytes = async (tx, client) => {
     return toBase64(await tx.build({ client: client, onlyTransactionKind: false }));
 };
+/**
+ * Strip the JSON-RPC `{ fields: {...} }` wrapper from a Move value.
+ *
+ * gRPC returns the fields directly, JSON-RPC nests them one level down, so this
+ * makes a read work on either transport.
+ */
+export const unwrapMoveFields = (value) => value?.fields ?? value;
+/**
+ * The object id of a `Table` / `Bag` / `ObjectTable` field, whichever way the
+ * transport rendered its `UID`.
+ *
+ * The two disagree: over gRPC a UID comes back flattened to a string, so the
+ * field reads `{ id: "0x...", size: "1" }`, while JSON-RPC keeps the nesting and
+ * gives `{ id: { id: "0x..." }, size: "1" }`. Reaching straight for `.id.id`
+ * therefore yields `undefined` on gRPC — and because every caller treats a
+ * missing table id as "no such table", the read fails CLOSED: a whitelisted
+ * source vault reads as not whitelisted, a real share balance reads as zero.
+ * Silent, and wrong in the direction that looks like ordinary empty state.
+ */
+export const tableIdOf = (field) => {
+    const table = unwrapMoveFields(field);
+    const id = unwrapMoveFields(table?.id);
+    return (typeof id === "string" ? id : id?.id) ?? undefined;
+};

package/package.json

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