@1sat/client 0.0.2 → 0.0.3

package/dist/services/OneSatServices.js

@@ -0,0 +1,401 @@
+import { ONESAT_MAINNET_URL, ONESAT_TESTNET_URL } from '@1sat/types';
+import { Beef, Hash, MerklePath, Transaction, Utils, } from '@bsv/sdk';
+import { ArcadeClient, BeefClient, Bsv21Client, ChaintracksClient, OrdfsClient, OverlayClient, OwnerClient, TxoClient, } from './index';
+/**
+ * Simple error class for WalletServices error responses.
+ */
+class ServiceError extends Error {
+    code;
+    description;
+    isError = true;
+    constructor(code, description) {
+        super(description);
+        this.code = code;
+        this.description = description;
+        this.name = code;
+    }
+}
+/**
+ * WalletServices implementation for 1Sat ecosystem.
+ *
+ * Provides access to 1Sat API clients and implements the WalletServices
+ * interface required by wallet-toolbox.
+ *
+ * API Routes:
+ * - /1sat/chaintracks/* - Block headers and chain tracking
+ * - /1sat/beef/* - Raw transactions and proofs
+ * - /1sat/arcade/* - Transaction broadcasting
+ * - /1sat/bsv21/* - BSV21 token data
+ * - /1sat/txo/* - Transaction outputs
+ * - /1sat/owner/* - Address queries and sync
+ * - /1sat/ordfs/* - Content/inscription serving
+ * - /overlay/* - Overlay services (topic managers, lookups)
+ */
+export class OneSatServices {
+    chain;
+    baseUrl;
+    // ===== API Clients =====
+    chaintracks;
+    beef;
+    arcade;
+    txo;
+    owner;
+    ordfs;
+    bsv21;
+    overlay;
+    // Optional fallback to wallet-toolbox Services for methods we don't implement
+    fallbackServices;
+    /**
+     * URL for wallet storage sync endpoint (BRC-100 JSON-RPC).
+     * Used by StorageClient for remote wallet backup/sync.
+     */
+    get storageUrl() {
+        return `${this.baseUrl}/1sat/wallet`;
+    }
+    constructor(chain, baseUrl, fallbackServices) {
+        this.fallbackServices = fallbackServices;
+        this.chain = chain;
+        this.baseUrl =
+            baseUrl || (chain === 'main' ? ONESAT_MAINNET_URL : ONESAT_TESTNET_URL);
+        const opts = { timeout: 30000 };
+        this.chaintracks = new ChaintracksClient(this.baseUrl, opts);
+        this.beef = new BeefClient(this.baseUrl, opts);
+        this.arcade = new ArcadeClient(this.baseUrl, opts);
+        this.txo = new TxoClient(this.baseUrl, opts);
+        this.owner = new OwnerClient(this.baseUrl, opts);
+        this.ordfs = new OrdfsClient(this.baseUrl, opts);
+        this.bsv21 = new Bsv21Client(this.baseUrl, opts);
+        this.overlay = new OverlayClient(this.baseUrl, opts);
+    }
+    // ===== Utility Methods =====
+    /**
+     * Get list of enabled capabilities from the server
+     */
+    async getCapabilities() {
+        const response = await fetch(`${this.baseUrl}/capabilities`);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch capabilities: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Close all client connections
+     */
+    close() {
+        this.chaintracks.close();
+    }
+    // ===== WalletServices Interface (Required by wallet-toolbox) =====
+    async getRawTx(txid, _useNext) {
+        // This is a network-only call for the WalletServices interface.
+        // Wallet should check storage before calling this.
+        try {
+            const beefBytes = await this.beef.getBeef(txid);
+            const tx = Transaction.fromBEEF(Array.from(beefBytes));
+            return { txid, name: '1sat-api', rawTx: Array.from(tx.toBinary()) };
+        }
+        catch (error) {
+            return {
+                txid,
+                error: new ServiceError('NETWORK_ERROR', error instanceof Error ? error.message : 'Unknown error'),
+            };
+        }
+    }
+    async getChainTracker() {
+        return this.chaintracks;
+    }
+    async getHeaderForHeight(height) {
+        return this.chaintracks.getHeaderBytes(height);
+    }
+    async getHeight() {
+        return this.chaintracks.currentHeight();
+    }
+    async getMerklePath(txid, _useNext) {
+        console.log('[OneSatServices] getMerklePath called for txid:', txid);
+        try {
+            const proofBytes = await this.beef.getProof(txid);
+            const merklePath = MerklePath.fromBinary([...proofBytes]);
+            console.log('[OneSatServices] getMerklePath got proof, blockHeight:', merklePath.blockHeight);
+            // Fetch the block header for this merkle path
+            const header = await this.chaintracks.findHeaderForHeight(merklePath.blockHeight);
+            if (!header) {
+                console.log('[OneSatServices] getMerklePath header not found for height:', merklePath.blockHeight);
+                return {
+                    name: '1sat-api',
+                    error: new ServiceError('HEADER_NOT_FOUND', `Block header not found for height ${merklePath.blockHeight}`),
+                };
+            }
+            console.log('[OneSatServices] getMerklePath success, returning merklePath and header');
+            return { name: '1sat-api', merklePath, header };
+        }
+        catch (error) {
+            console.error('[OneSatServices] getMerklePath error:', error);
+            return {
+                name: '1sat-api',
+                error: new ServiceError('NETWORK_ERROR', error instanceof Error ? error.message : 'Unknown error'),
+            };
+        }
+    }
+    async postBeef(beef, txids, _logger) {
+        console.log('[OneSatServices] postBeef called with txids:', txids);
+        console.log(`[OneSatServices] BEEF structure:\n${beef.toLogString()}`);
+        const results = [];
+        for (const txid of txids) {
+            try {
+                // Submit as AtomicBEEF which includes all source transactions
+                console.log('[OneSatServices] Submitting tx to arcade:', txid);
+                const atomicBeef = beef.toBinaryAtomic(txid);
+                console.log('[OneSatServices] AtomicBEEF length:', atomicBeef.length, 'bytes');
+                // Parse back to verify structure
+                const verifyBeef = Beef.fromBinary(atomicBeef);
+                console.log(`[OneSatServices] AtomicBEEF parsed back:\n${verifyBeef.toLogString()}`);
+                // TODO: Remove hardcoded callback headers after server testing
+                const status = await this.arcade.submitTransaction(atomicBeef, {
+                    callbackUrl: `${this.baseUrl}/1sat/arc/callback`,
+                    callbackToken: 'test-callback-token',
+                });
+                console.log('[OneSatServices] Arcade response:', status);
+                if (status.txStatus === 'MINED' ||
+                    status.txStatus === 'SEEN_ON_NETWORK' ||
+                    status.txStatus === 'ACCEPTED_BY_NETWORK') {
+                    results.push({
+                        name: '1sat-api',
+                        status: 'success',
+                        txidResults: [{ txid: status.txid || txid, status: 'success' }],
+                    });
+                }
+                else if (status.txStatus === 'REJECTED' ||
+                    status.txStatus === 'DOUBLE_SPEND_ATTEMPTED') {
+                    results.push({
+                        name: '1sat-api',
+                        status: 'error',
+                        error: new ServiceError(status.txStatus, status.extraInfo || 'Transaction rejected'),
+                        txidResults: [{ txid, status: 'error', data: status }],
+                    });
+                }
+                else {
+                    // Still processing - report as success since tx was accepted
+                    results.push({
+                        name: '1sat-api',
+                        status: 'success',
+                        txidResults: [{ txid: status.txid || txid, status: 'success' }],
+                    });
+                }
+            }
+            catch (error) {
+                console.error('[OneSatServices] postBeef error:', error);
+                results.push({
+                    name: '1sat-api',
+                    status: 'error',
+                    error: new ServiceError('NETWORK_ERROR', error instanceof Error ? error.message : 'Unknown error'),
+                    txidResults: [{ txid, status: 'error' }],
+                });
+            }
+        }
+        return results;
+    }
+    async getBeefForTxid(txid) {
+        const beefBytes = await this.beef.getBeef(txid);
+        return Beef.fromBinary(Array.from(beefBytes));
+    }
+    hashOutputScript(script) {
+        const scriptBin = Utils.toArray(script, 'hex');
+        return Utils.toHex(Hash.hash256(scriptBin).reverse());
+    }
+    getServicesCallHistory(_reset) {
+        const emptyHistory = {
+            serviceName: '',
+            historyByProvider: {},
+        };
+        return {
+            version: 1,
+            getMerklePath: { ...emptyHistory, serviceName: 'getMerklePath' },
+            getRawTx: { ...emptyHistory, serviceName: 'getRawTx' },
+            postBeef: { ...emptyHistory, serviceName: 'postBeef' },
+            getUtxoStatus: { ...emptyHistory, serviceName: 'getUtxoStatus' },
+            getStatusForTxids: {
+                ...emptyHistory,
+                serviceName: 'getStatusForTxids',
+            },
+            getScriptHashHistory: {
+                ...emptyHistory,
+                serviceName: 'getScriptHashHistory',
+            },
+            updateFiatExchangeRates: {
+                ...emptyHistory,
+                serviceName: 'updateFiatExchangeRates',
+            },
+        };
+    }
+    // ===== WalletServices Interface (Delegated to fallback) =====
+    async getBsvExchangeRate() {
+        if (!this.fallbackServices) {
+            throw new Error('getBsvExchangeRate not implemented');
+        }
+        return this.fallbackServices.getBsvExchangeRate();
+    }
+    async getFiatExchangeRate(currency, base) {
+        if (!this.fallbackServices) {
+            throw new Error('getFiatExchangeRate not implemented');
+        }
+        return this.fallbackServices.getFiatExchangeRate(currency, base);
+    }
+    async getStatusForTxids(txids, _useNext) {
+        const results = [];
+        let currentHeight;
+        for (const txid of txids) {
+            try {
+                // Try Arcade first (only knows about txs broadcast through it)
+                const status = await this.arcade.getStatus(txid);
+                if (status.txStatus === 'MINED' || status.txStatus === 'IMMUTABLE') {
+                    // Get current height for depth calculation if we haven't already
+                    if (currentHeight === undefined) {
+                        currentHeight = await this.getHeight();
+                    }
+                    const depth = status.blockHeight
+                        ? currentHeight - status.blockHeight + 1
+                        : 1;
+                    results.push({ txid, status: 'mined', depth });
+                }
+                else if (status.txStatus === 'SEEN_ON_NETWORK' ||
+                    status.txStatus === 'ACCEPTED_BY_NETWORK' ||
+                    status.txStatus === 'SENT_TO_NETWORK' ||
+                    status.txStatus === 'RECEIVED') {
+                    results.push({ txid, status: 'known', depth: 0 });
+                }
+                else {
+                    // REJECTED, DOUBLE_SPEND_ATTEMPTED, UNKNOWN - fall back to Beef
+                    results.push(await this.getStatusFromBeef(txid));
+                }
+            }
+            catch {
+                // Arcade 404 or error - fall back to Beef storage
+                // NOTE: If Arcade's scope is too limited (only knows txs it broadcast),
+                // consider using Beef storage as the primary source instead.
+                results.push(await this.getStatusFromBeef(txid));
+            }
+        }
+        return {
+            name: '1sat-api',
+            status: 'success',
+            results,
+        };
+    }
+    /**
+     * Helper to get tx status from Beef storage (fallback when Arcade doesn't know the tx)
+     */
+    async getStatusFromBeef(txid) {
+        try {
+            const beefBytes = await this.beef.getBeef(txid);
+            const tx = Transaction.fromBEEF(Array.from(beefBytes));
+            if (tx.merklePath) {
+                // Has a valid merkle path = mined
+                const currentHeight = await this.getHeight();
+                const depth = currentHeight - tx.merklePath.blockHeight + 1;
+                return { txid, status: 'mined', depth };
+            }
+            // No merkle path = known but not yet mined
+            return { txid, status: 'known', depth: 0 };
+        }
+        catch {
+            // 404 or error from Beef = unknown
+            return { txid, status: 'unknown', depth: undefined };
+        }
+    }
+    async isUtxo(output) {
+        const outpoint = `${output.txid}_${output.vout}`;
+        const spendTxid = await this.txo.getSpend(outpoint);
+        return spendTxid === null;
+    }
+    async getUtxoStatus(_output, _outputFormat, outpoint, _useNext) {
+        // We ignore _output (script hash) since we look up directly by outpoint
+        if (!outpoint) {
+            return {
+                name: '1sat-api',
+                status: 'error',
+                error: new ServiceError('INVALID_PARAMETER', 'outpoint is required for getUtxoStatus'),
+                details: [],
+            };
+        }
+        try {
+            const txo = await this.txo.get(outpoint, {
+                sats: true,
+                spend: true,
+                block: true,
+            });
+            const isUtxo = !txo.spend;
+            const [txid, voutStr] = txo.outpoint.split('_');
+            const vout = Number.parseInt(voutStr, 10);
+            return {
+                name: '1sat-api',
+                status: 'success',
+                isUtxo,
+                details: isUtxo
+                    ? [
+                        {
+                            txid,
+                            index: vout,
+                            satoshis: txo.satoshis,
+                            height: txo.blockHeight,
+                        },
+                    ]
+                    : [],
+            };
+        }
+        catch {
+            // TXO not found - treat as not a UTXO
+            return {
+                name: '1sat-api',
+                status: 'success',
+                isUtxo: false,
+                details: [],
+            };
+        }
+    }
+    async getScriptHashHistory(hash, useNext, logger) {
+        if (!this.fallbackServices) {
+            throw new Error('getScriptHashHistory not implemented');
+        }
+        return this.fallbackServices.getScriptHashHistory(hash, useNext, logger);
+    }
+    async hashToHeader(hash) {
+        const header = await this.chaintracks.findHeaderForBlockHash(hash);
+        if (!header) {
+            throw new Error(`Block header not found for hash: ${hash}`);
+        }
+        return header;
+    }
+    async nLockTimeIsFinal(txOrLockTime) {
+        const MAXINT = 0xffffffff;
+        const BLOCK_LIMIT = 500000000;
+        let nLockTime;
+        if (typeof txOrLockTime === 'number') {
+            nLockTime = txOrLockTime;
+        }
+        else {
+            let tx;
+            if (typeof txOrLockTime === 'string') {
+                tx = Transaction.fromHex(txOrLockTime);
+            }
+            else if (Array.isArray(txOrLockTime)) {
+                tx = Transaction.fromBinary(txOrLockTime);
+            }
+            else {
+                tx = txOrLockTime;
+            }
+            // If all inputs have max sequence, the transaction is final regardless of lockTime
+            if (tx.inputs.every((i) => i.sequence === MAXINT)) {
+                return true;
+            }
+            nLockTime = tx.lockTime;
+        }
+        // If lockTime >= BLOCK_LIMIT, it's a timestamp (seconds since epoch)
+        if (nLockTime >= BLOCK_LIMIT) {
+            const currentTime = Math.floor(Date.now() / 1000);
+            return nLockTime < currentTime;
+        }
+        // Otherwise, it's a block height
+        const height = await this.getHeight();
+        return nLockTime < height;
+    }
+}
+//# sourceMappingURL=OneSatServices.js.map

package/dist/services/OneSatServices.js.map

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

package/dist/services/OrdfsClient.d.ts

@@ -0,0 +1,48 @@
+import type { ClientOptions, OrdfsContentOptions, OrdfsContentResponse, OrdfsMetadata } from '@1sat/types';
+import { BaseClient } from './BaseClient';
+/**
+ * Client for ordfs routes.
+ * Provides inscription content and metadata.
+ *
+ * Content is served from /content (e.g., https://1sat.shruggr.cloud/content/:outpoint)
+ * API routes use /1sat/ordfs (e.g., https://1sat.shruggr.cloud/1sat/ordfs/metadata/:outpoint)
+ */
+export declare class OrdfsClient extends BaseClient {
+    private readonly contentBaseUrl;
+    constructor(baseUrl: string, options?: ClientOptions);
+    /**
+     * Get metadata for an inscription
+     * @param outpoint - Outpoint (txid_vout) or txid
+     * @param seq - Optional sequence number (-1 for latest)
+     */
+    getMetadata(outpoint: string, seq?: number): Promise<OrdfsMetadata>;
+    /**
+     * Get inscription content with full response headers
+     * @param outpoint - Outpoint (txid_vout) or txid
+     * @param options - Content request options
+     */
+    getContent(outpoint: string, options?: OrdfsContentOptions): Promise<OrdfsContentResponse>;
+    /**
+     * Preview base64-encoded HTML content
+     * @param b64HtmlData - Base64-encoded HTML
+     */
+    previewHtml(b64HtmlData: string): Promise<string>;
+    /**
+     * Preview content by posting it directly
+     * @param content - Content to preview
+     * @param contentType - Content type header
+     */
+    previewContent(content: Uint8Array, contentType: string): Promise<Uint8Array>;
+    /**
+     * Get the URL for fetching inscription content directly.
+     * Useful for displaying in img/video tags.
+     * @param outpoint - Outpoint (txid_vout) or txid
+     * @param options - Content request options
+     */
+    getContentUrl(outpoint: string, options?: OrdfsContentOptions): string;
+    /**
+     * Parse response headers into structured object
+     */
+    private parseResponseHeaders;
+}
+//# sourceMappingURL=OrdfsClient.d.ts.map

package/dist/services/OrdfsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrdfsClient.d.ts","sourceRoot":"","sources":["../../src/services/OrdfsClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EAEb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAE3B,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;IAMxD;;;;OAIG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKzE;;;;OAIG;IACG,UAAU,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,mBAAwB,GAC/B,OAAO,CAAC,oBAAoB,CAAC;IA0BhC;;;OAGG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKvD;;;;OAIG;IACG,cAAc,CACnB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC;IAQtB;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM;IAe1E;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAgC5B"}

package/dist/services/OrdfsClient.js

@@ -0,0 +1,124 @@
+import { BaseClient } from './BaseClient';
+/**
+ * Client for ordfs routes.
+ * Provides inscription content and metadata.
+ *
+ * Content is served from /content (e.g., https://1sat.shruggr.cloud/content/:outpoint)
+ * API routes use /1sat/ordfs (e.g., https://1sat.shruggr.cloud/1sat/ordfs/metadata/:outpoint)
+ */
+export class OrdfsClient extends BaseClient {
+    contentBaseUrl;
+    constructor(baseUrl, options = {}) {
+        super(`${baseUrl}/1sat/ordfs`, options);
+        // Content is at root /content, not under /1sat/
+        this.contentBaseUrl = `${baseUrl.replace(/\/$/, '')}/content`;
+    }
+    /**
+     * Get metadata for an inscription
+     * @param outpoint - Outpoint (txid_vout) or txid
+     * @param seq - Optional sequence number (-1 for latest)
+     */
+    async getMetadata(outpoint, seq) {
+        const path = seq !== undefined ? `${outpoint}:${seq}` : outpoint;
+        return this.request(`/metadata/${path}`);
+    }
+    /**
+     * Get inscription content with full response headers
+     * @param outpoint - Outpoint (txid_vout) or txid
+     * @param options - Content request options
+     */
+    async getContent(outpoint, options = {}) {
+        const url = this.getContentUrl(outpoint, options);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await this.fetchFn(url, {
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch content: ${response.statusText}`);
+            }
+            const headers = this.parseResponseHeaders(response);
+            const arrayBuffer = await response.arrayBuffer();
+            return {
+                data: new Uint8Array(arrayBuffer),
+                headers,
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Preview base64-encoded HTML content
+     * @param b64HtmlData - Base64-encoded HTML
+     */
+    async previewHtml(b64HtmlData) {
+        const response = await this.requestRaw(`/preview/${b64HtmlData}`);
+        return response.text();
+    }
+    /**
+     * Preview content by posting it directly
+     * @param content - Content to preview
+     * @param contentType - Content type header
+     */
+    async previewContent(content, contentType) {
+        return this.requestBinary('/preview', {
+            method: 'POST',
+            headers: { 'Content-Type': contentType },
+            body: content,
+        });
+    }
+    /**
+     * Get the URL for fetching inscription content directly.
+     * Useful for displaying in img/video tags.
+     * @param outpoint - Outpoint (txid_vout) or txid
+     * @param options - Content request options
+     */
+    getContentUrl(outpoint, options = {}) {
+        let path = outpoint;
+        if (options.seq !== undefined) {
+            path = `${outpoint}:${options.seq}`;
+        }
+        const queryParams = this.buildQueryString({
+            map: options.map,
+            parent: options.parent,
+            raw: options.raw,
+        });
+        return `${this.contentBaseUrl}/${path}${queryParams}`;
+    }
+    /**
+     * Parse response headers into structured object
+     */
+    parseResponseHeaders(response) {
+        const headers = {
+            contentType: response.headers.get('content-type') || 'application/octet-stream',
+        };
+        const outpoint = response.headers.get('x-outpoint');
+        if (outpoint)
+            headers.outpoint = outpoint;
+        const origin = response.headers.get('x-origin');
+        if (origin)
+            headers.origin = origin;
+        const seq = response.headers.get('x-ord-seq');
+        if (seq)
+            headers.sequence = Number.parseInt(seq, 10);
+        const cacheControl = response.headers.get('cache-control');
+        if (cacheControl)
+            headers.cacheControl = cacheControl;
+        const mapData = response.headers.get('x-map');
+        if (mapData) {
+            try {
+                headers.map = JSON.parse(mapData);
+            }
+            catch {
+                // Invalid JSON, skip
+            }
+        }
+        const parent = response.headers.get('x-parent');
+        if (parent)
+            headers.parent = parent;
+        return headers;
+    }
+}
+//# sourceMappingURL=OrdfsClient.js.map

package/dist/services/OrdfsClient.js.map

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

package/dist/services/OverlayClient.d.ts

@@ -0,0 +1,50 @@
+import type { ClientOptions } from '@1sat/types';
+import { BaseClient } from './BaseClient';
+/** Topic manager metadata returned by listTopicManagers */
+export interface TopicManagerInfo {
+    name?: string;
+    description?: string;
+    icon?: string;
+    [key: string]: unknown;
+}
+/** Lookup service provider metadata returned by listLookupServiceProviders */
+export interface LookupServiceInfo {
+    [key: string]: unknown;
+}
+/**
+ * Client for overlay service routes.
+ * Handles topic manager queries and overlay lookups.
+ */
+export declare class OverlayClient extends BaseClient {
+    constructor(baseUrl: string, options?: ClientOptions);
+    /**
+     * List all registered topic managers.
+     */
+    listTopicManagers(): Promise<Record<string, TopicManagerInfo>>;
+    /**
+     * List all registered lookup service providers.
+     */
+    listLookupServiceProviders(): Promise<Record<string, LookupServiceInfo>>;
+    /**
+     * Submit a transaction to the overlay service for indexing.
+     * @param beef - BEEF data as Uint8Array or number[]
+     * @param topics - Topic names to submit to (e.g., ["tm_tokenId"])
+     */
+    submit(beef: Uint8Array | number[], topics: string[]): Promise<{
+        status: string;
+        txid?: string;
+        message?: string;
+    }>;
+    /**
+     * Submit a BSV-21 token transaction to the overlay.
+     * Convenience method that formats the topic correctly.
+     * @param beef - BEEF data
+     * @param tokenId - Token ID (txid_vout format)
+     */
+    submitBsv21(beef: Uint8Array | number[], tokenId: string): Promise<{
+        status: string;
+        txid?: string;
+        message?: string;
+    }>;
+}
+//# sourceMappingURL=OverlayClient.d.ts.map

package/dist/services/OverlayClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayClient.d.ts","sourceRoot":"","sources":["../../src/services/OverlayClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;IAIxD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAMpE;;OAEG;IACG,0BAA0B,IAAI,OAAO,CAC1C,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CACjC;IAMD;;;;OAIG;IACG,MAAM,CACX,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,EAC3B,MAAM,EAAE,MAAM,EAAE,GACd,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgB/D;;;;;OAKG;IACG,WAAW,CAChB,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,EAC3B,OAAO,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAG/D"}