solforge 0.2.5 → 0.2.7

package/src/cli/commands/token-create.ts

@@ -8,13 +8,13 @@ import { parseFlags } from "../utils/args";
 //   solforge token create --decimals <d> --owner <pubkey> [--mint <pubkey>] [--amount <baseUnits> | --ui-amount <num>]
 export async function tokenCreateCommand(args: string[]) {
 	const { flags } = parseFlags(args);
-	const decimals = flags["decimals"] ? Number(flags["decimals"]) : NaN;
-	const owner = flags["owner"] as string | undefined;
-	const mint = flags["mint"] as string | undefined;
-	const amountBase = flags["amount"] as string | undefined;
+	const decimals = flags.decimals ? Number(flags.decimals) : NaN;
+	const owner = flags.owner as string | undefined;
+	const mint = flags.mint as string | undefined;
+	const amountBase = flags.amount as string | undefined;
 	const uiAmount = flags["ui-amount"] as string | undefined;
 
-	if (!isFinite(decimals)) {
+	if (!Number.isFinite(decimals)) {
 		p.log.error("--decimals is required (0-18)");
 		return;
 	}

package/src/cli/main.ts

@@ -1,24 +1,23 @@
 // Minimal, fast CLI router with @clack/prompts for UX
 import * as p from "@clack/prompts";
-// Load version for --version in both bun script and compiled binary
-// eslint-disable-next-line @typescript-eslint/consistent-type-imports
-import pkg from "../../package.json" assert { type: "json" };
+// CLI version string; keep in sync with package.json if possible
+const VERSION = "0.2.4";
 
 // Robust arg parsing for both bun script and compiled binary
 const known = new Set([
-  "help",
-  "-h",
-  "--help",
-  "version",
-  "-v",
-  "--version",
-  "rpc",
-  "start",
-  "config",
-  "airdrop",
-  "mint",
-  "token",
-  "program",
+	"help",
+	"-h",
+	"--help",
+	"version",
+	"-v",
+	"--version",
+	"rpc",
+	"start",
+	"config",
+	"airdrop",
+	"mint",
+	"token",
+	"program",
 ]);
 const raw = Bun.argv.slice(1);
 const firstIdx = raw.findIndex((a) => known.has(String(a)));
@@ -27,22 +26,22 @@ const argv = firstIdx >= 0 ? raw.slice(firstIdx) : [];
 async function main() {
 	const [cmd, sub, ...rest] = argv;
 
-  if (!cmd) {
-    const { runSolforge } = await import("./run-solforge");
-    // Pass through any flags provided when no explicit command was given
-    await runSolforge(raw);
-    return;
-  }
+	if (!cmd) {
+		const { runSolforge } = await import("./run-solforge");
+		// Pass through any flags provided when no explicit command was given
+		await runSolforge(raw);
+		return;
+	}
 
-  if (cmd === "help" || cmd === "-h" || cmd === "--help") {
-    printHelp();
-    return;
-  }
+	if (cmd === "help" || cmd === "-h" || cmd === "--help") {
+		printHelp();
+		return;
+	}
 
-  if (cmd === "version" || cmd === "-v" || cmd === "--version") {
-    printVersion();
-    return;
-  }
+	if (cmd === "version" || cmd === "-v" || cmd === "--version") {
+		printVersion();
+		return;
+	}
 
 	// Alias: solforge start -> solforge rpc start
 	if (cmd === "start") {
@@ -117,7 +116,7 @@ async function main() {
 }
 
 function printHelp() {
-  console.log(`
+	console.log(`
 solforge <command>
 
 Commands:
@@ -142,14 +141,12 @@ Options:
 }
 
 async function unknownCommand(parts: (string | undefined)[]) {
-  p.log.error(`Unknown command: ${parts.filter(Boolean).join(" ")}`);
-  printHelp();
+	p.log.error(`Unknown command: ${parts.filter(Boolean).join(" ")}`);
+	printHelp();
 }
 
 function printVersion() {
-	// Prefer package.json version if available
-	const v = (pkg as any)?.version ?? "";
-	console.log(String(v));
+	console.log(String(VERSION));
 }
 
 main();

package/src/cli/run-solforge.ts

@@ -15,7 +15,7 @@ const CONFIG_PATH = "sf.config.json";
 
 export async function runSolforge(args: string[] = []) {
 	const { flags } = parseFlags(args);
-	const ci = flags["ci"] === true || flags["y"] === true;
+	const ci = flags.ci === true || flags.y === true;
 	const config = await ensureConfig(ci);
 	await startWithConfig(config, args);
 }
@@ -53,9 +53,9 @@ async function ensureConfig(ci = false): Promise<SolforgeConfig> {
 async function startWithConfig(config: SolforgeConfig, args: string[] = []) {
 	const { flags } = parseFlags(args);
 	const host = String(
-		flags["network"] === true
+		flags.network === true
 			? "0.0.0.0"
-			: ((flags["host"] as string) ?? process.env.RPC_HOST ?? "127.0.0.1"),
+			: ((flags.host as string) ?? process.env.RPC_HOST ?? "127.0.0.1"),
 	);
 	const rpcPort = Number(config.server.rpcPort || defaultConfig.server.rpcPort);
 	const wsPort = Number(config.server.wsPort || rpcPort + 1);

package/src/cli/setup-wizard.ts

@@ -170,9 +170,10 @@ async function resolveTokens(selections: string[], existing: string[] = []) {
 	const set = new Set(existing);
 	for (const selection of selections) {
 		if (selection === "__custom__") {
-			(await collectCustomEntries("token mint address")).forEach((value) =>
-				set.add(value),
-			);
+			{
+				const values = await collectCustomEntries("token mint address");
+				for (const value of values) set.add(value);
+			}
 			continue;
 		}
 		const preset = TOKEN_PRESETS.find((token) => token.value === selection);
@@ -193,9 +194,10 @@ async function resolvePrograms(selections: string[], existing: string[] = []) {
 	const set = new Set(existing);
 	for (const selection of selections) {
 		if (selection === "__custom__") {
-			(await collectCustomEntries("program id")).forEach((value) =>
-				set.add(value),
-			);
+			{
+				const values = await collectCustomEntries("program id");
+				for (const value of values) set.add(value);
+			}
 			continue;
 		}
 		const preset = PROGRAM_PRESETS.find(

package/src/commands/add-program.ts

@@ -1,5 +1,5 @@
 import chalk from "chalk";
-import { existsSync } from "fs";
+import { existsSync } from "node:fs";
 import inquirer from "inquirer";
 import { configManager } from "../config/manager.js";
 import { processRegistry } from "../services/process-registry.js";

package/src/commands/init.ts

@@ -1,7 +1,7 @@
 import chalk from "chalk";
-import { existsSync, writeFileSync } from "fs";
+import { existsSync, writeFileSync } from "node:fs";
 import inquirer from "inquirer";
-import { resolve } from "path";
+import { resolve } from "node:path";
 import type { Config } from "../types/config.js";
 
 const defaultConfig: Config = {

package/src/commands/mint.ts

@@ -1,9 +1,8 @@
 import { input, select } from "@inquirer/prompts";
-import { Keypair, PublicKey } from "@solana/web3.js";
+import { PublicKey } from "@solana/web3.js";
 import chalk from "chalk";
 import { Command } from "commander";
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
+import { existsSync, readFileSync } from "node:fs";
 import type { TokenConfig } from "../types/config.js";
 import { runCommand } from "../utils/shell";
 import {
@@ -115,7 +114,7 @@ export const mintCommand = new Command()
 			let amount: string;
 			if (options.amount) {
 				const num = parseFloat(options.amount);
-				if (isNaN(num) || num <= 0) {
+				if (Number.isNaN(num) || num <= 0) {
 					console.error(chalk.red("❌ Invalid amount"));
 					process.exit(1);
 				}
@@ -126,7 +125,7 @@ export const mintCommand = new Command()
 					message: "Enter amount to mint:",
 					validate: (value: string) => {
 						const num = parseFloat(value);
-						if (isNaN(num) || num <= 0) {
+						if (Number.isNaN(num) || num <= 0) {
 							return "Please enter a valid positive number";
 						}
 						return true;
@@ -219,7 +218,7 @@ export async function mintTokenToWallet(
 					break;
 				}
 			}
-		} catch (error) {
+		} catch (_error) {
 			// No existing accounts found or parsing error, will create new account
 		}
 	}

package/src/commands/start.ts

@@ -1,8 +1,8 @@
 import chalk from "chalk";
-import { spawn } from "child_process";
-import { existsSync, readFileSync } from "fs";
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
 import ora from "ora";
-import { join } from "path";
+import { join } from "node:path";
 import { configManager } from "../config/manager.js";
 import { portManager } from "../services/port-manager.js";
 import type { RunningValidator } from "../services/process-registry.js";
@@ -392,7 +392,7 @@ export async function startCommand(
 						if (pidResult.success && pidResult.stdout.trim()) {
 							const pidLine = pidResult.stdout.trim().split("\n")[0];
 							if (pidLine) {
-								apiServerPid = parseInt(pidLine);
+								apiServerPid = parseInt(pidLine, 10);
 							}
 						}
 					} else {
@@ -434,7 +434,7 @@ export async function startCommand(
 		const runningValidator: RunningValidator = {
 			id: validatorId,
 			name: config.name,
-			pid: validatorProcess.pid!,
+			pid: validatorProcess.pid,
 			rpcPort: config.localnet.port,
 			faucetPort: config.localnet.faucetPort,
 			rpcUrl: `http://127.0.0.1:${config.localnet.port}`,
@@ -558,7 +558,7 @@ export async function startCommand(
 			console.log(chalk.yellow("\n📦 Cloned programs:"));
 			config.programs.forEach((program) => {
 				const name =
-					program.name || program.mainnetProgramId.slice(0, 8) + "...";
+					program.name || `${program.mainnetProgramId.slice(0, 8)}...`;
 				console.log(chalk.gray(`  - ${name}: ${program.mainnetProgramId}`));
 			});
 		}
@@ -778,8 +778,9 @@ async function waitForValidatorReady(
 /**
  * Airdrop SOL to the mint authority for fee payments
  */
+
 async function airdropSolToMintAuthority(
-	clonedToken: any,
+	clonedToken: ClonedToken,
 	rpcUrl: string,
 	debug: boolean = false,
 ): Promise<void> {
@@ -813,7 +814,7 @@ async function airdropSolToMintAuthority(
  */
 async function checkExistingClonedTokens(
 	tokens: TokenConfig[],
-	tokenCloner: TokenCloner,
+	_tokenCloner: TokenCloner,
 ): Promise<{ existingTokens: ClonedToken[]; tokensToClone: TokenConfig[] }> {
 	const existingTokens: ClonedToken[] = [];
 	const tokensToClone: TokenConfig[] = [];
@@ -851,7 +852,7 @@ async function checkExistingClonedTokens(
 				// Old format: file contains {publicKey, secretKey}
 				sharedMintAuthority = fileContent;
 			}
-		} catch (error) {
+		} catch (_error) {
 			// If we can't read the shared mint authority, treat all tokens as needing to be cloned
 			sharedMintAuthority = null;
 		}

package/src/commands/status.ts

@@ -90,7 +90,7 @@ export async function statusCommand(): Promise<void> {
 		console.log(`  📝 Project: ${config.name}`);
 		console.log(`  🪙 Tokens: ${config.tokens.length}`);
 		console.log(`  📦 Programs: ${config.programs.length}`);
-	} catch (error) {
+	} catch (_error) {
 		console.log(`  ❌ No valid configuration found`);
 		console.log(`  💡 Run 'solforge init' to create one`);
 	}

package/src/commands/stop.ts

@@ -186,7 +186,7 @@ async function waitForProcessShutdown(
 			process.kill(pid, 0);
 			// If no error thrown, process is still running
 			await new Promise((resolve) => setTimeout(resolve, 500));
-		} catch (error) {
+		} catch (_error) {
 			// Process is gone
 			return { success: true };
 		}

package/src/config/index.ts

@@ -68,7 +68,7 @@ export async function writeDefaultConfig(opts: { force?: boolean } = {}) {
 			mkdirSync(dir, { recursive: true });
 		} catch {}
 	}
-	writeFileSync(p, JSON.stringify(defaultConfig, null, 2) + "\n");
+	writeFileSync(p, `${JSON.stringify(defaultConfig, null, 2)}\n`);
 }
 
 export async function writeConfig(
@@ -81,50 +81,66 @@ export async function writeConfig(
 			mkdirSync(dir, { recursive: true });
 		} catch {}
 	}
-	await Bun.write(path, JSON.stringify(config, null, 2) + "\n");
+	await Bun.write(path, `${JSON.stringify(config, null, 2)}\n`);
 }
 
-export function getConfigValue(cfg: any, path?: string) {
+export function getConfigValue(
+	cfg: Record<string, unknown>,
+	path?: string,
+): unknown {
 	if (!path) return cfg;
-	return path.split(".").reduce((o, k) => (o ? o[k] : undefined), cfg);
+	let cur: unknown = cfg;
+	for (const k of path.split(".")) {
+		if (
+			cur &&
+			typeof cur === "object" &&
+			k in (cur as Record<string, unknown>)
+		) {
+			cur = (cur as Record<string, unknown>)[k];
+		} else {
+			return undefined;
+		}
+	}
+	return cur;
 }
 
-export function setConfigValue<T extends Record<string, any>>(
+export function setConfigValue<T extends Record<string, unknown>>(
 	cfg: T,
 	path: string,
-	value: any,
+	value: unknown,
 ): T {
 	const parts = path.split(".");
-	let node: any = cfg;
+	let node: Record<string, unknown> = cfg;
 	for (let i = 0; i < parts.length - 1; i++) {
 		const k = parts[i];
 		if (!node[k] || typeof node[k] !== "object") node[k] = {};
-		node = node[k];
+		node = node[k] as Record<string, unknown>;
 	}
 	node[parts[parts.length - 1]] = coerceValue(value);
 	return cfg;
 }
 
-function coerceValue(v: any) {
+function coerceValue(v: unknown): unknown {
 	if (v === "true") return true;
 	if (v === "false") return false;
-	if (v !== "" && !isNaN(Number(v))) return Number(v);
+	if (typeof v === "string" && v !== "" && !Number.isNaN(Number(v)))
+		return Number(v);
 	try {
-		return JSON.parse(v);
+		return typeof v === "string" ? JSON.parse(v) : v;
 	} catch {
 		return v;
 	}
 }
 
 function deepMerge<T>(a: T, b: Partial<T>): T {
-	if (Array.isArray(a) || Array.isArray(b)) return (b as any) ?? (a as any);
+	if (Array.isArray(a) || Array.isArray(b)) return (b ?? a) as unknown as T;
 	if (typeof a === "object" && typeof b === "object" && a && b) {
-		const out: any = { ...a };
+		const out: Record<string, unknown> = { ...(a as Record<string, unknown>) };
 		for (const [k, v] of Object.entries(b)) {
-			const ak = (a as any)[k];
-			out[k] = deepMerge(ak, v as any);
+			const ak = (a as Record<string, unknown>)[k];
+			out[k] = deepMerge(ak as unknown, v as unknown) as unknown;
 		}
-		return out;
+		return out as unknown as T;
 	}
-	return (b as any) ?? (a as any);
+	return (b ?? a) as unknown as T;
 }

package/src/config/manager.ts

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { join, resolve } from "path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
 import type { Config, ValidationResult } from "../types/config.js";
 import { ConfigSchema } from "../types/config.js";
 
@@ -77,7 +77,7 @@ export class ConfigManager {
 	/**
 	 * Validate a configuration object
 	 */
-	validate(config: any): ValidationResult {
+	validate(config: unknown): ValidationResult {
 		const result = ConfigSchema.safeParse(config);
 
 		if (result.success) {

package/src/db/index.ts

@@ -27,10 +27,10 @@ if (!PERSIST && DB_PATH !== ":memory:") {
 		if (existsSync(DB_PATH)) unlinkSync(DB_PATH);
 	} catch {}
 	try {
-		if (existsSync(DB_PATH + "-wal")) unlinkSync(DB_PATH + "-wal");
+		if (existsSync(`${DB_PATH}-wal`)) unlinkSync(`${DB_PATH}-wal`);
 	} catch {}
 	try {
-		if (existsSync(DB_PATH + "-shm")) unlinkSync(DB_PATH + "-shm");
+		if (existsSync(`${DB_PATH}-shm`)) unlinkSync(`${DB_PATH}-shm`);
 	} catch {}
 }
 

package/src/db/schema/index.ts

@@ -3,3 +3,4 @@ export * from "./address-signatures";
 export * from "./meta-kv";
 export * from "./transactions";
 export * from "./tx-accounts";
+export * from "./tx-account-states";

package/src/db/schema/transactions.ts

@@ -1,28 +1,35 @@
 import { index, integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
 
 export const transactions = sqliteTable(
-	"transactions",
-	{
-		signature: text("signature").primaryKey(),
-		slot: integer("slot").notNull(),
-		blockTime: integer("block_time"),
-		version: text("version").notNull(), // 0 | "legacy"
-		errJson: text("err_json"),
-		fee: integer("fee").notNull(),
-		rawBase64: text("raw_base64").notNull(),
-		preBalancesJson: text("pre_balances_json").notNull(),
-		postBalancesJson: text("post_balances_json").notNull(),
-		logsJson: text("logs_json").notNull(),
-		preTokenBalancesJson: text("pre_token_balances_json")
-			.default("[]")
-			.notNull(),
-		postTokenBalancesJson: text("post_token_balances_json")
-			.default("[]")
-			.notNull(),
-	},
-	(t) => ({
-		slotIdx: index("idx_transactions_slot").on(t.slot),
-	}),
+    "transactions",
+    {
+        signature: text("signature").primaryKey(),
+        slot: integer("slot").notNull(),
+        blockTime: integer("block_time"),
+        version: text("version").notNull(), // 0 | "legacy"
+        errJson: text("err_json"),
+        fee: integer("fee").notNull(),
+        rawBase64: text("raw_base64").notNull(),
+        preBalancesJson: text("pre_balances_json").notNull(),
+        postBalancesJson: text("post_balances_json").notNull(),
+        logsJson: text("logs_json").notNull(),
+        preTokenBalancesJson: text("pre_token_balances_json")
+            .default("[]")
+            .notNull(),
+        postTokenBalancesJson: text("post_token_balances_json")
+            .default("[]")
+            .notNull(),
+        // Additional rich metadata captured after execution
+        innerInstructionsJson: text("inner_instructions_json")
+            .default("[]")
+            .notNull(),
+        computeUnits: integer("compute_units"),
+        returnDataProgramId: text("return_data_program_id"),
+        returnDataBase64: text("return_data_base64"),
+    },
+    (t) => ({
+        slotIdx: index("idx_transactions_slot").on(t.slot),
+    }),
 );
 
 export type TransactionRow = typeof transactions.$inferSelect;

package/src/db/schema/tx-account-states.ts

@@ -0,0 +1,21 @@
+import { index, primaryKey, sqliteTable, text } from "drizzle-orm/sqlite-core";
+
+export const txAccountStates = sqliteTable(
+  "tx_account_states",
+  {
+    signature: text("signature").notNull(),
+    address: text("address").notNull(),
+    // JSON blobs capturing minimal account snapshot
+    // { lamports, ownerProgram, executable, rentEpoch, dataLen, dataBase64? }
+    preJson: text("pre_json"),
+    postJson: text("post_json"),
+  },
+  (t) => ({
+    pk: primaryKey({ columns: [t.signature, t.address], name: "pk_tx_account_states" }),
+    addrIdx: index("idx_tx_account_states_address").on(t.address),
+  }),
+);
+
+export type TxAccountStateRow = typeof txAccountStates.$inferSelect;
+export type NewTxAccountStateRow = typeof txAccountStates.$inferInsert;
+