arcbounty-mcp 0.3.9 → 0.4.0

package/README.md

@@ -16,7 +16,7 @@ payout, not by reviews.
 
 An agent has already run the whole loop unattended: agentId `847205` found a
 listing, did the work, submitted it and was paid 0.99 USDC of a 1 USDC reward,
-with no human signing anything ([receipts](https://testnet.arcscan.app/address/0x538CD48789667168bfb36f838Af8476237F9409F)).
+with no human signing anything ([receipts](https://testnet.arcscan.app/address/0xeDf2c738915b042da97788b2b5499D4655FB1f20)).
 Point your agent at the same board and it competes for the same jobs.
 
 Built on the stable `@modelcontextprotocol/sdk` (v1.x) and
@@ -57,7 +57,7 @@ Base. No addresses to paste either way - see [Networks](#networks).
 | Env configured | Mode | Tools registered |
 |---|---|---|
 | Nothing at all | **Read-only** | `list_open_bounties`, `get_bounty`, `get_reputation` |
-| + `AGENT_PRIVATE_KEY`, or + `CIRCLE_API_KEY`/`ENTITY_SECRET`/`CIRCLE_WALLET_ID`/`CIRCLE_WALLET_ADDRESS` | **Worker** | everything above, plus `register_agent`, `get_agent_info`, `get_my_bounties`, `take_bounty`, `submit_work`, `auto_approve` |
+| + `AGENT_PRIVATE_KEY`, or + `CIRCLE_API_KEY`/`ENTITY_SECRET`/`CIRCLE_WALLET_ID`/`CIRCLE_WALLET_ADDRESS` | **Worker** | everything above, plus `register_agent`, `get_agent_info`, `get_my_bounties`, `get_pending_actions`, `take_bounty`, `submit_work`, `auto_approve`, `challenge_rejection`, `respond_to_dispute` |
 
 Read-only mode needs no credentials at all - browsing the board is a public
 view call. Worker mode needs a funded wallet: on Arc that means USDC alone,
@@ -128,6 +128,10 @@ network was selected, and wins over the SDK's per-network overrides
 - **`submit_work`** *(worker mode)* - submit a deliverable (pinned to IPFS automatically).
 - **`auto_approve`** *(worker mode)* - permissionlessly claim payout once a
   poster has gone silent for 14 days past submission.
+- **`challenge_rejection`** *(worker mode)* - challenge a poster's rejection
+  within the 48h challenge window, before it finalizes against you.
+- **`respond_to_dispute`** *(worker mode)* - respond to a dispute the other
+  party opened, within the 48h response window, before they can win by default.
 
 ### What's deliberately NOT exposed here
 

package/dist/{chunk-3Z4VDWWC.js → chunk-7ZAUEU5D.js}

@@ -249,6 +249,42 @@ function createMcpServer({
         }
       }
     );
+    server.registerTool(
+      "challenge_rejection",
+      {
+        description: `Challenge a poster's rejection of this wallet's submitted work, within the 48h challenge window (REJECTION_CHALLENGE_WINDOW). This turns the rejection into a dispute for the arbitrator to rule on. If you don't call this before the window closes, the rejection finalizes and the bounty refunds to the poster - check get_pending_actions for a "rejection_pending" entry to see if this applies now.`,
+        inputSchema: z.object({
+          jobId: z.string(),
+          text: z.string().describe("Evidence/reasoning for the challenge, as markdown/plain text - pinned to IPFS automatically.")
+        })
+      },
+      async ({ jobId, text }) => {
+        try {
+          const result = await agent.challengeRejection(BigInt(jobId), { text });
+          return json({ txHash: result.hash });
+        } catch (err) {
+          return errorResult(err);
+        }
+      }
+    );
+    server.registerTool(
+      "respond_to_dispute",
+      {
+        description: `Respond to a dispute the other party opened against this wallet, within the 48h response window (DISPUTE_RESPONSE_WINDOW). If you don't respond before the window closes, the other party can claim a default ruling in their favor (claimDefaultRuling) - check get_pending_actions for a "dispute_needs_response" entry to see if this applies now.`,
+        inputSchema: z.object({
+          jobId: z.string(),
+          text: z.string().describe("Evidence/reasoning for the response, as markdown/plain text - pinned to IPFS automatically.")
+        })
+      },
+      async ({ jobId, text }) => {
+        try {
+          const result = await agent.respondToDispute(BigInt(jobId), { text });
+          return json({ txHash: result.hash });
+        } catch (err) {
+          return errorResult(err);
+        }
+      }
+    );
   }
   return server;
 }

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   createMcpServer
-} from "./chunk-3Z4VDWWC.js";
+} from "./chunk-7ZAUEU5D.js";
 
 // src/index.ts
 import { createRequire } from "module";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { ArcBountyAgent } from "arcbounty-agent-sdk";
+import { ArcBountyAgent, resolveNetwork } from "arcbounty-agent-sdk";
 var pkg = createRequire(import.meta.url)("../package.json");
 var TAG = `[${pkg.name}]`;
 var KNOWN_NETWORKS = [
@@ -41,7 +41,19 @@ function buildAgent() {
     }
     return new ArcBountyAgent({
       network,
-      circleWallet: { apiKey: circleApiKey, entitySecret, walletId: circleWalletId, address: circleWalletAddress },
+      circleWallet: {
+        apiKey: circleApiKey,
+        entitySecret,
+        walletId: circleWalletId,
+        address: circleWalletAddress,
+        // V4.7 (H-03): the SDK now requires this and cross-checks it against
+        // `network` at construction time - the two must agree, or the
+        // constructor throws instead of silently trusting a mismatched
+        // wallet config. Derived from the same `network` this server was
+        // configured for, not a separate env var, so there's nothing new to
+        // misconfigure here.
+        chainId: resolveNetwork(network).chainId
+      },
       rpcUrl
     });
   }

package/dist/tools.js

@@ -1,6 +1,6 @@
 import {
   createMcpServer
-} from "./chunk-3Z4VDWWC.js";
+} from "./chunk-7ZAUEU5D.js";
 export {
   createMcpServer
 };

package/package.json

@@ -1,68 +1,68 @@
-{
-  "name": "arcbounty-mcp",
-  "version": "0.3.9",
-  "mcpName": "io.github.Sofiia7/arcbounty-mcp",
-  "description": "Put an AI agent to work for USDC. MCP server for a live on-chain bounty board where agents and humans take the same jobs: browsing needs no credentials, and with a signing key the agent takes a job, submits the work, and is paid into its own wallet through canonical ERC-8183 escrow, earning ERC-8004 on-chain reputation for every completed job. One package, two networks: Arc (ArcBounty) and Base (BaseBounty).",
-  "type": "module",
-  "bin": {
-    "arcbounty-mcp": "dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "files": [
-    "dist",
-    "README.md",
-    ".env.example"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Sofiia7/ARC.git",
-    "directory": "mcp-server"
-  },
-  "homepage": "https://arcbounty.app",
-  "bugs": {
-    "url": "https://github.com/Sofiia7/ARC/issues"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts src/tools.ts --format esm --dts --clean",
-    "dev": "tsx src/index.ts",
-    "typecheck": "tsc --noEmit",
-    "start": "node dist/index.js",
-    "pack:mcpb": "npm run build && node sync-manifests.mjs && rm -rf build-mcpb && mkdir -p build-mcpb/server && cp manifest.json build-mcpb/ && cp -r dist build-mcpb/server/ && cp package.json build-mcpb/server/ && npm install --omit=dev --no-package-lock --prefix build-mcpb/server && npx @anthropic-ai/mcpb pack build-mcpb arcbounty-mcp.mcpb && node patch-mcpb.mjs arcbounty-mcp.mcpb manifest.smithery.json arcbounty-mcp-smithery.mcpb",
-    "sync:manifests": "node sync-manifests.mjs"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "arc",
-    "bounty",
-    "erc-8183",
-    "erc-8004",
-    "ai-agent",
-    "agent-payments",
-    "autonomous-agents",
-    "usdc",
-    "x402",
-    "base",
-    "basebounty",
-    "arcbounty"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "arcbounty-agent-sdk": "^0.6.8",
-    "viem": "^2.0.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.6.0",
-    "tsup": "^8.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.0.0"
-  },
-  "exports": {
-    ".": "./dist/index.js",
-    "./server": "./dist/tools.js",
-    "./dist/*": "./dist/*",
-    "./package.json": "./package.json"
-  }
-}
+{
+  "name": "arcbounty-mcp",
+  "version": "0.4.0",
+  "mcpName": "io.github.Sofiia7/arcbounty-mcp",
+  "description": "Put an AI agent to work for USDC. MCP server for a live on-chain bounty board where agents and humans take the same jobs: browsing needs no credentials, and with a signing key the agent takes a job, submits the work, and is paid into its own wallet through canonical ERC-8183 escrow, earning ERC-8004 on-chain reputation for every completed job. One package, two networks: Arc (ArcBounty) and Base (BaseBounty).",
+  "type": "module",
+  "bin": {
+    "arcbounty-mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Sofiia7/ARC.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://arcbounty.app",
+  "bugs": {
+    "url": "https://github.com/Sofiia7/ARC/issues"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/tools.ts --format esm --dts --clean",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "pack:mcpb": "npm run build && node sync-manifests.mjs && rm -rf build-mcpb && mkdir -p build-mcpb/server && cp manifest.json build-mcpb/ && cp -r dist build-mcpb/server/ && cp package.json build-mcpb/server/ && npm install --omit=dev --no-package-lock --prefix build-mcpb/server && npx @anthropic-ai/mcpb pack build-mcpb arcbounty-mcp.mcpb && node patch-mcpb.mjs arcbounty-mcp.mcpb manifest.smithery.json arcbounty-mcp-smithery.mcpb",
+    "sync:manifests": "node sync-manifests.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "arc",
+    "bounty",
+    "erc-8183",
+    "erc-8004",
+    "ai-agent",
+    "agent-payments",
+    "autonomous-agents",
+    "usdc",
+    "x402",
+    "base",
+    "basebounty",
+    "arcbounty"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "arcbounty-agent-sdk": "^0.7.0",
+    "viem": "^2.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./server": "./dist/tools.js",
+    "./dist/*": "./dist/*",
+    "./package.json": "./package.json"
+  }
+}