@anywalletkit/wallet-zcash 0.0.0-stage → 0.2.1

package/dist/history-DQNeEwXE.d.cts

@@ -0,0 +1,304 @@
+import { ChainTx, HistoryPage, HistorySource, HistoryQuery } from '@anywalletkit/core';
+
+/** Zcash mainnet or testnet. */
+type ZcashNetwork = 'mainnet' | 'testnet';
+/** CAIP-2 ids the SDK uses for Zcash (the swap2 catalog already names `zcash:mainnet`). */
+declare const CAIP2: Record<ZcashNetwork, string>;
+/** An unspent transparent output the account can spend. */
+interface Utxo {
+    txid: string;
+    vout: number;
+    /** Zatoshis. */
+    value: bigint;
+    /** Block height; -1 while in the mempool. */
+    height: number;
+}
+/** A previous output a transaction spends — ZIP-244 signs its value AND script. */
+interface SpentOutput {
+    value: bigint;
+    script: Uint8Array;
+}
+/** Transport-neutral transaction record (receipts, confirmations). */
+interface ZcashTxInfo {
+    txid: string;
+    /** -1 or 0 while unconfirmed. */
+    blockHeight: number;
+    confirmations: number;
+    fee?: bigint;
+    /** Unix seconds. */
+    blockTime?: number;
+}
+/** Minimal chain-data client every transport implements. Values in zatoshis. */
+interface ZcashClient {
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    getBalance(address: string): Promise<{
+        confirmed: bigint;
+        unconfirmed: bigint;
+    }>;
+    listUnspent(address: string): Promise<Utxo[]>;
+    /** Raw transaction hex (any version — only used to read prevouts and for receipts). */
+    getTransaction(txid: string): Promise<string>;
+    /** Value + scriptPubKey of one output of an existing transaction (what signing a spend of it needs). */
+    getOutput(txid: string, vout: number): Promise<SpentOutput | undefined>;
+    getTransactionInfo(txid: string): Promise<ZcashTxInfo | undefined>;
+    /** Broadcast raw hex; returns the txid. */
+    broadcast(rawTx: string): Promise<string>;
+    /** Current chain tip height (expiry height, anti-fee-sniping lock time, consensus branch selection). */
+    getBlockHeight(): Promise<number>;
+}
+/** One transport to a Zcash indexer: Blockchair or a Blockbook instance. */
+type ZcashClientConfig = 
+/** Blockchair's public REST API (`https://api.blockchair.com/zcash`; optional API key). Mainnet only. */
+{
+    type: 'blockchair';
+    clientConfig?: {
+        url?: string;
+        key?: string;
+    };
+}
+/** A Zcash Blockbook (NOWNodes `https://zec-blockbook.nownodes.io` with an `api-key` header, a self-hosted instance, …). */
+ | {
+    type: 'blockbook-http';
+    clientConfig: {
+        url: string;
+        headers?: Record<string, string>;
+    };
+};
+/**
+ * Options for a Zcash wallet manager or account: transports, network and fee limits. Transparent
+ * addresses only.
+ */
+interface ZcashConfig {
+    /** One or more transports (config objects or ready `ZcashClient`s). A list fails over in order. Omit for an offline (sign-only) wallet. */
+    client?: ZcashClientConfig | ZcashClient | Array<ZcashClientConfig | ZcashClient>;
+    network?: ZcashNetwork;
+    /** Extra attempts across the client list after the first failure (default 3). */
+    retries?: number;
+    /** Per-request timeout in ms (default 15000). */
+    timeoutMs?: number;
+    /** Max fee (zatoshis) for `transfer`. */
+    transferMaxFee?: bigint | number;
+    /** Max fee (zatoshis) for `sendTransaction` / `signTransaction`. */
+    transactionMaxFee?: bigint | number;
+    /** Hard fee ceiling in zatoshis for any transaction this account signs or broadcasts (default 1 000 000 = 0.01 ZEC). */
+    maxFee?: bigint | number;
+    /** Blocks after the tip at which an unmined transaction expires (ZIP-203; default 40, the zcashd/Zebra default). 0 = never. */
+    expiryDelta?: number;
+    /** Set nLockTime to the tip height so the transaction cannot be mined into a reorged block (default true). */
+    antiFeeSniping?: boolean;
+    /**
+     * Consensus branch id to sign under. Default: picked from the tip height
+     * (`branchIdForHeight`) — set this when a network upgrade activates before
+     * the package learns its id.
+     */
+    consensusBranchId?: number;
+    /** Coin-selection input cap (default 200). */
+    maxInputs?: number;
+    /** Injectable fetch (tests, custom agents). Defaults to globalThis.fetch. */
+    fetch?: typeof fetch;
+}
+/** A spend. `value` in zatoshis. `fee` overrides the ZIP-317 conventional fee (still subject to `maxFee`). */
+interface ZcashSpend {
+    to: string;
+    value: bigint | number | string;
+    fee?: bigint | number;
+}
+/** `sendTransaction` accepts a spend or an already signed raw transaction hex. */
+type ZcashTransaction = ZcashSpend | string;
+/** A transparent ZEC transfer. Amount in zatoshis. */
+interface ZcashTransferOptions {
+    /** Not supported on Zcash; present for the shared account interface. */
+    token?: string;
+    recipient: string;
+    amount: bigint | number | string;
+}
+/** A mined Zcash transaction. */
+interface ZcashReceipt {
+    hash: string;
+    /** Always 1 once mined — a transparent transaction cannot fail after inclusion. */
+    status: 1;
+    blockNumber: bigint;
+    confirmations: number;
+    fee?: bigint;
+}
+/** The most one transaction can send (a sweep of every UTXO), after the fee. */
+interface ZcashMaxSpendableResult {
+    /** Max zatoshis one transaction can send after the fee. 0n when nothing is spendable. */
+    amount: bigint;
+    fee: bigint;
+    /** Always 0n: a sweep leaves no change. */
+    changeValue: bigint;
+    inputs: number;
+}
+/** Problems a described transaction is flagged with. */
+type ZcashWarning = 
+/** Fee exceeds 10 % of the amount sent. */
+'fee-over-10pct-of-amount'
+/** Fee is below the ZIP-317 conventional fee — nodes may not relay it. */
+ | 'fee-below-conventional'
+/** An output is below the dust floor. */
+ | 'dust-output'
+/** Change was below dust and folded into the fee. */
+ | 'no-change'
+/** No expiry height: the transaction stays valid in mempools indefinitely. */
+ | 'no-expiry';
+/** One input of a described transaction: the UTXO it spends. */
+interface ZcashTxInputDescription {
+    txid: string;
+    vout: number;
+    value: bigint;
+    address: string | undefined;
+}
+/** One output of a described transaction, tagged as the recipient, our change, or unknown. */
+interface ZcashTxOutputDescription {
+    /** Undefined for scripts without an address form. */
+    address: string | undefined;
+    value: bigint;
+    role: 'recipient' | 'change' | 'unknown';
+}
+/** "What you sign": the fully resolved transaction before (or after) signing. */
+interface ZcashTxDescription {
+    kind: 'zcash-transfer';
+    version: 5;
+    consensusBranchId: number;
+    inputs: ZcashTxInputDescription[];
+    outputs: ZcashTxOutputDescription[];
+    /** Zatoshis sent to non-change outputs. */
+    amount: bigint;
+    fee: bigint;
+    /** The ZIP-317 fee this transaction's shape calls for. */
+    conventionalFee: bigint;
+    /** Serialized size in bytes. */
+    size: number;
+    lockTime: number;
+    expiryHeight: number;
+    /** Present once the transaction is signed. */
+    txid?: string;
+    warnings: ZcashWarning[];
+}
+
+/** Default Blockchair API root for Zcash. */
+declare const BLOCKCHAIR_URL = "https://api.blockchair.com/zcash";
+interface BlockchairTxRow {
+    block_id: number;
+    hash: string;
+    time?: string;
+    fee?: number;
+    input_count?: number;
+    output_count?: number;
+}
+interface BlockchairOutput {
+    index: number;
+    value: number;
+    script_hex: string;
+    recipient?: string;
+}
+interface BlockchairInput extends BlockchairOutput {
+    transaction_hash: string;
+    spending_index?: number;
+    spending_sequence?: number;
+}
+interface BlockchairTxDashboard {
+    transaction: BlockchairTxRow;
+    inputs: BlockchairInput[];
+    outputs: BlockchairOutput[];
+}
+/** "2026-10-18 10:05:14" (UTC) → unix seconds. */
+declare function blockchairTime(s: string | undefined): number | undefined;
+declare class BlockchairClient implements ZcashClient {
+    private readonly base;
+    private readonly key;
+    private readonly fetchFn;
+    private readonly timeoutMs;
+    constructor(config?: {
+        url?: string;
+        key?: string;
+    }, fetchFn?: typeof fetch, timeoutMs?: number);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    private url;
+    private request;
+    private dashboard;
+    /** Transaction hashes of an address, newest first, paged by offset (what the activity history walks). */
+    listTransactions(address: string, limit: number, offset: number): Promise<{
+        hashes: string[];
+        total: number | undefined;
+    }>;
+    /** Confirmed = the UTXOs mined so far; unconfirmed = incoming mempool outputs. (Beyond 1000 UTXOs the dashboard balance is used.) */
+    getBalance(address: string): Promise<{
+        confirmed: bigint;
+        unconfirmed: bigint;
+    }>;
+    listUnspent(address: string): Promise<Utxo[]>;
+    getTransaction(txid: string): Promise<string>;
+    /** Inputs / outputs with addresses, values and scripts — what the activity history and prevout lookups read. */
+    getTransactionDashboard(txid: string): Promise<BlockchairTxDashboard | undefined>;
+    /** Several transactions in one call (Blockchair takes up to 10 comma-separated hashes). */
+    getTransactionDashboards(txids: string[]): Promise<Map<string, BlockchairTxDashboard>>;
+    getOutput(txid: string, vout: number): Promise<SpentOutput | undefined>;
+    getTransactionInfo(txid: string): Promise<ZcashTxInfo | undefined>;
+    broadcast(rawTx: string): Promise<string>;
+    getBlockHeight(): Promise<number>;
+}
+
+/**
+ * Activity history for Zcash transparent addresses: a `HistorySource` over
+ * Blockchair's address dashboard (transaction hashes, newest first) and
+ * transaction dashboards (inputs / outputs with addresses and values, fetched
+ * ten at a time). Shielded legs of a transaction show up only as the
+ * transparent value that entered or left it.
+ */
+
+/** Options for {@link createZcashHistory}. */
+interface ZcashHistoryOptions {
+    /** Blockchair base (`https://api.blockchair.com/zcash`); optional API key. */
+    blockchairUrl?: string;
+    key?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+    /** Rows per page (max 100). Default: the query limit, capped at 100. */
+    pageSize?: number;
+}
+interface ZcashHistoryRaw {
+    tx: BlockchairTxDashboard;
+    ownIn: bigint;
+    ownOut: bigint;
+}
+interface ZcashChainTx extends ChainTx {
+    raw: ZcashHistoryRaw;
+}
+interface ZcashHistoryPage extends HistoryPage {
+    items: ZcashChainTx[];
+    offset: number;
+    total?: number;
+}
+/** Zcash transparent-address history from Blockchair. Build it with {@link createZcashHistory}. */
+interface ZcashHistorySource extends HistorySource {
+    listActivity(address: string, query?: HistoryQuery): Promise<ZcashHistoryPage>;
+    getTransaction(hash: string, address: string): Promise<ZcashChainTx | undefined>;
+}
+/** The history backend failed. */
+declare class HistoryUnavailableError extends Error {
+    readonly chain: string;
+    readonly reason: string;
+    constructor(chain: string, reason: string);
+}
+interface ZcashHistoryCursor {
+    v: 1;
+    o: number;
+    s: number;
+}
+declare function encodeCursor(c: ZcashHistoryCursor): string;
+declare function decodeCursor(s: string): ZcashHistoryCursor;
+declare function mapDashboardTx(chain: string, address: string, d: BlockchairTxDashboard): ZcashChainTx;
+/** Blockchair link for a transaction. */
+declare function zcashExplorerTxUrl(hash: string): string;
+/**
+ * A history source for transparent Zcash addresses backed by Blockchair (mainnet).
+ *
+ * @throws Error when no `fetch` is available.
+ */
+declare function createZcashHistory(options?: ZcashHistoryOptions): ZcashHistorySource;
+
+export { zcashExplorerTxUrl as A, BLOCKCHAIR_URL as B, CAIP2 as C, HistoryUnavailableError as H, type SpentOutput as S, type Utxo as U, type ZcashNetwork as Z, type ZcashTxDescription as a, type ZcashClient as b, type ZcashTxInfo as c, type ZcashConfig as d, type ZcashSpend as e, type ZcashTransferOptions as f, type ZcashMaxSpendableResult as g, type ZcashReceipt as h, type ZcashTransaction as i, BlockchairClient as j, type BlockchairTxDashboard as k, type ZcashChainTx as l, type ZcashClientConfig as m, type ZcashHistoryCursor as n, type ZcashHistoryOptions as o, type ZcashHistoryPage as p, type ZcashHistoryRaw as q, type ZcashHistorySource as r, type ZcashTxInputDescription as s, type ZcashTxOutputDescription as t, type ZcashWarning as u, blockchairTime as v, createZcashHistory as w, decodeCursor as x, encodeCursor as y, mapDashboardTx as z };

package/dist/history-DQNeEwXE.d.ts

@@ -0,0 +1,304 @@
+import { ChainTx, HistoryPage, HistorySource, HistoryQuery } from '@anywalletkit/core';
+
+/** Zcash mainnet or testnet. */
+type ZcashNetwork = 'mainnet' | 'testnet';
+/** CAIP-2 ids the SDK uses for Zcash (the swap2 catalog already names `zcash:mainnet`). */
+declare const CAIP2: Record<ZcashNetwork, string>;
+/** An unspent transparent output the account can spend. */
+interface Utxo {
+    txid: string;
+    vout: number;
+    /** Zatoshis. */
+    value: bigint;
+    /** Block height; -1 while in the mempool. */
+    height: number;
+}
+/** A previous output a transaction spends — ZIP-244 signs its value AND script. */
+interface SpentOutput {
+    value: bigint;
+    script: Uint8Array;
+}
+/** Transport-neutral transaction record (receipts, confirmations). */
+interface ZcashTxInfo {
+    txid: string;
+    /** -1 or 0 while unconfirmed. */
+    blockHeight: number;
+    confirmations: number;
+    fee?: bigint;
+    /** Unix seconds. */
+    blockTime?: number;
+}
+/** Minimal chain-data client every transport implements. Values in zatoshis. */
+interface ZcashClient {
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    getBalance(address: string): Promise<{
+        confirmed: bigint;
+        unconfirmed: bigint;
+    }>;
+    listUnspent(address: string): Promise<Utxo[]>;
+    /** Raw transaction hex (any version — only used to read prevouts and for receipts). */
+    getTransaction(txid: string): Promise<string>;
+    /** Value + scriptPubKey of one output of an existing transaction (what signing a spend of it needs). */
+    getOutput(txid: string, vout: number): Promise<SpentOutput | undefined>;
+    getTransactionInfo(txid: string): Promise<ZcashTxInfo | undefined>;
+    /** Broadcast raw hex; returns the txid. */
+    broadcast(rawTx: string): Promise<string>;
+    /** Current chain tip height (expiry height, anti-fee-sniping lock time, consensus branch selection). */
+    getBlockHeight(): Promise<number>;
+}
+/** One transport to a Zcash indexer: Blockchair or a Blockbook instance. */
+type ZcashClientConfig = 
+/** Blockchair's public REST API (`https://api.blockchair.com/zcash`; optional API key). Mainnet only. */
+{
+    type: 'blockchair';
+    clientConfig?: {
+        url?: string;
+        key?: string;
+    };
+}
+/** A Zcash Blockbook (NOWNodes `https://zec-blockbook.nownodes.io` with an `api-key` header, a self-hosted instance, …). */
+ | {
+    type: 'blockbook-http';
+    clientConfig: {
+        url: string;
+        headers?: Record<string, string>;
+    };
+};
+/**
+ * Options for a Zcash wallet manager or account: transports, network and fee limits. Transparent
+ * addresses only.
+ */
+interface ZcashConfig {
+    /** One or more transports (config objects or ready `ZcashClient`s). A list fails over in order. Omit for an offline (sign-only) wallet. */
+    client?: ZcashClientConfig | ZcashClient | Array<ZcashClientConfig | ZcashClient>;
+    network?: ZcashNetwork;
+    /** Extra attempts across the client list after the first failure (default 3). */
+    retries?: number;
+    /** Per-request timeout in ms (default 15000). */
+    timeoutMs?: number;
+    /** Max fee (zatoshis) for `transfer`. */
+    transferMaxFee?: bigint | number;
+    /** Max fee (zatoshis) for `sendTransaction` / `signTransaction`. */
+    transactionMaxFee?: bigint | number;
+    /** Hard fee ceiling in zatoshis for any transaction this account signs or broadcasts (default 1 000 000 = 0.01 ZEC). */
+    maxFee?: bigint | number;
+    /** Blocks after the tip at which an unmined transaction expires (ZIP-203; default 40, the zcashd/Zebra default). 0 = never. */
+    expiryDelta?: number;
+    /** Set nLockTime to the tip height so the transaction cannot be mined into a reorged block (default true). */
+    antiFeeSniping?: boolean;
+    /**
+     * Consensus branch id to sign under. Default: picked from the tip height
+     * (`branchIdForHeight`) — set this when a network upgrade activates before
+     * the package learns its id.
+     */
+    consensusBranchId?: number;
+    /** Coin-selection input cap (default 200). */
+    maxInputs?: number;
+    /** Injectable fetch (tests, custom agents). Defaults to globalThis.fetch. */
+    fetch?: typeof fetch;
+}
+/** A spend. `value` in zatoshis. `fee` overrides the ZIP-317 conventional fee (still subject to `maxFee`). */
+interface ZcashSpend {
+    to: string;
+    value: bigint | number | string;
+    fee?: bigint | number;
+}
+/** `sendTransaction` accepts a spend or an already signed raw transaction hex. */
+type ZcashTransaction = ZcashSpend | string;
+/** A transparent ZEC transfer. Amount in zatoshis. */
+interface ZcashTransferOptions {
+    /** Not supported on Zcash; present for the shared account interface. */
+    token?: string;
+    recipient: string;
+    amount: bigint | number | string;
+}
+/** A mined Zcash transaction. */
+interface ZcashReceipt {
+    hash: string;
+    /** Always 1 once mined — a transparent transaction cannot fail after inclusion. */
+    status: 1;
+    blockNumber: bigint;
+    confirmations: number;
+    fee?: bigint;
+}
+/** The most one transaction can send (a sweep of every UTXO), after the fee. */
+interface ZcashMaxSpendableResult {
+    /** Max zatoshis one transaction can send after the fee. 0n when nothing is spendable. */
+    amount: bigint;
+    fee: bigint;
+    /** Always 0n: a sweep leaves no change. */
+    changeValue: bigint;
+    inputs: number;
+}
+/** Problems a described transaction is flagged with. */
+type ZcashWarning = 
+/** Fee exceeds 10 % of the amount sent. */
+'fee-over-10pct-of-amount'
+/** Fee is below the ZIP-317 conventional fee — nodes may not relay it. */
+ | 'fee-below-conventional'
+/** An output is below the dust floor. */
+ | 'dust-output'
+/** Change was below dust and folded into the fee. */
+ | 'no-change'
+/** No expiry height: the transaction stays valid in mempools indefinitely. */
+ | 'no-expiry';
+/** One input of a described transaction: the UTXO it spends. */
+interface ZcashTxInputDescription {
+    txid: string;
+    vout: number;
+    value: bigint;
+    address: string | undefined;
+}
+/** One output of a described transaction, tagged as the recipient, our change, or unknown. */
+interface ZcashTxOutputDescription {
+    /** Undefined for scripts without an address form. */
+    address: string | undefined;
+    value: bigint;
+    role: 'recipient' | 'change' | 'unknown';
+}
+/** "What you sign": the fully resolved transaction before (or after) signing. */
+interface ZcashTxDescription {
+    kind: 'zcash-transfer';
+    version: 5;
+    consensusBranchId: number;
+    inputs: ZcashTxInputDescription[];
+    outputs: ZcashTxOutputDescription[];
+    /** Zatoshis sent to non-change outputs. */
+    amount: bigint;
+    fee: bigint;
+    /** The ZIP-317 fee this transaction's shape calls for. */
+    conventionalFee: bigint;
+    /** Serialized size in bytes. */
+    size: number;
+    lockTime: number;
+    expiryHeight: number;
+    /** Present once the transaction is signed. */
+    txid?: string;
+    warnings: ZcashWarning[];
+}
+
+/** Default Blockchair API root for Zcash. */
+declare const BLOCKCHAIR_URL = "https://api.blockchair.com/zcash";
+interface BlockchairTxRow {
+    block_id: number;
+    hash: string;
+    time?: string;
+    fee?: number;
+    input_count?: number;
+    output_count?: number;
+}
+interface BlockchairOutput {
+    index: number;
+    value: number;
+    script_hex: string;
+    recipient?: string;
+}
+interface BlockchairInput extends BlockchairOutput {
+    transaction_hash: string;
+    spending_index?: number;
+    spending_sequence?: number;
+}
+interface BlockchairTxDashboard {
+    transaction: BlockchairTxRow;
+    inputs: BlockchairInput[];
+    outputs: BlockchairOutput[];
+}
+/** "2026-10-18 10:05:14" (UTC) → unix seconds. */
+declare function blockchairTime(s: string | undefined): number | undefined;
+declare class BlockchairClient implements ZcashClient {
+    private readonly base;
+    private readonly key;
+    private readonly fetchFn;
+    private readonly timeoutMs;
+    constructor(config?: {
+        url?: string;
+        key?: string;
+    }, fetchFn?: typeof fetch, timeoutMs?: number);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    private url;
+    private request;
+    private dashboard;
+    /** Transaction hashes of an address, newest first, paged by offset (what the activity history walks). */
+    listTransactions(address: string, limit: number, offset: number): Promise<{
+        hashes: string[];
+        total: number | undefined;
+    }>;
+    /** Confirmed = the UTXOs mined so far; unconfirmed = incoming mempool outputs. (Beyond 1000 UTXOs the dashboard balance is used.) */
+    getBalance(address: string): Promise<{
+        confirmed: bigint;
+        unconfirmed: bigint;
+    }>;
+    listUnspent(address: string): Promise<Utxo[]>;
+    getTransaction(txid: string): Promise<string>;
+    /** Inputs / outputs with addresses, values and scripts — what the activity history and prevout lookups read. */
+    getTransactionDashboard(txid: string): Promise<BlockchairTxDashboard | undefined>;
+    /** Several transactions in one call (Blockchair takes up to 10 comma-separated hashes). */
+    getTransactionDashboards(txids: string[]): Promise<Map<string, BlockchairTxDashboard>>;
+    getOutput(txid: string, vout: number): Promise<SpentOutput | undefined>;
+    getTransactionInfo(txid: string): Promise<ZcashTxInfo | undefined>;
+    broadcast(rawTx: string): Promise<string>;
+    getBlockHeight(): Promise<number>;
+}
+
+/**
+ * Activity history for Zcash transparent addresses: a `HistorySource` over
+ * Blockchair's address dashboard (transaction hashes, newest first) and
+ * transaction dashboards (inputs / outputs with addresses and values, fetched
+ * ten at a time). Shielded legs of a transaction show up only as the
+ * transparent value that entered or left it.
+ */
+
+/** Options for {@link createZcashHistory}. */
+interface ZcashHistoryOptions {
+    /** Blockchair base (`https://api.blockchair.com/zcash`); optional API key. */
+    blockchairUrl?: string;
+    key?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+    /** Rows per page (max 100). Default: the query limit, capped at 100. */
+    pageSize?: number;
+}
+interface ZcashHistoryRaw {
+    tx: BlockchairTxDashboard;
+    ownIn: bigint;
+    ownOut: bigint;
+}
+interface ZcashChainTx extends ChainTx {
+    raw: ZcashHistoryRaw;
+}
+interface ZcashHistoryPage extends HistoryPage {
+    items: ZcashChainTx[];
+    offset: number;
+    total?: number;
+}
+/** Zcash transparent-address history from Blockchair. Build it with {@link createZcashHistory}. */
+interface ZcashHistorySource extends HistorySource {
+    listActivity(address: string, query?: HistoryQuery): Promise<ZcashHistoryPage>;
+    getTransaction(hash: string, address: string): Promise<ZcashChainTx | undefined>;
+}
+/** The history backend failed. */
+declare class HistoryUnavailableError extends Error {
+    readonly chain: string;
+    readonly reason: string;
+    constructor(chain: string, reason: string);
+}
+interface ZcashHistoryCursor {
+    v: 1;
+    o: number;
+    s: number;
+}
+declare function encodeCursor(c: ZcashHistoryCursor): string;
+declare function decodeCursor(s: string): ZcashHistoryCursor;
+declare function mapDashboardTx(chain: string, address: string, d: BlockchairTxDashboard): ZcashChainTx;
+/** Blockchair link for a transaction. */
+declare function zcashExplorerTxUrl(hash: string): string;
+/**
+ * A history source for transparent Zcash addresses backed by Blockchair (mainnet).
+ *
+ * @throws Error when no `fetch` is available.
+ */
+declare function createZcashHistory(options?: ZcashHistoryOptions): ZcashHistorySource;
+
+export { zcashExplorerTxUrl as A, BLOCKCHAIR_URL as B, CAIP2 as C, HistoryUnavailableError as H, type SpentOutput as S, type Utxo as U, type ZcashNetwork as Z, type ZcashTxDescription as a, type ZcashClient as b, type ZcashTxInfo as c, type ZcashConfig as d, type ZcashSpend as e, type ZcashTransferOptions as f, type ZcashMaxSpendableResult as g, type ZcashReceipt as h, type ZcashTransaction as i, BlockchairClient as j, type BlockchairTxDashboard as k, type ZcashChainTx as l, type ZcashClientConfig as m, type ZcashHistoryCursor as n, type ZcashHistoryOptions as o, type ZcashHistoryPage as p, type ZcashHistoryRaw as q, type ZcashHistorySource as r, type ZcashTxInputDescription as s, type ZcashTxOutputDescription as t, type ZcashWarning as u, blockchairTime as v, createZcashHistory as w, decodeCursor as x, encodeCursor as y, mapDashboardTx as z };