@bsv/wallet-toolbox 1.7.13 → 1.7.15

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/Transaction.d.ts

@@ -0,0 +1,299 @@
+import TransactionInput from './TransactionInput.js';
+import TransactionOutput from './TransactionOutput.js';
+import { Reader } from '../primitives/utils.js';
+import FeeModel from './FeeModel.js';
+import { Broadcaster, BroadcastResponse, BroadcastFailure } from './Broadcaster.js';
+import MerklePath from './MerklePath.js';
+import ChainTracker from './ChainTracker.js';
+/**
+ * Represents a complete Bitcoin transaction. This class encapsulates all the details
+ * required for creating, signing, and processing a Bitcoin transaction, including
+ * inputs, outputs, and various transaction-related methods.
+ *
+ * @class Transaction
+ * @property {number} version - The version number of the transaction. Used to specify
+ *           which set of rules this transaction follows.
+ * @property {TransactionInput[]} inputs - An array of TransactionInput objects, representing
+ *           the inputs for the transaction. Each input references a previous transaction's output.
+ * @property {TransactionOutput[]} outputs - An array of TransactionOutput objects, representing
+ *           the outputs for the transaction. Each output specifies the amount of satoshis to be
+ *           transferred and the conditions under which they can be spent.
+ * @property {number} lockTime - The lock time of the transaction. If non-zero, it specifies the
+ *           earliest time or block height at which the transaction can be added to the block chain.
+ * @property {Record<string, any>} metadata - A key-value store for attaching additional data to
+ *           the transaction object, not included in the transaction itself. Useful for adding descriptions, internal reference numbers, or other information.
+ * @property {MerkleProof} [merklePath] - Optional. A merkle proof demonstrating the transaction's
+ *           inclusion in a block. Useful for transaction verification using SPV.
+ *
+ * @example
+ * // Creating a new transaction
+ * let tx = new Transaction();
+ * tx.addInput(...);
+ * tx.addOutput(...);
+ * await tx.fee();
+ * await tx.sign();
+ * await tx.broadcast();
+ *
+ * @description
+ * The Transaction class provides comprehensive
+ * functionality to handle various aspects of transaction creation, including
+ * adding inputs and outputs, computing fees, signing the transaction, and
+ * generating its binary or hexadecimal representation.
+ */
+export default class Transaction {
+    version: number;
+    inputs: TransactionInput[];
+    outputs: TransactionOutput[];
+    lockTime: number;
+    metadata: Record<string, any>;
+    merklePath?: MerklePath;
+    private cachedHash?;
+    private rawBytesCache?;
+    private hexCache?;
+    private static addPathOrInputs;
+    /**
+     * Creates a new transaction, linked to its inputs and their associated merkle paths, from a BEEF V1, V2 or Atomic.
+     * Optionally, you can provide a specific TXID to retrieve a particular transaction from the BEEF data.
+     * If the TXID is provided but not found in the BEEF data, an error will be thrown.
+     * If no TXID is provided, the last transaction in the BEEF data is returned, or the atomic txid.
+     * @param beef A binary representation of transactions in BEEF format.
+     * @param txid Optional TXID of the transaction to retrieve from the BEEF data.
+     * @returns An anchored transaction, linked to its associated inputs populated with merkle paths.
+     */
+    static fromBEEF(beef: number[], txid?: string): Transaction;
+    /**
+     * Creates a new transaction from an Atomic BEEF (BRC-95) structure.
+     * Extracts the subject transaction and supporting merkle path and source transactions contained in the BEEF data
+     *
+     * @param beef A binary representation of an Atomic BEEF structure.
+     * @returns The subject transaction, linked to its associated inputs populated with merkle paths.
+     */
+    static fromAtomicBEEF(beef: number[]): Transaction;
+    private static fromAnyBeef;
+    /**
+     * Creates a new transaction, linked to its inputs and their associated merkle paths, from a EF (BRC-30) structure.
+     * @param ef A binary representation of a transaction in EF format.
+     * @returns An extended transaction, linked to its associated inputs by locking script and satoshis amounts only.
+     */
+    static fromEF(ef: number[]): Transaction;
+    /**
+     * Since the validation of blockchain data is atomically transaction data validation,
+     * any application seeking to validate data in output scripts must store the entire transaction as well.
+     * Since the transaction data includes the output script data, saving a second copy of potentially
+     * large scripts can bloat application storage requirements.
+     *
+     * This function efficiently parses binary transaction data to determine the offsets and lengths of each script.
+     * This supports the efficient retreival of script data from transaction data.
+     *
+     * @param bin binary transaction data
+     * @returns {
+     *   inputs: { vin: number, offset: number, length: number }[]
+     *   outputs: { vout: number, offset: number, length: number }[]
+     * }
+     */
+    static parseScriptOffsets(bin: number[]): {
+        inputs: Array<{
+            vin: number;
+            offset: number;
+            length: number;
+        }>;
+        outputs: Array<{
+            vout: number;
+            offset: number;
+            length: number;
+        }>;
+    };
+    static fromReader(br: Reader): Transaction;
+    /**
+     * Creates a Transaction instance from a binary array.
+     *
+     * @static
+     * @param {number[]} bin - The binary array representation of the transaction.
+     * @returns {Transaction} - A new Transaction instance.
+     */
+    static fromBinary(bin: number[]): Transaction;
+    /**
+     * Creates a Transaction instance from a hexadecimal string.
+     *
+     * @static
+     * @param {string} hex - The hexadecimal string representation of the transaction.
+     * @returns {Transaction} - A new Transaction instance.
+     */
+    static fromHex(hex: string): Transaction;
+    /**
+     * Creates a Transaction instance from a hexadecimal string encoded EF.
+     *
+     * @static
+     * @param {string} hex - The hexadecimal string representation of the transaction EF.
+     * @returns {Transaction} - A new Transaction instance.
+     */
+    static fromHexEF(hex: string): Transaction;
+    /**
+     * Creates a Transaction instance from a hexadecimal string encoded BEEF.
+     * Optionally, you can provide a specific TXID to retrieve a particular transaction from the BEEF data.
+     * If the TXID is provided but not found in the BEEF data, an error will be thrown.
+     * If no TXID is provided, the last transaction in the BEEF data is returned.
+     *
+     * @static
+     * @param {string} hex - The hexadecimal string representation of the transaction BEEF.
+     * @param {string} [txid] - Optional TXID of the transaction to retrieve from the BEEF data.
+     * @returns {Transaction} - A new Transaction instance.
+     */
+    static fromHexBEEF(hex: string, txid?: string): Transaction;
+    constructor(version?: number, inputs?: TransactionInput[], outputs?: TransactionOutput[], lockTime?: number, metadata?: Record<string, any>, merklePath?: MerklePath);
+    private invalidateSerializationCaches;
+    /**
+     * Adds a new input to the transaction.
+     *
+     * @param {TransactionInput} input - The TransactionInput object to add to the transaction.
+     * @throws {Error} - If the input does not have a sourceTXID or sourceTransaction defined.
+     */
+    addInput(input: TransactionInput): void;
+    /**
+     * Adds a new output to the transaction.
+     *
+     * @param {TransactionOutput} output - The TransactionOutput object to add to the transaction.
+     */
+    addOutput(output: TransactionOutput): void;
+    /**
+     * Adds a new P2PKH output to the transaction.
+     *
+     * @param {number[] | string} address - The P2PKH address of the output.
+     * @param {number} [satoshis] - The number of satoshis to send to the address - if not provided, the output is considered a change output.
+     *
+     */
+    addP2PKHOutput(address: number[] | string, satoshis?: number): void;
+    /**
+     * Updates the transaction's metadata.
+     *
+     * @param {Record<string, any>} metadata - The metadata object to merge into the existing metadata.
+     */
+    updateMetadata(metadata: Record<string, any>): void;
+    /**
+     * Computes fees prior to signing.
+     * If no fee model is provided, uses a LivePolicy fee model that fetches current rates from ARC.
+     * If fee is a number, the transaction uses that value as fee.
+     *
+     * @param modelOrFee - The initialized fee model to use or fixed fee for the transaction
+     * @param changeDistribution - Specifies how the change should be distributed
+     * amongst the change outputs
+     *
+     */
+    fee(modelOrFee?: FeeModel | number, changeDistribution?: 'equal' | 'random'): Promise<void>;
+    private calculateChange;
+    private distributeChange;
+    private distributeRandomChange;
+    private distributeEqualChange;
+    private benfordNumber;
+    /**
+     * Utility method that returns the current fee based on inputs and outputs
+     *
+     * @returns The current transaction fee
+     */
+    getFee(): number;
+    /**
+     * Signs a transaction, hydrating all its unlocking scripts based on the provided script templates where they are available.
+     */
+    sign(): Promise<void>;
+    /**
+     * Broadcasts a transaction.
+     *
+     * @param broadcaster The Broadcaster instance wwhere the transaction will be sent
+     * @returns A BroadcastResponse or BroadcastFailure from the Broadcaster
+     */
+    broadcast(broadcaster?: Broadcaster): Promise<BroadcastResponse | BroadcastFailure>;
+    private writeTransactionBody;
+    private buildSerializedBytes;
+    private getSerializedBytes;
+    /**
+     * Converts the transaction to a binary array format.
+     *
+     * @returns {number[]} - The binary array representation of the transaction.
+     */
+    toBinary(): number[];
+    toUint8Array(): Uint8Array;
+    /**
+     * Converts the transaction to a BRC-30 EF format.
+     *
+     * @returns {number[]} - The BRC-30 EF representation of the transaction.
+     */
+    toEF(): number[];
+    /**
+     * Converts the transaction to a hexadecimal string EF.
+     *
+     * @returns {string} - The hexadecimal string representation of the transaction EF.
+     */
+    toHexEF(): string;
+    /**
+     * Converts the transaction to a hexadecimal string format.
+     *
+     * @returns {string} - The hexadecimal string representation of the transaction.
+     */
+    toHex(): string;
+    /**
+     * Converts the transaction to a hexadecimal string BEEF.
+     *
+     * @returns {string} - The hexadecimal string representation of the transaction BEEF.
+     */
+    toHexBEEF(): string;
+    /**
+     * Converts the transaction to a hexadecimal string Atomic BEEF.
+     *
+     * @returns {string} - The hexadecimal string representation of the transaction Atomic BEEF.
+     */
+    toHexAtomicBEEF(): string;
+    /**
+     * Calculates the transaction's hash.
+     *
+     * @param {'hex' | undefined} enc - The encoding to use for the hash. If 'hex', returns a hexadecimal string; otherwise returns a binary array.
+     * @returns {string | number[]} - The hash of the transaction in the specified format.
+     */
+    hash(enc?: 'hex'): number[] | string;
+    /**
+     * Calculates the transaction's ID in binary array.
+     *
+     * @returns {number[]} - The ID of the transaction in the binary array format.
+     */
+    id(): number[];
+    /**
+     * Calculates the transaction's ID in hexadecimal format.
+     *
+     * @param {'hex'} enc - The encoding to use for the ID. If 'hex', returns a hexadecimal string.
+     * @returns {string} - The ID of the transaction in the hex format.
+     */
+    id(enc: 'hex'): string;
+    /**
+     * Verifies the legitimacy of the Bitcoin transaction according to the rules of SPV by ensuring all the input transactions link back to valid block headers, the chain of spends for all inputs are valid, and the sum of inputs is not less than the sum of outputs.
+     *
+     * @param chainTracker - An instance of ChainTracker, a Bitcoin block header tracker. If the value is set to 'scripts only', headers will not be verified. If not provided then the default chain tracker will be used.
+     * @param feeModel - An instance of FeeModel, a fee model to use for fee calculation. If not provided then the default fee model will be used.
+     * @param memoryLimit - The maximum memory in bytes usage allowed for script evaluation. If not provided then the default memory limit will be used.
+     *
+     * @returns Whether the transaction is valid according to the rules of SPV.
+     *
+     * @example tx.verify(new WhatsOnChain(), LivePolicy.getInstance())
+     */
+    verify(chainTracker?: ChainTracker | 'scripts only', feeModel?: FeeModel, memoryLimit?: number): Promise<boolean>;
+    /**
+     * Serializes this transaction, together with its inputs and the respective merkle proofs, into the BEEF (BRC-62) format. This enables efficient verification of its compliance with the rules of SPV.
+     *
+     * @param allowPartial If true, error will not be thrown if there are any missing sourceTransactions.
+     *
+     * @returns The serialized BEEF structure
+     * @throws Error if there are any missing sourceTransactions unless `allowPartial` is true.
+     */
+    toBEEF(allowPartial?: boolean): number[];
+    /**
+     * Serializes this transaction and its inputs into the Atomic BEEF (BRC-95) format.
+     * The Atomic BEEF format starts with a 4-byte prefix `0x01010101`, followed by the TXID of the subject transaction,
+     * and then the BEEF data containing only the subject transaction and its dependencies.
+     * This format ensures that the BEEF structure is atomic and contains no unrelated transactions.
+     *
+     * @param allowPartial If true, error will not be thrown if there are any missing sourceTransactions.
+     *
+     * @returns {number[]} - The serialized Atomic BEEF structure.
+     * @throws Error if there are any missing sourceTransactions unless `allowPartial` is true.
+     */
+    toAtomicBEEF(allowPartial?: boolean): number[];
+}
+//# sourceMappingURL=Transaction.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/Transaction.d.ts.map

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

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/TransactionInput.d.ts

@@ -0,0 +1,63 @@
+import UnlockingScript from '../script/UnlockingScript.js';
+import Transaction from './Transaction.js';
+/**
+ * Represents an input to a Bitcoin transaction.
+ * This interface defines the structure and components required to construct
+ * a transaction input in the Bitcoin blockchain.
+ *
+ * @interface TransactionInput
+ * @property {Transaction} [sourceTransaction] - Optional. The source transaction
+ *           from which this input is derived. This is the transaction whose output
+ *           is being spent by this input. Preferably provided if available.
+ * @property {string} [sourceTXID] - Optional. The transaction ID (TXID) of the source
+ *           transaction. Required if the source transaction itself is not provided.
+ *           This uniquely identifies the transaction within the blockchain.
+ * @property {number} sourceOutputIndex - The index of the output in the source transaction
+ *           that this input is spending. It is zero-based, indicating the position of the
+ *           output in the array of outputs of the source transaction.
+ * @property {UnlockingScript} [unlockingScript] - Optional. The script that 'unlocks' the
+ *           source output for spending. This script typically contains signatures and
+ *           public keys that evidence the ownership of the output.
+ * @property {Object} [unlockingScriptTemplate] - Optional. A template for generating the
+ *           unlocking script. Useful when the unlocking script needs to be generated
+ *           dynamically.
+ *    @property {Function} unlockingScriptTemplate.sign - A function that, when given the
+ *              current transaction and the index of this input, returns a Promise that
+ *              resolves to the UnlockingScript.
+ *    @property {Function} unlockingScriptTemplate.estimateLength - A function that estimates
+ *              the length of the unlocking script, given the transaction and the input index.
+ * @property {number} sequence - A sequence number for the input. Used to enable
+ *           updates to this input. If set to a non-final value (less than 0xFFFFFFFF),
+ *           it indicates that the input may be replaced in the future.
+ *
+ * @example
+ * // Creating a simple transaction input
+ * let txInput = {
+ *   sourceTXID: '123abc...',
+ *   sourceOutputIndex: 0,
+ *   sequence: 0xFFFFFFFF
+ * };
+ *
+ * // Using an unlocking script template
+ * txInput.unlockingScriptTemplate = {
+ *   sign: async (tx, index) => { ... },
+ *   estimateLength: async (tx, index) => { ... }
+ * };
+ *
+ * @description
+ * This interface links an input to a
+ * previous output and provides mechanisms (through unlocking scripts) to authorize the
+ * spending of that output.
+ */
+export default interface TransactionInput {
+    sourceTransaction?: Transaction;
+    sourceTXID?: string;
+    sourceOutputIndex: number;
+    unlockingScript?: UnlockingScript;
+    unlockingScriptTemplate?: {
+        sign: (tx: Transaction, inputIndex: number) => Promise<UnlockingScript>;
+        estimateLength: (tx: Transaction, inputIndex: number) => Promise<number>;
+    };
+    sequence?: number;
+}
+//# sourceMappingURL=TransactionInput.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/TransactionInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionInput.d.ts","sourceRoot":"","sources":["../../../../src/transaction/TransactionInput.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,8BAA8B,CAAA;AAC1D,OAAO,WAAW,MAAM,kBAAkB,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,CAAC,OAAO,WAAW,gBAAgB;IACvC,iBAAiB,CAAC,EAAE,WAAW,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,uBAAuB,CAAC,EAAE;QACxB,IAAI,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;QACvE,cAAc,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KACzE,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/TransactionOutput.d.ts

@@ -0,0 +1,36 @@
+import LockingScript from '../script/LockingScript.js';
+/**
+ * Represents an output in a Bitcoin transaction.
+ * This interface defines the structure and components necessary to construct
+ * a transaction output, which secures owned Bitcoins to be unlocked later.
+ *
+ * @interface TransactionOutput
+ * @property {number} [satoshis] - Optional. The amount of satoshis (the smallest unit of Bitcoin) to be transferred by this output.
+ * @property {LockingScript} lockingScript - The script that 'locks' the satoshis,
+ *           specifying the conditions under which they can be spent. This script is
+ *           essential for securing the funds and typically contains cryptographic
+ *           puzzles that need to be solved to spend the output.
+ * @property {boolean} [change] - Optional. A flag that indicates whether this output
+ *           is a change output. If true, it means this output is returning funds back
+ *           to the sender, usually as the 'change' from the transaction inputs.
+ *
+ * @example
+ * // Creating a simple transaction output
+ * let txOutput = {
+ *   satoshis: 1000,
+ *   lockingScript: LockingScript.fromASM('OP_DUP OP_HASH160 ... OP_EQUALVERIFY OP_CHECKSIG'),
+ *   change: false
+ * };
+ *
+ * @description
+ * The TransactionOutput interface defines how bitcoins are to be distributed in a transaction, either to a recipient or
+ * back to the sender as change. The lockingScript is critical as it determines the conditions
+ * under which the output can be spent, typically requiring a digital signature matching the
+ * intended recipient's public key.
+ */
+export default interface TransactionOutput {
+    satoshis?: number;
+    lockingScript: LockingScript;
+    change?: boolean;
+}
+//# sourceMappingURL=TransactionOutput.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/TransactionOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionOutput.d.ts","sourceRoot":"","sources":["../../../../src/transaction/TransactionOutput.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,4BAA4B,CAAA;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,OAAO,WAAW,iBAAiB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,aAAa,CAAA;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/ARC.d.ts

@@ -0,0 +1,64 @@
+import { BroadcastResponse, BroadcastFailure, Broadcaster } from '../Broadcaster.js';
+import Transaction from '../Transaction.js';
+import { HttpClient } from '../http/HttpClient.js';
+/** Configuration options for the ARC broadcaster. */
+export interface ArcConfig {
+    /** Authentication token for the ARC API */
+    apiKey?: string;
+    /** The HTTP client used to make requests to the ARC API. */
+    httpClient?: HttpClient;
+    /** Deployment id used annotating api calls in XDeployment-ID header - this value will be randomly generated if not set */
+    deploymentId?: string;
+    /** notification callback endpoint for proofs and double spend notification */
+    callbackUrl?: string;
+    /** default access token for notification callback endpoint. It will be used as a Authorization header for the http callback */
+    callbackToken?: string;
+    /** additional headers to be attached to all tx submissions. */
+    headers?: Record<string, string>;
+}
+/**
+ * Represents an ARC transaction broadcaster.
+ */
+export default class ARC implements Broadcaster {
+    readonly URL: string;
+    readonly apiKey: string | undefined;
+    readonly deploymentId: string;
+    readonly callbackUrl: string | undefined;
+    readonly callbackToken: string | undefined;
+    readonly headers: Record<string, string> | undefined;
+    private readonly httpClient;
+    /**
+     * Constructs an instance of the ARC broadcaster.
+     *
+     * @param {string} URL - The URL endpoint for the ARC API.
+     * @param {ArcConfig} config - Configuration options for the ARC broadcaster.
+     */
+    constructor(URL: string, config?: ArcConfig);
+    /**
+     * Constructs an instance of the ARC broadcaster.
+     *
+     * @param {string} URL - The URL endpoint for the ARC API.
+     * @param {string} apiKey - The API key used for authorization with the ARC API.
+     */
+    constructor(URL: string, apiKey?: string);
+    /**
+     * Constructs a dictionary of the default & supplied request headers.
+     */
+    private requestHeaders;
+    /**
+     * Broadcasts a transaction via ARC.
+     *
+     * @param {Transaction} tx - The transaction to be broadcasted.
+     * @returns {Promise<BroadcastResponse | BroadcastFailure>} A promise that resolves to either a success or failure response.
+     */
+    broadcast(tx: Transaction): Promise<BroadcastResponse | BroadcastFailure>;
+    /**
+     * Broadcasts multiple transactions via ARC.
+     * Handles mixed responses where some transactions succeed and others fail.
+     *
+     * @param {Transaction[]} txs - Array of transactions to be broadcasted.
+     * @returns {Promise<Array<object>>} A promise that resolves to an array of objects.
+     */
+    broadcastMany(txs: Transaction[]): Promise<object[]>;
+}
+//# sourceMappingURL=ARC.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/ARC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ARC.d.ts","sourceRoot":"","sources":["../../../../../src/transaction/broadcasters/ARC.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACZ,MAAM,mBAAmB,CAAA;AAC1B,OAAO,WAAW,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAA4B,MAAM,uBAAuB,CAAA;AAK5E,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,0HAA0H;IAC1H,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+HAA+H;IAC/H,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAMD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,GAAI,YAAW,WAAW;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IAEvC;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS;IAC3C;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IA6BxC;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;;;;OAKG;IACG,SAAS,CACb,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAgFhD;;;;;;OAMG;IACG,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAqC3D"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/DefaultBroadcaster.d.ts

@@ -0,0 +1,4 @@
+import { Broadcaster } from '../Broadcaster.js';
+import { ArcConfig } from './ARC.js';
+export declare function defaultBroadcaster(isTestnet?: boolean, config?: ArcConfig): Broadcaster;
+//# sourceMappingURL=DefaultBroadcaster.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/DefaultBroadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultBroadcaster.d.ts","sourceRoot":"","sources":["../../../../../src/transaction/broadcasters/DefaultBroadcaster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,wBAAgB,kBAAkB,CAChC,SAAS,GAAE,OAAe,EAC1B,MAAM,GAAE,SAAc,GACrB,WAAW,CAKb"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/Teranode.d.ts

@@ -0,0 +1,25 @@
+import { BroadcastResponse, BroadcastFailure, Broadcaster } from '../Broadcaster.js';
+import Transaction from '../Transaction.js';
+import { HttpClient } from '../http/index.js';
+/**
+ * Represents an Teranode transaction broadcaster.
+ */
+export default class Teranode implements Broadcaster {
+    readonly URL: string;
+    readonly httpClient: HttpClient;
+    /**
+     * Constructs an instance of the Teranode broadcaster.
+     *
+     * @param {string} URL - The URL endpoint for the Teranode API.
+     * @param {HttpClient} httpClient - The HTTP client used to make requests to the API, binaryHttpClient by default.
+     */
+    constructor(URL: string, httpClient?: HttpClient);
+    /**
+     * Broadcasts a transaction via Teranode.
+     *
+     * @param {Transaction} tx - The transaction to be broadcasted.
+     * @returns {Promise<BroadcastResponse | BroadcastFailure>} A promise that resolves to either a success or failure response.
+     */
+    broadcast(tx: Transaction): Promise<BroadcastResponse | BroadcastFailure>;
+}
+//# sourceMappingURL=Teranode.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/Teranode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Teranode.d.ts","sourceRoot":"","sources":["../../../../../src/transaction/broadcasters/Teranode.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACZ,MAAM,mBAAmB,CAAA;AAC1B,OAAO,WAAW,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAoB,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE/D;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,YAAW,WAAW;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAE/B;;;;;OAKG;gBAED,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,UAA+B;IAM7C;;;;;OAKG;IACG,SAAS,CACb,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;CAuCjD"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/WhatsOnChainBroadcaster.d.ts

@@ -0,0 +1,26 @@
+import { BroadcastResponse, BroadcastFailure, Broadcaster } from '../Broadcaster.js';
+import Transaction from '../Transaction.js';
+import { HttpClient } from '../http/HttpClient.js';
+/**
+ * Represents an WhatsOnChain transaction broadcaster.
+ */
+export default class WhatsOnChainBroadcaster implements Broadcaster {
+    readonly network: string;
+    private readonly URL;
+    private readonly httpClient;
+    /**
+     * Constructs an instance of the WhatsOnChain broadcaster.
+     *
+     * @param {'main' | 'test' | 'stn'} network - The BSV network to use when calling the WhatsOnChain API.
+     * @param {HttpClient} httpClient - The HTTP client used to make requests to the API.
+     */
+    constructor(network?: 'main' | 'test' | 'stn', httpClient?: HttpClient);
+    /**
+     * Broadcasts a transaction via WhatsOnChain.
+     *
+     * @param {Transaction} tx - The transaction to be broadcasted.
+     * @returns {Promise<BroadcastResponse | BroadcastFailure>} A promise that resolves to either a success or failure response.
+     */
+    broadcast(tx: Transaction): Promise<BroadcastResponse | BroadcastFailure>;
+}
+//# sourceMappingURL=WhatsOnChainBroadcaster.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/WhatsOnChainBroadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhatsOnChainBroadcaster.d.ts","sourceRoot":"","sources":["../../../../../src/transaction/broadcasters/WhatsOnChainBroadcaster.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACZ,MAAM,mBAAmB,CAAA;AAC1B,OAAO,WAAW,MAAM,mBAAmB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGlD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,YAAW,WAAW;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IAEvC;;;;;OAKG;gBAED,OAAO,GAAE,MAAM,GAAG,MAAM,GAAG,KAAc,EACzC,UAAU,GAAE,UAAgC;IAO9C;;;;;OAKG;IACG,SAAS,CACb,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;CA0CjD"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/index.d.ts

@@ -0,0 +1,6 @@
+export { default as ARC } from './ARC.js';
+export type { ArcConfig } from './ARC.js';
+export { default as WhatsOnChainBroadcaster } from './WhatsOnChainBroadcaster.js';
+export { default as Teranode } from './Teranode.js';
+export { defaultBroadcaster } from './DefaultBroadcaster.js';
+//# sourceMappingURL=index.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/broadcasters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/transaction/broadcasters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,UAAU,CAAA;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACjF,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/chaintrackers/BlockHeadersService.d.ts

@@ -0,0 +1,46 @@
+import ChainTracker from '../ChainTracker.js';
+import { HttpClient } from '../http/HttpClient.js';
+/** Configuration options for the BlockHeadersService ChainTracker. */
+export interface BlockHeadersServiceConfig {
+    /** The HTTP client used to make requests to the API. */
+    httpClient?: HttpClient;
+    /** The API key used to authenticate requests to the BlockHeadersService API. */
+    apiKey?: string;
+}
+/**
+ * Represents a chain tracker based on a BlockHeadersService API.
+ *
+ * @example
+ * ```typescript
+ * const chainTracker = new BlockHeadersService('https://headers.spv.money', {
+ *   apiKey: '17JxRHcJerGBEbusx56W8o1m8Js73TFGo'
+ * })
+ * ```
+ */
+export declare class BlockHeadersService implements ChainTracker {
+    protected readonly baseUrl: string;
+    protected readonly httpClient: HttpClient;
+    protected readonly apiKey: string;
+    /**
+     * Constructs an instance of the BlockHeadersService ChainTracker.
+     *
+     * @param {string} baseUrl - The base URL for the BlockHeadersService API (e.g. https://headers.spv.money)
+     * @param {BlockHeadersServiceConfig} config - Configuration options for the BlockHeadersService ChainTracker.
+     */
+    constructor(baseUrl: string, config?: BlockHeadersServiceConfig);
+    /**
+     * Verifies if a given merkle root is valid for a specific block height.
+     *
+     * @param {string} root - The merkle root to verify.
+     * @param {number} height - The block height to check against.
+     * @returns {Promise<boolean>} - A promise that resolves to true if the merkle root is valid for the specified block height, false otherwise.
+     */
+    isValidRootForHeight(root: string, height: number): Promise<boolean>;
+    /**
+     * Gets the current block height from the BlockHeadersService API.
+     *
+     * @returns {Promise<number>} - A promise that resolves to the current block height.
+     */
+    currentHeight(): Promise<number>;
+}
+//# sourceMappingURL=BlockHeadersService.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/chaintrackers/BlockHeadersService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockHeadersService.d.ts","sourceRoot":"","sources":["../../../../../src/transaction/chaintrackers/BlockHeadersService.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGlD,sEAAsE;AACtE,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,UAAU,CAAC,EAAE,UAAU,CAAA;IAEvB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAmBD;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAClC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IACzC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEjC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,yBAA8B;IAQxC;;;;;;OAMG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoC1E;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CA4BvC"}

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/chaintrackers/DefaultChainTracker.d.ts

@@ -0,0 +1,3 @@
+import ChainTracker from '../ChainTracker.js';
+export declare function defaultChainTracker(): ChainTracker;
+//# sourceMappingURL=DefaultChainTracker.d.ts.map

package/mobile/node_modules/@bsv/sdk/dist/types/src/transaction/chaintrackers/DefaultChainTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultChainTracker.d.ts","sourceRoot":"","sources":["../../../../../src/transaction/chaintrackers/DefaultChainTracker.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAE7C,wBAAgB,mBAAmB,IAAI,YAAY,CAElD"}