@openagentmarket/create-agent 1.5.1 → 1.5.2

package/README.md

@@ -31,7 +31,8 @@ Interactive prompts for:
 - Agent name and description
 - Skills (comma-separated)
 - Optional **on-chain registration** (ERC-8004)
-- Optional **x402 payments** (USDC on Base)
+- Optional **x402 payments** — charge for your services (USDC on Base)
+- Optional **send payments** — send USDC or ETH on Base (`send_usdc`, `send_eth` skills)
 
 ## Getting Started
 
@@ -44,3 +45,53 @@ npm start
 ```
 
 Configure `.env` with your `MNEMONIC` (auto-generated for hirers).
+
+## Adding Send Payments to Existing Projects
+
+If you scaffolded your agent before the send payment feature was available, you can add it manually. No new npm packages required — `ethers` (already in your `package.json`) has everything needed.
+
+**1. Add to `.env`:**
+
+```
+BASE_RPC_URL="https://mainnet.base.org"
+```
+
+**2. Add imports to `index.ts`:**
+
+```typescript
+import { Contract, parseUnits, parseEther, JsonRpcProvider } from 'ethers';
+```
+
+**3. Add task handlers after your existing `agent.onTask(...)` blocks:**
+
+```typescript
+// ── Send USDC on Base ──
+const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+const USDC_ABI = [
+  "function transfer(address to, uint256 amount) returns (bool)",
+  "function balanceOf(address owner) view returns (uint256)"
+];
+
+agent.onTask("send_usdc", async (input) => {
+  const provider = new JsonRpcProvider(process.env.BASE_RPC_URL || "https://mainnet.base.org");
+  const wallet = agent.getWallet().connect(provider);
+  const usdc = new Contract(USDC_ADDRESS, USDC_ABI, wallet);
+  const amount = parseUnits(input.amount, 6);
+  const tx = await usdc.transfer(input.to, amount);
+  const receipt = await tx.wait();
+  return { success: true, txHash: receipt.hash, chain: "base", currency: "USDC", amount: input.amount, to: input.to };
+});
+
+// ── Send ETH on Base ──
+agent.onTask("send_eth", async (input) => {
+  const provider = new JsonRpcProvider(process.env.BASE_RPC_URL || "https://mainnet.base.org");
+  const wallet = agent.getWallet().connect(provider);
+  const tx = await wallet.sendTransaction({ to: input.to, value: parseEther(input.amount) });
+  const receipt = await tx.wait();
+  return { success: true, txHash: receipt.hash, chain: "base", currency: "ETH", amount: input.amount, to: input.to };
+});
+```
+
+**4. Add `"send_usdc"` and `"send_eth"` to your agent's `skills` array in the `card` config.**
+
+**5. Fund your agent's wallet** with USDC or ETH on Base before sending.

package/dist/index.js

@@ -203,20 +203,28 @@ async function scaffoldHirer() {
         `      const desc = reg.description || "";`,
         `      const agentId = item.agentId || "";`,
         ``,
-        `      // Extract XMTP chat address from Agent Endpoints`,
+        `      // Extract XMTP chat address from a2aEndpoint or endpointsRawJson`,
         `      let chatAddr = "";`,
         `      try {`,
-        `        const services = JSON.parse(reg.endpointsRawJson || "[]");`,
-        `        for (const svc of services) {`,
-        `          if (svc.endpoint && svc.endpoint.includes("openagent.market/chat")) {`,
-        `            const url = new URL(svc.endpoint);`,
-        `            chatAddr = url.searchParams.get("agent") || "";`,
-        `            break;`,
+        `        // Primary: use a2aEndpoint (always present)`,
+        `        if (reg.a2aEndpoint && reg.a2aEndpoint.includes("openagent.market/chat")) {`,
+        `          const url = new URL(reg.a2aEndpoint);`,
+        `          chatAddr = url.searchParams.get("agent") || "";`,
+        `        }`,
+        `        // Fallback: try endpointsRawJson`,
+        `        if (!chatAddr) {`,
+        `          const services = JSON.parse(reg.endpointsRawJson || "[]");`,
+        `          for (const svc of services) {`,
+        `            if (svc.endpoint && svc.endpoint.includes("openagent.market/chat")) {`,
+        `              const url = new URL(svc.endpoint);`,
+        `              chatAddr = url.searchParams.get("agent") || "";`,
+        `              break;`,
+        `            }`,
         `          }`,
         `        }`,
         `      } catch {}`,
         ``,
-        `      // Fallback to owner if no endpoint found`,
+        `      // Last resort: owner address`,
         `      if (!chatAddr) chatAddr = item.owner || "?";`,
         ``,
         `      console.log("  🤖 " + name + (agentId ? " (#" + agentId + ")" : ""));`,
@@ -320,11 +328,17 @@ async function scaffoldWorker() {
         {
             type: 'confirm',
             name: 'includePayments',
-            message: 'Include x402 payments?',
+            message: 'Include x402 payments (charge for your services)?',
+            initial: false
+        },
+        {
+            type: 'confirm',
+            name: 'includeSendPayments',
+            message: 'Include send payments (USDC/ETH on Base)?',
             initial: false
         }
     ]);
-    const { agentName, description, skills, includeRegistration, includePayments } = response;
+    const { agentName, description, skills, includeRegistration, includePayments, includeSendPayments } = response;
     if (!agentName) {
         console.log(kleur.red('Cancelled.'));
         process.exit(1);
@@ -368,14 +382,30 @@ async function scaffoldWorker() {
         envContent += 'REGISTRATION_PRIVATE_KEY=""\n';
         envContent += 'PINATA_JWT=""\n';
     }
+    if (includeSendPayments) {
+        envContent += 'BASE_RPC_URL="https://mainnet.base.org"\n';
+    }
     fs.writeFileSync(path.join(targetDir, '.env'), envContent);
     // 4. .gitignore
     fs.writeFileSync(path.join(targetDir, '.gitignore'), 'node_modules\n.env\ndist\n');
     // 5. index.ts
-    const taskHandlers = skillList.map((skill) => `
+    // Add send payment skills if enabled
+    if (includeSendPayments) {
+        if (!skillList.includes('send_usdc'))
+            skillList.push('send_usdc');
+        if (!skillList.includes('send_eth'))
+            skillList.push('send_eth');
+    }
+    const taskHandlers = skillList.map((skill) => {
+        if (skill === 'send_usdc')
+            return SEND_USDC_HANDLER;
+        if (skill === 'send_eth')
+            return SEND_ETH_HANDLER;
+        return `
 agent.onTask("${skill}", async (input) => {
   return { message: \`Handled ${skill} with \${JSON.stringify(input)}\` };
-});`).join('\n');
+});`;
+    }).join('\n');
     const paymentConfig = includePayments ? `
     payment: {
       amount: 5,
@@ -408,8 +438,11 @@ async function registerAgent(agent: any) {
     const registrationCall = includeRegistration
         ? '\n  // Uncomment to register on-chain:\n  // await registerAgent(agent);\n'
         : '';
+    const sendPaymentImports = includeSendPayments
+        ? `import { Contract, parseUnits, parseEther, JsonRpcProvider } from 'ethers';\n`
+        : '';
     const indexTs = `import { OpenAgent } from '@openagentmarket/nodejs';
-import 'dotenv/config';
+${sendPaymentImports}import 'dotenv/config';
 
 async function main() {
   const mnemonic = process.env.MNEMONIC;
@@ -469,6 +502,7 @@ main().catch(console.error);
         `| **Name** | ${agentName} |`,
         `| **Skills** | ${skillList.join(', ')} |`,
         `| **Payments** | ${includePayments ? 'Enabled (x402)' : 'Disabled'} |`,
+        `| **Send Payments** | ${includeSendPayments ? 'Enabled (USDC/ETH on Base)' : 'Disabled'} |`,
         `| **Registration** | ${includeRegistration ? 'Included' : 'Not included'} |`,
         ``,
         `## Environment Variables`,
@@ -476,6 +510,7 @@ main().catch(console.error);
         `| Variable | Required | Description |`,
         `|----------|----------|-------------|`,
         '| `MNEMONIC` | Yes | Agent wallet seed phrase |',
+        includeSendPayments ? '| `BASE_RPC_URL` | For send payments | Base RPC endpoint (default: https://mainnet.base.org) |' : '',
         includeRegistration ? '| `REGISTRATION_PRIVATE_KEY` | For registration | Wallet paying gas |\n| `PINATA_JWT` | For registration | IPFS metadata upload |' : '',
         ``,
         `## Resources`,
@@ -493,6 +528,55 @@ main().catch(console.error);
     console.log('  # Set your MNEMONIC in .env');
     console.log('  npm start\n');
 }
+// ── Send Payment Templates ───────────────────────────────────────────────────
+const SEND_USDC_HANDLER = `
+// ── Send USDC on Base ──
+const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+const USDC_ABI = [
+  "function transfer(address to, uint256 amount) returns (bool)",
+  "function balanceOf(address owner) view returns (uint256)"
+];
+
+agent.onTask("send_usdc", async (input) => {
+  const provider = new JsonRpcProvider(process.env.BASE_RPC_URL || "https://mainnet.base.org");
+  const wallet = agent.getWallet().connect(provider);
+  const usdc = new Contract(USDC_ADDRESS, USDC_ABI, wallet);
+
+  // USDC has 6 decimals
+  const amount = parseUnits(input.amount, 6);
+  const tx = await usdc.transfer(input.to, amount);
+  const receipt = await tx.wait();
+
+  return {
+    success: true,
+    txHash: receipt.hash,
+    chain: "base",
+    currency: "USDC",
+    amount: input.amount,
+    to: input.to
+  };
+});`;
+const SEND_ETH_HANDLER = `
+// ── Send ETH on Base ──
+agent.onTask("send_eth", async (input) => {
+  const provider = new JsonRpcProvider(process.env.BASE_RPC_URL || "https://mainnet.base.org");
+  const wallet = agent.getWallet().connect(provider);
+
+  const tx = await wallet.sendTransaction({
+    to: input.to,
+    value: parseEther(input.amount)
+  });
+  const receipt = await tx.wait();
+
+  return {
+    success: true,
+    txHash: receipt.hash,
+    chain: "base",
+    currency: "ETH",
+    amount: input.amount,
+    to: input.to
+  };
+});`;
 // ── Shared helpers ───────────────────────────────────────────────────────────
 function writeSharedTsConfig(targetDir) {
     const tsConfig = {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openagentmarket/create-agent",
-    "version": "1.5.1",
+    "version": "1.5.2",
     "description": "CLI to scaffold a new OpenAgent project (hirer or worker)",
     "type": "module",
     "bin": {
@@ -23,4 +23,4 @@
         "@types/prompts": "^2.4.9",
         "typescript": "^5.3.3"
     }
-}
+}

package/src/index.ts

@@ -218,20 +218,28 @@ async function scaffoldHirer() {
         `      const desc = reg.description || "";`,
         `      const agentId = item.agentId || "";`,
         ``,
-        `      // Extract XMTP chat address from Agent Endpoints`,
+        `      // Extract XMTP chat address from a2aEndpoint or endpointsRawJson`,
         `      let chatAddr = "";`,
         `      try {`,
-        `        const services = JSON.parse(reg.endpointsRawJson || "[]");`,
-        `        for (const svc of services) {`,
-        `          if (svc.endpoint && svc.endpoint.includes("openagent.market/chat")) {`,
-        `            const url = new URL(svc.endpoint);`,
-        `            chatAddr = url.searchParams.get("agent") || "";`,
-        `            break;`,
+        `        // Primary: use a2aEndpoint (always present)`,
+        `        if (reg.a2aEndpoint && reg.a2aEndpoint.includes("openagent.market/chat")) {`,
+        `          const url = new URL(reg.a2aEndpoint);`,
+        `          chatAddr = url.searchParams.get("agent") || "";`,
+        `        }`,
+        `        // Fallback: try endpointsRawJson`,
+        `        if (!chatAddr) {`,
+        `          const services = JSON.parse(reg.endpointsRawJson || "[]");`,
+        `          for (const svc of services) {`,
+        `            if (svc.endpoint && svc.endpoint.includes("openagent.market/chat")) {`,
+        `              const url = new URL(svc.endpoint);`,
+        `              chatAddr = url.searchParams.get("agent") || "";`,
+        `              break;`,
+        `            }`,
         `          }`,
         `        }`,
         `      } catch {}`,
         ``,
-        `      // Fallback to owner if no endpoint found`,
+        `      // Last resort: owner address`,
         `      if (!chatAddr) chatAddr = item.owner || "?";`,
         ``,
         `      console.log("  🤖 " + name + (agentId ? " (#" + agentId + ")" : ""));`,
@@ -339,12 +347,18 @@ async function scaffoldWorker() {
         {
             type: 'confirm',
             name: 'includePayments',
-            message: 'Include x402 payments?',
+            message: 'Include x402 payments (charge for your services)?',
+            initial: false
+        },
+        {
+            type: 'confirm',
+            name: 'includeSendPayments',
+            message: 'Include send payments (USDC/ETH on Base)?',
             initial: false
         }
     ]);
 
-    const { agentName, description, skills, includeRegistration, includePayments } = response;
+    const { agentName, description, skills, includeRegistration, includePayments, includeSendPayments } = response;
     if (!agentName) {
         console.log(kleur.red('Cancelled.'));
         process.exit(1);
@@ -394,16 +408,29 @@ async function scaffoldWorker() {
         envContent += 'REGISTRATION_PRIVATE_KEY=""\n';
         envContent += 'PINATA_JWT=""\n';
     }
+    if (includeSendPayments) {
+        envContent += 'BASE_RPC_URL="https://mainnet.base.org"\n';
+    }
     fs.writeFileSync(path.join(targetDir, '.env'), envContent);
 
     // 4. .gitignore
     fs.writeFileSync(path.join(targetDir, '.gitignore'), 'node_modules\n.env\ndist\n');
 
     // 5. index.ts
-    const taskHandlers = skillList.map((skill: string) => `
+    // Add send payment skills if enabled
+    if (includeSendPayments) {
+        if (!skillList.includes('send_usdc')) skillList.push('send_usdc');
+        if (!skillList.includes('send_eth')) skillList.push('send_eth');
+    }
+
+    const taskHandlers = skillList.map((skill: string) => {
+        if (skill === 'send_usdc') return SEND_USDC_HANDLER;
+        if (skill === 'send_eth') return SEND_ETH_HANDLER;
+        return `
 agent.onTask("${skill}", async (input) => {
   return { message: \`Handled ${skill} with \${JSON.stringify(input)}\` };
-});`).join('\n');
+});`;
+    }).join('\n');
 
     const paymentConfig = includePayments ? `
     payment: {
@@ -440,8 +467,12 @@ async function registerAgent(agent: any) {
         ? '\n  // Uncomment to register on-chain:\n  // await registerAgent(agent);\n'
         : '';
 
+    const sendPaymentImports = includeSendPayments
+        ? `import { Contract, parseUnits, parseEther, JsonRpcProvider } from 'ethers';\n`
+        : '';
+
     const indexTs = `import { OpenAgent } from '@openagentmarket/nodejs';
-import 'dotenv/config';
+${sendPaymentImports}import 'dotenv/config';
 
 async function main() {
   const mnemonic = process.env.MNEMONIC;
@@ -502,6 +533,7 @@ main().catch(console.error);
         `| **Name** | ${agentName} |`,
         `| **Skills** | ${skillList.join(', ')} |`,
         `| **Payments** | ${includePayments ? 'Enabled (x402)' : 'Disabled'} |`,
+        `| **Send Payments** | ${includeSendPayments ? 'Enabled (USDC/ETH on Base)' : 'Disabled'} |`,
         `| **Registration** | ${includeRegistration ? 'Included' : 'Not included'} |`,
         ``,
         `## Environment Variables`,
@@ -509,6 +541,7 @@ main().catch(console.error);
         `| Variable | Required | Description |`,
         `|----------|----------|-------------|`,
         '| `MNEMONIC` | Yes | Agent wallet seed phrase |',
+        includeSendPayments ? '| `BASE_RPC_URL` | For send payments | Base RPC endpoint (default: https://mainnet.base.org) |' : '',
         includeRegistration ? '| `REGISTRATION_PRIVATE_KEY` | For registration | Wallet paying gas |\n| `PINATA_JWT` | For registration | IPFS metadata upload |' : '',
         ``,
         `## Resources`,
@@ -528,6 +561,58 @@ main().catch(console.error);
     console.log('  npm start\n');
 }
 
+// ── Send Payment Templates ───────────────────────────────────────────────────
+
+const SEND_USDC_HANDLER = `
+// ── Send USDC on Base ──
+const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+const USDC_ABI = [
+  "function transfer(address to, uint256 amount) returns (bool)",
+  "function balanceOf(address owner) view returns (uint256)"
+];
+
+agent.onTask("send_usdc", async (input) => {
+  const provider = new JsonRpcProvider(process.env.BASE_RPC_URL || "https://mainnet.base.org");
+  const wallet = agent.getWallet().connect(provider);
+  const usdc = new Contract(USDC_ADDRESS, USDC_ABI, wallet);
+
+  // USDC has 6 decimals
+  const amount = parseUnits(input.amount, 6);
+  const tx = await usdc.transfer(input.to, amount);
+  const receipt = await tx.wait();
+
+  return {
+    success: true,
+    txHash: receipt.hash,
+    chain: "base",
+    currency: "USDC",
+    amount: input.amount,
+    to: input.to
+  };
+});`;
+
+const SEND_ETH_HANDLER = `
+// ── Send ETH on Base ──
+agent.onTask("send_eth", async (input) => {
+  const provider = new JsonRpcProvider(process.env.BASE_RPC_URL || "https://mainnet.base.org");
+  const wallet = agent.getWallet().connect(provider);
+
+  const tx = await wallet.sendTransaction({
+    to: input.to,
+    value: parseEther(input.amount)
+  });
+  const receipt = await tx.wait();
+
+  return {
+    success: true,
+    txHash: receipt.hash,
+    chain: "base",
+    currency: "ETH",
+    amount: input.amount,
+    to: input.to
+  };
+});`;
+
 // ── Shared helpers ───────────────────────────────────────────────────────────
 
 function writeSharedTsConfig(targetDir: string) {