clawclick-sdk 0.1.3 → 0.1.5

package/README.md

@@ -2,6 +2,21 @@
 
 CLI & SDK for Claw.Click agents — launch tokens, trade, upload images, claim fees.
 
+## Dual Launch System
+
+The factory supports two launch types:
+
+| Feature | DIRECT (claws.fun) | AGENT (claw.click) |
+|---------|--------------------|--------------------|
+| Hook | None — hookless V4 pool | ClawclickHook — epoch/tax/limits |
+| Fee | 1% LP fee (static) | Dynamic fee (0x800000) via hook |
+| Tax | None | Starts high, decays over 5 epochs |
+| Limits | None | Max TX + Max Wallet, relaxing per epoch |
+| Graduation | N/A | Triggers at 16× starting MCAP |
+| Uniswap UI | Tradeable natively | Requires custom swap UI |
+| Fee claims | `collectFeesFromPosition()` (70/30 split) | `claimFeesETH()` / `claimFeesToken()` via hook |
+| Bootstrap | Min 0.001 ETH (seeds initial liquidity) | Min 0.001 ETH (seeds initial liquidity) |
+
 ## Install
 
 ```bash
@@ -20,38 +35,45 @@ Create a `.env` file:
 
 ```bash
 CLAWCLICK_PRIVATE_KEY=your_hex_private_key
-CLAWCLICK_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
+CLAWCLICK_RPC_URL=https://ethereum-sepolia-rpc.publicnode.com
 CLAWCLICK_API_URL=https://claw-click-backend-5157d572b2b6.herokuapp.com/
-CLAWCLICK_FACTORY_ADDRESS=0x...
-CLAWCLICK_HOOK_ADDRESS=0x...
-CLAWCLICK_SWAP_EXECUTOR_ADDRESS=0x...
+CLAWCLICK_FACTORY_ADDRESS=0xe6f52084209699491aCc2532e857e3510e4c5e13
+CLAWCLICK_HOOK_ADDRESS=0x582c8085b3857E44561a3E9442Adc064E94e2ac8
+CLAWCLICK_POOL_SWAP_TEST_ADDRESS=0x9b6b46e2c869aa39918db7f52f5557fe577b6eee
 CLAWCLICK_CHAIN_ID=11155111
 ```
 
 ## CLI Commands
 
 ```bash
-# Launch a new token
-clawclick launch -n "My Token" -s "MTK" -b 0xBeneficiary -m 1.5
+# Launch a DIRECT token (hookless, tradeable on Uniswap)
+# -e sets bootstrap ETH (min 0.001 ETH required to seed liquidity)
+clawclick launch -n "My Token" -s "MTK" -b 0xBeneficiary -m 1.5 -T direct -e 0.01
+
+# Launch an AGENT token (hook-based, epoch/tax/graduation)
+clawclick launch -n "Agent Token" -s "AGT" -b 0xBeneficiary -m 2 -T agent -e 0.001
 
-# Buy tokens with ETH
+# Launch defaults to AGENT with 0.001 ETH bootstrap if -T and -e are omitted
+clawclick launch -n "Default" -s "DFL" -b 0xBeneficiary
+
+# Buy tokens with ETH (works for both launch types)
 clawclick buy -t 0xTokenAddress -a 0.1
 
-# Sell tokens
+# Sell tokens (works for both launch types)
 clawclick sell -t 0xTokenAddress -a 1000000
 clawclick sell -t 0xTokenAddress -a all
 
 # Upload images (must be token owner/creator/agent)
 clawclick upload -t 0xTokenAddress -l ./logo.png -b ./banner.png
 
-# Claim ETH fees
+# Claim ETH fees (AGENT pools only — via hook)
 clawclick claim
 clawclick claim -b 0xBeneficiaryAddress
 
-# Claim token fees
+# Claim token fees (AGENT pools only — via hook)
 clawclick claim -t 0xTokenAddress
 
-# Get token info (on-chain + API)
+# Get token info (shows launch type, on-chain + API data)
 clawclick info -t 0xTokenAddress
 
 # Check balances
@@ -77,55 +99,106 @@ import { ClawClick } from '@clawclick/sdk'
 
 const sdk = new ClawClick({
   privateKey: process.env.PRIVATE_KEY!,
-  rpcUrl: 'https://sepolia.infura.io/v3/...',
+  rpcUrl: 'https://ethereum-sepolia-rpc.publicnode.com',
   apiUrl: 'https://your-backend.herokuapp.com',
   factoryAddress: '0x...',
   hookAddress: '0x...',
-  swapExecutorAddress: '0x...',
+  poolSwapTestAddress: '0x...',  // PoolSwapTest contract
   chainId: 11155111,
 })
 
-// Launch a token
-const { tokenAddress, poolId, txHash } = await sdk.launch({
-  name: 'My Token',
-  symbol: 'MTK',
+// ── Launch (DIRECT — hookless, Uniswap-tradeable) ──
+const direct = await sdk.launch({
+  name: 'My Direct Token',
+  symbol: 'MDT',
   beneficiary: '0x...',
   targetMcapETH: '1.5',
+  bootstrapETH: '0.01',   // min 0.001 ETH — more = tighter spread
+  launchType: 'direct',   // hookless pool, 1% LP fee
 })
+console.log(direct.launchType) // 'direct'
 
-// Buy
-await sdk.buy(tokenAddress, '0.1')
+// ── Launch (AGENT — hook-based, epoch/tax/graduation) ──
+const agent = await sdk.launch({
+  name: 'Agent Token',
+  symbol: 'AGT',
+  beneficiary: '0x...',
+  targetMcapETH: '2',
+  bootstrapETH: '0.001',  // minimum bootstrap (0.001 ETH)
+  launchType: 'agent',    // default — hook-based pool
+  feeSplit: {
+    wallets: ['0xAlice...', '0xBob...'],
+    percentages: [5000, 5000],  // 50/50 of creator's 70%
+  },
+})
 
-// Sell
-await sdk.sell(tokenAddress, '1000000')
-await sdk.sell(tokenAddress, 'all')
+// ── Trading (same API for both types) ──
+await sdk.buy(tokenAddress, '0.1')        // Buy with 0.1 ETH
+await sdk.sell(tokenAddress, '1000000')   // Sell 1M tokens
+await sdk.sell(tokenAddress, 'all')       // Sell entire balance
 
-// Upload images
-await sdk.uploadImages(tokenAddress, {
-  logoPath: './logo.png',
-  bannerPath: './banner.png',
-})
+// ── Check launch type ──
+const isDirect = await sdk.isDirectLaunch(tokenAddress)
+
+// ── Token info (includes launchType) ──
+const info = await sdk.getTokenInfo(tokenAddress)
+console.log(info.launchType) // 'direct' or 'agent'
 
-// Claim fees
+// ── Fee claims (AGENT only — via hook) ──
 await sdk.claimFeesETH()
 await sdk.claimFeesToken(tokenAddress)
 
-// Read data
-const info = await sdk.getTokenInfo(tokenAddress)
+// ── LP fee collection (DIRECT — via factory) ──
+await sdk.collectFeesFromPosition(tokenAddress, 0)
+
+// ── Pool state (scalar fields — arrays excluded by Solidity auto-getter) ──
+const state = await sdk.getPoolState(tokenAddress)
+console.log(state.activated)    // true
+console.log(state.recycledETH)  // ETH from withdrawn positions
+
+// ── AGENT-specific reads (no-op for DIRECT) ──
 const progress = await sdk.getPoolProgress(tokenAddress)
-const tax = await sdk.getCurrentTax(tokenAddress)
-const limits = await sdk.getCurrentLimits(tokenAddress)
-const graduated = await sdk.isGraduated(tokenAddress)
-const balance = await sdk.getTokenBalance(tokenAddress)
-const ethBalance = await sdk.getETHBalance()
+const tax = await sdk.getCurrentTax(tokenAddress)       // 0n for DIRECT
+const limits = await sdk.getCurrentLimits(tokenAddress)  // max uint for DIRECT
+const graduated = await sdk.isGraduated(tokenAddress)    // false for DIRECT
+
+// ── Upload images ──
+await sdk.uploadImages(tokenAddress, {
+  logoPath: './logo.png',
+  bannerPath: './banner.png',
+})
 
-// API reads
+// ── API reads ──
 const tokens = await sdk.listTokens({ sort: 'hot', limit: 10 })
 const trending = await sdk.getTrending()
 const stats = await sdk.getStats()
 const tokenData = await sdk.getTokenFromAPI(tokenAddress)
 ```
 
+## Architecture
+
+```
+┌──────────────┐     createLaunch(DIRECT)     ┌──────────────────┐
+│              │  ──────────────────────────►  │                  │
+│   CLI / SDK  │                               │  ClawclickFactory │
+│              │  ──────────────────────────►  │                  │
+└──────┬───────┘     createLaunch(AGENT)       └────────┬─────────┘
+       │                                                │
+       │ buy / sell                                     │ AGENT only
+       ▼                                                ▼
+┌──────────────┐                               ┌──────────────────┐
+│ PoolSwapTest │  ─────── swap() ──────────►   │  Uniswap V4      │
+│              │                               │  PoolManager      │
+└──────────────┘                               └────────┬─────────┘
+                                                        │
+                                               ┌────────┴─────────┐
+                                               │ ClawclickHook    │
+                                               │ (AGENT pools)    │
+                                               │ tax / limits /   │
+                                               │ epoch / graduate │
+                                               └──────────────────┘
+```
+
 ## Building
 
 ```bash
@@ -137,5 +210,5 @@ npm run build
 ## Development
 
 ```bash
-npm run dev -- launch -n "Test" -s "TST" -b 0x...
+npm run dev -- launch -n "Test" -s "TST" -b 0x... -T direct
 ```

package/dist/abi.d.ts

@@ -1,3 +1,8 @@
+/** LaunchType enum values matching the contract */
+export declare const LaunchType: {
+    readonly DIRECT: 0;
+    readonly AGENT: 1;
+};
 export declare const FACTORY_ABI: readonly [{
     readonly name: "createLaunch";
     readonly type: "function";
@@ -33,6 +38,9 @@ export declare const FACTORY_ABI: readonly [{
                 readonly name: "count";
                 readonly type: "uint8";
             }];
+        }, {
+            readonly name: "launchType";
+            readonly type: "uint8";
         }];
     }];
     readonly outputs: readonly [{
@@ -115,10 +123,13 @@ export declare const FACTORY_ABI: readonly [{
                 readonly name: "count";
                 readonly type: "uint8";
             }];
+        }, {
+            readonly name: "launchType";
+            readonly type: "uint8";
         }];
     }];
 }, {
-    readonly name: "poolStates";
+    readonly name: "launchByPoolId";
     readonly type: "function";
     readonly stateMutability: "view";
     readonly inputs: readonly [{
@@ -135,34 +146,111 @@ export declare const FACTORY_ABI: readonly [{
             readonly name: "beneficiary";
             readonly type: "address";
         }, {
-            readonly name: "startingMCAP";
-            readonly type: "uint256";
+            readonly name: "agentWallet";
+            readonly type: "address";
         }, {
-            readonly name: "graduationMCAP";
-            readonly type: "uint256";
+            readonly name: "creator";
+            readonly type: "address";
         }, {
-            readonly name: "totalSupply";
-            readonly type: "uint256";
+            readonly name: "poolId";
+            readonly type: "bytes32";
         }, {
-            readonly name: "positionTokenIds";
-            readonly type: "uint256[5]";
+            readonly name: "poolKey";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "currency0";
+                readonly type: "address";
+            }, {
+                readonly name: "currency1";
+                readonly type: "address";
+            }, {
+                readonly name: "fee";
+                readonly type: "uint24";
+            }, {
+                readonly name: "tickSpacing";
+                readonly type: "int24";
+            }, {
+                readonly name: "hooks";
+                readonly type: "address";
+            }];
         }, {
-            readonly name: "positionMinted";
-            readonly type: "bool[5]";
+            readonly name: "targetMcapETH";
+            readonly type: "uint256";
         }, {
-            readonly name: "positionRetired";
-            readonly type: "bool[5]";
+            readonly name: "createdAt";
+            readonly type: "uint256";
         }, {
-            readonly name: "recycledETH";
+            readonly name: "createdBlock";
             readonly type: "uint256";
         }, {
-            readonly name: "activated";
-            readonly type: "bool";
+            readonly name: "name";
+            readonly type: "string";
         }, {
-            readonly name: "graduated";
-            readonly type: "bool";
+            readonly name: "symbol";
+            readonly type: "string";
+        }, {
+            readonly name: "feeSplit";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "wallets";
+                readonly type: "address[5]";
+            }, {
+                readonly name: "percentages";
+                readonly type: "uint16[5]";
+            }, {
+                readonly name: "count";
+                readonly type: "uint8";
+            }];
+        }, {
+            readonly name: "launchType";
+            readonly type: "uint8";
         }];
     }];
+}, {
+    readonly name: "poolStates";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "beneficiary";
+        readonly type: "address";
+    }, {
+        readonly name: "startingMCAP";
+        readonly type: "uint256";
+    }, {
+        readonly name: "graduationMCAP";
+        readonly type: "uint256";
+    }, {
+        readonly name: "totalSupply";
+        readonly type: "uint256";
+    }, {
+        readonly name: "recycledETH";
+        readonly type: "uint256";
+    }, {
+        readonly name: "activated";
+        readonly type: "bool";
+    }, {
+        readonly name: "graduated";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "poolActivated";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
 }, {
     readonly name: "getTokenCount";
     readonly type: "function";
@@ -223,6 +311,24 @@ export declare const FACTORY_ABI: readonly [{
         readonly name: "";
         readonly type: "address";
     }];
+}, {
+    readonly name: "config";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "positionManager";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
 }, {
     readonly name: "mintNextPosition";
     readonly type: "function";
@@ -235,6 +341,18 @@ export declare const FACTORY_ABI: readonly [{
         readonly type: "uint256";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly name: "retireOldPosition";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "positionIndex";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
 }, {
     readonly name: "collectFeesFromPosition";
     readonly type: "function";
@@ -247,6 +365,15 @@ export declare const FACTORY_ABI: readonly [{
         readonly type: "uint256";
     }];
     readonly outputs: readonly [];
+}, {
+    readonly name: "clearDevOverride";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [];
 }];
 export declare const HOOK_ABI: readonly [{
     readonly name: "launches";
@@ -412,8 +539,8 @@ export declare const HOOK_ABI: readonly [{
         readonly type: "uint256";
     }];
 }];
-export declare const SWAP_EXECUTOR_ABI: readonly [{
-    readonly name: "executeBuy";
+export declare const POOL_SWAP_TEST_ABI: readonly [{
+    readonly name: "swap";
     readonly type: "function";
     readonly stateMutability: "payable";
     readonly inputs: readonly [{
@@ -436,17 +563,42 @@ export declare const SWAP_EXECUTOR_ABI: readonly [{
             readonly type: "address";
         }];
     }, {
-        readonly name: "amountIn";
-        readonly type: "uint256";
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "zeroForOne";
+            readonly type: "bool";
+        }, {
+            readonly name: "amountSpecified";
+            readonly type: "int256";
+        }, {
+            readonly name: "sqrtPriceLimitX96";
+            readonly type: "uint160";
+        }];
     }, {
-        readonly name: "amountOutMin";
-        readonly type: "uint256";
+        readonly name: "testSettings";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "takeClaims";
+            readonly type: "bool";
+        }, {
+            readonly name: "settleUsingBurn";
+            readonly type: "bool";
+        }];
+    }, {
+        readonly name: "hookData";
+        readonly type: "bytes";
     }];
-    readonly outputs: readonly [];
-}, {
-    readonly name: "executeSell";
+    readonly outputs: readonly [{
+        readonly name: "delta";
+        readonly type: "int256";
+    }];
+}];
+/** @deprecated Use POOL_SWAP_TEST_ABI instead — SwapExecutor reverts on Sepolia */
+export declare const SWAP_EXECUTOR_ABI: readonly [{
+    readonly name: "swap";
     readonly type: "function";
-    readonly stateMutability: "nonpayable";
+    readonly stateMutability: "payable";
     readonly inputs: readonly [{
         readonly name: "key";
         readonly type: "tuple";
@@ -467,16 +619,36 @@ export declare const SWAP_EXECUTOR_ABI: readonly [{
             readonly type: "address";
         }];
     }, {
-        readonly name: "token";
-        readonly type: "address";
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "zeroForOne";
+            readonly type: "bool";
+        }, {
+            readonly name: "amountSpecified";
+            readonly type: "int256";
+        }, {
+            readonly name: "sqrtPriceLimitX96";
+            readonly type: "uint160";
+        }];
     }, {
-        readonly name: "amountIn";
-        readonly type: "uint256";
+        readonly name: "testSettings";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "takeClaims";
+            readonly type: "bool";
+        }, {
+            readonly name: "settleUsingBurn";
+            readonly type: "bool";
+        }];
     }, {
-        readonly name: "amountOutMin";
-        readonly type: "uint256";
+        readonly name: "hookData";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "delta";
+        readonly type: "int256";
     }];
-    readonly outputs: readonly [];
 }];
 export declare const ERC20_ABI: readonly [{
     readonly name: "approve";

package/dist/abi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmKd,CAAA;AAKV,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwGX,CAAA;AAKV,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CpB,CAAA;AAKV,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CZ,CAAA"}
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,eAAO,MAAM,UAAU;;;CAAmC,CAAA;AA8C1D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuKd,CAAA;AAKV,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwGX,CAAA;AAKV,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCrB,CAAA;AAEV,mFAAmF;AACnF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqB,CAAA;AAKnD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CZ,CAAA"}