@velocity-exchange/sdk 0.2.5 → 0.4.0

package/lib/node/priorityFee/priorityFeeSubscriberMap.js

@@ -4,9 +4,14 @@ exports.PriorityFeeSubscriberMap = void 0;
 const velocityPriorityFeeMethod_1 = require("./velocityPriorityFeeMethod");
 const types_1 = require("./types");
 /**
- * takes advantage of /batchPriorityFees endpoint from Velocity hosted priority fee service
+ * PriorityFeeSubscriberMap — polls the Velocity-hosted `/batchPriorityFees`
+ * endpoint for a fixed set of markets and caches the latest per-market fee
+ * levels, keyed by market type and index. Unlike `PriorityFeeSubscriber`
+ * (single aggregated result across `PriorityFeeMethod.VELOCITY` markets),
+ * this exposes each market's fee levels independently via `getPriorityFees`.
  */
 class PriorityFeeSubscriberMap {
+    /** @param config `frequencyMs` defaults to `DEFAULT_PRIORITY_FEE_MAP_FREQUENCY_MS` (10s); `velocityPriorityFeeEndpoint` is required. */
     constructor(config) {
         var _a, _b;
         this.frequencyMs =
@@ -23,6 +28,7 @@ class PriorityFeeSubscriberMap {
             this.feesMap.get(fee.marketType).set(fee.marketIndex, fee);
         });
     }
+    /** Performs an immediate `load()` and then polls at `frequencyMs`. Idempotent while already subscribed. */
     async subscribe() {
         if (this.intervalId) {
             return;
@@ -30,15 +36,22 @@ class PriorityFeeSubscriberMap {
         await this.load();
         this.intervalId = setInterval(this.load.bind(this), this.frequencyMs);
     }
+    /** Stops polling. */
     async unsubscribe() {
         if (this.intervalId) {
             clearInterval(this.intervalId);
             this.intervalId = undefined;
         }
     }
+    /**
+     * Fetches one batch of per-market fee levels from
+     * `/batchPriorityFees` for all `velocityMarkets` and merges the results
+     * into `feesMap`. No-ops if no markets are configured. Errors are caught
+     * and logged, not thrown — `feesMap` is left at its previous state.
+     */
     async load() {
         try {
-            if (!this.velocityMarkets) {
+            if (!this.velocityMarkets || this.velocityMarkets.length === 0) {
                 return;
             }
             const fees = await (0, velocityPriorityFeeMethod_1.fetchVelocityPriorityFee)(this.velocityPriorityFeeEndpoint, this.velocityMarkets.map((m) => m.marketType), this.velocityMarkets.map((m) => m.marketIndex));
@@ -48,9 +61,15 @@ class PriorityFeeSubscriberMap {
             console.error('Error fetching priority fees', e);
         }
     }
+    /** Replaces the set of markets to fetch fees for; takes effect on the next `load()`. */
     updateMarketTypeAndIndex(velocityMarkets) {
         this.velocityMarkets = velocityMarkets;
     }
+    /**
+     * @param marketType `'perp'` or `'spot'`.
+     * @param marketIndex Market index within that market type.
+     * @returns The most recently fetched fee-level set for that market, or `undefined` if never fetched (including before the first successful `load()`).
+     */
     getPriorityFees(marketType, marketIndex) {
         var _a;
         return (_a = this.feesMap.get(marketType)) === null || _a === void 0 ? void 0 : _a.get(marketIndex);

package/lib/node/priorityFee/solanaPriorityFeeMethod.d.ts

@@ -1,7 +1,19 @@
 import { Connection } from '@solana/web3.js';
+/** One sample from Solana's `getRecentPrioritizationFees`. */
 export type SolanaPriorityFeeResponse = {
     slot: number;
+    /** Priority fee paid, in micro-lamports per compute unit. */
     prioritizationFee: number;
 };
+/**
+ * Fetches recent prioritization fees for `addresses` via the Solana RPC
+ * `getRecentPrioritizationFees` method, then filters to the most recent
+ * `lookbackDistance` slots (relative to the newest returned slot, not the
+ * current chain tip) and sorts descending by slot.
+ * @param connection RPC connection.
+ * @param lookbackDistance Number of slots back from the newest sample to retain.
+ * @param addresses Account keys to scope the fee lookup to (accounts the transaction will write-lock).
+ * @returns Filtered, slot-descending samples; `undefined` if the RPC returned zero results; an empty array if the RPC call itself threw (error is logged, not thrown).
+ */
 export declare function fetchSolanaPriorityFee(connection: Connection, lookbackDistance: number, addresses: string[]): Promise<SolanaPriorityFeeResponse[] | undefined>;
 //# sourceMappingURL=solanaPriorityFeeMethod.d.ts.map

package/lib/node/priorityFee/solanaPriorityFeeMethod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solanaPriorityFeeMethod.d.ts","sourceRoot":"","sources":["../../../src/priorityFee/solanaPriorityFeeMethod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAsB,sBAAsB,CAC3C,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,yBAAyB,EAAE,GAAG,SAAS,CAAC,CAsBlD"}
+{"version":3,"file":"solanaPriorityFeeMethod.d.ts","sourceRoot":"","sources":["../../../src/priorityFee/solanaPriorityFeeMethod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,8DAA8D;AAC9D,MAAM,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC3C,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,yBAAyB,EAAE,GAAG,SAAS,CAAC,CAsBlD"}

package/lib/node/priorityFee/solanaPriorityFeeMethod.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchSolanaPriorityFee = void 0;
+/**
+ * Fetches recent prioritization fees for `addresses` via the Solana RPC
+ * `getRecentPrioritizationFees` method, then filters to the most recent
+ * `lookbackDistance` slots (relative to the newest returned slot, not the
+ * current chain tip) and sorts descending by slot.
+ * @param connection RPC connection.
+ * @param lookbackDistance Number of slots back from the newest sample to retain.
+ * @param addresses Account keys to scope the fee lookup to (accounts the transaction will write-lock).
+ * @returns Filtered, slot-descending samples; `undefined` if the RPC returned zero results; an empty array if the RPC call itself threw (error is logged, not thrown).
+ */
 async function fetchSolanaPriorityFee(connection, lookbackDistance, addresses) {
     try {
         // @ts-ignore

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

@@ -2,33 +2,65 @@ import { Connection, PublicKey } from '@solana/web3.js';
 import { SolanaPriorityFeeResponse } from './solanaPriorityFeeMethod';
 import { HeliusPriorityFeeResponse } from './heliusPriorityFeeMethod';
 import { VelocityMarketInfo, VelocityPriorityFeeResponse } from './velocityPriorityFeeMethod';
+/** Default poll interval (ms) for `PriorityFeeSubscriber`/`PriorityFeeSubscriberMap` when `frequencyMs` is not configured. */
 export declare const DEFAULT_PRIORITY_FEE_MAP_FREQUENCY_MS = 10000;
+/**
+ * A pluggable priority-fee aggregation function. `PriorityFeeSubscriber`
+ * calls `calculate` after each poll to derive `getCustomStrategyResult()`.
+ * Built-in implementations: `AverageStrategy`/`AverageOverSlotsStrategy`,
+ * `EwmaStrategy`, `MaxStrategy`/`MaxOverSlotsStrategy`.
+ */
 export interface PriorityFeeStrategy {
+    /**
+     * @param samples Fee samples from whichever `priorityFeeMethod` is active — `SolanaPriorityFeeResponse[]` for SOLANA (expected sorted descending by slot), a single `HeliusPriorityFeeResponse` for HELIUS, or `VelocityPriorityFeeResponse` for VELOCITY.
+     * @returns A priority fee estimate in micro-lamports per compute unit.
+     */
     calculate(samples: SolanaPriorityFeeResponse[] | HeliusPriorityFeeResponse | VelocityPriorityFeeResponse): number;
 }
+/** Which upstream API `PriorityFeeSubscriber` queries for priority-fee samples. */
 export declare enum PriorityFeeMethod {
+    /** Solana RPC `getRecentPrioritizationFees`. Requires `connection`. */
     SOLANA = "solana",
+    /** Helius `getPriorityFeeEstimate`. Requires `heliusRpcUrl` or a Helius `connection`. */
     HELIUS = "helius",
+    /** Velocity-hosted priority fee cache, scoped by market. Requires `velocityPriorityFeeEndpoint` and `velocityMarkets`. */
     VELOCITY = "velocity"
 }
+/** Configuration for `PriorityFeeSubscriber`. Which fields are required depends on `priorityFeeMethod` — see `PriorityFeeMethod`. */
 export type PriorityFeeSubscriberConfig = {
+    /** RPC connection used for SOLANA sampling (and as a Helius URL source for HELIUS if `heliusRpcUrl` is omitted); optional only when `priorityFeeMethod` is `HELIUS` or `VELOCITY`. */
     connection?: Connection;
+    /** Poll interval in milliseconds for `load()`; defaults to `DEFAULT_PRIORITY_FEE_MAP_FREQUENCY_MS` (10s). */
     frequencyMs?: number;
+    /** Account keys the transaction will write-lock; scopes SOLANA/HELIUS fee sampling to congestion on these accounts specifically. */
     addresses?: PublicKey[];
+    /** Markets to query when `priorityFeeMethod` is `VELOCITY`; can also be supplied later via `updateMarketTypeAndIndex`. */
     velocityMarkets?: VelocityMarketInfo[];
+    /** `PriorityFeeStrategy` backing `getCustomStrategyResult()`; defaults to `AverageOverSlotsStrategy`. */
     customStrategy?: PriorityFeeStrategy;
+    /** Which upstream API to sample from; defaults to `PriorityFeeMethod.SOLANA`. */
     priorityFeeMethod?: PriorityFeeMethod;
+    /** Number of recent slots to consider when computing fee estimates; defaults to 50. */
     slotsToCheck?: number;
+    /** Helius RPC URL; required for `PriorityFeeMethod.HELIUS` unless `connection`'s endpoint already points at Helius. */
     heliusRpcUrl?: string;
+    /** Base URL of the Velocity-hosted priority fee service; required for `PriorityFeeMethod.VELOCITY`. */
     velocityPriorityFeeEndpoint?: string;
+    /** Upper bound (micro-lamports per compute unit) applied to every `get*StrategyResult`/`getHeliusPriorityFeeLevel` return value, after `priorityFeeMultiplier`. Unset (`undefined`) means no clamp. */
     maxFeeMicroLamports?: number;
+    /** Multiplier applied to the raw strategy result before `maxFeeMicroLamports` clamping; defaults to `1.0`. */
     priorityFeeMultiplier?: number;
 };
+/** Base config for `PriorityFeeSubscriberMap`, which only supports `PriorityFeeMethod.VELOCITY` (batched per-market fee lookups via `/batchPriorityFees`). */
 type PriorityFeeSubscriberMapConfigBase = {
+    /** Poll interval in milliseconds for `load()`; defaults to `DEFAULT_PRIORITY_FEE_MAP_FREQUENCY_MS` (10s). */
     frequencyMs?: number;
+    /** Markets to fetch fees for; can also be supplied later via `updateMarketTypeAndIndex`. */
     velocityMarkets?: VelocityMarketInfo[];
 };
+/** Configuration for `PriorityFeeSubscriberMap`. */
 export type PriorityFeeSubscriberMapConfig = PriorityFeeSubscriberMapConfigBase & {
+    /** Base URL of the Velocity-hosted priority fee service (queried via `/batchPriorityFees`). */
     velocityPriorityFeeEndpoint: string;
 };
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/priorityFee/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EACN,kBAAkB,EAClB,2BAA2B,EAC3B,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,qCAAqC,QAAS,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAGnC,SAAS,CACR,OAAO,EACJ,yBAAyB,EAAE,GAC3B,yBAAyB,GACzB,2BAA2B,GAC5B,MAAM,CAAC;CACV;AAED,oBAAY,iBAAiB;IAC5B,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACrB;AAED,MAAM,MAAM,2BAA2B,GAAG;IAEzC,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IAExB,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEvC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,KAAK,kCAAkC,GAAG;IAEzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACvC,CAAC;AAGF,MAAM,MAAM,8BAA8B,GACzC,kCAAkC,GAAG;IACpC,2BAA2B,EAAE,MAAM,CAAC;CACpC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/priorityFee/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EACN,kBAAkB,EAClB,2BAA2B,EAC3B,MAAM,6BAA6B,CAAC;AAErC,8HAA8H;AAC9H,eAAO,MAAM,qCAAqC,QAAS,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAGnC;;;OAGG;IACH,SAAS,CACR,OAAO,EACJ,yBAAyB,EAAE,GAC3B,yBAAyB,GACzB,2BAA2B,GAC5B,MAAM,CAAC;CACV;AAED,mFAAmF;AACnF,oBAAY,iBAAiB;IAC5B,uEAAuE;IACvE,MAAM,WAAW;IACjB,yFAAyF;IACzF,MAAM,WAAW;IACjB,0HAA0H;IAC1H,QAAQ,aAAa;CACrB;AAED,qIAAqI;AACrI,MAAM,MAAM,2BAA2B,GAAG;IACzC,sLAAsL;IACtL,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6GAA6G;IAC7G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oIAAoI;IACpI,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,0HAA0H;IAC1H,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACvC,yGAAyG;IACzG,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uHAAuH;IACvH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uGAAuG;IACvG,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uMAAuM;IACvM,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8GAA8G;IAC9G,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,8JAA8J;AAC9J,KAAK,kCAAkC,GAAG;IACzC,6GAA6G;IAC7G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACvC,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,8BAA8B,GACzC,kCAAkC,GAAG;IACpC,+FAA+F;IAC/F,2BAA2B,EAAE,MAAM,CAAC;CACpC,CAAC"}

package/lib/node/priorityFee/types.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PriorityFeeMethod = exports.DEFAULT_PRIORITY_FEE_MAP_FREQUENCY_MS = void 0;
+/** Default poll interval (ms) for `PriorityFeeSubscriber`/`PriorityFeeSubscriberMap` when `frequencyMs` is not configured. */
 exports.DEFAULT_PRIORITY_FEE_MAP_FREQUENCY_MS = 10000;
+/** Which upstream API `PriorityFeeSubscriber` queries for priority-fee samples. */
 var PriorityFeeMethod;
 (function (PriorityFeeMethod) {
+    /** Solana RPC `getRecentPrioritizationFees`. Requires `connection`. */
     PriorityFeeMethod["SOLANA"] = "solana";
+    /** Helius `getPriorityFeeEstimate`. Requires `heliusRpcUrl` or a Helius `connection`. */
     PriorityFeeMethod["HELIUS"] = "helius";
+    /** Velocity-hosted priority fee cache, scoped by market. Requires `velocityPriorityFeeEndpoint` and `velocityMarkets`. */
     PriorityFeeMethod["VELOCITY"] = "velocity";
 })(PriorityFeeMethod || (exports.PriorityFeeMethod = PriorityFeeMethod = {}));

package/lib/node/priorityFee/velocityPriorityFeeMethod.d.ts

@@ -1,14 +1,25 @@
 import { HeliusPriorityLevel } from './heliusPriorityFeeMethod';
+/** Identifies a market to fetch/track priority fees for. */
 export type VelocityMarketInfo = {
     marketType: string;
     marketIndex: number;
 };
+/** Per-percentile priority fee (micro-lamports/CU, same buckets as `HeliusPriorityLevel`) for one market, as returned by the Velocity priority fee endpoint. */
 export type VelocityPriorityFeeLevels = {
     [key in HeliusPriorityLevel]: number;
 } & {
     marketType: 'perp' | 'spot';
     marketIndex: number;
 };
+/** One `VelocityPriorityFeeLevels` entry per requested market. */
 export type VelocityPriorityFeeResponse = VelocityPriorityFeeLevels[];
+/**
+ * Fetches per-market priority fee levels from the Velocity-hosted
+ * `/batchPriorityFees` endpoint.
+ * @param url Base URL of the Velocity priority fee service.
+ * @param marketTypes Market types to query, parallel-indexed to `marketIndexes` (e.g. `['perp', 'perp', 'spot']`).
+ * @param marketIndexes Market indexes to query, parallel-indexed to `marketTypes`.
+ * @returns One `VelocityPriorityFeeLevels` per requested market; an empty array if the request failed (error is logged, not thrown) or returned a non-OK HTTP status.
+ */
 export declare function fetchVelocityPriorityFee(url: string, marketTypes: string[], marketIndexes: number[]): Promise<VelocityPriorityFeeResponse>;
 //# sourceMappingURL=velocityPriorityFeeMethod.d.ts.map

package/lib/node/priorityFee/velocityPriorityFeeMethod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"velocityPriorityFeeMethod.d.ts","sourceRoot":"","sources":["../../../src/priorityFee/velocityPriorityFeeMethod.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;KACtC,GAAG,IAAI,mBAAmB,GAAG,MAAM;CACpC,GAAG;IACH,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,yBAAyB,EAAE,CAAC;AAEtE,wBAAsB,wBAAwB,CAC7C,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,2BAA2B,CAAC,CAoBtC"}
+{"version":3,"file":"velocityPriorityFeeMethod.d.ts","sourceRoot":"","sources":["../../../src/priorityFee/velocityPriorityFeeMethod.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,gKAAgK;AAChK,MAAM,MAAM,yBAAyB,GAAG;KACtC,GAAG,IAAI,mBAAmB,GAAG,MAAM;CACpC,GAAG;IACH,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,2BAA2B,GAAG,yBAAyB,EAAE,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC7C,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,2BAA2B,CAAC,CAoBtC"}

package/lib/node/priorityFee/velocityPriorityFeeMethod.js

@@ -5,6 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchVelocityPriorityFee = void 0;
 const node_fetch_1 = __importDefault(require("node-fetch"));
+/**
+ * Fetches per-market priority fee levels from the Velocity-hosted
+ * `/batchPriorityFees` endpoint.
+ * @param url Base URL of the Velocity priority fee service.
+ * @param marketTypes Market types to query, parallel-indexed to `marketIndexes` (e.g. `['perp', 'perp', 'spot']`).
+ * @param marketIndexes Market indexes to query, parallel-indexed to `marketTypes`.
+ * @returns One `VelocityPriorityFeeLevels` per requested market; an empty array if the request failed (error is logged, not thrown) or returned a non-OK HTTP status.
+ */
 async function fetchVelocityPriorityFee(url, marketTypes, marketIndexes) {
     try {
         const response = await (0, node_fetch_1.default)(`${url}/batchPriorityFees?marketType=${marketTypes.join(',')}&marketIndex=${marketIndexes.join(',')}`);

package/lib/node/slot/SlotSubscriber.d.ts

@@ -5,9 +5,17 @@ import StrictEventEmitter from 'strict-event-emitter-types/types/src';
 type SlotSubscriberConfig = {
     resubTimeoutMs?: number;
 };
+/** Events emitted on `SlotSubscriber.eventEmitter`. */
 export interface SlotSubscriberEvents {
+    /** Fired whenever a new, strictly-greater slot is observed (including the initial slot fetched by `subscribe()`). */
     newSlot: (newSlot: number) => void;
 }
+/**
+ * SlotSubscriber — tracks the current slot via `connection.onSlotChange`,
+ * with an optional stall-detection resubscribe. Slot updates that are not
+ * strictly greater than the currently tracked slot are ignored (protects
+ * against out-of-order delivery).
+ */
 export declare class SlotSubscriber {
     private connection;
     currentSlot: number;
@@ -17,11 +25,21 @@ export declare class SlotSubscriber {
     resubTimeoutMs?: number;
     isUnsubscribing: boolean;
     receivingData: boolean;
+    /**
+     * @param connection RPC connection to subscribe on.
+     * @param config.resubTimeoutMs If set to a positive value, resubscribe when no slot update arrives for this many ms; `0` (or unset) disables the resubscribe watchdog. Positive values below 1000ms log a warning (too aggressive) but are still honored.
+     */
     constructor(connection: Connection, config?: SlotSubscriberConfig);
+    /** Fetches the current slot once via RPC, then subscribes to `onSlotChange` for live updates. Idempotent while already subscribed. */
     subscribe(): Promise<void>;
     private updateCurrentSlot;
     private setTimeout;
+    /** @returns The most recently observed slot, or `0` if `subscribe()` hasn't completed yet. */
     getSlot(): number;
+    /**
+     * Removes the `onSlotChange` listener and cancels the resub timeout.
+     * @param onResub Internal flag used when unsubscribing as part of an automatic resubscribe cycle; when `false` (a caller-initiated unsubscribe), also permanently disables future auto-resubscribe by clearing `resubTimeoutMs`.
+     */
     unsubscribe(onResub?: boolean): Promise<void>;
 }
 export {};

package/lib/node/slot/SlotSubscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SlotSubscriber.d.ts","sourceRoot":"","sources":["../../../src/slot/SlotSubscriber.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,kBAAkB,MAAM,sCAAsC,CAAC;AAGtE,KAAK,oBAAoB,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,cAAc;IAYzB,OAAO,CAAC,UAAU;IAXnB,WAAW,SAAK;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,kBAAkB,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;IAGrE,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,UAAS;IACxB,aAAa,UAAS;gBAGb,UAAU,EAAE,UAAU,EAC9B,MAAM,CAAC,EAAE,oBAAoB;IAWjB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BvC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,UAAU;IAkBX,OAAO,IAAI,MAAM;IAIX,WAAW,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBxD"}
+{"version":3,"file":"SlotSubscriber.d.ts","sourceRoot":"","sources":["../../../src/slot/SlotSubscriber.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,kBAAkB,MAAM,sCAAsC,CAAC;AAGtE,KAAK,oBAAoB,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACpC,qHAAqH;IACrH,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IAgBzB,OAAO,CAAC,UAAU;IAfnB,WAAW,SAAK;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,kBAAkB,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC;IAGrE,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,UAAS;IACxB,aAAa,UAAS;IAEtB;;;OAGG;gBAEM,UAAU,EAAE,UAAU,EAC9B,MAAM,CAAC,EAAE,oBAAoB;IAW9B,sIAAsI;IACzH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BvC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,UAAU;IAkBlB,8FAA8F;IACvF,OAAO,IAAI,MAAM;IAIxB;;;OAGG;IACU,WAAW,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBxD"}

package/lib/node/slot/SlotSubscriber.js

@@ -2,7 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SlotSubscriber = void 0;
 const events_1 = require("events");
+/**
+ * SlotSubscriber — tracks the current slot via `connection.onSlotChange`,
+ * with an optional stall-detection resubscribe. Slot updates that are not
+ * strictly greater than the currently tracked slot are ignored (protects
+ * against out-of-order delivery).
+ */
 class SlotSubscriber {
+    /**
+     * @param connection RPC connection to subscribe on.
+     * @param config.resubTimeoutMs If set to a positive value, resubscribe when no slot update arrives for this many ms; `0` (or unset) disables the resubscribe watchdog. Positive values below 1000ms log a warning (too aggressive) but are still honored.
+     */
     constructor(connection, config) {
         this.connection = connection;
         this.currentSlot = 0;
@@ -14,6 +24,7 @@ class SlotSubscriber {
             console.log('resubTimeoutMs should be at least 1000ms to avoid spamming resub');
         }
     }
+    /** Fetches the current slot once via RPC, then subscribes to `onSlotChange` for live updates. Idempotent while already subscribed. */
     async subscribe() {
         if (this.subscriptionId != null) {
             return;
@@ -54,9 +65,14 @@ class SlotSubscriber {
             }
         }, this.resubTimeoutMs);
     }
+    /** @returns The most recently observed slot, or `0` if `subscribe()` hasn't completed yet. */
     getSlot() {
         return this.currentSlot;
     }
+    /**
+     * Removes the `onSlotChange` listener and cancels the resub timeout.
+     * @param onResub Internal flag used when unsubscribing as part of an automatic resubscribe cycle; when `false` (a caller-initiated unsubscribe), also permanently disables future auto-resubscribe by clearing `resubTimeoutMs`.
+     */
     async unsubscribe(onResub = false) {
         if (!onResub) {
             this.resubTimeoutMs = undefined;

package/lib/node/slot/SlothashSubscriber.d.ts

@@ -3,10 +3,18 @@ type SlothashSubscriberConfig = {
     resubTimeoutMs?: number;
     commitment?: Commitment;
 };
+/** A slot and its corresponding blockhash, decoded from the `SysvarS1otHashes111111111111111111111111111` account. */
 export type Slothash = {
     slot: number;
+    /** Base58-encoded blockhash for that slot. */
     hash: string;
 };
+/**
+ * SlothashSubscriber — tracks the most recent entry of the `SlotHashes`
+ * sysvar via `connection.onAccountChange`, with an optional stall-detection
+ * resubscribe. Updates whose slot is not strictly greater than the currently
+ * tracked one are ignored.
+ */
 export declare class SlothashSubscriber {
     private connection;
     private _currentSlothash?;
@@ -17,10 +25,28 @@ export declare class SlothashSubscriber {
     resubTimeoutMs?: number;
     isUnsubscribing: boolean;
     receivingData: boolean;
+    /**
+     * @param connection RPC connection to subscribe on.
+     * @param config.commitment Commitment for both the initial fetch and the account-change subscription; defaults to `'processed'`.
+     * @param config.resubTimeoutMs If set to a positive value, resubscribe when no update arrives for this many ms; `0` (or unset) disables the resubscribe watchdog. Positive values below 1000ms log a warning but are still honored.
+     */
     constructor(connection: Connection, config?: SlothashSubscriberConfig);
+    /**
+     * Fetches the `SlotHashes` sysvar once via RPC, then subscribes to
+     * `onAccountChange` for live updates. Idempotent while already subscribed.
+     * @throws If the sysvar account can't be fetched on the initial load.
+     */
     subscribe(): Promise<void>;
     private setTimeout;
+    /**
+     * @returns The most recently observed `Slothash`.
+     * @throws If called before `subscribe()` has completed its initial fetch.
+     */
     getSlothash(): Slothash;
+    /**
+     * Removes the `onAccountChange` listener and cancels the resub timeout.
+     * @param onResub Internal flag used when unsubscribing as part of an automatic resubscribe cycle; when `false`, also permanently disables future auto-resubscribe by clearing `resubTimeoutMs`.
+     */
     unsubscribe(onResub?: boolean): Promise<void>;
 }
 export {};

package/lib/node/slot/SlothashSubscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SlothashSubscriber.d.ts","sourceRoot":"","sources":["../../../src/slot/SlothashSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,UAAU,EAEV,MAAM,iBAAiB,CAAC;AAKzB,KAAK,wBAAwB,GAAG;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,qBAAa,kBAAkB;IAoB7B,OAAO,CAAC,UAAU;IAnBnB,OAAO,CAAC,gBAAgB,CAAC,CAAW;IACpC,OAAO,KAAK,eAAe,GAO1B;IACD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,UAAU,CAAC;IAGvB,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,UAAS;IACxB,aAAa,UAAS;gBAGb,UAAU,EAAE,UAAU,EAC9B,MAAM,CAAC,EAAE,wBAAwB;IAWrB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCvC,OAAO,CAAC,UAAU;IAkBX,WAAW,IAAI,QAAQ;IAIjB,WAAW,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBxD"}
+{"version":3,"file":"SlothashSubscriber.d.ts","sourceRoot":"","sources":["../../../src/slot/SlothashSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,UAAU,EACV,UAAU,EAEV,MAAM,iBAAiB,CAAC;AAKzB,KAAK,wBAAwB,GAAG;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,sHAAsH;AACtH,MAAM,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,kBAAkB;IAyB7B,OAAO,CAAC,UAAU;IAxBnB,OAAO,CAAC,gBAAgB,CAAC,CAAW;IACpC,OAAO,KAAK,eAAe,GAO1B;IACD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,UAAU,CAAC;IAGvB,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,UAAS;IACxB,aAAa,UAAS;IAEtB;;;;OAIG;gBAEM,UAAU,EAAE,UAAU,EAC9B,MAAM,CAAC,EAAE,wBAAwB;IAWlC;;;;OAIG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCvC,OAAO,CAAC,UAAU;IAkBlB;;;OAGG;IACI,WAAW,IAAI,QAAQ;IAI9B;;;OAGG;IACU,WAAW,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBxD"}

package/lib/node/slot/SlothashSubscriber.js

@@ -7,6 +7,12 @@ exports.SlothashSubscriber = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const bs58_1 = __importDefault(require("bs58"));
 const anchor_1 = require("../isomorphic/anchor");
+/**
+ * SlothashSubscriber — tracks the most recent entry of the `SlotHashes`
+ * sysvar via `connection.onAccountChange`, with an optional stall-detection
+ * resubscribe. Updates whose slot is not strictly greater than the currently
+ * tracked one are ignored.
+ */
 class SlothashSubscriber {
     get currentSlothash() {
         if (!this._currentSlothash) {
@@ -14,6 +20,11 @@ class SlothashSubscriber {
         }
         return this._currentSlothash;
     }
+    /**
+     * @param connection RPC connection to subscribe on.
+     * @param config.commitment Commitment for both the initial fetch and the account-change subscription; defaults to `'processed'`.
+     * @param config.resubTimeoutMs If set to a positive value, resubscribe when no update arrives for this many ms; `0` (or unset) disables the resubscribe watchdog. Positive values below 1000ms log a warning but are still honored.
+     */
     constructor(connection, config) {
         var _a;
         this.connection = connection;
@@ -25,6 +36,11 @@ class SlothashSubscriber {
             console.log('resubTimeoutMs should be at least 1000ms to avoid spamming resub');
         }
     }
+    /**
+     * Fetches the `SlotHashes` sysvar once via RPC, then subscribes to
+     * `onAccountChange` for live updates. Idempotent while already subscribed.
+     * @throws If the sysvar account can't be fetched on the initial load.
+     */
     async subscribe() {
         if (this.subscriptionId != null) {
             return;
@@ -64,9 +80,17 @@ class SlothashSubscriber {
             }
         }, this.resubTimeoutMs);
     }
+    /**
+     * @returns The most recently observed `Slothash`.
+     * @throws If called before `subscribe()` has completed its initial fetch.
+     */
     getSlothash() {
         return this.currentSlothash;
     }
+    /**
+     * Removes the `onAccountChange` listener and cancels the resub timeout.
+     * @param onResub Internal flag used when unsubscribing as part of an automatic resubscribe cycle; when `false`, also permanently disables future auto-resubscribe by clearing `resubTimeoutMs`.
+     */
     async unsubscribe(onResub = false) {
         if (!onResub) {
             this.resubTimeoutMs = undefined;
@@ -75,7 +99,7 @@ class SlothashSubscriber {
         clearTimeout(this.timeoutId);
         this.timeoutId = undefined;
         if (this.subscriptionId != null) {
-            await this.connection.removeSlotChangeListener(this.subscriptionId);
+            await this.connection.removeAccountChangeListener(this.subscriptionId);
             this.subscriptionId = undefined;
             this.isUnsubscribing = false;
         }

package/lib/node/swift/swiftOrderSubscriber.js

@@ -71,8 +71,8 @@ class SwiftOrderSubscriber {
         this.onOrder = onOrder;
         const env = this.config.velocityEnv;
         const endpoint = (_a = this.config.endpoint) !== null && _a !== void 0 ? _a : (env === 'devnet'
-            ? 'wss://master.swift.drift.trade/ws'
-            : 'wss://swift.drift.trade/ws');
+            ? 'wss://swift.master.velocity.exchange/ws'
+            : 'wss://swift.velocity.exchange/ws');
         const ws = new ws_1.default(endpoint + '?pubkey=' + this.config.keypair.publicKey.toBase58());
         this.ws = ws;
         ws.on('open', async () => {

package/lib/node/tokenFaucet.d.ts

@@ -1,5 +1,5 @@
-import * as anchor from './isomorphic/anchor29';
-import { AnchorProvider, Program } from './isomorphic/anchor29';
+import * as anchor from './isomorphic/anchor';
+import { AnchorProvider, Program } from './isomorphic/anchor';
 import { Account } from '@solana/spl-token';
 import { ConfirmOptions, Connection, PublicKey, TransactionInstruction, TransactionSignature } from '@solana/web3.js';
 import { IWallet } from './types';

package/lib/node/tokenFaucet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenFaucet.d.ts","sourceRoot":"","sources":["../../src/tokenFaucet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAO,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAEN,OAAO,EAIP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,cAAc,EACd,UAAU,EACV,SAAS,EAGT,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAEzC,qBAAa,WAAW;IACvB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,cAAc,CAAC;gBAGrB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,qBAAqB;IAsBnB,gCAAgC,IAAI,OAAO,CACvD;QAAC,SAAS;QAAE,MAAM;KAAC,CACnB;IAUY,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC;IAYtC,wBAAwB,IAAI,OAAO,CAAC,SAAS,CAAC;IAI9C,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAuB3C,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;YAMzB,YAAY;IAYb,UAAU,CACtB,gBAAgB,EAAE,SAAS,EAC3B,MAAM,EAAE,EAAE,GACR,OAAO,CAAC,oBAAoB,CAAC;IAiBnB,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA2BtD,qCAAqC,CACjD,aAAa,EAAE,SAAS,EACxB,MAAM,EAAE,EAAE,GACR,OAAO,CAAC,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IA2ChC,iDAAiD,CAC7D,aAAa,EAAE,SAAS,EACxB,MAAM,EAAE,EAAE,GACR,OAAO,CAAC,CAAC,SAAS,EAAE,sBAAsB,EAAE,sBAAsB,CAAC,CAAC;IAmB1D,gCAAgC,CAAC,KAAK,EAAE;QACpD,UAAU,EAAE,SAAS,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;IAMrB,mBAAmB,CAAC,KAAK,EAAE;QACvC,UAAU,EAAE,SAAS,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQP,uBAAuB,CAAC,KAAK,EAAE;QAC3C,UAAU,EAAE,SAAS,CAAC;QACtB,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;KACzC,GAAG,OAAO,CAAC,OAAO,CAAC;CA0BpB"}
+{"version":3,"file":"tokenFaucet.d.ts","sourceRoot":"","sources":["../../src/tokenFaucet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAO,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAEN,OAAO,EAIP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,cAAc,EACd,UAAU,EACV,SAAS,EAGT,sBAAsB,EACtB,oBAAoB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAEzC,qBAAa,WAAW;IACvB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,cAAc,CAAC;gBAGrB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,EACf,IAAI,CAAC,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,qBAAqB;IAyBnB,gCAAgC,IAAI,OAAO,CACvD;QAAC,SAAS;QAAE,MAAM;KAAC,CACnB;IAUY,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC;IAYtC,wBAAwB,IAAI,OAAO,CAAC,SAAS,CAAC;IAI9C,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAuB3C,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;YAMzB,YAAY;IAYb,UAAU,CACtB,gBAAgB,EAAE,SAAS,EAC3B,MAAM,EAAE,EAAE,GACR,OAAO,CAAC,oBAAoB,CAAC;IAiBnB,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA2BtD,qCAAqC,CACjD,aAAa,EAAE,SAAS,EACxB,MAAM,EAAE,EAAE,GACR,OAAO,CAAC,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IA2ChC,iDAAiD,CAC7D,aAAa,EAAE,SAAS,EACxB,MAAM,EAAE,EAAE,GACR,OAAO,CAAC,CAAC,SAAS,EAAE,sBAAsB,EAAE,sBAAsB,CAAC,CAAC;IAmB1D,gCAAgC,CAAC,KAAK,EAAE;QACpD,UAAU,EAAE,SAAS,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;IAMrB,mBAAmB,CAAC,KAAK,EAAE;QACvC,UAAU,EAAE,SAAS,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQP,uBAAuB,CAAC,KAAK,EAAE;QAC3C,UAAU,EAAE,SAAS,CAAC;QACtB,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;KACzC,GAAG,OAAO,CAAC,OAAO,CAAC;CA0BpB"}

package/lib/node/tokenFaucet.js

@@ -27,8 +27,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenFaucet = void 0;
-const anchor = __importStar(require("./isomorphic/anchor29"));
-const anchor29_1 = require("./isomorphic/anchor29");
+const anchor = __importStar(require("./isomorphic/anchor"));
+const anchor_1 = require("./isomorphic/anchor");
 const spl_token_1 = require("@solana/spl-token");
 const web3_js_1 = require("@solana/web3.js");
 const token_faucet_json_1 = __importDefault(require("./idl/token_faucet.json"));
@@ -40,11 +40,18 @@ class TokenFaucet {
         this.wallet = wallet;
         this.opts = opts || config_1.DEFAULT_CONFIRMATION_OPTS;
         // @ts-ignore
-        const provider = new anchor29_1.AnchorProvider(context ? context.connection.toConnection() : this.connection, 
+        const provider = new anchor_1.AnchorProvider(context ? context.connection.toConnection() : this.connection, 
         // @ts-ignore
         wallet, this.opts);
         this.provider = provider;
-        this.program = new anchor29_1.Program(token_faucet_json_1.default, programId, provider);
+        // Anchor (>= 0.30) reads the program id from `idl.address` rather than a
+        // constructor argument. Override it with the caller-provided `programId`
+        // so PDAs and instructions target the intended program.
+        const idl = {
+            ...token_faucet_json_1.default,
+            address: programId.toBase58(),
+        };
+        this.program = new anchor_1.Program(idl, provider);
         this.mint = mint;
     }
     async getFaucetConfigPublicKeyAndNonce() {