solforge 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +36 -8
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -26,7 +26,7 @@
26
26
 
27
27
  ```bash
28
28
  # Clone the repository
29
- git clone <repository-url>
29
+ git clone https://github.com/nitishxyz/solforge.git
30
30
  cd solforge
31
31
 
32
32
  # Install dependencies
@@ -43,16 +43,19 @@ bun run install:binary
43
43
  ### Basic Usage
44
44
 
45
45
  1. **Initialize a new project**:
46
+
46
47
  ```bash
47
48
  solforge init
48
49
  ```
49
50
 
50
51
  2. **Start your localnet**:
52
+
51
53
  ```bash
52
54
  solforge start
53
55
  ```
54
56
 
55
57
  3. **Check status**:
58
+
56
59
  ```bash
57
60
  solforge status
58
61
  solforge list
@@ -66,12 +69,14 @@ bun run install:binary
66
69
  ## 📖 Documentation
67
70
 
68
71
  ### 📚 Additional Documentation
72
+
69
73
  - [Configuration Guide](docs/CONFIGURATION.md) - Detailed configuration options and examples
70
74
  - [Troubleshooting Guide](#-troubleshooting) - Common issues and solutions
71
75
 
72
76
  ### Commands
73
77
 
74
78
  #### `solforge init`
79
+
75
80
  Initialize a new `sf.config.json` configuration file in the current directory.
76
81
 
77
82
  ```bash
@@ -79,12 +84,14 @@ solforge init
79
84
  ```
80
85
 
81
86
  This command will prompt you for:
87
+
82
88
  - Project name
83
89
  - Description
84
90
  - RPC port (default: 8899)
85
91
  - Whether to include USDC token
86
92
 
87
93
  #### `solforge start [options]`
94
+
88
95
  Start a localnet validator with the current configuration.
89
96
 
90
97
  ```bash
@@ -93,9 +100,11 @@ solforge start --debug # Start with debug logging
93
100
  ```
94
101
 
95
102
  **Options:**
103
+
96
104
  - `--debug` - Enable debug logging to see detailed command output
97
105
 
98
106
  #### `solforge list`
107
+
99
108
  List all running validators with detailed information.
100
109
 
101
110
  ```bash
@@ -103,6 +112,7 @@ solforge list
103
112
  ```
104
113
 
105
114
  Shows:
115
+
106
116
  - Validator ID and name
107
117
  - Process ID (PID)
108
118
  - RPC and Faucet ports
@@ -111,6 +121,7 @@ Shows:
111
121
  - Connection URLs
112
122
 
113
123
  #### `solforge stop [validator-id] [options]`
124
+
114
125
  Stop running validators.
115
126
 
116
127
  ```bash
@@ -121,10 +132,12 @@ solforge stop --kill # Force kill (SIGKILL)
121
132
  ```
122
133
 
123
134
  **Options:**
135
+
124
136
  - `--all` - Stop all running validators
125
137
  - `--kill` - Force kill the validator (SIGKILL instead of SIGTERM)
126
138
 
127
139
  #### `solforge kill [validator-id] [options]`
140
+
128
141
  Force kill running validators with interactive selection.
129
142
 
130
143
  ```bash
@@ -135,12 +148,14 @@ solforge kill --all # Kill all validators
135
148
 
136
149
  **Interactive Mode:**
137
150
  When run without arguments, `solforge kill` will:
151
+
138
152
  - Display a table of all running validators
139
153
  - Allow you to select which validator to kill using arrow keys
140
154
  - Provide options to kill individual validators, all validators, or cancel
141
155
  - No need to copy/paste validator IDs from `solforge list`
142
156
 
143
157
  #### `solforge status`
158
+
144
159
  Show overall localnet status and configuration summary.
145
160
 
146
161
  ```bash
@@ -148,6 +163,7 @@ solforge status
148
163
  ```
149
164
 
150
165
  #### `solforge add-program [options]`
166
+
151
167
  Add a program to your configuration.
152
168
 
153
169
  ```bash
@@ -157,11 +173,13 @@ solforge add-program --program-id <address> --name <name>
157
173
  ```
158
174
 
159
175
  **Options:**
176
+
160
177
  - `--program-id <address>` - Mainnet program ID to clone and deploy
161
178
  - `--name <name>` - Friendly name for the program
162
179
  - `--no-interactive` - Run in non-interactive mode
163
180
 
164
181
  #### `solforge transfer [options]`
182
+
165
183
  Interactively transfer tokens from mint authority to any address.
166
184
 
167
185
  ```bash
@@ -170,9 +188,11 @@ solforge transfer --rpc-url http://localhost:8899 # Custom RPC
170
188
  ```
171
189
 
172
190
  **Options:**
191
+
173
192
  - `--rpc-url <url>` - RPC URL to use (default: "http://127.0.0.1:8899")
174
193
 
175
194
  #### `solforge reset`
195
+
176
196
  Reset localnet ledger (coming soon).
177
197
 
178
198
  ```bash
@@ -232,8 +252,9 @@ Here's the complete schema:
232
252
  For detailed configuration options and examples, see the [Configuration Guide](docs/CONFIGURATION.md).
233
253
 
234
254
  **Quick Reference:**
255
+
235
256
  - `name` - Project name
236
- - `description` - Project description
257
+ - `description` - Project description
237
258
  - `tokens[]` - Tokens to clone from mainnet
238
259
  - `programs[]` - Programs to clone from mainnet
239
260
  - `localnet` - Validator settings (ports, logging, etc.)
@@ -241,6 +262,7 @@ For detailed configuration options and examples, see the [Configuration Guide](d
241
262
  ## 🎯 Use Cases
242
263
 
243
264
  ### DeFi Development
265
+
244
266
  Clone popular DeFi tokens and programs to test your application:
245
267
 
246
268
  ```json
@@ -253,7 +275,7 @@ Clone popular DeFi tokens and programs to test your application:
253
275
  "mintAmount": 10000000
254
276
  },
255
277
  {
256
- "symbol": "USDT",
278
+ "symbol": "USDT",
257
279
  "mainnetMint": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
258
280
  "mintAmount": 10000000
259
281
  }
@@ -268,6 +290,7 @@ Clone popular DeFi tokens and programs to test your application:
268
290
  ```
269
291
 
270
292
  ### NFT Development
293
+
271
294
  Set up an environment for NFT projects:
272
295
 
273
296
  ```json
@@ -287,6 +310,7 @@ Set up an environment for NFT projects:
287
310
  ```
288
311
 
289
312
  ### Multi-Environment Testing
313
+
290
314
  Run multiple validators for different test scenarios:
291
315
 
292
316
  ```bash
@@ -294,7 +318,7 @@ Run multiple validators for different test scenarios:
294
318
  cd defi-project
295
319
  solforge start
296
320
 
297
- # Terminal 2 - NFT environment
321
+ # Terminal 2 - NFT environment
298
322
  cd nft-project
299
323
  solforge start
300
324
 
@@ -365,6 +389,7 @@ bun run install:binary # Install binary to ~/.local/bin
365
389
  ### Common Issues
366
390
 
367
391
  **Port already in use**
392
+
368
393
  ```bash
369
394
  # Check what's using the port
370
395
  lsof -i :8899
@@ -379,6 +404,7 @@ lsof -i :8899
379
404
  ```
380
405
 
381
406
  **Validator won't start**
407
+
382
408
  ```bash
383
409
  # Check Solana CLI is installed
384
410
  solana --version
@@ -391,11 +417,13 @@ solforge start --debug
391
417
  ```
392
418
 
393
419
  **Token cloning fails**
420
+
394
421
  - Ensure RPC URL in config is accessible
395
422
  - Check mainnet mint address is correct
396
423
  - Verify network connectivity
397
424
 
398
425
  **Program deployment fails**
426
+
399
427
  - Ensure program ID exists on specified cluster
400
428
  - Check if program has dependencies that need to be deployed first
401
429
  - Verify sufficient SOL for deployment
@@ -409,6 +437,7 @@ solforge start --debug
409
437
  ```
410
438
 
411
439
  This shows:
440
+
412
441
  - Exact solana-test-validator commands
413
442
  - Program deployment steps
414
443
  - Token cloning operations
@@ -417,6 +446,7 @@ This shows:
417
446
  ### Logs and Data
418
447
 
419
448
  SolForge stores data in:
449
+
420
450
  - `~/.solforge/` - Process registry and metadata
421
451
  - `.solforge/` - Local working directory for current project
422
452
 
@@ -426,9 +456,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
426
456
 
427
457
  ## 🤝 Support
428
458
 
429
- - 🐛 **Issues**: [GitHub Issues](https://github.com/your-repo/solforge/issues)
430
- - 💬 **Discussions**: [GitHub Discussions](https://github.com/your-repo/solforge/discussions)
431
- - 📧 **Email**: your-email@example.com
459
+ - 🐛 **Issues**: [GitHub Issues](https://github.com/nitishxyz/solforge/issues)
432
460
 
433
461
  ## 🙏 Acknowledgments
434
462
 
@@ -438,4 +466,4 @@ MIT License - see [LICENSE](LICENSE) file for details.
438
466
 
439
467
  ---
440
468
 
441
- **Happy building on Solana! 🚀**
469
+ **Happy building on Solana! 🚀**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "solforge",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Solana localnet orchestration tool for cloning mainnet programs and tokens",
5
5
  "module": "index.ts",
6
6
  "type": "module",