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.
- package/README.md +36 -8
- 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
|
|
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/
|
|
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! 🚀**
|