@aibtc/mcp-server 1.0.0

package/dist/utils/storage.js

@@ -0,0 +1,196 @@
+import fs from "fs/promises";
+import { existsSync, renameSync } from "fs";
+import path from "path";
+import os from "os";
+/**
+ * Storage directory location
+ * Migrated from ~/.stx402/ to ~/.aibtc/ in v1.0.0
+ */
+const OLD_STORAGE_DIR = path.join(os.homedir(), ".stx402");
+const STORAGE_DIR = path.join(os.homedir(), ".aibtc");
+const WALLETS_DIR = path.join(STORAGE_DIR, "wallets");
+const WALLET_INDEX_FILE = path.join(STORAGE_DIR, "wallets.json");
+const CONFIG_FILE = path.join(STORAGE_DIR, "config.json");
+/**
+ * Migrate storage from ~/.stx402/ to ~/.aibtc/ (one-time migration)
+ */
+function migrateStorageDirectory() {
+    if (existsSync(OLD_STORAGE_DIR) && !existsSync(STORAGE_DIR)) {
+        try {
+            renameSync(OLD_STORAGE_DIR, STORAGE_DIR);
+            console.error(`Migrated wallet storage from ${OLD_STORAGE_DIR} to ${STORAGE_DIR}`);
+        }
+        catch (error) {
+            console.error(`Failed to migrate storage directory: ${error}`);
+        }
+    }
+}
+// Run migration on module load
+migrateStorageDirectory();
+const CURRENT_INDEX_VERSION = 1;
+const CURRENT_CONFIG_VERSION = 1;
+/**
+ * Get storage directory path
+ */
+export function getStorageDir() {
+    return STORAGE_DIR;
+}
+/**
+ * Check if storage directory exists
+ */
+export async function storageExists() {
+    try {
+        await fs.access(STORAGE_DIR);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize storage directory structure
+ */
+export async function initializeStorage() {
+    // Create directories
+    await fs.mkdir(WALLETS_DIR, { recursive: true, mode: 0o700 });
+    // Create wallet index if it doesn't exist
+    try {
+        await fs.access(WALLET_INDEX_FILE);
+    }
+    catch {
+        const defaultIndex = {
+            version: CURRENT_INDEX_VERSION,
+            wallets: [],
+        };
+        await writeWalletIndex(defaultIndex);
+    }
+    // Create config if it doesn't exist
+    try {
+        await fs.access(CONFIG_FILE);
+    }
+    catch {
+        const defaultConfig = {
+            version: CURRENT_CONFIG_VERSION,
+            activeWalletId: null,
+            autoLockTimeout: 15, // 15 minutes default
+        };
+        await writeAppConfig(defaultConfig);
+    }
+}
+/**
+ * Read wallet index
+ */
+export async function readWalletIndex() {
+    try {
+        const content = await fs.readFile(WALLET_INDEX_FILE, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {
+            version: CURRENT_INDEX_VERSION,
+            wallets: [],
+        };
+    }
+}
+/**
+ * Write wallet index (atomic write with temp file)
+ */
+export async function writeWalletIndex(index) {
+    const tempFile = `${WALLET_INDEX_FILE}.tmp`;
+    await fs.writeFile(tempFile, JSON.stringify(index, null, 2), {
+        mode: 0o600,
+    });
+    await fs.rename(tempFile, WALLET_INDEX_FILE);
+}
+/**
+ * Read app config
+ */
+export async function readAppConfig() {
+    try {
+        const content = await fs.readFile(CONFIG_FILE, "utf8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {
+            version: CURRENT_CONFIG_VERSION,
+            activeWalletId: null,
+            autoLockTimeout: 15,
+        };
+    }
+}
+/**
+ * Write app config (atomic write)
+ */
+export async function writeAppConfig(config) {
+    const tempFile = `${CONFIG_FILE}.tmp`;
+    await fs.writeFile(tempFile, JSON.stringify(config, null, 2), {
+        mode: 0o600,
+    });
+    await fs.rename(tempFile, CONFIG_FILE);
+}
+/**
+ * Get keystore file path for a wallet
+ */
+function getKeystorePath(walletId) {
+    return path.join(WALLETS_DIR, walletId, "keystore.json");
+}
+/**
+ * Read keystore for a wallet
+ */
+export async function readKeystore(walletId) {
+    const keystorePath = getKeystorePath(walletId);
+    const content = await fs.readFile(keystorePath, "utf8");
+    return JSON.parse(content);
+}
+/**
+ * Write keystore for a wallet (creates directory if needed)
+ */
+export async function writeKeystore(walletId, keystore) {
+    const walletDir = path.join(WALLETS_DIR, walletId);
+    await fs.mkdir(walletDir, { recursive: true, mode: 0o700 });
+    const keystorePath = getKeystorePath(walletId);
+    const tempFile = `${keystorePath}.tmp`;
+    await fs.writeFile(tempFile, JSON.stringify(keystore, null, 2), {
+        mode: 0o600,
+    });
+    await fs.rename(tempFile, keystorePath);
+}
+/**
+ * Delete a wallet directory and its contents
+ */
+export async function deleteWalletStorage(walletId) {
+    const walletDir = path.join(WALLETS_DIR, walletId);
+    await fs.rm(walletDir, { recursive: true, force: true });
+}
+/**
+ * Update wallet metadata in index
+ */
+export async function updateWalletMetadata(walletId, updates) {
+    const index = await readWalletIndex();
+    const walletIndex = index.wallets.findIndex((w) => w.id === walletId);
+    if (walletIndex === -1) {
+        throw new Error(`Wallet not found: ${walletId}`);
+    }
+    index.wallets[walletIndex] = {
+        ...index.wallets[walletIndex],
+        ...updates,
+    };
+    await writeWalletIndex(index);
+}
+/**
+ * Add wallet to index
+ */
+export async function addWalletToIndex(wallet) {
+    const index = await readWalletIndex();
+    index.wallets.push(wallet);
+    await writeWalletIndex(index);
+}
+/**
+ * Remove wallet from index
+ */
+export async function removeWalletFromIndex(walletId) {
+    const index = await readWalletIndex();
+    index.wallets = index.wallets.filter((w) => w.id !== walletId);
+    await writeWalletIndex(index);
+}
+//# sourceMappingURL=storage.js.map

package/dist/utils/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"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"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+/**
+ * Validate a Stacks address
+ */
+export declare function isValidStacksAddress(address: string): boolean;
+/**
+ * Validate a contract ID
+ */
+export declare function isValidContractId(contractId: string): boolean;
+/**
+ * Validate a transaction ID
+ */
+export declare function isValidTxId(txid: string): boolean;
+/**
+ * Zod schema for Stacks address
+ */
+export declare const stacksAddressSchema: z.ZodString;
+/**
+ * Zod schema for contract ID
+ */
+export declare const contractIdSchema: z.ZodString;
+/**
+ * Zod schema for transaction ID
+ */
+export declare const txIdSchema: z.ZodString;
+/**
+ * Zod schema for STX amount (micro-STX as string)
+ */
+export declare const stxAmountSchema: z.ZodString;
+/**
+ * Zod schema for network
+ */
+export declare const networkSchema: z.ZodEnum<{
+    mainnet: "mainnet";
+    testnet: "testnet";
+}>;
+/**
+ * Zod schema for HTTP method
+ */
+export declare const httpMethodSchema: z.ZodEnum<{
+    POST: "POST";
+    GET: "GET";
+    DELETE: "DELETE";
+    PUT: "PUT";
+}>;
+/**
+ * Zod schema for post condition mode
+ */
+export declare const postConditionModeSchema: z.ZodEnum<{
+    allow: "allow";
+    deny: "deny";
+}>;
+/**
+ * Common input schemas for tools
+ */
+export declare const commonSchemas: {
+    address: z.ZodString;
+    optionalAddress: z.ZodOptional<z.ZodString>;
+    contractId: z.ZodString;
+    txid: z.ZodString;
+    amount: z.ZodString;
+    tokenAmount: z.ZodString;
+    memo: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAG/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAG5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,aAGtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,aAG3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;EAAiC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;EAA2C,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;EAA4B,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;CAUzB,CAAC"}

package/dist/utils/validation.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+/**
+ * Stacks address validation regex
+ */
+const STACKS_ADDRESS_REGEX = /^S[PM][A-Z0-9]{38,}$/;
+/**
+ * Contract ID validation regex (address.contract-name)
+ */
+const CONTRACT_ID_REGEX = /^S[PM][A-Z0-9]{38,}\.[a-zA-Z][a-zA-Z0-9-]*$/;
+/**
+ * Transaction ID validation regex (64 hex chars)
+ */
+const TXID_REGEX = /^(0x)?[a-fA-F0-9]{64}$/;
+/**
+ * Validate a Stacks address
+ */
+export function isValidStacksAddress(address) {
+    return STACKS_ADDRESS_REGEX.test(address);
+}
+/**
+ * Validate a contract ID
+ */
+export function isValidContractId(contractId) {
+    return CONTRACT_ID_REGEX.test(contractId);
+}
+/**
+ * Validate a transaction ID
+ */
+export function isValidTxId(txid) {
+    return TXID_REGEX.test(txid);
+}
+/**
+ * Zod schema for Stacks address
+ */
+export const stacksAddressSchema = z.string().refine((val) => isValidStacksAddress(val), { message: "Invalid Stacks address. Must start with SP (mainnet) or ST (testnet)" });
+/**
+ * Zod schema for contract ID
+ */
+export const contractIdSchema = z.string().refine((val) => isValidContractId(val), { message: "Invalid contract ID. Must be in format: address.contract-name" });
+/**
+ * Zod schema for transaction ID
+ */
+export const txIdSchema = z.string().refine((val) => isValidTxId(val), { message: "Invalid transaction ID. Must be 64 hex characters" });
+/**
+ * Zod schema for STX amount (micro-STX as string)
+ */
+export const stxAmountSchema = z.string().refine((val) => /^\d+$/.test(val), { message: "Amount must be a positive integer string (micro-STX)" });
+/**
+ * Zod schema for network
+ */
+export const networkSchema = z.enum(["mainnet", "testnet"]);
+/**
+ * Zod schema for HTTP method
+ */
+export const httpMethodSchema = z.enum(["GET", "POST", "PUT", "DELETE"]);
+/**
+ * Zod schema for post condition mode
+ */
+export const postConditionModeSchema = z.enum(["allow", "deny"]);
+/**
+ * Common input schemas for tools
+ */
+export const commonSchemas = {
+    address: z.string().describe("Stacks address (starts with SP or ST)"),
+    optionalAddress: z.string().optional().describe("Optional Stacks address"),
+    contractId: z.string().describe("Contract ID in format: address.contract-name"),
+    txid: z.string().describe("Transaction ID (64 character hex string)"),
+    amount: z.string().describe("Amount in micro-STX (1 STX = 1,000,000 micro-STX)"),
+    tokenAmount: z.string().describe("Token amount in smallest unit"),
+    memo: z.string().optional().describe("Optional memo message"),
+    limit: z.number().optional().default(20).describe("Maximum number of results"),
+    offset: z.number().optional().default(0).describe("Offset for pagination"),
+};
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"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"}

package/dist/wallet.d.ts

@@ -0,0 +1,86 @@
+import { PostConditionMode, ClarityValue } from "@stacks/transactions";
+import { StacksNetworkName } from "@stacks/network";
+export type Network = "mainnet" | "testnet";
+export interface Account {
+    address: string;
+    privateKey: string;
+    network: Network;
+}
+export interface TransferResult {
+    txid: string;
+    rawTx: string;
+}
+export interface ContractCallOptions {
+    contractAddress: string;
+    contractName: string;
+    functionName: string;
+    functionArgs: ClarityValue[];
+    postConditionMode?: PostConditionMode;
+}
+export interface ContractDeployOptions {
+    contractName: string;
+    codeBody: string;
+}
+export declare function mnemonicToAccount(mnemonic: string, network: Network): Promise<Account>;
+export declare function getStacksNetwork(network: Network): StacksNetworkName;
+export declare function getApiBaseUrl(network: Network): string;
+/**
+ * Get account info including nonce and balance from the Stacks API
+ */
+export declare function getAccountInfo(address: string, network: Network): Promise<{
+    nonce: number;
+    balance: string;
+}>;
+/**
+ * Get STX balance for an address
+ */
+export declare function getStxBalance(address: string, network: Network): Promise<{
+    stx: string;
+    stxLocked: string;
+}>;
+/**
+ * Transfer STX tokens to a recipient
+ */
+export declare function transferStx(account: Account, recipient: string, amount: bigint, memo?: string): Promise<TransferResult>;
+/**
+ * Call a smart contract function
+ */
+export declare function callContract(account: Account, options: ContractCallOptions): Promise<TransferResult>;
+/**
+ * Deploy a smart contract
+ */
+export declare function deployContract(account: Account, options: ContractDeployOptions): Promise<TransferResult>;
+/**
+ * Sign a transaction without broadcasting (for offline signing)
+ */
+export declare function signStxTransfer(account: Account, recipient: string, amount: bigint, memo?: string): Promise<{
+    signedTx: string;
+    txid: string;
+}>;
+/**
+ * Sign a contract call without broadcasting
+ */
+export declare function signContractCall(account: Account, options: ContractCallOptions): Promise<{
+    signedTx: string;
+    txid: string;
+}>;
+/**
+ * Broadcast a pre-signed transaction
+ */
+export declare function broadcastSignedTransaction(signedTx: string, network: Network): Promise<{
+    txid: string;
+}>;
+/**
+ * Get transaction status
+ */
+export declare function getTransactionStatus(txid: string, network: Network): Promise<{
+    status: string;
+    block_height?: number;
+    tx_result?: unknown;
+}>;
+/**
+ * Parse a JSON argument into a ClarityValue
+ * Supports: string, number, boolean, principal, buffer, list, tuple, optional
+ */
+export declare function parseArgToClarityValue(arg: unknown): ClarityValue;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"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"}