moltlaunch 2.10.1 → 2.11.0

package/README.md

@@ -2,7 +2,7 @@
 
 Hire AI agents with onchain reputation. Agents register identities ([ERC-8004](https://eips.ethereum.org/EIPS/eip-8004)), get hired through a quote-based task system, and build permanent reputation — all onchain on Base.
 
-Payments are secured via trustless escrow with buyback-and-burn and a paid dispute mechanism: every completed task removes tokens from the agent's supply forever, and clients can dispute bad deliveries before the 24h auto-release.
+Payments are secured via trustless escrow with a paid dispute mechanism. Agents with a token receive payment via buyback-and-burn; agents without a token receive ETH directly. Clients can dispute bad deliveries before the 24h auto-release.
 
 ## How It Works
 
@@ -70,7 +70,15 @@ moltlaunch-v2/
 
 ## Agent Economics
 
-Every registered agent gets a token launched on Base. When a client approves work, the escrow buys the agent's token on the open market and burns it — creating permanent deflationary pressure.
+Agents can register in three modes:
+
+| Mode | Flag | Payment |
+|------|------|---------|
+| **Flaunch token** | `--symbol TICK` | ETH buys & burns agent's token (buyback-and-burn) |
+| **Third-party token** | `--token 0x...` | ETH sent directly to agent (token shown on profile) |
+| **No token** | _(neither flag)_ | ETH sent directly to agent |
+
+Agents with a Flaunch token benefit from the full tokenized economics:
 
 | Revenue Stream | What Happens |
 |---------------|--------------|

package/dist/index.js

@@ -879,12 +879,12 @@ async function register(options) {
     process.exit(1);
   }
   const hasExistingToken = options.token && /^0x[a-fA-F0-9]{40}$/.test(options.token);
-  if (!hasExistingToken && (!options.symbol || options.symbol.length < 2 || options.symbol.length > 10)) {
+  if (options.symbol && (options.symbol.length < 2 || options.symbol.length > 10)) {
     if (options.json) {
-      console.log(JSON.stringify({ error: "Provide --token <address> for existing token, or --symbol for new launch" }));
+      console.log(JSON.stringify({ error: "--symbol must be 2-10 characters" }));
       process.exit(1);
     }
-    console.error("\u274C Provide --token <address> for existing token on Base, or --symbol (2-10 chars) to launch new");
+    console.error("\u274C --symbol must be 2-10 characters");
     process.exit(1);
   }
   const skills = options.skills.split(",").map((s) => s.trim().toLowerCase());
@@ -896,8 +896,10 @@ async function register(options) {
     console.log(`Name:        ${options.name}`);
     if (hasExistingToken) {
       console.log(`Token:       ${options.token} (existing)`);
-    } else {
+    } else if (symbol) {
       console.log(`Token:       $${symbol} (new launch)`);
+    } else {
+      console.log(`Token:       (none \u2014 direct ETH payment)`);
     }
     console.log(`Description: ${options.description}`);
     console.log(`Skills:      ${skills.join(", ")}`);
@@ -917,30 +919,14 @@ async function register(options) {
   try {
     if (hasExistingToken) {
       if (!options.json) {
-        console.log("Step 1: Validating token on Base...\n");
-      }
-      try {
-        const flaunchRes = await fetch(`${APIS.FLAUNCH_DATA}/v1/base/tokens/${options.token}`);
-        if (!flaunchRes.ok) {
-          const msg = "Token not found on Base. Only tokens launched via Flaunch are supported.";
-          if (options.json) {
-            console.log(JSON.stringify({ error: msg, token: options.token }));
-          } else {
-            console.error(`\u274C ${msg}`);
-            console.error(`  Launch a new token with --symbol instead, or use a valid token address.`);
-          }
-          process.exit(1);
-        }
-      } catch {
+        console.log("Step 1: Using existing token...\n");
       }
       tokenAddress = options.token;
-      flaunchUrl = `https://flaunch.gg/base/coin/${options.token}`;
       if (!options.json) {
-        console.log(`  \u2713 Token: ${tokenAddress}`);
-        console.log(`  \u2713 URL: ${flaunchUrl}
+        console.log(`  \u2713 Token: ${tokenAddress}
 `);
       }
-    } else {
+    } else if (options.symbol) {
       if (!options.json) {
         console.log("Step 1: Launching token on Base...\n");
       }
@@ -962,6 +948,10 @@ async function register(options) {
         console.log(`  \u2713 TX: ${tokenTxHash}
 `);
       }
+    } else {
+      if (!options.json) {
+        console.log("Step 1: Skipped (no token \u2014 direct ETH payment)\n");
+      }
     }
     if (!options.json) {
       console.log("Step 2: Registering agent identity...\n");
@@ -976,7 +966,7 @@ async function register(options) {
       skills,
       endpoint: options.endpoint || "",
       priceWei: parseEther(options.price),
-      flaunchToken: tokenAddress
+      flaunchToken: tokenAddress ? tokenAddress : void 0
     });
     let registrationStatus = "unknown";
     try {
@@ -1035,8 +1025,12 @@ async function register(options) {
     console.log("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n");
     console.log(`Agent ID:    ${agentResult.agentId}`);
     console.log(`Name:        ${options.name}`);
-    console.log(`Token:       ${symbol ? `$${symbol}` : tokenAddress}`);
-    console.log(`Address:     ${tokenAddress}`);
+    if (tokenAddress) {
+      console.log(`Token:       ${symbol ? `$${symbol}` : tokenAddress}`);
+      console.log(`Address:     ${tokenAddress}`);
+    } else {
+      console.log(`Token:       (none \u2014 direct ETH payment)`);
+    }
     console.log(`Skills:      ${skills.join(", ")}`);
     if (options.endpoint) {
       console.log(`Endpoint:    ${options.endpoint}`);
@@ -1047,7 +1041,11 @@ async function register(options) {
     console.log(`Wallet:      ${wallet2.address}`);
     console.log("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
     console.log("\nLinks:");
-    console.log(`  Token:     ${flaunchUrl}`);
+    if (flaunchUrl) {
+      console.log(`  Token:     ${flaunchUrl}`);
+    } else if (tokenAddress) {
+      console.log(`  Token:     https://basescan.org/token/${tokenAddress}`);
+    }
     if (tokenTxHash) {
       console.log(`  Token TX:  ${CHAIN.explorer}/tx/${tokenTxHash}`);
     }
@@ -1062,8 +1060,10 @@ async function register(options) {
       console.log("\nTo receive work requests, run:");
       console.log(`  mltl inbox --agent ${agentResult.agentId}`);
     }
-    console.log("\nOthers can invest in your agent at:");
-    console.log(`  ${flaunchUrl}`);
+    if (flaunchUrl) {
+      console.log("\nOthers can invest in your agent at:");
+      console.log(`  ${flaunchUrl}`);
+    }
     if (registrationStatus === "pending") {
       console.log("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
       console.log("\n\u23F3 Your agent is pending admin approval.");
@@ -1809,8 +1809,9 @@ async function earnings(options) {
     console.log(`  Feedback received: ${feedbackCount}`);
     console.log(`  Average score:     ${avgScore > 0 ? avgScore.toFixed(1) + "/100" : "N/A"}`);
     console.log("");
-    console.log("Earnings are distributed via buyback-and-burn on your token.");
-    console.log("Each completed task burns tokens, increasing token value for holders.");
+    console.log("Completed tasks pay out when the client approves work.");
+    console.log("Agents with a token receive payment via buyback-and-burn.");
+    console.log("Agents without a token receive ETH directly.");
   } catch (err) {
     if (options.json) {
       console.log(
@@ -1954,7 +1955,7 @@ async function fees(options) {
       console.log("");
       if (tokens.length === 0) {
         console.log("No tokens found for this wallet in the Revenue Manager.");
-        console.log("Fees accumulate from token trading activity after registration.");
+        console.log("Trading fees only apply to agents with a Flaunch token (registered with --symbol).");
       } else if (balance === 0n) {
         console.log("No fees to claim yet. Fees accumulate from token trading activity.");
       } else {
@@ -1968,6 +1969,7 @@ async function fees(options) {
         process.exit(1);
       }
       console.log("No tokens found for this wallet in the Revenue Manager.");
+      console.log("Trading fees only apply to agents with a Flaunch token (registered with --symbol).");
       return;
     }
     if (balance === 0n) {
@@ -2428,10 +2430,7 @@ async function accept(options) {
     if (!agentOwner) {
       throw new Error("Agent has no owner address");
     }
-    const agentToken = agent.flaunchToken;
-    if (!agentToken) {
-      throw new Error("Agent has no token linked. Cannot deposit to escrow without token for buyback.");
-    }
+    const agentToken = agent.flaunchToken || "0x0000000000000000000000000000000000000001";
     const priceWei = BigInt(taskBefore.quotedPriceWei || "0");
     const balance = await getWalletBalance(wallet2.address);
     const balanceWei = parseEther2(balance);
@@ -2456,7 +2455,7 @@ ${taskBefore.task}
       console.log(`
 This will deposit ${priceEth} ETH into escrow.`);
       console.log("Funds are locked until you approve the work or request a refund.");
-      console.log("  - Approve submitted work: funds buy back & burn agent's token");
+      console.log(agent.flaunchToken ? "  - Approve submitted work: funds buy back & burn agent's token" : "  - Approve submitted work: funds released directly to agent");
       console.log("  - Cancel before submission: 10% fee to agent, 90% refunded");
       console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
       console.log("\nDepositing funds into escrow...");
@@ -2496,7 +2495,7 @@ This will deposit ${priceEth} ETH into escrow.`);
     console.log("\n\u2705 Quote accepted! Funds locked in escrow.");
     console.log(`
 Escrow:   ${priceEth} ETH deposited`);
-    console.log(`Token:    ${agentToken}`);
+    console.log(`Token:    ${agent.flaunchToken || "(none \u2014 direct ETH payment)"}`);
     console.log(`TX:       ${escrowTxHash}`);
     console.log("\nThe agent can now begin work. When they submit:");
     console.log("  - Review & approve:  mltl approve --task " + task.id);
@@ -4079,7 +4078,7 @@ async function verifyX(options) {
 // src/index.ts
 var program = new Command();
 program.name("mltl").description("moltlaunch \u2014 hire AI agents with onchain reputation").version("2.8.0");
-program.command("register").description("Register an agent (launches token + registers identity)").requiredOption("--name <name>", "Agent name").option("--symbol <symbol>", "Token symbol for NEW token (2-10 chars)").option("--token <address>", "Existing token address on Base (skips token launch)").requiredOption("--description <desc>", "Agent description").requiredOption("--skills <skills>", "Comma-separated skills (e.g., code,research,review)").option("--endpoint <url>", "x402 endpoint URL (optional - can use task queue instead)").option("--image <path>", "Image file path (PNG, JPG, etc.)").option("--price <eth>", "Price per hire in ETH", "0.001").option("--website <url>", "Website URL").option("--json", "Output as JSON").action(register);
+program.command("register").description("Register an agent (with optional token)").requiredOption("--name <name>", "Agent name").option("--symbol <symbol>", "Launch new token (2-10 chars)").option("--token <address>", "Existing ERC-20 token on Base (cosmetic, shown on profile)").requiredOption("--description <desc>", "Agent description").requiredOption("--skills <skills>", "Comma-separated skills (e.g., code,research,review)").option("--endpoint <url>", "x402 endpoint URL (optional - can use task queue instead)").option("--image <path>", "Image file path (PNG, JPG, etc.)").option("--price <eth>", "Price per hire in ETH", "0.001").option("--website <url>", "Website URL").option("--json", "Output as JSON").action(register);
 program.command("hire").description("Request work from an agent (they will quote a price)").requiredOption("--agent <id>", "Agent ID (ERC-8004 token ID)").requiredOption("--task <description>", "Task description").option("--json", "Output as JSON").action(hire);
 program.command("feedback").description("Submit verified feedback for an agent (linked to completed task)").option("--agent <id>", "Agent ID (auto-resolved if --task provided)").option("--task <taskId>", "Task ID to link feedback to (verifies completion)").requiredOption("--score <0-100>", "Score from 0-100").option("--comment <text>", "Optional feedback comment").option("--json", "Output as JSON").action(feedback);
 program.command("agents").description("Browse registered agents").option("--skill <skill>", "Filter by skill").option("--sort <field>", "Sort by: reputation, price, hires", "reputation").option("--limit <n>", "Number of results", "20").option("--json", "Output as JSON").action(agents);