clawncher 2.2.1 → 2.2.2
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 +66 -75
- package/package.json +2 -6
package/README.md
CHANGED
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
#
|
|
1
|
+
# clawncher
|
|
2
2
|
|
|
3
|
-
Command-line interface for [
|
|
3
|
+
Command-line interface for [Clawncher](https://clawn.ch/er) - deploy tokens on Base with Uniswap V4 pools, MEV protection, and configurable fee distribution.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
npm install -g
|
|
8
|
+
npm install -g clawncher
|
|
9
9
|
```
|
|
10
10
|
|
|
11
11
|
## Quick Start
|
|
12
12
|
|
|
13
13
|
```bash
|
|
14
14
|
# Configure your private key
|
|
15
|
-
|
|
15
|
+
clawncher config --private-key YOUR_PRIVATE_KEY
|
|
16
16
|
|
|
17
17
|
# Deploy a new token
|
|
18
|
-
|
|
18
|
+
clawncher deploy "My Token" MYTKN
|
|
19
19
|
|
|
20
20
|
# Show contract addresses
|
|
21
|
-
|
|
21
|
+
clawncher addresses
|
|
22
22
|
|
|
23
23
|
# Get token info from chain
|
|
24
|
-
|
|
24
|
+
clawncher info 0xTokenAddress
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
## Commands
|
|
@@ -32,54 +32,46 @@ Deploy a new token on Base with Uniswap V4 pool:
|
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
34
|
# Basic deployment
|
|
35
|
-
|
|
35
|
+
clawncher deploy "My Token" MYTKN
|
|
36
36
|
|
|
37
37
|
# With image and description
|
|
38
|
-
|
|
39
|
-
--name "My Token" \
|
|
40
|
-
--symbol MYTKN \
|
|
38
|
+
clawncher deploy "My Token" MYTKN \
|
|
41
39
|
--image "https://example.com/logo.png" \
|
|
42
40
|
--description "A great token"
|
|
43
41
|
|
|
44
42
|
# Custom fee recipient
|
|
45
|
-
|
|
43
|
+
clawncher deploy "My Token" MYTKN --recipient 0x1234...
|
|
46
44
|
|
|
47
|
-
# 1% LP fee: 80% to deployer
|
|
45
|
+
# 1% LP fee: 80% to deployer, 20% protocol
|
|
48
46
|
# Change fee preference to receive in WETH instead:
|
|
49
|
-
|
|
47
|
+
clawncher deploy "My Token" MYTKN --fee-preference Paired
|
|
50
48
|
|
|
51
49
|
# With vault allocation
|
|
52
|
-
|
|
53
|
-
--name "My Token" \
|
|
54
|
-
--symbol MYTKN \
|
|
50
|
+
clawncher deploy "My Token" MYTKN \
|
|
55
51
|
--vault-percent 10 \
|
|
56
52
|
--vault-lockup 30 \
|
|
57
53
|
--vault-recipient 0x1234...
|
|
58
54
|
|
|
59
55
|
# With dev buy (instant purchase at launch)
|
|
60
|
-
|
|
61
|
-
--name "My Token" \
|
|
62
|
-
--symbol MYTKN \
|
|
56
|
+
clawncher deploy "My Token" MYTKN \
|
|
63
57
|
--dev-buy 0.1 \
|
|
64
58
|
--dev-buy-recipient 0x1234...
|
|
65
59
|
|
|
66
60
|
# With vested dev buy (purchase with lockup + vesting)
|
|
67
|
-
|
|
68
|
-
--name "My Token" \
|
|
69
|
-
--symbol MYTKN \
|
|
61
|
+
clawncher deploy "My Token" MYTKN \
|
|
70
62
|
--vested-dev-buy 0.5 \
|
|
71
63
|
--vested-dev-buy-recipient 0x1234... \
|
|
72
64
|
--vested-dev-buy-lockup 14 \
|
|
73
65
|
--vested-dev-buy-vesting 90
|
|
74
66
|
|
|
75
67
|
# Deploy to mainnet
|
|
76
|
-
|
|
68
|
+
clawncher deploy "My Token" MYTKN --network mainnet
|
|
77
69
|
|
|
78
70
|
# Use custom RPC
|
|
79
|
-
|
|
71
|
+
clawncher deploy "My Token" MYTKN --rpc https://my-rpc.com
|
|
80
72
|
|
|
81
73
|
# JSON output
|
|
82
|
-
|
|
74
|
+
clawncher deploy "My Token" MYTKN --json
|
|
83
75
|
```
|
|
84
76
|
|
|
85
77
|
### Info
|
|
@@ -88,13 +80,13 @@ Get token info directly from the blockchain:
|
|
|
88
80
|
|
|
89
81
|
```bash
|
|
90
82
|
# Get token info
|
|
91
|
-
|
|
83
|
+
clawncher info 0xTokenAddress
|
|
92
84
|
|
|
93
85
|
# Specify network
|
|
94
|
-
|
|
86
|
+
clawncher info 0xTokenAddress --network mainnet
|
|
95
87
|
|
|
96
88
|
# JSON output
|
|
97
|
-
|
|
89
|
+
clawncher info 0xTokenAddress --json
|
|
98
90
|
```
|
|
99
91
|
|
|
100
92
|
### Fees
|
|
@@ -103,13 +95,16 @@ Check and manage trading fees:
|
|
|
103
95
|
|
|
104
96
|
```bash
|
|
105
97
|
# Check claimable fees (on-chain)
|
|
106
|
-
|
|
98
|
+
clawncher fees check 0xWalletAddress -t 0xToken1,0xToken2
|
|
107
99
|
|
|
108
100
|
# Check available fees (via API)
|
|
109
|
-
|
|
101
|
+
clawncher fees available 0xWalletAddress
|
|
110
102
|
|
|
111
|
-
#
|
|
112
|
-
|
|
103
|
+
# Claim fees
|
|
104
|
+
clawncher fees claim 0xToken... --network mainnet --private-key 0x...
|
|
105
|
+
|
|
106
|
+
# Claim everything (fees + vault + vested dev buy)
|
|
107
|
+
clawncher fees claim 0xToken... --vault --vested-dev-buy
|
|
113
108
|
```
|
|
114
109
|
|
|
115
110
|
### Config
|
|
@@ -118,37 +113,37 @@ Manage CLI configuration:
|
|
|
118
113
|
|
|
119
114
|
```bash
|
|
120
115
|
# Show current configuration
|
|
121
|
-
|
|
116
|
+
clawncher config --show
|
|
122
117
|
|
|
123
118
|
# Set default network
|
|
124
|
-
|
|
119
|
+
clawncher config --network mainnet
|
|
125
120
|
|
|
126
121
|
# Set private key
|
|
127
|
-
|
|
122
|
+
clawncher config --private-key 0x...
|
|
128
123
|
|
|
129
124
|
# Set custom RPC URLs
|
|
130
|
-
|
|
131
|
-
|
|
125
|
+
clawncher config --rpc-sepolia https://my-sepolia-rpc.com
|
|
126
|
+
clawncher config --rpc-mainnet https://my-mainnet-rpc.com
|
|
132
127
|
|
|
133
128
|
# Clear all configuration
|
|
134
|
-
|
|
129
|
+
clawncher config --clear
|
|
135
130
|
```
|
|
136
131
|
|
|
137
|
-
Configuration is stored in `~/.
|
|
132
|
+
Configuration is stored in `~/.clawncher/config.json`.
|
|
138
133
|
|
|
139
134
|
### Addresses
|
|
140
135
|
|
|
141
136
|
Show contract addresses for a network:
|
|
142
137
|
|
|
143
138
|
```bash
|
|
144
|
-
# Show sepolia addresses (default)
|
|
145
|
-
clawnch addresses
|
|
146
|
-
|
|
147
139
|
# Show mainnet addresses
|
|
148
|
-
|
|
140
|
+
clawncher addresses --network mainnet
|
|
141
|
+
|
|
142
|
+
# Show sepolia addresses
|
|
143
|
+
clawncher addresses --network sepolia
|
|
149
144
|
|
|
150
145
|
# JSON output
|
|
151
|
-
|
|
146
|
+
clawncher addresses --json
|
|
152
147
|
```
|
|
153
148
|
|
|
154
149
|
### API Commands
|
|
@@ -157,31 +152,29 @@ These commands fetch data from the Clawnch API:
|
|
|
157
152
|
|
|
158
153
|
```bash
|
|
159
154
|
# List all tokens
|
|
160
|
-
|
|
161
|
-
|
|
155
|
+
clawncher tokens
|
|
156
|
+
clawncher tokens --symbol DOG --limit 10
|
|
162
157
|
|
|
163
158
|
# View launch history
|
|
164
|
-
|
|
165
|
-
|
|
159
|
+
clawncher launches
|
|
160
|
+
clawncher launches --agent "MyAgent" --source moltbook
|
|
166
161
|
|
|
167
162
|
# Get market statistics
|
|
168
|
-
|
|
163
|
+
clawncher stats
|
|
169
164
|
```
|
|
170
165
|
|
|
171
166
|
### About
|
|
172
167
|
|
|
173
|
-
Show
|
|
168
|
+
Show Clawncher information and links:
|
|
174
169
|
|
|
175
170
|
```bash
|
|
176
|
-
|
|
171
|
+
clawncher about
|
|
177
172
|
```
|
|
178
173
|
|
|
179
174
|
## Deploy Options Reference
|
|
180
175
|
|
|
181
176
|
| Option | Description | Example |
|
|
182
177
|
|--------|-------------|---------|
|
|
183
|
-
| `--name` | Token name (required) | `--name "My Token"` |
|
|
184
|
-
| `--symbol` | Token symbol (required) | `--symbol MYTKN` |
|
|
185
178
|
| `--image` | Token image URL | `--image "https://..."` |
|
|
186
179
|
| `--description` | Token description | `--description "A great token"` |
|
|
187
180
|
| `--recipient` | Fee recipient address | `--recipient 0x1234...` |
|
|
@@ -204,17 +197,17 @@ clawnch about
|
|
|
204
197
|
|
|
205
198
|
### Vanity Addresses
|
|
206
199
|
|
|
207
|
-
By default, all tokens are deployed with a **vanity address** starting with `0xccc`. This makes
|
|
200
|
+
By default, all tokens are deployed with a **vanity address** starting with `0xccc`. This makes Clawncher tokens easily identifiable on block explorers.
|
|
208
201
|
|
|
209
202
|
```bash
|
|
210
203
|
# Default: mine for 0xccc... address
|
|
211
|
-
|
|
204
|
+
clawncher deploy "My Token" MTK
|
|
212
205
|
|
|
213
206
|
# Custom prefix (e.g., 0xdead...)
|
|
214
|
-
|
|
207
|
+
clawncher deploy "My Token" MTK --vanity-prefix dead
|
|
215
208
|
|
|
216
209
|
# Disable vanity mining for faster deployment
|
|
217
|
-
|
|
210
|
+
clawncher deploy "My Token" MTK --no-vanity
|
|
218
211
|
```
|
|
219
212
|
|
|
220
213
|
Mining time depends on prefix length:
|
|
@@ -238,21 +231,21 @@ Mining time depends on prefix length:
|
|
|
238
231
|
You can provide your private key in three ways (in order of precedence):
|
|
239
232
|
|
|
240
233
|
1. **Command line flag:** `--private-key 0x...`
|
|
241
|
-
2. **Environment variable:** `
|
|
242
|
-
3. **Config file:** `
|
|
234
|
+
2. **Environment variable:** `CLAWNCHER_PRIVATE_KEY=0x...`
|
|
235
|
+
3. **Config file:** `clawncher config --private-key 0x...`
|
|
243
236
|
|
|
244
237
|
### Network
|
|
245
238
|
|
|
246
239
|
Default network is `sepolia`. Change with:
|
|
247
240
|
|
|
248
241
|
```bash
|
|
249
|
-
|
|
242
|
+
clawncher config --network mainnet
|
|
250
243
|
```
|
|
251
244
|
|
|
252
245
|
Or per-command:
|
|
253
246
|
|
|
254
247
|
```bash
|
|
255
|
-
|
|
248
|
+
clawncher deploy "My Token" MYTKN --network mainnet
|
|
256
249
|
```
|
|
257
250
|
|
|
258
251
|
### RPC URLs
|
|
@@ -264,38 +257,36 @@ Default RPCs are used if not configured:
|
|
|
264
257
|
Configure custom RPCs:
|
|
265
258
|
|
|
266
259
|
```bash
|
|
267
|
-
|
|
268
|
-
|
|
260
|
+
clawncher config --rpc-sepolia https://my-rpc.com
|
|
261
|
+
clawncher config --rpc-mainnet https://my-rpc.com
|
|
269
262
|
```
|
|
270
263
|
|
|
271
264
|
Or per-command:
|
|
272
265
|
|
|
273
266
|
```bash
|
|
274
|
-
|
|
267
|
+
clawncher deploy "My Token" MYTKN --rpc https://my-rpc.com
|
|
275
268
|
```
|
|
276
269
|
|
|
277
270
|
## Environment Variables
|
|
278
271
|
|
|
279
|
-
- `
|
|
280
|
-
- `
|
|
281
|
-
- `MOLTBOOK_KEY` - Moltbook API key for authenticated API operations
|
|
272
|
+
- `CLAWNCHER_PRIVATE_KEY` - Private key for deployments
|
|
273
|
+
- `CLAWNCHER_API_URL` - Override the default API URL (default: https://clawn.ch)
|
|
282
274
|
|
|
283
275
|
## JSON Output
|
|
284
276
|
|
|
285
277
|
All commands support `--json` flag for machine-readable output:
|
|
286
278
|
|
|
287
279
|
```bash
|
|
288
|
-
|
|
289
|
-
|
|
280
|
+
clawncher deploy "My Token" TEST --json | jq '.tokenAddress'
|
|
281
|
+
clawncher info 0x... --json | jq '.symbol'
|
|
290
282
|
```
|
|
291
283
|
|
|
292
284
|
## Related
|
|
293
285
|
|
|
294
|
-
- [
|
|
295
|
-
- [Agent Skill
|
|
296
|
-
- [
|
|
297
|
-
- [
|
|
298
|
-
- [@clawnch/sdk](https://npmjs.com/package/@clawnch/sdk) - TypeScript SDK
|
|
286
|
+
- [Clawncher Website](https://clawn.ch/er)
|
|
287
|
+
- [Agent Skill](https://clawn.ch/er/skill)
|
|
288
|
+
- [Documentation](https://clawn.ch/er/docs)
|
|
289
|
+
- [@clawnch/clawncher-sdk](https://npmjs.com/package/@clawnch/clawncher-sdk) - TypeScript SDK
|
|
299
290
|
|
|
300
291
|
## License
|
|
301
292
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "clawncher",
|
|
3
|
-
"version": "2.2.
|
|
3
|
+
"version": "2.2.2",
|
|
4
4
|
"description": "CLI for Clawncher - token launcher on Base, optimized for agents",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -30,11 +30,7 @@
|
|
|
30
30
|
],
|
|
31
31
|
"author": "Clawncher",
|
|
32
32
|
"license": "MIT",
|
|
33
|
-
"
|
|
34
|
-
"type": "git",
|
|
35
|
-
"url": "https://github.com/clawnch/clawncher"
|
|
36
|
-
},
|
|
37
|
-
"homepage": "https://clawn.ch",
|
|
33
|
+
"homepage": "https://clawn.ch/er",
|
|
38
34
|
"engines": {
|
|
39
35
|
"node": ">=18"
|
|
40
36
|
},
|