@velocity-exchange/sdk 0.0.1

package/lib/node/velocityClientConfig.d.ts

@@ -0,0 +1,85 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/**
+ * VelocityClientConfig — configuration types for constructing a {@link VelocityClient}.
+ *
+ * Key options: RPC connection, wallet/keypair, account subscription mode
+ * (WebSocket vs polling), oracle client selection, transaction sender config,
+ * and feature flags (activeSubAccountId, authority override).
+ */
+import { Commitment, ConfirmOptions, Connection, PublicKey, TransactionVersion } from '@solana/web3.js';
+import { IWallet, TxParams, UserAccount } from './types';
+import { OracleInfo } from './oracles/types';
+import { BulkAccountLoader } from './accounts/bulkAccountLoader';
+import { VelocityEnv } from './config';
+import { TxSender } from './tx/types';
+import { TxHandler, TxHandlerConfig } from './tx/txHandler';
+import { GrpcConfigs, ResubOpts, DelistedMarketSetting } from './accounts/types';
+import { Coder, Program } from './isomorphic/anchor';
+import { WebSocketAccountSubscriber } from './accounts/webSocketAccountSubscriber';
+import { WebSocketAccountSubscriberV2 } from './accounts/webSocketAccountSubscriberV2';
+import { grpcVelocityClientAccountSubscriberV2 } from './accounts/grpcVelocityClientAccountSubscriberV2';
+import { grpcVelocityClientAccountSubscriber } from './accounts/grpcVelocityClientAccountSubscriber';
+import { grpcMultiUserAccountSubscriber } from './accounts/grpcMultiUserAccountSubscriber';
+import { WebSocketProgramAccountSubscriber } from './accounts/webSocketProgramAccountSubscriber';
+import { WebSocketVelocityClientAccountSubscriber } from './accounts/webSocketVelocityClientAccountSubscriber';
+import { WebSocketVelocityClientAccountSubscriberV2 } from './accounts/webSocketVelocityClientAccountSubscriberV2';
+export type VelocityClientConfig = {
+    connection: Connection;
+    wallet: IWallet;
+    env?: VelocityEnv;
+    programID?: PublicKey;
+    accountSubscription?: VelocityClientSubscriptionConfig;
+    opts?: ConfirmOptions;
+    txSender?: TxSender;
+    txHandler?: TxHandler;
+    subAccountIds?: number[];
+    activeSubAccountId?: number;
+    perpMarketIndexes?: number[];
+    spotMarketIndexes?: number[];
+    /** @deprecated use marketLookupTables */
+    marketLookupTable?: PublicKey;
+    marketLookupTables?: PublicKey[];
+    oracleInfos?: OracleInfo[];
+    userStats?: boolean;
+    authority?: PublicKey;
+    includeDelegates?: boolean;
+    authoritySubAccountMap?: Map<string, number[]>;
+    skipLoadUsers?: boolean;
+    txVersion?: TransactionVersion;
+    txParams?: TxParams;
+    enableMetricsEvents?: boolean;
+    txHandlerConfig?: TxHandlerConfig;
+    delistedMarketSetting?: DelistedMarketSetting;
+    useHotWalletAdmin?: boolean;
+    coder?: Coder;
+};
+/** @deprecated Use `VelocityClientConfig` instead. `DriftClientConfig` will be removed in a future major. */
+export type DriftClientConfig = VelocityClientConfig;
+export type VelocityClientSubscriptionConfig = {
+    type: 'grpc';
+    grpcConfigs: GrpcConfigs;
+    resubTimeoutMs?: number;
+    logResubMessages?: boolean;
+    velocityClientAccountSubscriber?: new (grpcConfigs: GrpcConfigs, program: Program, perpMarketIndexes: number[], spotMarketIndexes: number[], oracleInfos: OracleInfo[], shouldFindAllMarketsAndOracles: boolean, delistedMarketSetting: DelistedMarketSetting) => grpcVelocityClientAccountSubscriberV2 | grpcVelocityClientAccountSubscriber;
+    /** @deprecated Use `velocityClientAccountSubscriber` instead. `driftClientAccountSubscriber` will be removed in a future major. */
+    driftClientAccountSubscriber?: new (grpcConfigs: GrpcConfigs, program: Program, perpMarketIndexes: number[], spotMarketIndexes: number[], oracleInfos: OracleInfo[], shouldFindAllMarketsAndOracles: boolean, delistedMarketSetting: DelistedMarketSetting) => grpcVelocityClientAccountSubscriberV2 | grpcVelocityClientAccountSubscriber;
+    grpcMultiUserAccountSubscriber?: grpcMultiUserAccountSubscriber;
+} | {
+    type: 'websocket';
+    resubTimeoutMs?: number;
+    logResubMessages?: boolean;
+    commitment?: Commitment;
+    programUserAccountSubscriber?: WebSocketProgramAccountSubscriber<UserAccount>;
+    perpMarketAccountSubscriber?: new (accountName: string, program: Program, accountPublicKey: PublicKey, decodeBuffer?: (buffer: Buffer) => any, resubOpts?: ResubOpts, commitment?: Commitment) => WebSocketAccountSubscriberV2<any> | WebSocketAccountSubscriber<any>;
+    /** If you use V2 here, whatever you pass for perpMarketAccountSubscriber will be ignored and it will use v2 under the hood regardless */
+    velocityClientAccountSubscriber?: new (program: Program, perpMarketIndexes: number[], spotMarketIndexes: number[], oracleInfos: OracleInfo[], shouldFindAllMarketsAndOracles: boolean, delistedMarketSetting: DelistedMarketSetting) => WebSocketVelocityClientAccountSubscriber | WebSocketVelocityClientAccountSubscriberV2;
+    /** @deprecated Use `velocityClientAccountSubscriber` instead. `driftClientAccountSubscriber` will be removed in a future major. */
+    driftClientAccountSubscriber?: new (program: Program, perpMarketIndexes: number[], spotMarketIndexes: number[], oracleInfos: OracleInfo[], shouldFindAllMarketsAndOracles: boolean, delistedMarketSetting: DelistedMarketSetting) => WebSocketVelocityClientAccountSubscriber | WebSocketVelocityClientAccountSubscriberV2;
+} | {
+    type: 'polling';
+    accountLoader: BulkAccountLoader;
+};
+/** @deprecated Use `VelocityClientSubscriptionConfig` instead. `DriftClientSubscriptionConfig` will be removed in a future major. */
+export type DriftClientSubscriptionConfig = VelocityClientSubscriptionConfig;
+//# sourceMappingURL=velocityClientConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"velocityClientConfig.d.ts","sourceRoot":"","sources":["../../src/velocityClientConfig.ts"],"names":[],"mappings":"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"}

package/lib/node/velocityClientConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/node/wallet.d.ts

@@ -0,0 +1,17 @@
+import { Keypair, PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
+import { IWallet, IVersionedWallet } from './types';
+export declare class Wallet implements IWallet, IVersionedWallet {
+    readonly payer: Keypair;
+    constructor(payer: Keypair);
+    signTransaction(tx: Transaction): Promise<Transaction>;
+    signVersionedTransaction(tx: VersionedTransaction): Promise<VersionedTransaction>;
+    signAllTransactions(txs: Transaction[]): Promise<Transaction[]>;
+    signAllVersionedTransactions(txs: VersionedTransaction[]): Promise<VersionedTransaction[]>;
+    get publicKey(): PublicKey;
+}
+export declare class WalletV2 extends Wallet {
+    readonly payer: Keypair;
+    constructor(payer: Keypair);
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+}
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,OAAO,EACP,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGpD,qBAAa,MAAO,YAAW,OAAO,EAAE,gBAAgB;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO;gBAAd,KAAK,EAAE,OAAO;IAE7B,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAKtD,wBAAwB,CAC7B,EAAE,EAAE,oBAAoB,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAK1B,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAO/D,4BAA4B,CACjC,GAAG,EAAE,oBAAoB,EAAE,GACzB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOlC,IAAI,SAAS,IAAI,SAAS,CAEzB;CACD;AAED,qBAAa,QAAS,SAAQ,MAAM;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO;gBAAd,KAAK,EAAE,OAAO;IAI7B,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAG3D"}

package/lib/node/wallet.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletV2 = exports.Wallet = void 0;
+const tweetnacl_1 = __importDefault(require("tweetnacl"));
+class Wallet {
+    constructor(payer) {
+        this.payer = payer;
+    }
+    async signTransaction(tx) {
+        tx.partialSign(this.payer);
+        return tx;
+    }
+    async signVersionedTransaction(tx) {
+        tx.sign([this.payer]);
+        return tx;
+    }
+    async signAllTransactions(txs) {
+        return txs.map((t) => {
+            t.partialSign(this.payer);
+            return t;
+        });
+    }
+    async signAllVersionedTransactions(txs) {
+        return txs.map((t) => {
+            t.sign([this.payer]);
+            return t;
+        });
+    }
+    get publicKey() {
+        return this.payer.publicKey;
+    }
+}
+exports.Wallet = Wallet;
+class WalletV2 extends Wallet {
+    constructor(payer) {
+        super(payer);
+        this.payer = payer;
+    }
+    async signMessage(message) {
+        return Buffer.from(tweetnacl_1.default.sign.detached(message, this.payer.secretKey));
+    }
+}
+exports.WalletV2 = WalletV2;

package/package.json

@@ -0,0 +1,157 @@
+{
+	"name": "@velocity-exchange/sdk",
+	"version": "0.0.1",
+	"main": "lib/node/index.js",
+	"types": "lib/node/index.d.ts",
+	"module": "./lib/browser/index.js",
+	"author": "crispheaney",
+	"homepage": "https://www.drift.trade/",
+	"repository": {
+		"type": "git",
+		"url": "git@github.com:drift-labs/protocol-v2.git"
+	},
+	"scripts": {
+		"lint": "eslint './**/*.{ts,tsx}' --quiet --format unix",
+		"build": "bun run clean && tsc -p tsconfig.json && tsc -p tsconfig.browser.json && node scripts/postbuild.js",
+		"build:browser": "bun run clean && tsc -p tsconfig.json && tsc -p tsconfig.browser.json && node scripts/postbuild.js --force-env browser",
+		"build:minify": "node build-browser.js",
+		"clean": "rm -rf lib",
+		"test": "mocha -r ts-node/register tests/**/*.ts --ignore 'tests/dlob/**/*.ts'",
+		"test:match": "mocha -r ts-node/register --ignore 'tests/dlob/**/*.ts'",
+		"test:inspect": "mocha --inspect-brk -r ts-node/register tests/**/*.ts",
+		"test:bignum": "mocha -r ts-node/register tests/bn/**/*.ts",
+		"test:ci": "mocha -r ts-node/register tests/ci/**/*.ts",
+		"test:dlob": "mocha -r ts-node/register tests/dlob/**/*.ts",
+		"test:events": "mocha -r ts-node/register tests/events/**/*.ts",
+		"test:driftcore": "bun test tests/DriftCore",
+		"patch-and-pub": "npm version patch --force && npm publish",
+		"prettify": "prettier --check './src/***/*.ts'",
+		"prettify:fix": "prettier --write './{src,tests}/***/*.ts'",
+		"version": "node ./scripts/updateVersion.js",
+		"circular-deps": "bunx madge --circular --circular --extensions ts src"
+	},
+	"keywords": [
+		"drift-labs",
+		"drift",
+		"perps",
+		"velocity",
+		"velocity-exchange"
+	],
+	"license": "Apache-2.0",
+	"directories": {
+		"lib": "lib"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"dependencies": {
+		"@anchor-lang/core": "1.0.1",
+		"@coral-xyz/anchor": "npm:@anchor-lang/core@1.0.1",
+		"@coral-xyz/anchor-29": "npm:@coral-xyz/anchor@0.29.0",
+		"@msgpack/msgpack": "3.1.2",
+		"@pythnetwork/client": "2.5.3",
+		"@pythnetwork/price-service-sdk": "1.7.1",
+		"@pythnetwork/pyth-lazer-sdk": "6.0.0",
+		"@solana/spl-token": "0.4.13",
+		"@solana/web3.js": "1.98.0",
+		"@triton-one/yellowstone-grpc": "5.0.5",
+		"anchor-bankrun": "0.5.0",
+		"gill": "0.10.2",
+		"nanoid": "3.3.4",
+		"node-cache": "5.1.2",
+		"solana-bankrun": "0.4.0",
+		"strict-event-emitter-types": "2.0.0",
+		"tweetnacl": "1.0.3",
+		"tweetnacl-util": "0.15.1",
+		"uuid": "8.3.2",
+		"yargs": "17.7.2",
+		"zod": "4.0.17",
+		"zstddec": "0.1.0"
+	},
+	"optionalDependencies": {
+		"helius-laserstream": "0.1.8"
+	},
+	"devDependencies": {
+		"@types/big.js": "6.2.2",
+		"@types/bn.js": "5.1.6",
+		"@types/bs58": "4.0.4",
+		"@types/chai": "4.3.20",
+		"@types/jest": "28.1.8",
+		"@types/mocha": "9.1.1",
+		"@typescript-eslint/eslint-plugin": "6.21.0",
+		"@typescript-eslint/parser": "6.21.0",
+		"chai": "4.5.0",
+		"crypto-browserify": "3.12.1",
+		"encoding": "0.1.13",
+		"esbuild": "0.27.1",
+		"eslint": "8.57.0",
+		"eslint-config-prettier": "8.3.0",
+		"eslint-plugin-prettier": "3.4.0",
+		"lodash": "4.17.21",
+		"madge": "8.0.0",
+		"mocha": "10.7.3",
+		"object-sizeof": "2.6.5",
+		"os-browserify": "0.3.0",
+		"path-browserify": "1.0.1",
+		"prettier": "3.0.1",
+		"process": "0.11.10",
+		"sinon": "18.0.1",
+		"stream-browserify": "3.0.0",
+		"ts-node": "10.9.2",
+		"typescript": "5.4.5",
+		"vm-browserify": "1.1.2"
+	},
+	"description": "SDK for Drift Protocol",
+	"engines": {
+		"node": "24.15.0"
+	},
+	"resolutions": {
+		"@solana/web3.js": "1.98.0",
+		"@solana/errors": "2.0.0-preview.4",
+		"@solana/codecs-data-structures": "2.0.0-preview.4",
+		"chalk": "4.1.2",
+		"debug": "<4.4.2",
+		"ansi-styles": "4.3.0",
+		"supports-color": "7.2.0",
+		"strip-ansi": "6.0.1",
+		"ansi-regex": "5.0.1",
+		"wrap-ansi": "7.0.0",
+		"color-convert": "<3.1.1",
+		"color-name": "<2.0.1",
+		"color-string": "<2.1.1",
+		"simple-swizzle": "<0.2.3",
+		"is-arrayish": "<0.3.3",
+		"slice-ansi": "3.0.0",
+		"error-ex": "<1.3.3",
+		"backslash": "<0.2.1",
+		"chalk-template": "<0.4.0",
+		"supports-hyperlinks": "<4.1.1",
+		"has-ansi": "<6.0.1"
+	},
+	"overrides": {
+		"chalk": "4.1.2",
+		"debug": "<4.4.2",
+		"ansi-styles": "4.3.0",
+		"supports-color": "7.2.0",
+		"strip-ansi": "6.0.1",
+		"ansi-regex": "5.0.1",
+		"wrap-ansi": "7.0.0",
+		"color-convert": "<3.1.1",
+		"color-name": "<2.0.1",
+		"color-string": "<2.1.1",
+		"simple-swizzle": "<0.2.3",
+		"is-arrayish": "<0.3.3",
+		"slice-ansi": "3.0.0",
+		"error-ex": "<1.3.3",
+		"backslash": "<0.2.1",
+		"chalk-template": "<1.1.1",
+		"supports-hyperlinks": "<4.1.1",
+		"has-ansi": "<6.0.1"
+	},
+	"browser": {
+		"@grpc/grpc-js": false,
+		"@triton-one/yellowstone-grpc": false,
+		"helius-laserstream": false,
+		"zstddec": false
+	}
+}

package/scripts/deposit-isolated-positions.ts

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

package/scripts/find-flagged-users.ts

@@ -0,0 +1,213 @@
+import { Connection, Keypair, PublicKey } from '@solana/web3.js';
+import dotenv from 'dotenv';
+import {
+	VelocityClient,
+	VelocityClientConfig,
+	Wallet,
+	UserMap,
+	VELOCITY_PROGRAM_ID,
+	getMarketsAndOraclesForSubscription,
+	BulkAccountLoader,
+	BN,
+	PerpPosition,
+} from '../src';
+import { TransactionSignature } from '@solana/web3.js';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+async function main() {
+	dotenv.config({ path: '../' });
+	// Simple CLI parsing
+	interface CliOptions {
+		mode: 'list' | 'one' | 'all';
+		targetUser?: string;
+	}
+
+	function parseCliArgs(): CliOptions {
+		const args = process.argv.slice(2);
+		let mode: CliOptions['mode'] = 'list';
+		let targetUser: string | undefined = undefined;
+		for (let i = 0; i < args.length; i++) {
+			const arg = args[i];
+			if (arg === '--mode' && i + 1 < args.length) {
+				const next = args[i + 1] as CliOptions['mode'];
+				if (next === 'list' || next === 'one' || next === 'all') {
+					mode = next;
+				}
+				i++;
+			} else if ((arg === '--user' || arg === '--target') && i + 1 < args.length) {
+				targetUser = args[i + 1];
+				i++;
+			}
+		}
+		return { mode, targetUser };
+	}
+
+	const { mode, targetUser } = parseCliArgs();
+
+	const RPC_ENDPOINT =
+		process.env.RPC_ENDPOINT ?? 'https://api.mainnet-beta.solana.com';
+
+	const connection = new Connection(RPC_ENDPOINT);
+	const keypairPath =
+		process.env.SOLANA_KEYPAIR ??
+		path.join(os.homedir(), '.config', 'solana', 'id.json');
+	const secret = JSON.parse(fs.readFileSync(keypairPath, 'utf-8')) as number[];
+	const wallet = new Wallet(Keypair.fromSecretKey(Uint8Array.from(secret)));
+
+	const { perpMarketIndexes, spotMarketIndexes, oracleInfos } =
+		getMarketsAndOraclesForSubscription('mainnet-beta');
+
+		const accountLoader = new BulkAccountLoader(connection, 'confirmed', 60_000);
+
+	const clientConfig: VelocityClientConfig = {
+		connection,
+		wallet,
+		programID: new PublicKey(VELOCITY_PROGRAM_ID),
+		accountSubscription: {
+			type: 'polling',
+			accountLoader,
+		},
+		perpMarketIndexes,
+		spotMarketIndexes,
+		oracleInfos,
+		env: 'mainnet-beta',
+	};
+
+	const client = new VelocityClient(clientConfig);
+	await client.subscribe();
+
+	const userMap = new UserMap({
+		driftClient: client,
+		subscriptionConfig: {
+			type: 'polling',
+			frequency: 60_000,
+			commitment: 'confirmed',
+		},
+		includeIdle: false,
+		syncConfig: { type: 'paginated' },
+		throwOnFailedSync: false,
+	});
+	await userMap.subscribe();
+
+
+	const flaggedUsers: Array<{
+		userPubkey: string;
+		authority: string;
+		flags: Array<{ marketIndex: number; flag: number; isolatedPositionScaledBalance: BN }>;
+	}> = [];
+
+	console.log(`User map size: ${Array.from(userMap.entries()).length}`);
+
+	for (const [userPubkey, user] of userMap.entries()) {
+		const userAccount = user.getUserAccount();
+		const flaggedPositions = userAccount.perpPositions
+			.filter((p) => p.positionFlag >= 1 || p.isolatedPositionScaledBalance.toString() !== '0')
+			.map((p) => ({ marketIndex: p.marketIndex, flag: p.positionFlag, isolatedPositionScaledBalance: p.isolatedPositionScaledBalance, fullPosition: p }));
+
+		if (flaggedPositions.length > 0) {
+			if(mode === 'one' && userPubkey === targetUser) {
+				console.log(`flagged positions on user ${userPubkey}`);
+				console.log(flaggedPositions.map((p) => `mkt=${p.marketIndex}, flag=${p.flag}, isolatedPositionScaledBalance=${p.isolatedPositionScaledBalance.toString()}, fullPosition=${fullLogPerpPosition(p.fullPosition)}`).join('\n\n; '));
+			}
+			flaggedUsers.push({
+				userPubkey,
+				authority: userAccount.authority.toBase58(),
+				flags: flaggedPositions,
+			});
+		}
+	}
+
+	// Mode 1: list flagged users (default)
+	if (mode === 'list') {
+		console.log(`Flagged users (positionFlag >= 1 || isolatedPositionScaledBalance > 0): ${flaggedUsers.length}`);
+		for (const u of flaggedUsers) {
+			const flagsStr = u.flags
+				.map((f) => `mkt=${f.marketIndex}, flag=${f.flag}, isolatedPositionScaledBalance=${f.isolatedPositionScaledBalance.toString()}`)
+				.join('; ');
+			console.log(
+				`- authority=${u.authority} userAccount=${u.userPubkey} -> [${flagsStr}]`
+			);
+		}
+	}
+
+	// Helper to invoke updateUserIdle
+	async function updateUserIdleFor(userAccountPubkeyStr: string): Promise<TransactionSignature | undefined> {
+		const userObj = userMap.get(userAccountPubkeyStr);
+		if (!userObj) {
+			console.warn(`User ${userAccountPubkeyStr} not found in userMap`);
+			return undefined;
+		}
+		try {
+			const sig = await client.updateUserIdle(
+				new PublicKey(userAccountPubkeyStr),
+				userObj.getUserAccount()
+			);
+			console.log(`updateUserIdle sent for userAccount=${userAccountPubkeyStr} -> tx=${sig}`);
+			return sig;
+		} catch (e) {
+			console.error(`Failed updateUserIdle for userAccount=${userAccountPubkeyStr}`, e);
+			return undefined;
+		}
+	}
+
+	// Mode 2: updateUserIdle on a single flagged user
+	if (mode === 'one') {
+		if (flaggedUsers.length === 0) {
+			console.log('No flagged users to update.');
+		} else {
+			const chosen =
+				(targetUser && flaggedUsers.find((u) => u.userPubkey === targetUser)) ||
+				flaggedUsers[0];
+			console.log(
+				`Updating single flagged userAccount=${chosen.userPubkey} authority=${chosen.authority}`
+			);
+			await updateUserIdleFor(chosen.userPubkey);
+		}
+	}
+
+	// Mode 3: updateUserIdle on all flagged users
+	if (mode === 'all') {
+		if (flaggedUsers.length === 0) {
+			console.log('No flagged users to update.');
+		} else {
+			console.log(`Updating all ${flaggedUsers.length} flagged users...`);
+			for (const u of flaggedUsers) {
+				await updateUserIdleFor(u.userPubkey);
+			}
+			console.log('Finished updating all flagged users.');
+		}
+	}
+
+	await userMap.unsubscribe();
+	await client.unsubscribe();
+}
+
+main().catch((e) => {
+	console.error(e);
+	process.exit(1);
+});
+
+
+function fullLogPerpPosition(position: PerpPosition) {
+
+	return `
+	[PERP POSITION]
+	baseAssetAmount=${position.baseAssetAmount.toString()}
+	quoteAssetAmount=${position.quoteAssetAmount.toString()}
+	quoteBreakEvenAmount=${position.quoteBreakEvenAmount.toString()}
+	quoteEntryAmount=${position.quoteEntryAmount.toString()}
+	openBids=${position.openBids.toString()}
+	openAsks=${position.openAsks.toString()}
+	settledPnl=${position.settledPnl.toString()}
+	remainderBaseAssetAmount=${position.remainderBaseAssetAmount}
+	maxMarginRatio=${position.maxMarginRatio}
+	marketIndex=${position.marketIndex}
+	openOrders=${position.openOrders}
+	positionFlag=${position.positionFlag}
+	isolatedPositionScaledBalance=${position.isolatedPositionScaledBalance.toString()}
+	`;
+
+}
+