@arkade-os/sdk 0.4.25 → 0.4.27

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

@@ -1,4 +1,4 @@
-import { WalletRepository, WalletState } from "../repositories/walletRepository";
+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. */

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

@@ -1,4 +1,4 @@
-import type { RelativeTimelock } from "../script/tapscript";
+import type { RelativeTimelock } from "../script/tapscript.js";
 /**
  * Convert RelativeTimelock to BIP68 sequence number.
  */

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

@@ -1,6 +1,6 @@
 import { Transaction as BtcSignerTransaction } from "@scure/btc-signer";
-import { TxOpts } from "@scure/btc-signer/transaction";
-import { Bytes } from "@scure/btc-signer/utils";
+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.

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

@@ -1,4 +1,4 @@
-import { ArkTransaction, VirtualCoin } from "../wallet";
+import { ArkTransaction, VirtualCoin } from "../wallet/index.js";
 type ExtendedArkTransaction = ArkTransaction & {
     tag: "offchain" | "boarding" | "exit" | "batch";
 };

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

@@ -1,4 +1,4 @@
-import { Network } from "../networks";
+import { Network } from "../networks.js";
 export type VSize = {
     value: bigint;
     fee(feeRate: bigint): bigint;

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

@@ -1,6 +1,6 @@
-import { AssetDetails, BurnParams, IAssetManager, IReadonlyAssetManager, IssuanceParams, IssuanceResult, ReissuanceParams } from ".";
-import { IndexerProvider } from "../providers/indexer";
-import { Wallet } from "./wallet";
+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);

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

@@ -1,5 +1,5 @@
-import { Packet } from "../extension/asset";
-import { Asset, ExtendedVirtualCoin, Recipient, VirtualCoin } from "./index";
+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

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

@@ -1,5 +1,5 @@
-import type { BatchStartedEvent, BatchFinalizedEvent, BatchFailedEvent, TreeTxEvent, TreeSignatureEvent, TreeSigningStartedEvent, TreeNoncesEvent, BatchFinalizationEvent, SettlementEvent } from "../providers/ark";
-import { TxTree } from "../tree/txTree";
+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.

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

@@ -1,8 +1,8 @@
-import { TransactionOutput } from "@scure/btc-signer/psbt";
-import { ArkProvider, DelegateInfo, Identity, Outpoint } from "..";
-import { ContractVtxo } from "../contracts/types";
-import { DelegatorProvider } from "../providers/delegator";
-import { Bytes } from "@scure/btc-signer/utils";
+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.

package/dist/types/wallet/expo/background.d.ts

@@ -1,7 +1,7 @@
-import type { WalletRepository } from "../../repositories/walletRepository";
-import type { ContractRepository } from "../../repositories/contractRepository";
-import type { AsyncStorageTaskQueue } from "../../worker/expo/asyncStorageTaskQueue";
-import type { TaskProcessor } from "../../worker/expo/taskRunner";
+import type { WalletRepository } from "../../repositories/walletRepository.js";
+import type { ContractRepository } from "../../repositories/contractRepository.js";
+import type { AsyncStorageTaskQueue } from "../../worker/expo/asyncStorageTaskQueue.js";
+import type { TaskProcessor } from "../../worker/expo/taskRunner.js";
 /**
  * Wallet parameters persisted by @see ExpoWallet.setup and read
  * by the background handler to reconstruct providers and `extendVtxo`

package/dist/types/wallet/expo/index.d.ts

@@ -1,4 +1,4 @@
-export { ExpoWallet } from "./wallet";
-export type { ExpoWalletConfig, ExpoBackgroundConfig } from "./wallet";
-export { defineExpoBackgroundTask, registerExpoBackgroundTask, unregisterExpoBackgroundTask, } from "./background";
-export type { DefineBackgroundTaskOptions, PersistedBackgroundConfig, } from "./background";
+export { ExpoWallet } from "./wallet.js";
+export type { ExpoWalletConfig, ExpoBackgroundConfig } from "./wallet.js";
+export { defineExpoBackgroundTask, registerExpoBackgroundTask, unregisterExpoBackgroundTask, } from "./background.js";
+export type { DefineBackgroundTaskOptions, PersistedBackgroundConfig, } from "./background.js";

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

@@ -1,11 +1,11 @@
-import { Wallet } from "../wallet";
-import type { IWallet, IAssetManager, WalletBalance, WalletConfig, SendBitcoinParams, SettleParams, GetVtxosFilter, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, Recipient } from "..";
-import type { SettlementEvent } from "../../providers/ark";
-import type { Identity } from "../../identity";
-import type { IContractManager } from "../../contracts/contractManager";
-import type { IDelegatorManager } from "../delegator";
-import type { TaskQueue } from "../../worker/expo/taskQueue";
-import type { TaskProcessor } from "../../worker/expo/taskRunner";
+import { Wallet } from "../wallet.js";
+import type { IWallet, IAssetManager, WalletBalance, WalletConfig, SendBitcoinParams, SettleParams, GetVtxosFilter, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, Recipient } from "../index.js";
+import type { SettlementEvent } from "../../providers/ark.js";
+import type { Identity } from "../../identity/index.js";
+import type { IContractManager } from "../../contracts/contractManager.js";
+import type { IDelegatorManager } from "../delegator.js";
+import type { TaskQueue } from "../../worker/expo/taskQueue.js";
+import type { TaskProcessor } from "../../worker/expo/taskRunner.js";
 /**
  * Background processing configuration for @see ExpoWallet.
  */

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

@@ -1,7 +1,8 @@
-import { DescriptorProvider, DescriptorSigningRequest } from "../identity/descriptorProvider";
-import { HDCapableIdentity } from "../identity/hdCapableIdentity";
-import { WalletRepository } from "../repositories/walletRepository";
-import { Transaction } from "../utils/transaction";
+import { DescriptorProvider, DescriptorSigningRequest } from "../identity/descriptorProvider.js";
+import { HDCapableIdentity } from "../identity/hdCapableIdentity.js";
+import { WalletRepository } from "../repositories/walletRepository.js";
+import { Transaction } from "../utils/transaction.js";
+import { ReceiveRotatorBoot, ReceiveRotatorBootOpts, ReceiveRotatorFactory } from "./walletReceiveRotator.js";
 /**
  * HD-wallet {@link DescriptorProvider} that allocates a fresh signing
  * descriptor on every call. The provider holds no notion of "current" — it
@@ -29,7 +30,7 @@ import { Transaction } from "../utils/transaction";
  * // next: tr([fp/86'/0'/0']xpub/0/1)
  * ```
  */
-export declare class HDDescriptorProvider implements DescriptorProvider {
+export declare class HDDescriptorProvider implements DescriptorProvider, ReceiveRotatorFactory {
     private readonly identity;
     private readonly walletRepository;
     private constructor();
@@ -48,6 +49,19 @@ export declare class HDDescriptorProvider implements DescriptorProvider {
      * index.
      */
     getNextSigningDescriptor(): Promise<string>;
+    /**
+     * Re-derive the descriptor at the most recently allocated index
+     * WITHOUT advancing — i.e. read the same descriptor
+     * `getNextSigningDescriptor` last returned. Returns `undefined`
+     * when no descriptor has ever been allocated on this repo.
+     *
+     * Used by the boot path to keep the wallet's display address
+     * stable across restarts: when no tagged display contract exists
+     * (e.g. a fresh wallet that hasn't rotated yet, or a wallet whose
+     * baseline-only repo carries no rotation history), the boot should
+     * re-derive the existing index rather than burn a new one.
+     */
+    getCurrentSigningDescriptor(): Promise<string | undefined>;
     /**
      * Returns true when the given descriptor is derivable from this wallet's
      * seed. Delegates to the underlying identity, which handles both HD and
@@ -62,6 +76,13 @@ export declare class HDDescriptorProvider implements DescriptorProvider {
     signWithDescriptor(requests: DescriptorSigningRequest[]): Promise<Transaction[]>;
     /** Signs a message using the key derived from `descriptor`. */
     signMessageWithDescriptor(descriptor: string, message: Uint8Array, signatureType?: "schnorr" | "ecdsa"): Promise<Uint8Array>;
+    /**
+     * HD providers participate in receive rotation. The default
+     * factory boot (contract-repo lookup → allocate fresh descriptor)
+     * is exactly what we want, so this just delegates to
+     * {@link WalletReceiveRotator.defaultBoot}.
+     */
+    createReceiveRotator(opts: ReceiveRotatorBootOpts): Promise<ReceiveRotatorBoot | undefined>;
     /**
      * Substitute the wildcard in the identity's account-descriptor template
      * with a concrete index, going through the descriptors-scure parser

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

@@ -1,20 +1,45 @@
 import { Bytes } from "@scure/btc-signer/utils.js";
-import { ArkProvider, Output, SettlementEvent } from "../providers/ark";
-import { Identity, ReadonlyIdentity } from "../identity";
-import { RelativeTimelock } from "../script/tapscript";
-import { EncodedVtxoScript, TapLeafScript } from "../script/base";
-import { RenewalConfig, SettlementConfig } from "./vtxo-manager";
-import { IndexerProvider } from "../providers/indexer";
-import { OnchainProvider } from "../providers/onchain";
-import { ContractWatcherConfig } from "../contracts/contractWatcher";
-import { ContractRepository, WalletRepository } from "../repositories";
-import { IContractManager } from "../contracts/contractManager";
-import { IDelegatorManager } from "./delegator";
-import { DelegatorProvider } from "../providers/delegator";
+import { ArkProvider, Output, SettlementEvent } from "../providers/ark.js";
+import { Identity, ReadonlyIdentity } from "../identity/index.js";
+import { DescriptorProvider } from "../identity/descriptorProvider.js";
+import { RelativeTimelock } from "../script/tapscript.js";
+import { EncodedVtxoScript, TapLeafScript } from "../script/base.js";
+import { RenewalConfig, SettlementConfig } from "./vtxo-manager.js";
+import { IndexerProvider } from "../providers/indexer.js";
+import { OnchainProvider } from "../providers/onchain.js";
+import { ContractWatcherConfig } from "../contracts/contractWatcher.js";
+import { ContractRepository, WalletRepository } from "../repositories/index.js";
+import { IContractManager } from "../contracts/contractManager.js";
+import { IDelegatorManager } from "./delegator.js";
+import { DelegatorProvider } from "../providers/delegator.js";
 /** Defaults */
 export declare const DEFAULT_ARKADE_SERVER_URL: "https://arkade.computer";
-export declare const DEFAULT_ARKADE_HRP = "ark";
-export declare const DEFAULT_NETWORK_NAME = "bitcoin";
+export declare const DEFAULT_ARKADE_HRP: "ark";
+export declare const DEFAULT_NETWORK_NAME: "bitcoin";
+/**
+ * Wallet receive-address strategy.
+ *
+ * - `'auto'` *(default)*: **short-term** — currently identical to
+ *   `'static'`. The `'auto'` name is reserved for a future change that
+ *   will re-enable identity-probing once HD rotation has matured in
+ *   the field. Until then, opt into HD explicitly via `'hd'` or a
+ *   {@link DescriptorProvider}.
+ *   *(See `TODO(hd-maturation)` in
+ *   `src/wallet/walletReceiveRotator.ts:resolveDescriptorProvider` for
+ *   the flip-back criteria.)*
+ * - `'static'`: never rotate. The wallet uses one receive address derived
+ *   from `identity.xOnlyPublicKey()`.
+ * - `'hd'`: must rotate, using the built-in HD provider derived from the
+ *   identity. Throws at `Wallet.create` if the identity isn't HD-capable
+ *   or its descriptor isn't rangeable — no silent fallback.
+ * - A {@link DescriptorProvider} instance: rotate via the supplied
+ *   provider on every incoming VTXO. The wallet does not probe the
+ *   identity; the caller is responsible for ensuring the identity can
+ *   sign for whatever pubkey the provider returns. Errors thrown by the
+ *   provider propagate — there is no silent fallback for an explicit
+ *   provider.
+ */
+export type WalletMode = "auto" | "static" | "hd" | DescriptorProvider;
 /**
  * Base configuration options shared by all wallet types.
  *
@@ -164,6 +189,15 @@ export interface WalletConfig extends ReadonlyWalletConfig {
      * @see SettlementConfig
      */
     settlementConfig?: SettlementConfig | false;
+    /**
+     * Receive-address strategy. Pass `'static'`, `'hd'`, or a
+     * {@link DescriptorProvider} instance to drive rotation; omit (or
+     * pass `'auto'`) for the built-in auto-detect behaviour. See
+     * {@link WalletMode}.
+     *
+     * @defaultValue `'auto'`
+     */
+    walletMode?: WalletMode;
 }
 /**
  * Repository implementations used to store wallet and contract state.
@@ -472,24 +506,27 @@ export interface Coin extends Outpoint {
  * @see VirtualStatus
  */
 export interface VirtualCoin extends Coin {
-    /** Virtual output status */
-    virtualStatus: VirtualStatus;
-    /** Transaction id that spent this virtual output, when known. */
-    spentBy?: string;
-    /** Settlement transaction associated with this virtual output, when known. */
-    settledBy?: string;
-    /** Arkade transaction id that created or spent this virtual output, when known. */
-    arkTxId?: string;
     /** Creation time of the virtual output. */
     createdAt: Date;
-    /** Whether this virtual output has been unrolled to onchain outputs. */
+    /** The scriptPubKey (hex) locking this virtual output, as returned by the indexer. */
+    script: string;
+    /** Whether this virtual output has been broadcasted onchain via an unroll (unilateral exit). */
     isUnrolled: boolean;
-    /** Whether this virtual output is already spent. */
+    /**
+     * Whether this virtual output is already spent (boolean helper for `spentBy`).
+     * This is not set to true if the virtual output is unrolled or swept, only when it's spent offchain.
+     */
     isSpent?: boolean;
+    /** ID of the onchain commitment transaction that settled this output, if applicable. */
+    settledBy?: string;
+    /** ID of the offchain checkpoint transaction that spent this output, if applicable. */
+    spentBy?: string;
+    /** ID of the offchain Arkade transaction that spent the above checkpoint output, if applicable. */
+    arkTxId?: string;
+    /** Virtual output status */
+    virtualStatus: VirtualStatus;
     /** Assets carried by this virtual output, if any. */
     assets?: Asset[];
-    /** The scriptPubKey (hex) locking this virtual output, as returned by the indexer. */
-    script: string;
 }
 /** Wallet transaction direction. */
 export declare enum TxType {

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

@@ -0,0 +1,35 @@
+import { Transaction } from "@scure/btc-signer";
+import { Identity } from "../identity/index.js";
+import { ContractRepository } from "../repositories/contractRepository.js";
+import { DescriptorProvider } from "../identity/descriptorProvider.js";
+export interface InputSigningJob {
+    /** Index in the source transaction. */
+    index: number;
+    /**
+     * Script used to identify the owning contract. For normal inputs this
+     * is the input's witnessUtxo script. For arkTx inputs this is the
+     * source VTXO script, because the witnessUtxo carries the checkpoint
+     * script instead.
+     */
+    lookupScript: Uint8Array;
+}
+export interface InputSignerRouterDeps {
+    identity: Identity;
+    contractRepository: ContractRepository;
+    descriptorProvider?: DescriptorProvider;
+    boardingPkScript: Uint8Array;
+}
+/**
+ * Routes PSBT inputs to the correct signer based on the owning contract.
+ * Inputs whose script matches a `default`/`delegate` contract with a
+ * non-baseline owner are sent to {@link DescriptorProvider}; everything
+ * else (baseline-owned contracts, non-default/non-delegate contracts,
+ * and the boarding script) is sent to {@link Identity}. Inputs with no
+ * matching contract and no boarding match are silently skipped, matching
+ * how the wallet historically handled cosigner/connector inputs.
+ */
+export declare class InputSignerRouter {
+    private readonly deps;
+    constructor(deps: InputSignerRouterDeps);
+    sign(tx: Transaction, jobs: InputSigningJob[]): Promise<Transaction>;
+}

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

@@ -1,10 +1,10 @@
 import { P2TR } from "@scure/btc-signer/payment.js";
-import { Coin, SendBitcoinParams } from ".";
-import { Identity } from "../identity";
-import { Network, NetworkName } from "../networks";
-import { OnchainProvider } from "../providers/onchain";
-import { AnchorBumper } from "../utils/anchor";
-import { Transaction } from "../utils/transaction";
+import { Coin, SendBitcoinParams } from "./index.js";
+import { Identity } from "../identity/index.js";
+import { Network, NetworkName } from "../networks.js";
+import { OnchainProvider } from "../providers/onchain.js";
+import { AnchorBumper } from "../utils/anchor.js";
+import { Transaction } from "../utils/transaction.js";
 /**
  * Onchain Bitcoin wallet implementation for traditional Bitcoin transactions.
  *

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

@@ -1,5 +1,5 @@
-import { ExtendedCoin, IWallet } from ".";
-import { FeeInfo, SettlementEvent } from "../providers/ark";
+import { ExtendedCoin, IWallet } from "./index.js";
+import { FeeInfo, SettlementEvent } from "../providers/ark.js";
 /**
  * Ramps is a class wrapping `settle` method to provide a more convenient interface for onboarding and offboarding operations.
  *

package/dist/types/wallet/serviceWorker/wallet-message-handler.d.ts

@@ -1,10 +1,10 @@
-import { SettlementEvent } from "../../providers/ark";
-import type { Contract, ContractEvent, ContractWithVtxos, GetContractsFilter, PathSelection } from "../../contracts";
-import type { CreateContractParams, GetAllSpendingPathsOptions, GetSpendablePathsOptions } from "../../contracts/contractManager";
-import { ArkTransaction, AssetDetails, BurnParams, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IssuanceParams, IssuanceResult, IWallet, Recipient, ReissuanceParams, SendBitcoinParams, SettleParams, VirtualCoin, WalletBalance } from "../index";
-import { DelegateInfo } from "../../providers/delegator";
-import { MessageHandler, RequestEnvelope, ResponseEnvelope } from "../../worker/messageBus";
-import { Transaction } from "../../utils/transaction";
+import { SettlementEvent } from "../../providers/ark.js";
+import type { Contract, ContractEvent, ContractWithVtxos, GetContractsFilter, PathSelection } from "../../contracts/index.js";
+import type { CreateContractParams, GetAllSpendingPathsOptions, GetSpendablePathsOptions } from "../../contracts/contractManager.js";
+import { ArkTransaction, AssetDetails, BurnParams, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IssuanceParams, IssuanceResult, IWallet, Recipient, ReissuanceParams, SendBitcoinParams, SettleParams, VirtualCoin, WalletBalance } from "../index.js";
+import { DelegateInfo } from "../../providers/delegator.js";
+import { MessageHandler, RequestEnvelope, ResponseEnvelope } from "../../worker/messageBus.js";
+import { Transaction } from "../../utils/transaction.js";
 export declare class WalletNotInitializedError extends Error {
     constructor();
 }

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

@@ -1,15 +1,16 @@
-import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, StorageConfig, IReadonlyWallet, IReadonlyAssetManager, IAssetManager, Recipient } from "..";
-import { SettlementEvent } from "../../providers/ark";
-import { Identity, ReadonlyIdentity, type SerializedIdentity, type LegacySerializedIdentity } from "../../identity";
-import { WalletRepository } from "../../repositories/walletRepository";
-import { ContractRepository } from "../../repositories/contractRepository";
-import { RequestInitWallet, ResponseGetStatus, WalletUpdaterRequest, WalletUpdaterResponse } from "./wallet-message-handler";
-import type { IContractManager } from "../../contracts/contractManager";
-import type { IDelegatorManager } from "../delegator";
-import type { IVtxoManager, SettlementConfig } from "../vtxo-manager";
-import type { ContractWatcherConfig } from "../../contracts/contractWatcher";
+import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, StorageConfig, IReadonlyWallet, IReadonlyAssetManager, IAssetManager, Recipient } from "../index.js";
+import { SettlementEvent } from "../../providers/ark.js";
+import { Identity, ReadonlyIdentity, type SerializedIdentity, type LegacySerializedIdentity } from "../../identity/index.js";
+import { WalletRepository } from "../../repositories/walletRepository.js";
+import { ContractRepository } from "../../repositories/contractRepository.js";
+import { RequestInitWallet, ResponseGetStatus, WalletUpdaterRequest, WalletUpdaterResponse } from "./wallet-message-handler.js";
+import type { IContractManager } from "../../contracts/contractManager.js";
+import type { IDelegatorManager } from "../delegator.js";
+import type { IVtxoManager, SettlementConfig } from "../vtxo-manager.js";
+import type { ContractWatcherConfig } from "../../contracts/contractWatcher.js";
 type RequestType = WalletUpdaterRequest["type"];
 export type MessageTimeouts = Partial<Record<RequestType, number>>;
+export type ServiceWorkerWalletMode = "auto" | "static" | "hd";
 export declare const DEFAULT_MESSAGE_TIMEOUTS: Readonly<Record<RequestType, number>>;
 /**
  * Service Worker-based wallet implementation for browser environments.
@@ -68,6 +69,14 @@ interface ServiceWorkerWalletOptions {
     messageBusTimeoutMs?: number;
     /** Optional settlement configuration forwarded to the worker wallet. */
     settlementConfig?: SettlementConfig | false;
+    /**
+     * Receive-address strategy forwarded to the worker wallet.
+     *
+     * Service workers can only receive serializable configuration, so the
+     * descriptor-provider object form accepted by `Wallet.create()` is not
+     * supported here.
+     */
+    walletMode?: ServiceWorkerWalletMode;
     /** Optional contract watcher configuration forwarded to the worker wallet. */
     watcherConfig?: Partial<Omit<ContractWatcherConfig, "indexerProvider">>;
     /**
@@ -109,6 +118,7 @@ type MessageBusInitConfig = {
     esploraUrl?: string;
     timeoutMs?: number;
     settlementConfig?: SettlementConfig | false;
+    walletMode?: ServiceWorkerWalletMode;
     watcherConfig?: Partial<Omit<ContractWatcherConfig, "indexerProvider">>;
     messageTimeouts?: Record<string, number>;
 };

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

@@ -0,0 +1,19 @@
+/**
+ * Thrown when a rotated contract (default or delegate) is missing the
+ * metadata.signingDescriptor required to route it to a descriptor-aware
+ * signer.
+ */
+export declare class MissingSigningDescriptorError extends Error {
+    readonly contractScript: string;
+    readonly contractType: "default" | "delegate";
+    readonly name = "MissingSigningDescriptorError";
+    constructor(contractScript: string, contractType: "default" | "delegate");
+}
+/**
+ * Thrown when an input needs descriptor-aware signing but no
+ * DescriptorProvider was wired into the wallet.
+ */
+export declare class DescriptorSigningProviderMissingError extends Error {
+    readonly name = "DescriptorSigningProviderMissingError";
+    constructor();
+}

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

@@ -1,9 +1,9 @@
-import { ChainTx, IndexerProvider } from "../providers/indexer";
-import { AnchorBumper } from "../utils/anchor";
-import { OnchainProvider } from "../providers/onchain";
-import { Outpoint } from ".";
-import { Wallet } from "./wallet";
-import { Transaction } from "../utils/transaction";
+import { ChainTx, IndexerProvider } from "../providers/indexer.js";
+import { AnchorBumper } from "../utils/anchor.js";
+import { OnchainProvider } from "../providers/onchain.js";
+import { Outpoint } from "./index.js";
+import { Wallet } from "./wallet.js";
+import { Transaction } from "../utils/transaction.js";
 export declare namespace Unroll {
     enum StepType {
         UNROLL = 0,

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

@@ -1,8 +1,8 @@
-import { Recipient } from ".";
-import { type Coin, type ExtendedCoin, type ExtendedVirtualCoin, type VirtualCoin } from "..";
-import type { Contract } from "../contracts/types";
-import { ReadonlyWallet } from "./wallet";
-import { Bytes } from "@scure/btc-signer/utils";
+import { Recipient } from "./index.js";
+import { type Coin, type ExtendedCoin, type ExtendedVirtualCoin, type VirtualCoin } from "../index.js";
+import type { Contract } from "../contracts/types.js";
+import { ReadonlyWallet } from "./wallet.js";
+import { Bytes } from "@scure/btc-signer/utils.js";
 export declare const DUST_AMOUNT = 546;
 export declare function extendCoin(wallet: {
     boardingTapscript: ReadonlyWallet["boardingTapscript"];

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

@@ -1,6 +1,6 @@
-import { Recipient } from ".";
-import { Transaction } from "../utils/transaction";
-import type { Network } from "../networks";
+import { Recipient } from "./index.js";
+import { Transaction } from "../utils/transaction.js";
+import type { Network } from "../networks.js";
 export declare const ErrOffchainOutputNotFound: (address: string) => Error;
 export declare const ErrInvalidAssetOutputAmount: (got: bigint, want: bigint, assetId: string) => Error;
 export declare const ErrAssetGroupNotFound: (assetId: string) => Error;

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

@@ -1,5 +1,5 @@
-import { ExtendedCoin, ExtendedVirtualCoin, IWallet } from ".";
-import { SettlementEvent } from "../providers/ark";
+import { ExtendedCoin, ExtendedVirtualCoin, IWallet } from "./index.js";
+import { SettlementEvent } from "../providers/ark.js";
 /** Default renewal threshold in seconds (3 days). */
 export declare const DEFAULT_THRESHOLD_SECONDS: number;
 /**