@arkade-os/sdk 0.5.3 → 0.5.4

package/dist/{wallet-BjQugVUt.d.cts → wallet-Oc3Wd5gv.d.ts}

@@ -1,7 +1,7 @@
-import { W as WalletRepository, P as PageRequest, O as Outpoint, F as PageResult, D as ExtendedVirtualCoin, H as ScriptVtxoCursor, J as ScriptVtxoPageOptions, K as StoredVtxo, L as VtxoRepositoryKey, E as ExtendedCoin, M as TransactionHistoryPageFilter, Q as TransactionHistoryPageCursor, h as ArkTransaction, U as WalletState, a3 as DescriptorProvider, a4 as DescriptorSigningRequest, a5 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, x as RelativeTimelock, a6 as Network, 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, v as ArkProvider, w as IndexerProvider, aj as DelegateProvider, ak as ReadonlyWalletConfig, Y 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 EsploraProvider, ar as NetworkName, as as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, at as ContractWithVtxos, au as selectPendingRecoveryOutpoints, j as Activity, av as Coin, aw as ContractManager, ax as ContractManagerConfig, I as IWallet, ay as CSVMultisigTapscript, az as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, aA as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, aB as SignerSession, aC as SignedIntent, aD as Intent, p as SendParams, aE as TimeHeight } from './index-BURzbRup.cjs';
-import { TransactionOutput } from '@scure/btc-signer/psbt.js';
+import { W as WalletRepository, P as PageRequest, F as Outpoint, H as PageResult, D as ExtendedVirtualCoin, J as ScriptVtxoCursor, K as ScriptVtxoPageOptions, L as StoredVtxo, M as VtxoRepositoryKey, E as ExtendedCoin, Q as TransactionHistoryPageFilter, U as TransactionHistoryPageCursor, h as ArkTransaction, X as AtomicWalletState, Y as WalletState, a5 as DescriptorProvider, a6 as DescriptorSigningRequest, a7 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, x as RelativeTimelock, a8 as Network, a9 as BatchStartedEvent, aa as TreeSigningStartedEvent, ab as TxTree, ac as TreeNoncesEvent, ad as BatchFinalizationEvent, ae as BatchFinalizedEvent, af as BatchFailedEvent, ag as TreeTxEvent, ah as TreeSignatureEvent, o as SettlementEvent, b as WalletConfig, C as ContractRepository, k as IContractManager, ai as IReadonlyWallet, aj as ReadonlyIdentity, ak as OnchainProvider, O as OperatorProvider, w as IndexerProvider, al as DelegateProvider, am as ReadonlyWalletConfig, _ as IntentRepository, a1 as VirtualTxRepository, an as ExitCaptureMode, ao as ExitDataSource, i as ActivityRegistry, ap as IReadonlyAssetManager, aq as ContractSyncState, ar as RecipientArkadeAddressContext, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, as as EsploraProvider, at as NetworkName, au as OperatorInfo, av as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, aw as ContractWithVtxos, ax as selectPendingRecoveryOutpoints, j as Activity, ay as Coin, az as ContractManager, aA as ContractManagerConfig, I as IWallet, aB as CSVMultisigTapscript, aC as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, aD as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, aE as SignerSession, aF as SignedIntent, aG as Intent, aH as SignedProof, aI as Proof, p as SendParams, aJ as TimeHeight } from './index-DRwe0UDN.js';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-ByfKszb6.cjs';
+import { TransactionOutput } from '@scure/btc-signer/psbt.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-xrSBNybC.js';
 
 /**
  * IndexedDB-based implementation of WalletRepository.
@@ -9,7 +9,10 @@ import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-ByfKszb6.cjs';
 declare class IndexedDBWalletRepository implements WalletRepository {
     readonly version: 2;
     private readonly connection;
-    constructor(dbName?: string);
+    /** persistentWalletState asserts persistence beyond this process; it cannot detect browser eviction. */
+    constructor(dbName?: string, options?: {
+        persistentWalletState?: boolean;
+    });
     clear(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
     getVtxosPage(address: string, page: PageRequest<Outpoint>): Promise<PageResult<ExtendedVirtualCoin, Outpoint>>;
@@ -25,6 +28,7 @@ declare class IndexedDBWalletRepository implements WalletRepository {
     getTransactionHistoryPage(filter: TransactionHistoryPageFilter, page: PageRequest<TransactionHistoryPageCursor>): Promise<PageResult<ArkTransaction, TransactionHistoryPageCursor>>;
     saveTransactions(address: string, txs: ArkTransaction[]): Promise<void>;
     deleteTransactions(address: string): Promise<void>;
+    readonly atomicWalletState: AtomicWalletState;
     getWalletState(): Promise<WalletState | null>;
     saveWalletState(state: WalletState): Promise<void>;
     private getDB;
@@ -431,7 +435,7 @@ type ServerInfoSource = "live" | "cache";
  * const handler = wallet.createBatchHandler(intentId, inputs, expectedRecipients, musig2session);
  *
  * const abortController = new AbortController();
- * // Get event stream from the Arkade provider
+ * // Get event stream from the operator provider
  * const eventStream = arkProvider.getEventStream(
  *   abortController.signal,
  *   ['your-topic-1', 'your-topic-2']
@@ -831,7 +835,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     readonly network: Network;
     readonly onchainProvider: OnchainProvider;
     /** Narrowed so a readonly wallet can't grow a `submitTx` use; `Wallet` re-widens it. */
-    protected readonly arkProvider: Pick<ArkProvider, "getInfo">;
+    protected readonly arkProvider: Pick<OperatorProvider, "getInfo">;
     readonly indexerProvider: IndexerProvider;
     readonly dustAmount: bigint;
     readonly walletRepository: WalletRepository;
@@ -905,7 +909,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     getContractSyncState(): ContractSyncState;
     protected constructor(identity: ReadonlyIdentity, network: Network, onchainProvider: OnchainProvider, 
     /** Narrowed so a readonly wallet can't grow a `submitTx` use; `Wallet` re-widens it. */
-    arkProvider: Pick<ArkProvider, "getInfo">, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider | undefined, watcherConfig?: ReadonlyWalletConfig["watcherConfig"], walletContractTimelocks?: RelativeTimelock[]);
+    arkProvider: Pick<OperatorProvider, "getInfo">, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider | undefined, watcherConfig?: ReadonlyWalletConfig["watcherConfig"], walletContractTimelocks?: RelativeTimelock[]);
     /**
      * x-only hex → cutoff of the operator's deprecated signers, cached for OFFLINE read/watch.
      * Boarding watch/history fan out over {current} ∪ this set so deposits at addresses minted
@@ -974,7 +978,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     protected notifyBoardingRotation(): void;
     /** Shared setup for ReadonlyWallet.create() and Wallet.create(). */
     protected static setupWalletConfig(config: ReadonlyWalletConfig, pubKey: Uint8Array): Promise<{
-        arkProvider: ArkProvider;
+        arkProvider: OperatorProvider;
         indexerProvider: IndexerProvider;
         onchainProvider: OnchainProvider | EsploraProvider;
         network: Network;
@@ -985,7 +989,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
         dustAmount: bigint;
         walletRepository: WalletRepository | IndexedDBWalletRepository;
         contractRepository: ContractRepository;
-        info: ArkadeInfo;
+        info: OperatorInfo;
         serverInfoSource: ServerInfoSource;
         serverInfoLastOnlineAt: number | undefined;
         delegateProvider: DelegateProvider | undefined;
@@ -1214,14 +1218,14 @@ declare class ReadonlyWallet implements IReadonlyWallet {
  * // Create a wallet with providers
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkProvider: new RestArkProvider(),
+ *   operatorProvider: new RestOperatorProvider(),
  *   onchainProvider: new EsploraProvider()
  * });
  *
  * // Use custom providers and/or URLs (e.g., for Expo/React Native)
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkProvider: new ExpoArkProvider('https://arkade.computer'),
+ *   operatorProvider: new ExpoOperatorProvider('https://arkade.computer'),
  *   indexerProvider: new ExpoIndexerProvider('https://arkade.computer'),
  *   onchainProvider: new EsploraProvider('https://mempool.space/api')
  * });
@@ -1521,13 +1525,13 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
     /** @see WalletConfig.concurrentSpending */
     get concurrentSpending(): boolean;
     /** Public here; `ReadonlyWallet` keeps it protected so a readonly view can't submit. */
-    readonly arkProvider: ArkProvider;
+    readonly arkProvider: OperatorProvider;
     /**
      * Broadcast access bound to this wallet's server, so a plugin needs only the wallet. Not on
      * {@link ReadonlyWallet}: a readonly wallet or `toReadonly()` view must not be able to submit.
      */
     getArkadeBroadcaster(): Promise<ArkadeBroadcaster>;
-    protected constructor(identity: Identity, network: Network, onchainProvider: OnchainProvider, arkProvider: ArkProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, serverUnrollScript: CSVMultisigTapscript.Type, forfeitOutputScript: Bytes, forfeitPubkey: Bytes, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider, watcherConfig?: WalletConfig["watcherConfig"], settlementConfig?: WalletConfig["settlementConfig"], walletContractTimelocks?: RelativeTimelock[], receiveRotator?: WalletReceiveRotator, descriptorProvider?: DescriptorProvider, keyring?: KeyringDescriptorProvider, lookAheadWindow?: number, 
+    protected constructor(identity: Identity, network: Network, onchainProvider: OnchainProvider, arkProvider: OperatorProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, serverUnrollScript: CSVMultisigTapscript.Type, forfeitOutputScript: Bytes, forfeitPubkey: Bytes, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider, watcherConfig?: WalletConfig["watcherConfig"], settlementConfig?: WalletConfig["settlementConfig"], walletContractTimelocks?: RelativeTimelock[], receiveRotator?: WalletReceiveRotator, descriptorProvider?: DescriptorProvider, keyring?: KeyringDescriptorProvider, lookAheadWindow?: number, 
     /** Overrides for the `batchExpiry` bounds; defaults derive from `network`. */
     batchExpiryPolicy?: Partial<BatchExpiryPolicy> | undefined, 
     /** @see WalletConfig.oneShotSubmit */
@@ -1544,7 +1548,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      * ```typescript
      * const wallet = await Wallet.create({
      *   identity,
-     *   arkProvider: new RestArkProvider(),
+     *   operatorProvider: new RestOperatorProvider(),
      * });
      * ```
      */
@@ -1619,9 +1623,9 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
     signInputsByWitnessScript(tx: Transaction): Promise<Transaction>;
     signOnchainBoardingTx(tx: Transaction): Promise<Transaction>;
     safeRegisterIntent(intent: SignedIntent<Intent.RegisterMessage>, inputs: ExtendedCoin[]): Promise<string>;
-    makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[], validAt?: number): Promise<SignedIntent<Intent.RegisterMessage>>;
-    makeDeleteIntentSignature(coins: ExtendedCoin[]): Promise<SignedIntent<Intent.DeleteMessage>>;
-    makeGetPendingTxIntentSignature(coins: ExtendedVirtualCoin[]): Promise<SignedIntent<Intent.GetPendingTxMessage>>;
+    makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[], validAt?: number): Promise<SignedProof<Proof.RegisterMessage>>;
+    makeDeleteIntentSignature(coins: ExtendedCoin[]): Promise<SignedProof<Proof.DeleteMessage>>;
+    makeGetPendingTxIntentSignature(coins: ExtendedVirtualCoin[]): Promise<SignedProof<Proof.GetPendingTxMessage>>;
     /**
      * Finalizes pending transactions by retrieving them from the server and finalizing each one.
      * Skips the server check entirely when no send was interrupted (no pending tx flag set).
@@ -1784,7 +1788,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
     sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[], now?: TimeHeight): Promise<string>;
     /**
      * Build an offchain transaction from the given inputs and outputs,
-     * sign it, submit to the Arkade provider, and finalize.
+     * sign it, submit to the operator provider, and finalize.
      *
      * Signs whatever it is handed, ungated — see {@link settle} for the trade.
      *

package/dist/{wallet-BnmhohgZ.d.ts → wallet-jVBDQl6R.d.cts}

@@ -1,7 +1,7 @@
-import { W as WalletRepository, P as PageRequest, O as Outpoint, F as PageResult, D as ExtendedVirtualCoin, H as ScriptVtxoCursor, J as ScriptVtxoPageOptions, K as StoredVtxo, L as VtxoRepositoryKey, E as ExtendedCoin, M as TransactionHistoryPageFilter, Q as TransactionHistoryPageCursor, h as ArkTransaction, U as WalletState, a3 as DescriptorProvider, a4 as DescriptorSigningRequest, a5 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, x as RelativeTimelock, a6 as Network, 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, v as ArkProvider, w as IndexerProvider, aj as DelegateProvider, ak as ReadonlyWalletConfig, Y 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 EsploraProvider, ar as NetworkName, as as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, at as ContractWithVtxos, au as selectPendingRecoveryOutpoints, j as Activity, av as Coin, aw as ContractManager, ax as ContractManagerConfig, I as IWallet, ay as CSVMultisigTapscript, az as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, aA as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, aB as SignerSession, aC as SignedIntent, aD as Intent, p as SendParams, aE as TimeHeight } from './index-BURzbRup.js';
-import { TransactionOutput } from '@scure/btc-signer/psbt.js';
+import { W as WalletRepository, P as PageRequest, F as Outpoint, H as PageResult, D as ExtendedVirtualCoin, J as ScriptVtxoCursor, K as ScriptVtxoPageOptions, L as StoredVtxo, M as VtxoRepositoryKey, E as ExtendedCoin, Q as TransactionHistoryPageFilter, U as TransactionHistoryPageCursor, h as ArkTransaction, X as AtomicWalletState, Y as WalletState, a5 as DescriptorProvider, a6 as DescriptorSigningRequest, a7 as Transaction, l as GetNewAddressesOptions, m as NewAddress, a as Identity, x as RelativeTimelock, a8 as Network, a9 as BatchStartedEvent, aa as TreeSigningStartedEvent, ab as TxTree, ac as TreeNoncesEvent, ad as BatchFinalizationEvent, ae as BatchFinalizedEvent, af as BatchFailedEvent, ag as TreeTxEvent, ah as TreeSignatureEvent, o as SettlementEvent, b as WalletConfig, C as ContractRepository, k as IContractManager, ai as IReadonlyWallet, aj as ReadonlyIdentity, ak as OnchainProvider, O as OperatorProvider, w as IndexerProvider, al as DelegateProvider, am as ReadonlyWalletConfig, _ as IntentRepository, a1 as VirtualTxRepository, an as ExitCaptureMode, ao as ExitDataSource, i as ActivityRegistry, ap as IReadonlyAssetManager, aq as ContractSyncState, ar as RecipientArkadeAddressContext, G as GetArkadeInfoOptions, A as ArkadeInfo, c as ArkadeReader, as as EsploraProvider, at as NetworkName, au as OperatorInfo, av as ArkAddress, e as WalletBalance, f as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, g as GetSpendableVtxosFilter, aw as ContractWithVtxos, ax as selectPendingRecoveryOutpoints, j as Activity, ay as Coin, az as ContractManager, aA as ContractManagerConfig, I as IWallet, aB as CSVMultisigTapscript, aC as SettlementConfig, d as ArkadeBroadcaster, q as IAssetManager, aD as VtxoManager, n as IDelegateManager, S as SettleParams, R as Recipient, aE as SignerSession, aF as SignedIntent, aG as Intent, aH as SignedProof, aI as Proof, p as SendParams, aJ as TimeHeight } from './index-DRwe0UDN.cjs';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-Cd28gxpM.js';
+import { TransactionOutput } from '@scure/btc-signer/psbt.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-f4_t864Z.cjs';
 
 /**
  * IndexedDB-based implementation of WalletRepository.
@@ -9,7 +9,10 @@ import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-Cd28gxpM.js';
 declare class IndexedDBWalletRepository implements WalletRepository {
     readonly version: 2;
     private readonly connection;
-    constructor(dbName?: string);
+    /** persistentWalletState asserts persistence beyond this process; it cannot detect browser eviction. */
+    constructor(dbName?: string, options?: {
+        persistentWalletState?: boolean;
+    });
     clear(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
     getVtxosPage(address: string, page: PageRequest<Outpoint>): Promise<PageResult<ExtendedVirtualCoin, Outpoint>>;
@@ -25,6 +28,7 @@ declare class IndexedDBWalletRepository implements WalletRepository {
     getTransactionHistoryPage(filter: TransactionHistoryPageFilter, page: PageRequest<TransactionHistoryPageCursor>): Promise<PageResult<ArkTransaction, TransactionHistoryPageCursor>>;
     saveTransactions(address: string, txs: ArkTransaction[]): Promise<void>;
     deleteTransactions(address: string): Promise<void>;
+    readonly atomicWalletState: AtomicWalletState;
     getWalletState(): Promise<WalletState | null>;
     saveWalletState(state: WalletState): Promise<void>;
     private getDB;
@@ -431,7 +435,7 @@ type ServerInfoSource = "live" | "cache";
  * const handler = wallet.createBatchHandler(intentId, inputs, expectedRecipients, musig2session);
  *
  * const abortController = new AbortController();
- * // Get event stream from the Arkade provider
+ * // Get event stream from the operator provider
  * const eventStream = arkProvider.getEventStream(
  *   abortController.signal,
  *   ['your-topic-1', 'your-topic-2']
@@ -831,7 +835,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     readonly network: Network;
     readonly onchainProvider: OnchainProvider;
     /** Narrowed so a readonly wallet can't grow a `submitTx` use; `Wallet` re-widens it. */
-    protected readonly arkProvider: Pick<ArkProvider, "getInfo">;
+    protected readonly arkProvider: Pick<OperatorProvider, "getInfo">;
     readonly indexerProvider: IndexerProvider;
     readonly dustAmount: bigint;
     readonly walletRepository: WalletRepository;
@@ -905,7 +909,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     getContractSyncState(): ContractSyncState;
     protected constructor(identity: ReadonlyIdentity, network: Network, onchainProvider: OnchainProvider, 
     /** Narrowed so a readonly wallet can't grow a `submitTx` use; `Wallet` re-widens it. */
-    arkProvider: Pick<ArkProvider, "getInfo">, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider | undefined, watcherConfig?: ReadonlyWalletConfig["watcherConfig"], walletContractTimelocks?: RelativeTimelock[]);
+    arkProvider: Pick<OperatorProvider, "getInfo">, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider | undefined, watcherConfig?: ReadonlyWalletConfig["watcherConfig"], walletContractTimelocks?: RelativeTimelock[]);
     /**
      * x-only hex → cutoff of the operator's deprecated signers, cached for OFFLINE read/watch.
      * Boarding watch/history fan out over {current} ∪ this set so deposits at addresses minted
@@ -974,7 +978,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
     protected notifyBoardingRotation(): void;
     /** Shared setup for ReadonlyWallet.create() and Wallet.create(). */
     protected static setupWalletConfig(config: ReadonlyWalletConfig, pubKey: Uint8Array): Promise<{
-        arkProvider: ArkProvider;
+        arkProvider: OperatorProvider;
         indexerProvider: IndexerProvider;
         onchainProvider: OnchainProvider | EsploraProvider;
         network: Network;
@@ -985,7 +989,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
         dustAmount: bigint;
         walletRepository: WalletRepository | IndexedDBWalletRepository;
         contractRepository: ContractRepository;
-        info: ArkadeInfo;
+        info: OperatorInfo;
         serverInfoSource: ServerInfoSource;
         serverInfoLastOnlineAt: number | undefined;
         delegateProvider: DelegateProvider | undefined;
@@ -1214,14 +1218,14 @@ declare class ReadonlyWallet implements IReadonlyWallet {
  * // Create a wallet with providers
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkProvider: new RestArkProvider(),
+ *   operatorProvider: new RestOperatorProvider(),
  *   onchainProvider: new EsploraProvider()
  * });
  *
  * // Use custom providers and/or URLs (e.g., for Expo/React Native)
  * const wallet = await Wallet.create({
  *   identity: MnemonicIdentity.fromMnemonic('abandon abandon...'),
- *   arkProvider: new ExpoArkProvider('https://arkade.computer'),
+ *   operatorProvider: new ExpoOperatorProvider('https://arkade.computer'),
  *   indexerProvider: new ExpoIndexerProvider('https://arkade.computer'),
  *   onchainProvider: new EsploraProvider('https://mempool.space/api')
  * });
@@ -1521,13 +1525,13 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
     /** @see WalletConfig.concurrentSpending */
     get concurrentSpending(): boolean;
     /** Public here; `ReadonlyWallet` keeps it protected so a readonly view can't submit. */
-    readonly arkProvider: ArkProvider;
+    readonly arkProvider: OperatorProvider;
     /**
      * Broadcast access bound to this wallet's server, so a plugin needs only the wallet. Not on
      * {@link ReadonlyWallet}: a readonly wallet or `toReadonly()` view must not be able to submit.
      */
     getArkadeBroadcaster(): Promise<ArkadeBroadcaster>;
-    protected constructor(identity: Identity, network: Network, onchainProvider: OnchainProvider, arkProvider: ArkProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, serverUnrollScript: CSVMultisigTapscript.Type, forfeitOutputScript: Bytes, forfeitPubkey: Bytes, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider, watcherConfig?: WalletConfig["watcherConfig"], settlementConfig?: WalletConfig["settlementConfig"], walletContractTimelocks?: RelativeTimelock[], receiveRotator?: WalletReceiveRotator, descriptorProvider?: DescriptorProvider, keyring?: KeyringDescriptorProvider, lookAheadWindow?: number, 
+    protected constructor(identity: Identity, network: Network, onchainProvider: OnchainProvider, arkProvider: OperatorProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, serverUnrollScript: CSVMultisigTapscript.Type, forfeitOutputScript: Bytes, forfeitPubkey: Bytes, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegateProvider?: DelegateProvider, watcherConfig?: WalletConfig["watcherConfig"], settlementConfig?: WalletConfig["settlementConfig"], walletContractTimelocks?: RelativeTimelock[], receiveRotator?: WalletReceiveRotator, descriptorProvider?: DescriptorProvider, keyring?: KeyringDescriptorProvider, lookAheadWindow?: number, 
     /** Overrides for the `batchExpiry` bounds; defaults derive from `network`. */
     batchExpiryPolicy?: Partial<BatchExpiryPolicy> | undefined, 
     /** @see WalletConfig.oneShotSubmit */
@@ -1544,7 +1548,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
      * ```typescript
      * const wallet = await Wallet.create({
      *   identity,
-     *   arkProvider: new RestArkProvider(),
+     *   operatorProvider: new RestOperatorProvider(),
      * });
      * ```
      */
@@ -1619,9 +1623,9 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
     signInputsByWitnessScript(tx: Transaction): Promise<Transaction>;
     signOnchainBoardingTx(tx: Transaction): Promise<Transaction>;
     safeRegisterIntent(intent: SignedIntent<Intent.RegisterMessage>, inputs: ExtendedCoin[]): Promise<string>;
-    makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[], validAt?: number): Promise<SignedIntent<Intent.RegisterMessage>>;
-    makeDeleteIntentSignature(coins: ExtendedCoin[]): Promise<SignedIntent<Intent.DeleteMessage>>;
-    makeGetPendingTxIntentSignature(coins: ExtendedVirtualCoin[]): Promise<SignedIntent<Intent.GetPendingTxMessage>>;
+    makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[], validAt?: number): Promise<SignedProof<Proof.RegisterMessage>>;
+    makeDeleteIntentSignature(coins: ExtendedCoin[]): Promise<SignedProof<Proof.DeleteMessage>>;
+    makeGetPendingTxIntentSignature(coins: ExtendedVirtualCoin[]): Promise<SignedProof<Proof.GetPendingTxMessage>>;
     /**
      * Finalizes pending transactions by retrieving them from the server and finalizing each one.
      * Skips the server check entirely when no send was interrupted (no pending tx flag set).
@@ -1784,7 +1788,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet, HDWalletCapable,
     sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[], now?: TimeHeight): Promise<string>;
     /**
      * Build an offchain transaction from the given inputs and outputs,
-     * sign it, submit to the Arkade provider, and finalize.
+     * sign it, submit to the operator provider, and finalize.
      *
      * Signs whatever it is handed, ungated — see {@link settle} for the trade.
      *

package/dist/worker/expo/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunk5WRA66RV_cjs = require('../../chunk-5WRA66RV.cjs');
-require('../../chunk-OUTWUYJ4.cjs');
-require('../../chunk-ZMSM3NOH.cjs');
-require('../../chunk-BYPBVHVA.cjs');
-require('../../chunk-KW7ZEWYS.cjs');
+var chunkB6VNKGIH_cjs = require('../../chunk-B6VNKGIH.cjs');
+require('../../chunk-F3FAE7VJ.cjs');
+require('../../chunk-WXNSISXK.cjs');
+require('../../chunk-E6OOJEHL.cjs');
+require('../../chunk-GHUUT54D.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 chunk5WRA66RV_cjs.CONTRACT_POLL_TASK_TYPE; }
+  get: function () { return chunkB6VNKGIH_cjs.CONTRACT_POLL_TASK_TYPE; }
 });
 Object.defineProperty(exports, "contractPollProcessor", {
   enumerable: true,
-  get: function () { return chunk5WRA66RV_cjs.contractPollProcessor; }
+  get: function () { return chunkB6VNKGIH_cjs.contractPollProcessor; }
 });
 Object.defineProperty(exports, "createTaskDependencies", {
   enumerable: true,
-  get: function () { return chunk5WRA66RV_cjs.createTaskDependencies; }
+  get: function () { return chunkB6VNKGIH_cjs.createTaskDependencies; }
 });
 Object.defineProperty(exports, "runTasks", {
   enumerable: true,
-  get: function () { return chunk5WRA66RV_cjs.runTasks; }
+  get: function () { return chunkB6VNKGIH_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-i56-drQV.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-i56-drQV.cjs';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-C9PkPcW_.cjs';
-import '../../index-BURzbRup.cjs';
+import { T as TaskProcessor } from '../../taskRunner-BPPU-YHG.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-BPPU-YHG.cjs';
+export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-DTBa8EH7.cjs';
+import '../../index-DRwe0UDN.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-BaNCSxqK.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-BaNCSxqK.js';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-B3U5gQ-i.js';
-import '../../index-BURzbRup.js';
+import { T as TaskProcessor } from '../../taskRunner-CDlNeth0.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-CDlNeth0.js';
+export { A as AsyncStorageLike, a as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-DHMIxY04.js';
+import '../../index-DRwe0UDN.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-Y4BL3YYX.js';
-import '../../chunk-HAQAWBYG.js';
-import '../../chunk-6FL4N4S2.js';
-import '../../chunk-P7B4LQ3H.js';
-import '../../chunk-OPX2HRWM.js';
+export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-MWVAWFX6.js';
+import '../../chunk-ZJHLLDBP.js';
+import '../../chunk-BTRCN4JJ.js';
+import '../../chunk-6CUP6ZIF.js';
+import '../../chunk-AG4TFD6F.js';
 
 // src/worker/expo/taskQueue.ts
 var InMemoryTaskQueue = class {

package/package.json

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

package/dist/chunk-5WRA66RV.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/worker/expo/taskRunner.ts","../src/worker/expo/processors/contractPollProcessor.ts"],"names":["getRandomId","extendVirtualCoinForContract","collectContracts","getNormalizedVtxos","warnAndFilterVtxosForScript","saveVtxosForContract"],"mappings":"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","file":"chunk-5WRA66RV.cjs","sourcesContent":["import type { TaskItem, TaskResult, TaskQueue } from \"./taskQueue\";\nimport type { WalletRepository } from \"../../repositories/walletRepository\";\nimport type { ContractRepository } from \"../../repositories/contractRepository\";\nimport type { IndexerProvider } from \"../../providers/indexer\";\nimport type { ArkProvider } from \"../../providers/ark\";\nimport type { ExtendedVirtualCoin, VirtualCoin } from \"../../wallet\";\nimport type { Contract } from \"../../contracts/types\";\nimport { getRandomId, extendVirtualCoinForContract } from \"../../wallet/utils\";\n\n/**\n * Shared dependencies injected into every processor at runtime.\n *\n * `extendVtxo` requires the owning contract — processors must resolve each\n * vtxo's `script` to a known contract (via the contract repository) before\n * calling this. The strict signature prevents the footgun where a missing\n * contract silently falls back to the wallet's default tapscript.\n */\nexport interface TaskDependencies {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n    extendVtxo: (vtxo: VirtualCoin, contract: Contract) => ExtendedVirtualCoin;\n}\n\n/**\n * A stateless unit that handles one type of task item.\n *\n * Processors must not keep in-memory state across invocations —\n * all coordination lives in the @see TaskQueue and repositories.\n *\n * The `TDeps` parameter defaults to @see TaskDependencies but\n * can be overridden for domain-specific processors (e.g. swap processing).\n */\nexport interface TaskProcessor<TDeps = TaskDependencies> {\n    readonly taskType: string;\n    execute(item: TaskItem, deps: TDeps): Promise<Omit<TaskResult, \"id\" | \"executedAt\">>;\n}\n\n/**\n * Run all pending tasks from the queue through matching processors.\n *\n * For each task in the inbox:\n * 1. Find the processor whose `taskType` matches `task.type`.\n * 2. Execute it, producing a @see TaskResult.\n * 3. Push the result to the outbox and remove the task from the inbox.\n *\n * Tasks with no matching processor produce a `\"noop\"` result.\n * Processor errors produce a `\"failed\"` result with the error message.\n */\nexport async function runTasks<TDeps = TaskDependencies>(\n    queue: TaskQueue,\n    processors: TaskProcessor<TDeps>[],\n    deps: TDeps,\n): Promise<TaskResult[]> {\n    const tasks = await queue.getTasks();\n    const processorMap = new Map(processors.map((p) => [p.taskType, p]));\n    const results: TaskResult[] = [];\n\n    for (const task of tasks) {\n        const processor = processorMap.get(task.type);\n\n        let partial: Omit<TaskResult, \"id\" | \"executedAt\">;\n\n        if (!processor) {\n            partial = {\n                taskItemId: task.id,\n                type: task.type,\n                status: \"noop\",\n            };\n        } else {\n            try {\n                partial = await processor.execute(task, deps);\n            } catch (error) {\n                partial = {\n                    taskItemId: task.id,\n                    type: task.type,\n                    status: \"failed\",\n                    data: {\n                        error: error instanceof Error ? error.message : String(error),\n                    },\n                };\n            }\n        }\n\n        const result: TaskResult = {\n            ...partial,\n            id: getRandomId(),\n            executedAt: Date.now(),\n        };\n\n        await queue.pushResult(result);\n        await queue.removeTask(task.id);\n        results.push(result);\n    }\n\n    return results;\n}\n\n/**\n * Options for @see createTaskDependencies.\n */\nexport interface CreateTaskDependenciesOptions {\n    walletRepository: WalletRepository;\n    contractRepository: ContractRepository;\n    indexerProvider: IndexerProvider;\n    arkProvider: ArkProvider;\n}\n\n/**\n * Build the @see TaskDependencies needed by task processors\n * (e.g. `src/worker/expo/processors/contractPollProcessor.ts`)\n *\n * This is the same construction that `defineExpoBackgroundTask` does\n * internally, extracted so that consumers with custom schedulers\n * (e.g. bare React Native with `react-native-background-fetch`)\n * can build deps without depending on Expo.\n */\nexport function createTaskDependencies(options: CreateTaskDependenciesOptions): TaskDependencies {\n    return {\n        ...options,\n        extendVtxo: (vtxo: VirtualCoin, contract: Contract) =>\n            extendVirtualCoinForContract(vtxo, contract),\n    };\n}\n","import { collectContracts } from \"../../../repositories/contractRepository\";\nimport type { TaskItem, TaskResult } from \"../taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../taskRunner\";\nimport type { ExtendedVirtualCoin } from \"../../../wallet\";\nimport { getNormalizedVtxos } from \"../../../wallet/vtxo\";\nimport {\n    warnAndFilterVtxosForScript,\n    saveVtxosForContract,\n} from \"../../../contracts/vtxoOwnership\";\n\nexport const CONTRACT_POLL_TASK_TYPE = \"contract-poll\";\n\n/**\n * Polls the indexer for the latest VTXO state of every contract and\n * persists the results to the wallet repository.\n *\n * Replicates the polling subset of @see ContractManager.initialize:\n * 1. Load every watched contract from the contract repository.\n * 2. Paginated fetch of every VTXO (including spent) from the indexer.\n * 3. Extend each VTXO with tapscript data.\n * 4. Save to the wallet repository.\n *\n * NOTE: the indexer query deliberately omits `spendableOnly`. Every\n * repository implements `saveVtxos` as an upsert with no batch delete,\n * so filtering to spendable-only would leave VTXOs that became spent\n * between polls marked as spendable forever. Fetching the full set lets\n * the upsert overwrite stale records with their latest state.\n */\nexport const contractPollProcessor: TaskProcessor = {\n    taskType: CONTRACT_POLL_TASK_TYPE,\n\n    async execute(\n        item: TaskItem,\n        deps: TaskDependencies,\n    ): Promise<Omit<TaskResult, \"id\" | \"executedAt\">> {\n        const { contractRepository, walletRepository, indexerProvider, extendVtxo } = deps;\n\n        // Background channel, so it covers exactly what the watcher's\n        // subscription covers: `retained` rows are kept for reads only.\n        const contracts = await collectContracts(contractRepository, {\n            watch: [\"watched\", \"awaiting-funds\"],\n        });\n        let contractsProcessed = 0;\n        let vtxosSaved = 0;\n\n        for (const contract of contracts) {\n            // Paginated fetch of spendable virtual outputs\n            const pageSize = 100;\n            let pageIndex = 0;\n            let hasMore = true;\n            const allVtxos: ExtendedVirtualCoin[] = [];\n\n            while (hasMore) {\n                const { vtxos, page } = await getNormalizedVtxos(indexerProvider, {\n                    scripts: [contract.script],\n                    pageIndex,\n                    pageSize,\n                });\n\n                for (const vtxo of vtxos) {\n                    allVtxos.push(extendVtxo(vtxo, contract));\n                }\n\n                hasMore = page ? vtxos.length === pageSize : false;\n                pageIndex++;\n            }\n\n            // Skip wrong-script rows (legacy duplicates or indexer drift)\n            // before persisting; the loop must keep going for the remaining\n            // contracts even when one row is rejected.\n            const filtered = warnAndFilterVtxosForScript(\n                allVtxos,\n                contract.script,\n                \"contractPollProcessor\",\n            );\n            await saveVtxosForContract(walletRepository, contract, filtered);\n            vtxosSaved += filtered.length;\n            contractsProcessed++;\n        }\n\n        return {\n            taskItemId: item.id,\n            type: CONTRACT_POLL_TASK_TYPE,\n            status: \"success\",\n            data: { contractsProcessed, vtxosSaved },\n        };\n    },\n};\n"]}