solforge 0.2.11 → 0.2.13

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 (175) hide show
  1. package/package.json +4 -8
  2. package/docs/API.md +0 -379
  3. package/docs/CONFIGURATION.md +0 -407
  4. package/docs/bun-single-file-executable.md +0 -585
  5. package/docs/cli-plan.md +0 -154
  6. package/docs/data-indexing-plan.md +0 -214
  7. package/docs/gui-roadmap.md +0 -202
  8. package/scripts/decode-b58.ts +0 -10
  9. package/scripts/install.sh +0 -112
  10. package/server/index.ts +0 -5
  11. package/server/lib/base58.ts +0 -33
  12. package/server/lib/faucet.ts +0 -110
  13. package/server/lib/instruction-parser.ts +0 -328
  14. package/server/lib/parsers/spl-associated-token-account.ts +0 -50
  15. package/server/lib/parsers/spl-token.ts +0 -340
  16. package/server/lib/spl-token.ts +0 -57
  17. package/server/methods/TEMPLATE.md +0 -117
  18. package/server/methods/account/get-account-info.ts +0 -86
  19. package/server/methods/account/get-balance.ts +0 -23
  20. package/server/methods/account/get-multiple-accounts.ts +0 -84
  21. package/server/methods/account/get-parsed-account-info.ts +0 -17
  22. package/server/methods/account/index.ts +0 -12
  23. package/server/methods/account/parsers/index.ts +0 -52
  24. package/server/methods/account/parsers/loader-upgradeable.ts +0 -79
  25. package/server/methods/account/parsers/spl-token.ts +0 -256
  26. package/server/methods/account/parsers/system.ts +0 -4
  27. package/server/methods/account/request-airdrop.ts +0 -271
  28. package/server/methods/admin/adopt-mint-authority.ts +0 -94
  29. package/server/methods/admin/clone-program-accounts.ts +0 -55
  30. package/server/methods/admin/clone-program.ts +0 -152
  31. package/server/methods/admin/clone-token-accounts.ts +0 -117
  32. package/server/methods/admin/clone-token-mint.ts +0 -82
  33. package/server/methods/admin/create-mint.ts +0 -114
  34. package/server/methods/admin/create-token-account.ts +0 -137
  35. package/server/methods/admin/helpers.ts +0 -70
  36. package/server/methods/admin/index.ts +0 -10
  37. package/server/methods/admin/list-mints.ts +0 -21
  38. package/server/methods/admin/load-program.ts +0 -52
  39. package/server/methods/admin/mint-to.ts +0 -266
  40. package/server/methods/block/get-block-height.ts +0 -5
  41. package/server/methods/block/get-block.ts +0 -31
  42. package/server/methods/block/get-blocks-with-limit.ts +0 -19
  43. package/server/methods/block/get-latest-blockhash.ts +0 -12
  44. package/server/methods/block/get-slot.ts +0 -5
  45. package/server/methods/block/index.ts +0 -6
  46. package/server/methods/block/is-blockhash-valid.ts +0 -19
  47. package/server/methods/epoch/get-cluster-nodes.ts +0 -17
  48. package/server/methods/epoch/get-epoch-info.ts +0 -16
  49. package/server/methods/epoch/get-epoch-schedule.ts +0 -15
  50. package/server/methods/epoch/get-highest-snapshot-slot.ts +0 -9
  51. package/server/methods/epoch/get-leader-schedule.ts +0 -8
  52. package/server/methods/epoch/get-max-retransmit-slot.ts +0 -9
  53. package/server/methods/epoch/get-max-shred-insert-slot.ts +0 -9
  54. package/server/methods/epoch/get-slot-leader.ts +0 -6
  55. package/server/methods/epoch/get-slot-leaders.ts +0 -9
  56. package/server/methods/epoch/get-stake-activation.ts +0 -9
  57. package/server/methods/epoch/get-stake-minimum-delegation.ts +0 -9
  58. package/server/methods/epoch/get-vote-accounts.ts +0 -19
  59. package/server/methods/epoch/index.ts +0 -13
  60. package/server/methods/epoch/minimum-ledger-slot.ts +0 -5
  61. package/server/methods/fee/get-fee-calculator-for-blockhash.ts +0 -12
  62. package/server/methods/fee/get-fee-for-message.ts +0 -8
  63. package/server/methods/fee/get-fee-rate-governor.ts +0 -16
  64. package/server/methods/fee/get-fees.ts +0 -14
  65. package/server/methods/fee/get-recent-prioritization-fees.ts +0 -22
  66. package/server/methods/fee/index.ts +0 -5
  67. package/server/methods/get-address-lookup-table.ts +0 -27
  68. package/server/methods/index.ts +0 -265
  69. package/server/methods/performance/get-recent-performance-samples.ts +0 -25
  70. package/server/methods/performance/get-transaction-count.ts +0 -5
  71. package/server/methods/performance/index.ts +0 -2
  72. package/server/methods/program/get-block-commitment.ts +0 -9
  73. package/server/methods/program/get-block-production.ts +0 -14
  74. package/server/methods/program/get-block-time.ts +0 -21
  75. package/server/methods/program/get-blocks.ts +0 -11
  76. package/server/methods/program/get-first-available-block.ts +0 -9
  77. package/server/methods/program/get-genesis-hash.ts +0 -6
  78. package/server/methods/program/get-identity.ts +0 -6
  79. package/server/methods/program/get-inflation-governor.ts +0 -15
  80. package/server/methods/program/get-inflation-rate.ts +0 -10
  81. package/server/methods/program/get-inflation-reward.ts +0 -12
  82. package/server/methods/program/get-largest-accounts.ts +0 -8
  83. package/server/methods/program/get-parsed-program-accounts.ts +0 -12
  84. package/server/methods/program/get-parsed-token-accounts-by-delegate.ts +0 -12
  85. package/server/methods/program/get-parsed-token-accounts-by-owner.ts +0 -12
  86. package/server/methods/program/get-program-accounts.ts +0 -221
  87. package/server/methods/program/get-supply.ts +0 -13
  88. package/server/methods/program/get-token-account-balance.ts +0 -60
  89. package/server/methods/program/get-token-accounts-by-delegate.ts +0 -82
  90. package/server/methods/program/get-token-accounts-by-owner.ts +0 -416
  91. package/server/methods/program/get-token-largest-accounts.ts +0 -81
  92. package/server/methods/program/get-token-supply.ts +0 -39
  93. package/server/methods/program/index.ts +0 -21
  94. package/server/methods/solforge/index.ts +0 -158
  95. package/server/methods/system/get-health.ts +0 -5
  96. package/server/methods/system/get-minimum-balance-for-rent-exemption.ts +0 -13
  97. package/server/methods/system/get-version.ts +0 -9
  98. package/server/methods/system/index.ts +0 -3
  99. package/server/methods/transaction/get-confirmed-transaction.ts +0 -11
  100. package/server/methods/transaction/get-parsed-transaction.ts +0 -17
  101. package/server/methods/transaction/get-signature-statuses.ts +0 -79
  102. package/server/methods/transaction/get-signatures-for-address.ts +0 -41
  103. package/server/methods/transaction/get-transaction.ts +0 -639
  104. package/server/methods/transaction/index.ts +0 -7
  105. package/server/methods/transaction/inner-instructions.test.ts +0 -104
  106. package/server/methods/transaction/send-transaction.ts +0 -469
  107. package/server/methods/transaction/simulate-transaction.ts +0 -57
  108. package/server/rpc-server.ts +0 -521
  109. package/server/types.ts +0 -109
  110. package/server/ws-server.ts +0 -178
  111. package/src/api-server-entry.ts +0 -109
  112. package/src/cli/bootstrap.ts +0 -67
  113. package/src/cli/commands/airdrop.ts +0 -37
  114. package/src/cli/commands/config.ts +0 -39
  115. package/src/cli/commands/mint.ts +0 -187
  116. package/src/cli/commands/program-clone.ts +0 -122
  117. package/src/cli/commands/program-load.ts +0 -64
  118. package/src/cli/commands/rpc-start.ts +0 -49
  119. package/src/cli/commands/token-adopt-authority.ts +0 -37
  120. package/src/cli/commands/token-clone.ts +0 -112
  121. package/src/cli/commands/token-create.ts +0 -81
  122. package/src/cli/main.ts +0 -152
  123. package/src/cli/run-solforge.ts +0 -112
  124. package/src/cli/setup-utils.ts +0 -54
  125. package/src/cli/setup-wizard.ts +0 -258
  126. package/src/cli/utils/args.ts +0 -15
  127. package/src/commands/add-program.ts +0 -333
  128. package/src/commands/init.ts +0 -122
  129. package/src/commands/list.ts +0 -136
  130. package/src/commands/mint.ts +0 -287
  131. package/src/commands/start.ts +0 -881
  132. package/src/commands/status.ts +0 -99
  133. package/src/commands/stop.ts +0 -405
  134. package/src/config/index.ts +0 -146
  135. package/src/config/manager.ts +0 -157
  136. package/src/db/index.ts +0 -83
  137. package/src/db/schema/accounts.ts +0 -23
  138. package/src/db/schema/address-signatures.ts +0 -31
  139. package/src/db/schema/index.ts +0 -6
  140. package/src/db/schema/meta-kv.ts +0 -9
  141. package/src/db/schema/transactions.ts +0 -36
  142. package/src/db/schema/tx-account-states.ts +0 -23
  143. package/src/db/schema/tx-accounts.ts +0 -33
  144. package/src/db/tx-store.ts +0 -264
  145. package/src/gui/public/app.css +0 -1556
  146. package/src/gui/public/build/main.css +0 -1569
  147. package/src/gui/public/build/main.js +0 -303
  148. package/src/gui/public/build/main.js.txt +0 -231
  149. package/src/gui/public/index.html +0 -19
  150. package/src/gui/server.ts +0 -296
  151. package/src/gui/src/api.ts +0 -127
  152. package/src/gui/src/app.tsx +0 -441
  153. package/src/gui/src/components/airdrop-mint-form.tsx +0 -246
  154. package/src/gui/src/components/clone-program-modal.tsx +0 -202
  155. package/src/gui/src/components/clone-token-modal.tsx +0 -230
  156. package/src/gui/src/components/modal.tsx +0 -134
  157. package/src/gui/src/components/programs-panel.tsx +0 -124
  158. package/src/gui/src/components/status-panel.tsx +0 -136
  159. package/src/gui/src/components/tokens-panel.tsx +0 -122
  160. package/src/gui/src/hooks/use-interval.ts +0 -17
  161. package/src/gui/src/index.css +0 -557
  162. package/src/gui/src/main.tsx +0 -17
  163. package/src/index.ts +0 -216
  164. package/src/migrations-bundled.ts +0 -23
  165. package/src/rpc/start.ts +0 -44
  166. package/src/services/api-server.ts +0 -504
  167. package/src/services/port-manager.ts +0 -174
  168. package/src/services/process-registry.ts +0 -153
  169. package/src/services/program-cloner.ts +0 -317
  170. package/src/services/token-cloner.ts +0 -811
  171. package/src/services/validator.ts +0 -293
  172. package/src/types/config.ts +0 -110
  173. package/src/utils/shell.ts +0 -110
  174. package/src/utils/token-loader.ts +0 -115
  175. /package/{start.js → start.cjs} +0 -0
package/src/index.ts DELETED
@@ -1,216 +0,0 @@
1
- #!/usr/bin/env bun
2
-
3
- // Suppress bigint-buffer warning
4
- const originalStderrWrite = process.stderr.write.bind(process.stderr);
5
- process.stderr.write = ((
6
- chunk: unknown,
7
- encoding?: unknown,
8
- callback?: unknown,
9
- ) => {
10
- if (
11
- typeof chunk === "string" &&
12
- chunk.includes("bigint: Failed to load bindings")
13
- ) {
14
- return true; // Suppress this specific warning
15
- }
16
- const writer = originalStderrWrite as unknown as (
17
- chunk: string | Uint8Array,
18
- encoding?: BufferEncoding,
19
- callback?: ((err?: Error) => void) | undefined,
20
- ) => boolean;
21
- return writer(
22
- chunk as string | Uint8Array,
23
- encoding as BufferEncoding | undefined,
24
- callback as ((err?: Error) => void) | undefined,
25
- );
26
- }) as typeof process.stderr.write;
27
-
28
- import chalk from "chalk";
29
- import { Command } from "commander";
30
- import { existsSync } from "node:fs";
31
- import { resolve } from "node:path";
32
- import packageJson from "../package.json" with { type: "json" };
33
- import { addProgramCommand } from "./commands/add-program.js";
34
- import { initCommand } from "./commands/init.js";
35
- import { listCommand } from "./commands/list.js";
36
- import { mintCommand } from "./commands/mint.js";
37
- import { startCommand } from "./commands/start.js";
38
- import { statusCommand } from "./commands/status.js";
39
- import { killCommand, stopCommand } from "./commands/stop.js";
40
-
41
- const program = new Command();
42
-
43
- program
44
- .name("solforge")
45
- .description("Solana localnet orchestration tool")
46
- .version(packageJson.version);
47
-
48
- // Check for sf.config.json in current directory
49
- function findConfig(): string | null {
50
- const configPath = resolve(process.cwd(), "sf.config.json");
51
- return existsSync(configPath) ? configPath : null;
52
- }
53
-
54
- program
55
- .command("init")
56
- .description("Initialize a new sf.config.json in current directory")
57
- .action(async () => {
58
- console.log(chalk.blue("🚀 Initializing SolForge configuration..."));
59
- await initCommand();
60
- });
61
-
62
- program
63
- .command("start")
64
- .description("Start localnet with current sf.config.json")
65
- .option("--debug", "Enable debug logging to see commands and detailed output")
66
- .option(
67
- "--network",
68
- "Make API server accessible over network (binds to 0.0.0.0 instead of 127.0.0.1)",
69
- )
70
- .action(async (options) => {
71
- const configPath = findConfig();
72
- if (!configPath) {
73
- console.error(
74
- chalk.red("❌ No sf.config.json found in current directory"),
75
- );
76
- console.log(chalk.yellow("💡 Run `solforge init` to create one"));
77
- process.exit(1);
78
- }
79
-
80
- await startCommand(options.debug || false, options.network || false);
81
- });
82
-
83
- program
84
- .command("list")
85
- .description("List all running validators")
86
- .action(async () => {
87
- await listCommand();
88
- });
89
-
90
- program
91
- .command("stop")
92
- .description("Stop running validator(s)")
93
- .argument("[validator-id]", "ID of validator to stop")
94
- .option("--all", "Stop all running validators")
95
- .option("--kill", "Force kill the validator (SIGKILL instead of SIGTERM)")
96
- .action(async (validatorId, options) => {
97
- await stopCommand(validatorId, options);
98
- });
99
-
100
- program
101
- .command("kill")
102
- .description("Force kill running validator(s)")
103
- .argument("[validator-id]", "ID of validator to kill")
104
- .option("--all", "Kill all running validators")
105
- .action(async (validatorId, options) => {
106
- await killCommand(validatorId, options);
107
- });
108
-
109
- program
110
- .command("api-server")
111
- .description("Start API server standalone")
112
- .option("-p, --port <port>", "Port for API server", "3000")
113
- .option(
114
- "--host <host>",
115
- "Host to bind to (default: 127.0.0.1, use 0.0.0.0 for network access)",
116
- )
117
- .option("--rpc-url <url>", "Validator RPC URL", "http://127.0.0.1:8899")
118
- .option("--faucet-url <url>", "Validator faucet URL", "http://127.0.0.1:9900")
119
- .option("--work-dir <dir>", "Work directory", "./.solforge")
120
- .action(async (options) => {
121
- const configPath = findConfig();
122
- if (!configPath) {
123
- console.error(
124
- chalk.red("❌ No sf.config.json found in current directory"),
125
- );
126
- console.log(chalk.yellow("💡 Run `solforge init` to create one"));
127
- process.exit(1);
128
- }
129
-
130
- // Import API server components
131
- const { APIServer } = await import("./services/api-server.js");
132
- const { configManager } = await import("./config/manager.js");
133
-
134
- try {
135
- await configManager.load(configPath);
136
- const config = configManager.getConfig();
137
-
138
- const apiServer = new APIServer({
139
- port: parseInt(options.port, 10),
140
- host: options.host,
141
- validatorRpcUrl: options.rpcUrl,
142
- validatorFaucetUrl: options.faucetUrl,
143
- config,
144
- workDir: options.workDir,
145
- });
146
-
147
- const result = await apiServer.start();
148
- if (result.success) {
149
- console.log(chalk.green("✅ API Server started successfully!"));
150
-
151
- // Keep the process alive
152
- process.on("SIGTERM", async () => {
153
- console.log(
154
- chalk.yellow("📡 API Server received SIGTERM, shutting down..."),
155
- );
156
- await apiServer.stop();
157
- process.exit(0);
158
- });
159
-
160
- process.on("SIGINT", async () => {
161
- console.log(
162
- chalk.yellow("📡 API Server received SIGINT, shutting down..."),
163
- );
164
- await apiServer.stop();
165
- process.exit(0);
166
- });
167
-
168
- // Keep process alive
169
- setInterval(() => {}, 1000);
170
- } else {
171
- console.error(
172
- chalk.red(`❌ Failed to start API server: ${result.error}`),
173
- );
174
- process.exit(1);
175
- }
176
- } catch (error) {
177
- console.error(
178
- chalk.red(
179
- `❌ API Server error: ${
180
- error instanceof Error ? error.message : String(error)
181
- }`,
182
- ),
183
- );
184
- process.exit(1);
185
- }
186
- });
187
-
188
- program
189
- .command("add-program")
190
- .description("Add a program to sf.config.json")
191
-
192
- .option("--program-id <address>", "Mainnet program ID to clone and deploy")
193
- .option("--name <name>", "Friendly name for the program")
194
- .option("--no-interactive", "Run in non-interactive mode")
195
- .action(async (options) => {
196
- await addProgramCommand(options);
197
- });
198
-
199
- program
200
- .command("status")
201
- .description("Show localnet status")
202
- .action(async () => {
203
- await statusCommand();
204
- });
205
-
206
- program.addCommand(mintCommand);
207
-
208
- program
209
- .command("reset")
210
- .description("Reset localnet ledger")
211
- .action(async () => {
212
- console.log(chalk.blue("🔄 Resetting localnet..."));
213
- // TODO: Implement reset
214
- });
215
-
216
- program.parse();
@@ -1,23 +0,0 @@
1
- // Bundled Drizzle migrations for single-binary builds
2
- // These imports ensure Bun embeds the SQL files into the executable.
3
- // Order matters: keep in incremental order.
4
-
5
- // eslint-disable-next-line @typescript-eslint/ban-ts-comment
6
- // @ts-expect-error - Bun import attributes
7
- import mig0000 from "../drizzle/0000_friendly_millenium_guard.sql" with {
8
- type: "file",
9
- };
10
- // eslint-disable-next-line @typescript-eslint/ban-ts-comment
11
- // @ts-expect-error - Bun import attributes
12
- import mig0001 from "../drizzle/0001_stale_sentinels.sql" with { type: "file" };
13
- // eslint-disable-next-line @typescript-eslint/ban-ts-comment
14
- // @ts-expect-error - Bun import attributes
15
- import mig0002 from "../drizzle/0002_graceful_caretaker.sql" with {
16
- type: "file",
17
- };
18
-
19
- export const bundledMigrations: Array<{ name: string; path: string }> = [
20
- { name: "0000_friendly_millenium_guard.sql", path: mig0000 },
21
- { name: "0001_stale_sentinels.sql", path: mig0001 },
22
- { name: "0002_graceful_caretaker.sql", path: mig0002 },
23
- ];
package/src/rpc/start.ts DELETED
@@ -1,44 +0,0 @@
1
- import {
2
- createLiteSVMRpcServer,
3
- createLiteSVMWebSocketServer,
4
- } from "../../server";
5
- import { startGuiServer } from "../gui/server";
6
-
7
- export interface RpcStartOptions {
8
- rpcPort?: number;
9
- wsPort?: number;
10
- dbMode?: "ephemeral" | "persistent";
11
- dbPath?: string;
12
- host?: string;
13
- guiEnabled?: boolean;
14
- guiPort?: number;
15
- }
16
-
17
- export function startRpcServers(opts: RpcStartOptions = {}) {
18
- const rpcPort = Number(opts.rpcPort ?? (process.env.RPC_PORT || 8899));
19
- const wsPort = Number(opts.wsPort ?? rpcPort + 1);
20
- const host = String(opts.host ?? process.env.RPC_HOST ?? "127.0.0.1");
21
- const guiEnabled = opts.guiEnabled !== false;
22
- const guiPort = Number(
23
- opts.guiPort ?? process.env.SOLFORGE_GUI_PORT ?? 42069,
24
- );
25
-
26
- if (opts.dbMode) process.env.SOLFORGE_DB_MODE = opts.dbMode;
27
- if (opts.dbPath) process.env.SOLFORGE_DB_PATH = opts.dbPath;
28
-
29
- const { httpServer, rpcServer } = createLiteSVMRpcServer(rpcPort, host);
30
- const { wsServer } = createLiteSVMWebSocketServer(rpcServer, wsPort, host);
31
- const guiServer = guiEnabled
32
- ? startGuiServer({ port: guiPort, host, rpcPort, rpcServer })
33
- : null;
34
-
35
- return {
36
- httpServer,
37
- rpcServer,
38
- wsServer,
39
- rpcPort,
40
- wsPort,
41
- guiPort: guiServer ? guiServer.port : null,
42
- guiServer,
43
- };
44
- }