@aibtc/mcp-server 1.0.0

package/dist/services/sbtc.service.d.ts

@@ -0,0 +1,44 @@
+import { type Network } from "../config/index.js";
+import { type Account, type TransferResult } from "../transactions/builder.js";
+export interface SbtcBalance {
+    balance: string;
+    balanceSats: string;
+    balanceBtc: string;
+}
+export interface SbtcPegInfo {
+    totalSupply: string;
+    totalSupplySats: string;
+    totalSupplyBtc: string;
+    pegRatio: string;
+}
+export interface SbtcDepositInfo {
+    depositAddress: string;
+    minDeposit: string;
+    maxDeposit: string;
+    instructions: string[];
+}
+export declare class SbtcService {
+    private network;
+    private hiro;
+    private contracts;
+    constructor(network: Network);
+    /**
+     * Get sBTC balance for an address
+     */
+    getBalance(address: string): Promise<SbtcBalance>;
+    /**
+     * Transfer sBTC to a recipient
+     */
+    transfer(account: Account, recipient: string, amount: bigint, memo?: string): Promise<TransferResult>;
+    /**
+     * Get sBTC deposit instructions
+     * Note: sBTC deposits require interacting with the Bitcoin network directly
+     */
+    getDepositInfo(): Promise<SbtcDepositInfo>;
+    /**
+     * Get sBTC peg information
+     */
+    getPegInfo(): Promise<SbtcPegInfo>;
+}
+export declare function getSbtcService(network: Network): SbtcService;
+//# sourceMappingURL=sbtc.service.d.ts.map

package/dist/services/sbtc.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sbtc.service.d.ts","sourceRoot":"","sources":["../../src/services/sbtc.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAM7F,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,qBAAa,WAAW;IAIV,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,SAAS,CAAkC;gBAE/B,OAAO,EAAE,OAAO;IAKpC;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAevD;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC;IAwB1B;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,eAAe,CAAC;IAehD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;CAgBzC;AAQD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAK5D"}

package/dist/services/sbtc.service.js

@@ -0,0 +1,100 @@
+import { uintCV, principalCV } from "@stacks/transactions";
+import { getHiroApi } from "./hiro-api.js";
+import { getContracts, parseContractId } from "../config/index.js";
+import { callContract } from "../transactions/builder.js";
+// ============================================================================
+// sBTC Service
+// ============================================================================
+export class SbtcService {
+    network;
+    hiro;
+    contracts;
+    constructor(network) {
+        this.network = network;
+        this.hiro = getHiroApi(network);
+        this.contracts = getContracts(network);
+    }
+    /**
+     * Get sBTC balance for an address
+     */
+    async getBalance(address) {
+        const sbtcContract = this.contracts.SBTC_TOKEN;
+        const balance = await this.hiro.getTokenBalance(address, sbtcContract);
+        // sBTC uses 8 decimals (same as Bitcoin)
+        const balanceSats = balance;
+        const balanceBtc = (BigInt(balance) / BigInt(100_000_000)).toString();
+        return {
+            balance,
+            balanceSats,
+            balanceBtc,
+        };
+    }
+    /**
+     * Transfer sBTC to a recipient
+     */
+    async transfer(account, recipient, amount, memo) {
+        const sbtcContract = this.contracts.SBTC_TOKEN;
+        const { address: contractAddress, name: contractName } = parseContractId(sbtcContract);
+        const functionArgs = [
+            uintCV(amount),
+            principalCV(account.address),
+            principalCV(recipient),
+        ];
+        // Add memo if provided
+        if (memo) {
+            // sBTC transfer typically has an optional memo parameter
+            // Implementation depends on the specific sBTC contract version
+        }
+        return callContract(account, {
+            contractAddress,
+            contractName,
+            functionName: "transfer",
+            functionArgs,
+        });
+    }
+    /**
+     * Get sBTC deposit instructions
+     * Note: sBTC deposits require interacting with the Bitcoin network directly
+     */
+    async getDepositInfo() {
+        return {
+            depositAddress: "Use sBTC bridge at https://bridge.stx.eco",
+            minDeposit: "0.0001 BTC",
+            maxDeposit: "No limit",
+            instructions: [
+                "1. Visit the sBTC bridge at https://bridge.stx.eco",
+                "2. Connect your Bitcoin and Stacks wallets",
+                "3. Follow the bridge UI to deposit BTC",
+                "4. Wait for Bitcoin block confirmations",
+                "5. sBTC will be minted to your Stacks address",
+            ],
+        };
+    }
+    /**
+     * Get sBTC peg information
+     */
+    async getPegInfo() {
+        const sbtcContract = this.contracts.SBTC_TOKEN;
+        const metadata = await this.hiro.getTokenMetadata(sbtcContract);
+        const totalSupply = metadata?.total_supply || "0";
+        const totalSupplySats = totalSupply;
+        const totalSupplyBtc = (BigInt(totalSupply) / BigInt(100_000_000)).toString();
+        return {
+            totalSupply,
+            totalSupplySats,
+            totalSupplyBtc,
+            pegRatio: "1:1",
+        };
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+let _sbtcServiceInstance = null;
+export function getSbtcService(network) {
+    if (!_sbtcServiceInstance || _sbtcServiceInstance["network"] !== network) {
+        _sbtcServiceInstance = new SbtcService(network);
+    }
+    return _sbtcServiceInstance;
+}
+//# sourceMappingURL=sbtc.service.js.map

package/dist/services/sbtc.service.js.map

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

package/dist/services/scaffold.service.d.ts

@@ -0,0 +1,41 @@
+export interface EndpointConfig {
+    path: string;
+    method: "GET" | "POST";
+    description: string;
+    amount: string;
+    tokenType: "STX" | "sBTC" | "USDCx";
+}
+export interface AIEndpointConfig {
+    path: string;
+    description: string;
+    amount: string;
+    tokenType: "STX" | "sBTC" | "USDCx";
+    aiType: "chat" | "completion" | "summarize" | "translate" | "custom";
+    model?: string;
+    systemPrompt?: string;
+}
+export interface ScaffoldConfig {
+    outputDir: string;
+    projectName: string;
+    endpoints: EndpointConfig[];
+    recipientAddress: string;
+    network: "mainnet" | "testnet";
+    facilitatorUrl: string;
+}
+export interface ScaffoldResult {
+    projectPath: string;
+    filesCreated: string[];
+    nextSteps: string[];
+}
+export interface AIScaffoldConfig {
+    outputDir: string;
+    projectName: string;
+    endpoints: AIEndpointConfig[];
+    recipientAddress: string;
+    network: "mainnet" | "testnet";
+    facilitatorUrl: string;
+    defaultModel: string;
+}
+export declare function scaffoldProject(config: ScaffoldConfig): Promise<ScaffoldResult>;
+export declare function scaffoldAIProject(config: AIScaffoldConfig): Promise<ScaffoldResult>;
+//# sourceMappingURL=scaffold.service.d.ts.map

package/dist/services/scaffold.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.service.d.ts","sourceRoot":"","sources":["../../src/services/scaffold.service.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAoiBD,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAuDrF;AA4bD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqEzF"}