solforge 0.2.4 → 0.2.6

package/server/rpc-server.ts

@@ -35,8 +35,8 @@ export class LiteSVMRpcServer {
 			blockTime?: number;
 			preBalances?: number[];
 			postBalances?: number[];
-			preTokenBalances?: any[];
-			postTokenBalances?: any[];
+			preTokenBalances?: unknown[];
+			postTokenBalances?: unknown[];
 		}
 	> = new Map();
 	private store: TxStore;
@@ -95,7 +95,7 @@ export class LiteSVMRpcServer {
 
 	private createSuccessResponse(
 		id: string | number,
-		result: any,
+		result: unknown,
 	): JsonRpcResponse {
 		return {
 			jsonrpc: "2.0",
@@ -108,7 +108,7 @@ export class LiteSVMRpcServer {
 		id: string | number,
 		code: number,
 		message: string,
-		data?: any,
+		data?: unknown,
 	): JsonRpcResponse {
 		return {
 			jsonrpc: "2.0",
@@ -132,7 +132,7 @@ export class LiteSVMRpcServer {
 			},
 			getFaucet: () => this.faucet,
 			getTxCount: () => this.txCount,
-			registerMint: (mint: any) => {
+			registerMint: (mint: PublicKey | string) => {
 				try {
 					const pk =
 						typeof mint === "string" ? mint : new PublicKey(mint).toBase58();
@@ -140,7 +140,7 @@ export class LiteSVMRpcServer {
 				} catch {}
 			},
 			listMints: () => Array.from(this.knownMints),
-			registerProgram: (program: any) => {
+			registerProgram: (program: PublicKey | string) => {
 				try {
 					const pk =
 						typeof program === "string"
@@ -160,19 +160,30 @@ export class LiteSVMRpcServer {
 					blockTime: meta?.blockTime,
 					preBalances: meta?.preBalances,
 					postBalances: meta?.postBalances,
-					preTokenBalances: (meta as any)?.preTokenBalances,
-					postTokenBalances: (meta as any)?.postTokenBalances,
+					preTokenBalances: (
+						meta as { preTokenBalances?: unknown[] } | undefined
+					)?.preTokenBalances,
+					postTokenBalances: (
+						meta as { postTokenBalances?: unknown[] } | undefined
+					)?.postTokenBalances,
 				});
 
 				// Persist to SQLite for durability and history queries
 				try {
-					const msg: any = tx.message as any;
-					const rawKeys: any[] = Array.isArray(msg.staticAccountKeys)
+					const msg = tx.message as unknown as {
+						staticAccountKeys?: unknown[];
+						accountKeys?: unknown[];
+						header?: unknown;
+						isAccountSigner?: (i: number) => boolean;
+						isAccountWritable?: (i: number) => boolean;
+						version?: number;
+					};
+					const rawKeys: unknown[] = Array.isArray(msg.staticAccountKeys)
 						? msg.staticAccountKeys
 						: Array.isArray(msg.accountKeys)
 							? msg.accountKeys
 							: [];
-					const keys: string[] = rawKeys.map((k: any) => {
+					const keys: string[] = rawKeys.map((k) => {
 						try {
 							return typeof k === "string" ? k : (k as PublicKey).toBase58();
 						} catch {
@@ -226,18 +237,24 @@ export class LiteSVMRpcServer {
 							err: meta?.err ?? null,
 							rawBase64,
 							preBalances: Array.isArray(meta?.preBalances)
-								? meta!.preBalances!
+								? (meta?.preBalances as number[])
 								: [],
 							postBalances: Array.isArray(meta?.postBalances)
-								? meta!.postBalances!
-								: [],
-							logs: Array.isArray(meta?.logs) ? meta!.logs! : [],
-							preTokenBalances: Array.isArray((meta as any)?.preTokenBalances)
-								? (meta as any).preTokenBalances
-								: [],
-							postTokenBalances: Array.isArray((meta as any)?.postTokenBalances)
-								? (meta as any).postTokenBalances
+								? (meta?.postBalances as number[])
 								: [],
+							logs: Array.isArray(meta?.logs) ? (meta?.logs as string[]) : [],
+							preTokenBalances: (() => {
+								const arr = (
+									meta as { preTokenBalances?: unknown[] } | undefined
+								)?.preTokenBalances;
+								return Array.isArray(arr) ? arr : [];
+							})(),
+							postTokenBalances: (() => {
+								const arr = (
+									meta as { postTokenBalances?: unknown[] } | undefined
+								)?.postTokenBalances;
+								return Array.isArray(arr) ? arr : [];
+							})(),
 							accounts,
 						})
 						.catch(() => {});
@@ -262,7 +279,7 @@ export class LiteSVMRpcServer {
 								return null;
 							}
 						})
-						.filter(Boolean) as any[];
+						.filter(Boolean) as import("../src/db/tx-store").AccountSnapshot[];
 					if (snapshots.length > 0)
 						this.store.upsertAccounts(snapshots).catch(() => {});
 				} catch {}
@@ -302,7 +319,7 @@ export class LiteSVMRpcServer {
 
 	getSignatureStatus(
 		signature: string,
-	): { slot: number; err: any | null } | null {
+	): { slot: number; err: unknown | null } | null {
 		// Prefer local record for reliability
 		const rec = this.txRecords.get(signature);
 		if (rec) {
@@ -312,10 +329,10 @@ export class LiteSVMRpcServer {
 			const sigBytes = decodeBase58(signature);
 			const tx = this.svm.getTransaction(sigBytes);
 			if (!tx) return null;
-			// eslint-disable-next-line @typescript-eslint/no-explicit-any
-			let errVal: any = null;
+			let errVal: unknown = null;
 			try {
-				errVal = "err" in tx ? (tx as any).err() : null;
+				const raw = (tx as { err?: unknown }).err;
+				errVal = typeof raw === "function" ? (raw as () => unknown)() : raw;
 			} catch {
 				errVal = null;
 			}
@@ -350,13 +367,9 @@ export class LiteSVMRpcServer {
 			}
 
 			return result;
-		} catch (error: any) {
-			return this.createErrorResponse(
-				id,
-				-32603,
-				"Internal error",
-				error.message,
-			);
+		} catch (error: unknown) {
+			const message = error instanceof Error ? error.message : String(error);
+			return this.createErrorResponse(id, -32603, "Internal error", message);
 		}
 	}
 }
@@ -406,7 +419,7 @@ export function createLiteSVMRpcServer(port: number = 8899, host?: string) {
 							try {
 								console.log(
 									"RPC batch:",
-									body.map((b: any) => b.method),
+									body.map((b: { method?: string }) => b.method),
 								);
 							} catch {}
 						}
@@ -432,7 +445,7 @@ export function createLiteSVMRpcServer(port: number = 8899, host?: string) {
 							headers: { "Content-Type": "application/json", ...corsHeaders },
 						});
 					}
-				} catch (error) {
+				} catch (_error) {
 					return new Response(
 						JSON.stringify({
 							jsonrpc: "2.0",

package/server/types.ts

@@ -6,17 +6,17 @@ export interface JsonRpcRequest {
 	jsonrpc: "2.0";
 	id: string | number;
 	method: string;
-	params?: any;
+	params?: unknown;
 }
 
 export interface JsonRpcResponse {
 	jsonrpc: "2.0";
 	id: string | number;
-	result?: any;
+	result?: unknown;
 	error?: {
 		code: number;
 		message: string;
-		data?: any;
+		data?: unknown;
 	};
 }
 
@@ -27,12 +27,15 @@ export interface RpcMethodContext {
 	store?: TxStore;
 	encodeBase58: (bytes: Uint8Array) => string;
 	decodeBase58: (str: string) => Uint8Array;
-	createSuccessResponse: (id: string | number, result: any) => JsonRpcResponse;
+	createSuccessResponse: (
+		id: string | number,
+		result: unknown,
+	) => JsonRpcResponse;
 	createErrorResponse: (
 		id: string | number,
 		code: number,
 		message: string,
-		data?: any,
+		data?: unknown,
 	) => JsonRpcResponse;
 	notifySignature: (signature: string) => void;
 	getFaucet: () => Keypair;
@@ -69,6 +72,6 @@ export interface RpcMethodContext {
 
 export type RpcMethodHandler = (
 	id: string | number,
-	params: any,
+	params: unknown[] | undefined,
 	context: RpcMethodContext,
 ) => JsonRpcResponse | Promise<JsonRpcResponse>;

package/server/ws-server.ts

@@ -6,6 +6,7 @@ type Sub = { id: number; type: "signature"; signature: string };
 export function createLiteSVMWebSocketServer(
 	rpcServer: LiteSVMRpcServer,
 	port: number = 8900,
+	host?: string,
 ) {
 	let nextSubId = 1;
 	const subs = new Map<number, Sub>();
@@ -13,7 +14,11 @@ export function createLiteSVMWebSocketServer(
 	const sockets = new Set<WebSocket>();
 	const pendingChecks = new Map<string, number>();
 
-	const sendSignatureNotification = (sig: string, slot: number, err: any) => {
+	const sendSignatureNotification = (
+		sig: string,
+		slot: number,
+		err: unknown,
+	) => {
 		const payload = {
 			jsonrpc: "2.0",
 			method: "signatureNotification",
@@ -24,14 +29,14 @@ export function createLiteSVMWebSocketServer(
 		for (const [id, sub] of subs.entries()) {
 			if (sub.type === "signature" && sub.signature === sig) {
 				try {
-					sockets.forEach((s) =>
+					for (const s of sockets) {
 						s.send(
 							JSON.stringify({
 								...payload,
 								params: { ...payload.params, subscription: id },
 							}),
-						),
-					);
+						);
+					}
 				} catch {}
 				subs.delete(id);
 			}
@@ -67,8 +72,9 @@ export function createLiteSVMWebSocketServer(
 
 	const server: Server = Bun.serve({
 		port,
+		hostname: host || process.env.RPC_HOST || "127.0.0.1",
 		fetch(req, srv) {
-			if (srv.upgrade(req)) return undefined as any;
+			if (srv.upgrade(req)) return undefined as unknown as Response;
 			return new Response("Not a websocket", { status: 400 });
 		},
 		websocket: {
@@ -89,7 +95,7 @@ export function createLiteSVMWebSocketServer(
 						id,
 						method,
 						params = [],
-					} = msg as { id: number; method: string; params?: any[] };
+					} = msg as { id: number; method: string; params?: unknown[] };
 					if (method === "signatureSubscribe") {
 						const [signature] = params;
 						const subId = nextSubId++;
@@ -145,7 +151,7 @@ export function createLiteSVMWebSocketServer(
 							error: { code: -32601, message: `Method not found: ${method}` },
 						}),
 					);
-				} catch (e) {
+				} catch (_e) {
 					try {
 						ws.send(
 							JSON.stringify({
@@ -160,7 +166,8 @@ export function createLiteSVMWebSocketServer(
 		},
 	});
 
-	console.log(`📣 LiteSVM RPC PubSub running on ws://localhost:${port}`);
+	const hostname = (host || process.env.RPC_HOST || "127.0.0.1").toString();
+	console.log(`📣 LiteSVM RPC PubSub running on ws://${hostname}:${port}`);
 	return {
 		wsServer: server,
 		stop: () => {

package/src/api-server-entry.ts

@@ -1,109 +1,109 @@
 #!/usr/bin/env node
 
-import { APIServer } from "./services/api-server.js";
-import { configManager } from "./config/manager.js";
 import chalk from "chalk";
+import { configManager } from "./config/manager.js";
+import { APIServer } from "./services/api-server.js";
 
 async function main() {
-  try {
-    // Parse command line arguments
-    const args = process.argv.slice(2);
-    const portIndex = args.indexOf("--port");
-    const hostIndex = args.indexOf("--host");
-    const configIndex = args.indexOf("--config");
-    const rpcIndex = args.indexOf("--rpc-url");
-    const faucetIndex = args.indexOf("--faucet-url");
-    const workDirIndex = args.indexOf("--work-dir");
+	try {
+		// Parse command line arguments
+		const args = process.argv.slice(2);
+		const portIndex = args.indexOf("--port");
+		const hostIndex = args.indexOf("--host");
+		const configIndex = args.indexOf("--config");
+		const rpcIndex = args.indexOf("--rpc-url");
+		const faucetIndex = args.indexOf("--faucet-url");
+		const workDirIndex = args.indexOf("--work-dir");
 
-    if (
-      portIndex === -1 ||
-      configIndex === -1 ||
-      rpcIndex === -1 ||
-      faucetIndex === -1 ||
-      workDirIndex === -1 ||
-      !args[portIndex + 1] ||
-      !args[configIndex + 1] ||
-      !args[rpcIndex + 1] ||
-      !args[faucetIndex + 1] ||
-      !args[workDirIndex + 1]
-    ) {
-      console.error(
-        "Usage: api-server-entry --port <port> --config <config-path> --rpc-url <url> --faucet-url <url> --work-dir <dir> [--host <host>]"
-      );
-      process.exit(1);
-    }
+		if (
+			portIndex === -1 ||
+			configIndex === -1 ||
+			rpcIndex === -1 ||
+			faucetIndex === -1 ||
+			workDirIndex === -1 ||
+			!args[portIndex + 1] ||
+			!args[configIndex + 1] ||
+			!args[rpcIndex + 1] ||
+			!args[faucetIndex + 1] ||
+			!args[workDirIndex + 1]
+		) {
+			console.error(
+				"Usage: api-server-entry --port <port> --config <config-path> --rpc-url <url> --faucet-url <url> --work-dir <dir> [--host <host>]",
+			);
+			process.exit(1);
+		}
 
-    const port = parseInt(args[portIndex + 1]!);
-    const host =
-      hostIndex !== -1 && args[hostIndex + 1] ? args[hostIndex + 1] : undefined;
-    const configPath = args[configIndex + 1]!;
-    const rpcUrl = args[rpcIndex + 1]!;
-    const faucetUrl = args[faucetIndex + 1]!;
-    const workDir = args[workDirIndex + 1]!;
+		const port = parseInt(String(args[portIndex + 1]), 10);
+		const host =
+			hostIndex !== -1 && args[hostIndex + 1] ? args[hostIndex + 1] : undefined;
+		const configPath = String(args[configIndex + 1]);
+		const rpcUrl = String(args[rpcIndex + 1]);
+		const faucetUrl = String(args[faucetIndex + 1]);
+		const workDir = String(args[workDirIndex + 1]);
 
-    // Load configuration
-    await configManager.load(configPath);
-    const config = configManager.getConfig();
+		// Load configuration
+		await configManager.load(configPath);
+		const config = configManager.getConfig();
 
-    // Create and start API server
-    const apiServer = new APIServer({
-      port,
-      host,
-      validatorRpcUrl: rpcUrl,
-      validatorFaucetUrl: faucetUrl,
-      config,
-      workDir,
-    });
+		// Create and start API server
+		const apiServer = new APIServer({
+			port,
+			host,
+			validatorRpcUrl: rpcUrl,
+			validatorFaucetUrl: faucetUrl,
+			config,
+			workDir,
+		});
 
-    const result = await apiServer.start();
+		const result = await apiServer.start();
 
-    if (result.success) {
-      console.log(chalk.green(`🚀 API Server started on port ${port}`));
+		if (result.success) {
+			console.log(chalk.green(`🚀 API Server started on port ${port}`));
 
-      // Keep the process alive
-      process.on("SIGTERM", async () => {
-        console.log(
-          chalk.yellow("📡 API Server received SIGTERM, shutting down...")
-        );
-        await apiServer.stop();
-        process.exit(0);
-      });
+			// Keep the process alive
+			process.on("SIGTERM", async () => {
+				console.log(
+					chalk.yellow("📡 API Server received SIGTERM, shutting down..."),
+				);
+				await apiServer.stop();
+				process.exit(0);
+			});
 
-      process.on("SIGINT", async () => {
-        console.log(
-          chalk.yellow("📡 API Server received SIGINT, shutting down...")
-        );
-        await apiServer.stop();
-        process.exit(0);
-      });
+			process.on("SIGINT", async () => {
+				console.log(
+					chalk.yellow("📡 API Server received SIGINT, shutting down..."),
+				);
+				await apiServer.stop();
+				process.exit(0);
+			});
 
-      // Keep process alive
-      setInterval(() => {}, 1000);
-    } else {
-      console.error(
-        chalk.red(`❌ Failed to start API server: ${result.error}`)
-      );
-      process.exit(1);
-    }
-  } catch (error) {
-    console.error(
-      chalk.red(
-        `❌ API Server error: ${
-          error instanceof Error ? error.message : String(error)
-        }`
-      )
-    );
-    process.exit(1);
-  }
+			// Keep process alive
+			setInterval(() => {}, 1000);
+		} else {
+			console.error(
+				chalk.red(`❌ Failed to start API server: ${result.error}`),
+			);
+			process.exit(1);
+		}
+	} catch (error) {
+		console.error(
+			chalk.red(
+				`❌ API Server error: ${
+					error instanceof Error ? error.message : String(error)
+				}`,
+			),
+		);
+		process.exit(1);
+	}
 }
 
 main().catch((error) => {
-  console.error(
-    chalk.red(
-      `❌ Fatal error: ${
-        error instanceof Error ? error.message : String(error)
-      }`
-    )
-  );
-  process.exit(1);
+	console.error(
+		chalk.red(
+			`❌ Fatal error: ${
+				error instanceof Error ? error.message : String(error)
+			}`,
+		),
+	);
+	process.exit(1);
 });

package/src/cli/commands/airdrop.ts

@@ -4,8 +4,8 @@ import { parseFlags } from "../utils/args";
 
 export async function airdropCommand(args: string[]) {
 	const { flags } = parseFlags(args);
-	const to = String(flags["to"] || "");
-	const sol = Number(flags["sol"] || 0);
+	const to = String(flags.to || "");
+	const sol = Number(flags.sol || 0);
 	const cfg = await readConfig();
 	const url = `http://localhost:${cfg.server.rpcPort}`;
 	if (!to || !sol) {

package/src/cli/commands/config.ts

@@ -11,7 +11,7 @@ export async function configCommand(sub: string | undefined, args: string[]) {
 	switch (sub) {
 		case "init": {
 			const { flags } = parseFlags(args);
-			const force = !!flags["force"];
+			const force = !!flags.force;
 			await writeDefaultConfig({ force });
 			p.log.success("Wrote sf.config.json");
 			return;
@@ -28,7 +28,7 @@ export async function configCommand(sub: string | undefined, args: string[]) {
 			const updated = setConfigValue(cfg, key, value);
 			await Bun.write(
 				"sf.config.json",
-				JSON.stringify(updated, null, 2) + "\n",
+				`${JSON.stringify(updated, null, 2)}\n`,
 			);
 			p.log.success(`Updated ${key}`);
 			return;

package/src/cli/commands/mint.ts

@@ -7,9 +7,9 @@ import { parseFlags } from "../utils/args";
 // Usage: solforge mint --mint <mint> --to <owner> --amount <amount>
 export async function mintCommand(args: string[]) {
 	const { flags } = parseFlags(args);
-	let mint = flags["mint"] as string | undefined;
-	let receiver = flags["to"] as string | undefined; // required: receiver address (ATA owner)
-	let amountBase = flags["amount"] as string | undefined; // optional direct base-units
+	let mint = flags.mint as string | undefined;
+	let receiver = flags.to as string | undefined; // required: receiver address (ATA owner)
+	let amountBase = flags.amount as string | undefined; // optional direct base-units
 	let uiAmount = flags["ui-amount"] as string | undefined; // preferred UI units
 
 	const cfg = await readConfig();

package/src/cli/commands/program-clone.ts

@@ -6,12 +6,12 @@ export async function programCloneCommand(args: string[]) {
 	const { flags, rest } = parseFlags(args);
 	const programId = (
 		(rest[0] as string) ||
-		(flags["program"] as string) ||
+		(flags.program as string) ||
 		""
 	).trim();
-	const configPath = flags["config"] as string | undefined;
+	const configPath = flags.config as string | undefined;
 	const cfg = await readConfig(configPath);
-	const endpoint = (flags["endpoint"] as string) || cfg.clone.endpoint;
+	const endpoint = (flags.endpoint as string) || cfg.clone.endpoint;
 	const withAccounts = !!flags["with-accounts"];
 	const accountsLimit = flags["accounts-limit"]
 		? Number(flags["accounts-limit"])
@@ -56,16 +56,14 @@ export async function programAccountsCloneCommand(args: string[]) {
 	const { flags, rest } = parseFlags(args);
 	const programId = (
 		(rest[0] as string) ||
-		(flags["program"] as string) ||
+		(flags.program as string) ||
 		""
 	).trim();
-	const configPath = flags["config"] as string | undefined;
+	const configPath = flags.config as string | undefined;
 	const cfg = await readConfig(configPath);
-	const endpoint = (flags["endpoint"] as string) || cfg.clone.endpoint;
-	const limit = flags["limit"] ? Number(flags["limit"]) : undefined;
-	const filters = flags["filters"]
-		? safeJson(flags["filters"] as string)
-		: undefined;
+	const endpoint = (flags.endpoint as string) || cfg.clone.endpoint;
+	const limit = flags.limit ? Number(flags.limit) : undefined;
+	const filters = flags.filters ? safeJson(flags.filters as string) : undefined;
 	if (!programId) {
 		p.log.error(
 			"Usage: solforge program accounts clone <programId> [--endpoint URL] [--limit N] [--filters JSON]",
@@ -97,7 +95,7 @@ export async function programAccountsCloneCommand(args: string[]) {
 	}
 }
 
-function safeJson(s: string): any {
+function safeJson(s: string): unknown {
 	try {
 		return JSON.parse(s);
 	} catch {

package/src/cli/commands/program-load.ts

@@ -5,9 +5,9 @@ import { parseFlags } from "../utils/args";
 
 export async function programLoadCommand(args: string[]) {
 	const { flags, rest } = parseFlags(args);
-	const programId = (rest[0] as string) || (flags["program"] as string);
-	const fromFile = flags["file"] as string | undefined;
-	const endpoint = flags["endpoint"] as string | undefined;
+	const programId = (rest[0] as string) || (flags.program as string);
+	const fromFile = flags.file as string | undefined;
+	const endpoint = flags.endpoint as string | undefined;
 	if (!programId) {
 		p.log.error(
 			"Usage: solforge program load <programId> [--file PATH | --endpoint URL]",

package/src/cli/commands/rpc-start.ts

@@ -5,10 +5,11 @@ import { parseFlags } from "../utils/args";
 
 export async function rpcStartCommand(args: string[]) {
 	const { flags } = parseFlags(args);
-	const cfg = await readConfig(flags["config"] as string | undefined);
-	const rpcPort = Number(flags["port"] ?? cfg.server.rpcPort ?? 8899);
+	const cfg = await readConfig(flags.config as string | undefined);
+	const rpcPort = Number(flags.port ?? cfg.server.rpcPort ?? 8899);
 	const wsPort = Number(flags["ws-port"] ?? cfg.server.wsPort ?? rpcPort + 1);
-	const host = (flags["host"] as string) || "127.0.0.1";
+	const host =
+		flags.network === true ? "0.0.0.0" : (flags.host as string) || "127.0.0.1";
 	const dbMode =
 		(flags["db-mode"] as string) || cfg.server.db.mode || "ephemeral";
 	const dbPath =
@@ -17,7 +18,7 @@ export async function rpcStartCommand(args: string[]) {
 	const guiEnabled =
 		flags["no-gui"] === true
 			? false
-			: flags["gui"] === true
+			: flags.gui === true
 				? true
 				: cfg.gui.enabled !== false;
 
@@ -25,10 +26,12 @@ export async function rpcStartCommand(args: string[]) {
 	const guiMsg = guiEnabled ? `, GUI on ${guiPort}` : "";
 	s.start(`Starting RPC on ${host}:${rpcPort}, WS on ${wsPort}${guiMsg}...`);
 	try {
+		const mode: "ephemeral" | "persistent" =
+			dbMode === "persistent" ? "persistent" : "ephemeral";
 		const started = startRpcServers({
 			rpcPort,
 			wsPort,
-			dbMode: dbMode as any,
+			dbMode: mode,
 			dbPath,
 			host,
 			guiEnabled,

package/src/cli/commands/token-adopt-authority.ts

@@ -5,7 +5,7 @@ import { parseFlags } from "../utils/args";
 // Set the faucet as mint authority for an existing mint in LiteSVM (local-only)
 export async function tokenAdoptAuthorityCommand(args: string[]) {
 	const { flags, rest } = parseFlags(args);
-	const mint = (rest[0] as string) || (flags["mint"] as string);
+	const mint = (rest[0] as string) || (flags.mint as string);
 	if (!mint) {
 		p.log.error("Usage: solforge token adopt-authority <mint>");
 		return;