solforge 0.2.3 → 0.2.5

package/cli.cjs

@@ -9,94 +9,151 @@ const https = require("node:https");
 const { spawn } = require("node:child_process");
 
 function pkg() {
-  // Resolve package.json next to this file regardless of install location
-  const p = path.join(__dirname, "package.json");
-  try { return require(p); } catch { return { version: "" }; }
+	// Resolve package.json next to this file regardless of install location
+	const p = path.join(__dirname, "package.json");
+	try {
+		return require(p);
+	} catch {
+		return { version: "" };
+	}
 }
 
 function assetName() {
-  const p = process.platform;
-  const a = process.arch;
-  if (p === "darwin" && a === "arm64") return "solforge-darwin-arm64";
-  if (p === "darwin" && a === "x64") return "solforge-darwin-x64";
-  if (p === "linux" && a === "x64") return "solforge-linux-x64";
-  if (p === "linux" && a === "arm64") return "solforge-linux-arm64";
-  if (p === "win32" && a === "x64") return "solforge-windows-x64.exe";
-  return null;
+	const p = process.platform;
+	const a = process.arch;
+	if (p === "darwin" && a === "arm64") return "solforge-darwin-arm64";
+	if (p === "darwin" && a === "x64") return "solforge-darwin-x64";
+	if (p === "linux" && a === "x64") return "solforge-linux-x64";
+	if (p === "linux" && a === "arm64") return "solforge-linux-arm64";
+	if (p === "win32" && a === "x64") return "solforge-windows-x64.exe";
+	return null;
 }
 
 function vendorPath() {
-  const name = assetName();
-  if (!name) return null;
-  return path.join(__dirname, "vendor", name);
+	const name = assetName();
+	if (!name) return null;
+	return path.join(__dirname, "vendor", name);
 }
 
 function download(url, outPath) {
-  return new Promise((resolve, reject) => {
-    const req = https.get(url, (res) => {
-      if ([301, 302, 307, 308].includes(res.statusCode) && res.headers.location) {
-        return resolve(download(res.headers.location, outPath));
-      }
-      if (res.statusCode !== 200) {
-        return reject(new Error(`HTTP ${res.statusCode}`));
-      }
-      const file = fs.createWriteStream(outPath, { mode: process.platform === "win32" ? undefined : 0o755 });
-      res.pipe(file);
-      file.on("finish", () => file.close(() => resolve()));
-      file.on("error", reject);
-    });
-    req.on("error", reject);
-  });
+	return new Promise((resolve, reject) => {
+		const req = https.get(url, (res) => {
+			if (
+				[301, 302, 307, 308].includes(res.statusCode) &&
+				res.headers.location
+			) {
+				return resolve(download(res.headers.location, outPath));
+			}
+			if (res.statusCode !== 200) {
+				return reject(new Error(`HTTP ${res.statusCode}`));
+			}
+			const file = fs.createWriteStream(outPath, {
+				mode: process.platform === "win32" ? undefined : 0o755,
+			});
+			res.pipe(file);
+			file.on("finish", () => file.close(() => resolve()));
+			file.on("error", reject);
+		});
+		req.on("error", reject);
+	});
 }
 
 async function ensureBinary() {
-  const vp = vendorPath();
-  if (!vp) return null;
-  if (fs.existsSync(vp)) return vp;
+	const vp = vendorPath();
+	if (!vp) return null;
+	if (fs.existsSync(vp)) return vp;
 
-  // Respect opt-out
-  if (String(process.env.SOLFORGE_SKIP_DOWNLOAD || "").toLowerCase() === "true") {
-    return null;
-  }
+	// Respect opt-out
+	if (
+		String(process.env.SOLFORGE_SKIP_DOWNLOAD || "").toLowerCase() === "true"
+	) {
+		return null;
+	}
 
-  const { version, repository } = pkg();
-  const repo = process.env.SOLFORGE_REPO || (repository && (typeof repository === "string" ? repository.replace(/^github:/, "") : (repository.url && (repository.url.match(/github\.com[:/](.+?)\.git$/) || [])[1]))) || "nitishxyz/solforge";
-  if (!version) return null;
-  const asset = path.basename(vp);
-  const url = `https://github.com/${repo}/releases/download/v${version}/${asset}`;
+	const { version, repository } = pkg();
+	const repo =
+		process.env.SOLFORGE_REPO ||
+		(repository &&
+			(typeof repository === "string"
+				? repository.replace(/^github:/, "")
+				: repository.url &&
+					(repository.url.match(/github\.com[:/](.+?)\.git$/) || [])[1])) ||
+		"nitishxyz/solforge";
+	if (!version) return null;
+	const asset = path.basename(vp);
+	const url = `https://github.com/${repo}/releases/download/v${version}/${asset}`;
 
-  try {
-    fs.mkdirSync(path.dirname(vp), { recursive: true });
-    await download(url, vp);
-    if (process.platform !== "win32") {
-      try { fs.chmodSync(vp, 0o755); } catch {}
-    }
-    return fs.existsSync(vp) ? vp : null;
-  } catch {
-    return null;
-  }
+	try {
+		fs.mkdirSync(path.dirname(vp), { recursive: true });
+		await download(url, vp);
+		if (process.platform !== "win32") {
+			try {
+				fs.chmodSync(vp, 0o755);
+			} catch {}
+		}
+		return fs.existsSync(vp) ? vp : null;
+	} catch {
+		return null;
+	}
 }
 
 function run(cmd, args) {
-  return new Promise((resolve) => {
-    const child = spawn(cmd, args, { stdio: "inherit" });
-    child.on("exit", (code) => resolve(typeof code === "number" ? code : 0));
-  });
+	return new Promise((resolve) => {
+		const child = spawn(cmd, args, { stdio: "inherit" });
+		child.on("exit", (code) => resolve(typeof code === "number" ? code : 0));
+	});
 }
 
 (async () => {
-  const vp = await ensureBinary();
-  if (vp) {
-    const code = await run(vp, process.argv.slice(2));
-    process.exit(code);
-  }
-  // Fallback: try to run TS entry via Bun
-  const bun = process.env.SOLFORGE_BUN || "bun";
-  const entry = path.join(__dirname, "src", "cli", "main.ts");
-  const code = await run(bun, [entry, ...process.argv.slice(2)]);
-  if (code !== 0) {
-    console.error("solforge: failed to run binary and Bun fallback. Install Bun or ensure a release asset exists.");
-  }
-  process.exit(code);
-})();
+	// Fast path for --version/--help without booting the app
+	const args = process.argv.slice(2);
+	if (
+		args.includes("-v") ||
+		args.includes("--version") ||
+		args[0] === "version"
+	) {
+		console.log(pkg().version || "");
+		process.exit(0);
+	}
+	if (args.includes("-h") || args.includes("--help") || args[0] === "help") {
+		console.log(`
+solforge <command>
+
+Commands:
+  (no command)        Run setup then start RPC & WS servers
+  rpc start           Start RPC & WS servers
+  start               Alias for 'rpc start'
+  config init         Create sf.config.json in CWD
+  config get <key>    Read a config value (dot path)
+  config set <k> <v>  Set a config value
+  airdrop --to <pubkey> --sol <amount>  Airdrop SOL via RPC faucet
+  mint                 Interactive: pick mint, receiver, amount
+  token clone <mint>  Clone SPL token mint + accounts
+  program clone <programId>              Clone program code (and optionally accounts)
+  program accounts clone <programId>     Clone accounts owned by program
 
+Options:
+  -h, --help          Show help
+  -v, --version       Show version
+  --network           Bind servers to 0.0.0.0 (LAN access)
+  -y, --ci            Non-interactive; auto-accept prompts (use existing config)
+`);
+		process.exit(0);
+	}
+
+	const vp = await ensureBinary();
+	if (vp) {
+		const code = await run(vp, process.argv.slice(2));
+		process.exit(code);
+	}
+	// Fallback: try to run TS entry via Bun
+	const bun = process.env.SOLFORGE_BUN || "bun";
+	const entry = path.join(__dirname, "src", "cli", "main.ts");
+	const code = await run(bun, [entry, ...process.argv.slice(2)]);
+	if (code !== 0) {
+		console.error(
+			"solforge: failed to run binary and Bun fallback. Install Bun or ensure a release asset exists.",
+		);
+	}
+	process.exit(code);
+})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solforge",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "module": "index.ts",
   "type": "module",
   "private": false,

package/scripts/install.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env sh
+set -e
+
+# SolForge installer (downloads GitHub release binary)
+# Usage: curl -fsSL https://sh.solforge.sh | sh
+# Optional: SOLFORGE_VERSION=v0.2.5 curl -fsSL https://sh.solforge.sh | sh
+
+REPO="nitishxyz/solforge"
+BIN_NAME="solforge"
+VERSION="${SOLFORGE_VERSION:-latest}"
+
+info() { printf "\033[1;34m[i]\033[0m %s\n" "$*"; }
+warn() { printf "\033[1;33m[!]\033[0m %s\n" "$*"; }
+err()  { printf "\033[1;31m[x]\033[0m %s\n" "$*" 1>&2; }
+
+# Detect downloader
+http_get() {
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL "$1"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -qO- "$1"
+  else
+    err "Need 'curl' or 'wget' to download binaries"
+    exit 1
+  fi
+}
+
+http_down() {
+  dest="$2"
+  if command -v curl >/dev/null 2>&1; then
+    curl -fL --progress-bar -o "$dest" "$1"
+  else
+    wget -qO "$dest" "$1"
+  fi
+}
+
+# OS/arch detection
+uname_s=$(uname -s 2>/dev/null || echo unknown)
+uname_m=$(uname -m 2>/dev/null || echo unknown)
+
+case "$uname_s" in
+  Linux)  os="linux" ;;
+  Darwin) os="darwin" ;;
+  *) err "Unsupported OS: $uname_s"; exit 1 ;;
+esac
+
+case "$uname_m" in
+  x86_64|amd64) arch="x64" ;;
+  arm64|aarch64) arch="arm64" ;;
+  *) err "Unsupported architecture: $uname_m"; exit 1 ;;
+esac
+
+asset="${BIN_NAME}-${os}-${arch}"
+ext=""
+filename="$asset$ext"
+
+# Build URL
+if [ "$VERSION" = "latest" ]; then
+  base="https://github.com/$REPO/releases/latest/download"
+else
+  base="https://github.com/$REPO/releases/download/$VERSION"
+fi
+
+url="$base/$filename"
+
+info "Installing $BIN_NAME ($os/$arch) from: $url"
+
+# Download
+tmpdir=${TMPDIR:-/tmp}
+tmpfile="$tmpdir/$filename"
+http_down "$url" "$tmpfile"
+
+# Make executable
+chmod +x "$tmpfile"
+
+# Choose install dir
+install_dir="/usr/local/bin"
+if [ ! -w "$install_dir" ]; then
+  if command -v sudo >/dev/null 2>&1; then
+    sudo_cmd="sudo"
+  else
+    sudo_cmd=""
+  fi
+fi
+
+if [ -n "$sudo_cmd" ] && [ -d "$install_dir" ] && [ ! -w "$install_dir" ]; then
+  info "Moving binary to $install_dir (requires sudo)"
+  $sudo_cmd mv "$tmpfile" "$install_dir/$BIN_NAME"
+else
+  # Fallback to user bin
+  user_bin="$HOME/.local/bin"
+  mkdir -p "$user_bin"
+  info "Moving binary to $user_bin"
+  mv "$tmpfile" "$user_bin/$BIN_NAME"
+  install_dir="$user_bin"
+fi
+
+# Verify
+if "$install_dir/$BIN_NAME" --version >/dev/null 2>&1; then
+  ver=$("$install_dir/$BIN_NAME" --version 2>/dev/null || true)
+  info "$BIN_NAME installed: $ver"
+else
+  warn "Installed, but failed to run --version"
+fi
+
+# PATH hint
+case ":$PATH:" in
+  *":$install_dir:"*) :;;
+  *) warn "Add $install_dir to your PATH to use '$BIN_NAME'" ;;
+esac
+
+info "Done. Run: $BIN_NAME --help"

package/scripts/postinstall.cjs

@@ -9,61 +9,62 @@ const path = require("path");
 const https = require("https");
 
 function log(msg) {
-  console.log(`[solforge] ${msg}`);
+	console.log(`[solforge] ${msg}`);
 }
 function warn(msg) {
-  console.warn(`[solforge] ${msg}`);
+	console.warn(`[solforge] ${msg}`);
 }
 
 if (String(process.env.SOLFORGE_SKIP_DOWNLOAD || "").toLowerCase() === "true") {
-  log("Skipping binary download due to SOLFORGE_SKIP_DOWNLOAD=true");
-  process.exit(0);
+	log("Skipping binary download due to SOLFORGE_SKIP_DOWNLOAD=true");
+	process.exit(0);
 }
 
 function assetName() {
-  const p = process.platform;
-  const a = process.arch;
-  if (p === "darwin" && a === "arm64") return "solforge-darwin-arm64";
-  if (p === "darwin" && a === "x64") return "solforge-darwin-x64";
-  if (p === "linux" && a === "x64") return "solforge-linux-x64";
-  if (p === "linux" && a === "arm64") return "solforge-linux-arm64";
-  if (p === "win32" && a === "x64") return "solforge-windows-x64.exe";
-  return null;
+	const p = process.platform;
+	const a = process.arch;
+	if (p === "darwin" && a === "arm64") return "solforge-darwin-arm64";
+	if (p === "darwin" && a === "x64") return "solforge-darwin-x64";
+	if (p === "linux" && a === "x64") return "solforge-linux-x64";
+	if (p === "linux" && a === "arm64") return "solforge-linux-arm64";
+	if (p === "win32" && a === "x64") return "solforge-windows-x64.exe";
+	return null;
 }
 
 function getRepo() {
-  try {
-    const pkg = require(path.join(__dirname, "..", "package.json"));
-    if (pkg.repository) {
-      if (typeof pkg.repository === "string") return pkg.repository.replace(/^github:/, "");
-      if (pkg.repository.url) {
-        const m = pkg.repository.url.match(/github\.com[:/](.+?)\.git$/);
-        if (m) return m[1];
-      }
-    }
-  } catch {}
-  return process.env.SOLFORGE_REPO || "nitishxyz/solforge";
+	try {
+		const pkg = require(path.join(__dirname, "..", "package.json"));
+		if (pkg.repository) {
+			if (typeof pkg.repository === "string")
+				return pkg.repository.replace(/^github:/, "");
+			if (pkg.repository.url) {
+				const m = pkg.repository.url.match(/github\.com[:/](.+?)\.git$/);
+				if (m) return m[1];
+			}
+		}
+	} catch {}
+	return process.env.SOLFORGE_REPO || "nitishxyz/solforge";
 }
 
 function getVersion() {
-  try {
-    const pkg = require(path.join(__dirname, "..", "package.json"));
-    return pkg.version;
-  } catch {
-    return process.env.npm_package_version || "";
-  }
+	try {
+		const pkg = require(path.join(__dirname, "..", "package.json"));
+		return pkg.version;
+	} catch {
+		return process.env.npm_package_version || "";
+	}
 }
 
 const name = assetName();
 if (!name) {
-  warn(`No prebuilt binary for ${process.platform}/${process.arch}; skipping`);
-  process.exit(0);
+	warn(`No prebuilt binary for ${process.platform}/${process.arch}; skipping`);
+	process.exit(0);
 }
 
 const version = getVersion();
 if (!version) {
-  warn("Unable to determine package version; skipping binary download");
-  process.exit(0);
+	warn("Unable to determine package version; skipping binary download");
+	process.exit(0);
 }
 
 const repo = getRepo();
@@ -73,38 +74,45 @@ const vendorDir = path.join(__dirname, "..", "vendor");
 const outPath = path.join(vendorDir, name);
 
 if (fs.existsSync(outPath)) {
-  log(`Binary already present at vendor/${name}`);
-  process.exit(0);
+	log(`Binary already present at vendor/${name}`);
+	process.exit(0);
 }
 
 fs.mkdirSync(vendorDir, { recursive: true });
 
 function download(to, from, cb, redirects = 0) {
-  const req = https.get(from, (res) => {
-    if ([301, 302, 307, 308].includes(res.statusCode) && res.headers.location && redirects < 5) {
-      return download(to, res.headers.location, cb, redirects + 1);
-    }
-    if (res.statusCode !== 200) {
-      return cb(new Error(`HTTP ${res.statusCode} for ${from}`));
-    }
-    const file = fs.createWriteStream(to, { mode: 0o755 });
-    res.pipe(file);
-    file.on("finish", () => file.close(cb));
-  });
-  req.on("error", (err) => cb(err));
+	const req = https.get(from, (res) => {
+		if (
+			[301, 302, 307, 308].includes(res.statusCode) &&
+			res.headers.location &&
+			redirects < 5
+		) {
+			return download(to, res.headers.location, cb, redirects + 1);
+		}
+		if (res.statusCode !== 200) {
+			return cb(new Error(`HTTP ${res.statusCode} for ${from}`));
+		}
+		const file = fs.createWriteStream(to, { mode: 0o755 });
+		res.pipe(file);
+		file.on("finish", () => file.close(cb));
+	});
+	req.on("error", (err) => cb(err));
 }
 
 log(`Fetching ${name} for v${version}...`);
 download(outPath, url, (err) => {
-  if (err) {
-    warn(`Could not download prebuilt binary: ${err.message}`);
-    warn("CLI will fall back to running via Bun if available.");
-    try { fs.unlinkSync(outPath); } catch {}
-    process.exit(0);
-  }
-  if (process.platform !== "win32") {
-    try { fs.chmodSync(outPath, 0o755); } catch {}
-  }
-  log(`Installed vendor/${name}`);
+	if (err) {
+		warn(`Could not download prebuilt binary: ${err.message}`);
+		warn("CLI will fall back to running via Bun if available.");
+		try {
+			fs.unlinkSync(outPath);
+		} catch {}
+		process.exit(0);
+	}
+	if (process.platform !== "win32") {
+		try {
+			fs.chmodSync(outPath, 0o755);
+		} catch {}
+	}
+	log(`Installed vendor/${name}`);
 });
-

package/server/methods/program/get-token-accounts-by-owner.ts

@@ -359,12 +359,17 @@ export const getTokenAccountsByOwner: RpcMethodHandler = async (
 				}
 
 				// Build filtered list keeping only chosen indices
-				const keep = new Set<number>(Array.from(pick.values()).filter((v) => typeof v === "number" && v >= 0));
+				const keep = new Set<number>(
+					Array.from(pick.values()).filter(
+						(v) => typeof v === "number" && v >= 0,
+					),
+				);
 				const filtered: any[] = [];
 				for (let i = 0; i < out.length; i++) {
 					const e = out[i];
 					const info = e.account?.data?.parsed?.info;
-					const key = info?.owner && info?.mint ? `${info.owner}:${info.mint}` : null;
+					const key =
+						info?.owner && info?.mint ? `${info.owner}:${info.mint}` : null;
 					if (key && keep.has(i)) filtered.push(e);
 					else if (!key) filtered.push(e); // non-parsed or unexpected shape
 				}

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>();
@@ -67,6 +68,7 @@ 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;
 			return new Response("Not a websocket", { status: 400 });
@@ -160,7 +162,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: () => {