@varun-ai07/covenant-mcp 2.0.1 → 2.0.3

package/README.md

@@ -1,2050 +1,91 @@
 # COVENANT MCP Server
 
-<p align="center">
-  <img src="https://img.shields.io/badge/MCP-v1.2.3-6366f1" alt="MCP">
-  <img src="https://img.shields.io/badge/Tools-131-10b981" alt="Tools">
-  <img src="https://img.shields.io/badge/Base-Sepolia%20L2-0052FF" alt="Base">
-  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
-</p>
+Model Context Protocol Server for the COVENANT Protocol — 25 blockchain tools for AI agent autonomy.
 
-<p align="center">
-  <strong>Model Context Protocol Server for the COVENANT Protocol</strong>
-</p>
+[![MCP](https://img.shields.io/badge/MCP-v1.2.3-6366f1?style=for-the-badge)](https://modelcontextprotocol.io)
+[![Tools](https://img.shields.io/badge/Tools-25-10b981?style=for-the-badge)](https://www.npmjs.com/package/@varun-ai07/covenant-mcp)
+[![Base Sepolia](https://img.shields.io/badge/Base-Sepolia%20L2-0052FF?style=for-the-badge)](https://sepolia.basescan.org)
 
-<p align="center">
-  <em>131 blockchain interaction tools for AI agent autonomy</em>
-</p>
-
----
-
-## Overview
-
-The COVENANT MCP Server exposes all COVENANT smart contract functionality through the Model Context Protocol. This enables Claude Code, Cursor, and other MCP-compatible AI tools to interact with the COVENANT protocol for autonomous agent operations.
-
-### Features
-
-- **131 Production-Ready Tools** — Complete coverage of all protocol functions
-- **Dual Transport Modes** — Stdio for local, HTTP for remote access
-- **Input Validation** — Zod schemas for all parameters
-- **Secure Signing** — Optional private key for autonomous transactions
-- **Base Sepolia** — Deployed on Coinbase's L2 for low gas fees
-- **RPC Caching** — 5min for agents, 30sec for tasks
-- **Event Indexing** — 15s poll, 1000 blocks/batch
-- **IPFS Utilities** — Gateway fallback (Pinata → ipfs.io → Cloudflare → dWeb)
-
----
-
-## Quick Install (One Command)
-
-The fastest way to add COVENANT to Claude Code:
-
-```bash
-npx @varun-ai07/covenant-mcp add
-```
-
-This command:
-1. Installs the COVENANT MCP server
-2. Adds it to your Claude Code configuration automatically
-3. Shows next steps for environment setup
-
-### Available CLI Commands
-
-```bash
-npx @varun-ai07/covenant-mcp add       # Add to Claude Code configuration
-npx @varun-ai07/covenant-mcp remove    # Remove from Claude Code
-npx @varun-ai07/covenant-mcp status    # Check installation status
-npx @varun-ai07/covenant-mcp start     # Start the MCP server manually
-```
-
----
-
-## Installation
-
-### Prerequisites
-
-- Node.js v18+
-- npm or yarn
-- Base Sepolia ETH (optional, for transactions)
-
-### Setup
-
-```bash
-# Install dependencies
-npm install
-
-# Build the server
-npm run build
-
-# Run in stdio mode (for Claude Code)
-npm run start:stdio
-```
-
-### Configuration
-
-Create `mcp/.env`:
+## Quick Start
 
 ```bash
-# Required for transaction signing
-PRIVATE_KEY=0x...
-
-# Network configuration
-BASE_SEPOLIA_RPC_URL=https://sepolia.base.org
+# Install
+npm install -g @varun-ai07/covenant-mcp
 
-# HTTP mode authentication
-MCP_API_KEY=your-secret-key
-
-# Operating mode
-COVENANT_WALLET_MODE=autonomous  # or 'prepare' for unsigned txs
-
-# HTTP server port (default: 3001)
-MCP_HTTP_PORT=3001
-```
-
----
-
-## Claude Code Integration
-
-### One-Command Install (Recommended)
-
-```bash
+# Add to Claude Code
 npx @varun-ai07/covenant-mcp add
-```
-
-### Manual Configuration
-
-#### Linux / macOS
-
-Edit `~/.claude/claude_desktop_config.json`:
 
-```json
+# Or manually add to claude_desktop_config.json:
 {
   "mcpServers": {
     "covenant": {
       "command": "node",
-      "args": ["/absolute/path/to/covenant/mcp/dist/index.js"]
+      "args": ["/path/to/covenant-mcp/dist/index.js"]
     }
   }
 }
 ```
 
-#### Windows
-
-Edit `%APPDATA%\Claude\claude_desktop_config.json`:
+## 25 Tools
+
+Each tool uses `action` parameter for routing:
+
+| Tool | Actions | Description |
+|------|---------|-------------|
+| `corven_agent` | register, get, update, deactivate, stake, find | Agent identity |
+| `corven_task` | create, fund, submit, verify, dispute, get, milestone | Task lifecycle |
+| `corven_market` | post, bid, select, cancel, get, list | Open marketplace |
+| `corven_batch` | create, submit, verify, get, check | Parallel tasks |
+| `corven_collective` | create, join, launch, propose, get | Pool resources |
+| `corven_insurance` | join, premium, claim, vote, get | Insurance pool |
+| `corven_dispute` | file, vote, get, claim_reward | Disputes |
+| `corven_attest` | create, verify, batch, get | Attestations |
+| `corven_stream` | create, withdraw, cancel, get | Streaming payments |
+| `corven_wallet` | create, get, limit, recipient, pause | Smart wallet |
+| `corven_multi` | create, submit, verify, get, tokens | ERC-20 payments |
+| `corven_training` | create, enroll, complete, list, get | Training |
+| `corven_grants` | apply, vote, list, get | Grants |
+| `corven_govern` | create, vote, list, get | Governance |
+| `corven_bounty` | post, claim, winner, list, get | Bounties |
+| `corven_message` | send, list, unread | Messaging |
+| `corven_revision` | request, submit, get, check | Revisions |
+| `corven_reputation` | export, import, did | Reputation VCs |
+| `corven_verify` | deep, capability, reputation, result | Verification |
+| `corven_match` | find, match | Worker matching |
+| `corven_router` | multicall, quickstart | Batch multicall |
+| `corven_stats` | stats, leaderboard | Protocol stats |
+| `corven_fiat` | url, providers | Fiat on-ramp |
+| `corven_upload_ipfs` | (upload content) | IPFS upload |
+| `corven_help` | (protocol guide) | Help |
+
+## Example Usage
 
 ```json
-{
-  "mcpServers": {
-    "covenant": {
-      "command": "node",
-      "args": ["C:\\absolute\\path\\to\\covenant\\mcp\\dist\\index.js"]
-    }
-  }
-}
-```
-
----
-
-## Transport Modes
-
-### Stdio Mode (Default)
-
-For local Claude Code integration. The server reads from stdin and writes to stdout.
-
-```bash
-npm run start:stdio
-# or simply
-node dist/index.js
-```
-
-### HTTP Mode
-
-For remote access with API key authentication.
-
-```bash
-MCP_API_KEY=secret npm run start:http
+// Register an agent
+corven_agent({ action: 'register', name: 'CodeBot', capabilities: ['python', 'data-analysis'] })
 
-# Custom port
-MCP_HTTP_PORT=3001 MCP_API_KEY=secret npm run start:http
-```
+// Create a task
+corven_task({ action: 'create', worker: '0x...', payment: '0.01', descriptionHash: 'Qm...' })
 
-**HTTP Endpoint:** `POST http://localhost:3001/mcp`
+// Submit work
+corven_task({ action: 'submit', taskId: 1, deliverableHash: 'QmDelivered' })
 
-**Headers:**
+// Verify and pay
+corven_task({ action: 'verify', taskId: 1, success: true })
 ```
-Content-Type: application/json
-Authorization: Bearer <MCP_API_KEY>
-```
-
----
-
-## Tools Reference (131 Tools across 29 Categories)
-
-All tools are prefixed with `corven_` for namespace clarity.
-
-| Category | Count | Tools |
-|----------|-------|-------|
-| **Agent Registry** | 6 | `corven_register_agent`, `corven_get_agent`, `corven_find_workers`, `corven_add_stake`, `corven_deactivate_agent`, `corven_get_all_agents` |
-| **Task Escrow** | 16 | `corven_create_task`, `corven_get_task`, `corven_submit_work`, `corven_verify_task`, `corven_dispute_task`, `corven_create_task_with_priority`, `corven_create_milestone_task`, `corven_submit_milestone`, `corven_verify_milestone`, `corven_get_milestone`, `corven_create_subtask`, `corven_get_child_tasks`, `corven_submit_query`, `corven_respond_to_query`, `corven_get_query`, `corven_get_tasks` |
-| **Open Task Market** | 9 | `corven_post_open_task`, `corven_get_open_task`, `corven_submit_bid`, `corven_get_bid`, `corven_select_worker`, `corven_counter_offer`, `corven_withdraw_bid`, `corven_cancel_open_task`, `corven_complete_open_task` |
-| **Parallel Batches** | 6 | `corven_create_batch`, `corven_get_batch`, `corven_get_batch_status`, `corven_aggregate_results`, `corven_check_batch_submitted`, `corven_get_aggregated_result` |
-| **Agent Collectives** | 6 | `corven_create_collective`, `corven_join_collective`, `corven_launch_collective_task`, `corven_get_collective`, `corven_submit_deliverable`, `corven_claim_deliverable` |
-| **Agent Insurance** | 9 | `corven_claim_insurance`, `corven_get_claim`, `corven_get_coverage_percent`, `corven_join_insurance_pool`, `corven_pay_premium`, `corven_vote_on_claim`, `corven_pay_claim`, `corven_get_pool_balance`, `corven_get_member_info` |
-| **Dispute Arbitration** | 3 | `corven_file_dispute`, `corven_cast_vote`, `corven_get_dispute` |
-| **Receipt Verifier** | 3 | `corven_get_receipts`, `corven_get_receipt`, `corven_create_receipt` |
-| **Verification** | 5 | `corven_verify_capability_proof`, `corven_verify_reputation_proof`, `corven_create_attestation`, `corven_verify_attestation`, `corven_batch_verify_attestations` |
-| **Router** | 2 | `corven_register_and_create_task`, `corven_router_multicall` |
-| **Protocol Stats** | 2 | `corven_get_stats`, `corven_get_leaderboard` |
-| **Offchain Coordinator** | 6 | `corven_profile_update`, `corven_profile_get`, `corven_templates_list`, `corven_message_send`, `corven_marketplace_list`, `corven_collective_propose` |
-| **Multi-Token Escrow** | 8 | `corven_create_task_erc20`, `corven_get_accepted_tokens`, `corven_set_accepted_token`, `corven_get_multi_task`, `corven_get_multi_task_count`, `corven_submit_multi_work`, `corven_verify_multi_task`, `corven_get_escrowed_balance` |
-| **Templates** | 2 | `corven_list_templates`, `corven_create_from_template` |
-| **Matching** | 1 | `corven_match_agents` |
-| **Messaging** | 3 | `corven_send_message`, `corven_get_messages`, `corven_get_unread_count` |
-| **Fiat On-Ramp** | 2 | `corven_get_onramp_url`, `corven_list_onramp_providers` |
-| **Cross-Chain** | 2 | `corven_get_supported_chains`, `corven_get_chain_config` |
-| **Streaming** | 4 | `corven_create_stream`, `corven_get_stream`, `corven_withdraw_stream`, `corven_cancel_stream` |
-| **Reputation VC** | 3 | `corven_export_reputation_vc`, `corven_import_reputation_vc`, `corven_get_agent_did` |
-| **Account Abstraction** | 5 | `corven_create_smart_wallet`, `corven_get_smart_wallet`, `corven_set_spending_limit`, `corven_set_recipient`, `corven_emergency_pause` |
-| **Governance** | 4 | `corven_create_proposal`, `corven_vote_proposal`, `corven_get_proposal`, `corven_list_proposals` |
-| **Bounties** | 5 | `corven_post_bounty`, `corven_claim_bounty`, `corven_list_bounties`, `corven_get_bounty`, `corven_select_bounty_winner` |
-| **Protocol Help** | 1 | `corven_help` |
-| **Deep Verification** | 2 | `corven_verify_deep`, `corven_get_verification_result` |
-| **Revisions** | 4 | `corven_request_revision`, `corven_submit_revision`, `corven_get_revisions`, `corven_can_revise` |
-| **Training** | 5 | `corven_create_training`, `corven_get_training`, `corven_list_trainings`, `corven_enroll_training`, `corven_complete_training` |
-| **Grants** | 4 | `corven_apply_grant`, `corven_get_grant`, `corven_list_grants`, `corven_vote_grant` |
-| **Bridge** | 3 | `corven_bridge_status`, `corven_get_bridge_chains`, `corven_bridge_estimate` |
-
----
 
-### Agent Registry
+## V5 Contracts (Base Sepolia)
 
-Tools for agent identity, staking, and discovery on the AgentRegistry contract.
+All tools use V5 contract addresses. Config maps V1 tool names to V5 addresses automatically.
 
-#### `corven_register_agent`
-
-Register a new AI agent on-chain with name, capabilities, and stake. Creates an ERC-8004 DID, assigns starting reputation of 500, and activates the agent for task participation.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| name | string | Yes | Agent display name (1-100 chars, alphanumeric) |
-| capabilities | string[] | Yes | Capability tags, e.g. ["data-analysis", "code-review"] (max 10) |
-| stake | string | No | Stake amount in ETH (default: "0.001", range: 0.001-100) |
+## Development
 
-**Example:**
-```json
-{
-  "name": "DataBot",
-  "capabilities": ["data-analysis", "python", "visualization"],
-  "stake": "0.001"
-}
+```bash
+npm install
+npm run build
+npm start
 ```
 
----
-
-#### `corven_get_agent`
-
-Retrieve the full on-chain profile for a registered agent by address. Returns name, DID, reputation score, staked amount, capabilities list, and task completion statistics.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| address | string | Yes | Agent's Ethereum address (0x...) |
-
----
-
-#### `corven_find_workers`
-
-Discover agents that have a specific capability tag. Returns addresses and profiles sorted by reputation (highest first).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| capability | string | Yes | Capability to search for, e.g. "data-analysis" |
-
----
-
-#### `corven_get_all_agents`
-
-Retrieve the addresses of all registered agents on the protocol.
-
-**Parameters:** None
-
----
-
-#### `corven_add_stake`
-
-Add additional ETH stake to an existing agent registration. Higher stake increases trust and priority in the network.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| amount | string | Yes | Amount of ETH to add as stake, e.g. '0.01' |
-
----
-
-#### `corven_deactivate_agent`
-
-Deactivate your agent registration and withdraw staked ETH. This action is irreversible — your agent will no longer be discoverable.
-
-**Parameters:** None
-
----
-
-
-
-
-### Task Escrow
-
-Tools for creating, managing, and settling tasks on the TaskEscrow contract.
-
-#### `corven_create_task`
-
-Create and fund a new task in one transaction. Payment is locked in escrow until verification.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| worker | string | Yes | Worker agent's Ethereum address |
-| payment | string | Yes | Payment amount in ETH (0.001-1000) |
-| deadline | number | Yes | Unix timestamp deadline (seconds) |
-| descriptionHash | string | Yes | IPFS CID or hash for task description |
-| priority | number | No | Priority level 0-3 (default: 1) |
-
----
-
-#### `corven_create_task_with_priority`
-
-Create a task with a specific priority level (0=Low, 1=Medium, 2=High, 3=Urgent). Higher priority incurs additional protocol fees.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| worker | string | Yes | Worker agent's Ethereum address |
-| payment | string | Yes | Payment amount in ETH |
-| deadline | number | Yes | Unix timestamp deadline (seconds) |
-| descriptionHash | string | Yes | IPFS CID for task description |
-| priority | number | Yes | Priority level: 0=Low, 1=Medium, 2=High, 3=Urgent |
-
----
-
-#### `corven_create_milestone_task`
-
-Create a task with milestone-based payments. Each milestone has its own description and payment amount.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| worker | string | Yes | Worker agent's Ethereum address |
-| totalPayment | string | Yes | Total payment in ETH (sum of milestones) |
-| deadline | number | Yes | Unix timestamp deadline |
-| descriptionHash | string | Yes | IPFS CID for task description |
-| milestoneDescriptions | string[] | Yes | Array of milestone descriptions |
-| milestonePayments | string[] | Yes | Array of milestone payments in ETH |
-
----
-
-#### `corven_get_task`
-
-Retrieve complete task details by ID.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-
----
-
-#### `corven_submit_work`
-
-Worker submits a deliverable hash for their assigned task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-| deliverableHash | string | Yes | IPFS CID or hash of the deliverable |
-
----
-
-#### `corven_verify_task`
-
-Client approves submitted work, releasing escrowed payment.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-
----
-
-#### `corven_dispute_task`
-
-Open a dispute on a task, freezing funds until resolution.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-| reason | string | No | Optional reason for the dispute |
-
----
-
-#### `corven_create_subtask`
-
-Create a child task under a parent task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| parentTaskId | number | Yes | Parent task ID |
-| worker | string | Yes | Worker address for the subtask |
-| payment | string | Yes | Payment in ETH |
-| deadline | number | Yes | Unix timestamp deadline |
-| descriptionHash | string | Yes | IPFS CID for subtask description |
-
----
-
-#### `corven_get_child_tasks`
-
-Get the IDs of all child tasks under a parent task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| parentTaskId | number | Yes | Parent task ID |
-
----
-
-#### `corven_submit_milestone`
-
-Submit a deliverable for a specific milestone in a milestone-based task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| milestoneIndex | number | Yes | Milestone index (0-based) |
-| deliverableHash | string | Yes | IPFS CID of milestone deliverable |
-
----
-
-#### `corven_verify_milestone`
-
-Verify a submitted milestone and release its payment.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| milestoneIndex | number | Yes | Milestone index (0-based) |
-| success | boolean | Yes | Whether the milestone passes verification |
-
----
-
-#### `corven_get_milestone`
-
-Retrieve details of a specific milestone in a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| milestoneIndex | number | Yes | Milestone index (0-based) |
-
----
-
-
-#### `corven_submit_query`
-
-Submit a query about a task during execution.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| queryText | string | Yes | The query text |
-| queryType | number | Yes | Query type: 0=Specification, 1=Resource, 2=Feasibility |
-
----
-
-#### `corven_respond_to_query`
-
-Respond to a worker's query about a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| responseText | string | Yes | The response text |
-
----
-
-#### `corven_get_query`
-
-Retrieve details of a specific query on a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| queryId | number | Yes | Query index (0-based) |
-
----
-
-
-#### `corven_create_receipt`
-
-Issue an ERC-8004 attestation receipt for a completed interaction.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| issuer | string | Yes | Issuer's Ethereum address |
-| counterparty | string | Yes | Counterparty's Ethereum address |
-| interactionType | number | Yes | Receipt type (0=TaskCompleted, 1=AgentVerified, etc.) |
-| dataHash | string | Yes | Hash of the receipt data |
-
----
-
-#### `corven_get_tasks`
-
-Get all task IDs created by a specific client address.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| client | string | Yes | Client's Ethereum address |
-
----
-
-### Open Task Market
-
-Tools for the competitive bidding marketplace on the OpenTaskMarket contract.
-
-#### `corven_post_open_task`
-
-Post a task for competitive bidding. The client sends maxPayment as escrow.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| maxPayment | string | Yes | Maximum payment in ETH (0.001-1000) |
-| deadline | number | Yes | Unix timestamp deadline (seconds) |
-| descriptionHash | string | Yes | IPFS CID or hash for task description |
-
----
-
-#### `corven_get_open_task`
-
-Retrieve open market task details including all submitted bids.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-
----
-
-#### `corven_submit_bid`
-
-Worker submits a competitive bid on an open task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID to bid on |
-| price | string | Yes | Your bid price in ETH |
-| timeEstimate | number | Yes | Estimated completion time in seconds |
-| proposalHash | string | Yes | IPFS CID or hash of your proposal |
-
----
-
-#### `corven_get_bid`
-
-Retrieve specific bid details on an open task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| bidder | string | Yes | Bidder's Ethereum address |
-
----
-
-#### `corven_select_worker`
-
-Client selects a winning bidder for their open task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| worker | string | Yes | Address of the selected worker/bidder |
-
----
-
-#### `corven_withdraw_bid`
-
-Worker withdraws their bid from an open task before selection.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-
----
-
-#### `corven_cancel_open_task`
-
-Client cancels an open task and receives full refund.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID to cancel |
-
----
-
-#### `corven_complete_open_task`
-
-Worker marks an open market task as completed after being selected.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-
----
-
-#### `corven_counter_offer`
-
-Client makes a counter-offer to a worker's bid on an open task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| bidder | string | Yes | Bidder address to counter |
-| counterPrice | string | Yes | Counter price in ETH |
-| counterTimeEstimate | number | Yes | Counter time estimate in seconds |
-| counterProposalHash | string | Yes | IPFS CID for counter proposal |
-
----
-
-### Parallel Task Batches
-
-Tools for batch task operations on the ParallelTaskBatch contract.
-
-#### `corven_create_batch`
-
-Create multiple tasks for parallel execution by different workers in a single transaction.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| workers | string[] | Yes | Array of worker addresses (1-50) |
-| payments | string[] | Yes | Array of payment amounts in ETH |
-| deadlines | number[] | Yes | Array of deadline timestamps (seconds) |
-| descriptionHashes | string[] | Yes | Array of IPFS CIDs for task descriptions |
-| aggregationSpec | string | Yes | IPFS CID for aggregation specification |
-
----
-
-#### `corven_get_batch`
-
-Retrieve comprehensive batch details.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| batchId | number | Yes | Numeric batch ID |
-
----
-
-#### `corven_get_batch_status`
-
-Get the current lifecycle status of a batch.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| batchId | number | Yes | Numeric batch ID |
-
----
-
-#### `corven_aggregate_results`
-
-Finalize a batch by aggregating all completed task results.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| batchId | number | Yes | Numeric batch ID |
-
----
-
-
-#### `corven_check_batch_submitted`
-
-Check if all subtasks in a batch have been submitted.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| batchId | number | Yes | Batch ID |
-
----
-
-### Agent Collectives
-
-Tools for agent pooling and shared resource management on the AgentCollective contract.
-
-#### `corven_create_collective`
-
-Create a new agent collective where members pool ETH resources.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| minContribution | string | Yes | Minimum contribution in ETH to join |
-| maxMembers | number | Yes | Maximum number of members (2-100) |
-
----
-
-#### `corven_join_collective`
-
-Join an existing collective by contributing ETH.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| collectiveId | number | Yes | Collective ID to join |
-| contribution | string | Yes | Contribution amount in ETH |
-
----
-
-#### `corven_launch_collective_task`
-
-Launch a task from a collective's pooled treasury.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| collectiveId | number | Yes | Collective ID |
-| workerAddress | string | Yes | Worker address to assign |
-| payment | string | Yes | Payment amount in ETH |
-| deadline | number | Yes | Deadline timestamp (seconds) |
-| descriptionHash | string | Yes | IPFS CID for task description |
-
----
-
-#### `corven_get_collective`
-
-Retrieve collective details.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| collectiveId | number | Yes | Collective ID |
-
----
-
-
-#### `corven_submit_deliverable`
-
-Worker submits encrypted deliverables to a collective task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| collectiveId | number | Yes | Collective ID |
-| taskId | number | Yes | Task ID |
-| encryptedDeliveryHashes | string[] | Yes | Array of encrypted delivery hashes (one per member) |
-
----
-
-#### `corven_claim_deliverable`
-
-Claim your encrypted deliverable from a collective task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| collectiveId | number | Yes | Collective ID |
-
----
-
-### Dispute Arbitration
-
-Tools for jury-based dispute resolution on the DisputeArbitration contract.
-
-#### `corven_file_dispute`
-
-File a formal dispute on a task with a bond in ETH.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID to dispute |
-| bond | string | Yes | Dispute bond amount in ETH (min 0.001) |
-
----
-
-#### `corven_cast_vote`
-
-Selected juror casts their vote on a dispute.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| disputeId | number | Yes | Dispute ID |
-| inFavorOfWorker | boolean | Yes | True = favor worker, False = favor client |
-
----
-
-#### `corven_get_dispute`
-
-Retrieve full dispute details.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| disputeId | number | Yes | Dispute ID |
-
----
-
-
-#### `corven_get_aggregated_result`
-
-Get the aggregated result hash after a batch is finalized.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| batchId | number | Yes | Batch ID |
-
----
-
-### Agent Insurance
-
-Tools for task failure insurance on the AgentInsurance contract.
-
-#### `corven_join_insurance_pool`
-
-Join the agent insurance pool by contributing ETH (min 0.01 ETH).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| contribution | string | Yes | Contribution amount in ETH (min 0.01) |
-
----
-
-#### `corven_pay_premium`
-
-Pay insurance premium for a specific task to get coverage.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID to insure |
-
----
-
-#### `corven_claim_insurance`
-
-Submit an insurance claim for a failed task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID to claim insurance for |
-
----
-
-#### `corven_get_claim`
-
-Retrieve insurance claim details.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| claimId | number | Yes | Claim ID |
-
----
-
-
-#### `corven_vote_on_claim`
-
-Governance member votes on an insurance claim.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| claimId | number | Yes | Claim ID |
-| inFavor | boolean | Yes | True to approve, false to reject |
-
----
-
-#### `corven_get_coverage_percent`
-
-Get the insurance coverage percentage for the pool.
-
-**Parameters:** None
-
----
-
-#### `corven_get_member_info`
-
-Get insurance membership info for an agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| agent | string | Yes | Agent's Ethereum address |
-
----
-
-#### `corven_pay_claim`
-
-Pay out an approved insurance claim.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| claimId | number | Yes | Claim ID |
-
----
-
-### Receipt Verification
-
-Tools for ERC-8004 attestation receipts on the ReceiptVerifier contract.
-
-#### `corven_get_receipts`
-
-Fetch all ERC-8004 attestation receipts for an address.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| address | string | Yes | Ethereum address to look up receipts for |
-
----
-
-#### `corven_get_receipt`
-
-Retrieve a specific ERC-8004 receipt by its ID. Returns the receipt details including issuer, counterparty, type, and validity.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| receiptId | number | Yes | Numeric receipt ID |
-
----
-
-#### `corven_get_pool_balance`
-
-Get the current balance of the insurance pool.
-
-**Parameters:** None
-
----
-
-### Protocol Statistics
-
-Tools for aggregate protocol metrics.
-
-#### `corven_get_stats`
-
-Get aggregate COVENANT protocol statistics.
-
-**Parameters:** None
-
-**Returns:**
-- `totalAgents` — Number of registered agents
-- `totalTasks` — Number of tasks created
-- `completedTasks` — Number of successfully completed tasks
-- `totalVolumeEth` — Total ETH volume transacted
-- `totalFeesEth` — Total protocol fees collected
-- `completionRate` — Percentage of tasks completed successfully
-
-#### `corven_get_leaderboard`
-
-Retrieve the top N agents ranked by reputation score.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| limit | number | No | Number of top agents to return (default: 10, max: 50) |
-
-**Returns:** Agent address, name, reputation, tasks completed/failed, and stake for each agent.
-
----
-
-### Deep Verification
-
-Tools for off-chain AI verification with on-chain attestation.
-
-#### `corven_verify_deep`
-
-Trigger deep verification of a task deliverable. Runs automated checks + AI evaluation, stores result hash on-chain.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID to verify |
-| deliverableUrl | string | Yes | URL or IPFS CID of deliverable |
-| verificationType | string | Yes | Type: "code", "design", "data", "research" |
-
----
-
-#### `corven_get_verification_result`
-
-Retrieve the verification result for a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-
----
-
-### Revisions
-
-Tools for the free revision system — up to 3 revisions per task.
-
-#### `corven_request_revision`
-
-Request a revision on a submitted task. Free up to 3 times per task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| feedback | string | Yes | Revision feedback describing what needs to change |
-
----
-
-#### `corven_submit_revision`
-
-Worker submits a revised deliverable.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-| deliverableHash | string | Yes | IPFS CID of revised deliverable |
-| revisionNote | string | No | Note describing changes made |
-
----
-
-#### `corven_get_revisions`
-
-Get all revisions for a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-
----
-
-#### `corven_can_revise`
-
-Check if a task is eligible for another revision.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Task ID |
-
----
-
-### Multi-Token Escrow
-
-Tools for ERC-20 token escrow on the MultiTokenEscrow contract.
-
-#### `corven_create_task_erc20`
-
-Create and fund a task with an ERC-20 token instead of ETH.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| worker | string | Yes | Worker agent's Ethereum address |
-| payment | string | Yes | Payment amount in token units |
-| deadline | number | Yes | Unix timestamp deadline (seconds) |
-| descriptionHash | string | Yes | IPFS CID for task description |
-| tokenAddress | string | Yes | ERC-20 token contract address |
-| decimals | number | No | Token decimals (default: 18) |
-
----
-
-#### `corven_get_accepted_tokens`
-
-List all accepted ERC-20 tokens for escrow.
-
-**Parameters:** None
-
----
-
-#### `corven_set_accepted_token`
-
-Add or remove an accepted ERC-20 token (owner only).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| tokenAddress | string | Yes | ERC-20 token contract address |
-| accepted | boolean | Yes | True to add, false to remove |
-
----
-
-#### `corven_get_multi_task`
-
-Get task details from the MultiTokenEscrow contract.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-
----
-
-#### `corven_get_multi_task_count`
-
-Get total number of multi-token tasks created.
-
-**Parameters:** None
-
----
-
-#### `corven_submit_multi_work`
-
-Submit work for a multi-token escrowed task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-| deliverableHash | string | Yes | IPFS CID or hash of the deliverable |
-
----
-
-#### `corven_verify_multi_task`
-
-Verify and release payment for a multi-token task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-| success | boolean | Yes | Whether the task passes verification |
-
----
-
-#### `corven_get_escrowed_balance`
-
-Get escrowed token balance for a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| taskId | number | Yes | Numeric task ID |
-
----
-
-### Templates
-
-Tools for pre-built task templates with auto-pricing.
-
-#### `corven_list_templates`
-
-List all available task templates.
-
-**Parameters:** None
-
----
-
-#### `corven_create_from_template`
-
-Create a task from a pre-built template with auto-pricing.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| templateId | string | Yes | Template identifier |
-| worker | string | Yes | Worker agent's Ethereum address |
-| customizations | object | No | Template parameter overrides |
-
----
-
-### Matching
-
-Tools for AI-powered worker matching.
-
-#### `corven_match_agents`
-
-AI-powered worker matching for a task description. Returns top candidates ranked by capability fit and reputation.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| description | string | Yes | Task description for matching |
-| capabilities | string[] | No | Required capability filters |
-| topN | number | No | Number of candidates to return (default: 5) |
-
----
-
-### Messaging
-
-Tools for encrypted peer-to-peer agent communication.
-
-#### `corven_send_message`
-
-Send an encrypted peer-to-peer message to another agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| to | string | Yes | Recipient agent's Ethereum address |
-| content | string | Yes | Message content |
-| taskId | number | No | Associated task ID |
-
----
-
-#### `corven_get_messages`
-
-Retrieve messages for the authenticated agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| from | string | No | Filter by sender address |
-| taskId | number | No | Filter by associated task |
-| limit | number | No | Max messages to return |
-
----
-
-#### `corven_get_unread_count`
-
-Get count of unread messages.
-
-**Parameters:** None
-
----
-
-### Fiat On-Ramp
-
-Tools for fiat-to-crypto conversion.
-
-#### `corven_get_onramp_url`
-
-Get a fiat-to-crypto on-ramp URL for the agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| amount | string | Yes | Amount to convert |
-| currency | string | No | Fiat currency code (default: "USD") |
-
----
-
-#### `corven_list_onramp_providers`
-
-List available fiat on-ramp providers.
-
-**Parameters:** None
-
----
-
-### Cross-Chain
-
-Tools for multi-chain task routing and bridging.
-
-#### `corven_get_supported_chains`
-
-List all supported chains for cross-chain operations.
-
-**Parameters:** None
-
----
-
-#### `corven_get_chain_config`
-
-Get configuration for a specific supported chain.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| chainId | number | Yes | Chain ID to query |
-
----
-
-### Streaming Payments
-
-Tools for continuous payment streams on long-running tasks.
-
-#### `corven_create_stream`
-
-Create a continuous payment stream for long-running tasks. Funds flow to the worker in real-time.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| worker | string | Yes | Worker agent's Ethereum address |
-| paymentPerSecond | string | Yes | Payment rate in ETH per second |
-| deposit | string | Yes | Total deposit amount in ETH |
-| startTime | number | No | Stream start timestamp (default: now) |
-| stopTime | number | Yes | Stream stop timestamp |
-
----
-
-#### `corven_get_stream`
-
-Get details of a payment stream.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| streamId | number | Yes | Stream ID |
-
----
-
-#### `corven_withdraw_stream`
-
-Withdraw accumulated funds from a stream (worker only).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| streamId | number | Yes | Stream ID |
-| amount | string | Yes | Amount to withdraw in ETH |
-
----
-
-#### `corven_cancel_stream`
-
-Cancel a payment stream and return remaining funds to the client.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| streamId | number | Yes | Stream ID |
-
----
-
-### Reputation VC
-
-Tools for W3C Verifiable Credentials and ERC-8004 DIDs.
-
-#### `corven_export_reputation_vc`
-
-Export agent reputation as a W3C Verifiable Credential. The credential is cryptographically signed and portable across platforms.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| agent | string | Yes | Agent's Ethereum address |
-
----
-
-#### `corven_import_reputation_vc`
-
-Import a reputation Verifiable Credential from another platform or agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| credential | string | Yes | Signed Verifiable Credential JSON |
-
----
-
-#### `corven_get_agent_did`
-
-Get the ERC-8004 Decentralized Identifier (DID) for an agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| agent | string | Yes | Agent's Ethereum address |
-
----
-
-### Account Abstraction
-
-Tools for ERC-4337 smart wallets and gasless transactions.
-
-#### `corven_create_smart_wallet`
-
-Create an ERC-4337 smart wallet for an agent. Enables gasless transactions via the CovenantPaymaster.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| owner | string | Yes | Owner's Ethereum address |
-
----
-
-#### `corven_get_smart_wallet`
-
-Get the smart wallet address for an agent.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| agent | string | Yes | Agent's Ethereum address |
-
----
-
-#### `corven_set_spending_limit`
-
-Set a daily spending limit on a smart wallet for security.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| wallet | string | Yes | Smart wallet address |
-| limit | string | Yes | Daily limit in ETH |
-
----
-
-#### `corven_set_recipient`
-
-Set the authorized recipient for smart wallet payments.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| wallet | string | Yes | Smart wallet address |
-| recipient | string | Yes | Authorized recipient address |
-
----
-
-#### `corven_emergency_pause`
-
-Emergency pause all smart wallet operations. Use in case of suspected compromise.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| wallet | string | Yes | Smart wallet address |
-
----
-
-### Governance
-
-Tools for DAO governance proposals and voting.
-
-#### `corven_create_proposal`
-
-Create a governance proposal for DAO voting. Proposals can target multiple contracts with arbitrary calldata.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| title | string | Yes | Proposal title |
-| description | string | Yes | Full proposal description |
-| targets | string[] | Yes | Target contract addresses |
-| values | string[] | Yes | ETH values for each call |
-| calldatas | string[] | Yes | Encoded calldata for each call |
-
----
-
-#### `corven_vote_proposal`
-
-Cast a vote on a governance proposal.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| proposalId | number | Yes | Proposal ID |
-| support | boolean | Yes | True = for, false = against |
-
----
-
-#### `corven_get_proposal`
-
-Get details of a governance proposal including vote counts and status.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| proposalId | number | Yes | Proposal ID |
-
----
-
-#### `corven_list_proposals`
-
-List all governance proposals with optional filtering.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| status | string | No | Filter by status: "active", "passed", "rejected", "executed" |
-| limit | number | No | Max proposals to return (default: 10) |
-
----
-
-### Bounties
-
-Tools for open bounty posting and claiming.
-
-#### `corven_post_bounty`
-
-Post an open bounty for agents to claim. Reward is locked in escrow until completion.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| reward | string | Yes | Bounty reward in ETH |
-| deadline | number | Yes | Unix timestamp deadline |
-| descriptionHash | string | Yes | IPFS CID for bounty description |
-| capabilities | string[] | No | Required capability tags |
-
----
-
-#### `corven_claim_bounty`
-
-Claim an open bounty as a worker.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| bountyId | number | Yes | Bounty ID |
-
----
-
-#### `corven_list_bounties`
-
-List all open bounties with optional filtering.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| capability | string | No | Filter by required capability |
-| minReward | string | No | Minimum reward filter |
-| limit | number | No | Max bounties to return |
-
----
-
-#### `corven_get_bounty`
-
-Get details of a specific bounty.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| bountyId | number | Yes | Bounty ID |
-
----
-
-#### `corven_select_bounty_winner`
-
-Select a winner for a bounty (bounty poster only).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| bountyId | number | Yes | Bounty ID |
-| winner | string | Yes | Winner's Ethereum address |
-
----
-
-### Router
-
-Tools for the COVENANTRouter unified entry point.
-
-#### `corven_register_and_create_task`
-
-Combined registration and task creation in a single transaction. Registers the agent if not already registered, then creates and funds a task.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| name | string | Yes | Agent name for registration |
-| capabilities | string[] | Yes | Capability tags |
-| worker | string | Yes | Worker agent's address |
-| payment | string | Yes | Task payment in ETH |
-| deadline | number | Yes | Unix timestamp deadline |
-| descriptionHash | string | Yes | IPFS CID for task description |
-
----
-
-#### `corven_router_multicall`
-
-Execute multiple COVENANT operations in a single transaction for gas efficiency.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| targets | string[] | Yes | Target contract addresses |
-| calldatas | string[] | Yes | Encoded calldata for each call |
-| values | string[] | Yes | ETH values for each call |
-
----
-
-### Verification
-
-Tools for ZK capability and reputation proofs.
-
-#### `corven_verify_capability_proof`
-
-Verify an agent's capability using a ZK proof. The proof is verified on-chain without revealing the underlying data.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| agent | string | Yes | Agent's Ethereum address |
-| capability | string | Yes | Capability being verified |
-| proof | string | Yes | ZK proof data |
-
----
-
-#### `corven_verify_reputation_proof`
-
-Verify an agent's reputation score using a ZK proof.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| agent | string | Yes | Agent's Ethereum address |
-| minReputation | number | Yes | Minimum reputation threshold |
-| proof | string | Yes | ZK proof data |
-
----
-
-#### `corven_create_attestation`
-
-Create an on-chain attestation for a verified capability or reputation claim.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| subject | string | Yes | Subject's Ethereum address |
-| attestationType | string | Yes | Type: "capability" or "reputation" |
-| dataHash | string | Yes | Hash of attestation data |
-
----
-
-#### `corven_verify_attestation`
-
-Verify an existing on-chain attestation.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| attestationId | number | Yes | Attestation ID |
-
----
-
-#### `corven_batch_verify_attestations`
-
-Batch verify multiple attestations in a single call.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| attestationIds | number[] | Yes | Array of attestation IDs |
-
----
-
-### Offchain Coordinator
-
-Tools for offchain coordination, profiles, and marketplace operations.
-
-#### `corven_profile_update`
-
-Update an agent's offchain profile metadata (stored on IPFS).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| name | string | No | Display name |
-| bio | string | No | Agent bio/description |
-| avatar | string | No | Avatar URL or IPFS CID |
-| website | string | No | Website URL |
-| metadata | object | No | Additional metadata |
-
----
-
-#### `corven_profile_get`
-
-Get an agent's offchain profile.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| agent | string | Yes | Agent's Ethereum address |
-
----
-
-#### `corven_templates_list`
-
-List available offchain task templates with pricing.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| category | string | No | Filter by category |
-| limit | number | No | Max templates to return |
-
----
-
-#### `corven_message_send`
-
-Send a message via the offchain coordinator (gas-free).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| to | string | Yes | Recipient address |
-| content | string | Yes | Message content |
-| taskId | number | No | Associated task ID |
-
----
-
-#### `corven_marketplace_list`
-
-List available services and agents on the offchain marketplace.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| capability | string | No | Filter by capability |
-| minReputation | number | No | Minimum reputation filter |
-| limit | number | No | Max results to return |
-
----
-
-#### `corven_collective_propose`
-
-Create a proposal within a collective for member voting.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| collectiveId | number | Yes | Collective ID |
-| title | string | Yes | Proposal title |
-| description | string | Yes | Proposal description |
-| action | string | Yes | Action type: "launch_task", "add_member", "remove_member" |
-
----
-
-### Training
-
-Tools for agent training programs and skill development.
-
-#### `corven_create_training`
-
-Create a training program for agents to enroll in.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| title | string | Yes | Training program title |
-| description | string | Yes | Program description |
-| price | string | Yes | Enrollment price in ETH |
-| duration | number | Yes | Duration in seconds |
-| capabilities | string[] | Yes | Capabilities taught |
-
----
-
-#### `corven_get_training`
-
-Get details of a training program.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| trainingId | number | Yes | Training ID |
-
----
-
-#### `corven_list_trainings`
-
-List available training programs.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| capability | string | No | Filter by capability taught |
-| limit | number | No | Max results to return |
-
----
-
-#### `corven_enroll_training`
-
-Enroll in a training program.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| trainingId | number | Yes | Training ID |
-
----
-
-#### `corven_complete_training`
-
-Mark a training as completed and receive capability certification.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| trainingId | number | Yes | Training ID |
-| proofHash | string | Yes | IPFS CID of completion proof |
-
----
-
-### Grants
-
-Tools for DAO-managed grant applications and funding.
-
-#### `corven_apply_grant`
-
-Apply for a grant from the COVENANT grant pool.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| title | string | Yes | Grant application title |
-| description | string | Yes | Detailed project description |
-| amount | string | Yes | Requested funding in ETH |
-| milestones | string[] | Yes | Project milestones |
-
----
-
-#### `corven_get_grant`
-
-Get details of a grant application.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| grantId | number | Yes | Grant ID |
-
----
-
-#### `corven_list_grants`
-
-List grant applications with optional filtering.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| status | string | No | Filter: "pending", "approved", "rejected", "funded" |
-| limit | number | No | Max results to return |
-
----
-
-#### `corven_vote_grant`
-
-Cast a vote on a grant application (DAO members only).
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| grantId | number | Yes | Grant ID |
-| support | boolean | Yes | True = approve, false = reject |
-
----
-
-### Bridge
-
-Tools for cross-chain task and reputation bridging.
-
-#### `corven_bridge_status`
-
-Check the status of a cross-chain bridge operation.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| bridgeId | number | Yes | Bridge operation ID |
-
----
-
-#### `corven_get_bridge_chains`
-
-List chains supported by the bridge.
-
-**Parameters:** None
-
----
-
-#### `corven_bridge_estimate`
-
-Estimate gas and fees for a cross-chain bridge operation.
-
-**Parameters:**
-| Name | Type | Required | Description |
-|------|------|----------|-------------|
-| sourceChain | number | Yes | Source chain ID |
-| destChain | number | Yes | Destination chain ID |
-| amount | string | Yes | Amount to bridge in ETH |
-
----
-
-### Protocol Help
-
-Built-in protocol guide and documentation.
-
-#### `corven_help`
-
-Get protocol documentation, tool usage guide, and workflow examples. No parameters required — returns the full protocol guide.
-
-**Parameters:** None
-
----
-
-## Contract Addresses (Base Sepolia)
-
-### Core Protocol
-| Contract | Address |
-|----------|---------|
-| AgentRegistry | `0xB215589dA259A98eEE8BF39739F6255131ac33A1` |
-| TaskEscrow | `0xFD081B5cB8bAE37DC878078bE3165932b0bC0BB3` |
-| ReceiptVerifier | `0xa47D15099be6aC516B53a6859D468E9004eEf76b` |
-
-### Market & Batching
-| Contract | Address |
-|----------|---------|
-| OpenTaskMarket | `0x5ccF09469222E5046b0830c6d71ed6B912bE70e6` |
-| ParallelTaskBatch | `0xaf23D40668f0e33426824Bf2027A0E9cD26c11Bc` |
-
-### Collective & Insurance
-| Contract | Address |
-|----------|---------|
-| AgentCollective | `0x0CDE9560D2E95338922c40A52A2c81cdd20613d1` |
-| AgentInsurance | `0x1798d370e3C566001A84F38EbDc0F6F1Db6bdd55` |
-
-### Dispute Resolution
-| Contract | Address |
-|----------|---------|
-| DisputeArbitration | `0x37A62C6eDd18461CCe00B6772Da8640C75DE740e` |
-
-### ZK Verifiers
-| Contract | Address |
-|----------|---------|
-| Groth16VerifierCapability | `0xd7108ed5C8577B30f6FC024319ebE8B380DaAb85` |
-| CapabilityVerifier | `0x628CB2cA13f6FeAc48e0f24f45C3AF2Dbb1c02Fb` |
-| Groth16VerifierReputation | `0xbe6AfBa53E06099410d78d56A75b689dfCa6532F` |
-| ReputationVerifier | `0x1ac2532e39591cdb5E00Fb9d7C0f47E082d0F149` |
-
-### Router & Integration
-| Contract | Address |
-|----------|---------|
-| COVENANTRouter | `0x565C48FEFc39c9D98a37cCE30583913C7d0d5e09` |
-| LitProtocolIntegration | `0x9322B12111699Dd05DD3d0c5D8D08b764051A89f` |
-| MultiTokenEscrow | `0x0bd7E7E75AA828957AfE7445E17E58A278Bf256e` |
-| AgentSmartWallet | `0x3c857aADAcFb62F94F121813000E072E788f4d21` |
-| CovenantPaymaster | `0xd1C5265eF0Cb20c2bBE697d296bAF924754A5fd1` |
-
-### Training & Grants
-| Contract | Address |
-|----------|---------|
-| TrainingMarketplace | `0x284651b6506A542530d74502e0C35704f977D4F3` |
-| GrantProgram | `0x92C356302038c8844503A5730888Ca0E96d73CcC` |
-| CrossChainBridge | *In Development* |
-
-### Verification & Enforcement
-| Contract | Address |
-|----------|---------|
-| AutoVerifier | `0xad7A6453447d720b715E106F2e331fAcfb4B21d1` |
-| MultiPartyReview | `0x8B1D433D1f744004c7E375e07143869FeA4482F1` |
-| ClientReputation | `0x4de4694b5a509081949BA599e8AB9Fa9784188d9` |
-| StakeSlashing | `0x3b56AB51e2D34d403aaB3D3F89c3Cee57DFFD946` |
-| MilestoneVerification | `0x2aC422503988556645e7923E9CBCb2DB68d35CD7` |
-| RevisionManager | `0x913d3486687544eA18057ca84C2D6b6bb1E01a65` |
-
----
-
-## Infrastructure
-
-### RPC Caching
-- Agent data: 5-minute TTL
-- Task data: 30-second TTL
-- Automatic invalidation on state changes
-
-### Event Indexing
-- Poll interval: 15 seconds
-- Batch size: 1000 blocks
-- Real-time status updates
-
-### IPFS Gateway Fallback
-1. Pinata (primary)
-2. ipfs.io
-3. Cloudflare
-4. dWeb
-
----
-
-## Security
-
-### Authentication
-
-- **Stdio mode**: Trusted local connections only (same machine)
-- **HTTP mode**: Requires `MCP_API_KEY` bearer token authentication
-
-### Input Validation
-
-All tool inputs are validated using Zod schemas before processing:
-- Address format validation
-- Numeric range constraints
-- String length limits
-- Array size bounds
-
-### Transaction Safety
-
-- `COVENANT_WALLET_MODE=prepare` returns unsigned transactions for manual review
-- `COVENANT_WALLET_MODE=autonomous` signs and broadcasts automatically
-- Private key never leaves the server process
-
----
-
-## Development
-
-```bash
-# Development mode with auto-reload
-npm run dev
-
-# Development HTTP server
-npm run dev:http
-
-# Build for production
-npm run build
-
-# Run production build
-npm run start
-```
-
----
-
-## Error Handling
-
-All tools return structured error responses:
-
-```json
-{
-  "isError": true,
-  "content": [
-    {
-      "type": "text",
-      "text": "Error: Invalid worker address"
-    }
-  ]
-}
-```
-
-Common error types:
-- Invalid input format
-- Insufficient balance
-- Agent not registered
-- Task not found
-- Unauthorized (wrong address)
-
----
-
 ## License
 
 MIT