@velocity-exchange/sdk 0.4.0 → 0.6.0

package/lib/node/velocityClient.js

@@ -3042,7 +3042,8 @@ class VelocityClient {
      * @param subAccountId - Sub-account id to withdraw from; defaults to `this.activeSubAccountId`.
      * @returns The `withdraw` instruction.
      */
-    async getWithdrawIx(amount, marketIndex, userTokenAccount, reduceOnly = false, subAccountId) {
+    async getWithdrawIx(amount, marketIndex, userTokenAccount, reduceOnly = false, subAccountId, overrides) {
+        var _a;
         const user = await this.getUserAccountPublicKey(subAccountId);
         const remainingAccounts = this.getRemainingAccounts({
             userAccounts: [this.getUserAccountOrThrow(subAccountId)],
@@ -3068,7 +3069,7 @@ class VelocityClient {
             user,
             userStats: this.getUserStatsAccountPublicKey(),
             userTokenAccount,
-            authority: this.wallet.publicKey,
+            authority: (_a = overrides === null || overrides === void 0 ? void 0 : overrides.authority) !== null && _a !== void 0 ? _a : this.wallet.publicKey,
             tokenProgram,
             remainingAccounts,
         });
@@ -3154,14 +3155,23 @@ class VelocityClient {
      * @param marketIndex - Spot market index of the balance to transfer.
      * @param fromSubAccountId - Sub-account id to debit.
      * @param toSubAccountId - Sub-account id to credit.
+     * @param equityFloorDelta - Equity floor (QUOTE_PRECISION) to move from the debited to the credited
+     * sub-account along with the funds, keeping the sum of floors constant. The debited side must stay
+     * at/above its reduced floor and the credited side's collateral (after the transfer lands) must back
+     * its increased floor, else the transfer reverts with `InvalidEquityFloorTransfer`. Pass `'auto'`
+     * (quote market only) to move the minimal floor needed for the debited side to stay at/above its
+     * floor: `max(0, amount - (collateral - floor))`, capped at the debited side's floor. The auto delta
+     * never exceeds `amount`, so the credited side stays backed whenever it was before. Client-side
+     * pricing can differ slightly from the on-chain strict check at the exact boundary; retry with an
+     * explicit padded delta if an `'auto'` transfer reverts. Defaults to zero.
      * @param txParams - Optional compute-unit/priority-fee overrides for the transaction.
      * @returns The transaction signature.
      * @throws (on-chain) if `allowDelegateTransfer` is not enabled, if the signer is not the delegate on
      * both sub-accounts, if the sub-accounts have different owners, if either is bankrupt, or if
      * `fromSubAccountId === toSubAccountId`.
      */
-    async transferDepositByDelegate(amount, marketIndex, fromSubAccountId, toSubAccountId, txParams) {
-        const { txSig, slot } = await this.sendTransaction(await this.buildTransaction(await this.getTransferDepositByDelegateIx(amount, marketIndex, fromSubAccountId, toSubAccountId), txParams), [], this.opts);
+    async transferDepositByDelegate(amount, marketIndex, fromSubAccountId, toSubAccountId, equityFloorDelta = numericConstants_1.ZERO, txParams) {
+        const { txSig, slot } = await this.sendTransaction(await this.buildTransaction(await this.getTransferDepositByDelegateIx(amount, marketIndex, fromSubAccountId, toSubAccountId, equityFloorDelta), txParams), [], this.opts);
         if (fromSubAccountId === this.activeSubAccountId ||
             toSubAccountId === this.activeSubAccountId) {
             this.cacheSpotMarketSlot(slot, marketIndex);
@@ -3179,28 +3189,49 @@ class VelocityClient {
      * @param toSubAccountId - Sub-account id to credit.
      * @returns The instruction.
      */
-    async getTransferDepositByDelegateIx(amount, marketIndex, fromSubAccountId, toSubAccountId) {
+    async getTransferDepositByDelegateIx(amount, marketIndex, fromSubAccountId, toSubAccountId, equityFloorDelta = numericConstants_1.ZERO) {
         const fromUser = await (0, pda_1.getUserAccountPublicKey)(this.program.programId, this.authority, fromSubAccountId);
         const toUser = await (0, pda_1.getUserAccountPublicKey)(this.program.programId, this.authority, toSubAccountId);
-        let remainingAccounts;
-        const userMapKey = this.getUserMapKey(fromSubAccountId, this.authority);
-        const mapUser = this.users.get(userMapKey);
-        if (mapUser) {
-            remainingAccounts = this.getRemainingAccounts({
-                userAccounts: [mapUser.getUserAccountOrThrow()],
-                useMarketLastSlotCache: true,
-                writableSpotMarketIndexes: [marketIndex],
-            });
+        let resolvedFloorDelta;
+        if (equityFloorDelta === 'auto') {
+            // auto assumes amount and equity share QUOTE_PRECISION; for
+            // non-quote markets the caller must value the tokens themselves
+            if (marketIndex !== numericConstants_1.QUOTE_SPOT_MARKET_INDEX) {
+                throw new Error("equityFloorDelta 'auto' is only supported for the quote spot market; pass an explicit delta");
+            }
+            const fromUserClass = this.getUser(fromSubAccountId, this.authority);
+            const floor = fromUserClass.getUserAccountOrThrow().equityFloor;
+            if (floor.lte(numericConstants_1.ZERO)) {
+                resolvedFloorDelta = numericConstants_1.ZERO;
+            }
+            else {
+                const excess = anchor_1.BN.max(fromUserClass.getTotalCollateral('Initial', true).sub(floor), numericConstants_1.ZERO);
+                resolvedFloorDelta = anchor_1.BN.min(anchor_1.BN.max(amount.sub(excess), numericConstants_1.ZERO), floor);
+            }
         }
         else {
-            const fromUserAccount = (await this.program.account.user.fetch(fromUser));
-            remainingAccounts = this.getRemainingAccounts({
-                userAccounts: [fromUserAccount],
-                useMarketLastSlotCache: true,
-                writableSpotMarketIndexes: [marketIndex],
-            });
+            resolvedFloorDelta = equityFloorDelta;
         }
-        return await this.program.instruction.transferDepositByDelegate(marketIndex, amount, {
+        const loadUserAccount = async (subAccountId, userPublicKey) => {
+            const userMapKey = this.getUserMapKey(subAccountId, this.authority);
+            const mapUser = this.users.get(userMapKey);
+            if (mapUser) {
+                return mapUser.getUserAccountOrThrow();
+            }
+            return (await this.program.account.user.fetch(userPublicKey));
+        };
+        // moving equity floor triggers an on-chain margin check of the credited
+        // side, so its markets/oracles must be in the remaining accounts too
+        const userAccounts = [await loadUserAccount(fromSubAccountId, fromUser)];
+        if (resolvedFloorDelta.gt(numericConstants_1.ZERO)) {
+            userAccounts.push(await loadUserAccount(toSubAccountId, toUser));
+        }
+        const remainingAccounts = this.getRemainingAccounts({
+            userAccounts,
+            useMarketLastSlotCache: true,
+            writableSpotMarketIndexes: [marketIndex],
+        });
+        return await this.program.instruction.transferDepositByDelegate(marketIndex, amount, resolvedFloorDelta, {
             accounts: {
                 delegate: this.wallet.publicKey,
                 fromUser,
@@ -5241,6 +5272,42 @@ class VelocityClient {
             remainingAccounts,
         });
     }
+    /**
+     * Keeper instruction: trips the authority-wide equity floor breaker. Proves on-chain that the
+     * given subaccount's cross-margin total collateral is below its `equityFloor` (reverts with
+     * `SufficientCollateral` otherwise, or if no floor is set) and sets `equityBreakerTripped` on the
+     * authority's `UserStats` — every subaccount of the authority then rejects risk-increasing fills,
+     * withdrawals and transfers out until the warm admin calls `resetEquityFloorBreaker`.
+     * Permissionless — any signer may trip it; the margin calculation is the proof.
+     * @param userAccountPublicKey - Public key of the breached subaccount's user account.
+     * @param user - Decoded user account of the breached subaccount.
+     * @param txParams - Optional compute-unit/priority-fee overrides.
+     * @returns The transaction signature.
+     */
+    async tripEquityFloorBreaker(userAccountPublicKey, user, txParams) {
+        const { txSig } = await this.sendTransaction(await this.buildTransaction(await this.getTripEquityFloorBreakerIx(userAccountPublicKey, user), txParams), [], this.opts);
+        return txSig;
+    }
+    /**
+     * Builds the `tripEquityFloorBreaker` instruction. See `tripEquityFloorBreaker` for semantics.
+     * @param userAccountPublicKey - Public key of the breached subaccount's user account.
+     * @param userAccount - Decoded user account of the breached subaccount.
+     * @returns The instruction.
+     */
+    async getTripEquityFloorBreakerIx(userAccountPublicKey, userAccount) {
+        const remainingAccounts = this.getRemainingAccounts({
+            userAccounts: [userAccount],
+        });
+        return await this.program.instruction.tripEquityFloorBreaker({
+            accounts: {
+                state: await this.getStatePublicKey(),
+                keeper: this.wallet.publicKey,
+                user: userAccountPublicKey,
+                userStats: (0, pda_1.getUserStatsAccountPublicKey)(this.program.programId, userAccount.authority),
+            },
+            remainingAccounts,
+        });
+    }
     /**
      * Keeper instruction: marks a user account idle after confirming (via `validate_user_is_idle`)
      * it has been inactive long enough — the inactivity window is shorter (accelerated) when the
@@ -7183,11 +7250,12 @@ class VelocityClient {
     }
     /**
      * Keeper instruction: estimates the market's bid/ask price from the given makers' resting DLOB
-     * orders (filtered to those within `BID_ASK_TWAP_MAX_ORACLE_DIVERGENCE_PERCENT` of the oracle
-     * price) and folds the estimate into `lastBidPriceTwap`/`lastAskPriceTwap`. Restricted: the
-     * calling wallet's `UserStats` must have `canUpdateBidAskTwap` set and at least 1000 USDC
-     * (`QUOTE_PRECISION`, 1e6) staked in the insurance fund (`ifStakedQuoteAssetAmount`), or the
-     * instruction reverts.
+     * orders (kept only within `±BID_ASK_TWAP_MAX_ORACLE_DIVERGENCE_PERCENT` of the oracle price on
+     * both sides) and folds the estimate into `lastBidPriceTwap`/`lastAskPriceTwap`. This does NOT
+     * update the funding rate, crank funding separately via `getUpdateFundingRateIx`. Restricted:
+     * the calling wallet's `UserStats` (which must be the signer's own) must have
+     * `canUpdateBidAskTwap` set and at least 1000 USDC (`QUOTE_PRECISION`, 1e6) staked in the
+     * insurance fund (`ifStakedQuoteAssetAmount`), or the instruction reverts.
      * @param perpMarketIndex - Perp market index to update.
      * @param makers - `(maker, makerStats)` pairs whose resting orders are sampled for the estimate.
      * @param txParams - Optional compute-unit/priority-fee overrides.
@@ -7433,15 +7501,17 @@ class VelocityClient {
      * @param marketIndex - Spot market index whose insurance fund to stake into.
      * @returns The instruction.
      */
-    async getInitializeInsuranceFundStakeIx(marketIndex) {
-        const ifStakeAccountPublicKey = (0, pda_1.getInsuranceFundStakeAccountPublicKey)(this.program.programId, this.wallet.publicKey, marketIndex);
+    async getInitializeInsuranceFundStakeIx(marketIndex, overrides) {
+        var _a;
+        const authority = (_a = overrides === null || overrides === void 0 ? void 0 : overrides.authority) !== null && _a !== void 0 ? _a : this.wallet.publicKey;
+        const ifStakeAccountPublicKey = (0, pda_1.getInsuranceFundStakeAccountPublicKey)(this.program.programId, authority, marketIndex);
         const accounts = {
             insuranceFundStake: ifStakeAccountPublicKey,
             spotMarket: this.getSpotMarketAccountOrThrow(marketIndex).pubkey,
-            userStats: (0, pda_1.getUserStatsAccountPublicKey)(this.program.programId, this.wallet.publicKey // only allow payer to initialize own insurance fund stake account
+            userStats: (0, pda_1.getUserStatsAccountPublicKey)(this.program.programId, authority // only allow payer to initialize own insurance fund stake account
             ),
-            authority: this.wallet.publicKey,
-            payer: this.wallet.publicKey,
+            authority,
+            payer: authority,
             rent: web3_js_1.SYSVAR_RENT_PUBKEY,
             systemProgram: web3_js_1.SystemProgram.programId,
             state: await this.getStatePublicKey(),
@@ -7462,9 +7532,11 @@ class VelocityClient {
      * @param collateralAccountPublicKey - Token account to debit for the stake.
      * @returns The instruction.
      */
-    async getAddInsuranceFundStakeIx(marketIndex, amount, collateralAccountPublicKey) {
+    async getAddInsuranceFundStakeIx(marketIndex, amount, collateralAccountPublicKey, overrides) {
+        var _a;
+        const authority = (_a = overrides === null || overrides === void 0 ? void 0 : overrides.authority) !== null && _a !== void 0 ? _a : this.wallet.publicKey;
         const spotMarket = this.getSpotMarketAccountOrThrow(marketIndex);
-        const ifStakeAccountPublicKey = (0, pda_1.getInsuranceFundStakeAccountPublicKey)(this.program.programId, this.wallet.publicKey, marketIndex);
+        const ifStakeAccountPublicKey = (0, pda_1.getInsuranceFundStakeAccountPublicKey)(this.program.programId, authority, marketIndex);
         const remainingAccounts = [];
         this.addTokenMintToRemainingAccounts(spotMarket, remainingAccounts);
         if (this.isTransferHook(spotMarket)) {
@@ -7476,9 +7548,9 @@ class VelocityClient {
                 state: await this.getStatePublicKey(),
                 spotMarket: spotMarket.pubkey,
                 insuranceFundStake: ifStakeAccountPublicKey,
-                userStats: (0, pda_1.getUserStatsAccountPublicKey)(this.program.programId, this.wallet.publicKey // only allow payer to add to own insurance fund stake account
+                userStats: (0, pda_1.getUserStatsAccountPublicKey)(this.program.programId, authority // only allow payer to add to own insurance fund stake account
                 ),
-                authority: this.wallet.publicKey,
+                authority,
                 spotMarketVault: spotMarket.vault,
                 insuranceFundVault: spotMarket.insuranceFund.vault,
                 velocitySigner: this.getSignerPublicKey(),

package/package.json

@@ -1,12 +1,16 @@
 {
 	"name": "@velocity-exchange/sdk",
-	"version": "0.4.0",
+	"version": "0.6.0",
 	"main": "lib/node/index.js",
 	"types": "lib/node/index.d.ts",
 	"module": "./lib/browser/index.js",
+	"files": [
+		"lib"
+	],
 	"repository": {
 		"type": "git",
-		"url": "git@github.com:velocity-exchange/velocity-v1.git"
+		"url": "git+https://github.com/velocity-exchange/velocity-v1.git",
+		"directory": "packages/sdk"
 	},
 	"scripts": {
 		"lint": "eslint './**/*.{ts,tsx}' --quiet --format unix",
@@ -111,7 +115,7 @@
 	},
 	"description": "SDK for Velocity Protocol",
 	"engines": {
-		"node": "^24.0.0"
+		"node": ">=20"
 	},
 	"resolutions": {
 		"@solana/web3.js": "1.98.0",

package/.prettierignore

@@ -1 +0,0 @@
-src/idl/velocity.ts

package/CHANGELOG.md

@@ -1,132 +0,0 @@
-# @velocity-exchange/sdk
-
-## 0.4.0
-
-### Minor Changes
-
-- [#197](https://github.com/velocity-exchange/velocity-v1/pull/197) [`900c07d`](https://github.com/velocity-exchange/velocity-v1/commit/900c07d9da7e106c82fbe65b3d92226d090bdee9) Thanks [@jordy25519](https://github.com/jordy25519)! - Attach the taker's `RevenueShareEscrow` on perp fills for referred takers. `getFillPerpOrderIx` gains an optional `takerIsReferred` flag; when set (or when the order carries a builder code) the deterministic escrow PDA is added to the fill. This mirrors the on-chain fill gate, which reads `UserStats.referrerStatus` (the `BuilderReferral` bit), so referred takers' fills no longer revert with `UnableToLoadRevenueShareAccount`. `ReferrerMap` gains `isBuilderReferral(authority)` and `mustGetIsBuilderReferral(authority)`, sourcing the bit from the UserStats fetch it already performs.
-
-- [#189](https://github.com/velocity-exchange/velocity-v1/pull/189) [`8df28ac`](https://github.com/velocity-exchange/velocity-v1/commit/8df28ac6d113760ae4a8cdff4ad438cb25efce2c) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Program↔SDK parity fixes from the 2026-07-02 audit: renamed deprecated Switchboard
-  OracleSource keys to match the IDL (fixes a decode crash on affected markets), applied
-  the $100 initial-margin unrealized-PnL cap, standardized auction/limit prices to order
-  tick size across the DLOB, isolated-position handling in bankruptcy/liquidation math,
-  corrected MM-oracle validity gating, referrer_status memcmp offset, PerpOperation and
-  OrderBitFlag bit values, wired five missing event records into EventSubscriber, fixed
-  withdraw-limit divisors, multi-pool margin segregation, referee/builder fee estimation,
-  and added AdminClient.updatePauseAdmin plus admin CLI commands for pause-admin rotation
-  and fee-pool transfers. Also fixed withdrawFromIsolatedPerpPosition's withdraw-all path:
-  it substituted the MIN_I64 sentinel into the instruction's unsigned u64 amount (serializing
-  as 2^63, so full withdrawals always failed on-chain with InsufficientCollateral); it now
-  clamps the request to the position's deposit plus claimable PnL.
-
-  Follow-up completeness fixes: DLOBSubscriber.getL2/getL3 (and the dlob-server publisher) now
-  thread orderTickSize so the public book view is tick-standardized like on-chain; added
-  hasIsolatedMarginBankrupt and wired isolated-only bankruptcy detection into keeper resolution
-  (isIsolatedPositionBankrupt now guards against non-isolated indices); getMarketFees applies the
-  referee discount and calculateFeeForQuoteAmount accepts builder params so both public fee-prediction
-  entry points match on-chain; and isFallbackAvailableLiquiditySource now fully mirrors
-  amm_fill_gates_ok, adding the market-drawdown and MM-vs-exchange oracle volatility gates.
-
-  Low-risk parity follow-ups: MarginCategory now includes 'Fill' as a single shared type, handled
-  across perp margin ratio / unrealized-asset-weight and spot asset/liability weights (the
-  integer-averaged midpoint of initial and maintenance, mirroring get_margin_ratio /
-  get_asset_weight / get_liability_weight) instead of throwing or returning undefined; the
-  worst-tier taker-fee estimate in calculateEntriesEffectOnFreeCollateral now ceil-divides to match
-  calculate_taker_fee; MM-oracle validity is computed with the raw exchange confidence (matching
-  get_mm_oracle_price_data) while the returned MM price keeps its diff-adjusted confidence; and
-  corrected the OracleSourceNum doc (it is an SDK-internal oracle-id encoding, not the on-chain
-  Borsh discriminant).
-
-  Visible/breaking API changes in this release: `OracleSource.SWITCHBOARD` /
-  `OracleSource.SWITCHBOARD_ON_DEMAND` (and the corresponding `OracleSourceNum` entries) are renamed
-  to `DEPRECATED_SWITCHBOARD` / `DEPRECATED_SWITCHBOARD_ON_DEMAND` with no aliases kept for the old
-  names; `ContractType.FUTURE` is renamed to `DEPRECATED_FUTURE`; and `FeatureBitFlags.BUILDER_REFERRAL`
-  is removed outright, since no such on-chain flag exists. Separately, `getLimitPrice` gained a new
-  optional trailing `tickSize` parameter — the existing `fallbackPrice` parameter stays in its original
-  4th position, so old 4-argument call sites keep working unchanged.
-
-### Patch Changes
-
-- [#199](https://github.com/velocity-exchange/velocity-v1/pull/199) [`dff8a47`](https://github.com/velocity-exchange/velocity-v1/commit/dff8a4754f6b736fed330b2ab4fa5685db4f8159) Thanks [@jordy25519](https://github.com/jordy25519)! - Add BTC-PERP (index 1) and ETH-PERP (index 2) to `DevnetPerpMarkets`, reflecting the two Pyth-Lazer perp markets re-created on devnet. ETH-PERP uses lazer feed 2 (real ETH price feed).
-
-- [#193](https://github.com/velocity-exchange/velocity-v1/pull/193) [`bafd699`](https://github.com/velocity-exchange/velocity-v1/commit/bafd6990f8322f232d2f0d17042beb0e9c567164) Thanks [@jordy25519](https://github.com/jordy25519)! - Remove the stale `FettyRIP` (marketIndex 2) entry from `DevnetPerpMarkets`. That perp market was deleted on-chain, but the hand-maintained devnet config still listed it, so consumers that enumerate all perp markets (keeper-bots-v2, dlob-server) crashed with `Perp market config for 2 not found` when resolving the nonexistent market. The devnet config now mirrors on-chain state (SOL-PERP at index 0 only).
-
-## 0.3.0
-
-### Minor Changes
-
-- [#172](https://github.com/velocity-exchange/velocity-v1/pull/172) [`b7d15b9`](https://github.com/velocity-exchange/velocity-v1/commit/b7d15b970a74d267aeaf20bb644d5344b9aadc61) Thanks [@0xahzam](https://github.com/0xahzam)! - Decouple solvency-repair from the withdraw pause. The `resolve_perp_pnl_deficit`,
-  `resolve_perp_bankruptcy`, and `resolve_spot_bankruptcy` instructions are now gated by a
-  new `State.solvencyStatus` bitfield instead of `WithdrawPaused`, so user withdrawals can
-  be halted while solvency repair keeps running (or repair can be frozen on its own). Adds
-  the `SolvencyStatus` enum, `StateAccount.solvencyStatus`, a `solvencyRepairPaused()`
-  helper, `AdminClient.updateSolvencyStatus`, and the `exchange set-solvency-status` admin
-  CLI command.
-
-- [#141](https://github.com/velocity-exchange/velocity-v1/pull/141) [`3f148f8`](https://github.com/velocity-exchange/velocity-v1/commit/3f148f8b477e4176e11e0660adb0e67dd5163d3b) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Harden the native fast-path admin handlers. The
-  `update_amm_spread_adjustment_native` instruction now requires the program
-  `State` account: `getUpdateAmmSpreadAdjustmentNativeIx` is now **async** and
-  returns a `Promise<TransactionInstruction>` (it derives and appends the state
-  account), and its compute-unit budget was raised to cover the on-chain account
-  validation. Direct callers must `await` the builder. Two new program error
-  codes are surfaced in the IDL: `InvalidNativeStateAccount` (6355) and
-  `InvalidNativePerpMarketAccount` (6356).
-
-### Patch Changes
-
-- [#173](https://github.com/velocity-exchange/velocity-v1/pull/173) [`2f6c64d`](https://github.com/velocity-exchange/velocity-v1/commit/2f6c64d54f1146d8e7f9ee4ab556929c6bf8b920) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Fix stale `User` account byte offsets in `memcmp` filters and `OrderSubscriber`.
-
-  The Velocity `User` account is 4496 bytes, but the memcmp filters and the
-  `OrderSubscriber` staleness check still used offsets from the older 4376-byte
-  layout. As a result `getUserWithOrderFilter()` matched zero accounts, so any
-  consumer that bulk-loads users-with-orders (e.g. the DLOB server's
-  `OrderSubscriber.fetch()`) loaded no orders and produced an empty order book
-  (vAMM-only L2, empty L3). Offsets for `idle`, `hasOpenOrder`, `hasOpenAuction`,
-  `poolId`, and `lastActiveSlot` are corrected to match the on-chain layout.
-
-## 0.2.6
-
-### Patch Changes
-
-- [#156](https://github.com/velocity-exchange/velocity-v1/pull/156) [`d3b58ab`](https://github.com/velocity-exchange/velocity-v1/commit/d3b58ab7e3ad33f0e6634ff87e9b150915b3aa13) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Fix account decoder to pass account names as-is instead of capitalizing them. The
-  Anchor v1 IDL program constructor already camelCases account names, so the extra
-  `capitalize()` call was incorrect and caused decoding failures in the gRPC and
-  WebSocket subscribers.
-
-## 0.2.5
-
-### Patch Changes
-
-- [#155](https://github.com/velocity-exchange/velocity-v1/pull/155) [`15073bc`](https://github.com/velocity-exchange/velocity-v1/commit/15073bc0b740b2d1cad471126a00368e72655bd5) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Make the `UserAccountSubscriber` "not subscribed" contract consistent and fix a
-  misleading error message. `getUserAccountAndSlot()` now throws `NotSubscribedError`
-  when called before `subscribe()` on the gRPC-multi and WebSocket-program subscribers
-  too (the WebSocket and polling subscribers already did) — so `User.getUserAccount()`
-  uniformly throws when not subscribed and returns `undefined` only when subscribed but
-  the account was not found on chain. `getUserAccountOrThrow()` /
-  `getUserAccountAndSlotOrThrow()` now throw `User account not found: <pubkey>` (was
-  `User account not loaded`), since after `subscribe()` resolves a missing account means
-  "not found", not "still loading".
-
-## 0.2.4
-
-### Patch Changes
-
-- [#127](https://github.com/velocity-exchange/velocity-v1/pull/127) [`4f8e7aa`](https://github.com/velocity-exchange/velocity-v1/commit/4f8e7aaef0e35b190fc0b91cd29314d902d1ccab) Thanks [@ChesterSim](https://github.com/ChesterSim)! - reflect Typescript types on IDL changes
-
-## 0.2.3
-
-### Patch Changes
-
-- [#100](https://github.com/velocity-exchange/velocity-v1/pull/100) [`ae78769`](https://github.com/velocity-exchange/velocity-v1/commit/ae78769ef58355202c030435c2796ef045fe30a0) Thanks [@ChesterSim](https://github.com/ChesterSim)! - add back ForwardOnlyTxSender and calculateMaxRemainingDeposit
-
-## 0.2.2
-
-### Patch Changes
-
-- [#97](https://github.com/velocity-exchange/velocity-v1/pull/97) [`022a949`](https://github.com/velocity-exchange/velocity-v1/commit/022a949cb1802171ca57a61260f86c8908f94f34) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Re-export `PriceUpdateAccount` from the package root and declare `@types/node` as a devDependency (fixes the SDK build under isolated installs). Enables downstream apps (dlob-server, keeper-bots-v2) to consume the velocity SDK without reaching into subpaths.
-
-## 0.2.1
-
-### Patch Changes
-
-- [`4fd7462`](https://github.com/velocity-exchange/velocity-v1/commit/4fd7462bfa3c55e31e3457b1b65f519cf052a6fa) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Testing new changelog based package publishing flow

package/build-browser.js

@@ -1,58 +0,0 @@
-const esbuild = require('esbuild');
-const path = require('path');
-
-async function build() {
-  try {
-    await esbuild.build({
-      entryPoints: ['./lib/browser/index.js'],
-      bundle: true,
-      minify: true,
-      format: 'cjs',
-      platform: 'browser',
-      target: ['es2020'],
-      outfile: './dist/browser.min.js',
-      external: [
-        '@solana/web3.js',
-        '@coral-xyz/anchor',
-        '@coral-xyz/anchor-30',
-      ],
-      define: {
-        'process.env.NODE_ENV': '"production"',
-        'global': 'globalThis',
-      },
-      inject: [path.resolve(__dirname, 'esbuild-shims.js')],
-      alias: {
-        // Node polyfills for browser
-        'crypto': 'crypto-browserify',
-        'stream': 'stream-browserify',
-        'path': 'path-browserify',
-        'os': 'os-browserify/browser',
-        'process': 'process/browser',
-        'vm': 'vm-browserify',
-      },
-      // Ignore node-only modules
-      plugins: [{
-        name: 'ignore-node-modules',
-        setup(build) {
-          build.onResolve({ filter: /^(fs|net|dns|tls|http2)$/ }, args => {
-            return { path: args.path, namespace: 'ignore-ns' };
-          });
-          build.onLoad({ filter: /.*/, namespace: 'ignore-ns' }, () => {
-            return { contents: 'export default {}' };
-          });
-        },
-      }],
-      loader: {
-        '.json': 'json',
-      },
-      treeShaking: true,
-      sourcemap: false,
-    });
-    console.log('✅ Browser build complete');
-  } catch (error) {
-    console.error('❌ Build failed:', error);
-    process.exit(1);
-  }
-}
-
-build();

package/bunfig.toml

@@ -1,3 +0,0 @@
-[install]
-exact = true
-minimumReleaseAge = 604800 # 7 days

package/esbuild-shims.js

@@ -1,12 +0,0 @@
-import { Buffer } from 'buffer';
-import process from 'process';
-
-if (typeof globalThis.Buffer === 'undefined') {
-  globalThis.Buffer = Buffer;
-}
-
-if (typeof globalThis.process === 'undefined') {
-  globalThis.process = process;
-}
-
-export { Buffer, process };

package/scripts/deposit-isolated-positions.ts

@@ -1,110 +0,0 @@
-import { Connection, Keypair, PublicKey } from '@solana/web3.js';
-import dotenv from 'dotenv';
-import { AnchorProvider, Idl, Program, ProgramAccount, BN } from '@coral-xyz/anchor';
-import velocityIDL from '../src/idl/velocity.json';
-import {
-	VELOCITY_PROGRAM_ID,
-	PerpMarketAccount,
-	SpotMarketAccount,
-	OracleInfo,
-	Wallet,
-	numberToSafeBN,
-} from '../src';
-import { VelocityClient } from '../src/velocityClient';
-import { VelocityClientConfig } from '../src/velocityClientConfig';
-
-async function main() {
-	dotenv.config({ path: '../' });
-
-	const RPC_ENDPOINT = process.env.RPC_ENDPOINT;
-	if (!RPC_ENDPOINT) throw new Error('RPC_ENDPOINT env var required');
-
-	let keypair: Keypair;
-	const pk = process.env.PRIVATE_KEY;
-	if (pk) {
-		const secret = Uint8Array.from(JSON.parse(pk));
-		keypair = Keypair.fromSecretKey(secret);
-	} else {
-		keypair = new Keypair();
-		console.warn('Using ephemeral keypair. Provide PRIVATE_KEY to use a real wallet.');
-	}
-	const wallet = new Wallet(keypair);
-
-	const connection = new Connection(RPC_ENDPOINT);
-	const provider = new AnchorProvider(connection, wallet as any, {
-		commitment: 'processed',
-	});
-	const programId = new PublicKey(VELOCITY_PROGRAM_ID);
-	const program = new Program(velocityIDL as Idl, programId, provider);
-
-	const allPerpMarketProgramAccounts =
-		(await program.account.perpMarket.all()) as ProgramAccount<PerpMarketAccount>[];
-	const perpMarketIndexes = allPerpMarketProgramAccounts.map((val) => val.account.marketIndex);
-	const allSpotMarketProgramAccounts =
-		(await program.account.spotMarket.all()) as ProgramAccount<SpotMarketAccount>[];
-	const spotMarketIndexes = allSpotMarketProgramAccounts.map((val) => val.account.marketIndex);
-
-	const seen = new Set<string>();
-	const oracleInfos: OracleInfo[] = [];
-	for (const acct of allPerpMarketProgramAccounts) {
-		const key = `${acct.account.amm.oracle.toBase58()}-${Object.keys(acct.account.amm.oracleSource)[0]}`;
-		if (!seen.has(key)) {
-			seen.add(key);
-			oracleInfos.push({ publicKey: acct.account.amm.oracle, source: acct.account.amm.oracleSource });
-		}
-	}
-	for (const acct of allSpotMarketProgramAccounts) {
-		const key = `${acct.account.oracle.toBase58()}-${Object.keys(acct.account.oracleSource)[0]}`;
-		if (!seen.has(key)) {
-			seen.add(key);
-			oracleInfos.push({ publicKey: acct.account.oracle, source: acct.account.oracleSource });
-		}
-	}
-
-	const clientConfig: VelocityClientConfig = {
-		connection,
-		wallet,
-		programID: programId,
-		accountSubscription: { type: 'websocket', commitment: 'processed' },
-		perpMarketIndexes,
-		spotMarketIndexes,
-		oracleInfos,
-		env: 'devnet',
-	};
-	const client = new VelocityClient(clientConfig);
-	await client.subscribe();
-
-	const candidates = perpMarketIndexes.filter((i) => i >= 0 && i <= 5);
-	const targetMarketIndex = candidates.length
-		? candidates[Math.floor(Math.random() * candidates.length)]
-		: perpMarketIndexes[0];
-
-	const perpMarketAccount = client.getPerpMarketAccount(targetMarketIndex);
-	const quoteSpotMarketIndex = perpMarketAccount.quoteSpotMarketIndex;
-	const spotMarketAccount = client.getSpotMarketAccount(quoteSpotMarketIndex);
-
-	const precision = new BN(10).pow(new BN(spotMarketAccount.decimals));
-	const amount = numberToSafeBN(0.01, precision);
-
-	const userTokenAccount = await client.getAssociatedTokenAccount(quoteSpotMarketIndex);
-	const ix = await client.getDepositIntoIsolatedPerpPositionIx(
-		amount,
-		targetMarketIndex,
-		userTokenAccount,
-		0
-	);
-
-	const tx = await client.buildTransaction([ix]);
-	const { txSig } = await client.sendTransaction(tx);
-	console.log(`Deposited into isolated perp market ${targetMarketIndex}: ${txSig}`);
-
-	await client.getUser().unsubscribe();
-	await client.unsubscribe();
-}
-
-main().catch((e) => {
-	console.error(e);
-	process.exit(1);
-});
-
-