moltlaunch 2.0.0 → 2.0.2

package/src/commands/approve.ts

@@ -1,127 +0,0 @@
-// mltl approve - Approve submitted work and release payment from escrow (client action)
-
-import { formatEther } from "viem";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { getTask, completeTask } from "../lib/tasks.js";
-import { releaseEscrow, getEscrowDetails, EscrowStatus } from "../lib/escrow.js";
-import { APIS } from "../lib/constants.js";
-
-interface ApproveOptions {
-  task: string;
-  json?: boolean;
-}
-
-// Fetch agent from our worker API (no subgraph needed)
-async function fetchAgent(agentId: string) {
-  const res = await fetch(`${APIS.MANDATE}/api/agents/${agentId}`);
-  if (!res.ok) return null;
-  const data = await res.json() as { agent?: { name: string; owner: string } };
-  return data.agent;
-}
-
-export async function approve(options: ApproveOptions): Promise<void> {
-  const { wallet } = await loadOrCreateWallet();
-
-  if (!options.json) {
-    console.log("\nApproving work and preparing payment...");
-    console.log("──────────────────────────────────────────────");
-  }
-
-  try {
-    // Get task details
-    const task = await getTask(options.task);
-
-    if (task.status !== "submitted") {
-      throw new Error(`Task is ${task.status}, cannot approve (must be submitted)`);
-    }
-
-    // Verify caller is the client
-    if (task.clientAddress.toLowerCase() !== wallet.address.toLowerCase()) {
-      throw new Error("Only the client who created this task can approve it");
-    }
-
-    // Use the quoted price (set by agent)
-    if (!task.quotedPriceWei) {
-      throw new Error("Task has no quoted price");
-    }
-
-    const priceWei = BigInt(task.quotedPriceWei);
-    const priceEth = formatEther(priceWei);
-
-    // Get agent's wallet address
-    const agent = await fetchAgent(task.agentId);
-    if (!agent) {
-      throw new Error(`Agent #${task.agentId} not found`);
-    }
-
-    // The agent's owner address receives payment
-    const agentOwner = agent.owner;
-    if (!agentOwner) {
-      throw new Error("Agent has no owner address");
-    }
-
-    // Verify escrow exists
-    const escrow = await getEscrowDetails(task.id);
-    if (!escrow) {
-      throw new Error("No escrow found for this task. Was it accepted properly?");
-    }
-    if (escrow.status >= EscrowStatus.Released) {
-      throw new Error("Escrow already released");
-    }
-
-    if (!options.json) {
-      console.log(`\nTask ID:      ${task.id}`);
-      console.log(`Agent:        ${agent.name || `#${task.agentId}`}`);
-      console.log(`Agent Owner:  ${agentOwner}`);
-      console.log(`Escrow:       ${formatEther(escrow.amount)} ETH (locked)`);
-      console.log(`\nSubmitted result:\n${task.result}\n`);
-      console.log("──────────────────────────────────────────────");
-      console.log("\nReleasing payment from escrow...");
-    }
-
-    // Release funds from escrow to agent
-    const txHash = await releaseEscrow(wallet, task.id);
-
-    // Mark task as completed (signed with wallet)
-    const completedTask = await completeTask(wallet, options.task, txHash);
-
-    if (options.json) {
-      console.log(
-        JSON.stringify({
-          success: true,
-          task: {
-            id: completedTask.id,
-            agentId: completedTask.agentId,
-            status: completedTask.status,
-            quotedPriceWei: completedTask.quotedPriceWei,
-            txHash: completedTask.txHash,
-          },
-          payment: {
-            to: agentOwner,
-            amount: priceEth,
-            txHash,
-            type: "escrow_release",
-          },
-        }),
-      );
-      return;
-    }
-
-    console.log("\n✅ Work approved! Payment released from escrow.");
-    console.log("──────────────────────────────────────────────");
-    console.log(`\nPayment:  ${priceEth} ETH → ${agentOwner}`);
-    console.log(`TX:       ${txHash}`);
-    console.log("\nDon't forget to leave feedback:");
-    console.log(`  mltl feedback --agent ${task.agentId} --score 90\n`);
-  } catch (err) {
-    const errorMsg = err instanceof Error ? err.message : String(err);
-
-    if (options.json) {
-      console.log(JSON.stringify({ error: errorMsg }));
-      process.exit(1);
-    }
-
-    console.error(`\n❌ Failed to approve: ${errorMsg}`);
-    process.exit(1);
-  }
-}

package/src/commands/claim.ts

@@ -1,130 +0,0 @@
-// mltl claim - Claim payment after timeout (agent protection)
-
-import { formatEther } from "viem";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { getTask, completeTask } from "../lib/tasks.js";
-import {
-  releaseAfterTimeout,
-  getEscrowDetails,
-  isEscrowTimedOut,
-  getTimeUntilTimeout,
-  EscrowStatus,
-} from "../lib/escrow.js";
-
-interface ClaimOptions {
-  task: string;
-  json?: boolean;
-}
-
-export async function claim(options: ClaimOptions): Promise<void> {
-  const { wallet } = await loadOrCreateWallet();
-
-  if (!options.json) {
-    console.log("\nChecking claim eligibility...");
-    console.log("──────────────────────────────────────────────");
-  }
-
-  try {
-    // Get task details
-    const task = await getTask(options.task);
-
-    // Get escrow details
-    const escrow = await getEscrowDetails(options.task);
-
-    if (!escrow) {
-      throw new Error("No escrow found for this task");
-    }
-
-    if (escrow.status === EscrowStatus.Released || escrow.status === EscrowStatus.Refunded) {
-      throw new Error("Payment already released or refunded");
-    }
-
-    if (escrow.status !== EscrowStatus.Submitted) {
-      throw new Error("Work not yet submitted. Run 'mltl submit' first.");
-    }
-
-    if (escrow.status === EscrowStatus.Disputed) {
-      throw new Error("Task is disputed. Cannot claim until dispute is resolved.");
-    }
-
-    const priceEth = formatEther(escrow.amount);
-
-    // Check if timeout reached
-    const timedOut = await isEscrowTimedOut(options.task);
-
-    if (!timedOut) {
-      const secondsLeft = await getTimeUntilTimeout(options.task);
-      const hoursLeft = Number(secondsLeft) / 3600;
-
-      if (options.json) {
-        console.log(
-          JSON.stringify({
-            error: "Timeout not reached",
-            timeRemaining: {
-              seconds: Number(secondsLeft),
-              hours: hoursLeft.toFixed(2),
-            },
-          }),
-        );
-        process.exit(1);
-      }
-
-      console.log(`\n⏳ Timeout not reached yet.`);
-      console.log(`\nTime remaining: ${hoursLeft.toFixed(1)} hours`);
-      console.log(`\nThe client can still approve the work.`);
-      console.log(`If they don't respond, you can claim after the timeout.\n`);
-      return;
-    }
-
-    if (!options.json) {
-      console.log(`\nTask ID:  ${task.id}`);
-      console.log(`Amount:   ${priceEth} ETH`);
-      console.log(`Status:   Timeout reached - claiming payment...`);
-    }
-
-    // Release after timeout
-    const txHash = await releaseAfterTimeout(wallet, options.task);
-
-    // Sync completion to worker KV
-    try {
-      await completeTask(wallet, options.task, txHash);
-    } catch {
-      // Non-fatal: onchain release succeeded, KV sync is best-effort
-    }
-
-    if (options.json) {
-      console.log(
-        JSON.stringify({
-          success: true,
-          task: {
-            id: task.id,
-            agentId: task.agentId,
-          },
-          payment: {
-            amount: priceEth,
-            txHash,
-            type: "timeout_release",
-          },
-        }),
-      );
-      return;
-    }
-
-    console.log("\n✅ Payment claimed!");
-    console.log("──────────────────────────────────────────────");
-    console.log(`\nAmount:   ${priceEth} ETH`);
-    console.log(`TX:       ${txHash}`);
-    console.log(`\nThe client did not respond within 24 hours.`);
-    console.log(`Funds have been released to your wallet.\n`);
-  } catch (err) {
-    const errorMsg = err instanceof Error ? err.message : String(err);
-
-    if (options.json) {
-      console.log(JSON.stringify({ error: errorMsg }));
-      process.exit(1);
-    }
-
-    console.error(`\n❌ Failed to claim: ${errorMsg}`);
-    process.exit(1);
-  }
-}

package/src/commands/decline.ts

@@ -1,55 +0,0 @@
-// mltl decline - Decline a task request (agent action)
-
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { declineTask, getTask } from "../lib/tasks.js";
-
-interface DeclineOptions {
-  task: string;
-  json?: boolean;
-}
-
-export async function decline(options: DeclineOptions): Promise<void> {
-  const { wallet } = await loadOrCreateWallet();
-
-  if (!options.json) {
-    console.log("\nDeclining task...");
-  }
-
-  try {
-    // First verify task exists
-    const taskBefore = await getTask(options.task);
-
-    if (!["requested", "quoted"].includes(taskBefore.status)) {
-      throw new Error(`Task is ${taskBefore.status}, cannot decline`);
-    }
-
-    // Decline the task (signed with wallet)
-    const task = await declineTask(wallet, options.task);
-
-    if (options.json) {
-      console.log(
-        JSON.stringify({
-          success: true,
-          task: {
-            id: task.id,
-            status: task.status,
-          },
-        }),
-      );
-      return;
-    }
-
-    console.log(`\n✅ Task ${task.id} declined.`);
-    console.log("\nThe client will be notified.\n");
-  } catch (err) {
-    const errorMsg = err instanceof Error ? err.message : String(err);
-
-    if (options.json) {
-      console.log(JSON.stringify({ error: errorMsg }));
-      process.exit(1);
-    }
-
-    console.error(`\n❌ Failed to decline task: ${errorMsg}`);
-    process.exit(1);
-  }
-}

package/src/commands/dispute.ts

@@ -1,92 +0,0 @@
-// mltl dispute - Dispute submitted work and freeze timeout (client action)
-
-import { formatEther } from "viem";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { getTask } from "../lib/tasks.js";
-import { getEscrowDetails, getDisputeFee, disputeEscrow, EscrowStatus } from "../lib/escrow.js";
-import { signAction } from "../lib/auth.js";
-import { APIS } from "../lib/constants.js";
-
-interface DisputeOptions {
-  task: string;
-  json?: boolean;
-}
-
-export async function dispute(options: DisputeOptions): Promise<void> {
-  const { wallet } = await loadOrCreateWallet();
-
-  if (!options.json) {
-    console.log("\nDisputing submitted work...");
-    console.log("──────────────────────────────────────────────");
-  }
-
-  try {
-    const task = await getTask(options.task);
-
-    if (task.status !== "submitted") {
-      throw new Error(`Task is ${task.status}, cannot dispute (must be submitted)`);
-    }
-
-    if (task.clientAddress.toLowerCase() !== wallet.address.toLowerCase()) {
-      throw new Error("Only the client who created this task can dispute it");
-    }
-
-    const escrow = await getEscrowDetails(task.id);
-    if (!escrow) {
-      throw new Error("No escrow found for this task");
-    }
-    if (escrow.status !== EscrowStatus.Submitted) {
-      throw new Error("Escrow is not in submitted state");
-    }
-
-    const feeWei = await getDisputeFee(task.id);
-    const feeEth = formatEther(feeWei);
-
-    if (!options.json) {
-      console.log(`\nTask ID:       ${task.id}`);
-      console.log(`Escrow:        ${formatEther(escrow.amount)} ETH`);
-      console.log(`Dispute fee:   ${feeEth} ETH (10% of escrow)`);
-      console.log("\nOpening dispute...");
-    }
-
-    const txHash = await disputeEscrow(wallet, task.id, feeWei);
-
-    // Sign and notify worker
-    const { signature, timestamp, nonce } = await signAction(wallet, "dispute", task.id);
-
-    await fetch(`${APIS.MANDATE}/api/tasks/${task.id}/dispute`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ txHash, signature, timestamp, nonce }),
-    });
-
-    if (options.json) {
-      console.log(
-        JSON.stringify({
-          success: true,
-          taskId: task.id,
-          disputeFee: feeEth,
-          txHash,
-        })
-      );
-      return;
-    }
-
-    console.log("\nDispute opened! Timeout is now frozen.");
-    console.log("──────────────────────────────────────────────");
-    console.log(`\nFee paid: ${feeEth} ETH`);
-    console.log(`TX:       ${txHash}`);
-    console.log("\nAn admin will review and resolve the dispute.");
-    console.log("If you win, you get your escrow + fee back.\n");
-  } catch (err) {
-    const errorMsg = err instanceof Error ? err.message : String(err);
-
-    if (options.json) {
-      console.log(JSON.stringify({ error: errorMsg }));
-      process.exit(1);
-    }
-
-    console.error(`\n❌ Failed to dispute: ${errorMsg}`);
-    process.exit(1);
-  }
-}

package/src/commands/earnings.ts

@@ -1,86 +0,0 @@
-// mltl earnings - View your earnings from being hired
-
-import { formatEther } from "viem";
-import { loadOrCreateWallet, getWalletBalance } from "../lib/wallet.js";
-import { getAgentByOwner, getReputationSummary } from "../lib/mandate.js";
-import { CHAIN } from "../lib/constants.js";
-
-interface EarningsOptions {
-  json?: boolean;
-}
-
-export async function earnings(options: EarningsOptions): Promise<void> {
-  const { wallet } = await loadOrCreateWallet();
-
-  if (!options.json) {
-    console.log("\nMANDATE Earnings");
-    console.log("══════════════════════════════════════════════════════════════════\n");
-  }
-
-  try {
-    const balance = await getWalletBalance(wallet.address);
-    const agentId = await getAgentByOwner(wallet.address);
-
-    if (options.json) {
-      const result: Record<string, unknown> = {
-        wallet: wallet.address,
-        balance,
-        agent: null as Record<string, unknown> | null,
-      };
-
-      if (agentId && agentId > 0n) {
-        const rep = await getReputationSummary(agentId);
-        result.agent = {
-          agentId: agentId.toString(),
-          reputation: {
-            count: Number(rep.count),
-            summaryValue: Number(rep.summaryValue),
-          },
-        };
-      }
-
-      console.log(JSON.stringify(result));
-      return;
-    }
-
-    console.log(`Wallet:  ${wallet.address}`);
-    console.log(`Balance: ${balance} ETH`);
-    console.log("");
-
-    if (!agentId || agentId <= 0n) {
-      console.log("No registered agent found for this wallet.");
-      console.log("Register one with: mltl register --name <name> --description <desc> --skills <skills> --image <path>");
-      return;
-    }
-
-    console.log(`Agent ID: ${agentId.toString()}`);
-    console.log(`Explorer: ${CHAIN.explorer}/token/${agentId.toString()}`);
-    console.log("");
-    console.log("──────────────────────────────────────────────");
-    console.log("Reputation (ERC-8004):");
-    console.log("──────────────────────────────────────────────");
-
-    const rep = await getReputationSummary(agentId);
-    const feedbackCount = Number(rep.count);
-    const avgScore = feedbackCount > 0 ? Number(rep.summaryValue) / feedbackCount : 0;
-
-    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 Flaunch token.");
-    console.log("Each completed task burns tokens, increasing token value for holders.");
-
-  } catch (err) {
-    if (options.json) {
-      console.log(
-        JSON.stringify({
-          error: err instanceof Error ? err.message : String(err),
-        })
-      );
-      process.exit(1);
-    }
-
-    console.error(`\n❌ Failed to fetch earnings: ${err instanceof Error ? err.message : err}`);
-    process.exit(1);
-  }
-}

package/src/commands/feedback.ts

@@ -1,147 +0,0 @@
-// mltl feedback - Submit verified feedback for an agent after completing a task
-// Uses ERC-8004 Reputation Registry with full field utilization:
-// - feedbackHash: keccak256(taskId) — links to escrow record
-// - feedbackURI: "moltlaunch:task:<taskId>" — human-readable reference
-// - tag1: "mandate" — platform identifier
-// - tag2: agent contract address (CA)
-
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { giveFeedback, getAgent } from "../lib/mandate.js";
-import { getTask, rateTask } from "../lib/tasks.js";
-
-interface FeedbackOptions {
-  agent?: string;
-  task?: string;
-  score: string;
-  comment?: string;
-  json?: boolean;
-}
-
-export async function feedback(options: FeedbackOptions): Promise<void> {
-  const { wallet } = await loadOrCreateWallet();
-
-  const score = parseInt(options.score, 10);
-
-  if (score < 0 || score > 100) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "Score must be between 0 and 100" }));
-      process.exit(1);
-    }
-    console.error("Score must be between 0 and 100");
-    process.exit(1);
-  }
-
-  if (!options.agent && !options.task) {
-    if (options.json) {
-      console.log(JSON.stringify({ error: "Provide --agent or --task" }));
-      process.exit(1);
-    }
-    console.error("Provide --agent <id> or --task <taskId>");
-    process.exit(1);
-  }
-
-  let agentIdStr = options.agent || "";
-  let taskId = options.task;
-
-  // If --task provided, resolve agent from task and verify caller is the client
-  if (taskId) {
-    try {
-      const task = await getTask(taskId);
-
-      if (task.status !== "completed") {
-        const msg = `Task ${taskId} is not completed (status: ${task.status})`;
-        if (options.json) {
-          console.log(JSON.stringify({ error: msg }));
-          process.exit(1);
-        }
-        console.error(msg);
-        process.exit(1);
-      }
-
-      if (task.clientAddress.toLowerCase() !== wallet.address.toLowerCase()) {
-        const msg = "Only the task client can leave feedback";
-        if (options.json) {
-          console.log(JSON.stringify({ error: msg }));
-          process.exit(1);
-        }
-        console.error(msg);
-        process.exit(1);
-      }
-
-      agentIdStr = task.agentId;
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      if (options.json) {
-        console.log(JSON.stringify({ error: msg }));
-        process.exit(1);
-      }
-      console.error(`Failed to fetch task: ${msg}`);
-      process.exit(1);
-    }
-  }
-
-  const agentId = BigInt(agentIdStr.startsWith("0x") ? agentIdStr : agentIdStr);
-
-  if (!options.json) {
-    console.log("\nSubmitting verified feedback...");
-    console.log("──────────────────────────────────────────────");
-    console.log(`Agent:   #${agentIdStr}`);
-    console.log(`Score:   ${score}/100`);
-    if (taskId) console.log(`Task:    ${taskId}`);
-    console.log(`Tag1:    mandate`);
-    console.log("──────────────────────────────────────────────\n");
-  }
-
-  try {
-    // Resolve agent's contract address for tag2
-    const agent = await getAgent(agentId);
-    const agentCA = agent?.owner || "";
-
-    const txHash = await giveFeedback(wallet, agentId, score, {
-      taskId,
-      agentContractAddress: agentCA,
-    });
-
-    // Sync rating to worker KV for verified reputation tracking
-    if (taskId) {
-      try {
-        await rateTask(wallet, taskId, txHash, score, options.comment);
-      } catch {
-        // Non-fatal: onchain feedback succeeded, KV sync is best-effort
-      }
-    }
-
-    if (options.json) {
-      console.log(
-        JSON.stringify({
-          success: true,
-          agentId: agentIdStr,
-          score,
-          taskId: taskId || null,
-          feedbackHash: taskId ? `keccak256(${taskId})` : null,
-          txHash,
-        })
-      );
-      return;
-    }
-
-    console.log("Feedback submitted!\n");
-    console.log(`Transaction: ${txHash}`);
-    console.log(`View on Basescan: https://basescan.org/tx/${txHash}`);
-    if (taskId) {
-      console.log(`Linked to task: ${taskId}`);
-    }
-  } catch (err) {
-    if (options.json) {
-      console.log(
-        JSON.stringify({
-          error: err instanceof Error ? err.message : String(err),
-        })
-      );
-      process.exit(1);
-    }
-
-    console.error(`\nFeedback failed: ${err instanceof Error ? err.message : err}`);
-    process.exit(1);
-  }
-}