@arkade-os/sdk 0.4.43 → 0.4.45

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { K as ReadonlyIdentity, a as Identity, af as DescriptorSigningRequest, ag as Transaction, a3 as SignerSession, P as IntentRepository, a9 as ArkIntent, aa as IntentFilter, ab as Outpoint, Q as VirtualTxRepository, ac as VirtualTx, ad as VtxoBranch, W as WalletRepository, E as ExtendedVirtualCoin, a6 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, a7 as WalletState, t as Contract, C as ContractRepository, a8 as ContractFilter, ah as IntentFeeConfig, ai as OffchainInput, aj as FeeAmount, ak as OnchainInput, al as FeeOutput, o as ArkProvider, a1 as SettlementConfig, am as ContractWatcherConfig, I as IWallet, an as FeeInfo, j as SettlementEvent, H as DescriptorProvider, i as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ao as CreateContractParams, ap as GetContractsFilter, s as VirtualCoin, aq as GetSpendablePathsOptions, ar as GetAllSpendingPathsOptions, R as Recipient, as as IssuanceParams, at as ReissuanceParams, au as BurnParams, av as RenewVtxosOptions, c as WalletBalance, aw as ContractWithVtxos, ax as PathSelection, ay as ContractEvent, az as AssetDetails, aA as IssuanceResult, aB as DelegateInfo, aC as MigrationGlobalSkipReason, aD as MigrationLegSkipReason, aE as SignerStatus, J as IReadonlyWallet, e as ActivityRegistry, U as IReadonlyAssetManager, aF as StorageConfig, f as Activity, g as IContractManager, k as IAssetManager, h as IDelegateManager, aG as IVtxoManager, O as OnchainProvider, N as Network, X as NetworkName, _ as Coin, aH as ExplorerTransaction, r as TapLeafScript, aI as EncodedVtxoScript, a0 as CSVMultisigTapscript, q as RelativeTimelock, V as VtxoScript, aJ as Status, aK as ChainTx, p as IndexerProvider, v as TxTree, aL as PathContext } from './ark-I8jfe5VE.cjs';
-export { aM as ActivityIntent, aN as ActivityResolver, Z as ArkAddress, Y as ArkInfo, aO as ArkIntentState, aP as ArkTapscript, aQ as Asset, aR as AssetMetadata, aS as BaseWalletConfig, z as BatchFailedEvent, x as BatchFinalizationEvent, y as BatchFinalizedEvent, aT as BatchInfo, aU as BatchSignableIdentity, B as BatchStartedEvent, aV as CLTVMultisigTapscript, aW as ChainTxType, ae as ChainedTxType, aX as CommitmentTx, aY as ConditionCSVMultisigTapscript, aZ as ConditionMultisigTapscript, a_ as ContractBalance, a$ as ContractEventCallback, b0 as ContractHandler, $ as ContractManager, b1 as ContractManagerConfig, b2 as ContractState, b3 as ContractVtxo, b4 as ContractWatcher, b5 as DelegateManagerImpl, b6 as DelegateOptions, L as DelegateProvider, b7 as DelegatorManagerImpl, b8 as DelegatorProvider, b9 as DeprecatedSignerMigrationReport, ba as DeprecatedSignerReport, bb as DigestMismatchError, bc as Discoverable, bd as DiscoveredContract, be as DiscoveryDeps, bf as ESPLORA_URL, bg as EsploraProvider, bh as ExtendedContractVtxo, bi as GroupMembership, bj as HandlerError, bk as IDelegatorManager, bl as INTENT_TERMINAL_STATES, bm as IndexerTxType, a5 as Intent, bn as KnownMetadata, bo as MigrateDeprecatedSignerOptions, bp as MigrationLegReport, bq as MigrationVtxoRef, br as MultisigTapscript, bs as Nonces, bt as Output, bu as PageResponse, bv as PaginationOptions, bw as PartialSig, bx as ProviderClass, M as ReadonlyWalletConfig, l as RestArkProvider, by as RestDelegateProvider, bz as RestDelegatorProvider, m as RestIndexerProvider, bA as ScanContractsOptions, bB as ScanResult, bC as ScheduledSession, bD as SettlementEventType, bE as SignRequest, a4 as SignedIntent, bF as SignerClassification, bG as SignerSet, bH as SubscriptionEvent, bI as SubscriptionHeartbeat, n as SubscriptionResponse, bJ as TapLeaves, bK as TapTreeCoder, bL as TapscriptType, bM as TreeNonces, w as TreeNoncesEvent, bN as TreePartialSigs, F as TreeSignatureEvent, u as TreeSigningStartedEvent, D as TreeTxEvent, bO as Tx, bP as TxHistoryRecord, bQ as TxKey, T as TxNotification, bR as TxTreeNode, bS as TxType, bT as VirtualStatus, bU as Vtxo, bV as VtxoChain, a2 as VtxoManager, bW as VtxoType, b as WalletConfig, bX as WalletMode, bY as boardingResolver, bZ as classifyAgainstSignerSet, b_ as classifyContractSigner, b$ as createDefaultActivityRegistry, c0 as decodeTapscript, c1 as getNetwork, c2 as getSequence, c3 as isBatchSignable, c4 as isCooperativelyMigratable, c5 as isDiscoverable, c6 as isExpired, c7 as isRecoverable, c8 as isSpendable, c9 as isSubdust, ca as isTerminalIntentState, cb as isVtxoExpiringSoon, cc as networks, cd as signerSetFromInfo, ce as toXOnlySignerHex } from './ark-I8jfe5VE.cjs';
-export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, V as VHTLC, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from './index-DHuXlDEg.cjs';
-export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BRqbh2fW.cjs';
-import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot } from './wallet-BsqRU8KM.cjs';
-export { B as Batch, d as BoardingUtxoGroup, I as IncomingFunds, w as waitForIncomingFunds } from './wallet-BsqRU8KM.cjs';
+import { K as ReadonlyIdentity, a as Identity, ai as DescriptorSigningRequest, aj as Transaction, a6 as SignerSession, P as IntentRepository, ac as ArkIntent, ad as IntentFilter, ae as Outpoint, Q as VirtualTxRepository, af as VirtualTx, ag as VtxoBranch, W as WalletRepository, E as ExtendedVirtualCoin, a9 as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, aa as WalletState, t as Contract, C as ContractRepository, ab as ContractFilter, ak as IntentFeeConfig, al as OffchainInput, am as FeeAmount, an as OnchainInput, ao as FeeOutput, o as ArkProvider, a4 as SettlementConfig, ap as ContractWatcherConfig, I as IWallet, aq as FeeInfo, j as SettlementEvent, H as DescriptorProvider, i as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ar as CreateContractParams, as as GetContractsFilter, s as VirtualCoin, at as GetSpendablePathsOptions, au as GetAllSpendingPathsOptions, R as Recipient, av as IssuanceParams, aw as ReissuanceParams, ax as BurnParams, ay as RenewVtxosOptions, c as WalletBalance, Z as ContractSyncState, az as ContractWithVtxos, aA as PathSelection, aB as ContractEvent, aC as AssetDetails, aD as IssuanceResult, aE as DelegateInfo, aF as MigrationGlobalSkipReason, aG as MigrationLegSkipReason, aH as SignerStatus, J as IReadonlyWallet, e as ActivityRegistry, Y as IReadonlyAssetManager, aI as StorageConfig, f as Activity, g as IContractManager, k as IAssetManager, h as IDelegateManager, aJ as IVtxoManager, O as OnchainProvider, N as Network, _ as NetworkName, a1 as Coin, aK as ExplorerTransaction, r as TapLeafScript, aL as EncodedVtxoScript, a3 as CSVMultisigTapscript, q as RelativeTimelock, V as VtxoScript, aM as Status, aN as ChainTx, p as IndexerProvider, v as TxTree, aO as PathContext } from './ark-C-PjOngm.cjs';
+export { aP as ActivityIntent, aQ as ActivityResolver, a0 as ArkAddress, $ as ArkInfo, aR as ArkIntentState, aS as ArkTapscript, aT as Asset, aU as AssetMetadata, aV as BaseWalletConfig, z as BatchFailedEvent, x as BatchFinalizationEvent, y as BatchFinalizedEvent, aW as BatchInfo, aX as BatchSignableIdentity, B as BatchStartedEvent, aY as CLTVMultisigTapscript, aZ as ChainTxType, ah as ChainedTxType, a_ as CommitmentTx, a$ as ConditionCSVMultisigTapscript, b0 as ConditionMultisigTapscript, b1 as ContractBalance, b2 as ContractEventCallback, b3 as ContractHandler, a2 as ContractManager, b4 as ContractManagerConfig, b5 as ContractState, b6 as ContractVtxo, b7 as ContractWatcher, b8 as DelegateManagerImpl, b9 as DelegateOptions, L as DelegateProvider, ba as DelegatorManagerImpl, bb as DelegatorProvider, bc as DeprecatedSignerMigrationReport, bd as DeprecatedSignerReport, be as DigestMismatchError, bf as Discoverable, bg as DiscoveredContract, bh as DiscoveryDeps, bi as ESPLORA_URL, bj as EsploraProvider, U as ExitCaptureMode, bk as ExitChainResolver, X as ExitDataSource, bl as ExtendedContractVtxo, bm as GroupMembership, bn as HandlerError, bo as IDelegatorManager, bp as INTENT_TERMINAL_STATES, bq as IndexerTxType, a8 as Intent, br as KnownMetadata, bs as MigrateDeprecatedSignerOptions, bt as MigrationLegReport, bu as MigrationVtxoRef, bv as MultisigTapscript, bw as Nonces, bx as Output, by as PageResponse, bz as PaginationOptions, bA as PartialSig, bB as ProviderClass, M as ReadonlyWalletConfig, l as RestArkProvider, bC as RestDelegateProvider, bD as RestDelegatorProvider, m as RestIndexerProvider, bE as ScanContractsOptions, bF as ScanResult, bG as ScheduledSession, bH as SettlementEventType, bI as SignRequest, a7 as SignedIntent, bJ as SignerClassification, bK as SignerSet, bL as SubscriptionEvent, bM as SubscriptionHeartbeat, n as SubscriptionResponse, bN as TapLeaves, bO as TapTreeCoder, bP as TapscriptType, bQ as TreeNonces, w as TreeNoncesEvent, bR as TreePartialSigs, F as TreeSignatureEvent, u as TreeSigningStartedEvent, D as TreeTxEvent, bS as Tx, bT as TxHistoryRecord, bU as TxKey, T as TxNotification, bV as TxTreeNode, bW as TxType, bX as VirtualStatus, bY as Vtxo, bZ as VtxoChain, a5 as VtxoManager, b_ as VtxoType, b as WalletConfig, b$ as WalletMode, c0 as boardingResolver, c1 as classifyAgainstSignerSet, c2 as classifyContractSigner, c3 as createDefaultActivityRegistry, c4 as createExitChainResolver, c5 as decodeTapscript, c6 as getNetwork, c7 as getSequence, c8 as isBatchSignable, c9 as isCooperativelyMigratable, ca as isDiscoverable, cb as isExpired, cc as isRecoverable, cd as isSpendable, ce as isSubdust, cf as isTerminalIntentState, cg as isVtxoExpiringSoon, ch as networks, ci as signerSetFromInfo, cj as toXOnlySignerHex } from './ark-C-PjOngm.cjs';
+export { B as BoardingContractHandler, a as BoardingContractParams, D as DefaultContractHandler, b as DefaultContractParams, c as DelegateContractHandler, d as DelegateContractParams, V as VHTLC, e as VHTLCContractHandler, f as VHTLCContractParams, g as contractHandlers } from './index-BlW4I30l.cjs';
+export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DOEobYwH.cjs';
+import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot, P as ProviderConnectionState } from './wallet-DBjumS42.cjs';
+export { A as ArkError, B as Batch, d as BoardingUtxoGroup, I as IncomingFunds, e as ProviderKind, f as ProviderUnavailableError, S as ServerInfoSource, m as maybeArkError, w as waitForIncomingFunds } from './wallet-DBjumS42.cjs';
 import { Bytes, BTC_NETWORK } from '@scure/btc-signer/utils.js';
 import { P2TR } from '@scure/btc-signer/payment.js';
 import { Transaction as Transaction$1 } from '@scure/btc-signer';
@@ -1379,6 +1379,16 @@ type ResponseGetStatus = ResponseEnvelope & {
     payload: {
         walletInitialized: boolean;
         xOnlyPublicKey: Uint8Array | undefined;
+        providerConnectionState?: ProviderConnectionState;
+    };
+};
+type RequestGetContractSyncState = RequestEnvelope & {
+    type: "GET_CONTRACT_SYNC_STATE";
+};
+type ResponseGetContractSyncState = ResponseEnvelope & {
+    type: "CONTRACT_SYNC_STATE";
+    payload: {
+        syncState: ContractSyncState;
     };
 };
 type RequestClear = RequestEnvelope & {
@@ -1801,8 +1811,8 @@ type RequestRestoreWallet = RequestEnvelope & {
 type ResponseRestoreWallet = ResponseEnvelope & {
     type: "RESTORE_WALLET_SUCCESS";
 };
-type WalletUpdaterRequest = RequestInitWallet | RequestSettle | RequestSendBitcoin | RequestGetAddress | RequestGetBoardingAddress | RequestGetBalance | RequestGetVtxos | RequestGetBoardingUtxos | RequestGetTransactionHistory | RequestGetStatus | RequestClear | RequestReloadWallet | RequestSignTransaction | RequestCreateContract | RequestGetContracts | RequestGetContractsWithVtxos | RequestAnnotateVtxos | RequestUpdateContract | RequestDeleteContract | RequestGetSpendablePaths | RequestGetAllSpendingPaths | RequestIsContractManagerWatching | RequestRefreshVtxos | RequestRefreshOutpoints | RequestSend | RequestGetAssetDetails | RequestIssue | RequestReissue | RequestBurn | RequestDelegate | RequestGetDelegateInfo | RequestRecoverVtxos | RequestGetRecoverableBalance | RequestGetExpiringVtxos | RequestRenewVtxos | RequestGetExpiredBoardingUtxos | RequestSweepExpiredBoardingUtxos | RequestMigrateDeprecatedSignerVtxos | RequestGetDeprecatedSignerStatus | RequestRestoreWallet;
-type WalletUpdaterResponse = ResponseEnvelope & (ResponseInitWallet | ResponseSettle | ResponseSettleEvent | ResponseSendBitcoin | ResponseGetAddress | ResponseGetBoardingAddress | ResponseGetBalance | ResponseGetVtxos | ResponseGetBoardingUtxos | ResponseGetTransactionHistory | ResponseGetStatus | ResponseClear | ResponseReloadWallet | ResponseUtxoUpdate | ResponseVtxoUpdate | ResponseSignTransaction | ResponseCreateContract | ResponseGetContracts | ResponseGetContractsWithVtxos | ResponseAnnotateVtxos | ResponseUpdateContract | ResponseDeleteContract | ResponseGetSpendablePaths | ResponseGetAllSpendingPaths | ResponseIsContractManagerWatching | ResponseRefreshVtxos | ResponseRefreshOutpoints | ResponseContractEvent | ResponseSend | ResponseGetAssetDetails | ResponseIssue | ResponseReissue | ResponseBurn | ResponseDelegate | ResponseGetDelegateInfo | ResponseRecoverVtxos | ResponseRecoverVtxosEvent | ResponseGetRecoverableBalance | ResponseGetExpiringVtxos | ResponseRenewVtxos | ResponseRenewVtxosEvent | ResponseGetExpiredBoardingUtxos | ResponseSweepExpiredBoardingUtxos | ResponseMigrateDeprecatedSignerVtxos | ResponseMigrateDeprecatedSignerVtxosEvent | ResponseGetDeprecatedSignerStatus | ResponseRestoreWallet);
+type WalletUpdaterRequest = RequestInitWallet | RequestSettle | RequestSendBitcoin | RequestGetAddress | RequestGetBoardingAddress | RequestGetBalance | RequestGetVtxos | RequestGetBoardingUtxos | RequestGetTransactionHistory | RequestGetStatus | RequestGetContractSyncState | RequestClear | RequestReloadWallet | RequestSignTransaction | RequestCreateContract | RequestGetContracts | RequestGetContractsWithVtxos | RequestAnnotateVtxos | RequestUpdateContract | RequestDeleteContract | RequestGetSpendablePaths | RequestGetAllSpendingPaths | RequestIsContractManagerWatching | RequestRefreshVtxos | RequestRefreshOutpoints | RequestSend | RequestGetAssetDetails | RequestIssue | RequestReissue | RequestBurn | RequestDelegate | RequestGetDelegateInfo | RequestRecoverVtxos | RequestGetRecoverableBalance | RequestGetExpiringVtxos | RequestRenewVtxos | RequestGetExpiredBoardingUtxos | RequestSweepExpiredBoardingUtxos | RequestMigrateDeprecatedSignerVtxos | RequestGetDeprecatedSignerStatus | RequestRestoreWallet;
+type WalletUpdaterResponse = ResponseEnvelope & (ResponseInitWallet | ResponseSettle | ResponseSettleEvent | ResponseSendBitcoin | ResponseGetAddress | ResponseGetBoardingAddress | ResponseGetBalance | ResponseGetVtxos | ResponseGetBoardingUtxos | ResponseGetTransactionHistory | ResponseGetStatus | ResponseGetContractSyncState | ResponseClear | ResponseReloadWallet | ResponseUtxoUpdate | ResponseVtxoUpdate | ResponseSignTransaction | ResponseCreateContract | ResponseGetContracts | ResponseGetContractsWithVtxos | ResponseAnnotateVtxos | ResponseUpdateContract | ResponseDeleteContract | ResponseGetSpendablePaths | ResponseGetAllSpendingPaths | ResponseIsContractManagerWatching | ResponseRefreshVtxos | ResponseRefreshOutpoints | ResponseContractEvent | ResponseSend | ResponseGetAssetDetails | ResponseIssue | ResponseReissue | ResponseBurn | ResponseDelegate | ResponseGetDelegateInfo | ResponseRecoverVtxos | ResponseRecoverVtxosEvent | ResponseGetRecoverableBalance | ResponseGetExpiringVtxos | ResponseRenewVtxos | ResponseRenewVtxosEvent | ResponseGetExpiredBoardingUtxos | ResponseSweepExpiredBoardingUtxos | ResponseMigrateDeprecatedSignerVtxos | ResponseMigrateDeprecatedSignerVtxosEvent | ResponseGetDeprecatedSignerStatus | ResponseRestoreWallet);
 declare class WalletMessageHandler implements MessageHandler<WalletUpdaterRequest, WalletUpdaterResponse> {
     readonly messageTag: string;
     private wallet;
@@ -2095,6 +2105,13 @@ declare class ServiceWorkerReadonlyWallet implements IReadonlyWallet {
      * @returns Current service-worker wallet status payload including `walletInitalized` and `xOnlyPublicKey`
      */
     getStatus(): Promise<ResponseGetStatus["payload"]>;
+    /**
+     * Wallet-level provider-connection freshness, delegated to the worker via
+     * `GET_STATUS`. Async by necessity (the worker boundary is asynchronous); no
+     * synchronous variant is offered because it would have the same transport
+     * mismatch as the contract-manager proxy's cached `getSyncState()`.
+     */
+    getProviderConnectionState(): Promise<ProviderConnectionState>;
     getActivityHistory(): Promise<Activity[]>;
     getTransactionHistory(): Promise<ArkTransaction[]>;
     getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
@@ -2254,6 +2271,27 @@ declare class OnchainWallet implements AnchorBumper {
      * @see send
      */
     bumpP2A(parent: Transaction): Promise<[string, string]>;
+    /**
+     * Build and sign a CPFP fee child for a parent tx (given as raw hex)
+     * carrying a P2A anchor, funding it from this wallet's **confirmed**
+     * coins, and return the 1P1C package hexes WITHOUT broadcasting.
+     *
+     * This is the graph-mode fee source ({@link ExitFeeWallet}): the exit
+     * executor calls it to bump each transported virtual tx at execution
+     * time, so funding can be deferred rather than pre-signed.
+     *
+     * @param parentHex - Finalized parent transaction, raw network hex
+     * @param feeRate - sat/vB floor for the package (raised to MIN_FEE_RATE)
+     * @returns Tuple of parent hex (unchanged) and signed child hex
+     * @throws If the parent has no anchor, or funding cannot be selected/signed
+     */
+    bumpAnchor(parentHex: string, feeRate: number): Promise<[string, string]>;
+    /**
+     * Shared core of {@link bumpP2A} and {@link bumpAnchor}: probe the package
+     * fee with a single-input child, select coins for it, then build and sign
+     * with the actual selection (the fee grows per extra input).
+     */
+    private buildBumpPackage;
 }
 
 type SetupServiceWorkerOptions = {
@@ -3013,19 +3051,237 @@ declare namespace Unroll {
     function completeUnroll(wallet: Wallet, vtxoTxids: string[], outputAddress: string): Promise<string>;
 }
 
-declare class ArkError extends Error {
-    readonly code: number;
-    readonly message: string;
-    readonly name: string;
-    readonly metadata?: Record<string, string> | undefined;
-    constructor(code: number, message: string, name: string, metadata?: Record<string, string> | undefined);
+/** Relative delay before a sweep becomes valid, decoded from BIP-68. */
+type ExitDelay = {
+    type: "blocks" | "seconds";
+    value: number;
+};
+/** Broadcast a single pre-signed transaction (the funding splitter). */
+type BroadcastStep = {
+    kind: "broadcast";
+    txid: string;
+    hex: string;
+};
+/** Broadcast a 1P1C package: virtual tx + its pre-signed CPFP fee child. */
+type PackageStep = {
+    kind: "package";
+    parentTxid: string;
+    parentHex: string;
+    childTxid: string;
+    childHex: string;
+    /** Outpoints (txid:vout) of the VTXOs this step serves. */
+    forVtxos: string[];
+};
+/**
+ * A virtual tx that must go onchain but whose CPFP fee child is NOT
+ * pre-signed (graph mode). The executor builds and signs the child at
+ * execution time using its own fee wallet — this is how "send funds to
+ * this address and we proceed" works: funding is deferred, not baked in.
+ */
+type BumpStep = {
+    kind: "bump";
+    parentTxid: string;
+    parentHex: string;
+    /** Outpoints (txid:vout) of the VTXOs this step serves. */
+    forVtxos: string[];
+};
+/** Broadcast a pre-signed CSV sweep once its dependency matured. */
+type SweepStep = {
+    kind: "sweep";
+    vtxo: string;
+    txid: string;
+    hex: string;
+    /** The VTXO-creating leaf tx whose confirmation starts the CSV clock. */
+    dependsOnTxid: string;
+    delay: ExitDelay;
+};
+type ExitStep = BroadcastStep | PackageStep | BumpStep | SweepStep;
+/**
+ * How fee funding is provided:
+ * - `"funded"`: a splitter tx (broadcast at prepare time) pre-funds
+ *   pre-signed fee children — execution is fully keyless.
+ * - `"graph"`: only the tx graph + sweeps are transported; the executor
+ *   funds and signs the CPFP bumps at execution time from its own fee
+ *   wallet ("send funds to this address and we proceed").
+ */
+type ExitMode = "funded" | "graph";
+/** Per-VTXO metadata; skipped VTXOs carry a human-readable reason. */
+type ExitVtxoInfo = {
+    outpoint: string;
+    value?: number;
+    sweepFee?: number;
+    /** `${contractType}:${pathLabel}` for observability, e.g. "vhtlc:unilateral". */
+    path?: string;
+    delay?: ExitDelay;
+    skipped?: string;
+};
+type ExitTotals = {
+    /** Distinct transactions the executor ensures onchain. */
+    txCount: number;
+    totalFeeSats: number;
+    /** Sats consumed from the onchain wallet by the splitter (fees + funding outputs). */
+    fundingRequiredSats: number;
+    /** Sats arriving at the sweep address once all sweeps confirm. */
+    recoveredSats: number;
+};
+/**
+ * Versioned, language-agnostic unilateral exit package.
+ * Everything inside is pre-signed; executing it requires no keys and no
+ * Arkade infrastructure — only an Esplora-compatible API.
+ */
+type ExitPackage = {
+    version: 1;
+    /** Fee-funding strategy. Absent is treated as "funded" (v1 default). */
+    mode?: ExitMode;
+    network: NetworkName;
+    createdAt: number;
+    /** Min batch expiry (unix seconds) across included txs. Informational. */
+    validUntil?: number;
+    feeRate: number;
+    sweepAddress: string;
+    totals: ExitTotals;
+    vtxos: ExitVtxoInfo[];
+    /** Topologically ordered: a step's txs confirm before dependents proceed. */
+    steps: ExitStep[];
+};
+/** Cost/size quote returned by `UnilateralExit.estimate` — no funds needed. */
+type ExitQuote = {
+    feeRate: number;
+    fundingAddress: string;
+    currentBalanceSats: number;
+    shortfallSats: number;
+    validUntil?: number;
+    totals: ExitTotals;
+    vtxos: ExitVtxoInfo[];
+};
+declare function serializeExitPackage(pkg: ExitPackage): string;
+declare function deserializeExitPackage(json: string): ExitPackage;
+
+type ExitOptions = {
+    /** Wallet owning the VTXOs: identity (signing) + indexer + onchain provider. */
+    wallet: Wallet;
+    /** Fee funding source and change/funding address. Must share the wallet identity. */
+    onchainWallet: OnchainWallet;
+    /** Destination for the exited funds. */
+    sweepAddress: string;
+    /** sat/vB; defaults to the onchain provider estimate, floored at MIN_FEE_RATE. */
+    feeRate?: number;
+    /** Defaults to all spendable VTXOs. */
+    vtxos?: Outpoint[];
+    /**
+     * Fee-funding strategy (default `"funded"`):
+     * - `"funded"`: broadcast a splitter at prepare time and pre-sign the
+     *   fee children — the package executes fully keyless.
+     * - `"graph"`: transport only the tx graph + sweeps; the executor funds
+     *   and signs the CPFP bumps at execution time ("send funds to this
+     *   address and we proceed"). No splitter, no `onchainWallet` funds used.
+     */
+    mode?: ExitMode;
+    /**
+     * Network label embedded in the package (executor sanity check).
+     * Resolved from the wallet's network when omitted — exact for
+     * "bitcoin" and "regtest"; the tb-family defaults to "testnet", so
+     * pass this explicitly on signet/mutinynet.
+     */
+    networkName?: NetworkName;
+};
+/**
+ * Quote a unilateral exit: how many transactions, how many sats of fees,
+ * and how much must be deposited to the funding address. Requires no
+ * onchain funds and signs nothing.
+ */
+declare function estimate(opts: ExitOptions): Promise<ExitQuote>;
+
+type ExecutorEvent = {
+    stepIndex: number;
+    kind: ExitStep["kind"];
+    status: "skipped" | "broadcast" | "confirmed" | "waiting_csv" | "failed" | "warning";
+    forVtxos?: string[];
+    txid?: string;
+    reason?: string;
+    /** For waiting_csv with a blocks delay: absolute height at maturity. */
+    maturesAtHeight?: number;
+    /** For waiting_csv with a seconds delay: unix time at maturity. */
+    maturesAtTime?: number;
+};
+/**
+ * Fee source for graph-mode `bump` steps. Given a parent tx carrying a P2A
+ * anchor, it builds and signs the CPFP fee child from its own funds and
+ * returns the 1P1C package hexes (parent unchanged, child signed) — WITHOUT
+ * broadcasting; the executor owns broadcast. `OnchainWallet` implements it.
+ */
+interface ExitFeeWallet {
+    bumpAnchor(parentHex: string, feeRate: number): Promise<[parentHex: string, childHex: string]>;
 }
 /**
- * Try to convert an error to an ArkError class, returning undefined if the error is not an ArkError
- * @param error - The error to parse
- * @returns The parsed ArkError, or undefined if the error is not an ArkError
+ * Keyless, stateless executor for a pre-signed exit package.
+ *
+ * The blockchain is the only state: every action re-checks tx status first,
+ * so the executor can be killed and re-run anywhere at any time. It never
+ * parses transaction hex — it only relays it.
+ */
+declare class Executor implements AsyncIterable<ExecutorEvent> {
+    readonly pkg: ExitPackage;
+    readonly provider: OnchainProvider;
+    private readonly pollIntervalMs;
+    private readonly feeWallet?;
+    constructor(pkg: ExitPackage, provider: OnchainProvider, opts?: {
+        pollIntervalMs?: number;
+        feeWallet?: ExitFeeWallet;
+    });
+    private sleep;
+    private status;
+    private waitConfirmed;
+    [Symbol.asyncIterator](): AsyncIterator<ExecutorEvent>;
+}
+
+/**
+ * Build the fully pre-signed unilateral exit package.
+ *
+ * Signs every transaction needed to land the selected VTXOs onchain and
+ * **broadcasts the funding splitter** as a side effect — reserving the fee
+ * budget so later wallet activity cannot invalidate the package. The
+ * returned package is keyless to execute: hand it to
+ * `UnilateralExit.Executor` (or any Esplora-speaking watchtower).
+ */
+declare function prepare(opts: ExitOptions): Promise<ExitPackage>;
+
+/**
+ * Pre-signed unilateral exit.
+ *
+ * `estimate` quotes the cost (tx count, fees, funding required) without
+ * touching funds; `prepare` signs every transaction needed to land the
+ * VTXOs onchain and broadcasts the fee-funding splitter; `Executor` drives
+ * the resulting package to completion with nothing but an
+ * Esplora-compatible endpoint — no keys, no Arkade infrastructure.
+ */
+declare const UnilateralExit: {
+    readonly estimate: typeof estimate;
+    readonly prepare: typeof prepare;
+    readonly Executor: typeof Executor;
+};
+
+/**
+ * Whether a provider error is a *retryable* availability failure (operator or
+ * indexer temporarily unreachable) rather than a terminal one.
+ *
+ * Retryable:
+ *  - {@link ProviderUnavailableError} — already-classified 5xx/429/unavailable
+ *    (see e.g. {@link https | RestArkProvider.getInfo}'s non-2xx branch);
+ *  - {@link FetchError} — transport-level `fetch` rejection (DNS failure,
+ *    connection refused, TLS/CORS), which also carries undici timeouts as its
+ *    `cause`;
+ *  - {@link isFetchTimeoutError} — header/body timeouts that surface directly.
+ *
+ * Everything else (4xx, invalid JSON, schema violations, network mismatch,
+ * unsupported network) is terminal and returns `false`.
+ *
+ * NOTE (Step 2, Scope 2): this classifies the errors currently produced by the
+ * boot-critical `getInfo` path. Normalizing the indexer's per-branch
+ * `!res.ok` throws and the remaining Ark RPC methods into
+ * {@link ProviderUnavailableError} is the broader Scope-2 work still pending.
  */
-declare function maybeArkError(error: any): ArkError | undefined;
+declare function isRetryableProviderError(error: unknown): boolean;
 
 declare function validateConnectorsTxGraph(settlementTxB64: string, connectorsGraph: TxTree): void;
 declare function validateVtxoTxGraph(graph: TxTree, roundTransaction: Transaction$2, sweepTapTreeRoot: Uint8Array): void;
@@ -3755,4 +4011,4 @@ declare class AssetManager extends ReadonlyAssetManager implements IAssetManager
     burn(params: BurnParams): Promise<string>;
 }
 
-export { Activity, ActivityRegistry, type AnchorBumper, ArkError, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, AssetDetails, AssetManager, BIP322, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, type DescriptorOptions, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, EncodedVtxoScript, Estimator, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, FeeAmount, FeeInfo, FeeOutput, FetchError, GetVtxosFilter, HDDescriptorProvider, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, Unroll, type VSize, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, assembleBtcdTaprootTree, index as asset, buildForfeitTx, buildOffchainTx, buildVersion, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isCltvSatisfied, isCsvSpendable, isValidArkAddress, maybeArkError, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sdkVersion, sequenceToTimelock, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };
+export { Activity, ActivityRegistry, type AnchorBumper, ArkIntent, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, AssetDetails, AssetManager, BIP322, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractSyncState, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DelegateInfo, DelegateNotConfiguredError, DelegatorNotConfiguredError, type DescriptorOptions, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, type BlockHeader as ElectrumBlockHeader, ElectrumOnchainProvider, type TransactionHistory as ElectrumTransactionHistory, type Unspent as ElectrumUnspent, EncodedVtxoScript, Estimator, type ExecutorEvent, type ExitDelay, type ExitFeeWallet, type ExitMode, type ExitOptions, type ExitPackage, type ExitQuote, type ExitStep, type ExitTotals, type ExitVtxoInfo, ExplorerTransaction, ExtendedCoin, ExtendedVirtualCoin, FeeAmount, FeeInfo, FeeOutput, FetchError, GetVtxosFilter, HDDescriptorProvider, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IntentFilter, IntentRepository, IssuanceParams, IssuanceResult, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, MigrationGlobalSkipReason, MigrationLegSkipReason, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathContext, PathSelection, ProviderConnectionState, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, RenewVtxosOptions, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SignerStatus, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, UnilateralExit, Unroll, type VSize, VirtualCoin, VirtualTx, VirtualTxRepository, VtxoBranch, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, assembleBtcdTaprootTree, index as asset, buildForfeitTx, buildOffchainTx, buildVersion, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, deserializeExitPackage, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isCltvSatisfied, isCsvSpendable, isRetryableProviderError, isValidArkAddress, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sdkVersion, sequenceToTimelock, serializeExitPackage, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };