@velocity-exchange/sdk 0.4.0 → 0.6.1

package/CHANGELOG.md

@@ -1,132 +0,0 @@
-# @velocity-exchange/sdk
-
-## 0.4.0
-
-### Minor Changes
-
-- [#197](https://github.com/velocity-exchange/velocity-v1/pull/197) [`900c07d`](https://github.com/velocity-exchange/velocity-v1/commit/900c07d9da7e106c82fbe65b3d92226d090bdee9) Thanks [@jordy25519](https://github.com/jordy25519)! - Attach the taker's `RevenueShareEscrow` on perp fills for referred takers. `getFillPerpOrderIx` gains an optional `takerIsReferred` flag; when set (or when the order carries a builder code) the deterministic escrow PDA is added to the fill. This mirrors the on-chain fill gate, which reads `UserStats.referrerStatus` (the `BuilderReferral` bit), so referred takers' fills no longer revert with `UnableToLoadRevenueShareAccount`. `ReferrerMap` gains `isBuilderReferral(authority)` and `mustGetIsBuilderReferral(authority)`, sourcing the bit from the UserStats fetch it already performs.
-
-- [#189](https://github.com/velocity-exchange/velocity-v1/pull/189) [`8df28ac`](https://github.com/velocity-exchange/velocity-v1/commit/8df28ac6d113760ae4a8cdff4ad438cb25efce2c) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Program↔SDK parity fixes from the 2026-07-02 audit: renamed deprecated Switchboard
-  OracleSource keys to match the IDL (fixes a decode crash on affected markets), applied
-  the $100 initial-margin unrealized-PnL cap, standardized auction/limit prices to order
-  tick size across the DLOB, isolated-position handling in bankruptcy/liquidation math,
-  corrected MM-oracle validity gating, referrer_status memcmp offset, PerpOperation and
-  OrderBitFlag bit values, wired five missing event records into EventSubscriber, fixed
-  withdraw-limit divisors, multi-pool margin segregation, referee/builder fee estimation,
-  and added AdminClient.updatePauseAdmin plus admin CLI commands for pause-admin rotation
-  and fee-pool transfers. Also fixed withdrawFromIsolatedPerpPosition's withdraw-all path:
-  it substituted the MIN_I64 sentinel into the instruction's unsigned u64 amount (serializing
-  as 2^63, so full withdrawals always failed on-chain with InsufficientCollateral); it now
-  clamps the request to the position's deposit plus claimable PnL.
-
-  Follow-up completeness fixes: DLOBSubscriber.getL2/getL3 (and the dlob-server publisher) now
-  thread orderTickSize so the public book view is tick-standardized like on-chain; added
-  hasIsolatedMarginBankrupt and wired isolated-only bankruptcy detection into keeper resolution
-  (isIsolatedPositionBankrupt now guards against non-isolated indices); getMarketFees applies the
-  referee discount and calculateFeeForQuoteAmount accepts builder params so both public fee-prediction
-  entry points match on-chain; and isFallbackAvailableLiquiditySource now fully mirrors
-  amm_fill_gates_ok, adding the market-drawdown and MM-vs-exchange oracle volatility gates.
-
-  Low-risk parity follow-ups: MarginCategory now includes 'Fill' as a single shared type, handled
-  across perp margin ratio / unrealized-asset-weight and spot asset/liability weights (the
-  integer-averaged midpoint of initial and maintenance, mirroring get_margin_ratio /
-  get_asset_weight / get_liability_weight) instead of throwing or returning undefined; the
-  worst-tier taker-fee estimate in calculateEntriesEffectOnFreeCollateral now ceil-divides to match
-  calculate_taker_fee; MM-oracle validity is computed with the raw exchange confidence (matching
-  get_mm_oracle_price_data) while the returned MM price keeps its diff-adjusted confidence; and
-  corrected the OracleSourceNum doc (it is an SDK-internal oracle-id encoding, not the on-chain
-  Borsh discriminant).
-
-  Visible/breaking API changes in this release: `OracleSource.SWITCHBOARD` /
-  `OracleSource.SWITCHBOARD_ON_DEMAND` (and the corresponding `OracleSourceNum` entries) are renamed
-  to `DEPRECATED_SWITCHBOARD` / `DEPRECATED_SWITCHBOARD_ON_DEMAND` with no aliases kept for the old
-  names; `ContractType.FUTURE` is renamed to `DEPRECATED_FUTURE`; and `FeatureBitFlags.BUILDER_REFERRAL`
-  is removed outright, since no such on-chain flag exists. Separately, `getLimitPrice` gained a new
-  optional trailing `tickSize` parameter — the existing `fallbackPrice` parameter stays in its original
-  4th position, so old 4-argument call sites keep working unchanged.
-
-### Patch Changes
-
-- [#199](https://github.com/velocity-exchange/velocity-v1/pull/199) [`dff8a47`](https://github.com/velocity-exchange/velocity-v1/commit/dff8a4754f6b736fed330b2ab4fa5685db4f8159) Thanks [@jordy25519](https://github.com/jordy25519)! - Add BTC-PERP (index 1) and ETH-PERP (index 2) to `DevnetPerpMarkets`, reflecting the two Pyth-Lazer perp markets re-created on devnet. ETH-PERP uses lazer feed 2 (real ETH price feed).
-
-- [#193](https://github.com/velocity-exchange/velocity-v1/pull/193) [`bafd699`](https://github.com/velocity-exchange/velocity-v1/commit/bafd6990f8322f232d2f0d17042beb0e9c567164) Thanks [@jordy25519](https://github.com/jordy25519)! - Remove the stale `FettyRIP` (marketIndex 2) entry from `DevnetPerpMarkets`. That perp market was deleted on-chain, but the hand-maintained devnet config still listed it, so consumers that enumerate all perp markets (keeper-bots-v2, dlob-server) crashed with `Perp market config for 2 not found` when resolving the nonexistent market. The devnet config now mirrors on-chain state (SOL-PERP at index 0 only).
-
-## 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()}
-	`;
-
-}
-