@arkade-os/sdk 0.5.0-rc.21 → 0.5.0-rc.23

package/dist/wallet/expo/background.js

@@ -1,9 +1,9 @@
-import { ExpoIndexerProvider, ExpoArkProvider } from '../../chunk-LNJPVLIC.js';
-import { contractPollProcessor, createTaskDependencies, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-S2WWOVFC.js';
-import { getRandomId } from '../../chunk-EXFU6MTA.js';
-import '../../chunk-JZAEFOE4.js';
-import '../../chunk-CXHJGED6.js';
-import '../../chunk-4FDNOLBO.js';
+import { ExpoIndexerProvider, ExpoArkProvider } from '../../chunk-B4CZLBE6.js';
+import { contractPollProcessor, createTaskDependencies, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-W2VYRZLB.js';
+import { getRandomId } from '../../chunk-ENGV6VZF.js';
+import '../../chunk-SPJA7XMU.js';
+import '../../chunk-UDQ3QE4C.js';
+import '../../chunk-XZEQV5FE.js';
 import * as TaskManager from 'expo-task-manager';
 import * as BackgroundTask from 'expo-background-task';
 

package/dist/wallet/expo/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkVZMLADXQ_cjs = require('../../chunk-VZMLADXQ.cjs');
-var chunkR5OFJ23O_cjs = require('../../chunk-R5OFJ23O.cjs');
-require('../../chunk-Q7PC3NHX.cjs');
-require('../../chunk-GVF4OCTL.cjs');
-var chunk5XBH5SAL_cjs = require('../../chunk-5XBH5SAL.cjs');
+var chunkJETDFDWV_cjs = require('../../chunk-JETDFDWV.cjs');
+var chunkH7W2KLN2_cjs = require('../../chunk-H7W2KLN2.cjs');
+require('../../chunk-YFHGGSII.cjs');
+require('../../chunk-QLJXXVRO.cjs');
+var chunkKR6FLFIH_cjs = require('../../chunk-KR6FLFIH.cjs');
 var base = require('@scure/base');
 
 function warnOnRemovedBackgroundFields(bg) {
@@ -56,20 +56,20 @@ var ExpoWallet = class _ExpoWallet {
    * by the consumer.
    */
   static async setup(config) {
-    chunk5XBH5SAL_cjs.assertTimerMs("foregroundIntervalMs", config.background.foregroundIntervalMs);
+    chunkKR6FLFIH_cjs.assertTimerMs("foregroundIntervalMs", config.background.foregroundIntervalMs);
     warnOnRemovedBackgroundFields(config.background);
-    const wallet = await chunkR5OFJ23O_cjs.Wallet.create(config);
-    const processors = config.background.processors ?? [chunkVZMLADXQ_cjs.contractPollProcessor];
+    const wallet = await chunkH7W2KLN2_cjs.Wallet.create(config);
+    const processors = config.background.processors ?? [chunkJETDFDWV_cjs.contractPollProcessor];
     const deps = {
       walletRepository: wallet.walletRepository,
       contractRepository: wallet.contractRepository,
       indexerProvider: wallet.indexerProvider,
       arkProvider: wallet.arkProvider,
-      extendVtxo: (vtxo, contract) => chunkR5OFJ23O_cjs.extendVirtualCoinForContract(vtxo, contract)
+      extendVtxo: (vtxo, contract) => chunkH7W2KLN2_cjs.extendVirtualCoinForContract(vtxo, contract)
     };
     const { taskQueue } = config.background;
     if ("persistConfig" in taskQueue) {
-      const arkServerUrl = chunkR5OFJ23O_cjs.extractArkProviderUrl(wallet.arkProvider);
+      const arkServerUrl = chunkH7W2KLN2_cjs.extractArkProviderUrl(wallet.arkProvider);
       if (typeof arkServerUrl === "string" && arkServerUrl.length > 0) {
         const timelock = wallet.offchainTapscript.options.csvTimelock;
         const bgConfig = {
@@ -100,7 +100,7 @@ var ExpoWallet = class _ExpoWallet {
   }
   async runForegroundPoll() {
     if (this.cleared) return;
-    await chunkVZMLADXQ_cjs.runTasks(this.taskQueue, this.processors, this.deps);
+    await chunkJETDFDWV_cjs.runTasks(this.taskQueue, this.processors, this.deps);
     const results = await this.taskQueue.getResults();
     if (results.length > 0) {
       await this.taskQueue.acknowledgeResults(results.map((r) => r.id));
@@ -109,18 +109,18 @@ var ExpoWallet = class _ExpoWallet {
     await this.seedContractPollTask();
   }
   async seedContractPollTask() {
-    const existing = await this.taskQueue.getTasks(chunkVZMLADXQ_cjs.CONTRACT_POLL_TASK_TYPE);
+    const existing = await this.taskQueue.getTasks(chunkJETDFDWV_cjs.CONTRACT_POLL_TASK_TYPE);
     if (existing.length > 0) return;
     const task = {
-      id: chunkR5OFJ23O_cjs.getRandomId(),
-      type: chunkVZMLADXQ_cjs.CONTRACT_POLL_TASK_TYPE,
+      id: chunkH7W2KLN2_cjs.getRandomId(),
+      type: chunkJETDFDWV_cjs.CONTRACT_POLL_TASK_TYPE,
       data: {},
       createdAt: Date.now()
     };
     await this.taskQueue.addTask(task);
   }
   async removeContractPollTasks() {
-    const tasks = await this.taskQueue.getTasks(chunkVZMLADXQ_cjs.CONTRACT_POLL_TASK_TYPE);
+    const tasks = await this.taskQueue.getTasks(chunkJETDFDWV_cjs.CONTRACT_POLL_TASK_TYPE);
     for (const task of tasks) {
       await this.taskQueue.removeTask(task.id);
     }

package/dist/wallet/expo/index.d.cts

@@ -1,9 +1,9 @@
-import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../wallet-DG3Qmbmt.cjs';
-import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, E as ExtendedCoin, h as ArkTransaction, i as ActivityRegistry, j as Activity, k as IContractManager, l as GetNewAddressesOptions, m as NewAddress, n as IDelegateManager, S as SettleParams, o as SettlementEvent, p as SendParams, R as Recipient, q as IAssetManager } from '../../index-CK5QbTmZ.cjs';
-import { c as TaskQueue, T as TaskProcessor } from '../../taskRunner-Csey3EYJ.cjs';
+import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../wallet-CdUjdg15.cjs';
+import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, E as ExtendedCoin, h as ArkTransaction, i as ActivityRegistry, j as Activity, k as IContractManager, l as GetNewAddressesOptions, m as NewAddress, n as IDelegateManager, S as SettleParams, o as SettlementEvent, p as SendParams, R as Recipient, q as IAssetManager } from '../../index-BKBoBSKX.cjs';
+import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-CoGRmz1U.cjs';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer/utils.js';
-import '../../delegate-u6kXTtWY.cjs';
+import '../../delegate-DRoyCz4n.cjs';
 import '@scure/btc-signer';
 import '@scure/btc-signer/transaction.js';
 

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

@@ -1,9 +1,9 @@
-import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../wallet-DzSLMxBZ.js';
-import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, E as ExtendedCoin, h as ArkTransaction, i as ActivityRegistry, j as Activity, k as IContractManager, l as GetNewAddressesOptions, m as NewAddress, n as IDelegateManager, S as SettleParams, o as SettlementEvent, p as SendParams, R as Recipient, q as IAssetManager } from '../../index-CK5QbTmZ.js';
-import { c as TaskQueue, T as TaskProcessor } from '../../taskRunner-BeYR6NpQ.js';
+import { H as HDWalletCapable, a as HDAllocationCapable, A as AddressAllocationCapable, W as Wallet, P as ProviderConnectionState } from '../../wallet-yKzfCUfY.js';
+import { I as IWallet, a as Identity, b as WalletConfig, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, d as ArkadeBroadcaster, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, E as ExtendedCoin, h as ArkTransaction, i as ActivityRegistry, j as Activity, k as IContractManager, l as GetNewAddressesOptions, m as NewAddress, n as IDelegateManager, S as SettleParams, o as SettlementEvent, p as SendParams, R as Recipient, q as IAssetManager } from '../../index-BKBoBSKX.js';
+import { a as TaskQueue, T as TaskProcessor } from '../../taskRunner-B78rNRXB.js';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer/utils.js';
-import '../../delegate-BT5iON1T.js';
+import '../../delegate-DATx5c2o.js';
 import '@scure/btc-signer';
 import '@scure/btc-signer/transaction.js';
 

package/dist/wallet/expo/index.js

@@ -1,8 +1,8 @@
-import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-S2WWOVFC.js';
-import { Wallet, extractArkProviderUrl, getRandomId, extendVirtualCoinForContract } from '../../chunk-EXFU6MTA.js';
-import '../../chunk-JZAEFOE4.js';
-import '../../chunk-CXHJGED6.js';
-import { assertTimerMs } from '../../chunk-4FDNOLBO.js';
+import { contractPollProcessor, runTasks, CONTRACT_POLL_TASK_TYPE } from '../../chunk-W2VYRZLB.js';
+import { Wallet, extractArkProviderUrl, getRandomId, extendVirtualCoinForContract } from '../../chunk-ENGV6VZF.js';
+import '../../chunk-SPJA7XMU.js';
+import '../../chunk-UDQ3QE4C.js';
+import { assertTimerMs } from '../../chunk-XZEQV5FE.js';
 import { hex } from '@scure/base';
 
 function warnOnRemovedBackgroundFields(bg) {

package/dist/{wallet-DzSLMxBZ.d.ts → wallet-CdUjdg15.d.cts}

@@ -1,7 +1,7 @@
-import { W as WalletRepository, P as PageRequest, O as Outpoint, D as PageResult, B as ExtendedVirtualCoin, F as ScriptVtxoCursor, H as ScriptVtxoPageOptions, J as StoredVtxo, K as VtxoRepositoryKey, E as ExtendedCoin, L as TransactionHistoryPageFilter, M as TransactionHistoryPageCursor, h as ArkTransaction, Q as WalletState, a2 as DescriptorProvider, a3 as DescriptorSigningRequest, a4 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, w as RelativeTimelock, a5 as Network, a6 as CSVMultisigTapscript, a7 as BatchStartedEvent, a8 as TreeSigningStartedEvent, a9 as TxTree, aa as TreeNoncesEvent, ab as BatchFinalizationEvent, ac as BatchFinalizedEvent, ad as BatchFailedEvent, ae as TreeTxEvent, af as TreeSignatureEvent, o as SettlementEvent, b as WalletConfig, C as ContractRepository, k as IContractManager, ag as IReadonlyWallet, ah as ReadonlyIdentity, ai as OnchainProvider, u as ArkProvider, v as IndexerProvider, aj as DelegateProvider, ak as ReadonlyWalletConfig, X as IntentRepository, _ as VirtualTxRepository, al as ExitCaptureMode, am as ExitDataSource, i as ActivityRegistry, an as IReadonlyAssetManager, ao as ContractSyncState, ap as RecipientArkadeAddressContext, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, aq as NetworkName, ar as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, as as ContractWithVtxos, at as selectPendingRecoveryOutpoints, j as Activity, au as Coin, av as ContractManager, aw as ContractManagerConfig, I as IWallet, ax as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, ay as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, az as SignerSession, aA as SignedIntent, aB as Intent, p as SendParams, aC as TimeHeight } from './index-CK5QbTmZ.js';
+import { W as WalletRepository, P as PageRequest, O as Outpoint, D as PageResult, B as ExtendedVirtualCoin, F as ScriptVtxoCursor, H as ScriptVtxoPageOptions, J as StoredVtxo, K as VtxoRepositoryKey, E as ExtendedCoin, L as TransactionHistoryPageFilter, M as TransactionHistoryPageCursor, h as ArkTransaction, Q as WalletState, a2 as DescriptorProvider, a3 as DescriptorSigningRequest, a4 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, w as RelativeTimelock, a5 as Network, a6 as CSVMultisigTapscript, a7 as BatchStartedEvent, a8 as TreeSigningStartedEvent, a9 as TxTree, aa as TreeNoncesEvent, ab as BatchFinalizationEvent, ac as BatchFinalizedEvent, ad as BatchFailedEvent, ae as TreeTxEvent, af as TreeSignatureEvent, o as SettlementEvent, b as WalletConfig, C as ContractRepository, k as IContractManager, ag as IReadonlyWallet, ah as ReadonlyIdentity, ai as OnchainProvider, u as ArkProvider, v as IndexerProvider, aj as DelegateProvider, ak as ReadonlyWalletConfig, X as IntentRepository, _ as VirtualTxRepository, al as ExitCaptureMode, am as ExitDataSource, i as ActivityRegistry, an as IReadonlyAssetManager, ao as ContractSyncState, ap as RecipientArkadeAddressContext, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, aq as NetworkName, ar as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, as as ContractWithVtxos, at as selectPendingRecoveryOutpoints, j as Activity, au as Coin, av as ContractManager, aw as ContractManagerConfig, I as IWallet, ax as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, ay as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, az as SignerSession, aA as SignedIntent, aB as Intent, p as SendParams, aC as TimeHeight } from './index-BKBoBSKX.cjs';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-BT5iON1T.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DRoyCz4n.cjs';
 
 /**
  * IndexedDB-based implementation of WalletRepository.
@@ -849,14 +849,17 @@ declare class ArkadeCashCreateError extends Error {
 }
 /**
  * Freshness of provider-backed sync (server-info source + indexer-sync health). Balances/VTXOs
- * are always served from the repository regardless.
+ * are always served from the repository regardless. `syncing` says a provider sync is in flight
+ * right now; optional so adding it breaks no implementer, {@link ReadonlyWallet} always sets it.
  */
 type ProviderConnectionState = {
     mode: "online";
+    syncing?: boolean;
     source: "live";
     lastOnlineAt: number;
 } | {
     mode: "degraded";
+    syncing?: boolean;
     source: "cache" | "repository";
     provider: ProviderKind;
     reason: string;
@@ -873,6 +876,8 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     readonly walletRepository: WalletRepository;
     readonly contractRepository: ContractRepository;
     readonly delegateProvider?: DelegateProvider | undefined;
+    protected lazyInitialization: boolean;
+    private boardingLoaded;
     private _contractManager?;
     private _contractManagerInitializing?;
     protected readonly watcherConfig?: ReadonlyWalletConfig["watcherConfig"];
@@ -1048,6 +1053,9 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * Return the wallet's combined onchain and offchain balances.
      */
     getBalance(): Promise<WalletBalance>;
+    /** Cached balance; inspect connection state and boarding.loaded before displaying zeros. */
+    getStoredBalance(): Promise<WalletBalance>;
+    private balanceFromSnapshot;
     /**
      * Return virtual outputs tracked by the wallet, including escrowed, locked and
      * awaiting-recovery funds. Coin selection must use {@link getSpendableVtxos}: feeding this
@@ -1056,6 +1064,8 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * @param filter - Optional flags controlling whether recoverable or unrolled VTXOs are included
      */
     getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
+    /** Cached VTXOs; may be empty before the first sync. Never use for coin selection. */
+    getStoredVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /** @inheritdoc */
     getSpendableVtxos(filter?: GetSpendableVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
@@ -1083,6 +1093,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     protected contractSnapshot(filter?: GetSpendableVtxosFilter, options?: {
         unspentOnly?: boolean;
     }): Promise<ContractWithVtxos[]>;
+    protected contractSnapshotStored(): Promise<ContractWithVtxos[]>;
     /**
      * The two exclusion sets the gate is made of, derived from one snapshot so
      * {@link getSpendableVtxos} and the balance answer about the same instant.
@@ -1159,6 +1170,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * recovery goes through the deprecated-signer migration API.
      */
     getBoardingUtxos(): Promise<ExtendedCoin[]>;
+    getStoredBoardingUtxos(): Promise<ExtendedCoin[]>;
     /**
      * Subscribe to onchain and offchain notifications for newly received funds.
      *
@@ -1577,9 +1589,12 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      *
      * @param params - Optional settlement inputs and outputs. When omitted, the wallet settles all eligible funds.
      * @param eventCallback - Optional callback invoked for settlement stream events.
+     * @param hooks - Optional phases for preparation and intent registration.
      * @returns The finalized Arkade transaction id
      */
-    settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void, hooks?: {
+        onPhase?: (phase: "preparing" | "registration_attempt") => void;
+    }): Promise<string>;
     private _settleImpl;
     /**
      * Rotate-on-board: the boarding analogue of {@link WalletReceiveRotator}'s L2 rotation.
@@ -1783,10 +1798,13 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      *
      * @returns The Arkade transaction id and server-signed checkpoint PSBTs (for bookkeeping)
      */
-    buildAndSubmitOffchainTx(inputs: ExtendedVirtualCoin[], outputs: TransactionOutput[], serverUnrollScript?: CSVMultisigTapscript.Type): Promise<{
+    buildAndSubmitOffchainTx(inputs: ExtendedVirtualCoin[], outputs: TransactionOutput[], serverUnrollScript?: CSVMultisigTapscript.Type, options?: {
+        validUntil?: number;
+    }): Promise<{
         arkTxid: string;
         signedCheckpointTxs: string[];
     }>;
+    private _buildAndSubmitOffchainTx;
     private updateDbAfterOffchainTx;
     private updateDbAfterSettle;
 }

package/dist/{wallet-DG3Qmbmt.d.cts → wallet-yKzfCUfY.d.ts}

@@ -1,7 +1,7 @@
-import { W as WalletRepository, P as PageRequest, O as Outpoint, D as PageResult, B as ExtendedVirtualCoin, F as ScriptVtxoCursor, H as ScriptVtxoPageOptions, J as StoredVtxo, K as VtxoRepositoryKey, E as ExtendedCoin, L as TransactionHistoryPageFilter, M as TransactionHistoryPageCursor, h as ArkTransaction, Q as WalletState, a2 as DescriptorProvider, a3 as DescriptorSigningRequest, a4 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, w as RelativeTimelock, a5 as Network, a6 as CSVMultisigTapscript, a7 as BatchStartedEvent, a8 as TreeSigningStartedEvent, a9 as TxTree, aa as TreeNoncesEvent, ab as BatchFinalizationEvent, ac as BatchFinalizedEvent, ad as BatchFailedEvent, ae as TreeTxEvent, af as TreeSignatureEvent, o as SettlementEvent, b as WalletConfig, C as ContractRepository, k as IContractManager, ag as IReadonlyWallet, ah as ReadonlyIdentity, ai as OnchainProvider, u as ArkProvider, v as IndexerProvider, aj as DelegateProvider, ak as ReadonlyWalletConfig, X as IntentRepository, _ as VirtualTxRepository, al as ExitCaptureMode, am as ExitDataSource, i as ActivityRegistry, an as IReadonlyAssetManager, ao as ContractSyncState, ap as RecipientArkadeAddressContext, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, aq as NetworkName, ar as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, as as ContractWithVtxos, at as selectPendingRecoveryOutpoints, j as Activity, au as Coin, av as ContractManager, aw as ContractManagerConfig, I as IWallet, ax as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, ay as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, az as SignerSession, aA as SignedIntent, aB as Intent, p as SendParams, aC as TimeHeight } from './index-CK5QbTmZ.cjs';
+import { W as WalletRepository, P as PageRequest, O as Outpoint, D as PageResult, B as ExtendedVirtualCoin, F as ScriptVtxoCursor, H as ScriptVtxoPageOptions, J as StoredVtxo, K as VtxoRepositoryKey, E as ExtendedCoin, L as TransactionHistoryPageFilter, M as TransactionHistoryPageCursor, h as ArkTransaction, Q as WalletState, a2 as DescriptorProvider, a3 as DescriptorSigningRequest, a4 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, w as RelativeTimelock, a5 as Network, a6 as CSVMultisigTapscript, a7 as BatchStartedEvent, a8 as TreeSigningStartedEvent, a9 as TxTree, aa as TreeNoncesEvent, ab as BatchFinalizationEvent, ac as BatchFinalizedEvent, ad as BatchFailedEvent, ae as TreeTxEvent, af as TreeSignatureEvent, o as SettlementEvent, b as WalletConfig, C as ContractRepository, k as IContractManager, ag as IReadonlyWallet, ah as ReadonlyIdentity, ai as OnchainProvider, u as ArkProvider, v as IndexerProvider, aj as DelegateProvider, ak as ReadonlyWalletConfig, X as IntentRepository, _ as VirtualTxRepository, al as ExitCaptureMode, am as ExitDataSource, i as ActivityRegistry, an as IReadonlyAssetManager, ao as ContractSyncState, ap as RecipientArkadeAddressContext, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, aq as NetworkName, ar as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, as as ContractWithVtxos, at as selectPendingRecoveryOutpoints, j as Activity, au as Coin, av as ContractManager, aw as ContractManagerConfig, I as IWallet, ax as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, ay as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, az as SignerSession, aA as SignedIntent, aB as Intent, p as SendParams, aC as TimeHeight } from './index-BKBoBSKX.js';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-u6kXTtWY.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DATx5c2o.js';
 
 /**
  * IndexedDB-based implementation of WalletRepository.
@@ -849,14 +849,17 @@ declare class ArkadeCashCreateError extends Error {
 }
 /**
  * Freshness of provider-backed sync (server-info source + indexer-sync health). Balances/VTXOs
- * are always served from the repository regardless.
+ * are always served from the repository regardless. `syncing` says a provider sync is in flight
+ * right now; optional so adding it breaks no implementer, {@link ReadonlyWallet} always sets it.
  */
 type ProviderConnectionState = {
     mode: "online";
+    syncing?: boolean;
     source: "live";
     lastOnlineAt: number;
 } | {
     mode: "degraded";
+    syncing?: boolean;
     source: "cache" | "repository";
     provider: ProviderKind;
     reason: string;
@@ -873,6 +876,8 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     readonly walletRepository: WalletRepository;
     readonly contractRepository: ContractRepository;
     readonly delegateProvider?: DelegateProvider | undefined;
+    protected lazyInitialization: boolean;
+    private boardingLoaded;
     private _contractManager?;
     private _contractManagerInitializing?;
     protected readonly watcherConfig?: ReadonlyWalletConfig["watcherConfig"];
@@ -1048,6 +1053,9 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * Return the wallet's combined onchain and offchain balances.
      */
     getBalance(): Promise<WalletBalance>;
+    /** Cached balance; inspect connection state and boarding.loaded before displaying zeros. */
+    getStoredBalance(): Promise<WalletBalance>;
+    private balanceFromSnapshot;
     /**
      * Return virtual outputs tracked by the wallet, including escrowed, locked and
      * awaiting-recovery funds. Coin selection must use {@link getSpendableVtxos}: feeding this
@@ -1056,6 +1064,8 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * @param filter - Optional flags controlling whether recoverable or unrolled VTXOs are included
      */
     getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
+    /** Cached VTXOs; may be empty before the first sync. Never use for coin selection. */
+    getStoredVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /** @inheritdoc */
     getSpendableVtxos(filter?: GetSpendableVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
@@ -1083,6 +1093,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     protected contractSnapshot(filter?: GetSpendableVtxosFilter, options?: {
         unspentOnly?: boolean;
     }): Promise<ContractWithVtxos[]>;
+    protected contractSnapshotStored(): Promise<ContractWithVtxos[]>;
     /**
      * The two exclusion sets the gate is made of, derived from one snapshot so
      * {@link getSpendableVtxos} and the balance answer about the same instant.
@@ -1159,6 +1170,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      * recovery goes through the deprecated-signer migration API.
      */
     getBoardingUtxos(): Promise<ExtendedCoin[]>;
+    getStoredBoardingUtxos(): Promise<ExtendedCoin[]>;
     /**
      * Subscribe to onchain and offchain notifications for newly received funds.
      *
@@ -1577,9 +1589,12 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      *
      * @param params - Optional settlement inputs and outputs. When omitted, the wallet settles all eligible funds.
      * @param eventCallback - Optional callback invoked for settlement stream events.
+     * @param hooks - Optional phases for preparation and intent registration.
      * @returns The finalized Arkade transaction id
      */
-    settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
+    settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void, hooks?: {
+        onPhase?: (phase: "preparing" | "registration_attempt") => void;
+    }): Promise<string>;
     private _settleImpl;
     /**
      * Rotate-on-board: the boarding analogue of {@link WalletReceiveRotator}'s L2 rotation.
@@ -1783,10 +1798,13 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      *
      * @returns The Arkade transaction id and server-signed checkpoint PSBTs (for bookkeeping)
      */
-    buildAndSubmitOffchainTx(inputs: ExtendedVirtualCoin[], outputs: TransactionOutput[], serverUnrollScript?: CSVMultisigTapscript.Type): Promise<{
+    buildAndSubmitOffchainTx(inputs: ExtendedVirtualCoin[], outputs: TransactionOutput[], serverUnrollScript?: CSVMultisigTapscript.Type, options?: {
+        validUntil?: number;
+    }): Promise<{
         arkTxid: string;
         signedCheckpointTxs: string[];
     }>;
+    private _buildAndSubmitOffchainTx;
     private updateDbAfterOffchainTx;
     private updateDbAfterSettle;
 }

package/dist/worker/expo/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkVZMLADXQ_cjs = require('../../chunk-VZMLADXQ.cjs');
-require('../../chunk-R5OFJ23O.cjs');
-require('../../chunk-Q7PC3NHX.cjs');
-require('../../chunk-GVF4OCTL.cjs');
-require('../../chunk-5XBH5SAL.cjs');
+var chunkJETDFDWV_cjs = require('../../chunk-JETDFDWV.cjs');
+require('../../chunk-H7W2KLN2.cjs');
+require('../../chunk-YFHGGSII.cjs');
+require('../../chunk-QLJXXVRO.cjs');
+require('../../chunk-KR6FLFIH.cjs');
 
 // src/worker/expo/taskQueue.ts
 var InMemoryTaskQueue = class {
@@ -120,19 +120,19 @@ var AsyncStorageTaskQueue = class {
 
 Object.defineProperty(exports, "CONTRACT_POLL_TASK_TYPE", {
   enumerable: true,
-  get: function () { return chunkVZMLADXQ_cjs.CONTRACT_POLL_TASK_TYPE; }
+  get: function () { return chunkJETDFDWV_cjs.CONTRACT_POLL_TASK_TYPE; }
 });
 Object.defineProperty(exports, "contractPollProcessor", {
   enumerable: true,
-  get: function () { return chunkVZMLADXQ_cjs.contractPollProcessor; }
+  get: function () { return chunkJETDFDWV_cjs.contractPollProcessor; }
 });
 Object.defineProperty(exports, "createTaskDependencies", {
   enumerable: true,
-  get: function () { return chunkVZMLADXQ_cjs.createTaskDependencies; }
+  get: function () { return chunkJETDFDWV_cjs.createTaskDependencies; }
 });
 Object.defineProperty(exports, "runTasks", {
   enumerable: true,
-  get: function () { return chunkVZMLADXQ_cjs.runTasks; }
+  get: function () { return chunkJETDFDWV_cjs.runTasks; }
 });
 exports.AsyncStorageTaskQueue = AsyncStorageTaskQueue;
 exports.InMemoryTaskQueue = InMemoryTaskQueue;

package/dist/worker/expo/index.d.cts

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-Csey3EYJ.cjs';
-export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, a as TaskDependencies, b as TaskItem, c as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-Csey3EYJ.cjs';
-export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-x8ok3tJy.cjs';
-import '../../index-CK5QbTmZ.cjs';
+import { T as TaskProcessor } from '../../taskRunner-CoGRmz1U.cjs';
+export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, b as TaskDependencies, c as TaskItem, a as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-CoGRmz1U.cjs';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-DUu3VwBE.cjs';
+import '../../index-BKBoBSKX.cjs';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer';

package/dist/worker/expo/index.d.ts

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-BeYR6NpQ.js';
-export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, a as TaskDependencies, b as TaskItem, c as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-BeYR6NpQ.js';
-export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-aL7K14e4.js';
-import '../../index-CK5QbTmZ.js';
+import { T as TaskProcessor } from '../../taskRunner-B78rNRXB.js';
+export { C as CreateTaskDependenciesOptions, I as InMemoryTaskQueue, b as TaskDependencies, c as TaskItem, a as TaskQueue, d as TaskResult, e as createTaskDependencies, r as runTasks } from '../../taskRunner-B78rNRXB.js';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-Dm71_6ID.js';
+import '../../index-BKBoBSKX.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';
 import '@scure/btc-signer';

package/dist/worker/expo/index.js

@@ -1,8 +1,8 @@
-export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-S2WWOVFC.js';
-import '../../chunk-EXFU6MTA.js';
-import '../../chunk-JZAEFOE4.js';
-import '../../chunk-CXHJGED6.js';
-import '../../chunk-4FDNOLBO.js';
+export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-W2VYRZLB.js';
+import '../../chunk-ENGV6VZF.js';
+import '../../chunk-SPJA7XMU.js';
+import '../../chunk-UDQ3QE4C.js';
+import '../../chunk-XZEQV5FE.js';
 
 // src/worker/expo/taskQueue.ts
 var InMemoryTaskQueue = class {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.5.0-rc.21",
+  "version": "0.5.0-rc.23",
   "description": "TypeScript SDK for building Bitcoin wallets using the Arkade protocol",
   "repository": {
     "type": "git",