@aibtc/mcp-server 1.70.0 → 1.70.1

package/dist/tools/skill-mappings.js

@@ -225,8 +225,6 @@ export const TOOL_SKILL_MAP = {
     taproot_verify_cosig: "ordinals-p2p",
     taproot_multisig_guide: "ordinals-p2p",
     // identity skill — ERC-8004 on-chain agent identity
-    register_identity: "identity",
-    get_identity: "identity",
     identity_get_last_id: "identity",
     identity_get: "identity",
     identity_get_metadata: "identity",
@@ -238,12 +236,7 @@ export const TOOL_SKILL_MAP = {
     identity_unset_wallet: "identity",
     identity_transfer: "identity",
     // reputation skill — ERC-8004 on-chain agent reputation
-    give_feedback: "reputation",
-    get_reputation: "reputation",
     // validation skill — ERC-8004 on-chain agent validation
-    request_validation: "validation",
-    get_validation_status: "validation",
-    get_validation_summary: "validation",
     // stackspot skill — stacking lottery pots
     stackspot_list_pots: "stackspot",
     stackspot_get_pot_state: "stackspot",

package/dist/utils/bip322.d.ts

@@ -7,9 +7,8 @@
  *
  * Spec: https://github.com/bitcoin/bips/blob/master/bip-0322.mediawiki
  *
- * These primitives are shared across:
- * - src/tools/signing.tools.ts (btc_sign_message / btc_verify_message)
- * - src/tools/news.tools.ts (news_file_signal auth headers)
+ * Used by src/tools/signing.tools.ts (btc_sign_message / btc_verify_message)
+ * and the BIP-322-authenticated aibtc.com tools.
  */
 /**
  * BIP-322 tagged hash: SHA256(SHA256(tag) || SHA256(tag) || msg)

package/dist/utils/bip322.js

@@ -7,9 +7,8 @@
  *
  * Spec: https://github.com/bitcoin/bips/blob/master/bip-0322.mediawiki
  *
- * These primitives are shared across:
- * - src/tools/signing.tools.ts (btc_sign_message / btc_verify_message)
- * - src/tools/news.tools.ts (news_file_signal auth headers)
+ * Used by src/tools/signing.tools.ts (btc_sign_message / btc_verify_message)
+ * and the BIP-322-authenticated aibtc.com tools.
  */
 import { Transaction, Script, RawWitness, RawTx, } from "@scure/btc-signer";
 import { hashSha256Sync } from "@stacks/encryption";

package/dist/utils/erc8004-helpers.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared helpers for ERC-8004 tool files.
  *
- * Extracted to avoid duplication between erc8004.tools.ts and reputation.tools.ts.
+ * Shared by identity.tools.ts and reputation.tools.ts.
  */
 /** Default read-only caller address per network (boot addresses) */
 export declare const DEFAULT_CALLER: Record<string, string>;

package/dist/utils/erc8004-helpers.js

@@ -1,7 +1,7 @@
 /**
  * Shared helpers for ERC-8004 tool files.
  *
- * Extracted to avoid duplication between erc8004.tools.ts and reputation.tools.ts.
+ * Shared by identity.tools.ts and reputation.tools.ts.
  */
 import { NETWORK } from "../config/networks.js";
 import { getWalletManager } from "../services/wallet-manager.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.70.0",
+  "version": "1.70.1",
   "description": "Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.",
   "mcpName": "io.github.aibtcdev/mcp-server",
   "type": "module",
@@ -24,7 +24,7 @@
     "skill"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22"
   },
   "keywords": [
     "claude",

package/skill/SKILL.md

@@ -4,7 +4,7 @@ description: Bitcoin L1 wallet for agents - check balances, send BTC, manage UTX
 license: MIT
 metadata:
   author: aibtcdev
-  version: 1.70.0 # x-release-please-version
+  version: 1.70.1 # x-release-please-version
   npm: "@aibtc/mcp-server"
   github: https://github.com/aibtcdev/aibtc-mcp-server
 ---
@@ -283,8 +283,8 @@ Agent identity and reputation on Bitcoin and Stacks:
 - L0: Local agent key generation
 - L1: Dual-chain plain-message signatures (btc_sign_message + stacks_sign_message)
 - L2: X claim + BTC airdrop activation
-- L3: On-chain identity registration via ERC-8004 (register_identity)
-- L4: Reputation bootstrapping (get_reputation, give_feedback)
+- L3: On-chain identity registration via ERC-8004 (identity_register)
+- L4: Reputation bootstrapping (reputation_get_summary, reputation_give_feedback)
 - Active: 5-minute check-ins to maintain reputation and liveness
 
 See: [references/genesis-lifecycle.md](references/genesis-lifecycle.md)

package/skill/references/genesis-lifecycle.md

@@ -20,8 +20,8 @@ Each level unlocks new capabilities and demonstrates increasing commitment to th
 | L0 | Unverified | Create wallet with `wallet_create` | Local (~/.aibtc/) |
 | L1 | Registered | Dual-chain signatures verified | aibtc.com KV |
 | L2 | Genesis | X claim verified + BTC airdrop | KV + Bitcoin chain |
-| L3 | On-Chain Identity | ERC-8004 registration via `register_identity` | Stacks blockchain |
-| L4 | Reputation | Initial reputation established via `give_feedback` | Stacks blockchain |
+| L3 | On-Chain Identity | ERC-8004 registration via `identity_register` | Stacks blockchain |
+| L4 | Reputation | Initial reputation established via `reputation_give_feedback` | Stacks blockchain |
 | Active | - | Regular heartbeats to `/api/heartbeat` | KV (lastActive, checkInCount) |
 
 ## L0 → L1: Registration
@@ -163,13 +163,13 @@ Once an agent reaches L2 Genesis, it can register a permanent on-chain identity
 ```
 "Register my agent identity on-chain"
 ```
-Uses `register_identity` - writes the agent's Bitcoin and Stacks addresses to a Stacks smart contract implementing ERC-8004. Returns a transaction ID.
+Uses `identity_register` - writes the agent's Bitcoin and Stacks addresses to a Stacks smart contract implementing ERC-8004. Returns a transaction ID.
 
 2. **Verify registration**:
 ```
 "Get my on-chain identity info"
 ```
-Uses `get_identity` - reads the registered identity from the Stacks blockchain. Confirms the agent address is on-chain.
+Uses `identity_get` - reads the registered identity from the Stacks blockchain. Confirms the agent address is on-chain.
 
 3. **Check transaction status**:
 ```
@@ -181,8 +181,8 @@ Uses `get_transaction_status` - confirms the registration transaction was includ
 
 | Tool | Description |
 |------|-------------|
-| `register_identity` | Register agent identity on Stacks blockchain |
-| `get_identity` | Read registered identity for an address |
+| `identity_register` | Register agent identity on Stacks blockchain |
+| `identity_get` | Read registered identity for an address |
 
 ## L3 → L4: Reputation Bootstrapping
 
@@ -199,36 +199,21 @@ After on-chain identity registration, agents can establish a reputation record.
 ```
 "What's my current reputation score?"
 ```
-Uses `get_reputation` - returns current score, feedback count, and summary. New agents start at a neutral baseline.
+Uses `reputation_get_summary` - returns current score, feedback count, and summary. New agents start at a neutral baseline.
 
 2. **Give feedback to bootstrap ecosystem reputation**:
 ```
 "Submit positive feedback for agent SP1..."
 "Rate my interaction with the x402 inference service"
 ```
-Uses `give_feedback` - submits a signed reputation signal for another agent or service. Participation in the reputation system boosts your own visibility in the AX discovery chain.
-
-3. **Request validation** (optional):
-```
-"Request validation for my agent"
-```
-Uses `request_validation` - asks the aibtc.com platform to validate agent behavior. Approved validations increase reputation score.
-
-4. **Check validation status**:
-```
-"What's the status of my validation request?"
-```
-Uses `get_validation_status` - returns pending, approved, or rejected status.
+Uses `reputation_give_feedback` - submits a signed reputation signal for another agent or service. Participation in the reputation system boosts your own visibility in the AX discovery chain.
 
 ### Reputation Tool Reference
 
 | Tool | Description |
 |------|-------------|
-| `get_reputation` | Get reputation score and summary |
-| `give_feedback` | Submit reputation signal for another agent |
-| `request_validation` | Request platform validation |
-| `get_validation_status` | Check validation request status |
-| `get_validation_summary` | Get full validation history |
+| `reputation_get_summary` | Get reputation score and summary |
+| `reputation_give_feedback` | Submit reputation signal for another agent |
 
 ## L4 → Active: Liveness & Inbox
 
@@ -354,8 +339,8 @@ the 100-sat sBTC x402 payment and settles it directly. See
 | Create wallet | `wallet_create`, `wallet_import` |
 | L0 → L1 Registration | `get_wallet_info`, `btc_sign_message`, `stacks_sign_message` |
 | L1 → L2 Genesis | External (X post + admin verification) |
-| L2 → L3 On-Chain Identity | `register_identity`, `get_identity`, `get_transaction_status` |
-| L3 → L4 Reputation | `get_reputation`, `give_feedback`, `request_validation` |
+| L2 → L3 On-Chain Identity | `identity_register`, `identity_get`, `get_transaction_status` |
+| L3 → L4 Reputation | `reputation_get_summary`, `reputation_give_feedback` |
 | Heartbeat loop | `btc_sign_message` |
 | Inbox reply | `btc_sign_message` |
 | Inbox send (pay a peer) | `send_inbox_message_direct` |
@@ -396,7 +381,7 @@ Agent: "Check my BTC balance"
 ### 4. Register On-Chain Identity (L2 → L3)
 ```
 Agent: "Register my agent identity on-chain"
-→ register_identity
+→ identity_register
 → Result: txid: "0x1a2b3c...", pending confirmation
 
 Agent: "Check the status of transaction 0x1a2b3c..."
@@ -404,22 +389,22 @@ Agent: "Check the status of transaction 0x1a2b3c..."
 → Result: status: confirmed, block_height: 150000
 
 Agent: "Get my on-chain identity info"
-→ get_identity
+→ identity_get
 → Result: btcAddress: bc1q..., stxAddress: SP..., registered: true, level = L3
 ```
 
 ### 5. Bootstrap Reputation (L3 → L4)
 ```
 Agent: "What's my current reputation score?"
-→ get_reputation
+→ reputation_get_summary
 → Result: score: 0, feedbackCount: 0, status: "new"
 
 Agent: "Submit positive feedback for the x402 inference service SP1..."
-→ give_feedback
+→ reputation_give_feedback
 → Result: txid: "0x2c3d4e...", feedback recorded
 
 Agent: "What's my reputation score now?"
-→ get_reputation
+→ reputation_get_summary
 → Result: score: 1, feedbackCount: 1, status: "active", level = L4
 ```
 

package/skill/references/pillar-wallet.md

@@ -206,7 +206,7 @@ Uses `pillar_unwind` - repays borrowed sBTC and withdraws collateral.
 
 - [Pillar Website](https://pillarbtc.com)
 - [Twitter @pillar_btc](https://x.com/pillar_btc)
-- [CLAUDE.md Pillar Section](../../CLAUDE.md#pillar-smart-wallet)
+- [Pillar tool reference](../../docs/TOOLS.md)
 
 ---
 

package/dist/tools/erc8004.tools.d.ts

@@ -1,21 +0,0 @@
-/**
- * ERC-8004 Identity and Reputation Tools
- *
- * These tools provide on-chain agent identity and reputation management:
- *
- * Identity Tools:
- * - register_identity: Register new agent identity on-chain
- * - get_identity: Get agent identity info (owner, URI, wallet)
- *
- * Reputation Tools:
- * - give_feedback: Submit feedback for an agent
- * - get_reputation: Get aggregated reputation score
- *
- * Validation Tools:
- * - request_validation: Request third-party validation
- * - get_validation_status: Check validation request status
- * - get_validation_summary: Get validation summary for agent
- */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerErc8004Tools(server: McpServer): void;
-//# sourceMappingURL=erc8004.tools.d.ts.map

package/dist/tools/erc8004.tools.js

@@ -1,329 +0,0 @@
-/**
- * ERC-8004 Identity and Reputation Tools
- *
- * These tools provide on-chain agent identity and reputation management:
- *
- * Identity Tools:
- * - register_identity: Register new agent identity on-chain
- * - get_identity: Get agent identity info (owner, URI, wallet)
- *
- * Reputation Tools:
- * - give_feedback: Submit feedback for an agent
- * - get_reputation: Get aggregated reputation score
- *
- * Validation Tools:
- * - request_validation: Request third-party validation
- * - get_validation_status: Check validation request status
- * - get_validation_summary: Get validation summary for agent
- */
-import { z } from "zod";
-import { NETWORK, getExplorerTxUrl } from "../config/networks.js";
-import { createJsonResponse, createErrorResponse } from "../utils/index.js";
-import { getWalletManager } from "../services/wallet-manager.js";
-import { Erc8004Service } from "../services/erc8004.service.js";
-import { resolveFee } from "../utils/fee.js";
-import { sponsoredSchema } from "./schemas.js";
-import { normalizeHex, getCallerAddress } from "../utils/erc8004-helpers.js";
-const MAX_METADATA_KEY_LENGTH = 128;
-const MAX_METADATA_VALUE_BYTES = 512;
-export function registerErc8004Tools(server) {
-    const service = new Erc8004Service(NETWORK);
-    // ==========================================================================
-    // Identity Tools
-    // ==========================================================================
-    // Register identity
-    server.registerTool("register_identity", {
-        description: "Register a new agent identity on-chain using ERC-8004 identity registry. " +
-            "Returns a transaction ID. Check the transaction result to get the assigned agent ID. " +
-            "Requires an unlocked wallet.",
-        inputSchema: {
-            uri: z
-                .string()
-                .optional()
-                .describe("URI pointing to agent metadata (IPFS, HTTP, etc.). Optional."),
-            metadata: z
-                .array(z.object({
-                key: z.string().max(MAX_METADATA_KEY_LENGTH).describe("Metadata key (max 128 chars)"),
-                value: z.string().describe("Metadata value as hex string (max 512 bytes)"),
-            }))
-                .optional()
-                .describe("Array of metadata key-value pairs. Values must be hex-encoded buffers. Optional."),
-            fee: z
-                .string()
-                .optional()
-                .describe('Fee preset ("low", "medium", "high") or micro-STX amount. Optional.'),
-            sponsored: sponsoredSchema,
-        },
-    }, async ({ uri, metadata, fee, sponsored }) => {
-        try {
-            const walletManager = getWalletManager();
-            const account = walletManager.getActiveAccount();
-            if (!account) {
-                throw new Error("No active wallet. Please unlock your wallet first.");
-            }
-            // Parse metadata if provided
-            let parsedMetadata;
-            if (metadata && metadata.length > 0) {
-                parsedMetadata = metadata.map((m) => {
-                    const normalized = normalizeHex(m.value, `metadata value for key "${m.key}"`);
-                    const buf = Buffer.from(normalized, "hex");
-                    if (buf.length > MAX_METADATA_VALUE_BYTES) {
-                        throw new Error(`metadata value for key "${m.key}" exceeds ${MAX_METADATA_VALUE_BYTES} bytes (got ${buf.length})`);
-                    }
-                    return { key: m.key, value: buf };
-                });
-            }
-            const feeAmount = fee ? await resolveFee(fee, NETWORK, "contract_call") : undefined;
-            const result = await service.registerIdentity(account, uri, parsedMetadata, feeAmount, sponsored);
-            return createJsonResponse({
-                success: true,
-                txid: result.txid,
-                message: "Identity registration transaction submitted. " +
-                    "Check transaction result to get your agent ID.",
-                network: NETWORK,
-                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
-            });
-        }
-        catch (error) {
-            return createErrorResponse(error);
-        }
-    });
-    // Get identity
-    server.registerTool("get_identity", {
-        description: "Get agent identity information from ERC-8004 identity registry. " +
-            "Returns owner address, URI, and wallet address if set.",
-        inputSchema: {
-            agentId: z.number().int().min(0).describe("Agent ID to look up"),
-        },
-    }, async ({ agentId }) => {
-        try {
-            const callerAddress = getCallerAddress();
-            const identity = await service.getIdentity(agentId, callerAddress);
-            if (!identity) {
-                return createJsonResponse({
-                    success: false,
-                    agentId,
-                    message: "Agent ID not found",
-                });
-            }
-            return createJsonResponse({
-                success: true,
-                agentId: identity.agentId,
-                owner: identity.owner,
-                uri: identity.uri || "(no URI set)",
-                wallet: identity.wallet || "(no wallet set)",
-                network: NETWORK,
-            });
-        }
-        catch (error) {
-            return createErrorResponse(error);
-        }
-    });
-    // ==========================================================================
-    // Reputation Tools
-    // ==========================================================================
-    // Give feedback
-    server.registerTool("give_feedback", {
-        description: "Submit feedback for an agent using ERC-8004 reputation registry. " +
-            "Value is normalized to 18 decimals (WAD) internally for aggregation. " +
-            "Requires an unlocked wallet.",
-        inputSchema: {
-            agentId: z.number().int().min(0).describe("Agent ID to give feedback for"),
-            value: z
-                .number()
-                .int()
-                .min(0)
-                .describe("Feedback value (e.g., 5 for 5-star rating)"),
-            decimals: z
-                .number()
-                .int()
-                .min(0)
-                .max(18)
-                .describe("Decimals for the value (e.g., 0 for integer ratings)"),
-            tag1: z.string().optional().describe("Optional tag 1 (max 64 chars)"),
-            tag2: z.string().optional().describe("Optional tag 2 (max 64 chars)"),
-            endpoint: z.string().optional().describe("Optional endpoint URL"),
-            feedbackUri: z.string().optional().describe("Optional feedback URI"),
-            feedbackHash: z
-                .string()
-                .optional()
-                .describe("Optional feedback hash as hex string (32 bytes)"),
-            fee: z
-                .string()
-                .optional()
-                .describe('Fee preset ("low", "medium", "high") or micro-STX amount. Optional.'),
-            sponsored: sponsoredSchema,
-        },
-    }, async ({ agentId, value, decimals, tag1, tag2, endpoint, feedbackUri, feedbackHash, fee, sponsored }) => {
-        try {
-            const walletManager = getWalletManager();
-            const account = walletManager.getActiveAccount();
-            if (!account) {
-                throw new Error("No active wallet. Please unlock your wallet first.");
-            }
-            const hashBuffer = feedbackHash
-                ? Buffer.from(normalizeHex(feedbackHash, "feedbackHash", 32), "hex")
-                : undefined;
-            const feeAmount = fee ? await resolveFee(fee, NETWORK, "contract_call") : undefined;
-            const result = await service.giveFeedback(account, agentId, value, decimals, tag1, tag2, endpoint, feedbackUri, hashBuffer, feeAmount, sponsored);
-            return createJsonResponse({
-                success: true,
-                txid: result.txid,
-                message: "Feedback submitted successfully",
-                agentId,
-                value,
-                decimals,
-                network: NETWORK,
-                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
-            });
-        }
-        catch (error) {
-            return createErrorResponse(error);
-        }
-    });
-    // Get reputation
-    server.registerTool("get_reputation", {
-        description: "Get aggregated reputation summary for an agent from ERC-8004 reputation registry. " +
-            "Returns average rating as a raw WAD string (18 decimals) and total feedback count.",
-        inputSchema: {
-            agentId: z.number().int().min(0).describe("Agent ID to get reputation for"),
-        },
-    }, async ({ agentId }) => {
-        try {
-            const callerAddress = getCallerAddress();
-            const reputation = await service.getReputation(agentId, callerAddress);
-            if (reputation.totalFeedback === 0) {
-                return createJsonResponse({
-                    success: true,
-                    agentId,
-                    totalFeedback: 0,
-                    summaryValue: "0",
-                    summaryValueDecimals: 0,
-                    message: "No feedback yet for this agent",
-                    network: NETWORK,
-                });
-            }
-            return createJsonResponse({
-                success: true,
-                agentId: reputation.agentId,
-                totalFeedback: reputation.totalFeedback,
-                summaryValue: reputation.summaryValue,
-                summaryValueDecimals: reputation.summaryValueDecimals,
-                network: NETWORK,
-            });
-        }
-        catch (error) {
-            return createErrorResponse(error);
-        }
-    });
-    // ==========================================================================
-    // Validation Tools
-    // ==========================================================================
-    // Request validation
-    server.registerTool("request_validation", {
-        description: "Request third-party validation for an agent using ERC-8004 validation registry. " +
-            "The validator will be notified and can respond with a 0-100 score. " +
-            "Requires an unlocked wallet and must be called by agent owner or approved operator.",
-        inputSchema: {
-            validator: z.string().describe("Stacks address of the validator"),
-            agentId: z.number().int().min(0).describe("Agent ID to request validation for"),
-            requestUri: z.string().describe("URI with validation request details"),
-            requestHash: z.string().describe("Unique request hash as hex string (32 bytes)"),
-            fee: z
-                .string()
-                .optional()
-                .describe('Fee preset ("low", "medium", "high") or micro-STX amount. Optional.'),
-            sponsored: sponsoredSchema,
-        },
-    }, async ({ validator, agentId, requestUri, requestHash, fee, sponsored }) => {
-        try {
-            const walletManager = getWalletManager();
-            const account = walletManager.getActiveAccount();
-            if (!account) {
-                throw new Error("No active wallet. Please unlock your wallet first.");
-            }
-            const normalizedHash = normalizeHex(requestHash, "requestHash", 32);
-            const hashBuffer = Buffer.from(normalizedHash, "hex");
-            const feeAmount = fee ? await resolveFee(fee, NETWORK, "contract_call") : undefined;
-            const result = await service.requestValidation(account, validator, agentId, requestUri, hashBuffer, feeAmount, sponsored);
-            return createJsonResponse({
-                success: true,
-                txid: result.txid,
-                message: "Validation request submitted successfully",
-                validator,
-                agentId,
-                requestHash,
-                network: NETWORK,
-                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
-            });
-        }
-        catch (error) {
-            return createErrorResponse(error);
-        }
-    });
-    // Get validation status
-    server.registerTool("get_validation_status", {
-        description: "Get the status of a validation request using ERC-8004 validation registry. " +
-            "Returns validator, agent ID, response score (0-100), and response metadata.",
-        inputSchema: {
-            requestHash: z.string().describe("Request hash as hex string (32 bytes)"),
-        },
-    }, async ({ requestHash }) => {
-        try {
-            const callerAddress = getCallerAddress();
-            const normalizedHash = normalizeHex(requestHash, "requestHash", 32);
-            const hashBuffer = Buffer.from(normalizedHash, "hex");
-            const status = await service.getValidationStatus(hashBuffer, callerAddress);
-            if (!status) {
-                return createJsonResponse({
-                    success: false,
-                    requestHash,
-                    message: "Validation request not found",
-                    network: NETWORK,
-                });
-            }
-            return createJsonResponse({
-                success: true,
-                requestHash,
-                validator: status.validator,
-                agentId: status.agentId,
-                response: status.response,
-                responseHash: status.responseHash,
-                tag: status.tag || "(no tag)",
-                lastUpdate: status.lastUpdate,
-                hasResponse: status.hasResponse,
-                network: NETWORK,
-            });
-        }
-        catch (error) {
-            return createErrorResponse(error);
-        }
-    });
-    // Get validation summary
-    server.registerTool("get_validation_summary", {
-        description: "Get validation summary for an agent using ERC-8004 validation registry. " +
-            "Returns total validation count and average response score (0-100).",
-        inputSchema: {
-            agentId: z.number().int().min(0).describe("Agent ID to get validation summary for"),
-        },
-    }, async ({ agentId }) => {
-        try {
-            const callerAddress = getCallerAddress();
-            const summary = await service.getValidationSummary(agentId, callerAddress);
-            return createJsonResponse({
-                success: true,
-                agentId,
-                count: summary.count,
-                averageResponse: summary.avgResponse,
-                message: summary.count === 0
-                    ? "No validations yet for this agent"
-                    : `${summary.count} validation(s) with average score ${summary.avgResponse}/100`,
-                network: NETWORK,
-            });
-        }
-        catch (error) {
-            return createErrorResponse(error);
-        }
-    });
-}
-//# sourceMappingURL=erc8004.tools.js.map