@aibtc/mcp-server 1.70.1 → 1.71.0

package/README.md

@@ -15,7 +15,7 @@ Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg,
 - **Token Operations** - SIP-010 fungible token transfers and queries
 - **NFT Support** - SIP-009 NFT holdings, transfers, and metadata
 - **DeFi Trading** - ALEX DEX swaps and Zest Protocol lending/borrowing
-- **Stacking/PoX** - Stacking status and delegation
+- **Stacking/PoX-5** - Stake STX with a signer manager, extend, unstake, claim sBTC rewards
 - **BNS Domains** - .btc domain lookups and management (V1 + V2)
 - **x402 Payments** - Automatic payment handling for paid APIs
 
@@ -386,10 +386,14 @@ Both addresses are derived from the same recovery phrase, making it easy to mana
 ### Stacking / PoX
 | Tool | Description |
 |------|-------------|
-| `get_pox_info` | Get current PoX cycle info |
-| `get_stacking_status` | Check stacking status |
-| `stack_stx` | Lock STX for stacking |
-| `extend_stacking` | Extend stacking period |
+| `get_pox_info` | Current PoX-5 cycle, burn height, prepare phase |
+| `get_stacking_status` | Locked amount, signer manager, unlock height |
+| `list_stacking_signers` | Signer managers in the next cycle's signer set |
+| `stack_stx` | Lock STX with a signer manager |
+| `extend_stacking` | Extend, increase, switch signer or payout (stake-update) |
+| `unstake_stx` | Stop early; unlocks next cycle |
+| `get_stacking_rewards` | Unclaimed sBTC rewards for a cycle |
+| `claim_stacking_rewards` | Claim a cycle's rewards through the signer manager |
 
 ### BNS Domains (V1 + V2)
 | Tool | Description |

package/dist/bridge/index.js

@@ -29,7 +29,7 @@
  */
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { ALL_ENDPOINTS } from "../endpoints/registry.js";
+import { STATIC_ENDPOINTS } from "../endpoints/registry.js";
 const OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";
 const DEFAULT_MODEL = "anthropic/claude-3.5-haiku";
 /**
@@ -154,7 +154,7 @@ function printSafetyReceipt(opts, exposed, totalTools) {
         `  write_tool_count=${writeToolCount}`,
         `  blocked_tool_count=${opts.block.size}`,
         `  session_spend_cap=${opts.maxSpendUstx ?? "default"} uSTX / ${opts.maxSpendSats ?? "default"} sats`,
-        `  x402_endpoints_known=${ALL_ENDPOINTS.length}`,
+        `  x402_static_endpoints=${STATIC_ENDPOINTS.length}`,
         "  (reports configured execution boundaries only; no value has moved)",
     ];
     console.error(lines.join("\n"));

package/dist/config/contracts.d.ts

@@ -9,7 +9,7 @@ export declare const MAINNET_CONTRACTS: {
     readonly SBTC_WITHDRAWAL: "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-withdrawal";
     readonly USDCX: "SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx";
     readonly BNS: "SP000000000000000000002Q6VF78.bns";
-    readonly POX_4: "SP000000000000000000002Q6VF78.pox-4";
+    readonly POX_5: "SP000000000000000000002Q6VF78.pox-5";
     readonly ALEX_AMM_POOL: "SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.amm-swap-pool-v1-1";
     readonly ALEX_TOKEN: "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex";
     readonly ALEX_WSTX: "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wstx-v2";
@@ -57,7 +57,7 @@ export declare const TESTNET_CONTRACTS: {
     readonly SBTC_WITHDRAWAL: "ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-withdrawal";
     readonly USDCX: "ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.usdcx";
     readonly BNS: "ST000000000000000000002AMW42H.bns";
-    readonly POX_4: "ST000000000000000000002AMW42H.pox-4";
+    readonly POX_5: "ST000000000000000000002AMW42H.pox-5";
     readonly IDENTITY_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.identity-registry-v2";
     readonly REPUTATION_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.reputation-registry-v2";
     readonly VALIDATION_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.validation-registry-v2";
@@ -72,7 +72,7 @@ export declare function getContracts(network: Network): {
     readonly SBTC_WITHDRAWAL: "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-withdrawal";
     readonly USDCX: "SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx";
     readonly BNS: "SP000000000000000000002Q6VF78.bns";
-    readonly POX_4: "SP000000000000000000002Q6VF78.pox-4";
+    readonly POX_5: "SP000000000000000000002Q6VF78.pox-5";
     readonly ALEX_AMM_POOL: "SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.amm-swap-pool-v1-1";
     readonly ALEX_TOKEN: "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex";
     readonly ALEX_WSTX: "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-wstx-v2";
@@ -96,7 +96,7 @@ export declare function getContracts(network: Network): {
     readonly SBTC_WITHDRAWAL: "ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-withdrawal";
     readonly USDCX: "ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.usdcx";
     readonly BNS: "ST000000000000000000002AMW42H.bns";
-    readonly POX_4: "ST000000000000000000002AMW42H.pox-4";
+    readonly POX_5: "ST000000000000000000002AMW42H.pox-5";
     readonly IDENTITY_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.identity-registry-v2";
     readonly REPUTATION_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.reputation-registry-v2";
     readonly VALIDATION_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.validation-registry-v2";

package/dist/config/contracts.js

@@ -12,7 +12,7 @@ export const MAINNET_CONTRACTS = {
     // BNS
     BNS: "SP000000000000000000002Q6VF78.bns",
     // Stacking
-    POX_4: "SP000000000000000000002Q6VF78.pox-4",
+    POX_5: "SP000000000000000000002Q6VF78.pox-5",
     // ALEX DEX (SDK handles most operations, but we need pool contract for queries)
     ALEX_AMM_POOL: "SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.amm-swap-pool-v1-1",
     ALEX_TOKEN: "SP102V8P0F7JX67ARQ77WEA3D3CFB5XW39REDT0AM.token-alex",
@@ -112,7 +112,7 @@ export const TESTNET_CONTRACTS = {
     // BNS
     BNS: "ST000000000000000000002AMW42H.bns",
     // Stacking
-    POX_4: "ST000000000000000000002AMW42H.pox-4",
+    POX_5: "ST000000000000000000002AMW42H.pox-5",
     // ERC-8004 Identity & Reputation
     IDENTITY_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.identity-registry-v2",
     REPUTATION_REGISTRY: "ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18.reputation-registry-v2",

package/dist/endpoints/registry.d.ts

@@ -1,41 +1,23 @@
 /**
- * Known x402 endpoints registry
- * Endpoints from x402.biwas.xyz, x402.aibtc.com, stx402.com, and aibtc.com
+ * Static x402 endpoint entries for hosts that do not publish an OpenAPI spec.
+ *
+ * x402.aibtc.com and stx402.com publish `openapi.json`, so their endpoints are
+ * discovered live (see services/x402-discovery.service.ts) instead of listed here.
  */
-export type X402Source = "x402.biwas.xyz" | "x402.aibtc.com" | "stx402.com" | "aibtc.com";
+export type StaticX402Source = "x402.biwas.xyz" | "aibtc.com";
 export interface X402Endpoint {
     path: string;
     method: "GET" | "POST" | "PUT" | "DELETE";
     description: string;
     cost: string;
     category: string;
-    source: X402Source;
+    source: string;
     params?: Record<string, string>;
     body?: Record<string, string>;
 }
-export declare const ALL_ENDPOINTS: X402Endpoint[];
-/**
- * Search endpoints by keyword
- */
-export declare function searchEndpoints(query: string): X402Endpoint[];
-/**
- * Get endpoints by source
- */
-export declare function getEndpointsBySource(source: X402Source): X402Endpoint[];
+export declare const STATIC_ENDPOINTS: X402Endpoint[];
 /**
- * Format endpoints for display
+ * Format endpoints for display, grouped by category and source.
  */
 export declare function formatEndpointsTable(endpoints: X402Endpoint[]): string;
-/**
- * Get all unique categories
- */
-export declare function getCategories(): string[];
-/**
- * Lookup an endpoint in the registry by method, path, and source URL.
- * Used to determine if an endpoint is known-FREE or known-PAID before
- * deciding whether to use a payment-capable client.
- *
- * Supports path patterns with placeholders like {address}, {messageId}, etc.
- */
-export declare function lookupEndpoint(method: string, path: string, sourceUrl: string): X402Endpoint | undefined;
 //# sourceMappingURL=registry.d.ts.map