solforge 0.2.3 → 0.2.5

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 (43) hide show
  1. package/LICENSE +2 -2
  2. package/README.md +323 -364
  3. package/cli.cjs +126 -69
  4. package/package.json +1 -1
  5. package/scripts/install.sh +112 -0
  6. package/scripts/postinstall.cjs +66 -58
  7. package/server/methods/program/get-token-accounts-by-owner.ts +7 -2
  8. package/server/ws-server.ts +4 -1
  9. package/src/api-server-entry.ts +91 -91
  10. package/src/cli/commands/rpc-start.ts +4 -1
  11. package/src/cli/main.ts +39 -14
  12. package/src/cli/run-solforge.ts +20 -6
  13. package/src/commands/add-program.ts +324 -328
  14. package/src/commands/init.ts +106 -106
  15. package/src/commands/list.ts +125 -125
  16. package/src/commands/mint.ts +246 -246
  17. package/src/commands/start.ts +834 -831
  18. package/src/commands/status.ts +80 -80
  19. package/src/commands/stop.ts +381 -382
  20. package/src/config/manager.ts +149 -149
  21. package/src/gui/public/app.css +1556 -1
  22. package/src/gui/public/build/main.css +1569 -1
  23. package/src/gui/server.ts +20 -21
  24. package/src/gui/src/app.tsx +56 -37
  25. package/src/gui/src/components/airdrop-mint-form.tsx +17 -11
  26. package/src/gui/src/components/clone-program-modal.tsx +6 -6
  27. package/src/gui/src/components/clone-token-modal.tsx +7 -7
  28. package/src/gui/src/components/modal.tsx +13 -11
  29. package/src/gui/src/components/programs-panel.tsx +27 -15
  30. package/src/gui/src/components/status-panel.tsx +31 -17
  31. package/src/gui/src/components/tokens-panel.tsx +25 -19
  32. package/src/gui/src/index.css +491 -463
  33. package/src/index.ts +161 -146
  34. package/src/rpc/start.ts +1 -1
  35. package/src/services/api-server.ts +470 -473
  36. package/src/services/port-manager.ts +167 -167
  37. package/src/services/process-registry.ts +143 -143
  38. package/src/services/program-cloner.ts +312 -312
  39. package/src/services/token-cloner.ts +799 -797
  40. package/src/services/validator.ts +288 -288
  41. package/src/types/config.ts +71 -71
  42. package/src/utils/shell.ts +75 -75
  43. package/src/utils/token-loader.ts +77 -77
@@ -1,337 +1,333 @@
1
1
  import chalk from "chalk";
2
- import inquirer from "inquirer";
3
2
  import { existsSync } from "fs";
3
+ import inquirer from "inquirer";
4
4
  import { configManager } from "../config/manager.js";
5
- import { ProgramCloner } from "../services/program-cloner.js";
6
5
  import { processRegistry } from "../services/process-registry.js";
6
+ import { ProgramCloner } from "../services/program-cloner.js";
7
7
  import type { ProgramConfig } from "../types/config.js";
8
8
 
9
9
  export async function addProgramCommand(
10
- options: {
11
- name?: string;
12
- programId?: string;
13
- interactive?: boolean;
14
- } = {}
10
+ options: { name?: string; programId?: string; interactive?: boolean } = {},
15
11
  ): Promise<void> {
16
- console.log(chalk.blue("šŸ“¦ Adding program to configuration...\n"));
17
-
18
- // Check if config exists
19
- if (!existsSync("./sf.config.json")) {
20
- console.error(chalk.red("āŒ No sf.config.json found in current directory"));
21
- console.log(chalk.yellow("šŸ’” Run `solforge init` to create one"));
22
- return;
23
- }
24
-
25
- // Load current config
26
- try {
27
- await configManager.load("./sf.config.json");
28
- } catch (error) {
29
- console.error(chalk.red("āŒ Failed to load sf.config.json"));
30
- console.error(
31
- chalk.red(error instanceof Error ? error.message : String(error))
32
- );
33
- return;
34
- }
35
-
36
- const config = configManager.getConfig();
37
-
38
- // Get program details
39
- let programId: string;
40
- let programName: string | undefined;
41
- let upgradeable: boolean = false;
42
-
43
- if (options.interactive !== false && !options.programId) {
44
- // Interactive mode - show common programs + custom option
45
- const { programChoice } = await inquirer.prompt([
46
- {
47
- type: "list",
48
- name: "programChoice",
49
- message: "Select a program to add:",
50
- choices: [
51
- {
52
- name: "Token Metadata Program",
53
- value: {
54
- id: "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s",
55
- name: "Token Metadata",
56
- upgradeable: true,
57
- },
58
- },
59
- {
60
- name: "Associated Token Account Program",
61
- value: {
62
- id: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
63
- name: "Associated Token Account",
64
- upgradeable: false,
65
- },
66
- },
67
- {
68
- name: "System Program",
69
- value: {
70
- id: "11111111111111111111111111111112",
71
- name: "System Program",
72
- upgradeable: false,
73
- },
74
- },
75
- {
76
- name: "Token Program",
77
- value: {
78
- id: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
79
- name: "Token Program",
80
- upgradeable: false,
81
- },
82
- },
83
- {
84
- name: "Token Program 2022",
85
- value: {
86
- id: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
87
- name: "Token Program 2022",
88
- upgradeable: true,
89
- },
90
- },
91
- {
92
- name: "Rent Sysvar",
93
- value: {
94
- id: "SysvarRent111111111111111111111111111111111",
95
- name: "Rent Sysvar",
96
- upgradeable: false,
97
- },
98
- },
99
- {
100
- name: "Clock Sysvar",
101
- value: {
102
- id: "SysvarC1ock11111111111111111111111111111111",
103
- name: "Clock Sysvar",
104
- upgradeable: false,
105
- },
106
- },
107
- {
108
- name: "Jupiter V6 Program",
109
- value: {
110
- id: "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
111
- name: "Jupiter V6",
112
- upgradeable: true,
113
- },
114
- },
115
- {
116
- name: "Raydium AMM Program",
117
- value: {
118
- id: "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
119
- name: "Raydium AMM",
120
- upgradeable: false,
121
- },
122
- },
123
- {
124
- name: "Serum DEX Program",
125
- value: {
126
- id: "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
127
- name: "Serum DEX",
128
- upgradeable: false,
129
- },
130
- },
131
- {
132
- name: "Custom (enter program ID manually)",
133
- value: "custom",
134
- },
135
- ],
136
- },
137
- ]);
138
-
139
- if (programChoice === "custom") {
140
- const answers = await inquirer.prompt([
141
- {
142
- type: "input",
143
- name: "programId",
144
- message: "Enter program ID:",
145
- validate: (input) =>
146
- input.trim().length > 0 || "Program ID is required",
147
- },
148
- {
149
- type: "input",
150
- name: "name",
151
- message: "Enter program name (optional):",
152
- default: "",
153
- },
154
- {
155
- type: "confirm",
156
- name: "upgradeable",
157
- message: "Is this an upgradeable program?",
158
- default: false,
159
- },
160
- ]);
161
-
162
- programId = answers.programId;
163
- programName = answers.name || undefined;
164
- upgradeable = answers.upgradeable;
165
- } else {
166
- programId = programChoice.id;
167
- programName = programChoice.name;
168
- upgradeable = programChoice.upgradeable;
169
- }
170
- } else {
171
- // Non-interactive mode
172
- if (!options.programId) {
173
- console.error(chalk.red("āŒ Program ID is required"));
174
- console.log(
175
- chalk.gray(
176
- "šŸ’” Use --program-id flag, or run without flags for interactive mode"
177
- )
178
- );
179
- return;
180
- }
181
-
182
- programId = options.programId;
183
- programName = options.name;
184
- // Default to false for CLI, could add --upgradeable flag later
185
- upgradeable = false;
186
- }
187
-
188
- try {
189
- // Check if program already exists in config
190
- const existingProgram = config.programs.find(
191
- (p) => p.mainnetProgramId === programId
192
- );
193
- if (existingProgram) {
194
- console.log(
195
- chalk.yellow(`āš ļø Program ${programId} already exists in configuration`)
196
- );
197
- console.log(chalk.gray(` Name: ${existingProgram.name || "unnamed"}`));
198
- return;
199
- }
200
-
201
- // Verify program exists on mainnet first
202
- console.log(chalk.gray("šŸ” Verifying program exists on mainnet..."));
203
- const programCloner = new ProgramCloner();
204
- const programInfo = await programCloner.getProgramInfo(
205
- programId,
206
- "mainnet-beta"
207
- );
208
-
209
- if (!programInfo.exists) {
210
- console.error(chalk.red(`āŒ Program ${programId} not found on mainnet`));
211
- return;
212
- }
213
-
214
- if (!programInfo.executable) {
215
- console.error(chalk.red(`āŒ ${programId} is not an executable program`));
216
- return;
217
- }
218
-
219
- console.log(
220
- chalk.gray(` āœ“ Found executable program (${programInfo.size} bytes)`)
221
- );
222
-
223
- // Create new program config
224
- const newProgram: ProgramConfig = {
225
- name: programName,
226
- mainnetProgramId: programId,
227
- upgradeable: upgradeable,
228
- cluster: "mainnet-beta",
229
- dependencies: [],
230
- };
231
-
232
- // Add to config
233
- config.programs.push(newProgram);
234
-
235
- // Save updated config
236
- await configManager.save("./sf.config.json");
237
-
238
- console.log(
239
- chalk.green(
240
- `\nāœ… Successfully added ${programName || programId} to configuration!`
241
- )
242
- );
243
- console.log(chalk.cyan(`šŸ“ Updated sf.config.json`));
244
- console.log(chalk.gray(` Program ID: ${programId}`));
245
- console.log(chalk.gray(` Upgradeable: ${upgradeable ? "Yes" : "No"}`));
246
-
247
- // Check if there are running validators
248
- await processRegistry.cleanup();
249
- const validators = processRegistry.getRunning();
250
-
251
- if (validators.length > 0) {
252
- console.log(
253
- chalk.yellow(`\nāš ļø Found ${validators.length} running validator(s)`)
254
- );
255
- console.log(
256
- chalk.gray("šŸ’” Programs are added to genesis config and require RESET")
257
- );
258
- console.log(chalk.red(" āš ļø RESET will WIPE all ledger data!"));
259
- console.log(
260
- chalk.gray(
261
- ` 1. Stop validators using "${config.name}": solforge stop <validator-id>`
262
- )
263
- );
264
- console.log(chalk.gray(" 2. Start with reset: solforge start"));
265
-
266
- const { shouldRestart } = await inquirer.prompt([
267
- {
268
- type: "confirm",
269
- name: "shouldRestart",
270
- message: "āš ļø Reset validators now? (This will WIPE all ledger data)",
271
- default: false,
272
- },
273
- ]);
274
-
275
- if (shouldRestart) {
276
- console.log(chalk.yellow("\nšŸ”„ Resetting validators..."));
277
- console.log(chalk.red("āš ļø This will delete all ledger data!"));
278
-
279
- // Import the commands we need
280
- const { stopCommand } = await import("./stop.js");
281
- const { startCommand } = await import("./start.js");
282
-
283
- // Get current config for modifications
284
- const currentConfig = configManager.getConfig();
285
-
286
- // Stop validators that use this config
287
- const configName = currentConfig.name;
288
- const matchingValidators = validators.filter((v) =>
289
- v.name.startsWith(configName)
290
- );
291
-
292
- if (matchingValidators.length > 0) {
293
- console.log(
294
- chalk.gray(
295
- `šŸ›‘ Stopping ${matchingValidators.length} validator(s) using config "${configName}"...`
296
- )
297
- );
298
-
299
- for (const validator of matchingValidators) {
300
- await stopCommand(validator.id, {});
301
- }
302
- }
303
-
304
- // Wait a moment for clean shutdown
305
- await new Promise((resolve) => setTimeout(resolve, 2000));
306
-
307
- // Temporarily enable reset for this start
308
- const originalReset = currentConfig.localnet.reset;
309
- currentConfig.localnet.reset = true;
310
-
311
- console.log(
312
- chalk.cyan(
313
- "šŸš€ Starting validator with reset to apply program changes..."
314
- )
315
- );
316
-
317
- // Start new validator (will reset due to config)
318
- await startCommand(false);
319
-
320
- // Restore original reset setting
321
- currentConfig.localnet.reset = originalReset;
322
- await configManager.save("./sf.config.json");
323
- }
324
- } else {
325
- console.log(
326
- chalk.gray(
327
- "\nšŸ’” Start a validator to use the new program: solforge start"
328
- )
329
- );
330
- }
331
- } catch (error) {
332
- console.error(chalk.red("āŒ Failed to add program:"));
333
- console.error(
334
- chalk.red(` ${error instanceof Error ? error.message : String(error)}`)
335
- );
336
- }
12
+ console.log(chalk.blue("šŸ“¦ Adding program to configuration...\n"));
13
+
14
+ // Check if config exists
15
+ if (!existsSync("./sf.config.json")) {
16
+ console.error(chalk.red("āŒ No sf.config.json found in current directory"));
17
+ console.log(chalk.yellow("šŸ’” Run `solforge init` to create one"));
18
+ return;
19
+ }
20
+
21
+ // Load current config
22
+ try {
23
+ await configManager.load("./sf.config.json");
24
+ } catch (error) {
25
+ console.error(chalk.red("āŒ Failed to load sf.config.json"));
26
+ console.error(
27
+ chalk.red(error instanceof Error ? error.message : String(error)),
28
+ );
29
+ return;
30
+ }
31
+
32
+ const config = configManager.getConfig();
33
+
34
+ // Get program details
35
+ let programId: string;
36
+ let programName: string | undefined;
37
+ let upgradeable: boolean = false;
38
+
39
+ if (options.interactive !== false && !options.programId) {
40
+ // Interactive mode - show common programs + custom option
41
+ const { programChoice } = await inquirer.prompt([
42
+ {
43
+ type: "list",
44
+ name: "programChoice",
45
+ message: "Select a program to add:",
46
+ choices: [
47
+ {
48
+ name: "Token Metadata Program",
49
+ value: {
50
+ id: "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s",
51
+ name: "Token Metadata",
52
+ upgradeable: true,
53
+ },
54
+ },
55
+ {
56
+ name: "Associated Token Account Program",
57
+ value: {
58
+ id: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
59
+ name: "Associated Token Account",
60
+ upgradeable: false,
61
+ },
62
+ },
63
+ {
64
+ name: "System Program",
65
+ value: {
66
+ id: "11111111111111111111111111111112",
67
+ name: "System Program",
68
+ upgradeable: false,
69
+ },
70
+ },
71
+ {
72
+ name: "Token Program",
73
+ value: {
74
+ id: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
75
+ name: "Token Program",
76
+ upgradeable: false,
77
+ },
78
+ },
79
+ {
80
+ name: "Token Program 2022",
81
+ value: {
82
+ id: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb",
83
+ name: "Token Program 2022",
84
+ upgradeable: true,
85
+ },
86
+ },
87
+ {
88
+ name: "Rent Sysvar",
89
+ value: {
90
+ id: "SysvarRent111111111111111111111111111111111",
91
+ name: "Rent Sysvar",
92
+ upgradeable: false,
93
+ },
94
+ },
95
+ {
96
+ name: "Clock Sysvar",
97
+ value: {
98
+ id: "SysvarC1ock11111111111111111111111111111111",
99
+ name: "Clock Sysvar",
100
+ upgradeable: false,
101
+ },
102
+ },
103
+ {
104
+ name: "Jupiter V6 Program",
105
+ value: {
106
+ id: "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
107
+ name: "Jupiter V6",
108
+ upgradeable: true,
109
+ },
110
+ },
111
+ {
112
+ name: "Raydium AMM Program",
113
+ value: {
114
+ id: "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
115
+ name: "Raydium AMM",
116
+ upgradeable: false,
117
+ },
118
+ },
119
+ {
120
+ name: "Serum DEX Program",
121
+ value: {
122
+ id: "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin",
123
+ name: "Serum DEX",
124
+ upgradeable: false,
125
+ },
126
+ },
127
+ {
128
+ name: "Custom (enter program ID manually)",
129
+ value: "custom",
130
+ },
131
+ ],
132
+ },
133
+ ]);
134
+
135
+ if (programChoice === "custom") {
136
+ const answers = await inquirer.prompt([
137
+ {
138
+ type: "input",
139
+ name: "programId",
140
+ message: "Enter program ID:",
141
+ validate: (input) =>
142
+ input.trim().length > 0 || "Program ID is required",
143
+ },
144
+ {
145
+ type: "input",
146
+ name: "name",
147
+ message: "Enter program name (optional):",
148
+ default: "",
149
+ },
150
+ {
151
+ type: "confirm",
152
+ name: "upgradeable",
153
+ message: "Is this an upgradeable program?",
154
+ default: false,
155
+ },
156
+ ]);
157
+
158
+ programId = answers.programId;
159
+ programName = answers.name || undefined;
160
+ upgradeable = answers.upgradeable;
161
+ } else {
162
+ programId = programChoice.id;
163
+ programName = programChoice.name;
164
+ upgradeable = programChoice.upgradeable;
165
+ }
166
+ } else {
167
+ // Non-interactive mode
168
+ if (!options.programId) {
169
+ console.error(chalk.red("āŒ Program ID is required"));
170
+ console.log(
171
+ chalk.gray(
172
+ "šŸ’” Use --program-id flag, or run without flags for interactive mode",
173
+ ),
174
+ );
175
+ return;
176
+ }
177
+
178
+ programId = options.programId;
179
+ programName = options.name;
180
+ // Default to false for CLI, could add --upgradeable flag later
181
+ upgradeable = false;
182
+ }
183
+
184
+ try {
185
+ // Check if program already exists in config
186
+ const existingProgram = config.programs.find(
187
+ (p) => p.mainnetProgramId === programId,
188
+ );
189
+ if (existingProgram) {
190
+ console.log(
191
+ chalk.yellow(`āš ļø Program ${programId} already exists in configuration`),
192
+ );
193
+ console.log(chalk.gray(` Name: ${existingProgram.name || "unnamed"}`));
194
+ return;
195
+ }
196
+
197
+ // Verify program exists on mainnet first
198
+ console.log(chalk.gray("šŸ” Verifying program exists on mainnet..."));
199
+ const programCloner = new ProgramCloner();
200
+ const programInfo = await programCloner.getProgramInfo(
201
+ programId,
202
+ "mainnet-beta",
203
+ );
204
+
205
+ if (!programInfo.exists) {
206
+ console.error(chalk.red(`āŒ Program ${programId} not found on mainnet`));
207
+ return;
208
+ }
209
+
210
+ if (!programInfo.executable) {
211
+ console.error(chalk.red(`āŒ ${programId} is not an executable program`));
212
+ return;
213
+ }
214
+
215
+ console.log(
216
+ chalk.gray(` āœ“ Found executable program (${programInfo.size} bytes)`),
217
+ );
218
+
219
+ // Create new program config
220
+ const newProgram: ProgramConfig = {
221
+ name: programName,
222
+ mainnetProgramId: programId,
223
+ upgradeable: upgradeable,
224
+ cluster: "mainnet-beta",
225
+ dependencies: [],
226
+ };
227
+
228
+ // Add to config
229
+ config.programs.push(newProgram);
230
+
231
+ // Save updated config
232
+ await configManager.save("./sf.config.json");
233
+
234
+ console.log(
235
+ chalk.green(
236
+ `\nāœ… Successfully added ${programName || programId} to configuration!`,
237
+ ),
238
+ );
239
+ console.log(chalk.cyan(`šŸ“ Updated sf.config.json`));
240
+ console.log(chalk.gray(` Program ID: ${programId}`));
241
+ console.log(chalk.gray(` Upgradeable: ${upgradeable ? "Yes" : "No"}`));
242
+
243
+ // Check if there are running validators
244
+ await processRegistry.cleanup();
245
+ const validators = processRegistry.getRunning();
246
+
247
+ if (validators.length > 0) {
248
+ console.log(
249
+ chalk.yellow(`\nāš ļø Found ${validators.length} running validator(s)`),
250
+ );
251
+ console.log(
252
+ chalk.gray("šŸ’” Programs are added to genesis config and require RESET"),
253
+ );
254
+ console.log(chalk.red(" āš ļø RESET will WIPE all ledger data!"));
255
+ console.log(
256
+ chalk.gray(
257
+ ` 1. Stop validators using "${config.name}": solforge stop <validator-id>`,
258
+ ),
259
+ );
260
+ console.log(chalk.gray(" 2. Start with reset: solforge start"));
261
+
262
+ const { shouldRestart } = await inquirer.prompt([
263
+ {
264
+ type: "confirm",
265
+ name: "shouldRestart",
266
+ message: "āš ļø Reset validators now? (This will WIPE all ledger data)",
267
+ default: false,
268
+ },
269
+ ]);
270
+
271
+ if (shouldRestart) {
272
+ console.log(chalk.yellow("\nšŸ”„ Resetting validators..."));
273
+ console.log(chalk.red("āš ļø This will delete all ledger data!"));
274
+
275
+ // Import the commands we need
276
+ const { stopCommand } = await import("./stop.js");
277
+ const { startCommand } = await import("./start.js");
278
+
279
+ // Get current config for modifications
280
+ const currentConfig = configManager.getConfig();
281
+
282
+ // Stop validators that use this config
283
+ const configName = currentConfig.name;
284
+ const matchingValidators = validators.filter((v) =>
285
+ v.name.startsWith(configName),
286
+ );
287
+
288
+ if (matchingValidators.length > 0) {
289
+ console.log(
290
+ chalk.gray(
291
+ `šŸ›‘ Stopping ${matchingValidators.length} validator(s) using config "${configName}"...`,
292
+ ),
293
+ );
294
+
295
+ for (const validator of matchingValidators) {
296
+ await stopCommand(validator.id, {});
297
+ }
298
+ }
299
+
300
+ // Wait a moment for clean shutdown
301
+ await new Promise((resolve) => setTimeout(resolve, 2000));
302
+
303
+ // Temporarily enable reset for this start
304
+ const originalReset = currentConfig.localnet.reset;
305
+ currentConfig.localnet.reset = true;
306
+
307
+ console.log(
308
+ chalk.cyan(
309
+ "šŸš€ Starting validator with reset to apply program changes...",
310
+ ),
311
+ );
312
+
313
+ // Start new validator (will reset due to config)
314
+ await startCommand(false);
315
+
316
+ // Restore original reset setting
317
+ currentConfig.localnet.reset = originalReset;
318
+ await configManager.save("./sf.config.json");
319
+ }
320
+ } else {
321
+ console.log(
322
+ chalk.gray(
323
+ "\nšŸ’” Start a validator to use the new program: solforge start",
324
+ ),
325
+ );
326
+ }
327
+ } catch (error) {
328
+ console.error(chalk.red("āŒ Failed to add program:"));
329
+ console.error(
330
+ chalk.red(` ${error instanceof Error ? error.message : String(error)}`),
331
+ );
332
+ }
337
333
  }