npm - solforge - Versions diffs - 0.1.7 → 0.2.1 - Mend

solforge 0.1.7 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (151) hide show

package/README.md +367 -393
package/docs/API.md +379 -0
package/docs/CONFIGURATION.md +407 -0
package/docs/bun-single-file-executable.md +585 -0
package/docs/cli-plan.md +154 -0
package/docs/data-indexing-plan.md +214 -0
package/docs/gui-roadmap.md +202 -0
package/package.json +38 -51
package/server/index.ts +5 -0
package/server/lib/base58.ts +33 -0
package/server/lib/faucet.ts +110 -0
package/server/lib/spl-token.ts +57 -0
package/server/methods/TEMPLATE.md +117 -0
package/server/methods/account/get-account-info.ts +90 -0
package/server/methods/account/get-balance.ts +27 -0
package/server/methods/account/get-multiple-accounts.ts +83 -0
package/server/methods/account/get-parsed-account-info.ts +21 -0
package/server/methods/account/index.ts +12 -0
package/server/methods/account/parsers/index.ts +52 -0
package/server/methods/account/parsers/loader-upgradeable.ts +66 -0
package/server/methods/account/parsers/spl-token.ts +237 -0
package/server/methods/account/parsers/system.ts +4 -0
package/server/methods/account/request-airdrop.ts +219 -0
package/server/methods/admin/adopt-mint-authority.ts +94 -0
package/server/methods/admin/clone-program-accounts.ts +55 -0
package/server/methods/admin/clone-program.ts +152 -0
package/server/methods/admin/clone-token-accounts.ts +117 -0
package/server/methods/admin/clone-token-mint.ts +82 -0
package/server/methods/admin/create-mint.ts +114 -0
package/server/methods/admin/create-token-account.ts +137 -0
package/server/methods/admin/helpers.ts +70 -0
package/server/methods/admin/index.ts +10 -0
package/server/methods/admin/list-mints.ts +21 -0
package/server/methods/admin/load-program.ts +52 -0
package/server/methods/admin/mint-to.ts +278 -0
package/server/methods/block/get-block-height.ts +5 -0
package/server/methods/block/get-block.ts +35 -0
package/server/methods/block/get-blocks-with-limit.ts +23 -0
package/server/methods/block/get-latest-blockhash.ts +12 -0
package/server/methods/block/get-slot.ts +5 -0
package/server/methods/block/index.ts +6 -0
package/server/methods/block/is-blockhash-valid.ts +23 -0
package/server/methods/epoch/get-cluster-nodes.ts +17 -0
package/server/methods/epoch/get-epoch-info.ts +16 -0
package/server/methods/epoch/get-epoch-schedule.ts +15 -0
package/server/methods/epoch/get-highest-snapshot-slot.ts +9 -0
package/server/methods/epoch/get-leader-schedule.ts +8 -0
package/server/methods/epoch/get-max-retransmit-slot.ts +9 -0
package/server/methods/epoch/get-max-shred-insert-slot.ts +9 -0
package/server/methods/epoch/get-slot-leader.ts +6 -0
package/server/methods/epoch/get-slot-leaders.ts +9 -0
package/server/methods/epoch/get-stake-activation.ts +9 -0
package/server/methods/epoch/get-stake-minimum-delegation.ts +9 -0
package/server/methods/epoch/get-vote-accounts.ts +19 -0
package/server/methods/epoch/index.ts +13 -0
package/server/methods/epoch/minimum-ledger-slot.ts +5 -0
package/server/methods/fee/get-fee-calculator-for-blockhash.ts +12 -0
package/server/methods/fee/get-fee-for-message.ts +8 -0
package/server/methods/fee/get-fee-rate-governor.ts +16 -0
package/server/methods/fee/get-fees.ts +14 -0
package/server/methods/fee/get-recent-prioritization-fees.ts +22 -0
package/server/methods/fee/index.ts +5 -0
package/server/methods/get-address-lookup-table.ts +31 -0
package/server/methods/index.ts +265 -0
package/server/methods/performance/get-recent-performance-samples.ts +25 -0
package/server/methods/performance/get-transaction-count.ts +5 -0
package/server/methods/performance/index.ts +2 -0
package/server/methods/program/get-block-commitment.ts +9 -0
package/server/methods/program/get-block-production.ts +14 -0
package/server/methods/program/get-block-time.ts +21 -0
package/server/methods/program/get-blocks.ts +11 -0
package/server/methods/program/get-first-available-block.ts +9 -0
package/server/methods/program/get-genesis-hash.ts +6 -0
package/server/methods/program/get-identity.ts +6 -0
package/server/methods/program/get-inflation-governor.ts +15 -0
package/server/methods/program/get-inflation-rate.ts +10 -0
package/server/methods/program/get-inflation-reward.ts +12 -0
package/server/methods/program/get-largest-accounts.ts +8 -0
package/server/methods/program/get-parsed-program-accounts.ts +12 -0
package/server/methods/program/get-parsed-token-accounts-by-delegate.ts +12 -0
package/server/methods/program/get-parsed-token-accounts-by-owner.ts +12 -0
package/server/methods/program/get-program-accounts.ts +221 -0
package/server/methods/program/get-supply.ts +13 -0
package/server/methods/program/get-token-account-balance.ts +64 -0
package/server/methods/program/get-token-accounts-by-delegate.ts +81 -0
package/server/methods/program/get-token-accounts-by-owner.ts +390 -0
package/server/methods/program/get-token-largest-accounts.ts +80 -0
package/server/methods/program/get-token-supply.ts +38 -0
package/server/methods/program/index.ts +21 -0
package/server/methods/solforge/index.ts +155 -0
package/server/methods/system/get-health.ts +5 -0
package/server/methods/system/get-minimum-balance-for-rent-exemption.ts +13 -0
package/server/methods/system/get-version.ts +9 -0
package/server/methods/system/index.ts +3 -0
package/server/methods/transaction/get-confirmed-transaction.ts +11 -0
package/server/methods/transaction/get-parsed-transaction.ts +21 -0
package/server/methods/transaction/get-signature-statuses.ts +72 -0
package/server/methods/transaction/get-signatures-for-address.ts +45 -0
package/server/methods/transaction/get-transaction.ts +428 -0
package/server/methods/transaction/index.ts +7 -0
package/server/methods/transaction/send-transaction.ts +232 -0
package/server/methods/transaction/simulate-transaction.ts +56 -0
package/server/rpc-server.ts +474 -0
package/server/types.ts +74 -0
package/server/ws-server.ts +171 -0
package/src/cli/bootstrap.ts +67 -0
package/src/cli/commands/airdrop.ts +37 -0
package/src/cli/commands/config.ts +39 -0
package/src/cli/commands/mint.ts +187 -0
package/src/cli/commands/program-clone.ts +124 -0
package/src/cli/commands/program-load.ts +64 -0
package/src/cli/commands/rpc-start.ts +46 -0
package/src/cli/commands/token-adopt-authority.ts +37 -0
package/src/cli/commands/token-clone.ts +113 -0
package/src/cli/commands/token-create.ts +81 -0
package/src/cli/main.ts +130 -0
package/src/cli/run-solforge.ts +98 -0
package/src/cli/setup-utils.ts +54 -0
package/src/cli/setup-wizard.ts +256 -0
package/src/cli/utils/args.ts +15 -0
package/src/config/index.ts +130 -0
package/src/db/index.ts +83 -0
package/src/db/schema/accounts.ts +23 -0
package/src/db/schema/address-signatures.ts +31 -0
package/src/db/schema/index.ts +5 -0
package/src/db/schema/meta-kv.ts +9 -0
package/src/db/schema/transactions.ts +29 -0
package/src/db/schema/tx-accounts.ts +33 -0
package/src/db/tx-store.ts +229 -0
package/src/gui/public/app.css +1 -0
package/src/gui/public/build/main.css +1 -0
package/src/gui/public/build/main.js +303 -0
package/src/gui/public/build/main.js.txt +231 -0
package/src/gui/public/index.html +19 -0
package/src/gui/server.ts +297 -0
package/src/gui/src/api.ts +127 -0
package/src/gui/src/app.tsx +390 -0
package/src/gui/src/components/airdrop-mint-form.tsx +216 -0
package/src/gui/src/components/clone-program-modal.tsx +183 -0
package/src/gui/src/components/clone-token-modal.tsx +211 -0
package/src/gui/src/components/modal.tsx +127 -0
package/src/gui/src/components/programs-panel.tsx +112 -0
package/src/gui/src/components/status-panel.tsx +122 -0
package/src/gui/src/components/tokens-panel.tsx +116 -0
package/src/gui/src/hooks/use-interval.ts +17 -0
package/src/gui/src/index.css +529 -0
package/src/gui/src/main.tsx +17 -0
package/src/migrations-bundled.ts +17 -0
package/src/rpc/start.ts +44 -0
package/scripts/postinstall.cjs +0 -103
package/tsconfig.json +0 -28

package/src/gui/public/index.html ADDED Viewed

@@ -0,0 +1,19 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <meta name="color-scheme" content="dark" />
+    <meta name="theme-color" content="#0a0a0f" />
+    <title>SolForge - Solana Development Suite</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800;900&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css">
+  </head>
+  <body>
+    <link rel="stylesheet" href="./app.css" />
+    <div id="root"></div>
+    <script defer src="./build/main.js"></script>
+  </body>
+</html>

package/src/gui/server.ts ADDED Viewed

@@ -0,0 +1,297 @@
+import { serve } from "bun";
+import type { LiteSVMRpcServer } from "../../server/rpc-server";
+import type { JsonRpcResponse } from "../../server/types";
+import { readConfig, writeConfig } from "../config";
+import indexHtml from "./public/index.html";
+import { file } from "bun";
+// Embed built GUI assets as files so the compiled binary can stream them
+import appCssFile from "./public/app.css" with { type: "file" };
+import mainJsFile from "./public/build/main.js" with { type: "file" };
+import bundledCssFile from "./public/build/main.css" with { type: "file" };
+type GuiStartOptions = {
+	port?: number;
+	host?: string;
+	rpcPort?: number;
+	rpcServer?: LiteSVMRpcServer;
+};
+const LAMPORTS_PER_SOL = 1_000_000_000n;
+const CORS = {
+	"Access-Control-Allow-Origin": "*",
+	"Access-Control-Allow-Headers": "content-type",
+	"Access-Control-Allow-Methods": "GET,POST,OPTIONS",
+};
+class HttpError extends Error {
+	constructor(
+		public status: number,
+		message: string,
+		public details?: unknown,
+	) {
+		super(message);
+	}
+}
+const json = (data: unknown, status = 200) =>
+	new Response(JSON.stringify(data), {
+		status,
+		headers: { ...CORS, "Content-Type": "application/json" },
+	});
+const text = (value: string, status = 200) =>
+	new Response(value, {
+		status,
+		headers: { ...CORS, "Content-Type": "text/plain" },
+	});
+const okOptions = () => new Response(null, { status: 204, headers: CORS });
+const css = (fpath: string) =>
+    new Response(file(fpath), {
+        headers: { ...CORS, "Content-Type": "text/css" },
+    });
+const js = (fpath: string) =>
+    new Response(file(fpath), {
+        headers: { ...CORS, "Content-Type": "application/javascript" },
+    });
+const handleError = (error: unknown) => {
+	if (error instanceof HttpError)
+		return json({ error: error.message, details: error.details }, error.status);
+	console.error("[gui] API error", error);
+	return json({ error: "Internal server error" }, 500);
+};
+const wrap =
+	(handler: (req: Request) => Promise<unknown> | unknown) =>
+	async (req: Request) => {
+		try {
+			const result = await handler(req);
+			return result instanceof Response ? result : json(result);
+		} catch (error) {
+			return handleError(error);
+		}
+	};
+const readJson = async <T extends Record<string, unknown>>(
+	req: Request,
+): Promise<T> => {
+	try {
+		return (await req.json()) as T;
+	} catch (error) {
+		throw new HttpError(400, "Invalid JSON body", { cause: error });
+	}
+};
+const parseLamports = (payload: {
+	lamports?: string | number;
+	sol?: string | number;
+}) => {
+	if (payload.lamports != null) {
+		const lamports = BigInt(payload.lamports);
+		if (lamports <= 0n) throw new HttpError(400, "lamports must be positive");
+		return lamports;
+	}
+	if (payload.sol != null) {
+		const sol = Number(payload.sol);
+		if (!Number.isFinite(sol) || sol <= 0)
+			throw new HttpError(400, "sol must be positive");
+		return BigInt(Math.floor(sol * Number(LAMPORTS_PER_SOL)));
+	}
+	throw new HttpError(400, "lamports or sol is required");
+};
+export function startGuiServer(opts: GuiStartOptions = {}) {
+	const host = opts.host ?? "127.0.0.1";
+	const port = Number(opts.port ?? 42069);
+	const rpcPort = Number(opts.rpcPort ?? 8899);
+	const rpcServer = opts.rpcServer;
+	const rpcUrl = `http://${host}:${rpcPort}`;
+	const callRpc = async (method: string, params: any[] = []) => {
+		if (!rpcServer) throw new HttpError(503, "RPC server not available");
+		const response: JsonRpcResponse = await rpcServer.handleRequest({
+			jsonrpc: "2.0",
+			id: `gui-${Date.now()}`,
+			method,
+			params,
+		});
+		if (response.error)
+			throw new HttpError(
+				400,
+				response.error.message ?? "RPC error",
+				response.error,
+			);
+		return response.result;
+	};
+	async function recordTokenClone(mint: string) {
+		try {
+			const cfg = await readConfig();
+			const set = new Set(cfg.clone.tokens || []);
+			if (!set.has(mint)) {
+				set.add(mint);
+				cfg.clone.tokens = Array.from(set);
+				await writeConfig(cfg);
+			}
+		} catch (error) {
+			console.warn("[gui] failed to update config for token clone:", error);
+		}
+	}
+	async function recordProgramClone(programId: string) {
+		try {
+			const cfg = await readConfig();
+			const set = new Set(cfg.clone.programs || []);
+			if (!set.has(programId)) {
+				set.add(programId);
+				cfg.clone.programs = Array.from(set);
+				await writeConfig(cfg);
+			}
+		} catch (error) {
+			console.warn("[gui] failed to update config for program clone:", error);
+		}
+	}
+    const routes = {
+        "/": indexHtml,
+        "/app.css": { GET: () => css(appCssFile) },
+        "/build/main.css": { GET: () => css(bundledCssFile) },
+        "/build/main.js": { GET: () => js(mainJsFile) },
+		"/health": { GET: () => text("ok") },
+		"/api/config": { GET: () => json({ rpcUrl }), OPTIONS: okOptions },
+		"/api/status": {
+			GET: wrap(() => callRpc("solforgeGetStatus")),
+			OPTIONS: okOptions,
+		},
+		"/api/programs": {
+			GET: wrap(() => callRpc("solforgeListPrograms")),
+			OPTIONS: okOptions,
+		},
+		"/api/tokens": {
+			GET: wrap(() => callRpc("solforgeListTokensDetailed")),
+			OPTIONS: okOptions,
+		},
+		"/api/airdrop": {
+			POST: wrap(async (req) => {
+				const body = await readJson<{
+					address?: string;
+					lamports?: string | number;
+					sol?: string | number;
+				}>(req);
+				const address =
+					typeof body.address === "string" ? body.address.trim() : "";
+				if (!address) throw new HttpError(400, "address is required");
+				const lamports = parseLamports(body);
+				const signature = await callRpc("requestAirdrop", [
+					address,
+					Number(lamports),
+				]);
+				return { ok: true, signature };
+			}),
+			OPTIONS: okOptions,
+		},
+		"/api/mint": {
+			POST: wrap(async (req) => {
+				const body = await readJson<{
+					mint?: string;
+					owner?: string;
+					amountRaw?: string;
+				}>(req);
+				const mint = typeof body.mint === "string" ? body.mint.trim() : "";
+				const owner = typeof body.owner === "string" ? body.owner.trim() : "";
+				const amountRaw =
+					typeof body.amountRaw === "string" ? body.amountRaw.trim() : "";
+				if (!mint || !owner || !amountRaw)
+					throw new HttpError(400, "mint, owner and amountRaw are required");
+				return callRpc("solforgeMintTo", [mint, owner, amountRaw]);
+			}),
+			OPTIONS: okOptions,
+		},
+		"/api/clone/program": {
+			POST: wrap(async (req) => {
+				const body = await readJson<{
+					programId?: string;
+					endpoint?: string;
+					withAccounts?: boolean;
+					accountsLimit?: number;
+				}>(req);
+				const programId =
+					typeof body.programId === "string" ? body.programId.trim() : "";
+				if (!programId) throw new HttpError(400, "programId is required");
+				const endpoint =
+					typeof body.endpoint === "string" && body.endpoint.trim()
+						? body.endpoint.trim()
+						: undefined;
+				const withAccounts = body.withAccounts === true;
+				const accountsLimit =
+					typeof body.accountsLimit === "number"
+						? body.accountsLimit
+						: undefined;
+				const res = await callRpc("solforgeAdminCloneProgram", [
+					programId,
+					{ endpoint, withAccounts, accountsLimit },
+				]);
+				await recordProgramClone(programId);
+				return res;
+			}),
+			OPTIONS: okOptions,
+		},
+		"/api/clone/token": {
+			POST: wrap(async (req) => {
+				const body = await readJson<{
+					mint?: string;
+					endpoint?: string;
+					cloneAccounts?: boolean;
+					holders?: number;
+					allAccounts?: boolean;
+				}>(req);
+				const mint = typeof body.mint === "string" ? body.mint.trim() : "";
+				if (!mint) throw new HttpError(400, "mint is required");
+				const endpoint =
+					typeof body.endpoint === "string" && body.endpoint.trim()
+						? body.endpoint.trim()
+						: undefined;
+				const cloneAccounts = body.cloneAccounts === true;
+				const holders =
+					typeof body.holders === "number" ? body.holders : undefined;
+				const allAccounts = body.allAccounts === true;
+				const mintResult = await callRpc("solforgeAdminCloneTokenMint", [
+					mint,
+					{ endpoint },
+				]);
+				// Ensure local faucet is the mint authority so GUI minting works out of the box
+				try {
+					await callRpc("solforgeAdoptMintAuthority", [mint]);
+				} catch (e) {
+					console.warn("[gui] adopt mint authority failed (continuing)", e);
+				}
+				let accountsResult: unknown = null;
+				if (cloneAccounts) {
+					accountsResult = await callRpc("solforgeAdminCloneTokenAccounts", [
+						mint,
+						{ endpoint, holders, allAccounts },
+					]);
+				}
+				await recordTokenClone(mint);
+				return {
+					mint: mintResult,
+					adoptedAuthority: true,
+					accounts: accountsResult,
+				};
+			}),
+			OPTIONS: okOptions,
+		},
+	} as const;
+    const server = serve({
+        port,
+        hostname: host,
+        routes,
+        development: false,
+    });
+	console.log(`🖥️  Solforge GUI available at http://${host}:${server.port}`);
+	return { server, port: server.port };
+}
+export type { GuiStartOptions };

package/src/gui/src/api.ts ADDED Viewed

@@ -0,0 +1,127 @@
+export interface ApiConfig {
+	rpcUrl: string;
+}
+export interface ApiStatus {
+	slot: number;
+	slotBigint: string;
+	blockHeight: number;
+	blockHeightBigint: string;
+	txCount: number;
+	txCountBigint: string;
+	latestBlockhash: string;
+	faucet: {
+		address: string;
+		lamports: string;
+		sol: number;
+	};
+}
+export interface ProgramSummary {
+	programId: string;
+	owner: string;
+	executable: boolean;
+	dataLen: number;
+	lamports: string;
+}
+export interface TokenSummary {
+	mint: string;
+	supply: string;
+	decimals: number;
+	uiAmount: number;
+	uiAmountString: string;
+	mintAuthority: string | null;
+	isInitialized: boolean;
+}
+export interface AirdropPayload {
+	address: string;
+	lamports?: string | number;
+	sol?: string | number;
+}
+export interface MintPayload {
+	mint: string;
+	owner: string;
+	amountRaw: string;
+}
+export interface CloneProgramPayload {
+	programId: string;
+	endpoint?: string;
+	withAccounts?: boolean;
+	accountsLimit?: number;
+}
+export interface CloneTokenPayload {
+	mint: string;
+	endpoint?: string;
+	cloneAccounts?: boolean;
+	holders?: number;
+	allAccounts?: boolean;
+}
+interface ApiError {
+	error?: string;
+	details?: unknown;
+}
+async function request<T>(path: string, init: RequestInit = {}): Promise<T> {
+	const headers = new Headers(init.headers ?? {});
+	if (!headers.has("content-type") && init.body)
+		headers.set("content-type", "application/json");
+	const response = await fetch(path, { ...init, headers });
+	let payload: any = null;
+	const text = await response.text();
+	if (text) {
+		try {
+			payload = JSON.parse(text);
+		} catch (error) {
+			throw new Error(
+				`Failed to parse response from ${path}: ${String(error)}`,
+			);
+		}
+	}
+	if (!response.ok) {
+		const errPayload = payload as ApiError | null;
+		const message =
+			errPayload?.error || response.statusText || "Request failed";
+		throw new Error(message);
+	}
+	return payload as T;
+}
+export const fetchConfig = () => request<ApiConfig>("/api/config");
+export const fetchStatus = () => request<ApiStatus>("/api/status");
+export const fetchPrograms = () => request<ProgramSummary[]>("/api/programs");
+export const fetchTokens = () => request<TokenSummary[]>("/api/tokens");
+export const submitAirdrop = (body: AirdropPayload) =>
+	request<{ ok: boolean; signature?: string }>("/api/airdrop", {
+		method: "POST",
+		body: JSON.stringify(body),
+	});
+export const submitMint = (body: MintPayload) =>
+	request<
+		| {
+				ok: boolean;
+				signature?: string;
+				mint: string;
+				owner: string;
+				amount: string;
+		  }
+		| Record<string, unknown>
+	>("/api/mint", {
+		method: "POST",
+		body: JSON.stringify(body),
+	});
+export const cloneProgram = (body: CloneProgramPayload) =>
+	request<Record<string, unknown>>("/api/clone/program", {
+		method: "POST",
+		body: JSON.stringify(body),
+	});
+export const cloneToken = (body: CloneTokenPayload) =>
+	request<Record<string, unknown>>("/api/clone/token", {
+		method: "POST",
+		body: JSON.stringify(body),
+	});