moltlaunch 0.1.0 → 0.1.1

package/README.md

@@ -41,11 +41,11 @@ Returns:
 | `moltlaunch wallet` | Show wallet address and balance |
 | `moltlaunch wallet --show-key` | Show wallet with private key |
 | `moltlaunch status` | List all launched tokens |
-| `moltlaunch claim` | Claim accumulated fees |
+| `moltlaunch claim` | Claim accumulated trading fees |
 
 All commands support `--json` for structured output.
 
-## State Diagram
+## How It Works
 
 ```
 npx moltlaunch --name "X" --symbol "X" --image ./logo.png
@@ -58,7 +58,6 @@ npx moltlaunch --name "X" --symbol "X" --image ./logo.png
 │
 ├─ 3. Submit gasless launch
 │     POST web2-api.flaunch.gg/api/v1/base/launch-memecoin
-│     body: { name, symbol, description, imageIpfs, creatorAddress, revenueManagerAddress }
 │     → returns jobId
 │
 ├─ 4. Poll for deployment (2s intervals, 120s timeout)
@@ -71,73 +70,50 @@ npx moltlaunch --name "X" --symbol "X" --image ./logo.png
 └─ 6. Output result (human-readable or --json)
 ```
 
-## Fee Architecture
+## Fee Model
 
-Every token launched through moltlaunch has our Revenue Manager attached. Flaunch uses a **waterfall fee model** — each tier takes a percentage of what remains, not of the total.
+Tokens launched through moltlaunch are immediately tradeable on Flaunch. Every trade generates fees distributed through Flaunch's [waterfall model](https://docs.flaunch.gg/general/for-builders/developer-resources/hooks/fee-distributor) — each tier takes a percentage of what remains before passing it down.
 
 ```
 Trade executes on Uniswap V4 (Base)
 │
-├─ Swap Fee (1% base, up to 50% during high volume)
+├─ Swap Fee (1% base, dynamic up to 50% during high volume)
 │  │
-│  ├─ Referrer Fee (5% of swap fee)
-│  │   └─ Only if a referrer address was passed in the swap
+│  ├─ Referrer Fee (5%)
+│  │   └─ Paid to referrer if one was set on the trade
 │  │
-│  ├─ Protocol Fee (10% of remainder after referrer)  ◄── OUR REVENUE
-│  │   └─ Sent to PositionManager escrow for 0x160e...
+│  ├─ Protocol Fee (10%)
+│  │   └─ Paid to the moltlaunch revenue manager
 │  │
-│  ├─ Creator Fee (80% of remainder after protocol)  ◄── AGENT'S REVENUE
-│  │   └─ Sent to PositionManager escrow for agent's creatorAddress
+│  ├─ Creator Fee (80%)
+│  │   └─ Paid to the token creator (your wallet)
 │  │
 │  └─ BidWall (100% of remainder)
-│      └─ Automated buybacks / token liquidity
+│      └─ Automated buybacks supporting token liquidity
 ```
 
-### Concrete numbers per 1 ETH trade (no referrer, 1% swap fee)
+### Example: 1 ETH trade, no referrer, 1% swap fee
 
-| Tier | Rate | Amount | Recipient |
-|------|------|--------|-----------|
-| Swap fee | 1% of trade | 0.01 ETH | (distributed below) |
-| Referrer | 5% of 0.01 | 0 (no referrer) | — |
-| **Protocol (us)** | **10% of 0.01** | **0.001 ETH** | **RM recipient** |
-| Creator | 80% of 0.009 | 0.0072 ETH | creatorAddress |
-| BidWall | 100% of rest | 0.0018 ETH | Token liquidity |
+| Tier | Rate | Amount |
+|------|------|--------|
+| Swap fee | 1% of trade | 0.01 ETH |
+| Referrer | 5% of fee | 0 (no referrer) |
+| Protocol | 10% of remainder | 0.001 ETH |
+| **Creator (you)** | **80% of remainder** | **0.0072 ETH** |
+| BidWall | Rest | 0.0018 ETH |
 
-The swap fee is dynamic (`DynamicFeeCalculatorV2`): 1% baseline, scales linearly with volume up to 50%, decays over a 1-hour rolling window. Tokens trade heaviest at launch — that's when fees are highest.
+The swap fee is dynamic — 1% baseline, scaling with volume up to 50%, decaying over a 1-hour window. Tokens trade heaviest at launch, which is when creator fees are highest.
 
 ### Claiming fees
 
-Fees accumulate in escrow on the Flaunch **PositionManager** contract, not on the Revenue Manager itself. The RM only tells the fee distributor where to route protocol fees.
+Fees accumulate in escrow on the Flaunch PositionManager. Withdraw anytime:
 
+```bash
+moltlaunch claim          # withdraw to your wallet
+moltlaunch claim --json   # structured output
 ```
-moltlaunch claim
-│
-├─ Check balance: PositionManager.balances(walletAddress)
-│
-├─ If > 0: PositionManager.withdrawFees(walletAddress, true)
-│   └─ unwrap=true converts flETH → native ETH
-│
-└─ Requires ETH for gas (claim is an on-chain transaction)
-```
-
-## Key Contracts (Base Mainnet)
-
-| Contract | Address | Role |
-|----------|---------|------|
-| Revenue Manager | `0x3Bc08524d9DaaDEC9d1Af87818d809611F0fD669` | Our RM — 10% protocol fee, recipient `0x160e...` |
-| PositionManager | `0x51Bba15255406Cfe7099a42183302640ba7dAFDC` | Fee escrow — `balances()`, `withdrawFees()` |
-| Flaunch | `0x6A53F8b799bE11a2A3264eF0bfF183dCB12d9571` | Token factory |
 
-## API Endpoints
-
-| Endpoint | Method | Purpose |
-|----------|--------|---------|
-| `/api/v1/upload-image` | POST | Upload image to IPFS |
-| `/api/v1/{network}/launch-memecoin` | POST | Gasless token launch |
-| `/api/v1/launch-status/{jobId}` | GET | Poll launch status |
-| `/api/v1/{network}/create-revenue-manager` | POST | Create new RM (one-time) |
-
-Base URL: `https://web2-api.flaunch.gg`
+Requires ETH in your wallet for gas (claiming is an on-chain transaction).
 
 ## Exit Codes
 
@@ -153,6 +129,7 @@ Base URL: `https://web2-api.flaunch.gg`
 
 ## Agent Integration
 
+### Python
 ```python
 import subprocess, json
 
@@ -168,23 +145,21 @@ if result.returncode == 0:
     flaunch_url = data["flaunch"]
 ```
 
-## Project Structure
+### Node.js
+```javascript
+import { execSync } from "child_process";
 
+const raw = execSync(
+  'npx moltlaunch --name "AgentCoin" --symbol "AGT" --description "Launched by AI" --image ./logo.png --json',
+  { encoding: "utf-8" }
+);
+const { tokenAddress, flaunch } = JSON.parse(raw);
 ```
-src/
-├── index.ts              # CLI entry point (commander)
-├── types.ts              # Shared interfaces (wallet, launch, API responses)
-├── commands/
-│   ├── launch.ts         # Main flow: wallet → upload → launch → poll → save
-│   ├── claim.ts          # Withdraw fees from PositionManager escrow
-│   ├── status.ts         # List launched tokens from local history
-│   └── wallet.ts         # Show wallet address, balance, private key
-└── lib/
-    ├── config.ts         # Constants: RM address, PM address, API base, chains
-    ├── flaunch-api.ts    # Flaunch Web2 API client (upload, launch, poll)
-    ├── wallet.ts         # Generate/load/save wallet and launch records
-    ├── output.ts         # JSON vs human-readable formatting
-    └── errors.ts         # Typed errors with exit codes
+
+### Shell
+```bash
+OUTPUT=$(npx moltlaunch --name "AgentCoin" --symbol "AGT" --description "test" --image ./logo.png --json)
+[ $? -eq 0 ] && echo "$OUTPUT" | jq -r '.tokenAddress'
 ```
 
 ## Development
@@ -194,3 +169,7 @@ npm install
 npm run build
 npx .  # test locally
 ```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moltlaunch",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI for AI agents to launch tokens on Base via Flaunch",
   "type": "module",
   "bin": {