solforge 0.1.6 → 0.2.0

package/src/db/tx-store.ts

@@ -0,0 +1,229 @@
+import { and, desc, eq, gt, inArray, lt } from "drizzle-orm";
+import { db } from "./index";
+import { accounts } from "./schema/accounts";
+import { addressSignatures } from "./schema/address-signatures";
+import { transactions } from "./schema/transactions";
+import { txAccounts } from "./schema/tx-accounts";
+
+export type InsertTxBundle = {
+	signature: string;
+	slot: number;
+	blockTime?: number;
+	version: 0 | "legacy";
+	fee: number;
+	err: unknown | null;
+	rawBase64: string;
+	preBalances: number[];
+	postBalances: number[];
+	logs: string[];
+	accounts: Array<{
+		address: string;
+		index: number;
+		signer: boolean;
+		writable: boolean;
+		programIdIndex?: number;
+	}>;
+	preTokenBalances?: any[];
+	postTokenBalances?: any[];
+};
+
+export type AccountSnapshot = {
+	address: string;
+	lamports: number;
+	ownerProgram: string;
+	executable: boolean;
+	rentEpoch: number;
+	dataLen: number;
+	dataBase64?: string | null;
+	lastSlot: number;
+};
+
+export class TxStore {
+	async insertTransactionBundle(bundle: InsertTxBundle): Promise<void> {
+		const errJson = bundle.err ? JSON.stringify(bundle.err) : null;
+		await db.transaction(async (tx) => {
+			await tx
+				.insert(transactions)
+				.values({
+					signature: bundle.signature,
+					slot: bundle.slot,
+					blockTime: bundle.blockTime ?? null,
+					version: String(bundle.version),
+					errJson,
+					fee: bundle.fee,
+					rawBase64: bundle.rawBase64,
+					preBalancesJson: JSON.stringify(bundle.preBalances ?? []),
+					postBalancesJson: JSON.stringify(bundle.postBalances ?? []),
+					logsJson: JSON.stringify(bundle.logs ?? []),
+					preTokenBalancesJson: JSON.stringify(bundle.preTokenBalances ?? []),
+					postTokenBalancesJson: JSON.stringify(bundle.postTokenBalances ?? []),
+				})
+				.onConflictDoNothing();
+
+			if (Array.isArray(bundle.accounts) && bundle.accounts.length > 0) {
+				await tx
+					.insert(txAccounts)
+					.values(
+						bundle.accounts.map((a) => ({
+							signature: bundle.signature,
+							accountIndex: a.index,
+							address: a.address,
+							signer: a.signer ? 1 : 0,
+							writable: a.writable ? 1 : 0,
+							programIdIndex: a.programIdIndex ?? null,
+						})),
+					)
+					.onConflictDoNothing();
+
+				await tx
+					.insert(addressSignatures)
+					.values(
+						bundle.accounts.map((a) => ({
+							address: a.address,
+							signature: bundle.signature,
+							slot: bundle.slot,
+							err: errJson ? 1 : 0,
+							blockTime: bundle.blockTime ?? null,
+						})),
+					)
+					.onConflictDoNothing();
+			}
+		});
+	}
+
+	async upsertAccounts(snapshots: AccountSnapshot[]): Promise<void> {
+		if (!Array.isArray(snapshots) || snapshots.length === 0) return;
+		// SQLite upsert via onConflictDoUpdate
+		for (const s of snapshots) {
+			await db
+				.insert(accounts)
+				.values({
+					address: s.address,
+					lamports: s.lamports,
+					ownerProgram: s.ownerProgram,
+					executable: s.executable ? 1 : 0,
+					rentEpoch: s.rentEpoch,
+					dataLen: s.dataLen,
+					dataBase64: s.dataBase64 ?? null,
+					lastSlot: s.lastSlot,
+				})
+				.onConflictDoUpdate({
+					target: accounts.address,
+					set: {
+						lamports: s.lamports,
+						ownerProgram: s.ownerProgram,
+						executable: s.executable ? 1 : 0,
+						rentEpoch: s.rentEpoch,
+						dataLen: s.dataLen,
+						dataBase64: s.dataBase64 ?? null,
+						lastSlot: s.lastSlot,
+					},
+				});
+		}
+	}
+
+	async getTransaction(signature: string) {
+		const rows = await db
+			.select()
+			.from(transactions)
+			.where(eq(transactions.signature, signature))
+			.limit(1);
+		return rows[0] || null;
+	}
+
+	async getStatuses(signatures: string[]) {
+		if (!Array.isArray(signatures) || signatures.length === 0)
+			return new Map<string, { slot: number; err: any | null }>();
+		const results = await db
+			.select({
+				signature: transactions.signature,
+				slot: transactions.slot,
+				errJson: transactions.errJson,
+			})
+			.from(transactions)
+			.where(inArraySafe(transactions.signature, signatures));
+		const map = new Map<string, { slot: number; err: any | null }>();
+		for (const r of results)
+			map.set(r.signature, {
+				slot: Number(r.slot),
+				err: r.errJson ? safeParse(r.errJson) : null,
+			});
+		return map;
+	}
+
+	async getSignaturesForAddress(
+		address: string,
+		opts: { before?: string; until?: string; limit?: number } = {},
+	) {
+		let beforeSlot: number | undefined;
+		let untilSlot: number | undefined;
+		if (opts.before) {
+			const row = await this.getTransaction(opts.before);
+			beforeSlot = row?.slot ? Number(row.slot) : undefined;
+		}
+		if (opts.until) {
+			const row = await this.getTransaction(opts.until);
+			untilSlot = row?.slot ? Number(row.slot) : undefined;
+		}
+		const limit = Math.min(Math.max(opts.limit ?? 1000, 1), 1000);
+
+		const whereClauses = [eq(addressSignatures.address, address)] as any[];
+		if (typeof beforeSlot === "number")
+			whereClauses.push(lt(addressSignatures.slot, beforeSlot));
+		if (typeof untilSlot === "number")
+			whereClauses.push(gt(addressSignatures.slot, untilSlot));
+
+		const rows = await db
+			.select({
+				signature: addressSignatures.signature,
+				slot: addressSignatures.slot,
+				blockTime: addressSignatures.blockTime,
+				err: addressSignatures.err,
+			})
+			.from(addressSignatures)
+			.where(and(...whereClauses))
+			.orderBy(desc(addressSignatures.slot))
+			.limit(limit);
+
+		return rows.map((r) => ({
+			signature: r.signature,
+			slot: Number(r.slot),
+			err: r.err ? {} : null,
+			memo: null as null,
+			blockTime: r.blockTime ? Number(r.blockTime) : null,
+			confirmationStatus: r.err ? "processed" : "confirmed",
+		}));
+	}
+
+	async getAccountsByOwner(ownerProgram: string, limit = 1000) {
+		const rows = await db
+			.select()
+			.from(accounts)
+			.where(eq(accounts.ownerProgram, ownerProgram))
+			.orderBy(desc(accounts.lastSlot))
+			.limit(Math.min(Math.max(limit, 1), 1000));
+		return rows;
+	}
+
+	async getBlockTimeForSlot(slot: number): Promise<number | null> {
+		const rows = await db
+			.select({ bt: transactions.blockTime })
+			.from(transactions)
+			.where(eq(transactions.slot, slot))
+			.limit(1);
+		const r = rows[0];
+		return r?.bt != null ? Number(r.bt) : null;
+	}
+}
+
+function safeParse<T = any>(s: string): T | null {
+	try {
+		return JSON.parse(s) as T;
+	} catch {
+		return null;
+	}
+}
+
+function inArraySafe<T>(col: any, arr: T[]) {
+	return arr.length > 0 ? inArray(col, arr as any) : eq(col, "__never__");
+}

package/src/gui/public/app.css

@@ -0,0 +1 @@
+*,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }/*! tailwindcss v3.4.17 | MIT License | https://tailwindcss.com*/*,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}:host,html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-feature-settings:normal;font-variation-settings:normal;-webkit-tap-highlight-color:transparent}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-variation-settings:normal;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-feature-settings:inherit;font-variation-settings:inherit;font-size:100%;font-weight:inherit;line-height:inherit;letter-spacing:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]:where(:not([hidden=until-found])){display:none}.glass-panel{border-radius:1rem;border-width:1px;background:linear-gradient(135deg,hsla(0,0%,100%,.03),hsla(0,0%,100%,.01));border-color:var(--color-border-default);backdrop-filter:blur(20px);box-shadow:var(--shadow-xl),inset 0 1px 0 0 hsla(0,0%,100%,.05);transition:var(--transition-base)}.glass-panel:hover{border-color:var(--color-border-strong);box-shadow:var(--shadow-2xl),var(--shadow-glow),inset 0 1px 0 0 hsla(0,0%,100%,.08)}.card{border-radius:.75rem;padding:1.5rem;background:var(--color-bg-surface);border:1px solid var(--color-border-subtle);transition:var(--transition-smooth);animation:fadeIn .5s ease-out}.card:hover{background:var(--color-bg-elevated);border-color:var(--color-border-default);transform:translateY(-2px);box-shadow:var(--shadow-lg)}.btn-primary{display:inline-flex;align-items:center;justify-content:center;gap:.5rem;border-radius:.75rem;padding:.625rem 1.25rem;font-weight:500;transition:var(--transition-base);position:relative;overflow:hidden;text-transform:none;letter-spacing:.01em;background:linear-gradient(135deg,var(--color-accent-primary),var(--color-accent-secondary));color:#fff;box-shadow:0 4px 15px rgba(139,92,246,.3)}.btn-primary:hover{box-shadow:0 6px 25px rgba(139,92,246,.5);transform:translateY(-2px)}.btn-primary:active{transform:translateY(0)}.btn-secondary{display:inline-flex;align-items:center;justify-content:center;gap:.5rem;border-radius:.75rem;padding:.625rem 1.25rem;font-weight:500;transition:var(--transition-base);position:relative;overflow:hidden;text-transform:none;letter-spacing:.01em;background:var(--color-bg-elevated);color:var(--color-text-primary);border:1px solid var(--color-border-default)}.btn-secondary:hover{background:var(--color-bg-hover);border-color:var(--color-accent-primary);box-shadow:inset 0 0 0 1px var(--color-accent-primary)}.btn-icon{display:inline-flex;align-items:center;justify-content:center;width:40px;height:40px;border-radius:12px;background:var(--color-bg-elevated);border:1px solid var(--color-border-subtle);color:var(--color-text-secondary);transition:var(--transition-base)}.btn-icon:hover{background:var(--color-bg-hover);color:var(--color-accent-primary);border-color:var(--color-accent-primary);transform:scale(1.05)}.\!input,.input{width:100%;border-radius:.75rem;padding:.75rem 1rem;font-size:.875rem;line-height:1.25rem}.\!input{background:var(--color-bg-surface)!important;border:1px solid var(--color-border-subtle)!important;color:var(--color-text-primary)!important;transition:var(--transition-base)!important;font-family:Inter,sans-serif!important}.input{background:var(--color-bg-surface);border:1px solid var(--color-border-subtle);color:var(--color-text-primary);transition:var(--transition-base);font-family:Inter,sans-serif}.\!input:hover{background:var(--color-bg-elevated)!important;border-color:var(--color-border-default)!important}.input:hover{background:var(--color-bg-elevated);border-color:var(--color-border-default)}.\!input:focus{outline:none!important;border-color:var(--color-accent-primary)!important;box-shadow:0 0 0 3px var(--color-accent-glow)!important;background:var(--color-bg-elevated)!important}.input:focus{outline:none;border-color:var(--color-accent-primary);box-shadow:0 0 0 3px var(--color-accent-glow);background:var(--color-bg-elevated)}.\!input::-moz-placeholder{color:var(--color-text-muted)!important}.\!input::placeholder{color:var(--color-text-muted)!important}.input::-moz-placeholder{color:var(--color-text-muted)}.input::placeholder{color:var(--color-text-muted)}.select{width:100%;border-radius:.75rem;padding:.75rem 1rem;font-size:.875rem;line-height:1.25rem;background:var(--color-bg-surface);border:1px solid var(--color-border-subtle);color:var(--color-text-primary);transition:var(--transition-base);font-family:Inter,sans-serif}.select:hover{border-color:var(--color-border-default)}.select:focus,.select:hover{background:var(--color-bg-elevated)}.select:focus{outline:none;border-color:var(--color-accent-primary);box-shadow:0 0 0 3px var(--color-accent-glow)}.select::-moz-placeholder{color:var(--color-text-muted)}.select::placeholder{color:var(--color-text-muted)}.select{cursor:pointer;padding-right:40px;background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='%239ca3af' viewBox='0 0 24 24'%3E%3Cpath stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='m19 9-7 7-7-7'/%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right 12px center;background-size:20px}.checkbox{height:1.25rem;width:1.25rem;border-radius:.375rem;background:var(--color-bg-surface);border:1px solid var(--color-border-default);cursor:pointer;transition:var(--transition-base)}.checkbox:checked{background:linear-gradient(135deg,var(--color-accent-primary),var(--color-accent-secondary));border-color:var(--color-accent-primary)}.checkbox:focus{outline:none;box-shadow:0 0 0 3px var(--color-accent-glow)}.table-modern{width:100%;border-collapse:separate;border-spacing:0}.table-modern thead{background:var(--color-bg-surface)}.table-modern th{text-align:left;font-size:.75rem;line-height:1rem;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--color-text-tertiary)}.table-modern td,.table-modern th{padding:.75rem 1rem;border-bottom:1px solid var(--color-border-subtle)}.table-modern td{font-size:.875rem;line-height:1.25rem;color:var(--color-text-primary)}.table-modern tbody tr{transition:var(--transition-base)}.badge,.table-modern tbody tr:hover{background:var(--color-bg-elevated)}.badge{display:inline-flex;align-items:center;gap:.375rem;border-radius:9999px;padding:.25rem .75rem;font-size:.75rem;line-height:1rem;font-weight:500;color:var(--color-text-secondary);border:1px solid var(--color-border-subtle)}.badge-success{background:rgba(16,185,129,.1);color:#10b981;border-color:rgba(16,185,129,.2)}.badge-warning{background:rgba(245,158,11,.1);color:#f59e0b;border-color:rgba(245,158,11,.2)}.badge-info{background:rgba(59,130,246,.1);color:#3b82f6;border-color:rgba(59,130,246,.2)}.spinner{border:3px solid var(--color-border-subtle);border-top-color:var(--color-accent-primary);border-radius:50%;width:20px;height:20px;animation:spin 1s linear infinite}.tooltip.show{opacity:1}.status-dot{display:inline-block;height:.5rem;width:.5rem;border-radius:9999px;animation:pulse 2s infinite}.status-dot.online{background:var(--color-success);box-shadow:0 0 8px var(--color-success)}.status-dot.offline{background:var(--color-text-muted)}.status-dot.error{background:var(--color-error);box-shadow:0 0 8px var(--color-error)}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.inset-0{inset:0}.left-0{left:0}.left-3{left:.75rem}.left-4{left:1rem}.top-0{top:0}.top-1\/2{top:50%}.top-4{top:1rem}.z-30{z-index:30}.z-40{z-index:40}.z-50{z-index:50}.mx-auto{margin-left:auto;margin-right:auto}.mb-1{margin-bottom:.25rem}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-6{margin-bottom:1.5rem}.ml-8{margin-left:2rem}.mr-1{margin-right:.25rem}.mt-0\.5{margin-top:.125rem}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-6{margin-top:1.5rem}.block{display:block}.flex{display:flex}.table{display:table}.grid{display:grid}.hidden{display:none}.h-10{height:2.5rem}.h-12{height:3rem}.h-16{height:4rem}.h-full{height:100%}.max-h-\[60vh\]{max-height:60vh}.min-h-screen{min-height:100vh}.w-10{width:2.5rem}.w-12{width:3rem}.w-16{width:4rem}.w-5{width:1.25rem}.w-72{width:18rem}.w-full{width:100%}.max-w-7xl{max-width:80rem}.max-w-lg{max-width:32rem}.flex-1{flex:1 1 0%}.-translate-x-full{--tw-translate-x:-100%}.-translate-x-full,.-translate-y-1\/2{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.-translate-y-1\/2{--tw-translate-y:-50%}.translate-x-0{--tw-translate-x:0px}.transform,.translate-x-0{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}@keyframes spin{to{transform:rotate(1turn)}}.animate-spin{animation:spin 1s linear infinite}.cursor-not-allowed{cursor:not-allowed}.cursor-pointer{cursor:pointer}.scroll-mt-24{scroll-margin-top:6rem}.appearance-none{-webkit-appearance:none;-moz-appearance:none;appearance:none}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-start{align-items:flex-start}.items-center{align-items:center}.items-stretch{align-items:stretch}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.gap-4{gap:1rem}.space-y-2>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(.5rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.5rem*var(--tw-space-y-reverse))}.space-y-3>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(.75rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.75rem*var(--tw-space-y-reverse))}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1rem*var(--tw-space-y-reverse))}.space-y-5>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1.25rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1.25rem*var(--tw-space-y-reverse))}.space-y-6>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(1.5rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(1.5rem*var(--tw-space-y-reverse))}.space-y-8>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(2rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(2rem*var(--tw-space-y-reverse))}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.break-all{word-break:break-all}.rounded-2xl{border-radius:1rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-none{border-radius:0}.rounded-xl{border-radius:.75rem}.border{border-width:1px}.border-b{border-bottom-width:1px}.border-r{border-right-width:1px}.border-t{border-top-width:1px}.border-green-500\/30{border-color:rgba(34,197,94,.3)}.border-purple-500\/30{border-color:rgba(168,85,247,.3)}.border-red-500\/30{border-color:rgba(239,68,68,.3)}.border-white\/10{border-color:hsla(0,0%,100%,.1)}.border-white\/20{border-color:hsla(0,0%,100%,.2)}.border-white\/5{border-color:hsla(0,0%,100%,.05)}.bg-black\/50{background-color:rgba(0,0,0,.5)}.bg-black\/80{background-color:rgba(0,0,0,.8)}.bg-gray-900\/95{background-color:rgba(17,24,39,.95)}.bg-green-500\/10{background-color:rgba(34,197,94,.1)}.bg-red-500\/10{background-color:rgba(239,68,68,.1)}.bg-white\/5{background-color:hsla(0,0%,100%,.05)}.bg-gradient-to-br{background-image:linear-gradient(to bottom right,var(--tw-gradient-stops))}.bg-gradient-to-r{background-image:linear-gradient(to right,var(--tw-gradient-stops))}.from-amber-500\/20{--tw-gradient-from:rgba(245,158,11,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(245,158,11,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-amber-600\/20{--tw-gradient-from:rgba(217,119,6,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(217,119,6,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-blue-500\/20{--tw-gradient-from:rgba(59,130,246,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(59,130,246,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-blue-600\/20{--tw-gradient-from:rgba(37,99,235,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(37,99,235,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-gray-600\/20{--tw-gradient-from:rgba(75,85,99,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(75,85,99,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-green-500\/20{--tw-gradient-from:rgba(34,197,94,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(34,197,94,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-purple-400{--tw-gradient-from:#c084fc var(--tw-gradient-from-position);--tw-gradient-to:rgba(192,132,252,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-purple-500\/20{--tw-gradient-from:rgba(168,85,247,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(168,85,247,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-purple-600{--tw-gradient-from:#9333ea var(--tw-gradient-from-position);--tw-gradient-to:rgba(147,51,234,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-purple-600\/20{--tw-gradient-from:rgba(147,51,234,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(147,51,234,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-red-500\/10{--tw-gradient-from:rgba(239,68,68,.1) var(--tw-gradient-from-position);--tw-gradient-to:rgba(239,68,68,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-violet-500\/20{--tw-gradient-from:rgba(139,92,246,.2) var(--tw-gradient-from-position);--tw-gradient-to:rgba(139,92,246,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.from-white\/5{--tw-gradient-from:hsla(0,0%,100%,.05) var(--tw-gradient-from-position);--tw-gradient-to:hsla(0,0%,100%,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.to-cyan-500\/20{--tw-gradient-to:rgba(6,182,212,.2) var(--tw-gradient-to-position)}.to-cyan-600\/20{--tw-gradient-to:rgba(8,145,178,.2) var(--tw-gradient-to-position)}.to-emerald-500\/20{--tw-gradient-to:rgba(16,185,129,.2) var(--tw-gradient-to-position)}.to-gray-700\/20{--tw-gradient-to:rgba(55,65,81,.2) var(--tw-gradient-to-position)}.to-orange-500\/20{--tw-gradient-to:rgba(249,115,22,.2) var(--tw-gradient-to-position)}.to-orange-600\/20{--tw-gradient-to:rgba(234,88,12,.2) var(--tw-gradient-to-position)}.to-pink-500\/10{--tw-gradient-to:rgba(236,72,153,.1) var(--tw-gradient-to-position)}.to-purple-500\/20{--tw-gradient-to:rgba(168,85,247,.2) var(--tw-gradient-to-position)}.to-transparent{--tw-gradient-to:transparent var(--tw-gradient-to-position)}.to-violet-400{--tw-gradient-to:#a78bfa var(--tw-gradient-to-position)}.to-violet-500\/20{--tw-gradient-to:rgba(139,92,246,.2) var(--tw-gradient-to-position)}.to-violet-600{--tw-gradient-to:#7c3aed var(--tw-gradient-to-position)}.to-violet-600\/20{--tw-gradient-to:rgba(124,58,237,.2) var(--tw-gradient-to-position)}.bg-clip-text{-webkit-background-clip:text;background-clip:text}.p-0{padding:0}.p-3{padding:.75rem}.p-4{padding:1rem}.p-6{padding:1.5rem}.px-4{padding-left:1rem;padding-right:1rem}.py-12{padding-top:3rem;padding-bottom:3rem}.py-3{padding-top:.75rem;padding-bottom:.75rem}.pl-10{padding-left:2.5rem}.pt-2{padding-top:.5rem}.pt-3{padding-top:.75rem}.text-left{text-align:left}.text-center{text-align:center}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-sm{font-size:.875rem;line-height:1.25rem}.text-xl{font-size:1.25rem;line-height:1.75rem}.text-xs{font-size:.75rem;line-height:1rem}.font-bold{font-weight:700}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.tracking-wider{letter-spacing:.05em}.text-amber-300{--tw-text-opacity:1;color:rgb(252 211 77/var(--tw-text-opacity,1))}.text-amber-400{--tw-text-opacity:1;color:rgb(251 191 36/var(--tw-text-opacity,1))}.text-amber-500{--tw-text-opacity:1;color:rgb(245 158 11/var(--tw-text-opacity,1))}.text-blue-300{--tw-text-opacity:1;color:rgb(147 197 253/var(--tw-text-opacity,1))}.text-blue-400{--tw-text-opacity:1;color:rgb(96 165 250/var(--tw-text-opacity,1))}.text-blue-500{--tw-text-opacity:1;color:rgb(59 130 246/var(--tw-text-opacity,1))}.text-gray-300{--tw-text-opacity:1;color:rgb(209 213 219/var(--tw-text-opacity,1))}.text-gray-400{--tw-text-opacity:1;color:rgb(156 163 175/var(--tw-text-opacity,1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128/var(--tw-text-opacity,1))}.text-green-300{--tw-text-opacity:1;color:rgb(134 239 172/var(--tw-text-opacity,1))}.text-green-400{--tw-text-opacity:1;color:rgb(74 222 128/var(--tw-text-opacity,1))}.text-purple-300{--tw-text-opacity:1;color:rgb(216 180 254/var(--tw-text-opacity,1))}.text-purple-400{--tw-text-opacity:1;color:rgb(192 132 252/var(--tw-text-opacity,1))}.text-red-300{--tw-text-opacity:1;color:rgb(252 165 165/var(--tw-text-opacity,1))}.text-red-400{--tw-text-opacity:1;color:rgb(248 113 113/var(--tw-text-opacity,1))}.text-transparent{color:transparent}.text-violet-300{--tw-text-opacity:1;color:rgb(196 181 253/var(--tw-text-opacity,1))}.text-violet-400{--tw-text-opacity:1;color:rgb(167 139 250/var(--tw-text-opacity,1))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity,1))}.opacity-50{opacity:.5}.shadow-2xl{--tw-shadow:0 25px 50px -12px rgba(0,0,0,.25);--tw-shadow-colored:0 25px 50px -12px var(--tw-shadow-color)}.shadow-2xl,.shadow-lg{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-lg{--tw-shadow:0 10px 15px -3px rgba(0,0,0,.1),0 4px 6px -4px rgba(0,0,0,.1);--tw-shadow-colored:0 10px 15px -3px var(--tw-shadow-color),0 4px 6px -4px var(--tw-shadow-color)}.backdrop-blur-sm{--tw-backdrop-blur:blur(4px)}.backdrop-blur-sm,.backdrop-blur-xl{backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia)}.backdrop-blur-xl{--tw-backdrop-blur:blur(24px)}.transition-all{transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-colors{transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.transition-transform{transition-property:transform;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.duration-200{transition-duration:.2s}.duration-300{transition-duration:.3s}.ease-out{transition-timing-function:cubic-bezier(0,0,.2,1)}:root{color-scheme:dark;--color-bg-base:#0a0a0f;--color-bg-surface:#12121a;--color-bg-elevated:#1a1a24;--color-bg-hover:#22222e;--color-bg-active:#2a2a38;--color-accent-primary:#8b5cf6;--color-accent-secondary:#a78bfa;--color-accent-tertiary:#c4b5fd;--color-accent-glow:rgba(139,92,246,.4);--color-success:#10b981;--color-warning:#f59e0b;--color-error:#ef4444;--color-info:#3b82f6;--color-text-primary:#f3f4f6;--color-text-secondary:#9ca3af;--color-text-tertiary:#6b7280;--color-text-muted:#4b5563;--color-border-subtle:hsla(0,0%,100%,.06);--color-border-default:hsla(0,0%,100%,.1);--color-border-strong:hsla(0,0%,100%,.15);--shadow-sm:0 1px 2px 0 rgba(0,0,0,.05);--shadow-md:0 4px 6px -1px rgba(0,0,0,.1),0 2px 4px -2px rgba(0,0,0,.1);--shadow-lg:0 10px 15px -3px rgba(0,0,0,.1),0 4px 6px -4px rgba(0,0,0,.1);--shadow-xl:0 20px 25px -5px rgba(0,0,0,.1),0 8px 10px -6px rgba(0,0,0,.1);--shadow-2xl:0 25px 50px -12px rgba(0,0,0,.25);--shadow-glow:0 0 50px rgba(139,92,246,.3);--transition-base:all 0.2s cubic-bezier(0.4,0,0.2,1);--transition-smooth:all 0.3s cubic-bezier(0.4,0,0.2,1);--transition-spring:all 0.5s cubic-bezier(0.68,-0.55,0.265,1.55)}*{box-sizing:border-box;margin:0;padding:0}html{font-family:Inter,system-ui,-apple-system,sans-serif;font-feature-settings:"cv11","ss01";font-variation-settings:"opsz" 32;scroll-behavior:smooth}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;background:var(--color-bg-base);color:var(--color-text-primary);min-height:100vh;position:relative;overflow-x:hidden}body:before{content:"";position:fixed;top:0;left:0;right:0;bottom:0;background:radial-gradient(ellipse at top left,rgba(139,92,246,.15) 0,transparent 50%),radial-gradient(ellipse at bottom right,rgba(167,139,250,.1) 0,transparent 50%);pointer-events:none;z-index:0}#root{position:relative;z-index:1}::-webkit-scrollbar{width:12px;height:12px}::-webkit-scrollbar-track{background:var(--color-bg-surface);border-radius:6px}::-webkit-scrollbar-thumb{background:linear-gradient(180deg,var(--color-accent-primary),var(--color-accent-secondary));border-radius:6px;border:2px solid var(--color-bg-surface)}::-webkit-scrollbar-thumb:hover{background:linear-gradient(180deg,var(--color-accent-secondary),var(--color-accent-tertiary))}@keyframes fadeIn{0%{opacity:0;transform:translateY(10px)}to{opacity:1;transform:translateY(0)}}@keyframes slideIn{0%{opacity:0;transform:translateX(-20px)}to{opacity:1;transform:translateX(0)}}@keyframes pulse{0%,to{opacity:1}50%{opacity:.5}}@keyframes shimmer{0%{background-position:-1000px 0}to{background-position:1000px 0}}@keyframes glow{0%,to{box-shadow:0 0 20px rgba(139,92,246,.5),inset 0 0 20px rgba(139,92,246,.1)}50%{box-shadow:0 0 40px rgba(139,92,246,.8),inset 0 0 30px rgba(139,92,246,.2)}}.text-mono{font-family:JetBrains Mono,monospace}:focus-visible{outline:2px solid var(--color-accent-primary);outline-offset:2px}::-moz-selection{background:var(--color-accent-primary);color:#fff}::selection{background:var(--color-accent-primary);color:#fff}.hover\:scale-\[1\.02\]:hover{--tw-scale-x:1.02;--tw-scale-y:1.02;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.hover\:border-red-500\/30:hover{border-color:rgba(239,68,68,.3)}.hover\:bg-red-500\/20:hover{background-color:rgba(239,68,68,.2)}.hover\:bg-white\/5:hover{background-color:hsla(0,0%,100%,.05)}.hover\:text-red-300:hover{--tw-text-opacity:1;color:rgb(252 165 165/var(--tw-text-opacity,1))}.hover\:text-red-400:hover{--tw-text-opacity:1;color:rgb(248 113 113/var(--tw-text-opacity,1))}.group:hover .group-hover\:scale-110{--tw-scale-x:1.1;--tw-scale-y:1.1;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.group:hover .group-hover\:text-purple-300{--tw-text-opacity:1;color:rgb(216 180 254/var(--tw-text-opacity,1))}@media (min-width:640px){.sm\:flex-initial{flex:0 1 auto}.sm\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.sm\:flex-row{flex-direction:row}.sm\:items-center{align-items:center}}@media (min-width:768px){.md\:block{display:block}.md\:hidden{display:none}.md\:flex-row{flex-direction:row}.md\:items-center{align-items:center}.md\:justify-between{justify-content:space-between}.md\:p-8{padding:2rem}}@media (min-width:1024px){.lg\:ml-72{margin-left:18rem}.lg\:hidden{display:none}.lg\:translate-x-0{--tw-translate-x:0px;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.lg\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.lg\:grid-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}.lg\:flex-row{flex-direction:row}.lg\:items-center{align-items:center}}

package/src/gui/public/index.html

@@ -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

@@ -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 };