{"skill":{"slug":"moltmoon-agentcrypto-sdk","displayName":"MoltMoon Crypto Launcher","summary":"Complete OpenClaw-ready operating skill for @moltmoon/sdk V2. Use when an agent needs to install, configure, and operate the MoltMoon SDK or CLI end-to-end on Base mainnet, including launch dry-runs, metadata/image validation, live token launches, quote checks, buys, sells, rewards claiming, migration, troubleshooting, and safe production runbooks.","description":"---\r\nname: moltmoon-sdk\r\ndescription: Complete OpenClaw-ready operating skill for @moltmoon/sdk V2. Use when an agent needs to install, configure, and operate the MoltMoon SDK or CLI end-to-end on Base mainnet, including launch dry-runs, metadata/image validation, live token launches, quote checks, buys, sells, rewards claiming, migration, troubleshooting, and safe production runbooks.\r\n---\r\n\r\n# MoltMoon SDK Skill (OpenClaw) - V2\r\n\r\nUse this skill to operate the MoltMoon SDK/CLI as a complete agent workflow on Base mainnet.\r\n\r\n## V2 Economics Overview\r\n\r\nMoltMoon V2 uses **MoltTokenV2** (SafeMoon-style reflection tokens) with **BondingCurveMarketV2** bonding curves:\r\n\r\n| Parameter | Value |\r\n|-----------|-------|\r\n| Total supply | 1B tokens per launch |\r\n| Buy fee | 0% |\r\n| Sell fee | 5% (1% holder reflections + 2% creator + 2% treasury) |\r\n| Curve allocation | 80% on bonding curve, 20% reserved for LP |\r\n| Virtual base | $3,000 USDC |\r\n| Min seed (normal) | $20 USDC |\r\n| Platform cut | 10% of seed to treasury |\r\n| Graduation | At 95% of curve tokens sold (avoids asymptotic pricing) |\r\n| LP lock | 180 days on Aerodrome after graduation |\r\n| Creator upfront | Seed-scaled share from curve bucket (capped 20%) |\r\n\r\n**Reflection mechanics**: Every sell triggers 1% redistribution to all token holders (SafeMoon rOwned/tOwned). 4% is auto-swapped to USDC and split 50/50 between creator and treasury. Buys and wallet-to-wallet transfers are tax-free.\r\n\r\n**Post-graduation**: After graduating to Aerodrome DEX, the sell tax continues via multi-DEX pair detection. LP is time-locked for 180 days.\r\n\r\n## Install\r\n\r\nUse one of these paths:\r\n\r\n```bash\r\nnpm install @moltmoon/sdk\r\n```\r\n\r\nor run without install:\r\n\r\n```bash\r\nnpx -y @moltmoon/sdk moltlaunch --help\r\n```\r\n\r\n## Runtime Configuration\r\n\r\nSet environment variables before any write action:\r\n\r\n```env\r\nMOLTMOON_API_URL=https://api.moltmoon.ai\r\nMOLTMOON_NETWORK=base\r\nMOLTMOON_PRIVATE_KEY=0x...   # 32-byte hex key with 0x prefix\r\n```\r\n\r\nNotes:\r\n- `MOLTMOON_NETWORK` supports `base` only.\r\n- `MOLTMOON_PRIVATE_KEY` (or `PRIVATE_KEY`) is required for launch/buy/sell/claim.\r\n\r\n## Supported CLI Commands\r\n\r\nGlobal options:\r\n- `--api-url <url>`\r\n- `--network base`\r\n- `--private-key <0x...>`\r\n\r\nCommands:\r\n- `launch` Launch token (with metadata/image/socials, includes approval + create flow)\r\n- `tokens` List tokens\r\n- `buy` Approve USDC + buy in one flow\r\n- `sell` Approve token + sell in one flow\r\n- `quote-buy` Fetch buy quote only (0% fee)\r\n- `quote-sell` Fetch sell quote only (shows 5% fee deducted)\r\n- `rewards-earned` Check unclaimed USDC rewards for a wallet\r\n- `rewards-claim` Claim unclaimed USDC rewards (requires signer)\r\n- `migration-status` Check V1 to V2 migration status\r\n- `migrate` Migrate V1 tokens to V2 (approve + migrate flow)\r\n\r\n## Canonical CLI Runbooks\r\n\r\n### 1) Dry-run launch first (no chain tx)\r\n\r\n```bash\r\nnpx -y @moltmoon/sdk mltl launch \\\r\n  --name \"Agent Token\" \\\r\n  --symbol \"AGT\" \\\r\n  --description \"Agent launch token on MoltMoon\" \\\r\n  --website \"https://example.com\" \\\r\n  --twitter \"https://x.com/example\" \\\r\n  --discord \"https://discord.gg/example\" \\\r\n  --image \"./logo.png\" \\\r\n  --seed 20 \\\r\n  --dry-run \\\r\n  --json\r\n```\r\n\r\n### 2) Live launch\r\n\r\n```bash\r\nnpx -y @moltmoon/sdk mltl launch \\\r\n  --name \"Agent Token\" \\\r\n  --symbol \"AGT\" \\\r\n  --description \"Agent launch token on MoltMoon\" \\\r\n  --seed 20 \\\r\n  --json\r\n```\r\n\r\n### 3) Trade flow\r\n\r\n```bash\r\n# Buy (0% fee)\r\nnpx -y @moltmoon/sdk mltl quote-buy --market 0xMARKET --usdc 1 --json\r\nnpx -y @moltmoon/sdk mltl buy --market 0xMARKET --usdc 1 --slippage 500 --json\r\n\r\n# Sell (5% fee: 1% reflection + 2% creator + 2% treasury)\r\nnpx -y @moltmoon/sdk mltl quote-sell --market 0xMARKET --tokens 100 --json\r\nnpx -y @moltmoon/sdk mltl sell --market 0xMARKET --token 0xTOKEN --amount 100 --slippage 500 --json\r\n```\r\n\r\n### 4) Rewards flow ($MOLTM holders)\r\n\r\n```bash\r\n# Check earned USDC rewards\r\nnpx -y @moltmoon/sdk mltl rewards-earned --pool 0xPOOL --account 0xWALLET --json\r\n\r\n# Claim rewards\r\nnpx -y @moltmoon/sdk mltl rewards-claim --pool 0xPOOL --json\r\n```\r\n\r\n### 5) V1 to V2 migration\r\n\r\n```bash\r\n# Check migration status\r\nnpx -y @moltmoon/sdk mltl migration-status --json\r\n\r\n# Migrate tokens (approve + swap)\r\nnpx -y @moltmoon/sdk mltl migrate --amount 1000 --json\r\n```\r\n\r\n## SDK API Surface\r\n\r\nInitialize:\r\n\r\n```ts\r\nimport { MoltmoonSDK } from '@moltmoon/sdk';\r\n\r\nconst sdk = new MoltmoonSDK({\r\n  baseUrl: process.env.MOLTMOON_API_URL || 'https://api.moltmoon.ai',\r\n  network: 'base',\r\n  privateKey: process.env.MOLTMOON_PRIVATE_KEY as `0x${string}`,\r\n});\r\n```\r\n\r\nRead methods:\r\n- `getTokens()` - List all launched tokens\r\n- `getMarket(marketAddress)` - Full market details (V2: includes `holderRewardsPool`, `aerodromePool`, `virtualBase`, `liquidityTokens`, `creator`, `usdc`)\r\n- `getQuoteBuy(marketAddress, usdcIn)` - Buy quote (0% fee)\r\n- `getQuoteSell(marketAddress, tokensIn)` - Sell quote (5% fee deducted)\r\n\r\nLaunch methods:\r\n- `prepareLaunchToken(params)` -> metadata URI + intents only (dry-run)\r\n- `launchToken(params)` -> executes approve + create\r\n\r\nTrade methods:\r\n- `buy(marketAddress, usdcIn, slippageBps?)` - Approve USDC + buy\r\n- `sell(marketAddress, tokensIn, tokenAddress, slippageBps?)` - Approve token + sell\r\n\r\nRewards methods:\r\n- `getRewardsEarned(poolAddress, account)` - Check unclaimed USDC\r\n- `claimRewards(poolAddress)` - Claim USDC rewards\r\n\r\nMigration methods:\r\n- `getMigrationStatus()` - V1/V2 migration state\r\n- `migrate(v1Amount)` - Approve V1 + migrate to V2\r\n\r\nUtility methods:\r\n- `calculateProgress(marketDetails)` - Graduation progress %\r\n- `calculateMarketCap(marketDetails)` - Market cap in USDC\r\n\r\n## MarketDetails V2 Fields\r\n\r\nThe `getMarket()` response now includes:\r\n\r\n```ts\r\ninterface MarketDetails {\r\n  market: string;\r\n  token: string;\r\n  usdc: string;                  // USDC contract address\r\n  graduated: boolean;            // true after 95% sold\r\n  curveTokensRemaining: string;\r\n  baseReserveReal: string;       // real USDC in curve\r\n  totalBaseReserve: string;      // virtual + real\r\n  virtualBase: string;           // $3,000 USDC virtual\r\n  liquidityTokens: string;       // reserved for Aerodrome LP\r\n  sellFeeBps: number;            // 500 (5%)\r\n  creator: string;               // token creator address\r\n  holderRewardsPool: string;     // $MOLTM rewards pool\r\n  aerodromePool: string | null;  // DEX pool after graduation\r\n  progressPercent: number;       // 0-95 (graduates at 95)\r\n}\r\n```\r\n\r\n## Launch Metadata + Image Rules\r\n\r\nEnforce these before launch:\r\n- Image must be PNG or JPEG\r\n- Max size 500KB (`<=100KB` recommended)\r\n- Dimensions must be square, min `512x512`, max `2048x2048`\r\n- Social links must be valid URLs\r\n- Seed for normal launch must be at least `20` USDC\r\n\r\n## Failure Diagnosis\r\n\r\n- `Missing private key`\r\n  - Set `MOLTMOON_PRIVATE_KEY` or pass `--private-key`.\r\n- `Unsupported network`\r\n  - Use `base` only.\r\n- `transfer amount exceeds allowance`\r\n  - Re-run buy/sell/launch flow so approvals execute.\r\n- `transfer amount exceeds balance`\r\n  - Fund signer with Base ETH (gas) and USDC/token balance.\r\n- `graduated`\r\n  - Market has graduated to Aerodrome. Trade on DEX directly.\r\n- `slippage`\r\n  - Increase `--slippage` bps or reduce trade size.\r\n- `curve`\r\n  - Not enough tokens remaining on curve for requested buy.\r\n- `threshold`\r\n  - Graduation threshold not yet met (need 95% sold).\r\n- `ERR_NAME_NOT_RESOLVED` or fetch errors\r\n  - Check `MOLTMOON_API_URL` DNS and API uptime.\r\n- image validation errors\r\n  - Fix file type/size/dimensions to rules above.\r\n\r\n## Operator Policy\r\n\r\n- Run dry-run before every first live launch for a new token payload.\r\n- Confirm signer address and chain before write calls.\r\n- Keep secrets in `.env`; never commit keys.\r\n- Record tx hashes after launch/buy/sell/claim for audit trail.\r\n- Graduation is automatic at 95% curve sold - no manual trigger needed.\r\n- After graduation, tokens trade on Aerodrome with continued 5% sell tax.\r\n- $MOLTM holders earn passive USDC from ALL platform sell activity via HolderRewardsPool.\r\n","tags":{"ai crypto":"1.0.2","latest":"1.0.2","launch tokens":"1.0.2","moltmoon.ai":"1.0.2","pumpfun":"1.0.2","token launch":"1.0.2","crypto":"1.0.0","trading":"1.0.0"},"stats":{"comments":0,"downloads":2232,"installsAllTime":84,"installsCurrent":0,"stars":2,"versions":3},"createdAt":1770173285006,"updatedAt":1779076563966},"latestVersion":{"version":"1.0.2","createdAt":1770441944761,"changelog":"- Updated API URL in all documentation from moltmoon.xyz to moltmoon.ai.\n- Removed reference to the special $MOLTM genesis token and its rewards pool mechanics from economic overview.\n- No changes to CLI or SDK usage; documentation aligned with current endpoint.\n- No code changes; this is a documentation and policy update only.","license":null},"metadata":null,"owner":{"handle":"chillbruhhh","userId":"s17dc5x46awj404a6brws8n015884jjb","displayName":"Chillbruhhh","image":"https://avatars.githubusercontent.com/u/191831326?v=4"},"moderation":{"isSuspicious":true,"isMalwareBlocked":false,"verdict":"suspicious","reasonCodes":["suspicious.llm_suspicious"],"summary":"Detected: suspicious.llm_suspicious","engineVersion":"v2.4.24","updatedAt":1779076563966}}