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.
Files changed (2) hide show
  1. package/README.md +66 -75
  2. package/package.json +2 -6
package/README.md CHANGED
@@ -1,27 +1,27 @@
1
- # clawnch
1
+ # clawncher
2
2
 
3
- Command-line interface for [Clawnch](https://clawn.ch) - deploy tokens on Base with Uniswap V4 pools.
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 clawnch
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
- clawnch config --private-key YOUR_PRIVATE_KEY
15
+ clawncher config --private-key YOUR_PRIVATE_KEY
16
16
 
17
17
  # Deploy a new token
18
- clawnch deploy --name "My Token" --symbol MYTKN
18
+ clawncher deploy "My Token" MYTKN
19
19
 
20
20
  # Show contract addresses
21
- clawnch addresses
21
+ clawncher addresses
22
22
 
23
23
  # Get token info from chain
24
- clawnch info 0xTokenAddress
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
- clawnch deploy --name "My Token" --symbol MYTKN
35
+ clawncher deploy "My Token" MYTKN
36
36
 
37
37
  # With image and description
38
- clawnch deploy \
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
- clawnch deploy --name "My Token" --symbol MYTKN --recipient 0x1234...
43
+ clawncher deploy "My Token" MYTKN --recipient 0x1234...
46
44
 
47
- # 1% LP fee: 80% to deployer (in token by default), 20% protocol
45
+ # 1% LP fee: 80% to deployer, 20% protocol
48
46
  # Change fee preference to receive in WETH instead:
49
- clawnch deploy --name "My Token" --symbol MYTKN --fee-preference Paired
47
+ clawncher deploy "My Token" MYTKN --fee-preference Paired
50
48
 
51
49
  # With vault allocation
52
- clawnch deploy \
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
- clawnch deploy \
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
- clawnch deploy \
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
- clawnch deploy --name "My Token" --symbol MYTKN --network mainnet
68
+ clawncher deploy "My Token" MYTKN --network mainnet
77
69
 
78
70
  # Use custom RPC
79
- clawnch deploy --name "My Token" --symbol MYTKN --rpc https://my-rpc.com
71
+ clawncher deploy "My Token" MYTKN --rpc https://my-rpc.com
80
72
 
81
73
  # JSON output
82
- clawnch deploy --name "My Token" --symbol MYTKN --json
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
- clawnch info 0xTokenAddress
83
+ clawncher info 0xTokenAddress
92
84
 
93
85
  # Specify network
94
- clawnch info 0xTokenAddress --network mainnet
86
+ clawncher info 0xTokenAddress --network mainnet
95
87
 
96
88
  # JSON output
97
- clawnch info 0xTokenAddress --json
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
- clawnch fees check 0xWalletAddress --tokens 0xToken1,0xToken2
98
+ clawncher fees check 0xWalletAddress -t 0xToken1,0xToken2
107
99
 
108
100
  # Check available fees (via API)
109
- clawnch fees available 0xWalletAddress
101
+ clawncher fees available 0xWalletAddress
110
102
 
111
- # Check specific tokens via API
112
- clawnch fees available 0xWalletAddress --tokens 0xToken1,0xToken2
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
- clawnch config --show
116
+ clawncher config --show
122
117
 
123
118
  # Set default network
124
- clawnch config --network sepolia # or mainnet
119
+ clawncher config --network mainnet
125
120
 
126
121
  # Set private key
127
- clawnch config --private-key 0x...
122
+ clawncher config --private-key 0x...
128
123
 
129
124
  # Set custom RPC URLs
130
- clawnch config --rpc-sepolia https://my-sepolia-rpc.com
131
- clawnch config --rpc-mainnet https://my-mainnet-rpc.com
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
- clawnch config --clear
129
+ clawncher config --clear
135
130
  ```
136
131
 
137
- Configuration is stored in `~/.clawnch/config.json`.
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
- clawnch addresses --network mainnet
140
+ clawncher addresses --network mainnet
141
+
142
+ # Show sepolia addresses
143
+ clawncher addresses --network sepolia
149
144
 
150
145
  # JSON output
151
- clawnch addresses --json
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
- clawnch tokens
161
- clawnch tokens --symbol DOG --limit 10
155
+ clawncher tokens
156
+ clawncher tokens --symbol DOG --limit 10
162
157
 
163
158
  # View launch history
164
- clawnch launches
165
- clawnch launches --agent "MyAgent" --source moltbook
159
+ clawncher launches
160
+ clawncher launches --agent "MyAgent" --source moltbook
166
161
 
167
162
  # Get market statistics
168
- clawnch stats
163
+ clawncher stats
169
164
  ```
170
165
 
171
166
  ### About
172
167
 
173
- Show Clawnch information and links:
168
+ Show Clawncher information and links:
174
169
 
175
170
  ```bash
176
- clawnch about
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 Clawnch tokens easily identifiable on block explorers.
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
- clawnch deploy --name "My Token" --symbol MTK
204
+ clawncher deploy "My Token" MTK
212
205
 
213
206
  # Custom prefix (e.g., 0xdead...)
214
- clawnch deploy --name "My Token" --symbol MTK --vanity-prefix dead
207
+ clawncher deploy "My Token" MTK --vanity-prefix dead
215
208
 
216
209
  # Disable vanity mining for faster deployment
217
- clawnch deploy --name "My Token" --symbol MTK --no-vanity
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:** `CLAWNCH_PRIVATE_KEY=0x...`
242
- 3. **Config file:** `clawnch config --private-key 0x...`
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
- clawnch config --network mainnet
242
+ clawncher config --network mainnet
250
243
  ```
251
244
 
252
245
  Or per-command:
253
246
 
254
247
  ```bash
255
- clawnch deploy --network mainnet ...
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
- clawnch config --rpc-sepolia https://my-rpc.com
268
- clawnch config --rpc-mainnet https://my-rpc.com
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
- clawnch deploy --rpc https://my-rpc.com ...
267
+ clawncher deploy "My Token" MYTKN --rpc https://my-rpc.com
275
268
  ```
276
269
 
277
270
  ## Environment Variables
278
271
 
279
- - `CLAWNCH_PRIVATE_KEY` - Private key for deployments
280
- - `CLAWNCH_API_URL` - Override the default API URL (default: https://clawn.ch)
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
- clawnch deploy --name "Test" --symbol TEST --json | jq '.tokenAddress'
289
- clawnch info 0x... --json | jq '.symbol'
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
- - [Clawnch Website](https://clawn.ch)
295
- - [Agent Skill Documentation](https://clawn.ch/skill)
296
- - [Technical Documentation](https://clawn.ch/docs)
297
- - [OpenAPI Specification](https://clawn.ch/api/openapi)
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.1",
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
- "repository": {
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
  },