@arkade-os/sdk 0.4.26 → 0.4.28

package/dist/types/tree/txTree.d.ts

@@ -1,28 +0,0 @@
-import { Transaction } from "@scure/btc-signer/transaction.js";
-/**
- * TxTreeNode is a node of the tree.
- * It contains the transaction id, the transaction and the children.
- * any TxTree can be serialized as a list of TxTreeNode.
- */
-export type TxTreeNode = {
-    txid: string;
-    tx: string;
-    children: Record<number, string>;
-};
-/**
- * TxTree is a graph of bitcoin transactions.
- * It is used to represent batch tree created during settlement session
- */
-export declare class TxTree {
-    readonly root: Transaction;
-    readonly children: Map<number, TxTree>;
-    constructor(root: Transaction, children?: Map<number, TxTree>);
-    static create(chunks: TxTreeNode[]): TxTree;
-    nbOfNodes(): number;
-    validate(): void;
-    leaves(): Transaction[];
-    get txid(): string;
-    find(txid: string): TxTree | null;
-    update(txid: string, fn: (tx: Transaction) => void): void;
-    iterator(): Generator<TxTree, void, unknown>;
-}

package/dist/types/tree/validation.d.ts

@@ -1,15 +0,0 @@
-import { Transaction } from "@scure/btc-signer/transaction.js";
-import { TxTree } from "./txTree.js";
-export declare const ErrInvalidSettlementTx: (tx: string) => Error;
-export declare const ErrInvalidSettlementTxOutputs: Error;
-export declare const ErrEmptyTree: Error;
-export declare const ErrNumberOfInputs: Error;
-export declare const ErrWrongSettlementTxid: Error;
-export declare const ErrInvalidAmount: Error;
-export declare const ErrNoLeaves: Error;
-export declare const ErrInvalidTaprootScript: Error;
-export declare const ErrInvalidRoundTxOutputs: Error;
-export declare const ErrWrongCommitmentTxid: Error;
-export declare const ErrMissingCosignersPublicKeys: Error;
-export declare function validateConnectorsTxGraph(settlementTxB64: string, connectorsGraph: TxTree): void;
-export declare function validateVtxoTxGraph(graph: TxTree, roundTransaction: Transaction, sweepTapTreeRoot: Uint8Array): void;

package/dist/types/utils/anchor.d.ts

@@ -1,19 +0,0 @@
-import { Transaction } from "@scure/btc-signer";
-import { TransactionInputUpdate } from "@scure/btc-signer/psbt.js";
-export declare const ANCHOR_VALUE = 0n;
-export declare const ANCHOR_PKSCRIPT: Uint8Array<ArrayBuffer>;
-/**
- * A zero-value anchor output.
- */
-export declare const P2A: {
-    script: Uint8Array<ArrayBuffer>;
-    amount: bigint;
-};
-/**
- * search for anchor in the given transaction.
- * @throws {Error} if the anchor is not found or has the wrong amount
- */
-export declare function findP2AOutput(tx: Transaction): TransactionInputUpdate;
-export interface AnchorBumper {
-    bumpP2A(parent: Transaction): Promise<[string, string]>;
-}

package/dist/types/utils/arkTransaction.d.ts

@@ -1,49 +0,0 @@
-import { TransactionOutput } from "@scure/btc-signer/psbt.js";
-import { ExtendedCoin, VirtualCoin } from "../wallet/index.js";
-import { RelativeTimelock } from "../script/tapscript.js";
-import { EncodedVtxoScript, TapLeafScript } from "../script/base.js";
-import { CSVMultisigTapscript } from "../script/tapscript.js";
-import { Transaction } from "./transaction.js";
-export type ArkTxInput = {
-    tapLeafScript: TapLeafScript;
-} & EncodedVtxoScript & Pick<VirtualCoin, "txid" | "vout" | "value">;
-export type OffchainTx = {
-    arkTx: Transaction;
-    checkpoints: Transaction[];
-};
-/**
- * Builds an offchain transaction with checkpoint transactions.
- *
- * Creates one checkpoint transaction per input and a virtual transaction that
- * combines all the checkpoints, sending to the specified outputs. This is the
- * core function for creating Arkade transactions.
- *
- * @param inputs - Array of virtual transaction inputs
- * @param outputs - Array of transaction outputs
- * @param serverUnrollScript - Server unroll script for checkpoint transactions
- * @returns Object containing the virtual transaction and checkpoint transactions
- */
-export declare function buildOffchainTx(inputs: ArkTxInput[], outputs: TransactionOutput[], serverUnrollScript: CSVMultisigTapscript.Type): OffchainTx;
-export declare function hasBoardingTxExpired(coin: ExtendedCoin, boardingTimelock: RelativeTimelock, chainTipHeight?: number): boolean;
-/**
- * Verify tapscript signatures on a transaction input
- * @param tx Transaction to verify
- * @param inputIndex Index of the input to verify
- * @param requiredSigners List of required signer pubkeys (hex encoded)
- * @param excludePubkeys List of pubkeys to exclude from verification (hex encoded, e.g., server key not yet signed)
- * @param allowedSighashTypes List of allowed sighash types (defaults to [SigHash.DEFAULT])
- * @throws Error if verification fails
- */
-export declare function verifyTapscriptSignatures(tx: Transaction, inputIndex: number, requiredSigners: string[], excludePubkeys?: string[], allowedSighashTypes?: number[]): void;
-/**
- * Merges the signed transaction with the original transaction
- * @param signedTx signed transaction
- * @param originalTx original transaction
- */
-export declare function combineTapscriptSigs(signedTx: Transaction, originalTx: Transaction): Transaction;
-/**
- * Validates if a given string is a valid Arkade address by attempting to decode it.
- * @param address The Arkade address to validate.
- * @returns True if the address is valid, false otherwise.
- */
-export declare function isValidArkAddress(address: string): boolean;

package/dist/types/utils/bip21.d.ts

@@ -1,38 +0,0 @@
-/** Known BIP21 parameters including Arkade-specific extensions. */
-export interface BIP21Params {
-    address?: string;
-    amount?: number;
-    label?: string;
-    message?: string;
-    /** Optional Arkade address parameter. */
-    ark?: string;
-    /** Optional Silent Payment address parameter. */
-    sp?: string;
-    [key: string]: string | number | undefined;
-}
-/** Result returned by `BIP21.parse`. */
-export interface BIP21ParseResult {
-    originalString: string;
-    params: BIP21Params;
-}
-export declare enum BIP21Error {
-    INVALID_URI = "Invalid BIP21 URI",
-    INVALID_ADDRESS = "Invalid address"
-}
-export declare class BIP21 {
-    /**
-     * Create a BIP21 URI from the provided parameters.
-     *
-     * @param params - BIP21 parameters to encode
-     * @returns Encoded BIP21 URI
-     */
-    static create(params: BIP21Params): string;
-    /**
-     * Parse a BIP21 URI and return its decoded parameters.
-     *
-     * @param uri - BIP21 URI to parse
-     * @returns Parsed BIP21 URI data
-     * @throws Error if the URI does not start with the `bitcoin:` scheme
-     */
-    static parse(uri: string): BIP21ParseResult;
-}

package/dist/types/utils/syncCursors.d.ts

@@ -1,60 +0,0 @@
-import { WalletRepository, WalletState } from "../repositories/walletRepository.js";
-/** Lag behind real-time to avoid racing with indexer writes. */
-export declare const SAFETY_LAG_MS = 30000;
-/** Overlap window so boundary virtual outputs are never missed. */
-export declare const OVERLAP_MS: number;
-/**
- * Atomically read, mutate, and persist wallet state.
- * All callers that modify wallet state should go through this helper
- * to avoid lost-update races between interleaved async operations.
- */
-export declare function updateWalletState(repo: WalletRepository, updater: (state: WalletState) => WalletState): Promise<void>;
-/**
- * Read the global high-water mark for VTXO indexer syncs.
- *
- * Returns `0` when:
- *  - the wallet has never been synced (bootstrap case), or
- *  - the stored `lastSyncTime` was written by pre-PR code and is not
- *    safe to reuse under the new semantics (see {@link CURSOR_MIGRATED_KEY}).
- */
-export declare function getSyncCursor(repo: WalletRepository): Promise<number>;
-/**
- * Advance the global cursor after a successful full-scope delta sync.
- *
- * Clamped with `Math.max` against the current value so concurrent syncs
- * that finish out of order can't rewind the cursor: `lastUpdatedAt` is
- * captured before each sync enters the `updateWalletState` mutex, and
- * the later-started sync would otherwise overwrite the earlier-captured
- * one with a smaller value. The legacy value is discarded on the first
- * advance if the migration marker is absent so pre-PR data doesn't
- * survive the upgrade.
- */
-export declare function advanceSyncCursor(repo: WalletRepository, lastUpdatedAt: number): Promise<void>;
-/**
- * Remove the sync cursor, forcing a full re-bootstrap on next sync.
- *
- * Also clears the migration marker so any stored `lastSyncTime` is
- * treated as untrusted on the next read.
- */
-export declare function clearSyncCursor(repo: WalletRepository): Promise<void>;
-/**
- * Compute the `after` lower-bound for a delta sync query.
- *
- * No upper bound (`before`) is applied to the query so that freshly
- * created virtual outputs are never excluded. The safety lag is applied only
- * when advancing the cursor (see @see cursorCutoff).
- */
-export declare function computeSyncWindow(cursor: number): {
-    after: number;
-};
-/**
- * The safe high-water mark for cursor advancement.
- * Lags behind real-time by @see SAFETY_LAG_MS so that virtual outputs still
- * being indexed are re-queried on the next sync.
- *
- * When `requestStartedAt` is provided the cutoff is frozen to the
- * request start rather than wall-clock at commit time, preventing
- * long-running paginated fetches from advancing the cursor past the
- * data they actually observed.
- */
-export declare function cursorCutoff(requestStartedAt?: number): number;

package/dist/types/utils/timelock.d.ts

@@ -1,9 +0,0 @@
-import type { RelativeTimelock } from "../script/tapscript.js";
-/**
- * Convert RelativeTimelock to BIP68 sequence number.
- */
-export declare function timelockToSequence(timelock: RelativeTimelock): number;
-/**
- * Convert BIP68 sequence number back to RelativeTimelock.
- */
-export declare function sequenceToTimelock(sequence: number): RelativeTimelock;

package/dist/types/utils/transaction.d.ts

@@ -1,13 +0,0 @@
-import { Transaction as BtcSignerTransaction } from "@scure/btc-signer";
-import { TxOpts } from "@scure/btc-signer/transaction.js";
-import { Bytes } from "@scure/btc-signer/utils.js";
-/**
- * Transaction is a wrapper around the @scure/btc-signer Transaction class.
- * It adds the Arkade protocol specific options to the transaction.
- */
-export declare class Transaction extends BtcSignerTransaction {
-    static ARK_TX_OPTS: TxOpts;
-    constructor(opts?: TxOpts);
-    static fromPSBT(psbt_: Bytes, opts?: TxOpts): Transaction;
-    static fromRaw(raw: Bytes, opts?: TxOpts): Transaction;
-}

package/dist/types/utils/transactionHistory.d.ts

@@ -1,15 +0,0 @@
-import { ArkTransaction, VirtualCoin } from "../wallet/index.js";
-type ExtendedArkTransaction = ArkTransaction & {
-    tag: "offchain" | "boarding" | "exit" | "batch";
-};
-/**
- * Builds the transaction history by analyzing virtual outputs, boarding transactions, and ignored commitments.
- * History is sorted from newest to oldest and is composed only of SENT and RECEIVED transactions.
- *
- * @param {VirtualCoin[]} vtxos - An array of virtual outputs representing the user's transactions and balances.
- * @param {ArkTransaction[]} allBoardingTxs - An array of boarding transactions to include in the history.
- * @param {Set<string>} commitmentsToIgnore - A set of commitment IDs that should be excluded from processing.
- * @return {ExtendedArkTransaction[]} A sorted array of extended Arkade transactions, representing the transaction history.
- */
-export declare function buildTransactionHistory(vtxos: VirtualCoin[], allBoardingTxs: ArkTransaction[], commitmentsToIgnore: Set<string>, getTxCreatedAt?: (txid: string) => Promise<number | undefined>): Promise<ExtendedArkTransaction[]>;
-export {};

package/dist/types/utils/txSizeEstimator.d.ts

@@ -1,40 +0,0 @@
-import { Network } from "../networks.js";
-export type VSize = {
-    value: bigint;
-    fee(feeRate: bigint): bigint;
-};
-export declare class TxWeightEstimator {
-    static readonly P2PKH_SCRIPT_SIG_SIZE: number;
-    static readonly INPUT_SIZE: number;
-    static readonly BASE_CONTROL_BLOCK_SIZE: number;
-    static readonly OUTPUT_SIZE: number;
-    static readonly P2WPKH_OUTPUT_SIZE: number;
-    static readonly BASE_TX_SIZE: number;
-    static readonly WITNESS_HEADER_SIZE = 2;
-    static readonly WITNESS_SCALE_FACTOR = 4;
-    static readonly P2TR_OUTPUT_SIZE: number;
-    hasWitness: boolean;
-    inputCount: number;
-    outputCount: number;
-    inputSize: number;
-    inputWitnessSize: number;
-    outputSize: number;
-    private constructor();
-    static create(): TxWeightEstimator;
-    addP2AInput(): TxWeightEstimator;
-    addKeySpendInput(isDefault?: boolean): TxWeightEstimator;
-    addP2PKHInput(): TxWeightEstimator;
-    addTapscriptInput(leafWitnessSize: number, leafScriptSize: number, leafControlBlockSize: number): TxWeightEstimator;
-    addP2WPKHOutput(): TxWeightEstimator;
-    addP2TROutput(): TxWeightEstimator;
-    /**
-     * Adds an output given a raw script.
-     * Cost = 8 bytes (amount) + varint(scriptLen) + scriptLen
-     */
-    addOutputScript(script: Uint8Array): TxWeightEstimator;
-    /**
-     * Adds an output by decoding the address to get the exact script size.
-     */
-    addOutputAddress(address: string, network: Network): TxWeightEstimator;
-    vsize(): VSize;
-}

package/dist/types/utils/unknownFields.d.ts

@@ -1,83 +0,0 @@
-import { Transaction } from "@scure/btc-signer";
-import { TransactionInputUpdate } from "@scure/btc-signer/psbt.js";
-/**
- * ArkPsbtFieldKey are the available key names for the Arkade PSBT custom fields.
- */
-export declare enum ArkPsbtFieldKey {
-    VtxoTaprootTree = "taptree",
-    VtxoTreeExpiry = "expiry",
-    Cosigner = "cosigner",
-    ConditionWitness = "condition"
-}
-/**
- * ArkPsbtFieldKeyType is the key type of the Arkade PSBT custom field.
- * Every Arkade PSBT field has key type 222.
- */
-export declare const ArkPsbtFieldKeyType = 222;
-/**
- * ArkPsbtFieldCoder is the coder for the Arkade PSBT custom fields.
- * Each type has its own coder.
- */
-export interface ArkPsbtFieldCoder<T> {
-    key: ArkPsbtFieldKey;
-    encode: (value: T) => NonNullable<TransactionInputUpdate["unknown"]>[number];
-    decode: (value: NonNullable<TransactionInputUpdate["unknown"]>[number]) => T | null;
-}
-/**
- * setArkPsbtField appends a new unknown field to the input at inputIndex
- *
- * @example
- * ```typescript
- * setArkPsbtField(tx, 0, VtxoTaprootTree, myTaprootTree);
- * setArkPsbtField(tx, 0, VtxoTreeExpiry, myVtxoTreeExpiry);
- * ```
- */
-export declare function setArkPsbtField<T>(tx: Transaction, inputIndex: number, coder: ArkPsbtFieldCoder<T>, value: T): void;
-/**
- * getArkPsbtFields returns all the values of the given coder for the input at inputIndex
- * Multiple fields of the same type can exist in a single input.
- *
- * @example
- * ```typescript
- * const vtxoTaprootTreeFields = getArkPsbtFields(tx, 0, VtxoTaprootTree);
- * console.log(`input has ${vtxoTaprootTreeFields.length} vtxoTaprootTree fields`);
- */
-export declare function getArkPsbtFields<T>(tx: Transaction, inputIndex: number, coder: ArkPsbtFieldCoder<T>): T[];
-/**
- * VtxoTaprootTree is set to pass all spending leaves of the vtxo input
- *
- * @example
- * ```typescript
- * const vtxoTaprootTree = VtxoTaprootTree.encode(myTaprootTree);
- */
-export declare const VtxoTaprootTree: ArkPsbtFieldCoder<Uint8Array>;
-/**
- * ConditionWitness is set to pass the witness data used to finalize the conditionMultisigClosure
- *
- * @example
- * ```typescript
- * const conditionWitness = ConditionWitness.encode(myConditionWitness);
- */
-export declare const ConditionWitness: ArkPsbtFieldCoder<Uint8Array[]>;
-/**
- * CosignerPublicKey is set on every TxGraph transactions to identify the musig2 public keys
- *
- * @example
- * ```typescript
- * const cosignerPublicKey = CosignerPublicKey.encode(myCosignerPublicKey);
- */
-export declare const CosignerPublicKey: ArkPsbtFieldCoder<{
-    index: number;
-    key: Uint8Array;
-}>;
-/**
- * VtxoTreeExpiry is set to pass the expiry time of the input
- *
- * @example
- * ```typescript
- * const vtxoTreeExpiry = VtxoTreeExpiry.encode(myVtxoTreeExpiry);
- */
-export declare const VtxoTreeExpiry: ArkPsbtFieldCoder<{
-    type: "blocks" | "seconds";
-    value: bigint;
-}>;

package/dist/types/wallet/asset-manager.d.ts

@@ -1,69 +0,0 @@
-import { AssetDetails, BurnParams, IAssetManager, IReadonlyAssetManager, IssuanceParams, IssuanceResult, ReissuanceParams } from "./index.js";
-import { IndexerProvider } from "../providers/indexer.js";
-import { Wallet } from "./wallet.js";
-export declare class ReadonlyAssetManager implements IReadonlyAssetManager {
-    readonly indexer: IndexerProvider;
-    constructor(indexer: IndexerProvider);
-    getAssetDetails(assetId: string): Promise<AssetDetails>;
-}
-export declare class AssetManager extends ReadonlyAssetManager implements IAssetManager {
-    readonly wallet: Wallet;
-    constructor(wallet: Wallet);
-    /**
-     * Issue a new asset.
-     * @param params - Parameters for asset issuance
-     * @param params.amount - Amount of asset units to issue
-     * @param params.controlAssetId - Optional control asset ID (for reissuable assets)
-     * @param params.metadata - Optional metadata to attach to the asset
-     * @returns Promise resolving to the Arkade transaction ID and asset ID
-     *
-     * @example
-     * ```typescript
-     * // Issue a simple non-reissuable asset
-     * const result = await wallet.assetManager.issue({ amount: 1000 });
-     * console.log('Asset ID:', result.assetId);
-     *
-     * // Issue a reissuable asset with an existing control asset
-     * const result = await wallet.assetManager.issue({
-     *   amount: 1000,
-     *   controlAssetId: 'existingControlAssetId'
-     * });
-     * console.log('Asset ID:', result.assetId);
-     * ```
-     */
-    issue(params: IssuanceParams): Promise<IssuanceResult>;
-    /**
-     * Reissue more units of an existing asset.
-     * Requires ownership of the control asset.
-     *
-     * @param params - Parameters for asset reissuance
-     * @param params.assetId - The asset ID to reissue (control asset ID is resolved via getAssetDetails)
-     * @param params.amount - Amount of additional units to issue
-     * @returns Promise resolving to the Arkade transaction ID
-     *
-     * @example
-     * ```typescript
-     * const txid = await wallet.assetManager.reissue({
-     *   assetId: 'def456...',
-     *   amount: 500
-     * });
-     * ```
-     */
-    reissue(params: ReissuanceParams): Promise<string>;
-    /**
-     * Burn assets.
-     * @param params - Parameters for burning
-     * @param params.assetId - The asset ID to burn
-     * @param params.amount - Amount of units to burn
-     * @returns Promise resolving to the Arkade transaction ID
-     *
-     * @example
-     * ```typescript
-     * const txid = await wallet.assetManager.burn({
-     *   assetId: 'abc123...',
-     *   amount: 100
-     * });
-     * ```
-     */
-    burn(params: BurnParams): Promise<string>;
-}

package/dist/types/wallet/asset.d.ts

@@ -1,21 +0,0 @@
-import { Packet } from "../extension/asset/index.js";
-import { Asset, ExtendedVirtualCoin, Recipient, VirtualCoin } from "./index.js";
-/**
- * Creates an asset packet from asset inputs and receivers.
- * Groups inputs and outputs by asset ID and creates the Packet object
- * @param assetInputs - map input index -> assets
- * @param receivers - array of recipients with their asset allocations
- * @param changeReceiver - (optional) change receiver containing remaining assets
- * @returns packet containing all asset groups
- */
-export declare function createAssetPacket(assetInputs: Map<number, Asset[]>, receivers: Recipient[], changeReceiver?: Recipient): Packet;
-/**
- * Selects coins that contain a specific asset.
- * Returns coins sorted by amount (smallest first for better coin selection).
- */
-export declare function selectCoinsWithAsset(coins: ExtendedVirtualCoin[], assetId: string, requiredAmount: bigint): {
-    selected: ExtendedVirtualCoin[];
-    totalAssetAmount: bigint;
-};
-export declare function computeAssetChange(inputAssets: Map<string, bigint>, outputAssets: Map<string, bigint>): Map<string, bigint>;
-export declare function selectedCoinsToAssetInputs(selectedCoins: VirtualCoin[]): Map<number, Asset[]>;

package/dist/types/wallet/batch.d.ts

@@ -1,107 +0,0 @@
-import type { BatchStartedEvent, BatchFinalizedEvent, BatchFailedEvent, TreeTxEvent, TreeSignatureEvent, TreeSigningStartedEvent, TreeNoncesEvent, BatchFinalizationEvent, SettlementEvent } from "../providers/ark.js";
-import { TxTree } from "../tree/txTree.js";
-/**
- * Batch namespace provides utilities for joining and processing batch session.
- * The batch settlement process involves multiple events, this namespace provides abstractions and types to handle them.
- * @see https://docs.arkadeos.com/learn/pillars/batch-swaps
- * @example
- * ```typescript
- * // use wallet handler or create a custom one
- * const handler = wallet.createBatchHandler(intentId, inputs, expectedRecipients, musig2session);
- *
- * const abortController = new AbortController();
- * // Get event stream from the Arkade provider
- * const eventStream = arkProvider.getEventStream(
- *   abortController.signal,
- *   ['your-topic-1', 'your-topic-2']
- * );
- *
- * // Join the batch and process events
- * try {
- *   const commitmentTxid = await Batch.join(eventStream, handler);
- *   console.log('Batch completed with commitment:', commitmentTxid);
- * } catch (error) {
- *   console.error('Batch processing failed:', error);
- * } finally {
- *   abortController.abort();
- * }
- * ```
- */
-export declare namespace Batch {
-    interface Handler {
-        /**
-         * Called on BatchStarted event.
-         * @returns { skip: boolean } indicating whether the batch should be skipped or not.
-         */
-        onBatchStarted(event: BatchStartedEvent): Promise<{
-            skip: boolean;
-        }>;
-        /**
-         * Called when tree signing starts.
-         * @param event The tree signing started event.
-         * @param vtxoTree The unsigned virtual output tree, reconstructed from the TreeTxEvent events.
-         * @returns Promise resolving to a boolean indicating whether to continue processing.
-         */
-        onTreeSigningStarted(event: TreeSigningStartedEvent, vtxoTree: TxTree): Promise<{
-            skip: boolean;
-        }>;
-        /**
-         * Called when tree nonces are received.
-         * @param event The tree nonces event.
-         * @returns Promise resolving to a boolean indicating whether signing is complete.
-         */
-        onTreeNonces(event: TreeNoncesEvent): Promise<{
-            fullySigned: boolean;
-        }>;
-        /**
-         * Called during batch finalization.
-         * @param event The batch finalization event.
-         * @param vtxoTree The signed virtual output tree, reconstructed from the TreeTxEvent events.
-         * @param connectorTree The connector transaction tree, reconstructed from the TreeTxEvent events.
-         */
-        onBatchFinalization(event: BatchFinalizationEvent, vtxoTree?: TxTree, connectorTree?: TxTree): Promise<void>;
-        /**
-         * Called when batch finalization completes successfully.
-         *
-         * @param event - Batch finalized event
-         */
-        onBatchFinalized?(event: BatchFinalizedEvent): Promise<void>;
-        /**
-         * Called when batch processing fails.
-         *
-         * @param event - Batch failed event
-         */
-        onBatchFailed?(event: BatchFailedEvent): Promise<void>;
-        /**
-         * Called for each virtual output tree transaction chunk received during batch processing.
-         *
-         * @param event - Tree transaction event
-         */
-        onTreeTxEvent?(event: TreeTxEvent): Promise<void>;
-        /**
-         * Called for each tree signature event received during batch processing.
-         *
-         * @param event - Tree signature event
-         */
-        onTreeSignatureEvent?(event: TreeSignatureEvent): Promise<void>;
-    }
-    /**
-     * Options for the join function.
-     *
-     * @property abortController - Abort controller used to cancel batch processing.
-     * @property skipVtxoTreeSigning - Ignore events related to the virtual output tree musig2 signing session.
-     * @property eventCallback - Callback invoked for each settlement event received while joining the batch.
-     */
-    type JoinOptions = Partial<{
-        abortController: AbortController;
-        skipVtxoTreeSigning: boolean;
-        eventCallback: (event: SettlementEvent) => Promise<void>;
-    }>;
-    /**
-     * Start the state machine that will process the batch events and join a batch.
-     * @param eventIterator - The events stream to process.
-     * @param handler - How to react to events.
-     * @param options - Options.
-     */
-    function join(eventIterator: AsyncIterableIterator<SettlementEvent>, handler: Handler, options?: JoinOptions): Promise<string>;
-}

package/dist/types/wallet/delegator.d.ts

@@ -1,48 +0,0 @@
-import { TransactionOutput } from "@scure/btc-signer/psbt.js";
-import { ArkProvider, DelegateInfo, Identity, Outpoint } from "../index.js";
-import { ContractVtxo } from "../contracts/types.js";
-import { DelegatorProvider } from "../providers/delegator.js";
-import { Bytes } from "@scure/btc-signer/utils.js";
-export interface IDelegatorManager {
-    /**
-     * Delegate virtual outputs to the remote delegation service.
-     *
-     * Vtxos that are not locked to a delegate-type contract (no tap leaf
-     * matches the delegator's pubkey) are filtered out silently, since they
-     * cannot be co-signed by the delegator.
-     *
-     * @param vtxos - Virtual outputs to delegate
-     * @param destination - Arkade address that should receive renewed funds
-     * @param delegateAt - Optional timestamp to force a specific delegation time
-     * @returns Successfully delegated and failed outpoint groups
-     */
-    delegate(vtxos: ContractVtxo[], destination: string, delegateAt?: Date): Promise<{
-        delegated: Outpoint[];
-        failed: {
-            outpoints: Outpoint[];
-            error: unknown;
-        }[];
-    }>;
-    /** Fetch delegate metadata such as pubkey, fee, and delegate address. */
-    getDelegateInfo(): Promise<DelegateInfo>;
-}
-export declare class DelegatorManagerImpl implements IDelegatorManager {
-    readonly delegatorProvider: DelegatorProvider;
-    readonly arkInfoProvider: Pick<ArkProvider, "getInfo">;
-    readonly identity: Identity;
-    /** Create a delegator manager from the configured provider, Arkade info source, and wallet identity. */
-    constructor(delegatorProvider: DelegatorProvider, arkInfoProvider: Pick<ArkProvider, "getInfo">, identity: Identity);
-    getDelegateInfo(): Promise<DelegateInfo>;
-    delegate(vtxos: ContractVtxo[], destination: string, delegateAt?: Date): Promise<{
-        delegated: Outpoint[];
-        failed: {
-            outpoints: Outpoint[];
-            error: unknown;
-        }[];
-    }>;
-}
-/**
- * Finds the index of the output whose script matches the destination script.
- * Returns -1 if no match is found.
- */
-export declare function findDestinationOutputIndex(outputs: TransactionOutput[], destinationScript: Bytes): number;