@velocity-exchange/sdk 0.3.0 → 0.6.0

package/lib/node/wallet.d.ts

@@ -1,17 +1,54 @@
 import { Keypair, PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
 import { IWallet, IVersionedWallet } from './types';
+/**
+ * Local-keypair implementation of `IWallet`/`IVersionedWallet` that signs directly with an
+ * in-memory `Keypair` (no external wallet/RPC round-trip). Suitable for keeper bots, scripts, and
+ * tests; not for browser dapps holding user funds.
+ */
 export declare class Wallet implements IWallet, IVersionedWallet {
     readonly payer: Keypair;
     constructor(payer: Keypair);
+    /**
+     * Partially signs a legacy `Transaction` with this wallet's keypair, leaving any other
+     * required signatures untouched.
+     * @param tx - Transaction to sign; mutated in place.
+     * @returns The same transaction instance, now signed by `payer`.
+     */
     signTransaction(tx: Transaction): Promise<Transaction>;
+    /**
+     * Signs a `VersionedTransaction` with this wallet's keypair.
+     * @param tx - Transaction to sign; mutated in place.
+     * @returns The same transaction instance, now signed by `payer`.
+     */
     signVersionedTransaction(tx: VersionedTransaction): Promise<VersionedTransaction>;
+    /**
+     * Partially signs a batch of legacy `Transaction`s with this wallet's keypair.
+     * @param txs - Transactions to sign; each is mutated in place.
+     * @returns The same transaction instances, now signed by `payer`.
+     */
     signAllTransactions(txs: Transaction[]): Promise<Transaction[]>;
+    /**
+     * Signs a batch of `VersionedTransaction`s with this wallet's keypair.
+     * @param txs - Transactions to sign; each is mutated in place.
+     * @returns The same transaction instances, now signed by `payer`.
+     */
     signAllVersionedTransactions(txs: VersionedTransaction[]): Promise<VersionedTransaction[]>;
+    /** The wallet's public key, i.e. `payer.publicKey`. */
     get publicKey(): PublicKey;
 }
+/**
+ * `Wallet` variant that additionally supports raw message signing (`signMessage`), needed for
+ * flows like swift/signed-message orders that sign an ed25519 payload outside of a transaction.
+ */
 export declare class WalletV2 extends Wallet {
     readonly payer: Keypair;
     constructor(payer: Keypair);
+    /**
+     * Signs an arbitrary message with this wallet's ed25519 secret key (detached signature, not a
+     * transaction).
+     * @param message - Raw bytes to sign.
+     * @returns The 64-byte detached ed25519 signature.
+     */
     signMessage(message: Uint8Array): Promise<Uint8Array>;
 }
 //# sourceMappingURL=wallet.d.ts.map

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

@@ -1 +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"}
+{"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;;;;GAIG;AACH,qBAAa,MAAO,YAAW,OAAO,EAAE,gBAAgB;IAC3C,QAAQ,CAAC,KAAK,EAAE,OAAO;gBAAd,KAAK,EAAE,OAAO;IAEnC;;;;;OAKG;IACG,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAK5D;;;;OAIG;IACG,wBAAwB,CAC7B,EAAE,EAAE,oBAAoB,GACtB,OAAO,CAAC,oBAAoB,CAAC;IAKhC;;;;OAIG;IACG,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAOrE;;;;OAIG;IACG,4BAA4B,CACjC,GAAG,EAAE,oBAAoB,EAAE,GACzB,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOlC,uDAAuD;IACvD,IAAI,SAAS,IAAI,SAAS,CAEzB;CACD;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,MAAM;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO;gBAAd,KAAK,EAAE,OAAO;IAInC;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAG3D"}

package/lib/node/wallet.js

@@ -5,40 +5,77 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WalletV2 = exports.Wallet = void 0;
 const tweetnacl_1 = __importDefault(require("tweetnacl"));
+/**
+ * Local-keypair implementation of `IWallet`/`IVersionedWallet` that signs directly with an
+ * in-memory `Keypair` (no external wallet/RPC round-trip). Suitable for keeper bots, scripts, and
+ * tests; not for browser dapps holding user funds.
+ */
 class Wallet {
     constructor(payer) {
         this.payer = payer;
     }
+    /**
+     * Partially signs a legacy `Transaction` with this wallet's keypair, leaving any other
+     * required signatures untouched.
+     * @param tx - Transaction to sign; mutated in place.
+     * @returns The same transaction instance, now signed by `payer`.
+     */
     async signTransaction(tx) {
         tx.partialSign(this.payer);
         return tx;
     }
+    /**
+     * Signs a `VersionedTransaction` with this wallet's keypair.
+     * @param tx - Transaction to sign; mutated in place.
+     * @returns The same transaction instance, now signed by `payer`.
+     */
     async signVersionedTransaction(tx) {
         tx.sign([this.payer]);
         return tx;
     }
+    /**
+     * Partially signs a batch of legacy `Transaction`s with this wallet's keypair.
+     * @param txs - Transactions to sign; each is mutated in place.
+     * @returns The same transaction instances, now signed by `payer`.
+     */
     async signAllTransactions(txs) {
         return txs.map((t) => {
             t.partialSign(this.payer);
             return t;
         });
     }
+    /**
+     * Signs a batch of `VersionedTransaction`s with this wallet's keypair.
+     * @param txs - Transactions to sign; each is mutated in place.
+     * @returns The same transaction instances, now signed by `payer`.
+     */
     async signAllVersionedTransactions(txs) {
         return txs.map((t) => {
             t.sign([this.payer]);
             return t;
         });
     }
+    /** The wallet's public key, i.e. `payer.publicKey`. */
     get publicKey() {
         return this.payer.publicKey;
     }
 }
 exports.Wallet = Wallet;
+/**
+ * `Wallet` variant that additionally supports raw message signing (`signMessage`), needed for
+ * flows like swift/signed-message orders that sign an ed25519 payload outside of a transaction.
+ */
 class WalletV2 extends Wallet {
     constructor(payer) {
         super(payer);
         this.payer = payer;
     }
+    /**
+     * Signs an arbitrary message with this wallet's ed25519 secret key (detached signature, not a
+     * transaction).
+     * @param message - Raw bytes to sign.
+     * @returns The 64-byte detached ed25519 signature.
+     */
     async signMessage(message) {
         return Buffer.from(tweetnacl_1.default.sign.detached(message, this.payer.secretKey));
     }

package/package.json

@@ -1,12 +1,16 @@
 {
 	"name": "@velocity-exchange/sdk",
-	"version": "0.3.0",
+	"version": "0.6.0",
 	"main": "lib/node/index.js",
 	"types": "lib/node/index.d.ts",
 	"module": "./lib/browser/index.js",
+	"files": [
+		"lib"
+	],
 	"repository": {
 		"type": "git",
-		"url": "git@github.com:velocity-exchange/velocity-v1.git"
+		"url": "git+https://github.com/velocity-exchange/velocity-v1.git",
+		"directory": "packages/sdk"
 	},
 	"scripts": {
 		"lint": "eslint './**/*.{ts,tsx}' --quiet --format unix",
@@ -19,6 +23,7 @@
 		"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:parity": "mocha -r ts-node/register 'tests/sdkParity/**/*.ts' 'tests/oracles/**/*.ts' 'tests/amm/**/*.ts' 'tests/builder/**/*.ts' 'tests/liquidation/**/*.ts' 'tests/exchangeStatus/**/*.ts' 'tests/spot/**/*.ts' 'tests/user/**/*.ts' tests/dlob/tickSizeStandardization.ts",
 		"test:dlob": "mocha -r ts-node/register tests/dlob/**/*.ts",
 		"test:events": "mocha -r ts-node/register tests/events/**/*.ts",
 		"test:velocitycore": "bun test tests/VelocityCore",
@@ -110,7 +115,7 @@
 	},
 	"description": "SDK for Velocity Protocol",
 	"engines": {
-		"node": "^24.0.0"
+		"node": ">=20"
 	},
 	"resolutions": {
 		"@solana/web3.js": "1.98.0",

package/.prettierignore

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

package/CHANGELOG.md

@@ -1,81 +0,0 @@
-# @velocity-exchange/sdk
-
-## 0.3.0
-
-### Minor Changes
-
-- [#172](https://github.com/velocity-exchange/velocity-v1/pull/172) [`b7d15b9`](https://github.com/velocity-exchange/velocity-v1/commit/b7d15b970a74d267aeaf20bb644d5344b9aadc61) Thanks [@0xahzam](https://github.com/0xahzam)! - Decouple solvency-repair from the withdraw pause. The `resolve_perp_pnl_deficit`,
-  `resolve_perp_bankruptcy`, and `resolve_spot_bankruptcy` instructions are now gated by a
-  new `State.solvencyStatus` bitfield instead of `WithdrawPaused`, so user withdrawals can
-  be halted while solvency repair keeps running (or repair can be frozen on its own). Adds
-  the `SolvencyStatus` enum, `StateAccount.solvencyStatus`, a `solvencyRepairPaused()`
-  helper, `AdminClient.updateSolvencyStatus`, and the `exchange set-solvency-status` admin
-  CLI command.
-
-- [#141](https://github.com/velocity-exchange/velocity-v1/pull/141) [`3f148f8`](https://github.com/velocity-exchange/velocity-v1/commit/3f148f8b477e4176e11e0660adb0e67dd5163d3b) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Harden the native fast-path admin handlers. The
-  `update_amm_spread_adjustment_native` instruction now requires the program
-  `State` account: `getUpdateAmmSpreadAdjustmentNativeIx` is now **async** and
-  returns a `Promise<TransactionInstruction>` (it derives and appends the state
-  account), and its compute-unit budget was raised to cover the on-chain account
-  validation. Direct callers must `await` the builder. Two new program error
-  codes are surfaced in the IDL: `InvalidNativeStateAccount` (6355) and
-  `InvalidNativePerpMarketAccount` (6356).
-
-### Patch Changes
-
-- [#173](https://github.com/velocity-exchange/velocity-v1/pull/173) [`2f6c64d`](https://github.com/velocity-exchange/velocity-v1/commit/2f6c64d54f1146d8e7f9ee4ab556929c6bf8b920) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Fix stale `User` account byte offsets in `memcmp` filters and `OrderSubscriber`.
-
-  The Velocity `User` account is 4496 bytes, but the memcmp filters and the
-  `OrderSubscriber` staleness check still used offsets from the older 4376-byte
-  layout. As a result `getUserWithOrderFilter()` matched zero accounts, so any
-  consumer that bulk-loads users-with-orders (e.g. the DLOB server's
-  `OrderSubscriber.fetch()`) loaded no orders and produced an empty order book
-  (vAMM-only L2, empty L3). Offsets for `idle`, `hasOpenOrder`, `hasOpenAuction`,
-  `poolId`, and `lastActiveSlot` are corrected to match the on-chain layout.
-
-## 0.2.6
-
-### Patch Changes
-
-- [#156](https://github.com/velocity-exchange/velocity-v1/pull/156) [`d3b58ab`](https://github.com/velocity-exchange/velocity-v1/commit/d3b58ab7e3ad33f0e6634ff87e9b150915b3aa13) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Fix account decoder to pass account names as-is instead of capitalizing them. The
-  Anchor v1 IDL program constructor already camelCases account names, so the extra
-  `capitalize()` call was incorrect and caused decoding failures in the gRPC and
-  WebSocket subscribers.
-
-## 0.2.5
-
-### Patch Changes
-
-- [#155](https://github.com/velocity-exchange/velocity-v1/pull/155) [`15073bc`](https://github.com/velocity-exchange/velocity-v1/commit/15073bc0b740b2d1cad471126a00368e72655bd5) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Make the `UserAccountSubscriber` "not subscribed" contract consistent and fix a
-  misleading error message. `getUserAccountAndSlot()` now throws `NotSubscribedError`
-  when called before `subscribe()` on the gRPC-multi and WebSocket-program subscribers
-  too (the WebSocket and polling subscribers already did) — so `User.getUserAccount()`
-  uniformly throws when not subscribed and returns `undefined` only when subscribed but
-  the account was not found on chain. `getUserAccountOrThrow()` /
-  `getUserAccountAndSlotOrThrow()` now throw `User account not found: <pubkey>` (was
-  `User account not loaded`), since after `subscribe()` resolves a missing account means
-  "not found", not "still loading".
-
-## 0.2.4
-
-### Patch Changes
-
-- [#127](https://github.com/velocity-exchange/velocity-v1/pull/127) [`4f8e7aa`](https://github.com/velocity-exchange/velocity-v1/commit/4f8e7aaef0e35b190fc0b91cd29314d902d1ccab) Thanks [@ChesterSim](https://github.com/ChesterSim)! - reflect Typescript types on IDL changes
-
-## 0.2.3
-
-### Patch Changes
-
-- [#100](https://github.com/velocity-exchange/velocity-v1/pull/100) [`ae78769`](https://github.com/velocity-exchange/velocity-v1/commit/ae78769ef58355202c030435c2796ef045fe30a0) Thanks [@ChesterSim](https://github.com/ChesterSim)! - add back ForwardOnlyTxSender and calculateMaxRemainingDeposit
-
-## 0.2.2
-
-### Patch Changes
-
-- [#97](https://github.com/velocity-exchange/velocity-v1/pull/97) [`022a949`](https://github.com/velocity-exchange/velocity-v1/commit/022a949cb1802171ca57a61260f86c8908f94f34) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Re-export `PriceUpdateAccount` from the package root and declare `@types/node` as a devDependency (fixes the SDK build under isolated installs). Enables downstream apps (dlob-server, keeper-bots-v2) to consume the velocity SDK without reaching into subpaths.
-
-## 0.2.1
-
-### Patch Changes
-
-- [`4fd7462`](https://github.com/velocity-exchange/velocity-v1/commit/4fd7462bfa3c55e31e3457b1b65f519cf052a6fa) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Testing new changelog based package publishing flow

package/build-browser.js

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

package/bunfig.toml

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

package/esbuild-shims.js

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

package/scripts/deposit-isolated-positions.ts

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

package/scripts/find-flagged-users.ts

@@ -1,213 +0,0 @@
-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({
-		velocityClient: 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()}
-	`;
-
-}
-