@arkade-os/sdk 0.4.28 → 0.4.29

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { M as ReadonlyIdentity, a as Identity, a5 as DescriptorSigningRequest, a6 as Transaction, a2 as SignerSession, W as WalletRepository, E as ExtendedVirtualCoin, s as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, t as WalletState, r as Contract, C as ContractRepository, u as ContractFilter, a7 as IntentFeeConfig, a8 as OffchainInput, a9 as FeeAmount, aa as OnchainInput, ab as FeeOutput, m as ArkProvider, a0 as SettlementConfig, ac as ContractWatcherConfig, I as IWallet, ad as FeeInfo, h as SettlementEvent, J as DescriptorProvider, g as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ae as CreateContractParams, af as GetContractsFilter, q as VirtualCoin, ag as GetSpendablePathsOptions, ah as GetAllSpendingPathsOptions, R as Recipient, ai as IssuanceParams, aj as ReissuanceParams, ak as BurnParams, c as WalletBalance, al as ContractWithVtxos, am as PathSelection, an as ContractEvent, ao as AssetDetails, ap as IssuanceResult, aq as DelegateInfo, L as IReadonlyWallet, U as IReadonlyAssetManager, ar as StorageConfig, e as IContractManager, i as IAssetManager, f as IDelegatorManager, as as IVtxoManager, O as OnchainProvider, N as Network, X as NetworkName, K as Coin, at as ExplorerTransaction, p as TapLeafScript, au as EncodedVtxoScript, $ as CSVMultisigTapscript, o as RelativeTimelock, V as VtxoScript, av as Status, aw as Outpoint, ax as ChainTx, n as IndexerProvider, w as TxTree } from './ark-TZ1gXAXU.cjs';
-export { Z as ArkAddress, Y as ArkInfo, ay as ArkTapscript, az as Asset, aA as AssetMetadata, aB as BaseWalletConfig, D as BatchFailedEvent, y as BatchFinalizationEvent, z as BatchFinalizedEvent, aC as BatchInfo, aD as BatchSignableIdentity, B as BatchStartedEvent, aE as CLTVMultisigTapscript, aF as ChainTxType, aG as CommitmentTx, aH as ConditionCSVMultisigTapscript, aI as ConditionMultisigTapscript, aJ as ContractBalance, aK as ContractEventCallback, aL as ContractHandler, _ as ContractManager, aM as ContractManagerConfig, aN as ContractState, aO as ContractVtxo, aP as ContractWatcher, aQ as DelegateOptions, aR as DelegatorManagerImpl, P as DelegatorProvider, aS as Discoverable, aT as DiscoveredContract, aU as DiscoveryDeps, aV as ESPLORA_URL, aW as EsploraProvider, aX as ExtendedContractVtxo, aY as HandlerError, aZ as IndexerTxType, a4 as Intent, a_ as KnownMetadata, a$ as MultisigTapscript, b0 as Nonces, b1 as Output, b2 as PageResponse, b3 as PaginationOptions, b4 as PartialSig, b5 as PathContext, b6 as ProviderClass, Q as ReadonlyWalletConfig, j as RestArkProvider, b7 as RestDelegatorProvider, k as RestIndexerProvider, b8 as ScanContractsOptions, b9 as ScanResult, ba as ScheduledSession, bb as SettlementEventType, bc as SignRequest, a3 as SignedIntent, bd as SubscriptionEvent, be as SubscriptionHeartbeat, l as SubscriptionResponse, bf as TapLeaves, bg as TapTreeCoder, bh as TapscriptType, bi as TreeNonces, x as TreeNoncesEvent, bj as TreePartialSigs, H as TreeSignatureEvent, v as TreeSigningStartedEvent, F as TreeTxEvent, bk as Tx, bl as TxHistoryRecord, bm as TxKey, T as TxNotification, bn as TxTreeNode, bo as TxType, bp as VirtualStatus, bq as Vtxo, br as VtxoChain, a1 as VtxoManager, bs as VtxoType, b as WalletConfig, bt as WalletMode, bu as decodeTapscript, bv as getSequence, bw as isBatchSignable, bx as isDiscoverable, by as isExpired, bz as isRecoverable, bA as isSpendable, bB as isSubdust, bC as isVtxoExpiringSoon, bD as networks } from './ark-TZ1gXAXU.cjs';
-export { D as DefaultContractHandler, a as DefaultContractParams, b as DelegateContractHandler, c as DelegateContractParams, V as VHTLC, d as VHTLCContractHandler, e as VHTLCContractParams, f as contractHandlers } from './index-B22cA64m.cjs';
-export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BFZs69hp.cjs';
-import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot } from './wallet-AF-p-OWj.cjs';
-export { B as Batch, I as IncomingFunds, w as waitForIncomingFunds } from './wallet-AF-p-OWj.cjs';
+import { L as ReadonlyIdentity, a as Identity, a5 as DescriptorSigningRequest, a6 as Transaction, a2 as SignerSession, W as WalletRepository, E as ExtendedVirtualCoin, s as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, t as WalletState, r as Contract, C as ContractRepository, u as ContractFilter, a7 as IntentFeeConfig, a8 as OffchainInput, a9 as FeeAmount, aa as OnchainInput, ab as FeeOutput, m as ArkProvider, a0 as SettlementConfig, ac as ContractWatcherConfig, I as IWallet, ad as FeeInfo, h as SettlementEvent, J as DescriptorProvider, g as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ae as CreateContractParams, af as GetContractsFilter, q as VirtualCoin, ag as GetSpendablePathsOptions, ah as GetAllSpendingPathsOptions, R as Recipient, ai as IssuanceParams, aj as ReissuanceParams, ak as BurnParams, c as WalletBalance, al as ContractWithVtxos, am as PathSelection, an as ContractEvent, ao as AssetDetails, ap as IssuanceResult, aq as DelegateInfo, K as IReadonlyWallet, Q as IReadonlyAssetManager, ar as StorageConfig, e as IContractManager, i as IAssetManager, f as IDelegateManager, as as IVtxoManager, O as OnchainProvider, N as Network, U as NetworkName, Z as Coin, at as ExplorerTransaction, p as TapLeafScript, au as EncodedVtxoScript, $ as CSVMultisigTapscript, o as RelativeTimelock, V as VtxoScript, av as Status, aw as Outpoint, ax as ChainTx, n as IndexerProvider, w as TxTree } from './ark-ChhTwpLf.cjs';
+export { Y as ArkAddress, X as ArkInfo, ay as ArkTapscript, az as Asset, aA as AssetMetadata, aB as BaseWalletConfig, D as BatchFailedEvent, y as BatchFinalizationEvent, z as BatchFinalizedEvent, aC as BatchInfo, aD as BatchSignableIdentity, B as BatchStartedEvent, aE as CLTVMultisigTapscript, aF as ChainTxType, aG as CommitmentTx, aH as ConditionCSVMultisigTapscript, aI as ConditionMultisigTapscript, aJ as ContractBalance, aK as ContractEventCallback, aL as ContractHandler, _ as ContractManager, aM as ContractManagerConfig, aN as ContractState, aO as ContractVtxo, aP as ContractWatcher, aQ as DelegateManagerImpl, aR as DelegateOptions, M as DelegateProvider, aS as DelegatorManagerImpl, aT as DelegatorProvider, aU as Discoverable, aV as DiscoveredContract, aW as DiscoveryDeps, aX as ESPLORA_URL, aY as EsploraProvider, aZ as ExtendedContractVtxo, a_ as HandlerError, a$ as IDelegatorManager, b0 as IndexerTxType, a4 as Intent, b1 as KnownMetadata, b2 as MultisigTapscript, b3 as Nonces, b4 as Output, b5 as PageResponse, b6 as PaginationOptions, b7 as PartialSig, b8 as PathContext, b9 as ProviderClass, P as ReadonlyWalletConfig, j as RestArkProvider, ba as RestDelegateProvider, bb as RestDelegatorProvider, k as RestIndexerProvider, bc as ScanContractsOptions, bd as ScanResult, be as ScheduledSession, bf as SettlementEventType, bg as SignRequest, a3 as SignedIntent, bh as SubscriptionEvent, bi as SubscriptionHeartbeat, l as SubscriptionResponse, bj as TapLeaves, bk as TapTreeCoder, bl as TapscriptType, bm as TreeNonces, x as TreeNoncesEvent, bn as TreePartialSigs, H as TreeSignatureEvent, v as TreeSigningStartedEvent, F 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, a1 as VtxoManager, bw as VtxoType, b as WalletConfig, bx as WalletMode, by as decodeTapscript, bz as getSequence, bA as isBatchSignable, bB as isDiscoverable, bC as isExpired, bD as isRecoverable, bE as isSpendable, bF as isSubdust, bG as isVtxoExpiringSoon, bH as networks } from './ark-ChhTwpLf.cjs';
+export { D as DefaultContractHandler, a as DefaultContractParams, b as DelegateContractHandler, c as DelegateContractParams, V as VHTLC, d as VHTLCContractHandler, e as VHTLCContractParams, f as contractHandlers } from './index-DfT5xzgY.cjs';
+export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-4JBUkUhR.cjs';
+import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot } from './wallet-DjgFb_4T.cjs';
+export { B as Batch, I as IncomingFunds, w as waitForIncomingFunds } from './wallet-DjgFb_4T.cjs';
 import { P2TR } from '@scure/btc-signer/payment.js';
 import { Transaction as Transaction$1 } from '@scure/btc-signer';
 import { ElectrumWS } from 'ws-electrumx-client';
@@ -817,6 +817,8 @@ type Initialize = {
             url: string;
             publicKey?: string;
         };
+        delegateUrl?: string;
+        /** @deprecated alias for @see Initialize.config.delegateUrl */
         delegatorUrl?: string;
         indexerUrl?: string;
         esploraUrl?: string;
@@ -919,6 +921,17 @@ declare class MessageBus {
     static setup(path: string): Promise<ServiceWorker>;
 }
 
+/**
+ * Thrown when a collaborative-exit / offboard would leave a change VTXO below
+ * the dust threshold. Lets callers (e.g. wallet UI) react with appropriate UX
+ * — for instance, offering to exit the full balance — instead of forwarding a
+ * server-side dust rejection to the user.
+ */
+declare class DustChangeError extends Error {
+    readonly change: bigint;
+    readonly dustAmount: bigint;
+    constructor(change: bigint, dustAmount: bigint);
+}
 /**
  * Ramps is a class wrapping `settle` method to provide a more convenient interface for onboarding and offboarding operations.
  *
@@ -1113,9 +1126,12 @@ declare class WalletNotInitializedError extends Error {
 declare class ReadonlyWalletError extends Error {
     constructor();
 }
-declare class DelegatorNotConfiguredError extends Error {
+declare class DelegateNotConfiguredError extends Error {
     constructor();
 }
+/** @deprecated alias for DelegateNotConfiguredError */
+declare const DelegatorNotConfiguredError: typeof DelegateNotConfiguredError;
+type DelegatorNotConfiguredError = DelegateNotConfiguredError;
 type RequestInitWallet = RequestEnvelope & {
     type: "INIT_WALLET";
     payload: {
@@ -1576,8 +1592,17 @@ type ResponseSweepExpiredBoardingUtxos = ResponseEnvelope & {
         txid: string;
     };
 };
-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;
-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);
+type RequestRestoreWallet = RequestEnvelope & {
+    type: "RESTORE_WALLET";
+    payload: {
+        gapLimit?: number;
+    };
+};
+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 | 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 | ResponseRestoreWallet);
 declare class WalletMessageHandler implements MessageHandler<WalletUpdaterRequest, WalletUpdaterResponse> {
     readonly messageTag: string;
     private wallet;
@@ -1680,11 +1705,24 @@ declare const DEFAULT_MESSAGE_TIMEOUTS: Readonly<Record<RequestType, number>>;
 interface ServiceWorkerWalletOptions {
     /** Optional Arkade server public key used to construct and validate Arkade addresses. */
     arkServerPublicKey?: string;
-    /** Base URL of the Arkade server. */
+    /**
+     * Base URL of the Arkade server.
+     *
+     * @deprecated Provide an explicit provider via the worker config instead.
+     * URL-based configuration will be removed in a future major version.
+     */
     arkServerUrl?: string;
-    /** Optional override for the indexer URL. */
+    /**
+     * Optional override for the indexer URL.
+     *
+     * @deprecated Provide an explicit provider via the worker config instead.
+     */
     indexerUrl?: string;
-    /** Optional override for the Esplora API URL. */
+    /**
+     * Optional override for the Esplora API URL.
+     *
+     * @deprecated Provide an explicit provider via the worker config instead.
+     */
     esploraUrl?: string;
     /**
      * Repository-backed storage configuration overrides.
@@ -1694,6 +1732,8 @@ interface ServiceWorkerWalletOptions {
     /** Identity used to derive addresses and optionally sign operations. */
     identity: ReadonlyIdentity | Identity;
     /** Optional delegation service URL. */
+    delegateUrl?: string;
+    /** @deprecated alias for @see ServiceWorkerWalletOptions.delegateUrl */
     delegatorUrl?: string;
     /**
      * Override the default tag used for messages sent to and received from the service worker.
@@ -1748,6 +1788,8 @@ type MessageBusInitConfig = {
         url: string;
         publicKey?: string;
     };
+    delegateUrl?: string;
+    /** @deprecated alias for @see MessageBusInitConfig.delegateUrl */
     delegatorUrl?: string;
     indexerUrl?: string;
     esploraUrl?: string;
@@ -1770,6 +1812,8 @@ declare class ServiceWorkerReadonlyWallet implements IReadonlyWallet {
     protected messageTimeouts: Record<RequestType, number>;
     protected arkServerUrl?: string;
     protected arkServerPublicKey?: string;
+    protected delegateUrl?: string;
+    /** @deprecated alias for @see ServiceWorkerReadonlyWallet.delegateUrl */
     protected delegatorUrl?: string;
     protected indexerUrl?: string;
     protected esploraUrl?: string;
@@ -1855,8 +1899,8 @@ declare class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet implements
     readonly contractRepository: ContractRepository;
     readonly identity: Identity;
     private readonly _assetManager;
-    private readonly hasDelegator;
-    protected constructor(serviceWorker: ServiceWorker, identity: Identity, walletRepository: WalletRepository, contractRepository: ContractRepository, messageTag: string, hasDelegator: boolean);
+    private readonly hasDelegate;
+    protected constructor(serviceWorker: ServiceWorker, identity: Identity, walletRepository: WalletRepository, contractRepository: ContractRepository, messageTag: string, hasDelegate: boolean);
     get assetManager(): IAssetManager;
     protected serializeIdentity(): Promise<SerializedIdentity>;
     static create(options: ServiceWorkerWalletCreateOptions): Promise<ServiceWorkerWallet>;
@@ -1876,8 +1920,24 @@ declare class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet implements
     static setup(options: ServiceWorkerWalletSetupOptions): Promise<ServiceWorkerWallet>;
     sendBitcoin(params: SendBitcoinParams): Promise<string>;
     settle(params?: SettleParams, callback?: (event: SettlementEvent) => void): Promise<string>;
+    /**
+     * Explicitly recover this wallet's contracts and balance on a fresh repo.
+     * Mirrors {@link Wallet.restore} but drives the scan inside the service
+     * worker — the materialize() callback used by `scanContracts` cannot
+     * cross the postMessage boundary, so the entire flow runs worker-side
+     * and only the gapLimit / outcome cross the wire.
+     *
+     * Uses the streaming send path so the bus deadline does not race a
+     * long indexer-bound scan. AggregateError thrown by the worker is
+     * reconstructed here so callers can inspect `.errors`.
+     */
+    restore(opts?: {
+        gapLimit?: number;
+    }): Promise<void>;
     send(...recipients: [Recipient, ...Recipient[]]): Promise<string>;
-    getDelegatorManager(): Promise<IDelegatorManager | undefined>;
+    getDelegateManager(): Promise<IDelegateManager | undefined>;
+    /** @deprecated alias for @see ServiceWorkerWallet.getDelegateManager */
+    getDelegatorManager(): Promise<IDelegateManager | undefined>;
     getVtxoManager(): Promise<IVtxoManager>;
 }
 
@@ -1923,7 +1983,6 @@ declare class OnchainWallet implements AnchorBumper {
      * @param networkName - Bitcoin network name, @see NetworkName
      * @param provider - Optional onchain provider override, @see OnchainProvider
      * @returns Configured onchain wallet
-     * @defaultValue `provider = new EsploraProvider('https://mempool.space/api')`
      * @throws Error if the configured identity cannot produce a valid x-only public key
      */
     static create(identity: Identity, networkName?: NetworkName, provider?: OnchainProvider): Promise<OnchainWallet>;
@@ -3340,4 +3399,71 @@ declare class ServiceWorkerTimeoutError extends Error {
     constructor(detail: string);
 }
 
-export { type AnchorBumper, ArkError, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, AssetDetails, BIP322, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DelegateInfo, DelegatorNotConfiguredError, type DescriptorOptions, DescriptorSigningProviderMissingError, 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, GetVtxosFilter, HDDescriptorProvider, IContractManager, IDelegatorManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IssuanceParams, IssuanceResult, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathSelection, Ramps, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, Unroll, type VSize, VirtualCoin, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, index as asset, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isValidArkAddress, maybeArkError, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sequenceToTimelock, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };
+declare class ReadonlyAssetManager implements IReadonlyAssetManager {
+    readonly indexer: IndexerProvider;
+    constructor(indexer: IndexerProvider);
+    getAssetDetails(assetId: string): Promise<AssetDetails>;
+}
+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>;
+}
+
+export { type AnchorBumper, ArkError, 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, GetVtxosFilter, HDDescriptorProvider, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IssuanceParams, IssuanceResult, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathSelection, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, Unroll, type VSize, VirtualCoin, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, index as asset, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isValidArkAddress, maybeArkError, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sequenceToTimelock, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { M as ReadonlyIdentity, a as Identity, a5 as DescriptorSigningRequest, a6 as Transaction, a2 as SignerSession, W as WalletRepository, E as ExtendedVirtualCoin, s as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, t as WalletState, r as Contract, C as ContractRepository, u as ContractFilter, a7 as IntentFeeConfig, a8 as OffchainInput, a9 as FeeAmount, aa as OnchainInput, ab as FeeOutput, m as ArkProvider, a0 as SettlementConfig, ac as ContractWatcherConfig, I as IWallet, ad as FeeInfo, h as SettlementEvent, J as DescriptorProvider, g as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ae as CreateContractParams, af as GetContractsFilter, q as VirtualCoin, ag as GetSpendablePathsOptions, ah as GetAllSpendingPathsOptions, R as Recipient, ai as IssuanceParams, aj as ReissuanceParams, ak as BurnParams, c as WalletBalance, al as ContractWithVtxos, am as PathSelection, an as ContractEvent, ao as AssetDetails, ap as IssuanceResult, aq as DelegateInfo, L as IReadonlyWallet, U as IReadonlyAssetManager, ar as StorageConfig, e as IContractManager, i as IAssetManager, f as IDelegatorManager, as as IVtxoManager, O as OnchainProvider, N as Network, X as NetworkName, K as Coin, at as ExplorerTransaction, p as TapLeafScript, au as EncodedVtxoScript, $ as CSVMultisigTapscript, o as RelativeTimelock, V as VtxoScript, av as Status, aw as Outpoint, ax as ChainTx, n as IndexerProvider, w as TxTree } from './ark-TZ1gXAXU.js';
-export { Z as ArkAddress, Y as ArkInfo, ay as ArkTapscript, az as Asset, aA as AssetMetadata, aB as BaseWalletConfig, D as BatchFailedEvent, y as BatchFinalizationEvent, z as BatchFinalizedEvent, aC as BatchInfo, aD as BatchSignableIdentity, B as BatchStartedEvent, aE as CLTVMultisigTapscript, aF as ChainTxType, aG as CommitmentTx, aH as ConditionCSVMultisigTapscript, aI as ConditionMultisigTapscript, aJ as ContractBalance, aK as ContractEventCallback, aL as ContractHandler, _ as ContractManager, aM as ContractManagerConfig, aN as ContractState, aO as ContractVtxo, aP as ContractWatcher, aQ as DelegateOptions, aR as DelegatorManagerImpl, P as DelegatorProvider, aS as Discoverable, aT as DiscoveredContract, aU as DiscoveryDeps, aV as ESPLORA_URL, aW as EsploraProvider, aX as ExtendedContractVtxo, aY as HandlerError, aZ as IndexerTxType, a4 as Intent, a_ as KnownMetadata, a$ as MultisigTapscript, b0 as Nonces, b1 as Output, b2 as PageResponse, b3 as PaginationOptions, b4 as PartialSig, b5 as PathContext, b6 as ProviderClass, Q as ReadonlyWalletConfig, j as RestArkProvider, b7 as RestDelegatorProvider, k as RestIndexerProvider, b8 as ScanContractsOptions, b9 as ScanResult, ba as ScheduledSession, bb as SettlementEventType, bc as SignRequest, a3 as SignedIntent, bd as SubscriptionEvent, be as SubscriptionHeartbeat, l as SubscriptionResponse, bf as TapLeaves, bg as TapTreeCoder, bh as TapscriptType, bi as TreeNonces, x as TreeNoncesEvent, bj as TreePartialSigs, H as TreeSignatureEvent, v as TreeSigningStartedEvent, F as TreeTxEvent, bk as Tx, bl as TxHistoryRecord, bm as TxKey, T as TxNotification, bn as TxTreeNode, bo as TxType, bp as VirtualStatus, bq as Vtxo, br as VtxoChain, a1 as VtxoManager, bs as VtxoType, b as WalletConfig, bt as WalletMode, bu as decodeTapscript, bv as getSequence, bw as isBatchSignable, bx as isDiscoverable, by as isExpired, bz as isRecoverable, bA as isSpendable, bB as isSubdust, bC as isVtxoExpiringSoon, bD as networks } from './ark-TZ1gXAXU.js';
-export { D as DefaultContractHandler, a as DefaultContractParams, b as DelegateContractHandler, c as DelegateContractParams, V as VHTLC, d as VHTLCContractHandler, e as VHTLCContractParams, f as contractHandlers } from './index-NDla_UoJ.js';
-export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-aaVGfWsV.js';
-import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot } from './wallet-D9NBRqvC.js';
-export { B as Batch, I as IncomingFunds, w as waitForIncomingFunds } from './wallet-D9NBRqvC.js';
+import { L as ReadonlyIdentity, a as Identity, a5 as DescriptorSigningRequest, a6 as Transaction, a2 as SignerSession, W as WalletRepository, E as ExtendedVirtualCoin, s as VtxoRepositoryKey, d as ExtendedCoin, A as ArkTransaction, t as WalletState, r as Contract, C as ContractRepository, u as ContractFilter, a7 as IntentFeeConfig, a8 as OffchainInput, a9 as FeeAmount, aa as OnchainInput, ab as FeeOutput, m as ArkProvider, a0 as SettlementConfig, ac as ContractWatcherConfig, I as IWallet, ad as FeeInfo, h as SettlementEvent, J as DescriptorProvider, g as SettleParams, S as SendBitcoinParams, G as GetVtxosFilter, ae as CreateContractParams, af as GetContractsFilter, q as VirtualCoin, ag as GetSpendablePathsOptions, ah as GetAllSpendingPathsOptions, R as Recipient, ai as IssuanceParams, aj as ReissuanceParams, ak as BurnParams, c as WalletBalance, al as ContractWithVtxos, am as PathSelection, an as ContractEvent, ao as AssetDetails, ap as IssuanceResult, aq as DelegateInfo, K as IReadonlyWallet, Q as IReadonlyAssetManager, ar as StorageConfig, e as IContractManager, i as IAssetManager, f as IDelegateManager, as as IVtxoManager, O as OnchainProvider, N as Network, U as NetworkName, Z as Coin, at as ExplorerTransaction, p as TapLeafScript, au as EncodedVtxoScript, $ as CSVMultisigTapscript, o as RelativeTimelock, V as VtxoScript, av as Status, aw as Outpoint, ax as ChainTx, n as IndexerProvider, w as TxTree } from './ark-ChhTwpLf.js';
+export { Y as ArkAddress, X as ArkInfo, ay as ArkTapscript, az as Asset, aA as AssetMetadata, aB as BaseWalletConfig, D as BatchFailedEvent, y as BatchFinalizationEvent, z as BatchFinalizedEvent, aC as BatchInfo, aD as BatchSignableIdentity, B as BatchStartedEvent, aE as CLTVMultisigTapscript, aF as ChainTxType, aG as CommitmentTx, aH as ConditionCSVMultisigTapscript, aI as ConditionMultisigTapscript, aJ as ContractBalance, aK as ContractEventCallback, aL as ContractHandler, _ as ContractManager, aM as ContractManagerConfig, aN as ContractState, aO as ContractVtxo, aP as ContractWatcher, aQ as DelegateManagerImpl, aR as DelegateOptions, M as DelegateProvider, aS as DelegatorManagerImpl, aT as DelegatorProvider, aU as Discoverable, aV as DiscoveredContract, aW as DiscoveryDeps, aX as ESPLORA_URL, aY as EsploraProvider, aZ as ExtendedContractVtxo, a_ as HandlerError, a$ as IDelegatorManager, b0 as IndexerTxType, a4 as Intent, b1 as KnownMetadata, b2 as MultisigTapscript, b3 as Nonces, b4 as Output, b5 as PageResponse, b6 as PaginationOptions, b7 as PartialSig, b8 as PathContext, b9 as ProviderClass, P as ReadonlyWalletConfig, j as RestArkProvider, ba as RestDelegateProvider, bb as RestDelegatorProvider, k as RestIndexerProvider, bc as ScanContractsOptions, bd as ScanResult, be as ScheduledSession, bf as SettlementEventType, bg as SignRequest, a3 as SignedIntent, bh as SubscriptionEvent, bi as SubscriptionHeartbeat, l as SubscriptionResponse, bj as TapLeaves, bk as TapTreeCoder, bl as TapscriptType, bm as TreeNonces, x as TreeNoncesEvent, bn as TreePartialSigs, H as TreeSignatureEvent, v as TreeSigningStartedEvent, F 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, a1 as VtxoManager, bw as VtxoType, b as WalletConfig, bx as WalletMode, by as decodeTapscript, bz as getSequence, bA as isBatchSignable, bB as isDiscoverable, bC as isExpired, bD as isRecoverable, bE as isSpendable, bF as isSubdust, bG as isVtxoExpiringSoon, bH as networks } from './ark-ChhTwpLf.js';
+export { D as DefaultContractHandler, a as DefaultContractParams, b as DelegateContractHandler, c as DelegateContractParams, V as VHTLC, d as VHTLCContractHandler, e as VHTLCContractParams, f as contractHandlers } from './index-Cn82bBUu.js';
+export { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DN7RELL1.js';
+import { W as Wallet, R as ReadonlyWallet, a as ReceiveRotatorFactory, b as ReceiveRotatorBootOpts, c as ReceiveRotatorBoot } from './wallet-CCtqT2Wb.js';
+export { B as Batch, I as IncomingFunds, w as waitForIncomingFunds } from './wallet-CCtqT2Wb.js';
 import { P2TR } from '@scure/btc-signer/payment.js';
 import { Transaction as Transaction$1 } from '@scure/btc-signer';
 import { ElectrumWS } from 'ws-electrumx-client';
@@ -817,6 +817,8 @@ type Initialize = {
             url: string;
             publicKey?: string;
         };
+        delegateUrl?: string;
+        /** @deprecated alias for @see Initialize.config.delegateUrl */
         delegatorUrl?: string;
         indexerUrl?: string;
         esploraUrl?: string;
@@ -919,6 +921,17 @@ declare class MessageBus {
     static setup(path: string): Promise<ServiceWorker>;
 }
 
+/**
+ * Thrown when a collaborative-exit / offboard would leave a change VTXO below
+ * the dust threshold. Lets callers (e.g. wallet UI) react with appropriate UX
+ * — for instance, offering to exit the full balance — instead of forwarding a
+ * server-side dust rejection to the user.
+ */
+declare class DustChangeError extends Error {
+    readonly change: bigint;
+    readonly dustAmount: bigint;
+    constructor(change: bigint, dustAmount: bigint);
+}
 /**
  * Ramps is a class wrapping `settle` method to provide a more convenient interface for onboarding and offboarding operations.
  *
@@ -1113,9 +1126,12 @@ declare class WalletNotInitializedError extends Error {
 declare class ReadonlyWalletError extends Error {
     constructor();
 }
-declare class DelegatorNotConfiguredError extends Error {
+declare class DelegateNotConfiguredError extends Error {
     constructor();
 }
+/** @deprecated alias for DelegateNotConfiguredError */
+declare const DelegatorNotConfiguredError: typeof DelegateNotConfiguredError;
+type DelegatorNotConfiguredError = DelegateNotConfiguredError;
 type RequestInitWallet = RequestEnvelope & {
     type: "INIT_WALLET";
     payload: {
@@ -1576,8 +1592,17 @@ type ResponseSweepExpiredBoardingUtxos = ResponseEnvelope & {
         txid: string;
     };
 };
-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;
-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);
+type RequestRestoreWallet = RequestEnvelope & {
+    type: "RESTORE_WALLET";
+    payload: {
+        gapLimit?: number;
+    };
+};
+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 | 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 | ResponseRestoreWallet);
 declare class WalletMessageHandler implements MessageHandler<WalletUpdaterRequest, WalletUpdaterResponse> {
     readonly messageTag: string;
     private wallet;
@@ -1680,11 +1705,24 @@ declare const DEFAULT_MESSAGE_TIMEOUTS: Readonly<Record<RequestType, number>>;
 interface ServiceWorkerWalletOptions {
     /** Optional Arkade server public key used to construct and validate Arkade addresses. */
     arkServerPublicKey?: string;
-    /** Base URL of the Arkade server. */
+    /**
+     * Base URL of the Arkade server.
+     *
+     * @deprecated Provide an explicit provider via the worker config instead.
+     * URL-based configuration will be removed in a future major version.
+     */
     arkServerUrl?: string;
-    /** Optional override for the indexer URL. */
+    /**
+     * Optional override for the indexer URL.
+     *
+     * @deprecated Provide an explicit provider via the worker config instead.
+     */
     indexerUrl?: string;
-    /** Optional override for the Esplora API URL. */
+    /**
+     * Optional override for the Esplora API URL.
+     *
+     * @deprecated Provide an explicit provider via the worker config instead.
+     */
     esploraUrl?: string;
     /**
      * Repository-backed storage configuration overrides.
@@ -1694,6 +1732,8 @@ interface ServiceWorkerWalletOptions {
     /** Identity used to derive addresses and optionally sign operations. */
     identity: ReadonlyIdentity | Identity;
     /** Optional delegation service URL. */
+    delegateUrl?: string;
+    /** @deprecated alias for @see ServiceWorkerWalletOptions.delegateUrl */
     delegatorUrl?: string;
     /**
      * Override the default tag used for messages sent to and received from the service worker.
@@ -1748,6 +1788,8 @@ type MessageBusInitConfig = {
         url: string;
         publicKey?: string;
     };
+    delegateUrl?: string;
+    /** @deprecated alias for @see MessageBusInitConfig.delegateUrl */
     delegatorUrl?: string;
     indexerUrl?: string;
     esploraUrl?: string;
@@ -1770,6 +1812,8 @@ declare class ServiceWorkerReadonlyWallet implements IReadonlyWallet {
     protected messageTimeouts: Record<RequestType, number>;
     protected arkServerUrl?: string;
     protected arkServerPublicKey?: string;
+    protected delegateUrl?: string;
+    /** @deprecated alias for @see ServiceWorkerReadonlyWallet.delegateUrl */
     protected delegatorUrl?: string;
     protected indexerUrl?: string;
     protected esploraUrl?: string;
@@ -1855,8 +1899,8 @@ declare class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet implements
     readonly contractRepository: ContractRepository;
     readonly identity: Identity;
     private readonly _assetManager;
-    private readonly hasDelegator;
-    protected constructor(serviceWorker: ServiceWorker, identity: Identity, walletRepository: WalletRepository, contractRepository: ContractRepository, messageTag: string, hasDelegator: boolean);
+    private readonly hasDelegate;
+    protected constructor(serviceWorker: ServiceWorker, identity: Identity, walletRepository: WalletRepository, contractRepository: ContractRepository, messageTag: string, hasDelegate: boolean);
     get assetManager(): IAssetManager;
     protected serializeIdentity(): Promise<SerializedIdentity>;
     static create(options: ServiceWorkerWalletCreateOptions): Promise<ServiceWorkerWallet>;
@@ -1876,8 +1920,24 @@ declare class ServiceWorkerWallet extends ServiceWorkerReadonlyWallet implements
     static setup(options: ServiceWorkerWalletSetupOptions): Promise<ServiceWorkerWallet>;
     sendBitcoin(params: SendBitcoinParams): Promise<string>;
     settle(params?: SettleParams, callback?: (event: SettlementEvent) => void): Promise<string>;
+    /**
+     * Explicitly recover this wallet's contracts and balance on a fresh repo.
+     * Mirrors {@link Wallet.restore} but drives the scan inside the service
+     * worker — the materialize() callback used by `scanContracts` cannot
+     * cross the postMessage boundary, so the entire flow runs worker-side
+     * and only the gapLimit / outcome cross the wire.
+     *
+     * Uses the streaming send path so the bus deadline does not race a
+     * long indexer-bound scan. AggregateError thrown by the worker is
+     * reconstructed here so callers can inspect `.errors`.
+     */
+    restore(opts?: {
+        gapLimit?: number;
+    }): Promise<void>;
     send(...recipients: [Recipient, ...Recipient[]]): Promise<string>;
-    getDelegatorManager(): Promise<IDelegatorManager | undefined>;
+    getDelegateManager(): Promise<IDelegateManager | undefined>;
+    /** @deprecated alias for @see ServiceWorkerWallet.getDelegateManager */
+    getDelegatorManager(): Promise<IDelegateManager | undefined>;
     getVtxoManager(): Promise<IVtxoManager>;
 }
 
@@ -1923,7 +1983,6 @@ declare class OnchainWallet implements AnchorBumper {
      * @param networkName - Bitcoin network name, @see NetworkName
      * @param provider - Optional onchain provider override, @see OnchainProvider
      * @returns Configured onchain wallet
-     * @defaultValue `provider = new EsploraProvider('https://mempool.space/api')`
      * @throws Error if the configured identity cannot produce a valid x-only public key
      */
     static create(identity: Identity, networkName?: NetworkName, provider?: OnchainProvider): Promise<OnchainWallet>;
@@ -3340,4 +3399,71 @@ declare class ServiceWorkerTimeoutError extends Error {
     constructor(detail: string);
 }
 
-export { type AnchorBumper, ArkError, ArkNote, ArkProvider, type ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ArkTransaction, type ArkTxInput, AssetDetails, BIP322, BurnParams, CSVMultisigTapscript, ChainTx, Coin, ConditionWitness, Contract, ContractEvent, ContractRepository, ContractRepositoryImpl, ContractWatcherConfig, ContractWithVtxos, CosignerPublicKey, CreateContractParams, DEFAULT_MESSAGE_TIMEOUTS, DelegateInfo, DelegatorNotConfiguredError, type DescriptorOptions, DescriptorSigningProviderMissingError, 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, GetVtxosFilter, HDDescriptorProvider, IContractManager, IDelegatorManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IssuanceParams, IssuanceResult, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathSelection, Ramps, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, Unroll, type VSize, VirtualCoin, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, index as asset, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isValidArkAddress, maybeArkError, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sequenceToTimelock, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };
+declare class ReadonlyAssetManager implements IReadonlyAssetManager {
+    readonly indexer: IndexerProvider;
+    constructor(indexer: IndexerProvider);
+    getAssetDetails(assetId: string): Promise<AssetDetails>;
+}
+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>;
+}
+
+export { type AnchorBumper, ArkError, 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, GetVtxosFilter, HDDescriptorProvider, IAssetManager, IContractManager, IDelegateManager, IReadonlyAssetManager, IReadonlyWallet, IVtxoManager, IWallet, Identity, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, IndexerProvider, IntentFeeConfig, IssuanceParams, IssuanceResult, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, type MessageHandler, type MessageTimeouts, type MigrationStatus, MissingSigningDescriptorError, MnemonicIdentity, type MnemonicOptions, Network, NetworkName, type NetworkOptions, OffchainInput, type OffchainTx, OnchainInput, OnchainProvider, OnchainWallet, Outpoint, P2A, type ParsedArkContract, PathSelection, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlyIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, Recipient, ReissuanceParams, RelativeTimelock, type RequestEnvelope, type ResponseEnvelope, SeedIdentity, type SeedIdentityOptions, SendBitcoinParams, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, type ServiceWorkerWalletMode, SettleParams, SettlementConfig, SettlementEvent, SignerSession, SingleKey, Status, StorageConfig, TapLeafScript, Transaction, TxTree, TxWeightEstimator, Unroll, type VSize, VirtualCoin, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, Wallet, WalletBalance, WalletMessageHandler, WalletNotInitializedError, WalletRepository, WalletRepositoryImpl, WsElectrumChainSource, index as asset, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getArkPsbtFields, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isValidArkAddress, maybeArkError, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, sequenceToTimelock, setArkPsbtField, setupServiceWorker, timelockToSequence, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures };

package/dist/index.js

@@ -1,7 +1,7 @@
-export { ArkNote, BIP322, Batch, ContractManager, ContractRepositoryImpl, ContractWatcher, DEFAULT_MESSAGE_TIMEOUTS, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxWeightEstimator, Unroll, VtxoManager, Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isDiscoverable, isValidArkAddress, isVtxoExpiringSoon, migrateWalletRepository, networks, openDatabase, requiresMigration, rollbackMigration, setupServiceWorker, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds } from './chunk-BQLHADL7.js';
-export { ArkError, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ChainTxType, ConditionWitness, CosignerPublicKey, IndexerTxType, Intent, RestArkProvider, RestIndexerProvider, SettlementEventType, Transaction, VtxoTaprootTree, VtxoTreeExpiry, asset_exports as asset, getArkPsbtFields, maybeArkError, setArkPsbtField } from './chunk-ZBUDLTBO.js';
-export { DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, VHTLC, VHTLCContractHandler, contractHandlers } from './chunk-T64LAI7L.js';
-export { ArkAddress, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, MultisigTapscript, TapTreeCoder, TxType, VtxoScript, decodeTapscript, getSequence, isExpired, isRecoverable, isSpendable, isSubdust, sequenceToTimelock, timelockToSequence } from './chunk-HW3JJ323.js';
+export { ArkNote, AssetManager, BIP322, Batch, ContractManager, ContractRepositoryImpl, ContractWatcher, DEFAULT_MESSAGE_TIMEOUTS, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EsploraProvider, Estimator, HDDescriptorProvider, InMemoryContractRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBWalletRepository, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MessageBus, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, Unroll, VtxoManager, Wallet, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, buildForfeitTx, buildOffchainTx, closeDatabase, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, decodeArkContract, encodeArkContract, getMigrationStatus, getRandomId, hasBoardingTxExpired, isArkContract, isBatchSignable, isDiscoverable, isExpired, isRecoverable, isSpendable, isSubdust, isValidArkAddress, isVtxoExpiringSoon, migrateWalletRepository, openDatabase, requiresMigration, rollbackMigration, setupServiceWorker, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds } from './chunk-BVP2U66Q.js';
+export { ArkError, ArkPsbtFieldKey, ArkPsbtFieldKeyType, ChainTxType, ConditionWitness, CosignerPublicKey, IndexerTxType, Intent, RestArkProvider, RestIndexerProvider, SettlementEventType, Transaction, VtxoTaprootTree, VtxoTreeExpiry, asset_exports as asset, getArkPsbtFields, maybeArkError, setArkPsbtField } from './chunk-6NWNOLL3.js';
+export { DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, VHTLC, VHTLCContractHandler, contractHandlers } from './chunk-YA4G7RFB.js';
+export { ArkAddress, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, MultisigTapscript, TapTreeCoder, VtxoScript, decodeTapscript, getSequence, networks, sequenceToTimelock, timelockToSequence } from './chunk-TU3LVAPX.js';
 import './chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map