@aibtc/mcp-server 1.0.0

package/dist/services/hiro-api.js

@@ -0,0 +1,376 @@
+import { serializeCV } from "@stacks/transactions";
+import { getApiBaseUrl } from "../config/networks.js";
+import { parseContractId } from "../config/contracts.js";
+// ============================================================================
+// Hiro API Service
+// ============================================================================
+export class HiroApiService {
+    network;
+    baseUrl;
+    constructor(network) {
+        this.network = network;
+        this.baseUrl = getApiBaseUrl(network);
+    }
+    async fetch(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Hiro API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    // ==========================================================================
+    // Account Operations
+    // ==========================================================================
+    async getAccountInfo(address) {
+        return this.fetch(`/v2/accounts/${address}`);
+    }
+    async getStxBalance(address) {
+        return this.fetch(`/extended/v1/address/${address}/stx`);
+    }
+    async getAccountBalances(address) {
+        return this.fetch(`/extended/v1/address/${address}/balances`);
+    }
+    async getAccountTransactions(address, options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        if (options?.type)
+            options.type.forEach((t) => params.append("type", t));
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.fetch(`/extended/v1/address/${address}/transactions${query}`);
+    }
+    async getAccountNonce(address) {
+        const info = await this.getAccountInfo(address);
+        return info.nonce;
+    }
+    // ==========================================================================
+    // Token Operations
+    // ==========================================================================
+    async getTokenBalance(address, contractId) {
+        const balances = await this.getAccountBalances(address);
+        const tokenKey = Object.keys(balances.fungible_tokens).find((key) => key.startsWith(contractId + "::") || key === contractId);
+        if (!tokenKey) {
+            return "0";
+        }
+        return balances.fungible_tokens[tokenKey].balance;
+    }
+    async getTokenMetadata(contractId) {
+        try {
+            return await this.fetch(`/metadata/v1/ft/${contractId}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    async getTokenHolders(contractId, options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.fetch(`/extended/v1/tokens/ft/${contractId}/holders${query}`);
+    }
+    async getUserTokens(address) {
+        const balances = await this.getAccountBalances(address);
+        return Object.entries(balances.fungible_tokens).map(([asset_identifier, data]) => ({
+            asset_identifier,
+            balance: data.balance,
+        }));
+    }
+    // ==========================================================================
+    // NFT Operations
+    // ==========================================================================
+    async getNftHoldings(address, options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        if (options?.asset_identifiers) {
+            options.asset_identifiers.forEach((id) => params.append("asset_identifiers", id));
+        }
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.fetch(`/extended/v1/tokens/nft/holdings${query}&principal=${address}`);
+    }
+    async getNftEvents(contractId, options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.fetch(`/extended/v1/tokens/nft/history${query}&asset_identifier=${contractId}`);
+    }
+    async getNftMetadata(contractId, tokenId) {
+        return this.fetch(`/metadata/v1/nft/${contractId}/${tokenId}`);
+    }
+    // ==========================================================================
+    // Contract Operations
+    // ==========================================================================
+    async getContractInfo(contractId) {
+        return this.fetch(`/extended/v1/contract/${contractId}`);
+    }
+    async getContractInterface(contractId) {
+        const { address, name } = parseContractId(contractId);
+        return this.fetch(`/v2/contracts/interface/${address}/${name}`);
+    }
+    async getContractSource(contractId) {
+        const { address, name } = parseContractId(contractId);
+        return this.fetch(`/v2/contracts/source/${address}/${name}`);
+    }
+    async callReadOnlyFunction(contractId, functionName, functionArgs, senderAddress) {
+        const { address, name } = parseContractId(contractId);
+        const body = {
+            sender: senderAddress,
+            arguments: functionArgs.map((arg) => {
+                const serialized = serializeCV(arg);
+                // serializeCV returns hex string in newer versions, Uint8Array in older
+                if (typeof serialized === "string") {
+                    return serialized;
+                }
+                return Buffer.from(serialized).toString("hex");
+            }),
+        };
+        return this.fetch(`/v2/contracts/call-read/${address}/${name}/${functionName}`, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+    }
+    async getContractEvents(contractId, options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.fetch(`/extended/v1/contract/${contractId}/events${query}`);
+    }
+    // ==========================================================================
+    // Transaction Operations
+    // ==========================================================================
+    async getTransaction(txid) {
+        return this.fetch(`/extended/v1/tx/${txid}`);
+    }
+    async getTransactionStatus(txid) {
+        try {
+            const tx = await this.getTransaction(txid);
+            return {
+                status: tx.tx_status,
+                block_height: tx.block_height,
+                tx_result: tx.tx_result,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("404")) {
+                return { status: "pending" };
+            }
+            throw error;
+        }
+    }
+    async searchTransactions(query, options) {
+        const params = new URLSearchParams();
+        params.set("query", query);
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        return this.fetch(`/extended/v1/search?${params.toString()}`);
+    }
+    async getMempoolTransactions(options) {
+        const params = new URLSearchParams();
+        if (options?.sender_address)
+            params.set("sender_address", options.sender_address);
+        if (options?.recipient_address)
+            params.set("recipient_address", options.recipient_address);
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.fetch(`/extended/v1/tx/mempool${query}`);
+    }
+    async estimateFee(txPayload) {
+        return this.fetch("/v2/fees/transaction", {
+            method: "POST",
+            body: JSON.stringify({ transaction_payload: txPayload }),
+        });
+    }
+    // ==========================================================================
+    // Block Operations
+    // ==========================================================================
+    async getBlockByHeight(height) {
+        return this.fetch(`/extended/v1/block/by_height/${height}`);
+    }
+    async getBlockByHash(hash) {
+        return this.fetch(`/extended/v1/block/${hash}`);
+    }
+    async getLatestBlock() {
+        const response = await this.fetch("/extended/v1/block?limit=1");
+        if (!response.results.length) {
+            throw new Error("No blocks found");
+        }
+        return response.results[0];
+    }
+    async getBlocks(options) {
+        const params = new URLSearchParams();
+        if (options?.limit)
+            params.set("limit", options.limit.toString());
+        if (options?.offset)
+            params.set("offset", options.offset.toString());
+        const query = params.toString() ? `?${params.toString()}` : "";
+        return this.fetch(`/extended/v1/block${query}`);
+    }
+    // ==========================================================================
+    // Stacking / PoX Operations
+    // ==========================================================================
+    async getPoxInfo() {
+        return this.fetch("/v2/pox");
+    }
+    async getStackerInfo(address) {
+        return this.fetch(`/extended/v1/address/${address}/stx_inbound`);
+    }
+    // ==========================================================================
+    // BNS Operations
+    // ==========================================================================
+    async getBnsNameInfo(name) {
+        return this.fetch(`/v1/names/${name}`);
+    }
+    async getBnsNamesOwnedByAddress(address) {
+        return this.fetch(`/v1/addresses/stacks/${address}`);
+    }
+    async getBnsNamePrice(name) {
+        const [namespace] = name.split(".").reverse();
+        return this.fetch(`/v2/prices/names/${namespace}/${name}`);
+    }
+    async resolveBnsName(name) {
+        try {
+            const info = await this.getBnsNameInfo(name);
+            return info.address;
+        }
+        catch {
+            return null;
+        }
+    }
+    // ==========================================================================
+    // Network Status
+    // ==========================================================================
+    async getNetworkStatus() {
+        return this.fetch("/extended/v1/status");
+    }
+    async getCoreApiInfo() {
+        return this.fetch("/v2/info");
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+let _hiroApiInstance = null;
+export function getHiroApi(network) {
+    if (!_hiroApiInstance || _hiroApiInstance["network"] !== network) {
+        _hiroApiInstance = new HiroApiService(network);
+    }
+    return _hiroApiInstance;
+}
+export async function getStxBalance(address, network) {
+    const api = getHiroApi(network);
+    const balance = await api.getStxBalance(address);
+    return {
+        stx: balance.balance,
+        stxLocked: balance.locked,
+    };
+}
+export async function getTransactionStatus(txid, network) {
+    const api = getHiroApi(network);
+    return api.getTransactionStatus(txid);
+}
+// ============================================================================
+// BNS V2 API Service (for .btc names)
+// ============================================================================
+const BNSV2_API_URL = "https://api.bnsv2.com";
+export class BnsV2ApiService {
+    baseUrl;
+    constructor() {
+        this.baseUrl = BNSV2_API_URL;
+    }
+    async fetch(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`BNS V2 API error (${response.status}): ${errorText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get BNS V2 name info
+     */
+    async getNameInfo(name) {
+        const fullName = name.endsWith(".btc") ? name : `${name}.btc`;
+        return this.fetch(`/names/${fullName}`);
+    }
+    /**
+     * Get names owned by an address
+     */
+    async getNamesOwnedByAddress(address) {
+        return this.fetch(`/names/address/${address}/valid`);
+    }
+    /**
+     * Check if a name exists (is registered)
+     */
+    async nameExists(name) {
+        try {
+            const info = await this.getNameInfo(name);
+            return info.status === "active" && info.data.is_valid && !info.data.revoked;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("404")) {
+                return false;
+            }
+            if (error instanceof Error && error.message.includes("Name not found")) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Resolve a name to an address
+     */
+    async resolveName(name) {
+        try {
+            const info = await this.getNameInfo(name);
+            if (info.status === "active" && info.data.is_valid && !info.data.revoked) {
+                return info.data.owner;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+// BNS V2 singleton
+let _bnsV2ApiInstance = null;
+export function getBnsV2Api() {
+    if (!_bnsV2ApiInstance) {
+        _bnsV2ApiInstance = new BnsV2ApiService();
+    }
+    return _bnsV2ApiInstance;
+}
+//# sourceMappingURL=hiro-api.js.map

package/dist/services/hiro-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hiro-api.js","sourceRoot":"","sources":["../../src/services/hiro-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAgB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA8QzD,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,OAAO,cAAc;IAGL;IAFZ,OAAO,CAAS;IAExB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;QAClC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAEO,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,OAAqB;QACxD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,6EAA6E;IAC7E,qBAAqB;IACrB,6EAA6E;IAE7E,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC,KAAK,CAAc,gBAAgB,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,OAAO,IAAI,CAAC,KAAK,CAAa,wBAAwB,OAAO,MAAM,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,OAAe;QACtC,OAAO,IAAI,CAAC,KAAK,CAAkB,wBAAwB,OAAO,WAAW,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,OAAe,EACf,OAA8D;QAE9D,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,IAAI,OAAO,EAAE,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QAEzE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,wBAAwB,OAAO,gBAAgB,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,6EAA6E;IAC7E,mBAAmB;IACnB,6EAA6E;IAE7E,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,UAAkB;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,IAAI,CACzD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,UAAU,CACjE,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,KAAK,CAAgB,mBAAmB,UAAU,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,UAAkB,EAClB,OAA6C;QAE7C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,0BAA0B,UAAU,WAAW,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACjF,gBAAgB;YAChB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAE7E,KAAK,CAAC,cAAc,CAClB,OAAe,EACf,OAA2E;QAE3E,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,IAAI,OAAO,EAAE,iBAAiB,EAAE,CAAC;YAC/B,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,mCAAmC,KAAK,cAAc,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,OAA6C;QAE7C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,kCAAkC,KAAK,qBAAqB,UAAU,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAe;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,6EAA6E;IAC7E,sBAAsB;IACtB,6EAA6E;IAE7E,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAe,yBAAyB,UAAU,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,UAAkB;QAC3C,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,CAAoB,2BAA2B,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,UAAkB;QACxC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,wBAAwB,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,UAAkB,EAClB,YAAoB,EACpB,YAA4B,EAC5B,aAAqB;QAErB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAEtD,MAAM,IAAI,GAAG;YACX,MAAM,EAAE,aAAa;YACrB,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAClC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;gBACpC,wEAAwE;gBACxE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,OAAO,UAAU,CAAC;gBACpB,CAAC;gBACD,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC,CAAC;SACH,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,2BAA2B,OAAO,IAAI,IAAI,IAAI,YAAY,EAAE,EAAE;YAC9E,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,UAAkB,EAClB,OAA6C;QAE7C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,yBAAyB,UAAU,UAAU,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,6EAA6E;IAC7E,yBAAyB;IACzB,6EAA6E;IAE7E,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAc,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAAY;QAKrC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC3C,OAAO;gBACL,MAAM,EAAE,EAAE,CAAC,SAAS;gBACpB,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,SAAS,EAAE,EAAE,CAAC,SAAS;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,KAAa,EACb,OAA6C;QAE7C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErE,OAAO,IAAI,CAAC,KAAK,CAAC,uBAAuB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,OAAkG;QAElG,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,cAAc;YAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;QAClF,IAAI,OAAO,EAAE,iBAAiB;YAAE,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC3F,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,mBAAmB;IACnB,6EAA6E;IAE7E,KAAK,CAAC,gBAAgB,CAAC,MAAc;QACnC,OAAO,IAAI,CAAC,KAAK,CAAY,gCAAgC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAY,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAA2B,4BAA4B,CAAC,CAAC;QAC1F,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,SAAS,CACb,OAA6C;QAE7C,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,OAAO,EAAE,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,OAAO,EAAE,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAErE,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,6EAA6E;IAC7E,4BAA4B;IAC5B,6EAA6E;IAE7E,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,KAAK,CAAU,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,wBAAwB,OAAO,cAAc,CAAC,CAAC;IACnE,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAE7E,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAU,aAAa,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,yBAAyB,CAC7B,OAAe;QAEf,OAAO,IAAI,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAE7E,KAAK,CAAC,gBAAgB;QAWpB,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,cAAc;QAclB,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,IAAI,gBAAgB,GAA0B,IAAI,CAAC;AAEnD,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,SAAS,CAAC,KAAK,OAAO,EAAE,CAAC;QACjE,gBAAgB,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,OAAgB;IAEhB,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,OAAO;QACpB,SAAS,EAAE,OAAO,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,OAAgB;IAEhB,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C,MAAM,OAAO,eAAe;IAClB,OAAO,CAAS;IAExB;QACE,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,KAAK,CAAI,IAAY,EAAE,OAAqB;QACxD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,EAAE,OAAO;aACpB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC;QAC9D,OAAO,IAAI,CAAC,KAAK,CAAoB,UAAU,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,sBAAsB,CAAC,OAAe;QAC1C,OAAO,IAAI,CAAC,KAAK,CAA0B,kBAAkB,OAAO,QAAQ,CAAC,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACvE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACzE,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACzB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,mBAAmB;AACnB,IAAI,iBAAiB,GAA2B,IAAI,CAAC;AAErD,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

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

@@ -0,0 +1,70 @@
+import { NftHolding } from "./hiro-api.js";
+import { type Network } from "../config/index.js";
+import { type Account, type TransferResult } from "../transactions/builder.js";
+export interface NftInfo {
+    contractId: string;
+    tokenId: number;
+    owner: string;
+    metadata?: unknown;
+}
+export interface NftCollectionInfo {
+    contractId: string;
+    name?: string;
+    totalSupply?: number;
+    functions: string[];
+}
+export interface NftTransferEvent {
+    sender: string;
+    recipient: string;
+    tokenId: string;
+    txId: string;
+    blockHeight: number;
+}
+export declare class NftService {
+    private network;
+    private hiro;
+    constructor(network: Network);
+    /**
+     * Get all NFTs owned by an address
+     */
+    getHoldings(address: string, options?: {
+        limit?: number;
+        offset?: number;
+        contractId?: string;
+    }): Promise<{
+        total: number;
+        nfts: NftHolding[];
+    }>;
+    /**
+     * Get NFT metadata
+     */
+    getMetadata(contractId: string, tokenId: number): Promise<unknown>;
+    /**
+     * Get NFT owner by calling the contract
+     */
+    getOwner(contractId: string, tokenId: number, senderAddress: string): Promise<string | null>;
+    /**
+     * Get collection information
+     */
+    getCollectionInfo(contractId: string): Promise<NftCollectionInfo>;
+    /**
+     * Get NFT transfer history
+     */
+    getHistory(contractId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        total: number;
+        events: NftTransferEvent[];
+    }>;
+    /**
+     * Transfer an NFT (SIP-009 standard)
+     */
+    transfer(account: Account, contractId: string, tokenId: number, recipient: string): Promise<TransferResult>;
+    /**
+     * Mint an NFT (contract-specific, not part of SIP-009)
+     */
+    mint(account: Account, contractId: string, recipient: string, mintFunctionName?: string): Promise<TransferResult>;
+}
+export declare function getNftService(network: Network): NftService;
+//# sourceMappingURL=nft.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nft.service.d.ts","sourceRoot":"","sources":["../../src/services/nft.service.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,UAAU,EAAY,MAAM,eAAe,CAAC;AACjF,OAAO,EAAmB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAM7F,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,UAAU;IAGT,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,IAAI,CAAiB;gBAET,OAAO,EAAE,OAAO;IAIpC;;OAEG;IACG,WAAW,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAcjD;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxE;;OAEG;IACG,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyBzB;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmCvE;;OAEG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;IAiBzD;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC;IAmB1B;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,gBAAgB,GAAE,MAAe,GAChC,OAAO,CAAC,cAAc,CAAC;CAa3B;AAQD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAK1D"}

package/dist/services/nft.service.js

@@ -0,0 +1,148 @@
+import { uintCV, principalCV } from "@stacks/transactions";
+import { getHiroApi } from "./hiro-api.js";
+import { parseContractId } from "../config/index.js";
+import { callContract } from "../transactions/builder.js";
+// ============================================================================
+// NFT Service (SIP-009)
+// ============================================================================
+export class NftService {
+    network;
+    hiro;
+    constructor(network) {
+        this.network = network;
+        this.hiro = getHiroApi(network);
+    }
+    /**
+     * Get all NFTs owned by an address
+     */
+    async getHoldings(address, options) {
+        const assetIdentifiers = options?.contractId ? [options.contractId] : undefined;
+        const result = await this.hiro.getNftHoldings(address, {
+            limit: options?.limit,
+            offset: options?.offset,
+            asset_identifiers: assetIdentifiers,
+        });
+        return {
+            total: result.total,
+            nfts: result.results,
+        };
+    }
+    /**
+     * Get NFT metadata
+     */
+    async getMetadata(contractId, tokenId) {
+        return this.hiro.getNftMetadata(contractId, tokenId);
+    }
+    /**
+     * Get NFT owner by calling the contract
+     */
+    async getOwner(contractId, tokenId, senderAddress) {
+        parseContractId(contractId); // Validate contract ID format
+        try {
+            const result = await this.hiro.callReadOnlyFunction(contractId, "get-owner", [uintCV(tokenId)], senderAddress);
+            if (result.okay && result.result) {
+                // Parse the result - it returns (optional principal)
+                // This is a simplified parsing - actual implementation may need more robust parsing
+                const match = result.result.match(/\(some\s+([^\)]+)\)/);
+                if (match) {
+                    return match[1];
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get collection information
+     */
+    async getCollectionInfo(contractId) {
+        const contractInterface = await this.hiro.getContractInterface(contractId);
+        // Get the NFT token type info
+        const nftTokens = contractInterface.non_fungible_tokens || [];
+        const functions = contractInterface.functions.map((f) => f.name);
+        // Try to get the last token ID to determine supply
+        let totalSupply;
+        try {
+            // Many NFT contracts have get-last-token-id function (SIP-009 requirement)
+            const lastTokenResult = await this.hiro.callReadOnlyFunction(contractId, "get-last-token-id", [], contractId.split(".")[0]);
+            if (lastTokenResult.okay && lastTokenResult.result) {
+                const match = lastTokenResult.result.match(/\(ok\s+u(\d+)\)/);
+                if (match) {
+                    totalSupply = parseInt(match[1], 10);
+                }
+            }
+        }
+        catch {
+            // Function may not exist or may fail
+        }
+        return {
+            contractId,
+            name: nftTokens[0]?.name,
+            totalSupply,
+            functions,
+        };
+    }
+    /**
+     * Get NFT transfer history
+     */
+    async getHistory(contractId, options) {
+        const result = await this.hiro.getNftEvents(contractId, options);
+        const events = result.results.map((event) => ({
+            sender: event.sender,
+            recipient: event.recipient,
+            tokenId: event.value.repr,
+            txId: event.tx_id,
+            blockHeight: event.block_height,
+        }));
+        return {
+            total: result.total,
+            events,
+        };
+    }
+    /**
+     * Transfer an NFT (SIP-009 standard)
+     */
+    async transfer(account, contractId, tokenId, recipient) {
+        const { address: contractAddress, name: contractName } = parseContractId(contractId);
+        // SIP-009 transfer function signature:
+        // (transfer (token-id uint) (sender principal) (recipient principal))
+        const functionArgs = [
+            uintCV(tokenId),
+            principalCV(account.address),
+            principalCV(recipient),
+        ];
+        return callContract(account, {
+            contractAddress,
+            contractName,
+            functionName: "transfer",
+            functionArgs,
+        });
+    }
+    /**
+     * Mint an NFT (contract-specific, not part of SIP-009)
+     */
+    async mint(account, contractId, recipient, mintFunctionName = "mint") {
+        const { address: contractAddress, name: contractName } = parseContractId(contractId);
+        // This is a generic mint call - actual parameters depend on the specific contract
+        const functionArgs = [principalCV(recipient)];
+        return callContract(account, {
+            contractAddress,
+            contractName,
+            functionName: mintFunctionName,
+            functionArgs,
+        });
+    }
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+let _nftServiceInstance = null;
+export function getNftService(network) {
+    if (!_nftServiceInstance || _nftServiceInstance["network"] !== network) {
+        _nftServiceInstance = new NftService(network);
+    }
+    return _nftServiceInstance;
+}
+//# sourceMappingURL=nft.service.js.map

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

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