@velocity-exchange/sdk 0.2.5 → 0.4.0

package/lib/node/oracles/oracleId.js

@@ -3,6 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPublicKeyAndSourceFromOracleId = exports.getOracleId = exports.getOracleSourceFromNum = exports.getOracleSourceNum = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const types_1 = require("../types");
+/**
+ * Maps an `OracleSource` enum-object (e.g. `{ pyth: {} }`) to its stable numeric encoding
+ * (`OracleSourceNum`) used as part of an oracle id string. This encoding is SDK-internal — it
+ * is not the on-chain Borsh discriminant (see `OracleSourceNum`).
+ * @param source - The oracle source variant.
+ * @returns The corresponding `OracleSourceNum` value.
+ * @throws Error if `source` doesn't match any known variant.
+ */
 function getOracleSourceNum(source) {
     if ('pyth' in source)
         return types_1.OracleSourceNum.PYTH;
@@ -16,8 +24,8 @@ function getOracleSourceNum(source) {
         return types_1.OracleSourceNum.PYTH_1K_PULL;
     if ('pyth1MPull' in source)
         return types_1.OracleSourceNum.PYTH_1M_PULL;
-    if ('switchboard' in source)
-        return types_1.OracleSourceNum.SWITCHBOARD;
+    if ('deprecatedSwitchboard' in source)
+        return types_1.OracleSourceNum.DEPRECATED_SWITCHBOARD;
     if ('quoteAsset' in source)
         return types_1.OracleSourceNum.QUOTE_ASSET;
     if ('pythStableCoin' in source)
@@ -26,8 +34,8 @@ function getOracleSourceNum(source) {
         return types_1.OracleSourceNum.PYTH_STABLE_COIN_PULL;
     if ('prelaunch' in source)
         return types_1.OracleSourceNum.PRELAUNCH;
-    if ('switchboardOnDemand' in source)
-        return types_1.OracleSourceNum.SWITCHBOARD_ON_DEMAND;
+    if ('deprecatedSwitchboardOnDemand' in source)
+        return types_1.OracleSourceNum.DEPRECATED_SWITCHBOARD_ON_DEMAND;
     if ('pythLazer' in source)
         return types_1.OracleSourceNum.PYTH_LAZER;
     if ('pythLazer1K' in source)
@@ -39,6 +47,13 @@ function getOracleSourceNum(source) {
     throw new Error('Invalid oracle source');
 }
 exports.getOracleSourceNum = getOracleSourceNum;
+/**
+ * Inverse of `getOracleSourceNum`: maps a numeric `OracleSourceNum` back to its `OracleSource`
+ * enum-object.
+ * @param sourceNum - Numeric oracle source encoding.
+ * @returns The corresponding `OracleSource` variant.
+ * @throws Error if `sourceNum` doesn't match any known `OracleSourceNum` value.
+ */
 function getOracleSourceFromNum(sourceNum) {
     if (sourceNum === types_1.OracleSourceNum.PYTH)
         return 'pyth';
@@ -52,8 +67,8 @@ function getOracleSourceFromNum(sourceNum) {
         return 'pyth1KPull';
     if (sourceNum === types_1.OracleSourceNum.PYTH_1M_PULL)
         return 'pyth1MPull';
-    if (sourceNum === types_1.OracleSourceNum.SWITCHBOARD)
-        return 'switchboard';
+    if (sourceNum === types_1.OracleSourceNum.DEPRECATED_SWITCHBOARD)
+        return 'deprecatedSwitchboard';
     if (sourceNum === types_1.OracleSourceNum.QUOTE_ASSET)
         return 'quoteAsset';
     if (sourceNum === types_1.OracleSourceNum.PYTH_STABLE_COIN)
@@ -62,8 +77,8 @@ function getOracleSourceFromNum(sourceNum) {
         return 'pythStableCoinPull';
     if (sourceNum === types_1.OracleSourceNum.PRELAUNCH)
         return 'prelaunch';
-    if (sourceNum === types_1.OracleSourceNum.SWITCHBOARD_ON_DEMAND)
-        return 'switchboardOnDemand';
+    if (sourceNum === types_1.OracleSourceNum.DEPRECATED_SWITCHBOARD_ON_DEMAND)
+        return 'deprecatedSwitchboardOnDemand';
     if (sourceNum === types_1.OracleSourceNum.PYTH_LAZER)
         return 'pythLazer';
     if (sourceNum === types_1.OracleSourceNum.PYTH_LAZER_1K)
@@ -75,10 +90,26 @@ function getOracleSourceFromNum(sourceNum) {
     throw new Error('Invalid oracle source');
 }
 exports.getOracleSourceFromNum = getOracleSourceFromNum;
+/**
+ * Builds a stable string id for an oracle account, uniquely identifying it by both its address
+ * and the source/decoding scheme to use — the same pubkey can be interpreted under different
+ * `OracleSource`s (e.g. `pyth` vs `pyth1K`) with different results, so the pubkey alone is not a
+ * safe cache/map key.
+ * @param publicKey - The oracle account's address.
+ * @param source - The oracle source variant to decode it as.
+ * @returns A string of the form `"<base58 pubkey>-<OracleSourceNum>"`.
+ */
 function getOracleId(publicKey, source) {
     return `${publicKey.toBase58()}-${getOracleSourceNum(source)}`;
 }
 exports.getOracleId = getOracleId;
+/**
+ * Inverse of `getOracleId`: parses an oracle id string back into its pubkey and `OracleSource`.
+ * @param oracleId - An id string previously produced by `getOracleId`.
+ * @returns The decoded `publicKey` and `source`.
+ * @throws Error if the encoded source number doesn't match any known `OracleSourceNum` value, or
+ * `PublicKey` construction fails on a malformed id.
+ */
 function getPublicKeyAndSourceFromOracleId(oracleId) {
     const [publicKey, source] = oracleId.split('-');
     return {

package/lib/node/oracles/prelaunchOracleClient.d.ts

@@ -3,11 +3,31 @@
 import { Connection, PublicKey } from '@solana/web3.js';
 import { OracleClient, OraclePriceData } from './types';
 import { VelocityProgram } from '../config';
+/**
+ * `OracleClient` for the `PrelaunchOracle` account type — a synthetic, program-managed "oracle"
+ * used for perp markets that have not yet listed on a real price feed. Its price is admin/keeper
+ * set (via `updatePrelaunchOracleParams`) rather than fed by an external network.
+ */
 export declare class PrelaunchOracleClient implements OracleClient {
     private connection;
     private program;
     constructor(connection: Connection, program: VelocityProgram);
+    /**
+     * Fetches and decodes a `PrelaunchOracle` account's current price data.
+     * @param pricePublicKey - The `PrelaunchOracle` account's address (see `getPrelaunchOraclePublicKey`).
+     * @returns The decoded price data.
+     * @throws Error if the account does not exist.
+     */
     getOraclePriceData(pricePublicKey: PublicKey): Promise<OraclePriceData>;
+    /**
+     * Decodes raw `PrelaunchOracle` account bytes into normalized `OraclePriceData`. Note `slot` is
+     * populated from `ammLastUpdateSlot` (the last time the paired AMM used this price), not a
+     * slot recorded by the oracle account itself, and `hasSufficientNumberOfDataPoints` is always
+     * `true` since there is no publisher-count concept for this source.
+     * @param buffer - Raw `PrelaunchOracle` account data.
+     * @returns Price (`price`), confidence (`confidence`, both PRICE_PRECISION 1e6), and the
+     * prelaunch-only upper bound (`maxPrice`, PRICE_PRECISION 1e6).
+     */
     getOraclePriceDataFromBuffer(buffer: Buffer): OraclePriceData;
 }
 //# sourceMappingURL=prelaunchOracleClient.d.ts.map

package/lib/node/oracles/prelaunchOracleClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prelaunchOracleClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/prelaunchOracleClient.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAI5C,qBAAa,qBAAsB,YAAW,YAAY;IACzD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAkB;gBAEd,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe;IAKtD,kBAAkB,CAC9B,cAAc,EAAE,SAAS,GACvB,OAAO,CAAC,eAAe,CAAC;IASpB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;CAgBpE"}
+{"version":3,"file":"prelaunchOracleClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/prelaunchOracleClient.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAI5C;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAkB;gBAEd,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe;IAKnE;;;;;OAKG;IACU,kBAAkB,CAC9B,cAAc,EAAE,SAAS,GACvB,OAAO,CAAC,eAAe,CAAC;IAS3B;;;;;;;;OAQG;IACI,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;CAgBpE"}

package/lib/node/oracles/prelaunchOracleClient.js

@@ -2,15 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PrelaunchOracleClient = void 0;
 const utils_1 = require("./utils");
+/**
+ * `OracleClient` for the `PrelaunchOracle` account type — a synthetic, program-managed "oracle"
+ * used for perp markets that have not yet listed on a real price feed. Its price is admin/keeper
+ * set (via `updatePrelaunchOracleParams`) rather than fed by an external network.
+ */
 class PrelaunchOracleClient {
     constructor(connection, program) {
         this.connection = connection;
         this.program = program;
     }
+    /**
+     * Fetches and decodes a `PrelaunchOracle` account's current price data.
+     * @param pricePublicKey - The `PrelaunchOracle` account's address (see `getPrelaunchOraclePublicKey`).
+     * @returns The decoded price data.
+     * @throws Error if the account does not exist.
+     */
     async getOraclePriceData(pricePublicKey) {
         const data = await (0, utils_1.getOracleAccountDataOrThrow)(this.connection, pricePublicKey, 'Prelaunch oracle');
         return this.getOraclePriceDataFromBuffer(data);
     }
+    /**
+     * Decodes raw `PrelaunchOracle` account bytes into normalized `OraclePriceData`. Note `slot` is
+     * populated from `ammLastUpdateSlot` (the last time the paired AMM used this price), not a
+     * slot recorded by the oracle account itself, and `hasSufficientNumberOfDataPoints` is always
+     * `true` since there is no publisher-count concept for this source.
+     * @param buffer - Raw `PrelaunchOracle` account data.
+     * @returns Price (`price`), confidence (`confidence`, both PRICE_PRECISION 1e6), and the
+     * prelaunch-only upper bound (`maxPrice`, PRICE_PRECISION 1e6).
+     */
     getOraclePriceDataFromBuffer(buffer) {
         const prelaunchOracle = this.program.account.prelaunchOracle.coder.accounts.decodeUnchecked('prelaunchOracle', buffer);
         return {

package/lib/node/oracles/pythClient.d.ts

@@ -3,12 +3,43 @@
 import { Connection, PublicKey } from '@solana/web3.js';
 import { OracleClient, OraclePriceData } from './types';
 import { BN } from '../isomorphic/anchor';
+/**
+ * `OracleClient` for legacy (push-model) Pyth price accounts, decoded via `@pythnetwork/client`'s
+ * `parsePriceData`. Backs the `pyth`, `pyth1K`, `pyth1M`, and `pythStableCoin` `OracleSource`
+ * variants — the `pythPull`/`pyth1KPull`/`pyth1MPull`/`pythStableCoinPull` (Pyth pull-oracle)
+ * variants have been removed from the SDK and throw in `getOracleClient`.
+ */
 export declare class PythClient implements OracleClient {
     private connection;
     private multiple;
     private stableCoin;
+    /**
+     * @param connection - RPC connection used to fetch oracle account data.
+     * @param multiple - Divisor applied to the raw Pyth precision before rescaling to
+     * PRICE_PRECISION; pass `1000`/`1000000` for the `pyth1K`/`pyth1M` source variants (feeds
+     * quoted per 1,000 / 1,000,000 units of the underlying), or the default `ONE` (1) for a
+     * standard per-unit feed.
+     * @param stableCoin - When `true` (the `pythStableCoin` variant), snaps the decoded price to
+     * exactly `QUOTE_PRECISION` (1.0) whenever it is within 5bps (or within `confidence` if
+     * tighter) of peg — see `getStableCoinPrice`.
+     */
     constructor(connection: Connection, multiple?: BN, stableCoin?: boolean);
+    /**
+     * Fetches and decodes a Pyth price account's current price data.
+     * @param pricePublicKey - The Pyth price account's address.
+     * @returns The decoded, normalized price data.
+     * @throws Error if the account does not exist.
+     */
     getOraclePriceData(pricePublicKey: PublicKey): Promise<OraclePriceData>;
+    /**
+     * Decodes raw Pyth price account bytes into normalized `OraclePriceData`, rescaling from
+     * Pyth's native exponent to PRICE_PRECISION (1e6) via `convertPythPrice`. `confidence` defaults
+     * to 0 if the account has no confidence field (e.g. uninitialized), and `hasSufficientNumberOfDataPoints`
+     * is `true` only when the number of active quoters is at least `min(numComponentPrices, 3)`.
+     * @param buffer - Raw Pyth price account data.
+     * @returns `price`, `confidence`, `twap`, `twapConfidence` (all PRICE_PRECISION 1e6), `slot`
+     * (the price account's last update slot), and `hasSufficientNumberOfDataPoints`.
+     */
     getOraclePriceDataFromBuffer(buffer: Buffer): OraclePriceData;
 }
 //# sourceMappingURL=pythClient.d.ts.map

package/lib/node/oracles/pythClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pythClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/pythClient.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAS1C,qBAAa,UAAW,YAAW,YAAY;IAC9C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAU;gBAG3B,UAAU,EAAE,UAAU,EACtB,QAAQ,KAAM,EACd,UAAU,UAAQ;IAON,kBAAkB,CAC9B,cAAc,EAAE,SAAS,GACvB,OAAO,CAAC,eAAe,CAAC;IASpB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;CAsCpE"}
+{"version":3,"file":"pythClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/pythClient.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAS1C;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,YAAY;IAC9C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAU;IAE5B;;;;;;;;;OASG;gBAEF,UAAU,EAAE,UAAU,EACtB,QAAQ,KAAM,EACd,UAAU,UAAQ;IAOnB;;;;;OAKG;IACU,kBAAkB,CAC9B,cAAc,EAAE,SAAS,GACvB,OAAO,CAAC,eAAe,CAAC;IAS3B;;;;;;;;OAQG;IACI,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;CAsCpE"}

package/lib/node/oracles/pythClient.js

@@ -5,16 +5,47 @@ const client_1 = require("@pythnetwork/client");
 const anchor_1 = require("../isomorphic/anchor");
 const numericConstants_1 = require("../constants/numericConstants");
 const utils_1 = require("./utils");
+/**
+ * `OracleClient` for legacy (push-model) Pyth price accounts, decoded via `@pythnetwork/client`'s
+ * `parsePriceData`. Backs the `pyth`, `pyth1K`, `pyth1M`, and `pythStableCoin` `OracleSource`
+ * variants — the `pythPull`/`pyth1KPull`/`pyth1MPull`/`pythStableCoinPull` (Pyth pull-oracle)
+ * variants have been removed from the SDK and throw in `getOracleClient`.
+ */
 class PythClient {
+    /**
+     * @param connection - RPC connection used to fetch oracle account data.
+     * @param multiple - Divisor applied to the raw Pyth precision before rescaling to
+     * PRICE_PRECISION; pass `1000`/`1000000` for the `pyth1K`/`pyth1M` source variants (feeds
+     * quoted per 1,000 / 1,000,000 units of the underlying), or the default `ONE` (1) for a
+     * standard per-unit feed.
+     * @param stableCoin - When `true` (the `pythStableCoin` variant), snaps the decoded price to
+     * exactly `QUOTE_PRECISION` (1.0) whenever it is within 5bps (or within `confidence` if
+     * tighter) of peg — see `getStableCoinPrice`.
+     */
     constructor(connection, multiple = numericConstants_1.ONE, stableCoin = false) {
         this.connection = connection;
         this.multiple = multiple;
         this.stableCoin = stableCoin;
     }
+    /**
+     * Fetches and decodes a Pyth price account's current price data.
+     * @param pricePublicKey - The Pyth price account's address.
+     * @returns The decoded, normalized price data.
+     * @throws Error if the account does not exist.
+     */
     async getOraclePriceData(pricePublicKey) {
         const data = await (0, utils_1.getOracleAccountDataOrThrow)(this.connection, pricePublicKey, 'Pyth oracle');
         return this.getOraclePriceDataFromBuffer(data);
     }
+    /**
+     * Decodes raw Pyth price account bytes into normalized `OraclePriceData`, rescaling from
+     * Pyth's native exponent to PRICE_PRECISION (1e6) via `convertPythPrice`. `confidence` defaults
+     * to 0 if the account has no confidence field (e.g. uninitialized), and `hasSufficientNumberOfDataPoints`
+     * is `true` only when the number of active quoters is at least `min(numComponentPrices, 3)`.
+     * @param buffer - Raw Pyth price account data.
+     * @returns `price`, `confidence`, `twap`, `twapConfidence` (all PRICE_PRECISION 1e6), `slot`
+     * (the price account's last update slot), and `hasSufficientNumberOfDataPoints`.
+     */
     getOraclePriceDataFromBuffer(buffer) {
         var _a;
         const priceData = (0, client_1.parsePriceData)(buffer);
@@ -48,7 +79,7 @@ function convertPythPrice(price, exponent, multiple) {
 }
 const fiveBPS = new anchor_1.BN(500);
 function getStableCoinPrice(price, confidence) {
-    if (price.sub(numericConstants_1.QUOTE_PRECISION).abs().lt(anchor_1.BN.min(confidence, fiveBPS))) {
+    if (price.sub(numericConstants_1.QUOTE_PRECISION).abs().lte(anchor_1.BN.min(confidence, fiveBPS))) {
         return numericConstants_1.QUOTE_PRECISION;
     }
     else {

package/lib/node/oracles/pythLazerClient.d.ts

@@ -3,14 +3,48 @@
 import { Connection, PublicKey } from '@solana/web3.js';
 import { OracleClient, OraclePriceData } from './types';
 import { BN } from '../isomorphic/anchor';
+/**
+ * `OracleClient` for `PythLazerOracle` accounts — Velocity's on-chain cache of a Pyth Lazer
+ * push-update feed, decoded via the velocity program's own Anchor coder (Lazer has no dedicated
+ * client account layout package, unlike legacy Pyth). Backs the `pythLazer`, `pythLazer1K`,
+ * `pythLazer1M`, and `pythLazerStableCoin` `OracleSource` variants.
+ */
 export declare class PythLazerClient implements OracleClient {
     private connection;
     private multiple;
     private stableCoin;
     private program;
     readonly decodeFunc: (name: string, data: Buffer) => any;
+    /**
+     * @param connection - RPC connection used to fetch oracle account data; also used to spin up a
+     * throwaway `AnchorProvider`/`Program` (with a fresh random keypair, never used to sign) purely
+     * to get access to the IDL's `pythLazerOracle` account coder.
+     * @param multiple - Divisor applied to the raw Lazer precision before rescaling to
+     * PRICE_PRECISION; pass `1000`/`1000000` for the `pythLazer1K`/`pythLazer1M` source variants, or
+     * the default `ONE` (1) for a standard per-unit feed.
+     * @param stableCoin - When `true` (the `pythLazerStableCoin` variant), snaps the decoded price
+     * to exactly `QUOTE_PRECISION` (1.0) whenever it is within 5bps (or within `confidence` if
+     * tighter) of peg — see `getStableCoinPrice`.
+     */
     constructor(connection: Connection, multiple?: BN, stableCoin?: boolean);
+    /**
+     * Fetches and decodes a `PythLazerOracle` account's current price data.
+     * @param pricePublicKey - The `PythLazerOracle` account's address (see `getPythLazerOraclePublicKey`).
+     * @returns The decoded, normalized price data.
+     * @throws Error if the account does not exist.
+     */
     getOraclePriceData(pricePublicKey: PublicKey): Promise<OraclePriceData>;
+    /**
+     * Decodes raw `PythLazerOracle` account bytes into normalized `OraclePriceData`, rescaling from
+     * the feed's native exponent to PRICE_PRECISION (1e6) via `convertPythPrice`. Unlike legacy
+     * Pyth, Lazer has no separate TWAP field on-chain, so `twap`/`twapConfidence` are both set to
+     * the same converted live `price`/`conf` rather than a genuine time-weighted average.
+     * `hasSufficientNumberOfDataPoints` is always `true` (no publisher-count concept for this
+     * source), and `sequenceId` is set to the feed's `publishTime` for staleness/ordering checks.
+     * @param buffer - Raw `PythLazerOracle` account data.
+     * @returns `price`, `confidence`, `twap`, `twapConfidence` (all PRICE_PRECISION 1e6), `slot`
+     * (`postedSlot`, the slot the update landed on-chain), and `sequenceId` (`publishTime`).
+     */
     getOraclePriceDataFromBuffer(buffer: Buffer): OraclePriceData;
 }
 //# sourceMappingURL=pythLazerClient.d.ts.map

package/lib/node/oracles/pythLazerClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pythLazerClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/pythLazerClient.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAW,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAkB,EAAE,EAAW,MAAM,sBAAsB,CAAC;AAanE,qBAAa,eAAgB,YAAW,YAAY;IACnD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,OAAO,CAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;gBAGxD,UAAU,EAAE,UAAU,EACtB,QAAQ,KAAM,EACd,UAAU,UAAQ;IAqBN,kBAAkB,CAC9B,cAAc,EAAE,SAAS,GACvB,OAAO,CAAC,eAAe,CAAC;IASpB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;CAkCpE"}
+{"version":3,"file":"pythLazerClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/pythLazerClient.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,UAAU,EAAW,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAkB,EAAE,EAAW,MAAM,sBAAsB,CAAC;AAanE;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,YAAY;IACnD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,OAAO,CAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;IAEzD;;;;;;;;;;OAUG;gBAEF,UAAU,EAAE,UAAU,EACtB,QAAQ,KAAM,EACd,UAAU,UAAQ;IAqBnB;;;;;OAKG;IACU,kBAAkB,CAC9B,cAAc,EAAE,SAAS,GACvB,OAAO,CAAC,eAAe,CAAC;IAS3B;;;;;;;;;;OAUG;IACI,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;CAkCpE"}

package/lib/node/oracles/pythLazerClient.js

@@ -10,7 +10,24 @@ const numericConstants_1 = require("../constants/numericConstants");
 const wallet_1 = require("../wallet");
 const velocity_json_1 = __importDefault(require("../idl/velocity.json"));
 const utils_1 = require("./utils");
+/**
+ * `OracleClient` for `PythLazerOracle` accounts — Velocity's on-chain cache of a Pyth Lazer
+ * push-update feed, decoded via the velocity program's own Anchor coder (Lazer has no dedicated
+ * client account layout package, unlike legacy Pyth). Backs the `pythLazer`, `pythLazer1K`,
+ * `pythLazer1M`, and `pythLazerStableCoin` `OracleSource` variants.
+ */
 class PythLazerClient {
+    /**
+     * @param connection - RPC connection used to fetch oracle account data; also used to spin up a
+     * throwaway `AnchorProvider`/`Program` (with a fresh random keypair, never used to sign) purely
+     * to get access to the IDL's `pythLazerOracle` account coder.
+     * @param multiple - Divisor applied to the raw Lazer precision before rescaling to
+     * PRICE_PRECISION; pass `1000`/`1000000` for the `pythLazer1K`/`pythLazer1M` source variants, or
+     * the default `ONE` (1) for a standard per-unit feed.
+     * @param stableCoin - When `true` (the `pythLazerStableCoin` variant), snaps the decoded price
+     * to exactly `QUOTE_PRECISION` (1.0) whenever it is within 5bps (or within `confidence` if
+     * tighter) of peg — see `getStableCoinPrice`.
+     */
     constructor(connection, multiple = numericConstants_1.ONE, stableCoin = false) {
         this.connection = connection;
         this.multiple = multiple;
@@ -23,10 +40,27 @@ class PythLazerClient {
         this.program = new anchor_1.Program(velocity_json_1.default, provider);
         this.decodeFunc = this.program.account.pythLazerOracle.coder.accounts.decodeUnchecked.bind(this.program.account.pythLazerOracle.coder.accounts);
     }
+    /**
+     * Fetches and decodes a `PythLazerOracle` account's current price data.
+     * @param pricePublicKey - The `PythLazerOracle` account's address (see `getPythLazerOraclePublicKey`).
+     * @returns The decoded, normalized price data.
+     * @throws Error if the account does not exist.
+     */
     async getOraclePriceData(pricePublicKey) {
         const data = await (0, utils_1.getOracleAccountDataOrThrow)(this.connection, pricePublicKey, 'Pyth lazer oracle');
         return this.getOraclePriceDataFromBuffer(data);
     }
+    /**
+     * Decodes raw `PythLazerOracle` account bytes into normalized `OraclePriceData`, rescaling from
+     * the feed's native exponent to PRICE_PRECISION (1e6) via `convertPythPrice`. Unlike legacy
+     * Pyth, Lazer has no separate TWAP field on-chain, so `twap`/`twapConfidence` are both set to
+     * the same converted live `price`/`conf` rather than a genuine time-weighted average.
+     * `hasSufficientNumberOfDataPoints` is always `true` (no publisher-count concept for this
+     * source), and `sequenceId` is set to the feed's `publishTime` for staleness/ordering checks.
+     * @param buffer - Raw `PythLazerOracle` account data.
+     * @returns `price`, `confidence`, `twap`, `twapConfidence` (all PRICE_PRECISION 1e6), `slot`
+     * (`postedSlot`, the slot the update landed on-chain), and `sequenceId` (`publishTime`).
+     */
     getOraclePriceDataFromBuffer(buffer) {
         const priceData = this.decodeFunc('pythLazerOracle', buffer);
         const confidence = convertPythPrice(priceData.conf, priceData.exponent, this.multiple);
@@ -53,7 +87,7 @@ function convertPythPrice(price, exponent, multiple) {
 }
 const fiveBPS = new anchor_1.BN(500);
 function getStableCoinPrice(price, confidence) {
-    if (price.sub(numericConstants_1.QUOTE_PRECISION).abs().lt(anchor_1.BN.min(confidence, fiveBPS))) {
+    if (price.sub(numericConstants_1.QUOTE_PRECISION).abs().lte(anchor_1.BN.min(confidence, fiveBPS))) {
         return numericConstants_1.QUOTE_PRECISION;
     }
     else {

package/lib/node/oracles/quoteAssetOracleClient.d.ts

@@ -2,10 +2,28 @@
 /// <reference types="node" />
 import { PublicKey } from '@solana/web3.js';
 import { OracleClient, OraclePriceData } from './types';
+/**
+ * Fixed price of exactly 1.0 (PRICE_PRECISION, 1e6) with a minimal confidence band, returned by
+ * `QuoteAssetOracleClient` for any oracle lookup. Represents the quote asset (e.g. USDC) pegged
+ * 1:1 to itself with no real oracle needed.
+ */
 export declare const QUOTE_ORACLE_PRICE_DATA: OraclePriceData;
+/**
+ * `OracleClient` for the `quoteAsset` `OracleSource` variant — the spot market whose asset *is*
+ * the protocol's quote currency. Ignores its inputs entirely and always returns the constant
+ * `QUOTE_ORACLE_PRICE_DATA` (price 1.0); never makes an RPC call.
+ */
 export declare class QuoteAssetOracleClient implements OracleClient {
     constructor();
+    /**
+     * @param _pricePublicKey - Ignored.
+     * @returns The constant `QUOTE_ORACLE_PRICE_DATA`.
+     */
     getOraclePriceData(_pricePublicKey: PublicKey): Promise<OraclePriceData>;
+    /**
+     * @param _buffer - Ignored.
+     * @returns The constant `QUOTE_ORACLE_PRICE_DATA`.
+     */
     getOraclePriceDataFromBuffer(_buffer: Buffer): OraclePriceData;
 }
 //# sourceMappingURL=quoteAssetOracleClient.d.ts.map

package/lib/node/oracles/quoteAssetOracleClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quoteAssetOracleClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/quoteAssetOracleClient.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAIxD,eAAO,MAAM,uBAAuB,EAAE,eAKrC,CAAC;AAEF,qBAAa,sBAAuB,YAAW,YAAY;;IAG7C,kBAAkB,CAC9B,eAAe,EAAE,SAAS,GACxB,OAAO,CAAC,eAAe,CAAC;IAIpB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;CAGrE"}
+{"version":3,"file":"quoteAssetOracleClient.d.ts","sourceRoot":"","sources":["../../../src/oracles/quoteAssetOracleClient.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAIxD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAKrC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,YAAY;;IAG1D;;;OAGG;IACU,kBAAkB,CAC9B,eAAe,EAAE,SAAS,GACxB,OAAO,CAAC,eAAe,CAAC;IAI3B;;;OAGG;IACI,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe;CAGrE"}

package/lib/node/oracles/quoteAssetOracleClient.js

@@ -3,17 +3,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.QuoteAssetOracleClient = exports.QUOTE_ORACLE_PRICE_DATA = void 0;
 const anchor_1 = require("../isomorphic/anchor");
 const numericConstants_1 = require("../constants/numericConstants");
+/**
+ * Fixed price of exactly 1.0 (PRICE_PRECISION, 1e6) with a minimal confidence band, returned by
+ * `QuoteAssetOracleClient` for any oracle lookup. Represents the quote asset (e.g. USDC) pegged
+ * 1:1 to itself with no real oracle needed.
+ */
 exports.QUOTE_ORACLE_PRICE_DATA = {
     price: numericConstants_1.PRICE_PRECISION,
     slot: new anchor_1.BN(0),
     confidence: new anchor_1.BN(1),
     hasSufficientNumberOfDataPoints: true,
 };
+/**
+ * `OracleClient` for the `quoteAsset` `OracleSource` variant — the spot market whose asset *is*
+ * the protocol's quote currency. Ignores its inputs entirely and always returns the constant
+ * `QUOTE_ORACLE_PRICE_DATA` (price 1.0); never makes an RPC call.
+ */
 class QuoteAssetOracleClient {
     constructor() { }
+    /**
+     * @param _pricePublicKey - Ignored.
+     * @returns The constant `QUOTE_ORACLE_PRICE_DATA`.
+     */
     async getOraclePriceData(_pricePublicKey) {
         return Promise.resolve(exports.QUOTE_ORACLE_PRICE_DATA);
     }
+    /**
+     * @param _buffer - Ignored.
+     * @returns The constant `QUOTE_ORACLE_PRICE_DATA`.
+     */
     getOraclePriceDataFromBuffer(_buffer) {
         return exports.QUOTE_ORACLE_PRICE_DATA;
     }

package/lib/node/oracles/strictOraclePrice.d.ts

@@ -1,9 +1,30 @@
 import { BN } from '../isomorphic/anchor';
+/**
+ * Pairs a live oracle price with its 5-minute TWAP so margin/value calculations can pick whichever
+ * is more conservative — mirroring the on-chain "strict" price used for collateral valuation, which
+ * exists so a transient price spike/dip can't be used to over-value collateral or under-value a
+ * liability. All values are PRICE_PRECISION (1e6).
+ */
 export declare class StrictOraclePrice {
     current: BN;
     twap?: BN;
+    /**
+     * @param current - Live oracle price, PRICE_PRECISION (1e6).
+     * @param twap - 5-minute oracle TWAP, PRICE_PRECISION (1e6). If omitted, `max()`/`min()` both
+     * fall back to `current`.
+     */
     constructor(current: BN, twap?: BN);
+    /**
+     * The higher of `current` and `twap` — use when a higher price is the conservative choice
+     * (e.g. valuing a liability/borrow, where undervaluing it would overstate free collateral).
+     * @returns The larger of `current` and `twap` (or just `current` if no `twap` was provided), PRICE_PRECISION (1e6).
+     */
     max(): BN;
+    /**
+     * The lower of `current` and `twap` — use when a lower price is the conservative choice (e.g.
+     * valuing a deposit/asset, where overvaluing it would overstate free collateral).
+     * @returns The smaller of `current` and `twap` (or just `current` if no `twap` was provided), PRICE_PRECISION (1e6).
+     */
     min(): BN;
 }
 //# sourceMappingURL=strictOraclePrice.d.ts.map

package/lib/node/oracles/strictOraclePrice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strictOraclePrice.d.ts","sourceRoot":"","sources":["../../../src/oracles/strictOraclePrice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAE1C,qBAAa,iBAAiB;IAC7B,OAAO,EAAE,EAAE,CAAC;IACZ,IAAI,CAAC,EAAE,EAAE,CAAC;gBAEE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;IAK3B,GAAG,IAAI,EAAE;IAIT,GAAG,IAAI,EAAE;CAGhB"}
+{"version":3,"file":"strictOraclePrice.d.ts","sourceRoot":"","sources":["../../../src/oracles/strictOraclePrice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAE1C;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,EAAE,EAAE,CAAC;IACZ,IAAI,CAAC,EAAE,EAAE,CAAC;IAEV;;;;OAIG;gBACS,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;IAKlC;;;;OAIG;IACI,GAAG,IAAI,EAAE;IAIhB;;;;OAIG;IACI,GAAG,IAAI,EAAE;CAGhB"}

package/lib/node/oracles/strictOraclePrice.js

@@ -2,14 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StrictOraclePrice = void 0;
 const anchor_1 = require("../isomorphic/anchor");
+/**
+ * Pairs a live oracle price with its 5-minute TWAP so margin/value calculations can pick whichever
+ * is more conservative — mirroring the on-chain "strict" price used for collateral valuation, which
+ * exists so a transient price spike/dip can't be used to over-value collateral or under-value a
+ * liability. All values are PRICE_PRECISION (1e6).
+ */
 class StrictOraclePrice {
+    /**
+     * @param current - Live oracle price, PRICE_PRECISION (1e6).
+     * @param twap - 5-minute oracle TWAP, PRICE_PRECISION (1e6). If omitted, `max()`/`min()` both
+     * fall back to `current`.
+     */
     constructor(current, twap) {
         this.current = current;
         this.twap = twap;
     }
+    /**
+     * The higher of `current` and `twap` — use when a higher price is the conservative choice
+     * (e.g. valuing a liability/borrow, where undervaluing it would overstate free collateral).
+     * @returns The larger of `current` and `twap` (or just `current` if no `twap` was provided), PRICE_PRECISION (1e6).
+     */
     max() {
         return this.twap ? anchor_1.BN.max(this.twap, this.current) : this.current;
     }
+    /**
+     * The lower of `current` and `twap` — use when a lower price is the conservative choice (e.g.
+     * valuing a deposit/asset, where overvaluing it would overstate free collateral).
+     * @returns The smaller of `current` and `twap` (or just `current` if no `twap` was provided), PRICE_PRECISION (1e6).
+     */
     min() {
         return this.twap ? anchor_1.BN.min(this.twap, this.current) : this.current;
     }

package/lib/node/oracles/types.d.ts

@@ -9,25 +9,70 @@
 import { BN } from '../isomorphic/anchor';
 import { PublicKey } from '@solana/web3.js';
 import { OracleSource } from '../types';
+/**
+ * `OraclePriceData` variant for the market-maker (MM) oracle feed, which has no TWAP or
+ * pre-launch `maxPrice` fields but instead flags whether the MM oracle is currently trusted.
+ */
 export type MMOraclePriceData = Omit<OraclePriceData, 'twap' | 'twapConfidence' | 'maxPrice'> & {
+    /** Whether the MM oracle is currently considered active/valid and safe to use in place of the primary oracle. */
     isMMOracleActive: boolean;
+    /**
+     * Whether the MM oracle is enabled (has a non-zero price), mirroring `MMOraclePriceData::is_enabled`.
+     * Populated by `VelocityClient.getMMOracleDataForPerpMarket`; used by the AMM-fill volatility gate
+     * (`isFallbackAvailableLiquiditySource`). Optional because MM data is sometimes constructed without it.
+     */
+    isMMOracleEnabled?: boolean;
+    /**
+     * Whether the MM oracle is at least as recent as the exchange (safe) oracle, mirroring
+     * `MMOraclePriceData::is_mm_oracle_as_recent`. Used together with `isMMExchangeDiffBpsHigh` by the
+     * AMM-fill volatility gate.
+     */
+    isMMOracleAsRecent?: boolean;
+    /**
+     * Whether the MM-vs-exchange oracle price difference exceeds the 1% fallback threshold
+     * (`MM_EXCHANGE_FALLBACK_THRESHOLD`), mirroring `MMOraclePriceData::is_mm_exchange_diff_bps_high`.
+     * When the MM oracle is enabled and as-recent, a high diff suppresses AMM fills (early volatility protection).
+     */
+    isMMExchangeDiffBpsHigh?: boolean;
 };
+/** Normalized oracle price snapshot produced by every `OracleClient`, regardless of underlying source. */
 export type OraclePriceData = {
+    /** Oracle price, PRICE_PRECISION (1e6). */
     price: BN;
+    /** Slot at which this price was last updated on-chain. */
     slot: BN;
+    /** Oracle confidence interval (± band around `price`), PRICE_PRECISION (1e6). */
     confidence: BN;
+    /** Whether the source had enough independent publishers/quoters for the price to be trusted (Pyth-specific; always `true` for sources without a publisher-count concept). */
     hasSufficientNumberOfDataPoints: boolean;
+    /** Time-weighted average price, PRICE_PRECISION (1e6). Absent for sources with no TWAP (e.g. Pyth Lazer echoes the live price here instead). */
     twap?: BN;
+    /** Confidence interval of `twap`, PRICE_PRECISION (1e6). */
     twapConfidence?: BN;
+    /** Upper price bound; only populated for prelaunch-market oracles, PRICE_PRECISION (1e6). */
     maxPrice?: BN;
+    /** Monotonic sequence/publish-time id used to detect out-of-order updates (Pyth Lazer only). */
     sequenceId?: BN;
 };
+/** Identifies an oracle account and which `OracleSource` variant to decode it as. */
 export type OracleInfo = {
     publicKey: PublicKey;
     source: OracleSource;
 };
+/** Common interface implemented by every per-source oracle adapter (Pyth, Pyth Lazer, prelaunch, quote-asset). */
 export interface OracleClient {
+    /**
+     * Decodes raw oracle account bytes into normalized `OraclePriceData` without any RPC call.
+     * @param buffer - Raw account data as returned by `getAccountInfo`/`getMultipleAccounts`.
+     * @returns The decoded, normalized price data.
+     */
     getOraclePriceDataFromBuffer(buffer: Buffer): OraclePriceData;
+    /**
+     * Fetches and decodes an oracle account's current price data.
+     * @param publicKey - The oracle account's address.
+     * @returns The decoded, normalized price data.
+     * @throws Error if the account does not exist.
+     */
     getOraclePriceData(publicKey: PublicKey): Promise<OraclePriceData>;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/node/oracles/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/oracles/types.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG,IAAI,CACnC,eAAe,EACf,MAAM,GAAG,gBAAgB,GAAG,UAAU,CACtC,GAAG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,EAAE,CAAC;IACV,IAAI,EAAE,EAAE,CAAC;IACT,UAAU,EAAE,EAAE,CAAC;IACf,+BAA+B,EAAE,OAAO,CAAC;IACzC,IAAI,CAAC,EAAE,EAAE,CAAC;IACV,cAAc,CAAC,EAAE,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,CAAC;IACd,UAAU,CAAC,EAAE,EAAE,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,YAAY;IAC5B,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAC9D,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACnE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/oracles/types.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,CACnC,eAAe,EACf,MAAM,GAAG,gBAAgB,GAAG,UAAU,CACtC,GAAG;IACH,iHAAiH;IACjH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,0GAA0G;AAC1G,MAAM,MAAM,eAAe,GAAG;IAC7B,2CAA2C;IAC3C,KAAK,EAAE,EAAE,CAAC;IACV,0DAA0D;IAC1D,IAAI,EAAE,EAAE,CAAC;IACT,iFAAiF;IACjF,UAAU,EAAE,EAAE,CAAC;IACf,6KAA6K;IAC7K,+BAA+B,EAAE,OAAO,CAAC;IACzC,gJAAgJ;IAChJ,IAAI,CAAC,EAAE,EAAE,CAAC;IACV,4DAA4D;IAC5D,cAAc,CAAC,EAAE,EAAE,CAAC;IACpB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,EAAE,CAAC;IACd,gGAAgG;IAChG,UAAU,CAAC,EAAE,EAAE,CAAC;CAChB,CAAC;AAEF,qFAAqF;AACrF,MAAM,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,kHAAkH;AAClH,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAC9D;;;;;OAKG;IACH,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACnE"}