/**
 * Consolidated type definitions for 1sat-stack API clients.
 * These types mirror the structures returned by the 1sat-stack server.
 */
/**
 * Options for configuring API clients
 */
export interface ClientOptions {
    /** Request timeout in milliseconds (default: 30000) */
    timeout?: number;
    /** Custom fetch implementation */
    fetch?: typeof fetch;
}
/**
 * Server capabilities returned by /1sat/capabilities endpoint.
 * These match the actual capability names from 1sat-stack.
 */
export type Capability = "beef" | "pubsub" | "txo" | "owner" | "indexer" | "bsv21" | "ordfs" | "chaintracks" | "arcade" | "overlay";
/**
 * Block header data returned by chaintracks endpoints
 */
export interface BlockHeader {
    height: number;
    hash: string;
    version: number;
    prevHash: string;
    merkleRoot: string;
    time: number;
    bits: number;
    nonce: number;
}
/**
 * Transaction status values from arcade
 */
export type TxStatus = "UNKNOWN" | "RECEIVED" | "SENT_TO_NETWORK" | "ACCEPTED_BY_NETWORK" | "SEEN_ON_NETWORK" | "DOUBLE_SPEND_ATTEMPTED" | "REJECTED" | "MINED" | "IMMUTABLE";
/**
 * Transaction status response from arcade
 */
export interface TransactionStatus {
    txid: string;
    txStatus: TxStatus;
    timestamp: string;
    blockHash?: string;
    blockHeight?: number;
    merklePath?: string;
    extraInfo?: string;
    competingTxs?: string[];
}
/**
 * Options for submitting transactions to arcade
 */
export interface SubmitOptions {
    /** URL for status callbacks */
    callbackUrl?: string;
    /** Token for authenticating callbacks */
    callbackToken?: string;
    /** Receive all status updates, not just final */
    fullStatusUpdates?: boolean;
    /** Skip fee validation */
    skipFeeValidation?: boolean;
    /** Skip script validation */
    skipScriptValidation?: boolean;
}
/**
 * Mining policy from arcade
 */
export interface Policy {
    maxscriptsizepolicy: number;
    maxtxsigopscountspolicy: number;
    maxtxsizepolicy: number;
    miningFee: {
        satoshis: number;
        bytes: number;
    };
}
/**
 * Indexed transaction output.
 * Base fields (outpoint, score) are always present.
 * Other fields are present based on query options.
 */
export interface IndexedOutput {
    outpoint: string;
    score: number;
    satoshis?: number;
    blockHeight?: number;
    blockIdx?: number;
    spend?: string;
    events?: string[];
    data?: Record<string, unknown>;
}
/**
 * Spend information response
 */
export interface SpendResponse {
    spendTxid: string | null;
}
/**
 * Options for querying TXOs
 */
export interface TxoQueryOptions {
    /** Starting score for pagination */
    from?: number;
    /** Maximum results to return */
    limit?: number;
    /** Reverse order */
    rev?: boolean;
    /** Filter for unspent only */
    unspent?: boolean;
    /** Include satoshis in response */
    sats?: boolean;
    /** Include spend txid in response */
    spend?: boolean;
    /** Include events array in response */
    events?: boolean;
    /** Include blockHeight and blockIdx in response */
    block?: boolean;
    /** Data tags to include in response */
    tags?: string[];
}
/**
 * Balance response from owner endpoint
 */
export interface BalanceResponse {
    balance: number;
    count: number;
}
/**
 * Sync output streamed via SSE
 */
export interface SyncOutput {
    outpoint: string;
    score: number;
    spendTxid?: string;
}
/**
 * Indexed output from parse/ingest operations
 */
export interface IndexedTxo {
    outpoint: string;
    satoshis: number;
    script?: string;
    owners?: string[];
    events?: string[];
    data?: Record<string, unknown>;
}
/**
 * Index context returned by parse/ingest
 */
export interface IndexContext {
    txid: string;
    score: number;
    outputs: IndexedTxo[];
}
/**
 * OrdFS metadata for an inscription
 */
export interface OrdfsMetadata {
    outpoint: string;
    origin?: string;
    sequence: number;
    contentType: string;
    contentLength: number;
    parent?: string;
    map?: Record<string, unknown>;
}
/**
 * Options for OrdFS content requests
 */
export interface OrdfsContentOptions {
    /** Sequence number (-1 for latest, 0+ for specific sequence) */
    seq?: number;
    /** Include MAP data in X-Map header */
    map?: boolean;
    /** Include parent outpoint in X-Parent header */
    parent?: boolean;
    /** Return raw directory JSON instead of resolving */
    raw?: boolean;
}
/**
 * Headers returned from OrdFS content responses
 */
export interface OrdfsResponseHeaders {
    contentType: string;
    outpoint?: string;
    origin?: string;
    sequence?: number;
    cacheControl?: string;
    map?: Record<string, unknown>;
    parent?: string;
}
/**
 * Full content response from OrdFS including headers
 */
export interface OrdfsContentResponse {
    data: Uint8Array;
    headers: OrdfsResponseHeaders;
}
/**
 * BSV21 token data structure from overlay API
 */
export interface Bsv21TokenData {
    id: string;
    op: string;
    amt: string;
    sym?: string;
    dec?: string;
    icon?: string;
    address?: string;
}
/**
 * BSV21 token detail response from GET /bsv21/:tokenId and POST /bsv21/lookup
 */
export interface TokenDetailResponse {
    tokenId: string;
    token: Bsv21TokenData;
    status: TokenStatus;
}
/**
 * BSV21 token funding/activity status
 */
export interface TokenStatus {
    token_id: string;
    is_active: boolean;
    balance: number;
    credits: number;
    debits: number;
    output_count: number;
    fee_per_output: number;
    fee_address: string;
    is_whitelisted: boolean;
    is_blacklisted: boolean;
}
/**
 * BSV21 output data from overlay API
 */
export interface Bsv21OutputData {
    txid?: string;
    vout: number;
    data: {
        bsv21: Bsv21TokenData;
    };
    spend?: string | null;
    score?: number;
}
/**
 * BSV21 transaction data from overlay API
 */
export interface Bsv21TransactionData {
    txid: string;
    inputs: Bsv21OutputData[];
    outputs: Bsv21OutputData[];
    beef?: string;
    block_height?: number;
}
/**
 * Event from SSE subscription
 */
export interface SseEvent {
    topic: string;
    data: string;
    score?: number;
}