solforge 0.2.12 → 0.2.14

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 +1 -5
  2. package/start.cjs +19 -23
  3. package/docs/API.md +0 -379
  4. package/docs/CONFIGURATION.md +0 -407
  5. package/docs/bun-single-file-executable.md +0 -585
  6. package/docs/cli-plan.md +0 -154
  7. package/docs/data-indexing-plan.md +0 -214
  8. package/docs/gui-roadmap.md +0 -202
  9. package/scripts/decode-b58.ts +0 -10
  10. package/scripts/install.sh +0 -112
  11. package/server/index.ts +0 -5
  12. package/server/lib/base58.ts +0 -33
  13. package/server/lib/faucet.ts +0 -110
  14. package/server/lib/instruction-parser.ts +0 -328
  15. package/server/lib/parsers/spl-associated-token-account.ts +0 -50
  16. package/server/lib/parsers/spl-token.ts +0 -340
  17. package/server/lib/spl-token.ts +0 -57
  18. package/server/methods/TEMPLATE.md +0 -117
  19. package/server/methods/account/get-account-info.ts +0 -86
  20. package/server/methods/account/get-balance.ts +0 -23
  21. package/server/methods/account/get-multiple-accounts.ts +0 -84
  22. package/server/methods/account/get-parsed-account-info.ts +0 -17
  23. package/server/methods/account/index.ts +0 -12
  24. package/server/methods/account/parsers/index.ts +0 -52
  25. package/server/methods/account/parsers/loader-upgradeable.ts +0 -79
  26. package/server/methods/account/parsers/spl-token.ts +0 -256
  27. package/server/methods/account/parsers/system.ts +0 -4
  28. package/server/methods/account/request-airdrop.ts +0 -271
  29. package/server/methods/admin/adopt-mint-authority.ts +0 -94
  30. package/server/methods/admin/clone-program-accounts.ts +0 -55
  31. package/server/methods/admin/clone-program.ts +0 -152
  32. package/server/methods/admin/clone-token-accounts.ts +0 -117
  33. package/server/methods/admin/clone-token-mint.ts +0 -82
  34. package/server/methods/admin/create-mint.ts +0 -114
  35. package/server/methods/admin/create-token-account.ts +0 -137
  36. package/server/methods/admin/helpers.ts +0 -70
  37. package/server/methods/admin/index.ts +0 -10
  38. package/server/methods/admin/list-mints.ts +0 -21
  39. package/server/methods/admin/load-program.ts +0 -52
  40. package/server/methods/admin/mint-to.ts +0 -266
  41. package/server/methods/block/get-block-height.ts +0 -5
  42. package/server/methods/block/get-block.ts +0 -31
  43. package/server/methods/block/get-blocks-with-limit.ts +0 -19
  44. package/server/methods/block/get-latest-blockhash.ts +0 -12
  45. package/server/methods/block/get-slot.ts +0 -5
  46. package/server/methods/block/index.ts +0 -6
  47. package/server/methods/block/is-blockhash-valid.ts +0 -19
  48. package/server/methods/epoch/get-cluster-nodes.ts +0 -17
  49. package/server/methods/epoch/get-epoch-info.ts +0 -16
  50. package/server/methods/epoch/get-epoch-schedule.ts +0 -15
  51. package/server/methods/epoch/get-highest-snapshot-slot.ts +0 -9
  52. package/server/methods/epoch/get-leader-schedule.ts +0 -8
  53. package/server/methods/epoch/get-max-retransmit-slot.ts +0 -9
  54. package/server/methods/epoch/get-max-shred-insert-slot.ts +0 -9
  55. package/server/methods/epoch/get-slot-leader.ts +0 -6
  56. package/server/methods/epoch/get-slot-leaders.ts +0 -9
  57. package/server/methods/epoch/get-stake-activation.ts +0 -9
  58. package/server/methods/epoch/get-stake-minimum-delegation.ts +0 -9
  59. package/server/methods/epoch/get-vote-accounts.ts +0 -19
  60. package/server/methods/epoch/index.ts +0 -13
  61. package/server/methods/epoch/minimum-ledger-slot.ts +0 -5
  62. package/server/methods/fee/get-fee-calculator-for-blockhash.ts +0 -12
  63. package/server/methods/fee/get-fee-for-message.ts +0 -8
  64. package/server/methods/fee/get-fee-rate-governor.ts +0 -16
  65. package/server/methods/fee/get-fees.ts +0 -14
  66. package/server/methods/fee/get-recent-prioritization-fees.ts +0 -22
  67. package/server/methods/fee/index.ts +0 -5
  68. package/server/methods/get-address-lookup-table.ts +0 -27
  69. package/server/methods/index.ts +0 -265
  70. package/server/methods/performance/get-recent-performance-samples.ts +0 -25
  71. package/server/methods/performance/get-transaction-count.ts +0 -5
  72. package/server/methods/performance/index.ts +0 -2
  73. package/server/methods/program/get-block-commitment.ts +0 -9
  74. package/server/methods/program/get-block-production.ts +0 -14
  75. package/server/methods/program/get-block-time.ts +0 -21
  76. package/server/methods/program/get-blocks.ts +0 -11
  77. package/server/methods/program/get-first-available-block.ts +0 -9
  78. package/server/methods/program/get-genesis-hash.ts +0 -6
  79. package/server/methods/program/get-identity.ts +0 -6
  80. package/server/methods/program/get-inflation-governor.ts +0 -15
  81. package/server/methods/program/get-inflation-rate.ts +0 -10
  82. package/server/methods/program/get-inflation-reward.ts +0 -12
  83. package/server/methods/program/get-largest-accounts.ts +0 -8
  84. package/server/methods/program/get-parsed-program-accounts.ts +0 -12
  85. package/server/methods/program/get-parsed-token-accounts-by-delegate.ts +0 -12
  86. package/server/methods/program/get-parsed-token-accounts-by-owner.ts +0 -12
  87. package/server/methods/program/get-program-accounts.ts +0 -221
  88. package/server/methods/program/get-supply.ts +0 -13
  89. package/server/methods/program/get-token-account-balance.ts +0 -60
  90. package/server/methods/program/get-token-accounts-by-delegate.ts +0 -82
  91. package/server/methods/program/get-token-accounts-by-owner.ts +0 -416
  92. package/server/methods/program/get-token-largest-accounts.ts +0 -81
  93. package/server/methods/program/get-token-supply.ts +0 -39
  94. package/server/methods/program/index.ts +0 -21
  95. package/server/methods/solforge/index.ts +0 -158
  96. package/server/methods/system/get-health.ts +0 -5
  97. package/server/methods/system/get-minimum-balance-for-rent-exemption.ts +0 -13
  98. package/server/methods/system/get-version.ts +0 -9
  99. package/server/methods/system/index.ts +0 -3
  100. package/server/methods/transaction/get-confirmed-transaction.ts +0 -11
  101. package/server/methods/transaction/get-parsed-transaction.ts +0 -17
  102. package/server/methods/transaction/get-signature-statuses.ts +0 -79
  103. package/server/methods/transaction/get-signatures-for-address.ts +0 -41
  104. package/server/methods/transaction/get-transaction.ts +0 -639
  105. package/server/methods/transaction/index.ts +0 -7
  106. package/server/methods/transaction/inner-instructions.test.ts +0 -104
  107. package/server/methods/transaction/send-transaction.ts +0 -469
  108. package/server/methods/transaction/simulate-transaction.ts +0 -57
  109. package/server/rpc-server.ts +0 -521
  110. package/server/types.ts +0 -109
  111. package/server/ws-server.ts +0 -178
  112. package/src/api-server-entry.ts +0 -109
  113. package/src/cli/bootstrap.ts +0 -67
  114. package/src/cli/commands/airdrop.ts +0 -37
  115. package/src/cli/commands/config.ts +0 -39
  116. package/src/cli/commands/mint.ts +0 -187
  117. package/src/cli/commands/program-clone.ts +0 -122
  118. package/src/cli/commands/program-load.ts +0 -64
  119. package/src/cli/commands/rpc-start.ts +0 -49
  120. package/src/cli/commands/token-adopt-authority.ts +0 -37
  121. package/src/cli/commands/token-clone.ts +0 -112
  122. package/src/cli/commands/token-create.ts +0 -81
  123. package/src/cli/main.ts +0 -158
  124. package/src/cli/run-solforge.ts +0 -112
  125. package/src/cli/setup-utils.ts +0 -54
  126. package/src/cli/setup-wizard.ts +0 -258
  127. package/src/cli/utils/args.ts +0 -15
  128. package/src/commands/add-program.ts +0 -333
  129. package/src/commands/init.ts +0 -122
  130. package/src/commands/list.ts +0 -136
  131. package/src/commands/mint.ts +0 -287
  132. package/src/commands/start.ts +0 -881
  133. package/src/commands/status.ts +0 -99
  134. package/src/commands/stop.ts +0 -405
  135. package/src/config/index.ts +0 -146
  136. package/src/config/manager.ts +0 -157
  137. package/src/db/index.ts +0 -83
  138. package/src/db/schema/accounts.ts +0 -23
  139. package/src/db/schema/address-signatures.ts +0 -31
  140. package/src/db/schema/index.ts +0 -6
  141. package/src/db/schema/meta-kv.ts +0 -9
  142. package/src/db/schema/transactions.ts +0 -36
  143. package/src/db/schema/tx-account-states.ts +0 -23
  144. package/src/db/schema/tx-accounts.ts +0 -33
  145. package/src/db/tx-store.ts +0 -264
  146. package/src/gui/public/app.css +0 -1556
  147. package/src/gui/public/build/main.css +0 -1569
  148. package/src/gui/public/build/main.js +0 -303
  149. package/src/gui/public/build/main.js.txt +0 -231
  150. package/src/gui/public/index.html +0 -19
  151. package/src/gui/server.ts +0 -296
  152. package/src/gui/src/api.ts +0 -127
  153. package/src/gui/src/app.tsx +0 -441
  154. package/src/gui/src/components/airdrop-mint-form.tsx +0 -246
  155. package/src/gui/src/components/clone-program-modal.tsx +0 -202
  156. package/src/gui/src/components/clone-token-modal.tsx +0 -230
  157. package/src/gui/src/components/modal.tsx +0 -134
  158. package/src/gui/src/components/programs-panel.tsx +0 -124
  159. package/src/gui/src/components/status-panel.tsx +0 -136
  160. package/src/gui/src/components/tokens-panel.tsx +0 -122
  161. package/src/gui/src/hooks/use-interval.ts +0 -17
  162. package/src/gui/src/index.css +0 -557
  163. package/src/gui/src/main.tsx +0 -17
  164. package/src/index.ts +0 -216
  165. package/src/migrations-bundled.ts +0 -23
  166. package/src/rpc/start.ts +0 -44
  167. package/src/services/api-server.ts +0 -504
  168. package/src/services/port-manager.ts +0 -174
  169. package/src/services/process-registry.ts +0 -153
  170. package/src/services/program-cloner.ts +0 -317
  171. package/src/services/token-cloner.ts +0 -811
  172. package/src/services/validator.ts +0 -293
  173. package/src/types/config.ts +0 -110
  174. package/src/utils/shell.ts +0 -110
  175. package/src/utils/token-loader.ts +0 -115
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
- }