solforge 0.2.12 → 0.2.14

package/src/cli/run-solforge.ts

@@ -1,112 +0,0 @@
-import * as p from "@clack/prompts";
-import {
-	defaultConfig,
-	readConfig,
-	type SolforgeConfig,
-	writeConfig,
-} from "../config";
-import { startRpcServers } from "../rpc/start";
-import { bootstrapEnvironment } from "./bootstrap";
-import { cancelSetup } from "./setup-utils";
-import { runSetupWizard } from "./setup-wizard";
-import { parseFlags } from "./utils/args";
-
-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 config = await ensureConfig(ci);
-	await startWithConfig(config, args);
-}
-
-async function ensureConfig(ci = false): Promise<SolforgeConfig> {
-	const exists = await Bun.file(CONFIG_PATH).exists();
-	if (!exists) {
-		if (ci) {
-			// Non-interactive: write defaults and continue
-			await saveConfig(defaultConfig);
-			return defaultConfig;
-		}
-		p.intro("Solforge setup");
-		const config = await runSetupWizard();
-		await saveConfig(config);
-		p.outro("Configuration saved");
-		return config;
-	}
-
-	const current = await readConfig(CONFIG_PATH);
-	if (ci) return current; // Non-interactive: always reuse existing config
-	const reuse = await p.confirm({
-		message: `Use existing config at ${CONFIG_PATH}?`,
-		initialValue: true,
-	});
-	if (p.isCancel(reuse)) cancelSetup();
-
-	if (reuse) return current;
-
-	const updated = await runSetupWizard(current);
-	await saveConfig(updated);
-	return updated;
-}
-
-async function startWithConfig(config: SolforgeConfig, args: string[] = []) {
-	const { flags } = parseFlags(args);
-	const host = String(
-		flags.network === true
-			? "0.0.0.0"
-			: ((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);
-	const guiEnabled = config.gui?.enabled !== false;
-	const guiPort = Number(config.gui?.port ?? defaultConfig.gui.port);
-
-	const spinner = p.spinner();
-	const guiPart = guiEnabled ? `, GUI ${guiPort}` : "";
-	spinner.start(
-		`Starting RPC on ${host}:${rpcPort} (WS ${wsPort}${guiPart})...`,
-	);
-	try {
-		const started = startRpcServers({
-			rpcPort,
-			wsPort,
-			dbMode: config.server.db.mode,
-			dbPath: config.server.db.path,
-			host,
-			guiEnabled,
-			guiPort,
-		});
-		spinner.stop("RPC started");
-
-		await waitForRpc(`http://${host}:${started.rpcPort}`);
-		await bootstrapEnvironment(config, host, started.rpcPort);
-
-		p.log.success(
-			`Solforge ready ➜ HTTP http://${host}:${started.rpcPort} | WS ws://${host}:${started.wsPort}${
-				started.guiPort ? ` | GUI http://${host}:${started.guiPort}` : ""
-			}`,
-		);
-	} catch (error) {
-		spinner.stop("Failed to start RPC");
-		p.log.error(String(error));
-		process.exitCode = 1;
-	}
-}
-
-async function waitForRpc(url: string, timeoutMs = 10_000) {
-	const start = Date.now();
-	while (Date.now() - start < timeoutMs) {
-		try {
-			const res = await fetch(`${url}/health`);
-			if (res.ok) return;
-		} catch {}
-		await Bun.sleep(200);
-	}
-	throw new Error("RPC server did not become ready in time");
-}
-
-async function saveConfig(config: SolforgeConfig) {
-	await writeConfig(config, CONFIG_PATH);
-	p.log.success(`Updated ${CONFIG_PATH}`);
-}

package/src/cli/setup-utils.ts

@@ -1,54 +0,0 @@
-import * as p from "@clack/prompts";
-
-const CANCEL_MESSAGE = "Setup cancelled";
-
-export function cancelSetup(): never {
-	p.cancel(CANCEL_MESSAGE);
-	process.exit(0);
-}
-
-export function ensure<T>(value: T | symbol): T {
-	if (p.isCancel(value)) cancelSetup();
-	return value as T;
-}
-
-export function validatePort(value: string | number | undefined) {
-	const num = Number(value);
-	if (!Number.isInteger(num)) return "Port must be an integer";
-	if (num < 1 || num > 65535) return "Port must be between 1 and 65535";
-	return undefined;
-}
-
-export function validatePositiveNumber(value: string) {
-	const num = Number(value);
-	if (!Number.isFinite(num)) return "Enter a number";
-	if (num <= 0) return "Enter a positive number";
-	return undefined;
-}
-
-export function validatePubkey(value: string | undefined) {
-	if (!value) return "Value is required";
-	const trimmed = value.trim();
-	if (trimmed.length < 32 || trimmed.length > 44)
-		return "Expected base58 address";
-	return undefined;
-}
-
-export async function collectCustomEntries(label: string) {
-	const results: string[] = [];
-	while (true) {
-		const value = await p.text({
-			message: `Enter ${label} (leave blank to finish)`,
-		});
-		if (p.isCancel(value)) cancelSetup();
-		const trimmed = typeof value === "string" ? value.trim() : "";
-		if (!trimmed) break;
-		const error = validatePubkey(trimmed);
-		if (error) {
-			p.log.error(error);
-			continue;
-		}
-		results.push(trimmed);
-	}
-	return results;
-}

package/src/cli/setup-wizard.ts

@@ -1,258 +0,0 @@
-import * as p from "@clack/prompts";
-import { defaultConfig, type SolforgeConfig } from "../config";
-import {
-	cancelSetup,
-	collectCustomEntries,
-	ensure,
-	validatePort,
-	validatePositiveNumber,
-	validatePubkey,
-} from "./setup-utils";
-
-const TOKEN_PRESETS = [
-	{
-		value: "usdc",
-		label: "USDC",
-		mint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
-	},
-	{
-		value: "usdt",
-		label: "USDT",
-		mint: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
-	},
-];
-const PROGRAM_PRESETS = [
-	{
-		value: "jupiter",
-		label: "Jupiter",
-		programId: "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
-	},
-	{
-		value: "pump",
-		label: "Pump core",
-		programId: "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
-	},
-	{
-		value: "pump-amm",
-		label: "Pump AMM",
-		programId: "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA",
-	},
-	{
-		value: "pump-fees",
-		label: "Pump fees",
-		programId: "pfeeUxB6jkeY1Hxd7CsFCAjcbHA9rWtchMGdZ6VojVZ",
-	},
-];
-export async function runSetupWizard(existing: SolforgeConfig = defaultConfig) {
-	const base: SolforgeConfig = JSON.parse(JSON.stringify(existing));
-
-	const rpcPort = Number(
-		ensure(
-			await p.text({
-				message: "RPC port",
-				initialValue: String(
-					base.server.rpcPort ?? defaultConfig.server.rpcPort,
-				),
-				validate: validatePort,
-			}),
-		),
-	);
-
-	const wsPort = Number(
-		ensure(
-			await p.text({
-				message: "WebSocket port",
-				initialValue: String(base.server.wsPort ?? rpcPort + 1),
-				validate: validatePort,
-			}),
-		),
-	);
-
-	const guiEnabledResp = await p.confirm({
-		message: "Enable GUI server?",
-		initialValue: base.gui?.enabled ?? defaultConfig.gui.enabled,
-	});
-	if (p.isCancel(guiEnabledResp)) cancelSetup();
-	const guiEnabled = guiEnabledResp !== false;
-
-	let guiPort = base.gui?.port ?? defaultConfig.gui.port;
-	if (guiEnabled) {
-		guiPort = Number(
-			ensure(
-				await p.text({
-					message: "GUI port",
-					initialValue: String(guiPort ?? defaultConfig.gui.port),
-					validate: validatePort,
-				}),
-			),
-		);
-	}
-
-	const endpoint = ensure(
-		await p.text({
-			message: "Source RPC endpoint for cloning",
-			initialValue: base.clone.endpoint || defaultConfig.clone.endpoint,
-			placeholder: defaultConfig.clone.endpoint,
-			validate: (value) => (value ? undefined : "Endpoint is required"),
-		}),
-	).trim();
-
-	const tokenSelection = ensure(
-		await p.multiselect({
-			message: "Which tokens should be cloned into LiteSVM?",
-			options: [
-				...TOKEN_PRESETS.map((token) => ({
-					value: token.value,
-					label: `${token.label} (${token.mint})`,
-				})),
-				{ value: "__custom__", label: "Add custom token mint" },
-			],
-			initialValues: TOKEN_PRESETS.filter((preset) =>
-				base.clone.tokens?.includes(preset.mint),
-			).map((preset) => preset.value),
-			required: false,
-		}),
-	) as string[];
-	let tokenSeed: string[] = [];
-	if ((base.clone.tokens?.length ?? 0) > 0) {
-		const keep = await p.confirm({
-			message: `Keep existing token list (${base.clone.tokens.length})?`,
-			initialValue: true,
-		});
-		if (p.isCancel(keep)) cancelSetup();
-		if (keep) tokenSeed = [...base.clone.tokens];
-	}
-
-	const tokens = await resolveTokens(tokenSelection, tokenSeed);
-
-	const programSelection = ensure(
-		await p.multiselect({
-			message: "Clone any on-chain programs?",
-			options: [
-				...PROGRAM_PRESETS.map((program) => ({
-					value: program.value,
-					label: `${program.label} (${program.programId})`,
-				})),
-				{ value: "__custom__", label: "Add custom program" },
-			],
-			initialValues: PROGRAM_PRESETS.filter((preset) =>
-				base.clone.programs?.includes(preset.programId),
-			).map((preset) => preset.value),
-			required: false,
-		}),
-	) as string[];
-	let programSeed: string[] = [];
-	if ((base.clone.programs?.length ?? 0) > 0) {
-		const keepPrograms = await p.confirm({
-			message: `Keep existing program list (${base.clone.programs.length})?`,
-			initialValue: true,
-		});
-		if (p.isCancel(keepPrograms)) cancelSetup();
-		if (keepPrograms) programSeed = [...base.clone.programs];
-	}
-
-	const programs = await resolvePrograms(programSelection, programSeed);
-
-	const airdrops = await collectAirdrops(base.bootstrap?.airdrops ?? []);
-
-	base.server.rpcPort = rpcPort;
-	base.server.wsPort = wsPort;
-	base.gui = { enabled: guiEnabled, port: guiPort ?? defaultConfig.gui.port };
-	base.clone.endpoint = endpoint;
-	base.clone.tokens = tokens;
-	base.clone.programs = programs;
-	base.bootstrap = { airdrops };
-
-	return base;
-}
-
-async function resolveTokens(selections: string[], existing: string[] = []) {
-	const set = new Set(existing);
-	for (const selection of selections) {
-		if (selection === "__custom__") {
-			{
-				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);
-		if (!preset) continue;
-		const mint = ensure(
-			await p.text({
-				message: `Mint address for ${preset.label}`,
-				initialValue: preset.mint,
-				validate: validatePubkey,
-			}),
-		).trim();
-		set.add(mint);
-	}
-	return Array.from(set);
-}
-
-async function resolvePrograms(selections: string[], existing: string[] = []) {
-	const set = new Set(existing);
-	for (const selection of selections) {
-		if (selection === "__custom__") {
-			{
-				const values = await collectCustomEntries("program id");
-				for (const value of values) set.add(value);
-			}
-			continue;
-		}
-		const preset = PROGRAM_PRESETS.find(
-			(program) => program.value === selection,
-		);
-		if (!preset) continue;
-		const programId = ensure(
-			await p.text({
-				message: `Program ID for ${preset.label}`,
-				initialValue: preset.programId,
-				validate: validatePubkey,
-			}),
-		).trim();
-		set.add(programId);
-	}
-	return Array.from(set);
-}
-
-async function collectAirdrops(
-	existing: Array<{ address: string; amountSol: number }>,
-) {
-	const entries: Array<{ address: string; amountSol: number }> = [];
-	if (existing.length > 0) {
-		const keep = await p.confirm({
-			message: `Keep existing airdrop recipients (${existing.length})?`,
-			initialValue: true,
-		});
-		if (p.isCancel(keep)) cancelSetup();
-		if (keep) entries.push(...existing);
-	}
-
-	while (true) {
-		const address = await p.text({
-			message:
-				entries.length === 0
-					? "Airdrop recipient address (leave blank to skip)"
-					: "Add another airdrop recipient (leave blank to finish)",
-		});
-		if (p.isCancel(address)) cancelSetup();
-		const trimmed = typeof address === "string" ? address.trim() : "";
-		if (!trimmed) break;
-		const error = validatePubkey(trimmed);
-		if (error) {
-			p.log.error(error);
-			continue;
-		}
-		const amount = ensure(
-			await p.text({
-				message: `Amount of SOL to airdrop to ${trimmed}`,
-				initialValue: "100",
-				validate: validatePositiveNumber,
-			}),
-		);
-		entries.push({ address: trimmed, amountSol: Number(amount) });
-	}
-
-	return entries;
-}

package/src/cli/utils/args.ts

@@ -1,15 +0,0 @@
-export function parseFlags(args: string[]) {
-	const flags: Record<string, string | boolean> = {};
-	const rest: string[] = [];
-	for (let i = 0; i < args.length; i++) {
-		const a = args[i];
-		if (a.startsWith("--")) {
-			const [k, v] = a.slice(2).split("=");
-			if (typeof v === "string" && v.length > 0) flags[k] = v;
-			else if (i + 1 < args.length && !args[i + 1].startsWith("-"))
-				flags[k] = args[++i];
-			else flags[k] = true;
-		} else rest.push(a);
-	}
-	return { flags, rest };
-}