@aibtc/mcp-server 1.53.0 → 1.55.0

package/dist/tools/bounty-scanner.tools.d.ts

@@ -1,28 +1,39 @@
 /**
- * Bounty Scanner Tools
+ * Bounty Tools — native aibtc.com/api/bounties
  *
- * Tools for interacting with the bounty.drx4.xyz sBTC bounty board.
- * Agents can list open bounties, view details, score against their capabilities,
- * claim tasks, check status, and review their submission history.
+ * First-party bounty board on aibtc.com. Replaces the prior bounty.drx4.xyz proxy
+ * (issue #524). Status is derived from timestamps at response time, not stored:
  *
- * Read-only tools (no auth required):
- * - bounty_list       — List bounties with optional filters
- * - bounty_get        — Full detail for a single bounty by ID
- * - bounty_match      — Score open bounties against agent capability tags
- * - bounty_status     — Check claim/submission status for a bounty
- * - bounty_my_claims  — List all claims/submissions for current wallet
- * - bounty_stats      — Platform aggregate stats
+ *   open → judging → winner-announced → paid (terminal)
+ *                  ↘ cancelled / abandoned (terminal)
  *
- * Authenticated tool (requires unlocked wallet with bc1q address):
- * - bounty_claim      — Claim a bounty (BIP-322 signed)
+ * Read tools (no auth):
+ * - bounty_list         — list with filters (status, poster, submitter, tag)
+ * - bounty_get          — detail with winner block + payment hint
+ * - bounty_submissions  — paginated submissions for a bounty
  *
- * Authentication: BIP-322 simple signature (P2WPKH, bc1q addresses preferred).
- * Message format: "agent-bounties | {action} | {btc_address} | {resource} | {timestamp}"
- * Headers: X-BTC-Address, X-Signature, X-Timestamp
+ * Signed write tools (BIP-322 over P2WPKH, embedded in request body):
+ * - bounty_create  — poster posts a bounty (Genesis L2+)
+ * - bounty_submit  — submitter posts work (Registered L1+)
+ * - bounty_accept  — poster picks a winner
+ * - bounty_paid    — poster proves payment with a confirmed sBTC txid
+ * - bounty_cancel  — poster cancels before any acceptance
  *
- * Status flow: open → claimed → submitted → approved → paid (or cancelled)
+ * Convenience views (read-only, default to current wallet's bc1q address):
+ * - bounty_my_posted       — bounties this wallet has posted
+ * - bounty_my_submissions  — bounties this wallet has submitted to
  *
- * Reference: https://bounty.drx4.xyz/api
+ * Signed-message format (no hashing — fields are inlined with " | "):
+ *   AIBTC Bounty Create | {posterBtc} | {title} | {description} | {rewardSats} | {expiresAt} | {tagsCommaJoined} | {signedAt}
+ *   AIBTC Bounty Submit | {bountyId} | {submitterBtc} | {message} | {contentUrl} | {signedAt}
+ *   AIBTC Bounty Accept | {bountyId} | {submissionId} | {signedAt}
+ *   AIBTC Bounty Paid   | {bountyId} | {txid} | {signedAt}
+ *   AIBTC Bounty Cancel | {bountyId} | {signedAt}
+ *
+ * `tagsCommaJoined` is `tags.join(",")` or `""` when no tags. `contentUrl` is `""`
+ * when omitted. `signedAt` is ISO 8601 within ±5 minutes of server time.
+ *
+ * Reference: https://aibtc.com/docs/bounties.txt, https://aibtc.com/api/openapi.json
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare function registerBountyScannerTools(server: McpServer): void;

package/dist/tools/bounty-scanner.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounty-scanner.tools.d.ts","sourceRoot":"","sources":["../../src/tools/bounty-scanner.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkEpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAselE"}
+{"version":3,"file":"bounty-scanner.tools.d.ts","sourceRoot":"","sources":["../../src/tools/bounty-scanner.tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6GpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4alE"}