@velocity-exchange/sdk 0.8.0 → 0.10.0

package/lib/browser/idl/velocity.d.ts

@@ -12466,6 +12466,10 @@ export type Velocity = {
                 {
                     "name": "equityFloor";
                     "type": "u64";
+                },
+                {
+                    "name": "equityFloorBuffer";
+                    "type": "u64";
                 }
             ];
         },
@@ -12887,6 +12891,63 @@ export type Velocity = {
             ];
             "args": [];
         },
+        {
+            "name": "updateUserVaultOwned";
+            "docs": [
+                "Mark a User as vault-owned (its authority is a vault PDA and its equity",
+                "prices vault depositor shares). Set-only and authority-gated: only the",
+                "User's authority may call it, and it is CPI'd by the vaults program at",
+                "vault init. A vault-owned User is skipped by the revenue-share sweep so a",
+                "builder/referral reward can never enter vault NAV (OtterSec #91/#92/#93)."
+            ];
+            "discriminator": [
+                50,
+                156,
+                218,
+                143,
+                216,
+                94,
+                68,
+                93
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "authority";
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "subAccountId";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "authority";
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "subAccountId";
+                    "type": "u16";
+                }
+            ];
+        },
         {
             "name": "updateWarmAdmin";
             "discriminator": [
@@ -16299,6 +16360,16 @@ export type Velocity = {
             "code": 6364;
             "name": "dailyDepositLimit";
             "msg": "Spot market daily deposit limit hit";
+        },
+        {
+            "code": 6365;
+            "name": "reservedSpotMarketName";
+            "msg": "The name 'USDT' is reserved for the quote spot market (index 0)";
+        },
+        {
+            "code": 6366;
+            "name": "cannotModifyBuilderOrder";
+            "msg": "Cannot modify a builder-coded order; cancel and re-place instead";
         }
     ];
     "types": [
@@ -24065,21 +24136,25 @@ export type Velocity = {
                     {
                         "name": "equityFloor";
                         "docs": [
-                            "Minimum account equity (cross-margin total collateral) required for",
-                            "risk-increasing orders, fills, withdrawals and deposit transfers.",
-                            "Settable only by the warm/cold admin; 0 disables the check.",
+                            "Minimum account net equity (unweighted assets plus perp pnl minus",
+                            "spot liabilities, see `calculate_user_equity`). Below this the",
+                            "permissionless breaker can trip. Risk-increasing orders, fills,",
+                            "withdrawals and deposit transfers must clear `equity_floor +",
+                            "equity_floor_buffer`. Settable only by the warm/cold admin; 0 disables",
+                            "both checks.",
                             "precision: QUOTE_PRECISION"
                         ];
                         "type": "u64";
                     },
                     {
-                        "name": "padding2";
-                        "type": {
-                            "array": [
-                                "u8",
-                                8
-                            ];
-                        };
+                        "name": "equityFloorBuffer";
+                        "docs": [
+                            "Extra headroom above `equity_floor` required by risk-increasing",
+                            "actions, so an account cannot legally end an action at the trip",
+                            "threshold. No effect while `equity_floor` is 0.",
+                            "precision: QUOTE_PRECISION"
+                        ];
+                        "type": "u64";
                     }
                 ];
             };

package/lib/browser/idl/velocity.json

@@ -12460,6 +12460,10 @@
                 {
                     "name": "equity_floor",
                     "type": "u64"
+                },
+                {
+                    "name": "equity_floor_buffer",
+                    "type": "u64"
                 }
             ]
         },
@@ -12881,6 +12885,63 @@
             ],
             "args": []
         },
+        {
+            "name": "update_user_vault_owned",
+            "docs": [
+                "Mark a User as vault-owned (its authority is a vault PDA and its equity",
+                "prices vault depositor shares). Set-only and authority-gated: only the",
+                "User's authority may call it, and it is CPI'd by the vaults program at",
+                "vault init. A vault-owned User is skipped by the revenue-share sweep so a",
+                "builder/referral reward can never enter vault NAV (OtterSec #91/#92/#93)."
+            ],
+            "discriminator": [
+                50,
+                156,
+                218,
+                143,
+                216,
+                94,
+                68,
+                93
+            ],
+            "accounts": [
+                {
+                    "name": "user",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "authority"
+                            },
+                            {
+                                "kind": "arg",
+                                "path": "sub_account_id"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "_sub_account_id",
+                    "type": "u16"
+                }
+            ]
+        },
         {
             "name": "update_warm_admin",
             "discriminator": [
@@ -16293,6 +16354,16 @@
             "code": 6364,
             "name": "DailyDepositLimit",
             "msg": "Spot market daily deposit limit hit"
+        },
+        {
+            "code": 6365,
+            "name": "ReservedSpotMarketName",
+            "msg": "The name 'USDT' is reserved for the quote spot market (index 0)"
+        },
+        {
+            "code": 6366,
+            "name": "CannotModifyBuilderOrder",
+            "msg": "Cannot modify a builder-coded order; cancel and re-place instead"
         }
     ],
     "types": [
@@ -24059,21 +24130,25 @@
                     {
                         "name": "equity_floor",
                         "docs": [
-                            "Minimum account equity (cross-margin total collateral) required for",
-                            "risk-increasing orders, fills, withdrawals and deposit transfers.",
-                            "Settable only by the warm/cold admin; 0 disables the check.",
+                            "Minimum account net equity (unweighted assets plus perp pnl minus",
+                            "spot liabilities, see `calculate_user_equity`). Below this the",
+                            "permissionless breaker can trip. Risk-increasing orders, fills,",
+                            "withdrawals and deposit transfers must clear `equity_floor +",
+                            "equity_floor_buffer`. Settable only by the warm/cold admin; 0 disables",
+                            "both checks.",
                             "precision: QUOTE_PRECISION"
                         ],
                         "type": "u64"
                     },
                     {
-                        "name": "padding2",
-                        "type": {
-                            "array": [
-                                "u8",
-                                8
-                            ]
-                        }
+                        "name": "equity_floor_buffer",
+                        "docs": [
+                            "Extra headroom above `equity_floor` required by risk-increasing",
+                            "actions, so an account cannot legally end an action at the trip",
+                            "threshold. No effect while `equity_floor` is 0.",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "u64"
                     }
                 ]
             }

package/lib/browser/index.d.ts

@@ -45,6 +45,7 @@ export * from './adminClient';
 export * from './assert/assert';
 export { PythLazerSubscriber, type PythLazerPriceFeedArray, type PriceUpdateAccount, } from './pyth';
 export * from './testClient';
+export * from './equityFloorManager';
 export * from './user';
 export * from './userConfig';
 export * from './userStats';
@@ -64,6 +65,8 @@ export * from './events/parse';
 export * from './events/pollingLogProvider';
 export * from './jupiter/jupiterClient';
 export * from './swap/UnifiedSwapClient';
+export * from './swap/types';
+export * from './swap/routeInstructions';
 export * from './math/auction';
 export * from './math/builder';
 export * from './math/spotMarket';
@@ -109,6 +112,7 @@ export * from './tx/priorityFeeCalculator';
 export * from './tx/types';
 export * from './tx/txHandler';
 export * from './tx/txParamProcessor';
+export * from './tx/utils';
 export * from './util/computeUnits';
 export * from './util/digest';
 export * from './util/promiseTimeout';

package/lib/browser/index.js

@@ -75,6 +75,7 @@ __exportStar(require("./assert/assert"), exports);
 var pyth_1 = require("./pyth");
 Object.defineProperty(exports, "PythLazerSubscriber", { enumerable: true, get: function () { return pyth_1.PythLazerSubscriber; } });
 __exportStar(require("./testClient"), exports);
+__exportStar(require("./equityFloorManager"), exports);
 __exportStar(require("./user"), exports);
 __exportStar(require("./userConfig"), exports);
 __exportStar(require("./userStats"), exports);
@@ -95,6 +96,9 @@ __exportStar(require("./events/pollingLogProvider"), exports);
 __exportStar(require("./jupiter/jupiterClient"), exports);
 // Primary swap client interface - use this for all swap operations
 __exportStar(require("./swap/UnifiedSwapClient"), exports);
+// The SwapProvider contract both providers implement, and the shared route filter
+__exportStar(require("./swap/types"), exports);
+__exportStar(require("./swap/routeInstructions"), exports);
 __exportStar(require("./math/auction"), exports);
 __exportStar(require("./math/builder"), exports);
 __exportStar(require("./math/spotMarket"), exports);
@@ -140,6 +144,7 @@ __exportStar(require("./tx/priorityFeeCalculator"), exports);
 __exportStar(require("./tx/types"), exports);
 __exportStar(require("./tx/txHandler"), exports);
 __exportStar(require("./tx/txParamProcessor"), exports);
+__exportStar(require("./tx/utils"), exports);
 __exportStar(require("./util/computeUnits"), exports);
 __exportStar(require("./util/digest"), exports);
 __exportStar(require("./util/promiseTimeout"), exports);

package/lib/browser/jupiter/jupiterClient.d.ts

@@ -1,6 +1,5 @@
 import { AddressLookupTableAccount, Connection, PublicKey, TransactionInstruction, TransactionMessage, VersionedTransaction } from '@solana/web3.js';
-import { BN } from '../isomorphic/anchor';
-import { SwapMode } from '../swap/UnifiedSwapClient';
+import { GetRouteInstructionsParams, SwapMode, SwapProvider, SwapQuote, SwapQuoteParams, SwapRouteInstructions } from '../swap/types';
 export interface MarketInfo {
     id: string;
     inAmount: number;
@@ -207,14 +206,17 @@ export interface QuoteResponse {
      */
     errorCode?: string;
 }
+/** A Jupiter quote plus the payload {@link JupiterClient.getRouteInstructions} needs. */
+export type JupiterSwapQuote = QuoteResponse & SwapQuote;
 export declare const RECOMMENDED_JUPITER_API_VERSION = "/v1";
 /** @deprecated Use RECOMMENDED_JUPITER_API instead. lite-api.jup.ag requires migration to api.jup.ag with API key. */
 export declare const LEGACY_JUPITER_API = "https://lite-api.jup.ag/swap";
 export declare const RECOMMENDED_JUPITER_API = "https://api.jup.ag/swap";
-export declare class JupiterClient {
+export declare class JupiterClient implements SwapProvider {
+    readonly providerName: "jupiter";
     url: string;
     connection: Connection;
-    lookupTableCahce: Map<string, AddressLookupTableAccount>;
+    lookupTableCache: Map<string, AddressLookupTableAccount>;
     private apiKey?;
     /**
      * Create a Jupiter client
@@ -240,31 +242,34 @@ export declare class JupiterClient {
      * @param swapMode the swap mode (ExactIn or ExactOut)
      * @param onlyDirectRoutes whether to only return direct routes
      */
-    getQuote({ inputMint, outputMint, amount, maxAccounts, // 50 is an estimated amount with buffer
-    slippageBps, swapMode, onlyDirectRoutes, excludeDexes, autoSlippage, maxAutoSlippageBps, usdEstimate, }: {
-        inputMint: PublicKey;
-        outputMint: PublicKey;
-        amount: BN;
-        maxAccounts?: number;
-        slippageBps?: number;
-        swapMode?: SwapMode;
-        onlyDirectRoutes?: boolean;
-        excludeDexes?: string[];
-        autoSlippage?: boolean;
-        maxAutoSlippageBps?: number;
-        usdEstimate?: number;
-    }): Promise<QuoteResponse>;
+    getQuote({ inputMint, outputMint, amount, maxAccounts, slippageBps, swapMode, onlyDirectRoutes, excludeDexes, autoSlippage, maxAutoSlippageBps, usdEstimate, }: SwapQuoteParams): Promise<JupiterSwapQuote>;
     /**
      * Get a swap transaction for quote
-     * @param quoteResponse quote to perform swap
+     * @param quote quote to perform swap, from {@link getQuote}
      * @param userPublicKey the signer's wallet public key
-     * @param slippageBps the slippage tolerance in basis points
+     *
+     * Always builds at the quote's own slippage — the price the caller was
+     * shown. Re-quote to change it rather than overriding it here.
      */
-    getSwap({ quote, userPublicKey, slippageBps, }: {
-        quote: QuoteResponse;
+    getSwap({ quote, userPublicKey, }: {
+        quote: QuoteResponse | JupiterSwapQuote;
         userPublicKey: PublicKey;
-        slippageBps?: number;
     }): Promise<VersionedTransaction>;
+    /**
+     * The standalone transaction Jupiter's `/swap` endpoint returns, setup and
+     * teardown included.
+     * @throws If the quote came from a different provider or a different wallet.
+     */
+    getSwapTransaction({ quote, userPublicKey, }: GetRouteInstructionsParams): Promise<VersionedTransaction>;
+    /**
+     * Builds the route instructions for a quote returned by {@link getQuote}.
+     *
+     * The quote carries its own route payload, so this reads no client state
+     * and two quotes in flight can never be confused for one another. The swap
+     * is built at the slippage the quote was priced at — re-quote to change it.
+     * @throws If the quote came from a different provider or a different wallet.
+     */
+    getRouteInstructions({ quote, userPublicKey, }: GetRouteInstructionsParams): Promise<SwapRouteInstructions>;
     /**
      * Get the transaction message and lookup tables for a transaction
      * @param transaction
@@ -277,10 +282,9 @@ export declare class JupiterClient {
     }>;
     getLookupTable(accountKey: PublicKey): Promise<AddressLookupTableAccount | undefined>;
     /**
-     * Get the jupiter instructions from transaction by filtering out instructions to compute budget and associated token programs
-     * @param transactionMessage the transaction message
-     * @param inputMint the input mint
-     * @param outputMint the output mint
+     * Strips the setup/teardown Jupiter wraps around its route.
+     * @deprecated Use {@link getRouteInstructions}, which quotes and filters in
+     * one step. Kept for callers holding a decompiled message of their own.
      */
     getJupiterInstructions({ transactionMessage, inputMint, outputMint, }: {
         transactionMessage: TransactionMessage;

package/lib/browser/jupiter/jupiterClient.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.JupiterClient = exports.RECOMMENDED_JUPITER_API = exports.LEGACY_JUPITER_API = exports.RECOMMENDED_JUPITER_API_VERSION = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const node_fetch_1 = __importDefault(require("node-fetch"));
+const routeInstructions_1 = require("../swap/routeInstructions");
+const types_1 = require("../swap/types");
 exports.RECOMMENDED_JUPITER_API_VERSION = '/v1';
 /** @deprecated Use RECOMMENDED_JUPITER_API instead. lite-api.jup.ag requires migration to api.jup.ag with API key. */
 exports.LEGACY_JUPITER_API = 'https://lite-api.jup.ag/swap';
@@ -18,7 +20,8 @@ class JupiterClient {
      * @param apiKey - API key for Jupiter API. Required for api.jup.ag (free tier available at https://portal.jup.ag)
      */
     constructor({ connection, url, apiKey, }) {
-        this.lookupTableCahce = new Map();
+        this.providerName = 'jupiter';
+        this.lookupTableCache = new Map();
         this.connection = connection;
         this.url = url !== null && url !== void 0 ? url : exports.RECOMMENDED_JUPITER_API;
         this.apiKey = apiKey;
@@ -45,8 +48,8 @@ class JupiterClient {
      * @param swapMode the swap mode (ExactIn or ExactOut)
      * @param onlyDirectRoutes whether to only return direct routes
      */
-    async getQuote({ inputMint, outputMint, amount, maxAccounts = 50, // 50 is an estimated amount with buffer
-    slippageBps = 50, swapMode = 'ExactIn', onlyDirectRoutes = false, excludeDexes, autoSlippage = false, maxAutoSlippageBps, usdEstimate, }) {
+    async getQuote({ inputMint, outputMint, amount, maxAccounts = types_1.DEFAULT_SWAP_MAX_ACCOUNTS, slippageBps = 50, swapMode = 'ExactIn', onlyDirectRoutes = false, excludeDexes, autoSlippage = false, maxAutoSlippageBps, usdEstimate, }) {
+        var _a;
         if (autoSlippage && maxAutoSlippageBps === undefined) {
             throw new Error('JupiterClient.getQuote: maxAutoSlippageBps is required when autoSlippage is enabled');
         }
@@ -78,20 +81,40 @@ class JupiterClient {
             : '';
         const headers = this.getHeaders();
         const fetchOptions = Object.keys(headers).length > 0 ? { headers } : {};
-        const quote = await (await (0, node_fetch_1.default)(`${this.url}${apiVersionParam}/quote?${params.toString()}`, fetchOptions)).json();
-        return quote;
+        const response = await (0, node_fetch_1.default)(`${this.url}${apiVersionParam}/quote?${params.toString()}`, fetchOptions);
+        const quote = (await response.json().catch(() => undefined));
+        // A failed quote still returns parseable JSON — an `{ error, errorCode }`
+        // body with no mints or amounts. Returning it unchecked pushes the failure
+        // downstream to /swap, which rejects it with an opaque deserialization
+        // error ("missing field `inputMint`") that hides the real cause.
+        if (!response.ok || !quote) {
+            throw new Error(`Jupiter quote failed: ${response.status} ${(quote === null || quote === void 0 ? void 0 : quote.error) || (quote === null || quote === void 0 ? void 0 : quote.errorCode) || response.statusText}`);
+        }
+        if (quote.error || quote.errorCode) {
+            throw new Error(`Jupiter quote failed: ${(_a = quote.error) !== null && _a !== void 0 ? _a : quote.errorCode}`);
+        }
+        if (!quote.inputMint || !quote.outputMint || !quote.outAmount) {
+            throw new Error('Jupiter quote failed: response is missing route fields');
+        }
+        // Jupiter's /swap endpoint takes the quote body back verbatim, so the
+        // quote is its own route payload.
+        return (0, types_1.buildSwapQuote)(quote, { provider: 'jupiter', quote });
     }
     /**
      * Get a swap transaction for quote
-     * @param quoteResponse quote to perform swap
+     * @param quote quote to perform swap, from {@link getQuote}
      * @param userPublicKey the signer's wallet public key
-     * @param slippageBps the slippage tolerance in basis points
+     *
+     * Always builds at the quote's own slippage — the price the caller was
+     * shown. Re-quote to change it rather than overriding it here.
      */
-    async getSwap({ quote, userPublicKey, slippageBps = 50, }) {
+    async getSwap({ quote, userPublicKey, }) {
         var _a;
         if (!quote) {
             throw new Error('Jupiter swap quote not provided. Please try again.');
         }
+        // `providerRoute` is our own wrapper, not part of Jupiter's quote body.
+        const { providerRoute: _providerRoute, ...quoteResponse } = quote;
         const apiVersionParam = this.url === exports.RECOMMENDED_JUPITER_API || this.url === exports.LEGACY_JUPITER_API
             ? exports.RECOMMENDED_JUPITER_API_VERSION
             : '';
@@ -99,9 +122,9 @@ class JupiterClient {
             method: 'POST',
             headers: this.getHeaders('application/json'),
             body: JSON.stringify({
-                quoteResponse: quote,
+                quoteResponse,
                 userPublicKey,
-                slippageBps,
+                slippageBps: quoteResponse.slippageBps,
             }),
         })).json();
         if (!('swapTransaction' in resp)) {
@@ -116,6 +139,41 @@ class JupiterClient {
             throw new Error('Something went wrong with creating the Jupiter swap transaction. Please try again.');
         }
     }
+    /**
+     * The standalone transaction Jupiter's `/swap` endpoint returns, setup and
+     * teardown included.
+     * @throws If the quote came from a different provider or a different wallet.
+     */
+    async getSwapTransaction({ quote, userPublicKey, }) {
+        const jupiterQuote = (0, types_1.expectProviderRoute)(quote, 'jupiter', userPublicKey)
+            .quote;
+        return this.getSwap({ quote: jupiterQuote, userPublicKey });
+    }
+    /**
+     * Builds the route instructions for a quote returned by {@link getQuote}.
+     *
+     * The quote carries its own route payload, so this reads no client state
+     * and two quotes in flight can never be confused for one another. The swap
+     * is built at the slippage the quote was priced at — re-quote to change it.
+     * @throws If the quote came from a different provider or a different wallet.
+     */
+    async getRouteInstructions({ quote, userPublicKey, }) {
+        const jupiterQuote = (0, types_1.expectProviderRoute)(quote, 'jupiter', userPublicKey)
+            .quote;
+        const transaction = await this.getSwap({
+            quote: jupiterQuote,
+            userPublicKey,
+        });
+        const { transactionMessage, lookupTables } = await this.getTransactionMessageAndLookupTables({ transaction });
+        return {
+            instructions: (0, routeInstructions_1.filterRouteInstructions)({
+                instructions: transactionMessage.instructions,
+                inputMint: new web3_js_1.PublicKey(quote.inputMint),
+                outputMint: new web3_js_1.PublicKey(quote.outputMint),
+            }),
+            lookupTables,
+        };
+    }
     /**
      * Get the transaction message and lookup tables for a transaction
      * @param transaction
@@ -134,40 +192,29 @@ class JupiterClient {
         };
     }
     async getLookupTable(accountKey) {
-        var _a;
-        const cached = this.lookupTableCahce.get(accountKey.toString());
+        const cached = this.lookupTableCache.get(accountKey.toString());
         if (cached !== undefined) {
             return cached;
         }
-        return ((_a = (await this.connection.getAddressLookupTable(accountKey)).value) !== null && _a !== void 0 ? _a : undefined);
+        const lookupTable = (await this.connection.getAddressLookupTable(accountKey)).value;
+        if (!lookupTable) {
+            return undefined;
+        }
+        // Populate the cache — without this every route re-fetches the same tables,
+        // which is a large share of the RPC calls a swap makes.
+        this.lookupTableCache.set(accountKey.toString(), lookupTable);
+        return lookupTable;
     }
     /**
-     * Get the jupiter instructions from transaction by filtering out instructions to compute budget and associated token programs
-     * @param transactionMessage the transaction message
-     * @param inputMint the input mint
-     * @param outputMint the output mint
+     * Strips the setup/teardown Jupiter wraps around its route.
+     * @deprecated Use {@link getRouteInstructions}, which quotes and filters in
+     * one step. Kept for callers holding a decompiled message of their own.
      */
     getJupiterInstructions({ transactionMessage, inputMint, outputMint, }) {
-        return transactionMessage.instructions.filter((instruction) => {
-            if (instruction.programId.toString() ===
-                'ComputeBudget111111111111111111111111111111') {
-                return false;
-            }
-            if (instruction.programId.toString() ===
-                'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA') {
-                return false;
-            }
-            if (instruction.programId.toString() === '11111111111111111111111111111111') {
-                return false;
-            }
-            if (instruction.programId.toString() ===
-                'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL') {
-                const mint = instruction.keys[3].pubkey;
-                if (mint.equals(inputMint) || mint.equals(outputMint)) {
-                    return false;
-                }
-            }
-            return true;
+        return (0, routeInstructions_1.filterRouteInstructions)({
+            instructions: transactionMessage.instructions,
+            inputMint,
+            outputMint,
         });
     }
 }

package/lib/browser/math/margin.d.ts

@@ -100,3 +100,31 @@ export declare function calculateMarginUSDCRequiredForTrade(velocityClient: Velo
  * @returns Collateral amount required, in `collateralIndex`'s own spot-market precision (via `velocityClient.convertToSpotPrecision`).
  */
 export declare function calculateCollateralDepositRequiredForTrade(velocityClient: VelocityClient, targetMarketIndex: number, baseSize: BN, collateralIndex: number, userMaxMarginRatio?: number, estEntryPrice?: BN): BN;
+/**
+ * Minimal equity floor to carry along with a quote transfer of `amount` out
+ * of a subaccount so the debited side ends at/above its buffered floor
+ * (`equityFloor + equityFloorBuffer`): the first
+ * `netEquity - (floor + buffer)` of the transfer carries no floor, the
+ * remainder carries floor one-for-one, capped at the floor the subaccount
+ * actually holds. `netEquity` is `User.getNetUsdValue()`, the metric the
+ * onchain floor checks use. Returns zero when no floor is set. The result
+ * never exceeds `amount`, so a credited side that met its own buffered floor
+ * before the transfer still meets it after. All values QUOTE_PRECISION.
+ */
+export declare function calculateEquityFloorAutoDelta(amount: BN, netEquity: BN, equityFloor: BN, equityFloorBuffer: BN): BN;
+/**
+ * Severity of a subaccount's equity relative to its floor, most to least
+ * severe. `breached`: below the floor, the permissionless breaker can trip.
+ * `critical`: below `floor + buffer`, risk-increasing actions are rejecting.
+ * `warning`: within `warningBufferMultiple * buffer` of the floor.
+ * `healthy`: above all thresholds. `disabled`: no floor set.
+ */
+export type EquityFloorLevel = 'breached' | 'critical' | 'warning' | 'healthy' | 'disabled';
+/**
+ * Classifies `netEquity` (`User.getNetUsdValue()`) against the floor
+ * thresholds. Used by the `EquityFloorManager` and the equity-floor guard bot
+ * so both report the same levels. `warningBufferMultiple` scales the warning
+ * threshold above the floor (default 2: warn inside `floor + 2 * buffer`).
+ * All QUOTE_PRECISION.
+ */
+export declare function getEquityFloorLevel(netEquity: BN, equityFloor: BN, equityFloorBuffer: BN, warningBufferMultiple?: number): EquityFloorLevel;