clawclick-sdk 0.1.0

package/README.md

@@ -0,0 +1,141 @@
+# @clawclick/sdk
+
+CLI & SDK for Claw.Click agents — launch tokens, trade, upload images, claim fees.
+
+## Install
+
+```bash
+npm install @clawclick/sdk
+```
+
+Or use the CLI globally:
+
+```bash
+npm install -g @clawclick/sdk
+```
+
+## Setup
+
+Create a `.env` file:
+
+```bash
+CLAWCLICK_PRIVATE_KEY=your_hex_private_key
+CLAWCLICK_RPC_URL=https://sepolia.infura.io/v3/YOUR_KEY
+CLAWCLICK_API_URL=https://your-backend.herokuapp.com
+CLAWCLICK_FACTORY_ADDRESS=0x...
+CLAWCLICK_HOOK_ADDRESS=0x...
+CLAWCLICK_SWAP_EXECUTOR_ADDRESS=0x...
+CLAWCLICK_CHAIN_ID=11155111
+```
+
+## CLI Commands
+
+```bash
+# Launch a new token
+clawclick launch -n "My Token" -s "MTK" -b 0xBeneficiary -m 1.5
+
+# Buy tokens with ETH
+clawclick buy -t 0xTokenAddress -a 0.1
+
+# Sell tokens
+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
+clawclick claim
+clawclick claim -b 0xBeneficiaryAddress
+
+# Claim token fees
+clawclick claim -t 0xTokenAddress
+
+# Get token info (on-chain + API)
+clawclick info -t 0xTokenAddress
+
+# Check balances
+clawclick balance
+clawclick balance -t 0xTokenAddress
+
+# List tokens
+clawclick list
+clawclick list -s mcap -l 20
+clawclick list -q "search term"
+
+# Trending tokens
+clawclick trending
+
+# Platform stats
+clawclick stats
+```
+
+## SDK Usage
+
+```typescript
+import { ClawClick } from '@clawclick/sdk'
+
+const sdk = new ClawClick({
+  privateKey: process.env.PRIVATE_KEY!,
+  rpcUrl: 'https://sepolia.infura.io/v3/...',
+  apiUrl: 'https://your-backend.herokuapp.com',
+  factoryAddress: '0x...',
+  hookAddress: '0x...',
+  swapExecutorAddress: '0x...',
+  chainId: 11155111,
+})
+
+// Launch a token
+const { tokenAddress, poolId, txHash } = await sdk.launch({
+  name: 'My Token',
+  symbol: 'MTK',
+  beneficiary: '0x...',
+  targetMcapETH: '1.5',
+})
+
+// Buy
+await sdk.buy(tokenAddress, '0.1')
+
+// Sell
+await sdk.sell(tokenAddress, '1000000')
+await sdk.sell(tokenAddress, 'all')
+
+// Upload images
+await sdk.uploadImages(tokenAddress, {
+  logoPath: './logo.png',
+  bannerPath: './banner.png',
+})
+
+// Claim fees
+await sdk.claimFeesETH()
+await sdk.claimFeesToken(tokenAddress)
+
+// Read data
+const info = await sdk.getTokenInfo(tokenAddress)
+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()
+
+// 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)
+```
+
+## Building
+
+```bash
+cd cli
+npm install
+npm run build
+```
+
+## Development
+
+```bash
+npm run dev -- launch -n "Test" -s "TST" -b 0x...
+```

package/dist/abi.d.ts

@@ -0,0 +1,542 @@
+export declare const FACTORY_ABI: readonly [{
+    readonly name: "createLaunch";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "name";
+            readonly type: "string";
+        }, {
+            readonly name: "symbol";
+            readonly type: "string";
+        }, {
+            readonly name: "beneficiary";
+            readonly type: "address";
+        }, {
+            readonly name: "agentWallet";
+            readonly type: "address";
+        }, {
+            readonly name: "targetMcapETH";
+            readonly type: "uint256";
+        }, {
+            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 outputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly name: "launchByToken";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly name: "beneficiary";
+            readonly type: "address";
+        }, {
+            readonly name: "agentWallet";
+            readonly type: "address";
+        }, {
+            readonly name: "creator";
+            readonly type: "address";
+        }, {
+            readonly name: "poolId";
+            readonly type: "bytes32";
+        }, {
+            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: "targetMcapETH";
+            readonly type: "uint256";
+        }, {
+            readonly name: "createdAt";
+            readonly type: "uint256";
+        }, {
+            readonly name: "createdBlock";
+            readonly type: "uint256";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+        }, {
+            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: "poolStates";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: 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: "positionTokenIds";
+            readonly type: "uint256[5]";
+        }, {
+            readonly name: "positionMinted";
+            readonly type: "bool[5]";
+        }, {
+            readonly name: "positionRetired";
+            readonly type: "bool[5]";
+        }, {
+            readonly name: "recycledETH";
+            readonly type: "uint256";
+        }, {
+            readonly name: "activated";
+            readonly type: "bool";
+        }, {
+            readonly name: "graduated";
+            readonly type: "bool";
+        }];
+    }];
+}, {
+    readonly name: "getTokenCount";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getTokenAtIndex";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "index";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "totalLaunches";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "previewSqrtPrice";
+    readonly type: "function";
+    readonly stateMutability: "pure";
+    readonly inputs: readonly [{
+        readonly name: "targetMcapETH";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint160";
+    }];
+}, {
+    readonly name: "hook";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "poolManager";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "mintNextPosition";
+    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";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "positionIndex";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];
+export declare const HOOK_ABI: readonly [{
+    readonly name: "launches";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "token";
+            readonly type: "address";
+        }, {
+            readonly name: "beneficiary";
+            readonly type: "address";
+        }, {
+            readonly name: "startMcap";
+            readonly type: "uint256";
+        }, {
+            readonly name: "baseTax";
+            readonly type: "uint256";
+        }, {
+            readonly name: "startSqrtPrice";
+            readonly type: "uint160";
+        }, {
+            readonly name: "phase";
+            readonly type: "uint8";
+        }, {
+            readonly name: "liquidityStage";
+            readonly type: "uint8";
+        }, {
+            readonly name: "graduationMcap";
+            readonly type: "uint256";
+        }];
+    }];
+}, {
+    readonly name: "getCurrentTax";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getCurrentLimits";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "maxTx";
+        readonly type: "uint256";
+    }, {
+        readonly name: "maxWallet";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getCurrentEpoch";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "isGraduated";
+    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: "isGraduatedByToken";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "poolProgress";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "currentPosition";
+        readonly type: "uint256";
+    }, {
+        readonly name: "currentEpoch";
+        readonly type: "uint256";
+    }, {
+        readonly name: "lastEpochMCAP";
+        readonly type: "uint256";
+    }, {
+        readonly name: "graduated";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "getPoolIdForToken";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+    }];
+}, {
+    readonly name: "claimBeneficiaryFeesETH";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "beneficiary";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "claimBeneficiaryFeesToken";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "beneficiary";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "TOTAL_SUPPLY";
+    readonly type: "function";
+    readonly stateMutability: "pure";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}];
+export declare const SWAP_EXECUTOR_ABI: readonly [{
+    readonly name: "executeBuy";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "key";
+        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: "amountIn";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amountOutMin";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "executeSell";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "key";
+        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: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amountIn";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amountOutMin";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];
+export declare const ERC20_ABI: readonly [{
+    readonly name: "approve";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "balanceOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "allowance";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "symbol";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+    }];
+}, {
+    readonly name: "decimals";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint8";
+    }];
+}];
+//# sourceMappingURL=abi.d.ts.map

package/dist/abi.d.ts.map

@@ -0,0 +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"}