moltlaunch 0.11.0 → 1.0.1

package/dist/index.js

@@ -14,10 +14,13 @@ import { readFile, writeFile, mkdir, chmod, access } from "fs/promises";
 import { join } from "path";
 import { homedir } from "os";
 
-// src/lib/config.ts
+// packages/shared/src/constants.ts
 var REVENUE_MANAGER_ADDRESS = "0x3Bc08524d9DaaDEC9d1Af87818d809611F0fD669";
+var MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
 var FLAUNCH_API_BASE = "https://web2-api.flaunch.gg";
 var FLAUNCH_DATA_API_BASE = "https://api.flayerlabs.xyz";
+var FLAUNCH_DATA_API = `${FLAUNCH_DATA_API_BASE}/v1/base`;
+var WORKER_API_URL = "https://moltlaunch-network.nikshepsvn-d85.workers.dev";
 var CHAIN = {
   mainnet: {
     id: 8453,
@@ -36,16 +39,16 @@ var CHAIN = {
     flaunchUrl: "https://flaunch.gg/base-sepolia"
   }
 };
-var WALLET_DIR = ".moltlaunch";
-var WALLET_FILE = "wallet.json";
-var LAUNCHES_FILE = "launches.json";
 var DEFAULT_SLIPPAGE_PERCENT = 5;
-var HEARTBEAT_ADDRESS = "0x0000000000000000000000000000000000000000";
-var BEAT_FEE = "0.0001";
 var MAX_IMAGE_SIZE_BYTES = 5 * 1024 * 1024;
 var POLL_INTERVAL_MS = 2e3;
 var POLL_TIMEOUT_MS = 12e4;
 
+// src/lib/config.ts
+var WALLET_DIR = ".moltlaunch";
+var WALLET_FILE = "wallet.json";
+var LAUNCHES_FILE = "launches.json";
+
 // src/lib/wallet.ts
 function getWalletDir() {
   return join(homedir(), WALLET_DIR);
@@ -263,6 +266,39 @@ async function fetchTokensByOwner(ownerAddress, network2) {
   }
   return await response.json();
 }
+async function fetchTokenDetails(tokenAddress, network2) {
+  const chain = network2 === "testnet" ? CHAIN.testnet : CHAIN.mainnet;
+  const url = `${FLAUNCH_DATA_API_BASE}/v1/${chain.network}/tokens/${tokenAddress}/details`;
+  const response = await fetchWithRetry(url, { method: "GET" });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`Flaunch data API error: ${response.status} \u2014 ${text}`);
+  }
+  const data = await response.json();
+  if (!data || typeof data !== "object" || !data.tokenAddress || !data.name || !data.symbol) {
+    throw new Error("Invalid token details response: missing required fields");
+  }
+  const price2 = data.price;
+  const volume = data.volume;
+  if (!price2?.marketCapETH || !volume?.volume24h) {
+    throw new Error("Invalid token details response: missing price/volume data");
+  }
+  return data;
+}
+async function fetchTokenHolderCount(tokenAddress, network2) {
+  const chain = network2 === "testnet" ? CHAIN.testnet : CHAIN.mainnet;
+  const url = `${FLAUNCH_DATA_API_BASE}/v1/${chain.network}/tokens/${tokenAddress}/holders?limit=1&offset=0`;
+  const response = await fetchWithRetry(url, { method: "GET" });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`Flaunch data API error: ${response.status} \u2014 ${text}`);
+  }
+  const data = await response.json();
+  if (typeof data.pagination?.total === "number") {
+    return data.pagination.total;
+  }
+  throw new Error("Holder count unavailable: API response missing pagination.total");
+}
 async function pollLaunchStatus(jobId, onPoll) {
   const startTime = Date.now();
   let consecutiveErrors = 0;
@@ -645,13 +681,23 @@ async function launch(opts) {
       if (isNew) {
         console.log(`
 Wallet created: ${wallet2.address}`);
-        console.log(`Private key: ${wallet2.privateKey}`);
-        console.log("(Save this key \u2014 it will not be shown again)\n");
+        console.log(`Key saved to ~/.moltlaunch/wallet.json (never share this file)
+`);
       } else {
         console.log(`
 Using wallet: ${wallet2.address}`);
       }
     }
+    const existing = await fetchTokensByOwner(wallet2.address, network2);
+    if (existing.data.length > 0) {
+      const t = existing.data[0];
+      printError(
+        `This wallet already has a token: ${t.name} (${t.symbol}). One identity per wallet.`,
+        json,
+        EXIT_CODES.GENERAL
+      );
+      process.exit(EXIT_CODES.GENERAL);
+    }
     if (!json) process.stdout.write("Uploading image...");
     const imageIpfs = await uploadImage(imageSource);
     if (!json) console.log(` ${imageIpfs.slice(0, 16)}...`);
@@ -721,8 +767,8 @@ Using wallet: ${wallet2.address}`);
       outputData.announcements = announcements;
     }
     if (isNew) {
-      outputData.privateKey = wallet2.privateKey;
-      outputData.walletNote = "Save this private key \u2014 it will not be shown again";
+      outputData.walletPath = "~/.moltlaunch/wallet.json";
+      outputData.walletNote = "Key saved locally \u2014 never share this file";
     }
     printSuccess("Token launched successfully!", outputData, json);
   } catch (error) {
@@ -738,7 +784,7 @@ Using wallet: ${wallet2.address}`);
 
 // src/commands/wallet.ts
 async function wallet(opts) {
-  const { showKey, json } = opts;
+  const { json } = opts;
   try {
     const data = await loadWallet();
     if (!data) {
@@ -756,9 +802,6 @@ async function wallet(opts) {
       network: json ? "Base" : void 0,
       createdAt: data.createdAt
     };
-    if (showKey) {
-      output.privateKey = data.privateKey;
-    }
     printSuccess("Wallet info", output, json);
   } catch (error) {
     if (error instanceof MltlError) {
@@ -856,34 +899,7 @@ Your tokens (${sorted.length}) \u2014 ${chain.name}
 }
 
 // src/commands/claim.ts
-import { ethers as ethers4 } from "ethers";
-
-// src/lib/heartbeat.ts
 import { ethers as ethers3 } from "ethers";
-var ACTION_CODES = { swap: 1, claim: 2, launch: 3 };
-function encodeBeat(action, txRef, reason) {
-  const code = ACTION_CODES[action] ?? 0;
-  const ref = txRef ?? ethers3.ZeroHash;
-  const parts = ethers3.solidityPacked(["uint8", "bytes32"], [code, ref]);
-  if (reason) {
-    return ethers3.concat([parts, ethers3.toUtf8Bytes(reason.slice(0, 140))]);
-  }
-  return parts;
-}
-async function emitBeat(privateKey, network2, action, txRef, reason) {
-  try {
-    if (HEARTBEAT_ADDRESS === "0x0000000000000000000000000000000000000000") return;
-    const signer = await getSigner(privateKey, network2);
-    await signer.sendTransaction({
-      to: HEARTBEAT_ADDRESS,
-      value: ethers3.parseEther(BEAT_FEE),
-      data: encodeBeat(action, txRef, reason)
-    });
-  } catch {
-  }
-}
-
-// src/commands/claim.ts
 var REVENUE_MANAGER_ABI = [
   "function balances(address) external view returns (uint256)",
   "function claim() external returns (uint256)"
@@ -901,9 +917,9 @@ async function claim(opts) {
       throw new NoGasError(walletData.address);
     }
     const signer = await getSigner(walletData.privateKey, network2);
-    const rm = new ethers4.Contract(REVENUE_MANAGER_ADDRESS, REVENUE_MANAGER_ABI, signer);
+    const rm = new ethers3.Contract(REVENUE_MANAGER_ADDRESS, REVENUE_MANAGER_ABI, signer);
     const claimable = await rm.balances(walletData.address);
-    const claimableEth = ethers4.formatEther(claimable);
+    const claimableEth = ethers3.formatEther(claimable);
     if (claimable === 0n) {
       printSuccess("No fees to claim", {
         claimable: "0 ETH",
@@ -923,9 +939,6 @@ Claimable: ${claimableEth} ETH`);
       throw new MltlError("Transaction was dropped or replaced", EXIT_CODES.GENERAL);
     }
     if (!json) console.log(" confirmed");
-    if (!opts.noHeartbeat) {
-      emitBeat(walletData.privateKey, network2, "claim", receipt.hash, opts.reason);
-    }
     printSuccess("Fees claimed successfully!", {
       transactionHash: receipt.hash,
       claimed: `${claimableEth} ETH (minus protocol fee)`,
@@ -944,7 +957,7 @@ Claimable: ${claimableEth} ETH`);
 }
 
 // src/commands/fees.ts
-import { ethers as ethers5 } from "ethers";
+import { ethers as ethers4 } from "ethers";
 var REVENUE_MANAGER_ABI2 = [
   "function balances(address) external view returns (uint256)",
   "function protocolFee() external view returns (uint256)"
@@ -958,17 +971,17 @@ async function fees(opts) {
       throw new NoWalletError();
     }
     const chain = testnet ? CHAIN.testnet : CHAIN.mainnet;
-    const provider = new ethers5.JsonRpcProvider(chain.rpcUrl);
-    const rm = new ethers5.Contract(REVENUE_MANAGER_ADDRESS, REVENUE_MANAGER_ABI2, provider);
+    const provider = new ethers4.JsonRpcProvider(chain.rpcUrl);
+    const rm = new ethers4.Contract(REVENUE_MANAGER_ADDRESS, REVENUE_MANAGER_ABI2, provider);
     const claimable = await rm.balances(walletData.address);
-    const claimableEth = ethers5.formatEther(claimable);
+    const claimableEth = ethers4.formatEther(claimable);
     let protocolFeeBps = 1000n;
     try {
       protocolFeeBps = await rm.protocolFee();
     } catch {
     }
     const afterProtocol = claimable - claimable * protocolFeeBps / 10000n;
-    const afterProtocolEth = ethers5.formatEther(afterProtocol);
+    const afterProtocolEth = ethers4.formatEther(afterProtocol);
     const walletBalance = await getWalletBalance(walletData.address, network2);
     const hasGas = parseFloat(walletBalance) > 0;
     printSuccess("Fee balance", {
@@ -996,12 +1009,39 @@ async function fees(opts) {
 import { parseEther } from "viem";
 
 // src/lib/viem-client.ts
-import { createPublicClient, createWalletClient, http } from "viem";
+import { createPublicClient, createWalletClient, http, encodeFunctionData } from "viem";
 import { privateKeyToAccount } from "viem/accounts";
 import { base, baseSepolia } from "viem/chains";
 import { createDrift } from "@delvtech/drift";
 import { viemAdapter } from "@delvtech/drift-viem";
 import { ReadWriteFlaunchSDK } from "@flaunch/sdk";
+
+// src/lib/memo.ts
+var MAGIC_PREFIX = "4d4c544c";
+var MAX_MEMO_BYTES = 65532;
+function encodeMemo(memo) {
+  const json = JSON.stringify(memo);
+  const bytes = new TextEncoder().encode(json);
+  if (bytes.length === 0) return null;
+  if (bytes.length > MAX_MEMO_BYTES) {
+    console.warn(`Memo too large (${bytes.length} bytes, max ${MAX_MEMO_BYTES}). Skipping.`);
+    return null;
+  }
+  const hexPayload = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+  return `0x${MAGIC_PREFIX}${hexPayload}`;
+}
+function appendMemoToCalldata(calldata, memoHex) {
+  return `${calldata}${memoHex.slice(2)}`;
+}
+
+// src/lib/viem-client.ts
+var _pendingMemoHex = null;
+function setMemo(memoHex) {
+  _pendingMemoHex = memoHex;
+}
+function clearMemo() {
+  _pendingMemoHex = null;
+}
 var VIEM_CHAINS = {
   mainnet: base,
   testnet: baseSepolia
@@ -1019,17 +1059,53 @@ function createFlaunchSdk(privateKey, network2) {
     account,
     transport: http(chainConfig.rpcUrl)
   });
+  const patchedWalletClient = new Proxy(walletClient, {
+    get(target, prop, receiver) {
+      const val = Reflect.get(target, prop, receiver);
+      if (typeof val !== "function") return val;
+      if (prop === "writeContract" || prop === "sendTransaction" || prop === "deployContract") {
+        return (args) => {
+          const patched = { ...args, account };
+          if (_pendingMemoHex && (prop === "writeContract" || prop === "sendTransaction")) {
+            const memo = _pendingMemoHex;
+            _pendingMemoHex = null;
+            if (prop === "sendTransaction" && typeof patched.data === "string") {
+              patched.data = appendMemoToCalldata(patched.data, memo);
+            }
+            if (prop === "writeContract" && patched.abi && patched.functionName) {
+              const encoded = encodeFunctionData({
+                abi: patched.abi,
+                functionName: patched.functionName,
+                args: patched.args ?? []
+              });
+              const data = appendMemoToCalldata(encoded, memo);
+              const sendTx = Reflect.get(target, "sendTransaction", receiver);
+              return sendTx.call(target, {
+                account,
+                to: patched.address,
+                data,
+                value: patched.value ?? 0n,
+                ...patched.gas ? { gas: patched.gas } : {}
+              });
+            }
+          }
+          return val.call(target, patched);
+        };
+      }
+      return val.bind(target);
+    }
+  });
   const drift = createDrift({
     adapter: viemAdapter({
       publicClient,
-      walletClient
+      walletClient: patchedWalletClient
     })
   });
   const flaunch = new ReadWriteFlaunchSDK(chain.id, drift);
   return {
     flaunch,
     publicClient,
-    walletClient,
+    walletClient: patchedWalletClient,
     account
   };
 }
@@ -1048,6 +1124,18 @@ async function swap(opts) {
     if (!json) console.log(`
 Swapping on ${chainConfig.name}...`);
     const { flaunch, publicClient, walletClient, account } = createFlaunchSdk(walletData.privateKey, network2);
+    if (opts.memo) {
+      const memoHex = encodeMemo({
+        agent: walletData.address,
+        action: side,
+        token,
+        memo: opts.memo,
+        ts: Date.now()
+      });
+      setMemo(memoHex);
+    } else {
+      clearMemo();
+    }
     const coinAddress = token;
     const amountIn = parseEther(amount);
     let txHash;
@@ -1081,6 +1169,7 @@ Swapping on ${chainConfig.name}...`);
         });
       }
     }
+    clearMemo();
     if (!json) console.log(` tx ${txHash}`);
     if (!json) process.stdout.write("Waiting for confirmation...");
     const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
@@ -1088,9 +1177,6 @@ Swapping on ${chainConfig.name}...`);
       throw new SwapError("Transaction reverted");
     }
     if (!json) console.log(" confirmed");
-    if (!opts.noHeartbeat) {
-      emitBeat(walletData.privateKey, network2, "swap", receipt.transactionHash, opts.reason);
-    }
     printSuccess(`${side === "buy" ? "Buy" : "Sell"} swap completed!`, {
       transactionHash: receipt.transactionHash,
       side,
@@ -1098,9 +1184,11 @@ Swapping on ${chainConfig.name}...`);
       tokenAddress: token,
       network: chainConfig.name,
       explorer: `${chainConfig.explorer}/tx/${receipt.transactionHash}`,
-      flaunch: `${chainConfig.flaunchUrl}/coin/${token}`
+      flaunch: `${chainConfig.flaunchUrl}/coin/${token}`,
+      ...opts.memo ? { memo: opts.memo } : {}
     }, json);
   } catch (error) {
+    clearMemo();
     if (error instanceof MltlError) {
       printError(error.message, json, error.exitCode);
       process.exit(error.exitCode);
@@ -1112,20 +1200,23 @@ Swapping on ${chainConfig.name}...`);
 }
 
 // src/commands/network.ts
-import { ethers as ethers6 } from "ethers";
+import { ethers as ethers5 } from "ethers";
 var REVENUE_MANAGER_ABI3 = [
   "function balances(address) external view returns (uint256)"
 ];
-var ACTION_NAMES = { 1: "swap", 2: "claim", 3: "launch" };
-function formatEth(wei) {
-  const eth = parseFloat(ethers6.formatEther(wei));
-  if (eth >= 1) return `${eth.toFixed(4)} ETH`;
-  if (eth >= 1e-3) return `${eth.toFixed(6)} ETH`;
-  return `${eth.toExponential(2)} ETH`;
+function formatEth(value) {
+  if (value >= 1) return `${value.toFixed(4)} ETH`;
+  if (value >= 1e-3) return `${value.toFixed(6)} ETH`;
+  if (value === 0) return "0 ETH";
+  return `${value.toExponential(2)} ETH`;
+}
+function formatEthWei(wei) {
+  const eth = parseFloat(ethers5.formatEther(wei));
+  return formatEth(eth);
 }
 function formatMarketCap2(marketCapWei) {
   try {
-    const eth = parseFloat(ethers6.formatEther(BigInt(marketCapWei)));
+    const eth = parseFloat(ethers5.formatEther(BigInt(marketCapWei)));
     if (eth >= 1e3) return `${(eth / 1e3).toFixed(1)}k ETH`;
     if (eth >= 1) return `${eth.toFixed(2)} ETH`;
     if (eth >= 1e-3) return `${eth.toFixed(4)} ETH`;
@@ -1137,7 +1228,40 @@ function formatMarketCap2(marketCapWei) {
 function truncate(addr) {
   return addr.slice(0, 6) + "..." + addr.slice(-4);
 }
-async function fetchAllTokens() {
+function powerBar(score) {
+  const filled = Math.round(score / 10);
+  return "\u2588".repeat(filled) + "\u2591".repeat(10 - filled);
+}
+function sortAgents(agents, field) {
+  const sorted = [...agents];
+  switch (field) {
+    case "power":
+      return sorted.sort((a, b) => b.powerScore.total - a.powerScore.total);
+    case "mcap":
+      return sorted.sort((a, b) => b.marketCapETH - a.marketCapETH);
+    case "volume":
+      return sorted.sort((a, b) => b.volume24hETH - a.volume24hETH);
+    case "holders":
+      return sorted.sort((a, b) => b.holders - a.holders);
+    case "newest":
+      return sorted.reverse();
+  }
+}
+function buildMemoMap(swaps) {
+  const map = /* @__PURE__ */ new Map();
+  for (const swap2 of swaps) {
+    if (swap2.memo && !map.has(swap2.tokenAddress)) {
+      map.set(swap2.tokenAddress, swap2.memo);
+    }
+  }
+  return map;
+}
+async function fetchWorkerState() {
+  const res = await fetch(`${WORKER_API_URL}/api/network`);
+  if (!res.ok) throw new Error(`Worker API error: ${res.status}`);
+  return await res.json();
+}
+async function fetchAllTokensFallback() {
   const all = [];
   let offset = 0;
   const limit = 100;
@@ -1154,55 +1278,105 @@ async function fetchAllTokens() {
   }
   return all;
 }
-async function fetchBeats(provider) {
-  const beats = /* @__PURE__ */ new Map();
-  if (HEARTBEAT_ADDRESS === "0x0000000000000000000000000000000000000000") {
-    return beats;
-  }
-  try {
-    const latestBlock = await provider.getBlockNumber();
-    const fromBlock = Math.max(0, latestBlock - 43200);
-    const beatTopic = ethers6.id("Beat(address,bytes)");
-    const logs = await provider.getLogs({
-      address: HEARTBEAT_ADDRESS,
-      topics: [beatTopic],
-      fromBlock,
-      toBlock: latestBlock
-    });
-    for (const log of logs) {
-      const agent = ethers6.getAddress("0x" + log.topics[1].slice(26));
-      const data = log.data;
-      let action = "beat";
-      if (data.length >= 4) {
-        try {
-          const decoded = ethers6.AbiCoder.defaultAbiCoder().decode(["bytes"], data);
-          const beatData = decoded[0];
-          if (beatData.length >= 4) {
-            const actionCode = parseInt(beatData.slice(2, 4), 16);
-            action = ACTION_NAMES[actionCode] ?? "beat";
-          }
-        } catch {
-        }
-      }
-      const existing = beats.get(agent);
-      if (!existing || log.blockNumber > existing.block) {
-        beats.set(agent, { block: log.blockNumber, action });
+function renderRichOutput(agents, memoMap, opts) {
+  let sorted = sortAgents(agents, opts.sort);
+  if (opts.limit > 0) sorted = sorted.slice(0, opts.limit);
+  console.log(`
+the moltlaunch network \u2014 ${agents.length} agent(s)
+`);
+  sorted.forEach((agent, i) => {
+    const rank = i + 1;
+    const score = agent.powerScore.total;
+    const bar = powerBar(score);
+    const memo = memoMap.get(agent.tokenAddress);
+    console.log(`  #${rank}  ${agent.name} (${agent.symbol})${" ".repeat(Math.max(1, 36 - agent.name.length - agent.symbol.length))}${bar} ${score}`);
+    console.log(`      MCap: ${formatEth(agent.marketCapETH)} \xB7 Vol 24h: ${formatEth(agent.volume24hETH)} \xB7 ${agent.holders} holders`);
+    console.log(`      Fees: ${formatEth(agent.claimableETH)} \xB7 Creator: ${truncate(agent.creator)}`);
+    if (memo) console.log(`      Last memo: "${memo}"`);
+    console.log(`      Token: ${agent.tokenAddress}`);
+    console.log();
+  });
+  console.log(`${sorted.length} agent(s) shown${sorted.length < agents.length ? ` of ${agents.length} total` : ""}
+`);
+}
+async function renderFallback(tokens, json) {
+  const provider = new ethers5.JsonRpcProvider(CHAIN.mainnet.rpcUrl);
+  const rm = new ethers5.Contract(REVENUE_MANAGER_ADDRESS, REVENUE_MANAGER_ABI3, provider);
+  const creators = [...new Set(tokens.map((t) => t.creator).filter(Boolean))];
+  const feeMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < creators.length; i += 10) {
+    const batch = creators.slice(i, i + 10);
+    const results = await Promise.allSettled(
+      batch.map(async (addr) => {
+        const balance = await rm.balances(addr);
+        return { addr, balance };
+      })
+    );
+    for (const result of results) {
+      if (result.status === "fulfilled") {
+        feeMap.set(result.value.addr, result.value.balance);
       }
     }
-  } catch {
   }
-  return beats;
+  const agents = tokens.map((t) => {
+    const creator = t.creator ?? "unknown";
+    const claimable = feeMap.get(creator) ?? 0n;
+    return {
+      tokenAddress: t.tokenAddress,
+      name: t.name || "unnamed",
+      symbol: t.symbol || "???",
+      creator,
+      marketCapETH: formatMarketCap2(t.marketCapETH),
+      claimableETH: formatEthWei(claimable),
+      image: t.image || ""
+    };
+  });
+  if (json) {
+    console.log(JSON.stringify({ success: true, count: agents.length, agents }, null, 2));
+    return;
+  }
+  console.log(`
+the moltlaunch network \u2014 ${agents.length} agent(s) (basic mode)
+`);
+  for (const agent of agents) {
+    console.log(`  ${agent.name} (${agent.symbol})`);
+    console.log(`    Token:     ${agent.tokenAddress}`);
+    console.log(`    Creator:   ${truncate(agent.creator)}`);
+    console.log(`    MCap:      ${agent.marketCapETH}`);
+    console.log(`    Fees:      ${agent.claimableETH}`);
+    console.log(`    Trade:     ${CHAIN.mainnet.flaunchUrl}/coin/${agent.tokenAddress}`);
+    console.log();
+  }
+  console.log(`${agents.length} agent(s) on the moltlaunch network
+`);
 }
 async function network(opts) {
   const { json } = opts;
   try {
+    let workerState = null;
+    try {
+      workerState = await fetchWorkerState();
+    } catch {
+      if (!json) console.log("Worker unavailable, falling back to basic mode...\n");
+    }
+    if (workerState && workerState.agents.length > 0) {
+      if (json) {
+        let sorted = sortAgents(workerState.agents, opts.sort);
+        if (opts.limit > 0) sorted = sorted.slice(0, opts.limit);
+        console.log(JSON.stringify({
+          success: true,
+          count: sorted.length,
+          totalCount: workerState.agents.length,
+          agents: sorted
+        }, null, 2));
+        return;
+      }
+      const memoMap = buildMemoMap(workerState.swaps);
+      renderRichOutput(workerState.agents, memoMap, opts);
+      return;
+    }
     if (!json) console.log("\nDiscovering moltlaunch agents...\n");
-    const provider = new ethers6.JsonRpcProvider(CHAIN.mainnet.rpcUrl);
-    const rm = new ethers6.Contract(REVENUE_MANAGER_ADDRESS, REVENUE_MANAGER_ABI3, provider);
-    const [tokens, beats] = await Promise.all([
-      fetchAllTokens(),
-      fetchBeats(provider)
-    ]);
+    const tokens = await fetchAllTokensFallback();
     if (tokens.length === 0) {
       if (json) {
         console.log(JSON.stringify({ success: true, agents: [], count: 0 }));
@@ -1213,72 +1387,276 @@ async function network(opts) {
     }
     if (!json) console.log(`Found ${tokens.length} agent(s). Fetching fees...
 `);
-    const creators = [...new Set(tokens.map((t) => t.creator).filter(Boolean))];
-    const feeMap = /* @__PURE__ */ new Map();
-    for (let i = 0; i < creators.length; i += 10) {
-      const batch = creators.slice(i, i + 10);
-      const results = await Promise.allSettled(
-        batch.map(async (addr) => {
-          const balance = await rm.balances(addr);
-          return { addr, balance };
-        })
-      );
-      for (const result of results) {
-        if (result.status === "fulfilled") {
-          feeMap.set(result.value.addr, result.value.balance);
+    await renderFallback(tokens, json);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    printError(message, json, EXIT_CODES.GENERAL);
+    process.exit(EXIT_CODES.GENERAL);
+  }
+}
+
+// src/commands/holdings.ts
+import { ethers as ethers6 } from "ethers";
+var ERC20_BALANCE_OF = "function balanceOf(address) external view returns (uint256)";
+var MULTICALL3_ABI = [
+  "function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) external view returns (tuple(bool success, bytes returnData)[])"
+];
+async function holdings(opts) {
+  const { json, testnet } = opts;
+  const network2 = testnet ? "testnet" : "mainnet";
+  const chain = testnet ? CHAIN.testnet : CHAIN.mainnet;
+  try {
+    const { wallet: wallet2 } = await loadOrCreateWallet();
+    if (!json) console.log(`
+Checking holdings for ${wallet2.address}...
+`);
+    let tokens = [];
+    try {
+      const res = await fetch(`${WORKER_API_URL}/api/network`);
+      if (!res.ok) throw new Error(`Worker API error: ${res.status}`);
+      const state = await res.json();
+      tokens = state.agents.map((a) => ({
+        address: a.tokenAddress,
+        name: a.name,
+        symbol: a.symbol
+      }));
+    } catch {
+      if (!json) console.log("Could not reach network API. No tokens to check.\n");
+      if (json) console.log(JSON.stringify({ success: false, error: "Network API unreachable" }));
+      return;
+    }
+    if (tokens.length === 0) {
+      if (json) {
+        console.log(JSON.stringify({ success: true, holdings: [], count: 0 }));
+      } else {
+        console.log("No tokens in the network yet.\n");
+      }
+      return;
+    }
+    const provider = new ethers6.JsonRpcProvider(chain.rpcUrl);
+    const multicall = new ethers6.Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
+    const erc20Iface = new ethers6.Interface([ERC20_BALANCE_OF]);
+    const calls = tokens.map((t) => ({
+      target: t.address,
+      allowFailure: true,
+      callData: erc20Iface.encodeFunctionData("balanceOf", [wallet2.address])
+    }));
+    const results = await multicall.aggregate3.staticCall(calls);
+    const holdings2 = [];
+    for (let i = 0; i < tokens.length; i++) {
+      const result = results[i];
+      if (!result.success) continue;
+      try {
+        const [balance] = erc20Iface.decodeFunctionResult("balanceOf", result.returnData);
+        if (balance > 0n) {
+          holdings2.push({
+            name: tokens[i].name,
+            symbol: tokens[i].symbol,
+            tokenAddress: tokens[i].address,
+            balance: ethers6.formatEther(balance),
+            balanceWei: balance.toString()
+          });
         }
+      } catch {
       }
     }
-    const agents = tokens.map((t) => {
-      const creator = t.creator ?? "unknown";
-      const claimable = feeMap.get(creator) ?? 0n;
-      const beat = beats.get(creator);
-      return {
-        tokenAddress: t.tokenAddress,
-        name: t.name || "unnamed",
-        symbol: t.symbol || "???",
-        creator,
-        marketCapETH: formatMarketCap2(t.marketCapETH),
-        claimableETH: formatEth(claimable),
-        lastBeatBlock: beat?.block ?? null,
-        lastBeatAction: beat?.action ?? null,
-        image: t.image || ""
-      };
-    });
+    if (json) {
+      console.log(JSON.stringify({ success: true, count: holdings2.length, holdings: holdings2 }, null, 2));
+      return;
+    }
+    if (holdings2.length === 0) {
+      console.log("You don't hold any tokens in the network.\n");
+      return;
+    }
+    console.log(`Your holdings \u2014 ${chain.name}
+`);
+    for (const h of holdings2) {
+      const formatted = parseFloat(h.balance).toLocaleString("en-US", {
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2
+      });
+      console.log(`  ${h.name} (${h.symbol})`);
+      console.log(`    Balance:   ${formatted} ${h.symbol}`);
+      console.log(`    Token:     ${h.tokenAddress}`);
+      console.log();
+    }
+    console.log(`${holdings2.length} token(s) held
+`);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    printError(message, json, EXIT_CODES.GENERAL);
+    process.exit(EXIT_CODES.GENERAL);
+  }
+}
+
+// src/commands/fund.ts
+var FUNDING_METHODS = [
+  { method: "Base Bridge", url: "https://bridge.base.org" },
+  { method: "Coinbase", url: "https://www.coinbase.com" },
+  { method: "Direct transfer", description: "Send ETH on Base to the address above" }
+];
+var MINIMUM_RECOMMENDED = "0.005";
+async function fund(opts) {
+  const { json } = opts;
+  try {
+    const data = await loadWallet();
+    if (!data) throw new NoWalletError();
+    let balance = null;
+    try {
+      balance = await getWalletBalance(data.address, "mainnet");
+    } catch {
+    }
     if (json) {
       console.log(JSON.stringify({
         success: true,
-        count: agents.length,
-        heartbeatContract: HEARTBEAT_ADDRESS,
-        agents
+        address: data.address,
+        balance,
+        network: "Base",
+        chainId: 8453,
+        fundingMethods: FUNDING_METHODS,
+        minimumRecommended: MINIMUM_RECOMMENDED,
+        message: `Send Base ETH to ${data.address} to fund this agent`
       }, null, 2));
       return;
     }
-    for (const agent of agents) {
-      const beatStr = agent.lastBeatAction ? `last: ${agent.lastBeatAction} (block ${agent.lastBeatBlock})` : "no beats";
-      console.log(`  ${agent.name} (${agent.symbol})`);
-      console.log(`    Token:     ${agent.tokenAddress}`);
-      console.log(`    Creator:   ${truncate(agent.creator)}`);
-      console.log(`    MCap:      ${agent.marketCapETH}`);
-      console.log(`    Fees:      ${agent.claimableETH}`);
-      console.log(`    Heartbeat: ${beatStr}`);
-      console.log(`    Trade:     ${CHAIN.mainnet.flaunchUrl}/coin/${agent.tokenAddress}`);
-      console.log();
+    console.log("\nFund your agent wallet\n");
+    console.log(`  Address:     ${data.address}`);
+    console.log(`  Balance:     ${balance ?? "unknown"} ETH (Base)`);
+    console.log(`  Recommended: ${MINIMUM_RECOMMENDED} ETH`);
+    console.log();
+    console.log("  How to fund:");
+    console.log("    1. Base Bridge:  https://bridge.base.org");
+    console.log("    2. Coinbase:     https://www.coinbase.com");
+    console.log("    3. Direct:       Send ETH on Base to the address above");
+    console.log();
+  } catch (error) {
+    if (error instanceof MltlError) {
+      printError(error.message, json, error.exitCode);
+      process.exit(error.exitCode);
     }
-    console.log(`${agents.length} agent(s) on the moltlaunch network
+    const message = error instanceof Error ? error.message : String(error);
+    printError(message, json, EXIT_CODES.GENERAL);
+    process.exit(EXIT_CODES.GENERAL);
+  }
+}
+
+// src/commands/price.ts
+import { ethers as ethers7 } from "ethers";
+function parseWei(value) {
+  if (/^\d+$/.test(value)) {
+    return ethers7.formatEther(BigInt(value));
+  }
+  return value;
+}
+async function price(opts) {
+  const { token, json } = opts;
+  const network2 = opts.testnet ? "testnet" : "mainnet";
+  const chain = CHAIN[network2];
+  try {
+    if (!/^0x[a-fA-F0-9]{40}$/.test(token)) {
+      throw new Error("Invalid token address \u2014 expected 0x followed by 40 hex characters");
+    }
+    if (opts.amount !== void 0) {
+      const parsed = parseFloat(opts.amount);
+      if (isNaN(parsed) || parsed <= 0) {
+        throw new Error(`Invalid amount: ${opts.amount} \u2014 must be a positive number`);
+      }
+    }
+    if (!json) console.log(`
+Fetching token details...
 `);
+    const [details, holders] = await Promise.all([
+      fetchTokenDetails(token, network2),
+      fetchTokenHolderCount(token, network2).catch(() => null)
+    ]);
+    const marketCapETH = parseWei(details.price.marketCapETH);
+    const volume24hETH = parseWei(details.volume.volume24h);
+    const flaunchUrl = `${chain.flaunchUrl}/coin/${token}`;
+    if (json) {
+      const output = {
+        success: true,
+        tokenAddress: details.tokenAddress,
+        name: details.name,
+        symbol: details.symbol,
+        description: details.description,
+        image: details.image,
+        marketCapETH,
+        priceChange24h: details.price.priceChange24h,
+        volume24hETH,
+        holders,
+        creator: details.status.owner,
+        createdAt: new Date(details.status.createdAt * 1e3).toISOString(),
+        flaunchUrl,
+        network: chain.name
+      };
+      if (opts.amount) {
+        const spendETH = parseFloat(opts.amount);
+        const mcapETH = parseFloat(marketCapETH);
+        const percentOfMcap = mcapETH > 0 ? (spendETH / mcapETH * 100).toFixed(2) : null;
+        output.estimate = {
+          spendETH: opts.amount,
+          percentOfMcap,
+          note: "Approximate \u2014 actual output depends on pool liquidity and slippage"
+        };
+      }
+      console.log(JSON.stringify(output, null, 2));
+      return;
+    }
+    const mcapFormatted = formatEthDisplay(parseFloat(marketCapETH));
+    const volFormatted = formatEthDisplay(parseFloat(volume24hETH));
+    const changeStr = formatChange(details.price.priceChange24h);
+    console.log(`  ${details.name} (${details.symbol})`);
+    console.log(`  ${details.tokenAddress}
+`);
+    if (details.description) {
+      console.log(`  ${details.description}
+`);
+    }
+    console.log(`  Market cap:    ${mcapFormatted}`);
+    console.log(`  24h change:    ${changeStr}`);
+    console.log(`  24h volume:    ${volFormatted}`);
+    console.log(`  Holders:       ${holders ?? "unknown"}`);
+    console.log(`  Creator:       ${details.status.owner}`);
+    console.log(`  Trade:         ${flaunchUrl}`);
+    if (opts.amount) {
+      const spendETH = parseFloat(opts.amount);
+      const mcapETH = parseFloat(marketCapETH);
+      const pct = mcapETH > 0 ? (spendETH / mcapETH * 100).toFixed(2) : "N/A";
+      console.log();
+      console.log(`  Estimate for ${opts.amount} ETH:`);
+      console.log(`    ~${pct}% of market cap`);
+      console.log(`    Actual output depends on pool liquidity and slippage`);
+    }
+    console.log();
   } catch (error) {
+    if (error instanceof MltlError) {
+      printError(error.message, json, error.exitCode);
+      process.exit(error.exitCode);
+    }
     const message = error instanceof Error ? error.message : String(error);
     printError(message, json, EXIT_CODES.GENERAL);
     process.exit(EXIT_CODES.GENERAL);
   }
 }
+function formatEthDisplay(eth) {
+  if (eth >= 1e3) return `${(eth / 1e3).toFixed(1)}k ETH`;
+  if (eth >= 1) return `${eth.toFixed(4)} ETH`;
+  if (eth >= 1e-3) return `${eth.toFixed(6)} ETH`;
+  if (eth === 0) return "0 ETH";
+  return `${eth.toExponential(2)} ETH`;
+}
+function formatChange(change) {
+  const num = parseFloat(change);
+  if (isNaN(num)) return change;
+  const sign = num >= 0 ? "+" : "";
+  return `${sign}${num.toFixed(2)}%`;
+}
 
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 var program = new Command();
-program.name("mltl").description("moltlaunch \u2014 the onchain toolkit for agents").version(version).option("--no-heartbeat", "Skip emitting on-chain transparency beat");
+program.name("mltl").description("moltlaunch \u2014 the onchain agent network").version(version);
 program.command("launch", { isDefault: true }).description("Launch a new token on Base").requiredOption("--name <name>", "Token name").requiredOption("--symbol <symbol>", "Token symbol").requiredOption("--description <desc>", "Token description").option("--image <path>", "Path to token image (max 5MB, uses default logo if omitted)").option("--website <url>", "Website URL (overrides auto-created Moltbook post)").option("--testnet", "Use Base Sepolia testnet", false).option("--json", "Output as JSON (for agents)", false).option("-q, --quiet", "Skip announcing to social platforms", false).action(
   (opts) => launch({
     name: opts.name,
@@ -1291,8 +1669,8 @@ program.command("launch", { isDefault: true }).description("Launch a new token o
     quiet: opts.quiet
   })
 );
-program.command("wallet").description("Show wallet address and balance").option("--show-key", "Show private key", false).option("--json", "Output as JSON", false).action(
-  (opts) => wallet({ showKey: opts.showKey, json: opts.json })
+program.command("wallet").description("Show wallet address and balance").option("--json", "Output as JSON", false).action(
+  (opts) => wallet({ json: opts.json })
 );
 program.command("status").description("List all tokens under the revenue manager").option("--testnet", "Use Base Sepolia testnet", false).option("--json", "Output as JSON", false).action(
   (opts) => status({ testnet: opts.testnet, json: opts.json })
@@ -1300,15 +1678,13 @@ program.command("status").description("List all tokens under the revenue manager
 program.command("fees").description("Check claimable fee balance (read-only, no gas needed)").option("--testnet", "Use Base Sepolia testnet", false).option("--json", "Output as JSON", false).action(
   (opts) => fees({ testnet: opts.testnet, json: opts.json })
 );
-program.command("claim").description("Withdraw accumulated fees from PositionManager escrow").option("--reason <text>", "Reason for claiming (included in heartbeat)").option("--testnet", "Use Base Sepolia testnet", false).option("--json", "Output as JSON", false).action(
+program.command("claim").description("Withdraw accumulated fees from PositionManager escrow").option("--testnet", "Use Base Sepolia testnet", false).option("--json", "Output as JSON", false).action(
   (opts) => claim({
     testnet: opts.testnet,
-    json: opts.json,
-    reason: opts.reason,
-    noHeartbeat: !program.opts().heartbeat
+    json: opts.json
   })
 );
-program.command("swap").description("Swap ETH for tokens or tokens for ETH on Uniswap V4").requiredOption("--token <address>", "Token address").requiredOption("--amount <amount>", "Amount (ETH for buy, tokens for sell)").requiredOption("--side <direction>", "buy or sell").option("--slippage <percent>", "Slippage tolerance percent", "5").option("--testnet", "Use Base Sepolia testnet", false).option("--reason <text>", "Reason for the trade (included in heartbeat)").option("--json", "Output as JSON", false).action(
+program.command("swap").description("Swap ETH for tokens or tokens for ETH on Uniswap V4").requiredOption("--token <address>", "Token address").requiredOption("--amount <amount>", "Amount (ETH for buy, tokens for sell)").requiredOption("--side <direction>", "buy or sell").option("--slippage <percent>", "Slippage tolerance percent", "5").option("--testnet", "Use Base Sepolia testnet", false).option("--memo <text>", "Onchain memo \u2014 agent reasoning, strategy notes, or context (appended to tx calldata)").option("--json", "Output as JSON", false).action(
   (opts) => swap({
     token: opts.token,
     amount: opts.amount,
@@ -1316,12 +1692,25 @@ program.command("swap").description("Swap ETH for tokens or tokens for ETH on Un
     slippage: parseFloat(opts.slippage),
     testnet: opts.testnet,
     json: opts.json,
-    reason: opts.reason,
-    noHeartbeat: !program.opts().heartbeat
+    memo: opts.memo
   })
 );
-program.command("network").description("Discover all moltlaunch agents and their tokens").option("--json", "Output as JSON (for agents)", false).action(
-  (opts) => network({ json: opts.json })
+program.command("network").description("Discover all moltlaunch agents and their tokens").option("--json", "Output as JSON (for agents)", false).option("--sort <field>", "Sort by: power, mcap, volume, holders, newest", "power").option("--limit <n>", "Number of agents to show (0 = all)", "0").action(
+  (opts) => network({ json: opts.json, sort: opts.sort, limit: parseInt(opts.limit, 10) })
+);
+program.command("holdings").description("Show tokens you hold in the network").option("--json", "Output as JSON", false).option("--testnet", "Use Base Sepolia testnet", false).action(
+  (opts) => holdings({ json: opts.json, testnet: opts.testnet })
+);
+program.command("fund").description("Show wallet address, balance, and funding instructions").option("--json", "Output as JSON", false).action(
+  (opts) => fund({ json: opts.json })
+);
+program.command("price").description("Fetch token details and price info from Flaunch").requiredOption("--token <address>", "Token contract address").option("--amount <eth>", "ETH amount to simulate spend").option("--testnet", "Use Base Sepolia testnet", false).option("--json", "Output as JSON", false).action(
+  (opts) => price({
+    token: opts.token,
+    amount: opts.amount,
+    testnet: opts.testnet,
+    json: opts.json
+  })
 );
 program.parse();
 //# sourceMappingURL=index.js.map