@aibtc/mcp-server 1.0.0

package/dist/utils/encryption.js

@@ -0,0 +1,110 @@
+import crypto from "crypto";
+// Scrypt parameters - memory-hard to resist GPU/ASIC attacks
+const SCRYPT_PARAMS = {
+    N: 16384, // 2^14 - CPU/memory cost
+    r: 8, // Block size
+    p: 1, // Parallelization
+    keyLen: 32, // 256 bits for AES-256
+};
+const CURRENT_VERSION = 1;
+/**
+ * Derive encryption key from password using Scrypt
+ */
+function deriveKey(password, salt) {
+    return new Promise((resolve, reject) => {
+        crypto.scrypt(password, salt, SCRYPT_PARAMS.keyLen, {
+            N: SCRYPT_PARAMS.N,
+            r: SCRYPT_PARAMS.r,
+            p: SCRYPT_PARAMS.p,
+        }, (err, derivedKey) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(derivedKey);
+            }
+        });
+    });
+}
+/**
+ * Encrypt plaintext with password using AES-256-GCM
+ */
+export async function encrypt(plaintext, password) {
+    // Generate random salt and IV
+    const salt = crypto.randomBytes(32);
+    const iv = crypto.randomBytes(12); // GCM recommended IV size
+    // Derive key from password
+    const key = await deriveKey(password, salt);
+    // Encrypt with AES-256-GCM
+    const cipher = crypto.createCipheriv("aes-256-gcm", key, iv);
+    const encrypted = Buffer.concat([
+        cipher.update(plaintext, "utf8"),
+        cipher.final(),
+    ]);
+    const authTag = cipher.getAuthTag();
+    return {
+        ciphertext: encrypted.toString("base64"),
+        iv: iv.toString("base64"),
+        authTag: authTag.toString("base64"),
+        salt: salt.toString("base64"),
+        scryptParams: SCRYPT_PARAMS,
+        version: CURRENT_VERSION,
+    };
+}
+/**
+ * Decrypt ciphertext with password using AES-256-GCM
+ */
+export async function decrypt(encrypted, password) {
+    // Decode from base64
+    const ciphertext = Buffer.from(encrypted.ciphertext, "base64");
+    const iv = Buffer.from(encrypted.iv, "base64");
+    const authTag = Buffer.from(encrypted.authTag, "base64");
+    const salt = Buffer.from(encrypted.salt, "base64");
+    // Derive key using stored parameters
+    const key = await deriveKeyWithParams(password, salt, encrypted.scryptParams);
+    // Decrypt with AES-256-GCM
+    const decipher = crypto.createDecipheriv("aes-256-gcm", key, iv);
+    decipher.setAuthTag(authTag);
+    try {
+        const decrypted = Buffer.concat([
+            decipher.update(ciphertext),
+            decipher.final(),
+        ]);
+        return decrypted.toString("utf8");
+    }
+    catch {
+        throw new Error("Decryption failed - invalid password or corrupted data");
+    }
+}
+/**
+ * Derive key with custom scrypt parameters (for stored data)
+ */
+function deriveKeyWithParams(password, salt, params) {
+    return new Promise((resolve, reject) => {
+        crypto.scrypt(password, salt, params.keyLen, {
+            N: params.N,
+            r: params.r,
+            p: params.p,
+        }, (err, derivedKey) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(derivedKey);
+            }
+        });
+    });
+}
+/**
+ * Generate cryptographically secure random bytes
+ */
+export function randomBytes(length) {
+    return crypto.randomBytes(length);
+}
+/**
+ * Generate a random UUID for wallet IDs
+ */
+export function generateWalletId() {
+    return crypto.randomUUID();
+}
+//# sourceMappingURL=encryption.js.map

package/dist/utils/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../src/utils/encryption.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAmB5B,6DAA6D;AAC7D,MAAM,aAAa,GAAG;IACpB,CAAC,EAAE,KAAK,EAAE,yBAAyB;IACnC,CAAC,EAAE,CAAC,EAAE,aAAa;IACnB,CAAC,EAAE,CAAC,EAAE,kBAAkB;IACxB,MAAM,EAAE,EAAE,EAAE,uBAAuB;CACpC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;GAEG;AACH,SAAS,SAAS,CAAC,QAAgB,EAAE,IAAY;IAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,MAAM,CACX,QAAQ,EACR,IAAI,EACJ,aAAa,CAAC,MAAM,EACpB;YACE,CAAC,EAAE,aAAa,CAAC,CAAC;YAClB,CAAC,EAAE,aAAa,CAAC,CAAC;YAClB,CAAC,EAAE,aAAa,CAAC,CAAC;SACnB,EACD,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;YAClB,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,QAAgB;IAEhB,8BAA8B;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,0BAA0B;IAE7D,2BAA2B;IAC3B,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE5C,2BAA2B;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC;QAChC,MAAM,CAAC,KAAK,EAAE;KACf,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEpC,OAAO;QACL,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACnC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,YAAY,EAAE,aAAa;QAC3B,OAAO,EAAE,eAAe;KACzB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAwB,EACxB,QAAgB;IAEhB,qBAAqB;IACrB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEnD,qCAAqC;IACrC,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IAE9E,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACjE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;YAC9B,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;YAC3B,QAAQ,CAAC,KAAK,EAAE;SACjB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,IAAY,EACZ,MAAqC;IAErC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,MAAM,CACX,QAAQ,EACR,IAAI,EACJ,MAAM,CAAC,MAAM,EACb;YACE,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,CAAC,EAAE,MAAM,CAAC,CAAC;SACZ,EACD,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;YAClB,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Base error class for aibtc-mcp-server
+ */
+export declare class AibtcError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+/**
+ * Error for invalid configuration
+ */
+export declare class ConfigError extends AibtcError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error for transaction failures
+ */
+export declare class TransactionError extends AibtcError {
+    readonly txid?: string | undefined;
+    constructor(message: string, txid?: string | undefined, details?: unknown);
+}
+/**
+ * Error for API failures
+ */
+export declare class ApiError extends AibtcError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined, details?: unknown);
+}
+/**
+ * Error for contract call failures
+ */
+export declare class ContractError extends AibtcError {
+    readonly contractId?: string | undefined;
+    constructor(message: string, contractId?: string | undefined, details?: unknown);
+}
+/**
+ * Base error for wallet operations
+ */
+export declare class WalletError extends AibtcError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error when wallet is locked and operation requires unlocked wallet
+ */
+export declare class WalletLockedError extends WalletError {
+    constructor();
+}
+/**
+ * Error when wallet is not found
+ */
+export declare class WalletNotFoundError extends WalletError {
+    constructor(walletId: string);
+}
+/**
+ * Error for invalid password
+ */
+export declare class InvalidPasswordError extends WalletError {
+    constructor();
+}
+/**
+ * Error for invalid mnemonic
+ */
+export declare class InvalidMnemonicError extends WalletError {
+    constructor();
+}
+/**
+ * Format error for tool response
+ */
+export declare function formatError(error: unknown): {
+    message: string;
+    code?: string;
+    details?: unknown;
+};
+/**
+ * Create error response for MCP tools
+ */
+export declare function createErrorResponse(error: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;aACD,IAAI,CAAC,EAAE,MAAM;gBAA9C,OAAO,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA,EAAE,OAAO,CAAC,EAAE,OAAO;CAI9E;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,UAAU;aAGpB,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;aAGzB,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;;CAKjD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,QAAQ,EAAE,MAAM;CAI7B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;;CAKpD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;;CAKpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAcjG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IACnD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf,CAWA"}

package/dist/utils/errors.js

@@ -0,0 +1,132 @@
+/**
+ * Base error class for aibtc-mcp-server
+ */
+export class AibtcError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "AibtcError";
+    }
+}
+/**
+ * Error for invalid configuration
+ */
+export class ConfigError extends AibtcError {
+    constructor(message, details) {
+        super(message, "CONFIG_ERROR", details);
+        this.name = "ConfigError";
+    }
+}
+/**
+ * Error for transaction failures
+ */
+export class TransactionError extends AibtcError {
+    txid;
+    constructor(message, txid, details) {
+        super(message, "TRANSACTION_ERROR", details);
+        this.txid = txid;
+        this.name = "TransactionError";
+    }
+}
+/**
+ * Error for API failures
+ */
+export class ApiError extends AibtcError {
+    statusCode;
+    constructor(message, statusCode, details) {
+        super(message, "API_ERROR", details);
+        this.statusCode = statusCode;
+        this.name = "ApiError";
+    }
+}
+/**
+ * Error for contract call failures
+ */
+export class ContractError extends AibtcError {
+    contractId;
+    constructor(message, contractId, details) {
+        super(message, "CONTRACT_ERROR", details);
+        this.contractId = contractId;
+        this.name = "ContractError";
+    }
+}
+/**
+ * Base error for wallet operations
+ */
+export class WalletError extends AibtcError {
+    constructor(message, details) {
+        super(message, "WALLET_ERROR", details);
+        this.name = "WalletError";
+    }
+}
+/**
+ * Error when wallet is locked and operation requires unlocked wallet
+ */
+export class WalletLockedError extends WalletError {
+    constructor() {
+        super("Wallet is locked. Use wallet_unlock to unlock it.");
+        this.name = "WalletLockedError";
+    }
+}
+/**
+ * Error when wallet is not found
+ */
+export class WalletNotFoundError extends WalletError {
+    constructor(walletId) {
+        super(`Wallet not found: ${walletId}`);
+        this.name = "WalletNotFoundError";
+    }
+}
+/**
+ * Error for invalid password
+ */
+export class InvalidPasswordError extends WalletError {
+    constructor() {
+        super("Invalid password");
+        this.name = "InvalidPasswordError";
+    }
+}
+/**
+ * Error for invalid mnemonic
+ */
+export class InvalidMnemonicError extends WalletError {
+    constructor() {
+        super("Invalid mnemonic phrase");
+        this.name = "InvalidMnemonicError";
+    }
+}
+/**
+ * Format error for tool response
+ */
+export function formatError(error) {
+    if (error instanceof AibtcError) {
+        return {
+            message: error.message,
+            code: error.code,
+            details: error.details,
+        };
+    }
+    if (error instanceof Error) {
+        return { message: error.message };
+    }
+    return { message: "Unknown error occurred" };
+}
+/**
+ * Create error response for MCP tools
+ */
+export function createErrorResponse(error) {
+    const formatted = formatError(error);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Error: ${formatted.message}${formatted.code ? ` (${formatted.code})` : ""}`,
+            },
+        ],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/formatting.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Format STX amount from micro-STX to STX
+ */
+export declare function formatStx(microStx: string | bigint): string;
+/**
+ * Format sBTC amount from sats to BTC
+ */
+export declare function formatSbtc(sats: string | bigint): string;
+/**
+ * Format token amount with decimals
+ */
+export declare function formatTokenAmount(amount: string | bigint, decimals: number, symbol?: string): string;
+/**
+ * Parse STX amount string to micro-STX
+ */
+export declare function parseStxAmount(amount: string): bigint;
+/**
+ * Format address for display (truncated)
+ */
+export declare function formatAddress(address: string, chars?: number): string;
+/**
+ * Format transaction ID for display
+ */
+export declare function formatTxId(txid: string, chars?: number): string;
+/**
+ * Format date from timestamp
+ */
+export declare function formatDate(timestamp: number): string;
+/**
+ * Format block height
+ */
+export declare function formatBlockHeight(height: number): string;
+/**
+ * Create JSON response for MCP tools
+ */
+export declare function createJsonResponse(data: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/**
+ * Create success response for MCP tools
+ */
+export declare function createSuccessResponse(message: string, data?: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+//# sourceMappingURL=formatting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAW3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAWxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAKxE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG;IACjD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CASA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,GACb;IACD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAaA"}

package/dist/utils/formatting.js

@@ -0,0 +1,114 @@
+/**
+ * Format STX amount from micro-STX to STX
+ */
+export function formatStx(microStx) {
+    const value = BigInt(microStx);
+    const stx = value / BigInt(1_000_000);
+    const remainder = value % BigInt(1_000_000);
+    if (remainder === BigInt(0)) {
+        return `${stx} STX`;
+    }
+    const decimal = remainder.toString().padStart(6, "0").replace(/0+$/, "");
+    return `${stx}.${decimal} STX`;
+}
+/**
+ * Format sBTC amount from sats to BTC
+ */
+export function formatSbtc(sats) {
+    const value = BigInt(sats);
+    const btc = value / BigInt(100_000_000);
+    const remainder = value % BigInt(100_000_000);
+    if (remainder === BigInt(0)) {
+        return `${btc} sBTC`;
+    }
+    const decimal = remainder.toString().padStart(8, "0").replace(/0+$/, "");
+    return `${btc}.${decimal} sBTC`;
+}
+/**
+ * Format token amount with decimals
+ */
+export function formatTokenAmount(amount, decimals, symbol) {
+    const value = BigInt(amount);
+    const divisor = BigInt(10 ** decimals);
+    const whole = value / divisor;
+    const remainder = value % divisor;
+    let result;
+    if (remainder === BigInt(0)) {
+        result = whole.toString();
+    }
+    else {
+        const decimal = remainder.toString().padStart(decimals, "0").replace(/0+$/, "");
+        result = `${whole}.${decimal}`;
+    }
+    return symbol ? `${result} ${symbol}` : result;
+}
+/**
+ * Parse STX amount string to micro-STX
+ */
+export function parseStxAmount(amount) {
+    // Remove STX suffix if present
+    const cleaned = amount.replace(/\s*STX$/i, "").trim();
+    if (cleaned.includes(".")) {
+        const [whole, decimal] = cleaned.split(".");
+        const paddedDecimal = (decimal || "").padEnd(6, "0").slice(0, 6);
+        return BigInt(whole || "0") * BigInt(1_000_000) + BigInt(paddedDecimal);
+    }
+    return BigInt(cleaned) * BigInt(1_000_000);
+}
+/**
+ * Format address for display (truncated)
+ */
+export function formatAddress(address, chars = 8) {
+    if (address.length <= chars * 2 + 3) {
+        return address;
+    }
+    return `${address.slice(0, chars)}...${address.slice(-chars)}`;
+}
+/**
+ * Format transaction ID for display
+ */
+export function formatTxId(txid, chars = 8) {
+    return formatAddress(txid, chars);
+}
+/**
+ * Format date from timestamp
+ */
+export function formatDate(timestamp) {
+    return new Date(timestamp * 1000).toISOString();
+}
+/**
+ * Format block height
+ */
+export function formatBlockHeight(height) {
+    return height.toLocaleString();
+}
+/**
+ * Create JSON response for MCP tools
+ */
+export function createJsonResponse(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Create success response for MCP tools
+ */
+export function createSuccessResponse(message, data) {
+    const response = data
+        ? { success: true, message, ...data }
+        : { success: true, message };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=formatting.js.map

package/dist/utils/formatting.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export * from "./formatting.js";
+export * from "./validation.js";
+export * from "./encryption.js";
+export * from "./storage.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export * from "./formatting.js";
+export * from "./validation.js";
+export * from "./encryption.js";
+export * from "./storage.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/utils/storage.d.ts

@@ -0,0 +1,90 @@
+import type { EncryptedData } from "./encryption.js";
+import type { Network } from "../config/networks.js";
+/**
+ *
+ * Wallet metadata (stored in index, no sensitive data)
+ */
+export interface WalletMetadata {
+    id: string;
+    name: string;
+    address: string;
+    network: Network;
+    createdAt: string;
+    lastUsed?: string;
+}
+/**
+ * Wallet index file structure
+ */
+export interface WalletIndex {
+    version: number;
+    wallets: WalletMetadata[];
+}
+/**
+ * App configuration
+ */
+export interface AppConfig {
+    version: number;
+    activeWalletId: string | null;
+    autoLockTimeout: number;
+}
+/**
+ * Keystore file structure (contains encrypted mnemonic)
+ */
+export interface KeystoreFile {
+    version: number;
+    encrypted: EncryptedData;
+    addressIndex: number;
+}
+/**
+ * Get storage directory path
+ */
+export declare function getStorageDir(): string;
+/**
+ * Check if storage directory exists
+ */
+export declare function storageExists(): Promise<boolean>;
+/**
+ * Initialize storage directory structure
+ */
+export declare function initializeStorage(): Promise<void>;
+/**
+ * Read wallet index
+ */
+export declare function readWalletIndex(): Promise<WalletIndex>;
+/**
+ * Write wallet index (atomic write with temp file)
+ */
+export declare function writeWalletIndex(index: WalletIndex): Promise<void>;
+/**
+ * Read app config
+ */
+export declare function readAppConfig(): Promise<AppConfig>;
+/**
+ * Write app config (atomic write)
+ */
+export declare function writeAppConfig(config: AppConfig): Promise<void>;
+/**
+ * Read keystore for a wallet
+ */
+export declare function readKeystore(walletId: string): Promise<KeystoreFile>;
+/**
+ * Write keystore for a wallet (creates directory if needed)
+ */
+export declare function writeKeystore(walletId: string, keystore: KeystoreFile): Promise<void>;
+/**
+ * Delete a wallet directory and its contents
+ */
+export declare function deleteWalletStorage(walletId: string): Promise<void>;
+/**
+ * Update wallet metadata in index
+ */
+export declare function updateWalletMetadata(walletId: string, updates: Partial<WalletMetadata>): Promise<void>;
+/**
+ * Add wallet to index
+ */
+export declare function addWalletToIndex(wallet: WalletMetadata): Promise<void>;
+/**
+ * Remove wallet from index
+ */
+export declare function removeWalletFromIndex(walletId: string): Promise<void>;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AA6BrD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAOtD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BvD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC,CAU5D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAMxE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAWxD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE;AASD;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAI1E;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E"}