@velocity-exchange/sdk 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,19 +1,39 @@
 # @velocity-exchange/sdk
 
+## 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/drift-labs/protocol-v2-shadow/pull/100) [`ae78769`](https://github.com/drift-labs/protocol-v2-shadow/commit/ae78769ef58355202c030435c2796ef045fe30a0) Thanks [@ChesterSim](https://github.com/ChesterSim)! - add back ForwardOnlyTxSender and calculateMaxRemainingDeposit
+- [#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/drift-labs/protocol-v2-shadow/pull/97) [`022a949`](https://github.com/drift-labs/protocol-v2-shadow/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.
+- [#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/drift-labs/protocol-v2-shadow/commit/4fd7462bfa3c55e31e3457b1b65f519cf052a6fa) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Testing new changelog based package publishing flow
+- [`4fd7462`](https://github.com/velocity-exchange/velocity-v1/commit/4fd7462bfa3c55e31e3457b1b65f519cf052a6fa) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Testing new changelog based package publishing flow

package/README.md

@@ -1,11 +1,11 @@
 <div align="center">
-  <img height="120" src="https://raw.githubusercontent.com/drift-labs/protocol-v2-shadow/master/assets/velocity-logo.svg" />
+  <img height="120" src="https://raw.githubusercontent.com/velocity-exchange/velocity-v1/master/assets/velocity-logo.svg" />
 
   <h1 style="margin-top:20px;">Velocity Exchange</h1>
 
   <p>
     <a href="https://www.npmjs.com/package/@velocity-exchange/sdk"><img alt="SDK npm package" src="https://img.shields.io/npm/v/@velocity-exchange/sdk" /></a>
-    <a href="https://drift-labs.github.io/protocol-v2/sdk/"><img alt="Docs" src="https://img.shields.io/badge/docs-tutorials-blueviolet" /></a>
+    <a href="https://velocity-exchange.github.io/protocol-v2/sdk/"><img alt="Docs" src="https://img.shields.io/badge/docs-tutorials-blueviolet" /></a>
     <a href="https://discord.com/channels/849494028176588802/878700556904980500"><img alt="Discord Chat" src="https://img.shields.io/discord/889577356681945098?color=blueviolet" /></a>
     <a href="https://opensource.org/licenses/Apache-2.0"><img alt="License" src="https://img.shields.io/github/license/project-serum/anchor?color=blueviolet" /></a>
   </p>
@@ -21,18 +21,18 @@ npm i @velocity-exchange/sdk
 
 _Start here if you're integrating with Velocity!_
 
-- [Velocity v2-teacher + API Docs](https://drift-labs.github.io/v2-teacher/)
+- [Velocity v2-teacher + API Docs](https://velocity-exchange.github.io/v2-teacher/)
   - Docs and examples for using the SDK in Typescript and Python
   - Useful concepts and examples when integrating Velocity
   - Docs for Velocity's "Data API"
-- [Typescript API docs](https://drift-labs.github.io/protocol-v2/sdk/)
+- [Typescript API docs](https://velocity-exchange.github.io/protocol-v2/sdk/)
   - JSDoc automated documentation for the Velocity v2 Typescript SDK
 - [Velocity docs](https://docs.drift.trade/)
   - Comprehensive universal docs for Velocity
 
 ---
 
-The below is a light overview of using Solana and Velocity's typescript sdk. If you want comprehensive docs with examples of how to integrate with Velocity you should use the [v2-teacher docs](https://drift-labs.github.io/v2-teacher/).
+The below is a light overview of using Solana and Velocity's typescript sdk. If you want comprehensive docs with examples of how to integrate with Velocity you should use the [v2-teacher docs](https://velocity-exchange.github.io/v2-teacher/).
 
 ### Setting up a wallet for your program
 

package/lib/browser/accounts/grpcMultiAccountSubscriber.d.ts

@@ -34,5 +34,4 @@ export declare class grpcMultiAccountSubscriber<T, U = undefined> {
     removeAccounts(accounts: PublicKey[]): Promise<void>;
     unsubscribe(): Promise<void>;
     private setTimeout;
-    private capitalize;
 }

package/lib/browser/accounts/grpcMultiAccountSubscriber.js

@@ -125,7 +125,7 @@ class grpcMultiAccountSubscriber {
                             buffer: newBuffer,
                             slot: currentSlot,
                         });
-                        const accountDecoded = this.program.coder.accounts.decode(this.capitalize(this.accountName), newBuffer);
+                        const accountDecoded = this.program.coder.accounts.decode(this.accountName, newBuffer);
                         this.setAccountData(accountId, accountDecoded, currentSlot);
                     }
                 }
@@ -220,7 +220,7 @@ class grpcMultiAccountSubscriber {
             const handleDataBuffer = (context, buffer, accountProps) => {
                 const data = this.decodeBufferFn
                     ? this.decodeBufferFn(buffer, accountPubkey, accountProps)
-                    : this.program.coder.accounts.decode(this.capitalize(this.accountName), buffer);
+                    : this.program.coder.accounts.decode(this.accountName, buffer);
                 const handler = this.onChangeMap.get(accountPubkey);
                 if (handler) {
                     handler(data, context, buffer, accountProps);
@@ -377,10 +377,5 @@ class grpcMultiAccountSubscriber {
             }
         }, (_a = this.resubOpts) === null || _a === void 0 ? void 0 : _a.resubTimeoutMs);
     }
-    capitalize(value) {
-        if (!value)
-            return value;
-        return value.charAt(0).toUpperCase() + value.slice(1);
-    }
 }
 exports.grpcMultiAccountSubscriber = grpcMultiAccountSubscriber;

package/lib/browser/accounts/grpcMultiUserAccountSubscriber.js

@@ -146,6 +146,9 @@ class grpcMultiUserAccountSubscriber {
                 isSubscribed = false;
             },
             getUserAccountAndSlot() {
+                if (!isSubscribed) {
+                    throw new types_1.NotSubscribedError('You must call `subscribe` before using this function');
+                }
                 return parent.userData.get(key);
             },
         };

package/lib/browser/accounts/webSocketAccountSubscriberV2.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebSocketAccountSubscriberV2 = void 0;
-const utils_1 = require("./utils");
 const gill_1 = require("gill");
 const bs58_1 = __importDefault(require("bs58"));
 /**
@@ -376,7 +375,7 @@ class WebSocketAccountSubscriberV2 {
             return this.decodeBufferFn(buffer);
         }
         else {
-            return this.program.coder.accounts.decode((0, utils_1.capitalize)(this.accountName), buffer);
+            return this.program.coder.accounts.decode(this.accountName, buffer);
         }
     }
     unsubscribe(onResub = false) {

package/lib/browser/accounts/websocketProgramUserAccountSubscriber.js

@@ -45,6 +45,9 @@ class WebSocketProgramUserAccountSubscriber {
         this.isSubscribed = false;
     }
     getUserAccountAndSlot() {
+        if (!this.isSubscribed) {
+            throw new types_1.NotSubscribedError('You must call `subscribe` before using this function');
+        }
         return this.userAccountAndSlot;
     }
 }

package/lib/browser/config.js

@@ -22,7 +22,7 @@ exports.configs = {
         PYTH_ORACLE_MAPPING_ADDRESS: 'BmA9Z6FjioHJPpjT39QazZyhDRUdZy2ezwx4GiDdE2u2',
         VELOCITY_PROGRAM_ID: exports.VELOCITY_DEVNET_PROGRAM_ID,
         JIT_PROXY_PROGRAM_ID: 'J1TnP8zvVxbtF5KFp5xRmWuvG9McnhzmBd9XGfCyuxFP',
-        QUOTE_MINT_ADDRESS: '8FfvSRKMZRDHrCBy142XMUXrKEkXnxDQ4YmJv7xbAw8Q',
+        QUOTE_MINT_ADDRESS: 'GqmEqYsy8EyvofDpmtFxK8zhYrgWgNokAtYoduQdL7v6',
         V2_ALPHA_TICKET_MINT_ADDRESS: 'DeEiGWfCMP9psnLGkxGrBBMEAW5Jv8bBGMN8DCtFRCyB',
         PERP_MARKETS: perpMarkets_1.DevnetPerpMarkets,
         SPOT_MARKETS: spotMarkets_1.DevnetSpotMarkets,

package/lib/browser/constants/spotMarkets.js

@@ -15,7 +15,7 @@ exports.DevnetSpotMarkets = [
         poolId: 0,
         oracle: new web3_js_1.PublicKey('Dai8hT1YRBBm5rBSJUSKcdR11psM55LVAkshbypfC4k4'),
         oracleSource: types_1.OracleSource.PYTH_LAZER_STABLE_COIN,
-        mint: new web3_js_1.PublicKey('8FfvSRKMZRDHrCBy142XMUXrKEkXnxDQ4YmJv7xbAw8Q'),
+        mint: new web3_js_1.PublicKey('GqmEqYsy8EyvofDpmtFxK8zhYrgWgNokAtYoduQdL7v6'),
         precision: new anchor_1.BN(10).pow(numericConstants_1.SIX),
         precisionExp: numericConstants_1.SIX,
         pythLazerId: 8,

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

@@ -1,5 +1,19 @@
 import { BN } from '../isomorphic/anchor';
+/**
+ * @param ifLiquidationFee Since PR#75 the program sizes liquidations against the
+ *   COMBINED insurance-fund + protocol liquidation fee budget:
+ *   `market.ifLiquidationFee + market.protocolLiquidationFee` (split IF-first
+ *   on-chain). Pass that sum here to match on-chain sizing; passing
+ *   `market.ifLiquidationFee` alone under-sizes the estimate.
+ */
 export declare function calculateBaseAssetAmountToCoverMarginShortage(marginShortage: BN, marginRatio: number, liquidationFee: number, ifLiquidationFee: number, oraclePrice: BN, quoteOraclePrice: BN): BN | undefined;
+/**
+ * @param ifLiquidationFee Since PR#75 the program sizes liquidations against the
+ *   COMBINED insurance-fund + protocol liquidation fee budget:
+ *   `market.ifLiquidationFee + market.protocolLiquidationFee` (split IF-first
+ *   on-chain). Pass that sum here to match on-chain sizing; passing
+ *   `market.ifLiquidationFee` alone under-sizes the estimate.
+ */
 export declare function calculateLiabilityTransferToCoverMarginShortage(marginShortage: BN, assetWeight: number, assetLiquidationMultiplier: number, liabilityWeight: number, liabilityLiquidationMultiplier: number, liabilityDecimals: number, liabilityPrice: BN, ifLiquidationFee: number): BN | undefined;
 export declare function calculateAssetTransferForLiabilityTransfer(assetAmount: BN, assetLiquidationMultiplier: number, assetDecimals: number, assetPrice: BN, liabilityAmount: BN, liabilityLiquidationMultiplier: number, liabilityDecimals: number, liabilityPrice: BN): BN | undefined;
 export declare function calculateMaxPctToLiquidate(userLastActiveSlot: BN, userLiquidationMarginFreed: BN, marginShortage: BN, slot: BN, initialPctToLiquidate: BN, liquidationDuration: BN): BN;

package/lib/browser/math/liquidation.js

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getMarginShortage = exports.calculateMaxPctToLiquidate = exports.calculateAssetTransferForLiabilityTransfer = exports.calculateLiabilityTransferToCoverMarginShortage = exports.calculateBaseAssetAmountToCoverMarginShortage = void 0;
 const anchor_1 = require("../isomorphic/anchor");
 const numericConstants_1 = require("../constants/numericConstants");
+/**
+ * @param ifLiquidationFee Since PR#75 the program sizes liquidations against the
+ *   COMBINED insurance-fund + protocol liquidation fee budget:
+ *   `market.ifLiquidationFee + market.protocolLiquidationFee` (split IF-first
+ *   on-chain). Pass that sum here to match on-chain sizing; passing
+ *   `market.ifLiquidationFee` alone under-sizes the estimate.
+ */
 function calculateBaseAssetAmountToCoverMarginShortage(marginShortage, marginRatio, liquidationFee, ifLiquidationFee, oraclePrice, quoteOraclePrice) {
     const marginRatioBN = new anchor_1.BN(marginRatio)
         .mul(numericConstants_1.LIQUIDATION_FEE_PRECISION)
@@ -20,6 +27,13 @@ function calculateBaseAssetAmountToCoverMarginShortage(marginShortage, marginRat
         .sub(oraclePrice.mul(new anchor_1.BN(ifLiquidationFee)).div(numericConstants_1.LIQUIDATION_FEE_PRECISION)));
 }
 exports.calculateBaseAssetAmountToCoverMarginShortage = calculateBaseAssetAmountToCoverMarginShortage;
+/**
+ * @param ifLiquidationFee Since PR#75 the program sizes liquidations against the
+ *   COMBINED insurance-fund + protocol liquidation fee budget:
+ *   `market.ifLiquidationFee + market.protocolLiquidationFee` (split IF-first
+ *   on-chain). Pass that sum here to match on-chain sizing; passing
+ *   `market.ifLiquidationFee` alone under-sizes the estimate.
+ */
 function calculateLiabilityTransferToCoverMarginShortage(marginShortage, assetWeight, assetLiquidationMultiplier, liabilityWeight, liabilityLiquidationMultiplier, liabilityDecimals, liabilityPrice, ifLiquidationFee) {
     if (assetWeight >= liabilityWeight) {
         // undefined is max

package/lib/browser/types.d.ts

@@ -464,6 +464,8 @@ export type DepositRecord = {
     depositRecordId: BN;
     explanation: DepositExplanation;
     transferUser?: PublicKey;
+    signer?: PublicKey;
+    userTokenAmountAfter: BN;
 };
 export type SpotInterestRecord = {
     ts: BN;
@@ -551,13 +553,14 @@ export type LiquidationRecord = {
     marginFreed: BN;
     liquidationId: number;
     bankrupt: boolean;
-    canceledOrderIds: BN[];
+    canceledOrderIds: number[];
     liquidatePerp: LiquidatePerpRecord;
     liquidateSpot: LiquidateSpotRecord;
     liquidateBorrowForPerpPnl: LiquidateBorrowForPerpPnlRecord;
     liquidatePerpPnlForDeposit: LiquidatePerpPnlForDepositRecord;
     perpBankruptcy: PerpBankruptcyRecord;
     spotBankruptcy: SpotBankruptcyRecord;
+    bitFlags: number;
 };
 export declare class LiquidationType {
     static readonly LIQUIDATE_PERP: {
@@ -584,11 +587,12 @@ export type LiquidatePerpRecord = {
     oraclePrice: BN;
     baseAssetAmount: BN;
     quoteAssetAmount: BN;
-    userOrderId: BN;
-    liquidatorOrderId: BN;
+    userOrderId: number;
+    liquidatorOrderId: number;
     fillRecordId: BN;
     liquidatorFee: BN;
     ifFee: BN;
+    protocolFee: BN;
 };
 export type LiquidateSpotRecord = {
     assetMarketIndex: number;
@@ -598,6 +602,7 @@ export type LiquidateSpotRecord = {
     liabilityPrice: BN;
     liabilityTransfer: BN;
     ifFee: BN;
+    protocolFee: BN;
 };
 export type LiquidateBorrowForPerpPnlRecord = {
     perpMarketIndex: number;
@@ -691,6 +696,9 @@ export type OrderActionRecord = {
     takerExistingBaseAssetAmount: BN | null;
     makerExistingQuoteEntryAmount: BN | null;
     makerExistingBaseAssetAmount: BN | null;
+    triggerPrice: BN | null;
+    builderIdx: number | null;
+    builderFee: BN | null;
 };
 export type SwapRecord = {
     ts: BN;
@@ -733,8 +741,6 @@ export type LPSwapRecord = {
     inConstituentIndex: number;
     outOraclePrice: BN;
     inOraclePrice: BN;
-    outMint: PublicKey;
-    inMint: PublicKey;
     lastAum: BN;
     lastAumSlot: BN;
     inMarketCurrentWeight: BN;
@@ -756,7 +762,6 @@ export type LPMintRedeemRecord = {
     constituentIndex: number;
     oraclePrice: BN;
     mint: PublicKey;
-    lpMint: PublicKey;
     lpAmount: BN;
     lpFee: BN;
     lpPrice: BN;
@@ -796,6 +801,7 @@ export type LPBorrowLendDepositRecord = {
 export type StateAccount = {
     coldAdmin: PublicKey;
     warmAdmin: PublicKey;
+    pauseAdmin: PublicKey;
     hotAmmCrank: PublicKey;
     hotLpCache: PublicKey;
     hotLpSwap: PublicKey;
@@ -832,6 +838,7 @@ export type StateAccount = {
     liquidationDuration: number;
     maxInitializeUserFee: number;
     featureBitFlags: number;
+    lpPoolFeatureBitFlags: number;
 };
 export type PerpMarketAccount = {
     status: MarketStatus;
@@ -873,6 +880,7 @@ export type PerpMarketAccount = {
     feeAdjustment: number;
     pausedOperations: number;
     lastFillPrice: BN;
+    poolId: number;
     hedgeConfig: {
         poolId: number;
         status: number;
@@ -961,6 +969,7 @@ export type SpotMarketAccount = {
     maxTokenDeposits: BN;
     lastInterestTs: BN;
     lastTwapTs: BN;
+    expiryTs: BN;
     initialAssetWeight: number;
     maintenanceAssetWeight: number;
     initialLiabilityWeight: number;
@@ -1019,12 +1028,21 @@ export type AMM = {
     totalMmFee: BN;
     totalFeeMinusDistributions: BN;
     totalFeeWithdrawn: BN;
+    askBaseAssetReserve: BN;
+    askQuoteAssetReserve: BN;
+    bidBaseAssetReserve: BN;
+    bidQuoteAssetReserve: BN;
     lastUpdateSlot: BN;
     netRevenueSinceLastFunding: BN;
     lastCumulativeFundingRateLong: BN;
     lastCumulativeFundingRateShort: BN;
+    lastOracleReservePriceSpreadPct: BN;
+    lastSpreadUpdateSlot: BN;
     baseSpread: number;
     maxSpread: number;
+    longSpread: number;
+    shortSpread: number;
+    referencePriceOffset: number;
     maxFillReserveFraction: number;
     maxSlippageRatio: number;
     curveUpdateIntensity: number;
@@ -1093,6 +1111,8 @@ export type UserStatsAccount = {
     };
     referrer: PublicKey;
     referrerStatus: number;
+    disableUpdatePerpBidAskTwap: number;
+    pausedOperations: number;
     authority: PublicKey;
     ifStakedQuoteAssetAmount: BN;
     delegatePermissions: number;
@@ -1375,8 +1395,8 @@ export type FeeTier = {
     refereeFeeDenominator: number;
 };
 export type OrderFillerRewardStructure = {
-    rewardNumerator: BN;
-    rewardDenominator: BN;
+    rewardNumerator: number;
+    rewardDenominator: number;
     timeBasedRewardLowerBound: BN;
 };
 export type OracleGuardRails = {
@@ -1409,6 +1429,22 @@ export type PrelaunchOracle = {
     lastUpdateSlot: BN;
     perpMarketIndex: number;
 };
+export type PrelaunchOracleParams = {
+    perpMarketIndex: number;
+    price: BN | null;
+    maxPrice: BN | null;
+};
+export type PythLazerOracle = {
+    price: BN;
+    publishTime: BN;
+    postedSlot: BN;
+    exponent: number;
+    conf: BN;
+};
+export type UpdatePerpMarketSummaryStatsParams = {
+    netUnsettledFundingPnl: BN | null;
+    updateAmmSummaryStats: boolean | null;
+};
 export type MarginCategory = 'Initial' | 'Maintenance';
 export type InsuranceFundStake = {
     costBasis: BN;
@@ -1416,6 +1452,7 @@ export type InsuranceFundStake = {
     authority: PublicKey;
     ifShares: BN;
     ifBase: BN;
+    lastValidTs: BN;
     lastWithdrawRequestShares: BN;
     lastWithdrawRequestValue: BN;
     lastWithdrawRequestTs: BN;
@@ -1489,6 +1526,9 @@ export type SignedMsgUserOrdersAccount = {
     authorityPubkey: PublicKey;
     signedMsgOrderData: SignedMsgOrderId[];
 };
+export type SignedMsgWsDelegatesAccount = {
+    delegates: PublicKey[];
+};
 export type RevenueShareAccount = {
     authority: PublicKey;
     totalReferrerRewards: BN;
@@ -1519,8 +1559,23 @@ export type BuilderInfo = {
     maxFeeTenthBps: number;
     padding: number[];
 };
+export type PerpMarketFeeSweepRecord = {
+    ts: BN;
+    marketIndex: number;
+    ifSwept: BN;
+    protocolSwept: BN;
+    ammProvisionTokenized: BN;
+};
+export type ProtocolFeeWithdrawRecord = {
+    ts: BN;
+    marketIndex: number;
+    isPerp: boolean;
+    spotMarketIndex: number;
+    amount: BN;
+    recipientTokenAccount: PublicKey;
+};
 export type RevenueShareSettleRecord = {
-    ts: number;
+    ts: BN;
     builder: PublicKey | null;
     referrer: PublicKey | null;
     feeSettled: BN;
@@ -1583,6 +1638,8 @@ export type LPPoolAccount = {
     bump: number;
     gammaExecution: number;
     xi: number;
+    targetOracleDelayFeeBpsPer10Slots: number;
+    targetPositionDelayFeeBpsPer10Slots: number;
 };
 export type ConstituentSpotBalance = {
     scaledBalance: BN;
@@ -1675,6 +1732,7 @@ export type CacheInfo = {
     marketIndex: number;
 };
 export type AmmCache = {
+    bump: number;
     cache: CacheInfo[];
 };
 export type AccountLiquidatableStatus = {
@@ -1690,4 +1748,12 @@ export declare class TransferFeeAndPnlPoolDirection {
         pnlToFeePool: {};
     };
 }
+export type TransferFeeAndPnlPoolRecord = {
+    ts: BN;
+    slot: BN;
+    perpMarketIndexWithFeePool: number;
+    perpMarketIndexWithPnlPool: number;
+    direction: TransferFeeAndPnlPoolDirection;
+    amount: BN;
+};
 export {};

package/lib/browser/user.d.ts

@@ -44,19 +44,35 @@ export declare class User {
      */
     fetchAccounts(): Promise<void>;
     unsubscribe(): Promise<void>;
+    /**
+     * Returns the cached user account.
+     *
+     * - **Throws** `NotSubscribedError` if the subscriber has not been subscribed
+     *   yet — reading the account before {@link subscribe} resolves is a
+     *   programming error, not a missing-account condition.
+     * - Returns `undefined` when subscribed but no account was found on chain.
+     *   Because `subscribe()` awaits the initial fetch, an `undefined` here means
+     *   the account does not exist (or has not yet been observed), not that data
+     *   is "still loading".
+     */
     getUserAccount(): UserAccount | undefined;
     /**
-     * Like {@link getUserAccount} but throws a named error instead of returning
-     * `undefined` when the account has not been loaded yet. Use at call sites
-     * that structurally require a loaded account.
+     * Like {@link getUserAccount} but throws instead of returning `undefined`
+     * when the account was not found. Use at call sites that structurally
+     * require the account to exist. (Still propagates `NotSubscribedError` when
+     * called before subscribing.)
+     *
+     * Delegates to {@link getUserAccount} (rather than the subscriber directly)
+     * so callers that override `getUserAccount` see the override here too.
      */
     getUserAccountOrThrow(): UserAccount;
     forceGetUserAccount(): Promise<UserAccount | undefined>;
     getUserAccountAndSlot(): DataAndSlot<UserAccount> | undefined;
     /**
-     * Like {@link getUserAccountAndSlot} but throws a named error instead of
-     * returning `undefined` when the account has not been loaded yet. Use at
-     * call sites that structurally require a loaded account.
+     * Like {@link getUserAccountAndSlot} but throws instead of returning
+     * `undefined` when the account was not found. Use at call sites that
+     * structurally require the account to exist. (Still propagates
+     * `NotSubscribedError` when called before subscribing.)
      */
     getUserAccountAndSlotOrThrow(): DataAndSlot<UserAccount>;
     getPerpPositionForUserAccount(userAccount: UserAccount, marketIndex: number): PerpPosition | undefined;

package/lib/browser/user.js

@@ -92,19 +92,34 @@ class User {
         await this.accountSubscriber.unsubscribe();
         this.isSubscribed = false;
     }
+    /**
+     * Returns the cached user account.
+     *
+     * - **Throws** `NotSubscribedError` if the subscriber has not been subscribed
+     *   yet — reading the account before {@link subscribe} resolves is a
+     *   programming error, not a missing-account condition.
+     * - Returns `undefined` when subscribed but no account was found on chain.
+     *   Because `subscribe()` awaits the initial fetch, an `undefined` here means
+     *   the account does not exist (or has not yet been observed), not that data
+     *   is "still loading".
+     */
     getUserAccount() {
         var _a;
         return (_a = this.accountSubscriber.getUserAccountAndSlot()) === null || _a === void 0 ? void 0 : _a.data;
     }
     /**
-     * Like {@link getUserAccount} but throws a named error instead of returning
-     * `undefined` when the account has not been loaded yet. Use at call sites
-     * that structurally require a loaded account.
+     * Like {@link getUserAccount} but throws instead of returning `undefined`
+     * when the account was not found. Use at call sites that structurally
+     * require the account to exist. (Still propagates `NotSubscribedError` when
+     * called before subscribing.)
+     *
+     * Delegates to {@link getUserAccount} (rather than the subscriber directly)
+     * so callers that override `getUserAccount` see the override here too.
      */
     getUserAccountOrThrow() {
         const userAccount = this.getUserAccount();
         if (!userAccount) {
-            throw new Error(`User account not loaded: ${this.getUserAccountPublicKey().toString()}`);
+            throw new Error(`User account not found: ${this.getUserAccountPublicKey().toString()}`);
         }
         return userAccount;
     }
@@ -117,12 +132,13 @@ class User {
         return this.accountSubscriber.getUserAccountAndSlot();
     }
     /**
-     * Like {@link getUserAccountAndSlot} but throws a named error instead of
-     * returning `undefined` when the account has not been loaded yet. Use at
-     * call sites that structurally require a loaded account.
+     * Like {@link getUserAccountAndSlot} but throws instead of returning
+     * `undefined` when the account was not found. Use at call sites that
+     * structurally require the account to exist. (Still propagates
+     * `NotSubscribedError` when called before subscribing.)
      */
     getUserAccountAndSlotOrThrow() {
-        return (0, utils_1.assertDataAndSlot)(this.accountSubscriber.getUserAccountAndSlot(), `User account not loaded: ${this.getUserAccountPublicKey().toString()}`);
+        return (0, utils_1.assertDataAndSlot)(this.accountSubscriber.getUserAccountAndSlot(), `User account not found: ${this.getUserAccountPublicKey().toString()}`);
     }
     getPerpPositionForUserAccount(userAccount, marketIndex) {
         return this.getActivePerpPositionsForUserAccount(userAccount).find((position) => position.marketIndex === marketIndex);

package/lib/browser/userMap/userMap.js

@@ -13,7 +13,11 @@ const PollingSubscription_1 = require("./PollingSubscription");
 const user_2 = require("../decode/user");
 const grpcSubscription_1 = require("./grpcSubscription");
 const events_1 = require("events");
-const MAX_USER_ACCOUNT_SIZE_BYTES = 4376;
+// Velocity's User account is 4496 bytes (8-byte discriminator + 4488 struct);
+// drift's was 4376. This caps the zstd-decompressed buffer in defaultSync — if it's
+// smaller than the real account, the buffer is truncated and decodeUser reads past
+// the end (RangeError: ERR_BUFFER_OUT_OF_BOUNDS). Must be >= the on-chain User size.
+const MAX_USER_ACCOUNT_SIZE_BYTES = 4496;
 class UserMap {
     /**
      * Constructs a new UserMap instance.

package/lib/browser/velocityClient.d.ts

@@ -199,8 +199,6 @@ export declare class VelocityClient {
     getInitializeRevenueShareEscrowIx(authority: PublicKey, numOrders: number, overrides?: {
         payer?: PublicKey;
     }): Promise<TransactionInstruction>;
-    migrateReferrer(authority: PublicKey, txParams?: TxParams): Promise<TransactionSignature>;
-    getMigrateReferrerIx(authority: PublicKey): Promise<TransactionInstruction>;
     resizeRevenueShareEscrowOrders(authority: PublicKey, numOrders: number, txParams?: TxParams): Promise<TransactionSignature>;
     getResizeRevenueShareEscrowOrdersIx(authority: PublicKey, numOrders: number): Promise<TransactionInstruction>;
     /**

package/lib/browser/velocityClient.js

@@ -728,24 +728,6 @@ class VelocityClient {
             },
         });
     }
-    async migrateReferrer(authority, txParams) {
-        const ix = await this.getMigrateReferrerIx(authority);
-        const tx = await this.buildTransaction([ix], txParams);
-        const { txSig } = await this.sendTransaction(tx, [], this.opts);
-        return txSig;
-    }
-    async getMigrateReferrerIx(authority) {
-        const escrow = (0, pda_1.getRevenueShareEscrowAccountPublicKey)(this.program.programId, authority);
-        return this.program.instruction.migrateReferrer({
-            accounts: {
-                escrow,
-                authority,
-                userStats: (0, pda_1.getUserStatsAccountPublicKey)(this.program.programId, authority),
-                state: await this.getStatePublicKey(),
-                payer: this.wallet.publicKey,
-            },
-        });
-    }
     async resizeRevenueShareEscrowOrders(authority, numOrders, txParams) {
         const ix = await this.getResizeRevenueShareEscrowOrdersIx(authority, numOrders);
         const tx = await this.buildTransaction([ix], txParams);

package/lib/node/accounts/grpcMultiAccountSubscriber.d.ts

@@ -34,6 +34,5 @@ export declare class grpcMultiAccountSubscriber<T, U = undefined> {
     removeAccounts(accounts: PublicKey[]): Promise<void>;
     unsubscribe(): Promise<void>;
     private setTimeout;
-    private capitalize;
 }
 //# sourceMappingURL=grpcMultiAccountSubscriber.d.ts.map

package/lib/node/accounts/grpcMultiAccountSubscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grpcMultiAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/grpcMultiAccountSubscriber.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAc,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAI5C,OAAO,EACN,MAAM,EAMN,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAiB,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAyB7E,qBAAa,0BAA0B,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAqB;IACrC,OAAO,KAAK,MAAM,GAOjB;IACD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAC,CAIhB;IACP,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAsB;IAErC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,UAAS;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAgC;IAClD,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,WAAW,CAQf;IAEJ,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,SAAS,CAAoC;IAErD,OAAO;WAsBa,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,EAC1C,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,EACvE,SAAS,CAAC,EAAE,SAAS,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACnC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAwB5C,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAInE,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAIjE,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAI1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoEtB,SAAS,CACd,QAAQ,EAAE,SAAS,EAAE,EACrB,QAAQ,EAAE,CACT,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,GAAG,SAAS,KACvB,IAAI,GACP,OAAO,CAAC,IAAI,CAAC;IAsIV,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCjD,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCpD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA4ClC,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,UAAU;CAIlB"}
+{"version":3,"file":"grpcMultiAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/grpcMultiAccountSubscriber.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAc,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAI5C,OAAO,EACN,MAAM,EAMN,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAiB,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAyB7E,qBAAa,0BAA0B,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAqB;IACrC,OAAO,KAAK,MAAM,GAOjB;IACD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAC,CAIhB;IACP,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAsB;IAErC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,UAAS;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAgC;IAClD,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,WAAW,CAQf;IAEJ,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,SAAS,CAAoC;IAErD,OAAO;WAsBa,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,EAC1C,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,EACvE,SAAS,CAAC,EAAE,SAAS,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACnC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAwB5C,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAInE,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAIjE,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAI1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoEtB,SAAS,CACd,QAAQ,EAAE,SAAS,EAAE,EACrB,QAAQ,EAAE,CACT,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,GAAG,SAAS,KACvB,IAAI,GACP,OAAO,CAAC,IAAI,CAAC;IAmIV,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCjD,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCpD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA4ClC,OAAO,CAAC,UAAU;CAclB"}