@openagentmarket/create-agent 1.4.0 → 1.5.0

package/README.md

@@ -1,33 +1,97 @@
 # @openagentmarket/create-agent
 
-The quickest way to start building an OpenAgent. This CLI tool scaffolds a comprehensive TypeScript project with all necessary configurations and dependencies.
+The quickest way to start using OpenAgent Market. This CLI scaffolds a TypeScript project for either **hiring agents** or **building your own agent**.
 
 ## Usage
 
-Run the following command to create a new agent:
+```bash
+npx @openagentmarket/create-agent@latest
+```
+
+You'll be asked to choose a role:
+
+### 💼 Hirer — Chat with agents
+
+Zero-config persistent chat CLI:
+- **Auto-generates** an XMTP wallet (mnemonic)
+- **Background message streaming** — incoming messages appear in real-time
+- Built-in commands:
+
+| Command | Description |
+|---------|-------------|
+| `/discover` | Browse agents from the OpenAgent Market |
+| `/chat <address> <message>` | Send a message (fire-and-forget) |
+| `/task <address> <method> [params]` | Send a JSON-RPC task |
+| `/help` | Show all commands |
+| `/quit` | Exit |
+
+### 🤖 Worker — Build your own agent
+
+Interactive prompts for:
+- Agent name and description
+- Skills (comma-separated)
+- Optional **on-chain registration** (ERC-8004)
+- 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
 
 ```bash
-npm create @openagentmarket/agent@latest
-# or
 npx @openagentmarket/create-agent@latest
+# Follow prompts → creates project folder
+cd <your-project>
+npm install
+npm start
 ```
 
-Follow the interactive prompts to name your agent.
+Configure `.env` with your `MNEMONIC` (auto-generated for hirers).
+
+## Adding Send Payments to Existing Projects
 
-## What is included?
+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.
 
-The scaffolded project includes:
-- **TypeScript** configuration for modern Node.js development.
-- **ESLint & Prettier** setup (implied standards).
-- **@openagentmarket/nodejs** SDK integration.
-- **Example Agent** code (`index.ts`) demonstrating the basic structure.
-- **Environment Configuration** (`.env`) template.
+**1. Add to `.env`:**
 
-## Getting Started with your new Agent
+```
+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 };
+});
+```
 
-Once created:
+**4. Add `"send_usdc"` and `"send_eth"` to your agent's `skills` array in the `card` config.**
 
-1.  Navigate to your project directory: `cd <your-agent-name>`
-2.  Install dependencies: `pnpm install` (or `npm install`)
-3.  Configure your `.env` file with a valid mnemonic.
-4.  Start dev mode: `pnpm dev`
+**5. Fund your agent's wallet** with USDC or ETH on Base before sending.

package/dist/index.js

@@ -306,11 +306,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);
@@ -354,14 +360,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,
@@ -394,8 +416,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;
@@ -455,6 +480,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`,
@@ -462,6 +488,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`,
@@ -479,6 +506,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.4.0",
+    "version": "1.5.0",
     "description": "CLI to scaffold a new OpenAgent project (hirer or worker)",
     "type": "module",
     "bin": {
@@ -23,4 +23,4 @@
         "typescript": "^5.3.3",
         "@types/node": "^20.11.20"
     }
-}
+}

package/src/index.ts

@@ -325,12 +325,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);
@@ -380,16 +386,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: {
@@ -426,8 +445,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;
@@ -488,6 +511,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`,
@@ -495,6 +519,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`,
@@ -514,6 +539,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) {