@arkade-os/sdk 0.4.48-rc.0 → 0.4.48

package/dist/{wallet-B6s7_5bJ.d.cts → wallet-B5bwixQa.d.ts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, N as BatchFinalizationEvent, P as BatchFinalizedEvent, Q as BatchFailedEvent, U as TreeTxEvent, X as TreeSignatureEvent, j as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Y as DescriptorProvider, g as IContractManager, Z as IReadonlyWallet, _ as ReadonlyIdentity, $ as Network, a0 as OnchainProvider, p as IndexerProvider, a1 as DelegateProvider, a2 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a3 as ExitCaptureMode, a4 as ExitDataSource, q as RelativeTimelock, e as ActivityRegistry, a5 as IReadonlyAssetManager, a6 as ContractSyncState, o as ArkProvider, a7 as NetworkName, a8 as ArkInfo, a9 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, A as ArkTransaction, f as Activity, d as ExtendedCoin, aa as Coin, ab as ContractManager, I as IWallet, a as Identity, ac as CSVMultisigTapscript, ad as SettlementConfig, k as IAssetManager, ae as VtxoManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, R as Recipient, af as SignerSession, ag as SignedIntent, ah as Intent } from './ark-CoJgwTi_.cjs';
+import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, P as BatchFinalizationEvent, Q as BatchFinalizedEvent, U as BatchFailedEvent, X as TreeTxEvent, Y as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Z as DescriptorProvider, f as IContractManager, _ as IReadonlyWallet, $ as ReadonlyIdentity, a0 as Network, a1 as OnchainProvider, o as IndexerProvider, a2 as DelegateProvider, a3 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a4 as ExitCaptureMode, a5 as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, a6 as IReadonlyAssetManager, a7 as ContractSyncState, n as ArkProvider, a8 as NetworkName, a9 as ArkInfo, aa as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, ab as Coin, t as ExtendedVirtualCoin, ac as ContractManager, I as IWallet, a as Identity, ad as CSVMultisigTapscript, ae as SettlementConfig, j as IAssetManager, af as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, ag as SignerSession, ah as SignedIntent, ai as Intent, aj as TimeHeight } from './ark-CjE0KkGp.js';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-Dl87_zMA.cjs';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-DhGZk1r2.js';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -487,7 +487,7 @@ interface BoardingUtxoGroup {
     coins: ExtendedCoin[];
 }
 /**
- * Why a VTXO at an arkcash address could not be swept by {@link Wallet.claimCash}.
+ * Why a VTXO at an arkadeCash address could not be swept by {@link Wallet.claimCash}.
  *
  * - `swept` — the server swept the batch at expiry. Recoverable in principle,
  *   but only through a settlement, which the thin sweep cannot do.
@@ -497,14 +497,14 @@ interface BoardingUtxoGroup {
  * - `has-assets` — asset-bearing; the BTC-only sweep would burn the assets.
  * - `sweep-failed` — spendable, but its own sweep was rejected.
  */
-type ArkCashUnclaimedReason = "swept" | "subdust" | "already-spent" | "has-assets" | "sweep-failed";
+type ArkadeCashUnclaimedReason = "swept" | "subdust" | "already-spent" | "has-assets" | "sweep-failed";
 /** A VTXO {@link Wallet.claimCash} left behind, with the reason why. */
-interface ArkCashUnclaimedVtxo {
+interface ArkadeCashUnclaimedVtxo {
     txid: string;
     vout: number;
     /** Value in satoshis. */
     value: number;
-    reason: ArkCashUnclaimedReason;
+    reason: ArkadeCashUnclaimedReason;
 }
 /**
  * Outcome of {@link Wallet.claimCash}: what was swept, and what was not.
@@ -512,13 +512,13 @@ interface ArkCashUnclaimedVtxo {
  * The shape is open — further buckets may be added alongside `unclaimed` as
  * more of the non-sweepable states become claimable.
  */
-interface ArkCashClaimResult {
+interface ArkadeCashClaimResult {
     /** Satoshis swept to this wallet. */
     swept: number;
     unclaimed: {
         /** Satoshis left behind. */
         amount: number;
-        vtxos: ArkCashUnclaimedVtxo[];
+        vtxos: ArkadeCashUnclaimedVtxo[];
     };
 }
 /**
@@ -531,13 +531,13 @@ interface ArkCashClaimResult {
  * cannot rule out a post-submit failure must persist `cash` — passing it to
  * {@link Wallet.claimCash} recovers the funds whether or not the send landed.
  */
-declare class ArkCashCreateError extends Error {
-    /** The encoded arkcash token controlling the funded output. */
+declare class ArkadeCashCreateError extends Error {
+    /** The encoded arkadeCash token controlling the funded output. */
     readonly cash: string;
     /** The original failure from `send`. */
     readonly cause: unknown;
     constructor(
-    /** The encoded arkcash token controlling the funded output. */
+    /** The encoded arkadeCash token controlling the funded output. */
     cash: string, 
     /** The original failure from `send`. */
     cause: unknown);
@@ -793,7 +793,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      *
      * @param filter - Optional flags controlling whether recoverable or unrolled VTXOs are included
      */
-    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
+    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
      * Outpoints of VTXOs whose deprecated signer is past its cutoff (EXPIRED) and
      * which have not yet been swept — unspendable until they recover. Offline:
@@ -1256,9 +1256,9 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * renewal / offboard) is not a board and leaves the boarding address
      * untouched.
      *
-     * Boarding inputs are the non-VTXO coins (no `virtualStatus`), the same
+     * Boarding inputs are the non-VTXO coins (no `script`), the same
      * discriminator {@link handleSettlementFinalizationEvent} uses; the
-     * `typeof` guard skips arknote string inputs before the `in` test.
+     * `typeof` guard skips the arknote strings settle also accepts.
      *
      * No-ops for static / `auto` wallets (no descriptor provider — boarding
      * stays on its fixed index-0 address). Best-effort and non-fatal: the
@@ -1321,14 +1321,14 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
     private hasPendingTxFlag;
     private setPendingTxFlag;
     /**
-     * Create an ArkCash bearer instrument.
+     * Create an ArkadeCash bearer instrument.
      *
      * Generates a fresh keypair, sends the specified amount to a DefaultVtxo
-     * controlled by the new key, and returns the encoded arkcash string.
+     * controlled by the new key, and returns the encoded arkadeCash string.
      * The receiver can claim the funds using `claimCash()` without ever
      * sharing their address.
      *
-     * ArkCash is a short-lived instrument: it carries a private key, so it is
+     * ArkadeCash is a short-lived instrument: it carries a private key, so it is
      * meant to be handed over and claimed promptly, not held. A note left
      * unclaimed past its batch expiry is swept by the server and `claimCash`
      * can only report it, not move it.
@@ -1336,31 +1336,31 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * @param amount - Amount in satoshis to send. Must be a whole number of
      * sats at or above the dust threshold — a below-dust amount would mint an
      * OP_RETURN output that is unspendable as cash.
-     * @returns The encoded arkcash string (e.g., "arkcash1...")
+     * @returns The encoded arkadeCash string (e.g., "arkadecash1...")
      */
     createCash(amount: number): Promise<string>;
     /**
-     * Claim an ArkCash bearer instrument: sweep what can be swept, report the
+     * Claim an ArkadeCash bearer instrument: sweep what can be swept, report the
      * rest.
      *
-     * Every spendable VTXO at the arkcash address is swept to this wallet in
-     * its own offchain transaction, signed with the key carried by the arkcash
+     * Every spendable VTXO at the arkadeCash address is swept to this wallet in
+     * its own offchain transaction, signed with the key carried by the arkadeCash
      * string. Nothing is ever persisted: no contract is imported, and the
-     * arkcash key is not stored. Anything that cannot be swept — server-swept,
+     * arkadeCash key is not stored. Anything that cannot be swept — server-swept,
      * subdust, already claimed, or asset-bearing — is returned in `unclaimed`
      * with a per-VTXO reason and otherwise ignored.
      *
-     * The arkcash string is the recovery token: a claim interrupted between
+     * The arkadeCash string is the recovery token: a claim interrupted between
      * submit and finalize is completed by simply re-running `claimCash`, which
-     * drains any pending arkcash transaction on the server before sweeping.
+     * drains any pending arkadeCash transaction on the server before sweeping.
      *
-     * @param cashStr - The encoded arkcash string (e.g., "arkcash1...")
+     * @param cashStr - The encoded arkadeCash string (e.g., "arkadecash1...")
      * @returns The swept total and the report of what was left behind. The
      * shape is open: further buckets may be added alongside `unclaimed`.
      */
-    claimCash(cashStr: string): Promise<ArkCashClaimResult>;
+    claimCash(cashStr: string): Promise<ArkadeCashClaimResult>;
     /**
-     * Split the VTXOs at an arkcash address into the ones the thin sweep can
+     * Split the VTXOs at an arkadeCash address into the ones the thin sweep can
      * move and the ones it can only report.
      */
     private classifyCashVtxos;
@@ -1368,7 +1368,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
     private fetchAllVtxos;
     /**
      * Complete any sweep a previous `claimCash` registered but never finalized.
-     * A thin variant of {@link finalizePendingTxs}, scoped to the arkcash key:
+     * A thin variant of {@link finalizePendingTxs}, scoped to the arkadeCash key:
      * the intent is signed with it, and so are the returned checkpoints.
      *
      * A drained sweep is not automatically *ours*. Whoever registered it chose
@@ -1377,7 +1377,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * completing it unsticks the funds), but only the value it actually pays to
      * `myPkScript` may be counted as claimed here.
      *
-     * @param vtxos - VTXOs at the arkcash contract's own pkScript, spent ones
+     * @param vtxos - VTXOs at the arkadeCash contract's own pkScript, spent ones
      * included (a registered sweep marks its input spent). Any other outpoint —
      * subdust above all — would make the proof invalid, since it describes every
      * input by that pkScript.
@@ -1429,7 +1429,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * there is no separate change output. It records no `TxSent` history — the
      * funds never leave the wallet.
      */
-    sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[]): Promise<string>;
+    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.
@@ -1459,4 +1459,4 @@ declare function selectVirtualCoins(coins: ExtendedVirtualCoin[], targetAmount:
  */
 declare function waitForIncomingFunds(wallet: Wallet): Promise<IncomingFunds>;
 
-export { type ArkCashClaimResult as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, ArkCashCreateError as d, type ArkCashUnclaimedReason as e, type ArkCashUnclaimedVtxo as f, ArkError as g, ArkErrorName as h, type BoardingUtxoGroup as i, type ProviderKind as j, ProviderUnavailableError as k, isArkError as l, maybeArkError as m, selectVirtualCoins as s, waitForIncomingFunds as w };
+export { ArkError as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, ArkErrorName as d, type ArkadeCashClaimResult as e, ArkadeCashCreateError as f, type ArkadeCashUnclaimedReason as g, type ArkadeCashUnclaimedVtxo as h, type BoardingUtxoGroup as i, type ProviderKind as j, ProviderUnavailableError as k, isArkError as l, maybeArkError as m, selectVirtualCoins as s, waitForIncomingFunds as w };

package/dist/{wallet-C61huH8i.d.ts → wallet-DiOrtYic.d.cts}

@@ -1,8 +1,8 @@
 import { Transaction } from '@scure/btc-signer';
 import { Bytes } from '@scure/btc-signer/utils.js';
-import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, N as BatchFinalizationEvent, P as BatchFinalizedEvent, Q as BatchFailedEvent, U as TreeTxEvent, X as TreeSignatureEvent, j as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Y as DescriptorProvider, g as IContractManager, Z as IReadonlyWallet, _ as ReadonlyIdentity, $ as Network, a0 as OnchainProvider, p as IndexerProvider, a1 as DelegateProvider, a2 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a3 as ExitCaptureMode, a4 as ExitDataSource, q as RelativeTimelock, e as ActivityRegistry, a5 as IReadonlyAssetManager, a6 as ContractSyncState, o as ArkProvider, a7 as NetworkName, a8 as ArkInfo, a9 as ArkAddress, c as WalletBalance, G as GetVtxosFilter, E as ExtendedVirtualCoin, A as ArkTransaction, f as Activity, d as ExtendedCoin, aa as Coin, ab as ContractManager, I as IWallet, a as Identity, ac as CSVMultisigTapscript, ad as SettlementConfig, k as IAssetManager, ae as VtxoManager, h as IDelegateManager, S as SendBitcoinParams, i as SettleParams, R as Recipient, af as SignerSession, ag as SignedIntent, ah as Intent } from './ark-CoJgwTi_.js';
+import { J as BatchStartedEvent, K as TreeSigningStartedEvent, L as TxTree, M as TreeNoncesEvent, P as BatchFinalizationEvent, Q as BatchFinalizedEvent, U as BatchFailedEvent, X as TreeTxEvent, Y as TreeSignatureEvent, i as SettlementEvent, b as WalletConfig, W as WalletRepository, C as ContractRepository, Z as DescriptorProvider, f as IContractManager, _ as IReadonlyWallet, $ as ReadonlyIdentity, a0 as Network, a1 as OnchainProvider, o as IndexerProvider, a2 as DelegateProvider, a3 as ReadonlyWalletConfig, x as IntentRepository, B as VirtualTxRepository, a4 as ExitCaptureMode, a5 as ExitDataSource, p as RelativeTimelock, d as ActivityRegistry, a6 as IReadonlyAssetManager, a7 as ContractSyncState, n as ArkProvider, a8 as NetworkName, a9 as ArkInfo, aa as ArkAddress, c as WalletBalance, G as GetVtxosFilter, N as NormalizedExtendedVirtualCoin, A as ArkTransaction, e as Activity, E as ExtendedCoin, ab as Coin, t as ExtendedVirtualCoin, ac as ContractManager, I as IWallet, a as Identity, ad as CSVMultisigTapscript, ae as SettlementConfig, j as IAssetManager, af as VtxoManager, g as IDelegateManager, S as SendBitcoinParams, h as SettleParams, R as Recipient, ag as SignerSession, ah as SignedIntent, ai as Intent, aj as TimeHeight } from './ark-CjE0KkGp.cjs';
 import { TransactionOutput } from '@scure/btc-signer/psbt.js';
-import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-CuaDqqQi.js';
+import { D as DefaultVtxo, a as DelegateVtxo } from './delegate-D3dY-2vS.cjs';
 
 declare class ArkError extends Error {
     readonly code: number;
@@ -487,7 +487,7 @@ interface BoardingUtxoGroup {
     coins: ExtendedCoin[];
 }
 /**
- * Why a VTXO at an arkcash address could not be swept by {@link Wallet.claimCash}.
+ * Why a VTXO at an arkadeCash address could not be swept by {@link Wallet.claimCash}.
  *
  * - `swept` — the server swept the batch at expiry. Recoverable in principle,
  *   but only through a settlement, which the thin sweep cannot do.
@@ -497,14 +497,14 @@ interface BoardingUtxoGroup {
  * - `has-assets` — asset-bearing; the BTC-only sweep would burn the assets.
  * - `sweep-failed` — spendable, but its own sweep was rejected.
  */
-type ArkCashUnclaimedReason = "swept" | "subdust" | "already-spent" | "has-assets" | "sweep-failed";
+type ArkadeCashUnclaimedReason = "swept" | "subdust" | "already-spent" | "has-assets" | "sweep-failed";
 /** A VTXO {@link Wallet.claimCash} left behind, with the reason why. */
-interface ArkCashUnclaimedVtxo {
+interface ArkadeCashUnclaimedVtxo {
     txid: string;
     vout: number;
     /** Value in satoshis. */
     value: number;
-    reason: ArkCashUnclaimedReason;
+    reason: ArkadeCashUnclaimedReason;
 }
 /**
  * Outcome of {@link Wallet.claimCash}: what was swept, and what was not.
@@ -512,13 +512,13 @@ interface ArkCashUnclaimedVtxo {
  * The shape is open — further buckets may be added alongside `unclaimed` as
  * more of the non-sweepable states become claimable.
  */
-interface ArkCashClaimResult {
+interface ArkadeCashClaimResult {
     /** Satoshis swept to this wallet. */
     swept: number;
     unclaimed: {
         /** Satoshis left behind. */
         amount: number;
-        vtxos: ArkCashUnclaimedVtxo[];
+        vtxos: ArkadeCashUnclaimedVtxo[];
     };
 }
 /**
@@ -531,13 +531,13 @@ interface ArkCashClaimResult {
  * cannot rule out a post-submit failure must persist `cash` — passing it to
  * {@link Wallet.claimCash} recovers the funds whether or not the send landed.
  */
-declare class ArkCashCreateError extends Error {
-    /** The encoded arkcash token controlling the funded output. */
+declare class ArkadeCashCreateError extends Error {
+    /** The encoded arkadeCash token controlling the funded output. */
     readonly cash: string;
     /** The original failure from `send`. */
     readonly cause: unknown;
     constructor(
-    /** The encoded arkcash token controlling the funded output. */
+    /** The encoded arkadeCash token controlling the funded output. */
     cash: string, 
     /** The original failure from `send`. */
     cause: unknown);
@@ -793,7 +793,7 @@ declare class ReadonlyWallet implements IReadonlyWallet {
      *
      * @param filter - Optional flags controlling whether recoverable or unrolled VTXOs are included
      */
-    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
+    getVtxos(filter?: GetVtxosFilter): Promise<NormalizedExtendedVirtualCoin[]>;
     /**
      * Outpoints of VTXOs whose deprecated signer is past its cutoff (EXPIRED) and
      * which have not yet been swept — unspendable until they recover. Offline:
@@ -1256,9 +1256,9 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * renewal / offboard) is not a board and leaves the boarding address
      * untouched.
      *
-     * Boarding inputs are the non-VTXO coins (no `virtualStatus`), the same
+     * Boarding inputs are the non-VTXO coins (no `script`), the same
      * discriminator {@link handleSettlementFinalizationEvent} uses; the
-     * `typeof` guard skips arknote string inputs before the `in` test.
+     * `typeof` guard skips the arknote strings settle also accepts.
      *
      * No-ops for static / `auto` wallets (no descriptor provider — boarding
      * stays on its fixed index-0 address). Best-effort and non-fatal: the
@@ -1321,14 +1321,14 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
     private hasPendingTxFlag;
     private setPendingTxFlag;
     /**
-     * Create an ArkCash bearer instrument.
+     * Create an ArkadeCash bearer instrument.
      *
      * Generates a fresh keypair, sends the specified amount to a DefaultVtxo
-     * controlled by the new key, and returns the encoded arkcash string.
+     * controlled by the new key, and returns the encoded arkadeCash string.
      * The receiver can claim the funds using `claimCash()` without ever
      * sharing their address.
      *
-     * ArkCash is a short-lived instrument: it carries a private key, so it is
+     * ArkadeCash is a short-lived instrument: it carries a private key, so it is
      * meant to be handed over and claimed promptly, not held. A note left
      * unclaimed past its batch expiry is swept by the server and `claimCash`
      * can only report it, not move it.
@@ -1336,31 +1336,31 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * @param amount - Amount in satoshis to send. Must be a whole number of
      * sats at or above the dust threshold — a below-dust amount would mint an
      * OP_RETURN output that is unspendable as cash.
-     * @returns The encoded arkcash string (e.g., "arkcash1...")
+     * @returns The encoded arkadeCash string (e.g., "arkadecash1...")
      */
     createCash(amount: number): Promise<string>;
     /**
-     * Claim an ArkCash bearer instrument: sweep what can be swept, report the
+     * Claim an ArkadeCash bearer instrument: sweep what can be swept, report the
      * rest.
      *
-     * Every spendable VTXO at the arkcash address is swept to this wallet in
-     * its own offchain transaction, signed with the key carried by the arkcash
+     * Every spendable VTXO at the arkadeCash address is swept to this wallet in
+     * its own offchain transaction, signed with the key carried by the arkadeCash
      * string. Nothing is ever persisted: no contract is imported, and the
-     * arkcash key is not stored. Anything that cannot be swept — server-swept,
+     * arkadeCash key is not stored. Anything that cannot be swept — server-swept,
      * subdust, already claimed, or asset-bearing — is returned in `unclaimed`
      * with a per-VTXO reason and otherwise ignored.
      *
-     * The arkcash string is the recovery token: a claim interrupted between
+     * The arkadeCash string is the recovery token: a claim interrupted between
      * submit and finalize is completed by simply re-running `claimCash`, which
-     * drains any pending arkcash transaction on the server before sweeping.
+     * drains any pending arkadeCash transaction on the server before sweeping.
      *
-     * @param cashStr - The encoded arkcash string (e.g., "arkcash1...")
+     * @param cashStr - The encoded arkadeCash string (e.g., "arkadecash1...")
      * @returns The swept total and the report of what was left behind. The
      * shape is open: further buckets may be added alongside `unclaimed`.
      */
-    claimCash(cashStr: string): Promise<ArkCashClaimResult>;
+    claimCash(cashStr: string): Promise<ArkadeCashClaimResult>;
     /**
-     * Split the VTXOs at an arkcash address into the ones the thin sweep can
+     * Split the VTXOs at an arkadeCash address into the ones the thin sweep can
      * move and the ones it can only report.
      */
     private classifyCashVtxos;
@@ -1368,7 +1368,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
     private fetchAllVtxos;
     /**
      * Complete any sweep a previous `claimCash` registered but never finalized.
-     * A thin variant of {@link finalizePendingTxs}, scoped to the arkcash key:
+     * A thin variant of {@link finalizePendingTxs}, scoped to the arkadeCash key:
      * the intent is signed with it, and so are the returned checkpoints.
      *
      * A drained sweep is not automatically *ours*. Whoever registered it chose
@@ -1377,7 +1377,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * completing it unsticks the funds), but only the value it actually pays to
      * `myPkScript` may be counted as claimed here.
      *
-     * @param vtxos - VTXOs at the arkcash contract's own pkScript, spent ones
+     * @param vtxos - VTXOs at the arkadeCash contract's own pkScript, spent ones
      * included (a registered sweep marks its input spent). Any other outpoint —
      * subdust above all — would make the proof invalid, since it describes every
      * input by that pkScript.
@@ -1429,7 +1429,7 @@ declare class Wallet extends ReadonlyWallet implements IWallet {
      * there is no separate change output. It records no `TxSent` history — the
      * funds never leave the wallet.
      */
-    sendSelectedVtxosToSelf(inputs: ExtendedVirtualCoin[]): Promise<string>;
+    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.
@@ -1459,4 +1459,4 @@ declare function selectVirtualCoins(coins: ExtendedVirtualCoin[], targetAmount:
  */
 declare function waitForIncomingFunds(wallet: Wallet): Promise<IncomingFunds>;
 
-export { type ArkCashClaimResult as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, ArkCashCreateError as d, type ArkCashUnclaimedReason as e, type ArkCashUnclaimedVtxo as f, ArkError as g, ArkErrorName as h, type BoardingUtxoGroup as i, type ProviderKind as j, ProviderUnavailableError as k, isArkError as l, maybeArkError as m, selectVirtualCoins as s, waitForIncomingFunds as w };
+export { ArkError as A, Batch as B, type IncomingFunds as I, type ProviderConnectionState as P, ReadonlyWallet as R, type ServerInfoSource as S, Wallet as W, type ReceiveRotatorFactory as a, type ReceiveRotatorBootOpts as b, type ReceiveRotatorBoot as c, ArkErrorName as d, type ArkadeCashClaimResult as e, ArkadeCashCreateError as f, type ArkadeCashUnclaimedReason as g, type ArkadeCashUnclaimedVtxo as h, type BoardingUtxoGroup as i, type ProviderKind as j, ProviderUnavailableError as k, isArkError as l, maybeArkError as m, selectVirtualCoins as s, waitForIncomingFunds as w };

package/dist/worker/expo/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkEA3IWZ4W_cjs = require('../../chunk-EA3IWZ4W.cjs');
-require('../../chunk-RJMFTTRJ.cjs');
-require('../../chunk-CFQO5MCM.cjs');
-require('../../chunk-RQSA7ADZ.cjs');
-require('../../chunk-L5ND2FJJ.cjs');
+var chunkSYDANBJI_cjs = require('../../chunk-SYDANBJI.cjs');
+require('../../chunk-ENZ4YPR2.cjs');
+require('../../chunk-EB3ALGTM.cjs');
+require('../../chunk-5XMVTK5S.cjs');
+require('../../chunk-7TXSPRN5.cjs');
 require('../../chunk-5BLDMQED.cjs');
 
 // src/worker/expo/taskQueue.ts
@@ -121,19 +121,19 @@ var AsyncStorageTaskQueue = class {
 
 Object.defineProperty(exports, "CONTRACT_POLL_TASK_TYPE", {
   enumerable: true,
-  get: function () { return chunkEA3IWZ4W_cjs.CONTRACT_POLL_TASK_TYPE; }
+  get: function () { return chunkSYDANBJI_cjs.CONTRACT_POLL_TASK_TYPE; }
 });
 Object.defineProperty(exports, "contractPollProcessor", {
   enumerable: true,
-  get: function () { return chunkEA3IWZ4W_cjs.contractPollProcessor; }
+  get: function () { return chunkSYDANBJI_cjs.contractPollProcessor; }
 });
 Object.defineProperty(exports, "createTaskDependencies", {
   enumerable: true,
-  get: function () { return chunkEA3IWZ4W_cjs.createTaskDependencies; }
+  get: function () { return chunkSYDANBJI_cjs.createTaskDependencies; }
 });
 Object.defineProperty(exports, "runTasks", {
   enumerable: true,
-  get: function () { return chunkEA3IWZ4W_cjs.runTasks; }
+  get: function () { return chunkSYDANBJI_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-RYihSj9E.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-RYihSj9E.cjs';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CwknfM_j.cjs';
-import '../../ark-CoJgwTi_.cjs';
+import { T as TaskProcessor } from '../../taskRunner-Brnak0Rc.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-Brnak0Rc.cjs';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-CeLZhZFU.cjs';
+import '../../ark-CjE0KkGp.cjs';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

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

@@ -1,7 +1,7 @@
-import { T as TaskProcessor } from '../../taskRunner-Df8YQpn1.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-Df8YQpn1.js';
-export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-D2Zl7yAB.js';
-import '../../ark-CoJgwTi_.js';
+import { T as TaskProcessor } from '../../taskRunner-B-2MHCYG.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-B-2MHCYG.js';
+export { a as AsyncStorageLike, A as AsyncStorageTaskQueue } from '../../asyncStorageTaskQueue-D9SOPMPC.js';
+import '../../ark-CjE0KkGp.js';
 import '@scure/btc-signer/transaction.js';
 import '@scure/btc-signer/utils.js';
 import '@scure/btc-signer/psbt.js';

package/dist/worker/expo/index.js

@@ -1,8 +1,8 @@
-export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-4AIHKC65.js';
-import '../../chunk-SV4PCGKM.js';
-import '../../chunk-GM6JRQP5.js';
-import '../../chunk-XN3554FT.js';
-import '../../chunk-C7TXXTMS.js';
+export { CONTRACT_POLL_TASK_TYPE, contractPollProcessor, createTaskDependencies, runTasks } from '../../chunk-G6J6AEMH.js';
+import '../../chunk-NYR5H6GR.js';
+import '../../chunk-BHHLRZCS.js';
+import '../../chunk-4VVTRPH3.js';
+import '../../chunk-ZDDBTFVO.js';
 import '../../chunk-NSBPE2FW.js';
 
 // src/worker/expo/taskQueue.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.48-rc.0",
+  "version": "0.4.48",
   "description": "TypeScript SDK for building Bitcoin wallets using the Arkade protocol",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -199,6 +199,7 @@
     "build": "tsup",
     "smoke:dist": "node scripts/smoke-dist.mjs",
     "typecheck": "tsc --noEmit",
+    "check:vtxo": "node scripts/check-virtual-status.mjs && node scripts/check-provider-boundary.mjs",
     "docs:build": "pnpm run typecheck && pnpm typedoc",
     "docs:open": "open ../../docs/index.html",
     "test": "vitest run",
@@ -215,7 +216,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "format": "prettier --write src test examples",
-    "lint": "prettier --check src test examples",
+    "lint": "prettier --check src test examples && pnpm run check:vtxo",
     "audit": "pnpm audit"
   }
 }

package/dist/chunk-3HUZAIKI.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/expoUtils.ts","../src/providers/expoArk.ts","../src/providers/expoIndexer.ts"],"names":["buildVersion","sdkVersion","fetch","RestArkProvider","DEFAULT_ARKADE_SERVER_URL","isFetchTimeoutError","RestIndexerProvider"],"mappings":";;;;;;AAMA,eAAsB,aAAa,OAAA,EAA4D;AAG3F,EAAA,IAAI;AACA,IAAA,MAAM,eAAA,GAAkB,MAAM,OAAO,YAAY,CAAA;AACjD,IAAA,OAAA,CAAQ,MAAM,gCAAgC,CAAA;AAC9C,IAAA,MAAM,mBAAA,GAAsB,CAAC,KAAA,EAAoB,IAAA,KAAuB;AACpE,MAAA,MAAM,OAAA,GAAU,IAAI,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AACzC,MAAA,OAAA,CAAQ,GAAA,CAAI,mBAAmBA,8BAAY,CAAA;AAC3C,MAAA,OAAA,CAAQ,GAAA,CAAI,iBAAiBC,4BAAU,CAAA;AACvC,MAAA,OAAO,gBAAgB,KAAA,CAAM,KAAA,EAAO,EAAE,GAAG,IAAA,EAAM,SAAS,CAAA;AAAA,IAC5D,CAAA;AACA,IAAA,OAAO,mBAAA;AAAA,EACX,SAAS,KAAA,EAAO;AAQZ,IAAA,OAAA,CAAQ,IAAA;AAAA,MACJ,wGAAA;AAAA,MAEA;AAAA,KACJ;AACA,IAAA,OAAOC,uBAAA;AAAA,EACX;AACJ;AAYA,gBAAuB,iBAAA,CACnB,GAAA,EACA,WAAA,EACA,OAAA,EACA,SACA,SAAA,EACgC;AAChC,EAAA,MAAM,eAAA,GAAkB,IAAI,eAAA,EAAgB;AAC5C,EAAA,MAAM,OAAA,GAAU,MAAM,eAAA,CAAgB,KAAA,EAAM;AAC5C,EAAA,WAAA,EAAa,iBAAiB,OAAA,EAAS,OAAA,EAAS,EAAE,IAAA,EAAM,MAAM,CAAA;AAE9D,EAAA,IAAI;AACA,IAAA,MAAM,QAAA,GAAW,MAAM,OAAA,CAAQ,GAAA,EAAK;AAAA,MAChC,OAAA,EAAS;AAAA,QACL,MAAA,EAAQ,mBAAA;AAAA,QACR,GAAG;AAAA,OACP;AAAA,MACA,QAAQ,eAAA,CAAgB;AAAA,KAC3B,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kBAAA,EAAqB,QAAA,CAAS,MAAM,CAAA,yBAAA,CAA2B,CAAA;AAAA,IACnF;AAEA,IAAA,IAAI,CAAC,SAAS,IAAA,EAAM;AAChB,MAAA,MAAM,IAAI,MAAM,uBAAuB,CAAA;AAAA,IAC3C;AAEA,IAAA,MAAM,MAAA,GAAS,QAAA,CAAS,IAAA,CAAK,SAAA,EAAU;AACvC,IAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,IAAA,IAAI,MAAA,GAAS,EAAA;AAEb,IAAA,OAAO,CAAC,aAAa,OAAA,EAAS;AAC1B,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACN,QAAA;AAAA,MACJ;AAEA,MAAA,MAAA,IAAU,QAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA;AAChD,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA;AAE/B,MAAA,KAAA,IAAS,IAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,MAAA,GAAS,GAAG,CAAA,EAAA,EAAK;AACvC,QAAA,MAAM,IAAA,GAAO,KAAA,CAAM,CAAC,CAAA,CAAE,IAAA,EAAK;AAC3B,QAAA,IAAI,CAAC,IAAA,EAAM;AAEX,QAAA,IAAI,IAAA,CAAK,UAAA,CAAW,OAAO,CAAA,EAAG;AAC1B,UAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,CAAC,EAAE,IAAA,EAAK;AACvC,UAAA,IAAI,CAAC,OAAA,EAAS;AAEd,UAAA,IAAI;AACA,YAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,OAAO,CAAA;AAC/B,YAAA,MAAM,MAAA,GAAS,UAAU,IAAI,CAAA;AAC7B,YAAA,IAAI,WAAW,IAAA,EAAM;AACjB,cAAA,MAAM,MAAA;AAAA,YACV;AAAA,UACJ,SAAS,UAAA,EAAY;AACjB,YAAA,OAAA,CAAQ,KAAA,CAAM,6BAA6B,UAAU,CAAA;AACrD,YAAA,MAAM,UAAA;AAAA,UACV;AAAA,QACJ;AAAA,MACJ;AAEA,MAAA,MAAA,GAAS,KAAA,CAAM,KAAA,CAAM,MAAA,GAAS,CAAC,CAAA;AAAA,IACnC;AAAA,EACJ,CAAA,SAAE;AACE,IAAA,WAAA,EAAa,mBAAA,CAAoB,SAAS,OAAO,CAAA;AAAA,EACrD;AACJ;;;AChGO,IAAM,eAAA,GAAN,cAA8BC,iCAAA,CAAgB;AAAA,EACjD,WAAA,CAAY,YAAoBC,2CAAA,EAA2B;AACvD,IAAA,KAAA,CAAM,SAAS,CAAA;AAAA,EACnB;AAAA,EAEA,OAAgB,cAAA,CACZ,MAAA,EACA,MAAA,EACsC;AACtC,IAAA,MAAM,SAAA,GAAY,MAAM,YAAA,EAAa;AACrC,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA,gBAAA,CAAA;AAC7B,IAAA,MAAM,cACF,MAAA,CAAO,MAAA,GAAS,IACV,CAAA,CAAA,EAAI,MAAA,CAAO,IAAI,CAAC,KAAA,KAAU,CAAA,OAAA,EAAU,kBAAA,CAAmB,KAAK,CAAC,CAAA,CAAE,EAAE,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA,GAC1E,EAAA;AAEV,IAAA,OAAO,CAAC,QAAQ,OAAA,EAAS;AACrB,MAAA,IAAI;AACA,QAAA,OAAO,iBAAA,CAAkB,MAAM,WAAA,EAAa,MAAA,EAAQ,WAAW,EAAC,EAAG,CAAC,IAAA,KAAS;AAGzE,UAAA,MAAM,SAAA,GAAY,KAAK,MAAA,IAAU,IAAA;AAGjC,UAAA,IAAI,SAAA,CAAU,cAAc,KAAA,CAAA,EAAW;AACnC,YAAA,OAAO,IAAA;AAAA,UACX;AAEA,UAAA,OAAO,IAAA,CAAK,qBAAqB,SAAS,CAAA;AAAA,QAC9C,CAAC,CAAA;AAAA,MACL,SAAS,KAAA,EAAO;AACZ,QAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,EAAc;AACvD,UAAA;AAAA,QACJ;AAIA,QAAA,IAAIC,qCAAA,CAAoB,KAAK,CAAA,EAAG;AAC5B,UAAA,OAAA,CAAQ,MAAM,uBAAuB,CAAA;AACrC,UAAA;AAAA,QACJ;AAEA,QAAA,OAAA,CAAQ,KAAA,CAAM,uBAAuB,KAAK,CAAA;AAC1C,QAAA,MAAM,KAAA;AAAA,MACV;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,OAAgB,sBAAsB,MAAA,EAGnC;AACC,IAAA,MAAM,SAAA,GAAY,MAAM,YAAA,EAAa;AACrC,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA,OAAA,CAAA;AAE7B,IAAA,OAAO,CAAC,QAAQ,OAAA,EAAS;AACrB,MAAA,IAAI;AACA,QAAA,OAAO,kBAAkB,GAAA,EAAK,MAAA,EAAQ,WAAW,EAAC,EAAG,CAAC,IAAA,KAAS;AAC3D,UAAA,OAAO,IAAA,CAAK,4BAAA,CAA6B,IAAA,CAAK,MAAM,CAAA;AAAA,QACxD,CAAC,CAAA;AAAA,MACL,SAAS,KAAA,EAAO;AACZ,QAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,EAAc;AACvD,UAAA;AAAA,QACJ;AAIA,QAAA,IAAIA,qCAAA,CAAoB,KAAK,CAAA,EAAG;AAC5B,UAAA,OAAA,CAAQ,MAAM,uBAAuB,CAAA;AACrC,UAAA;AAAA,QACJ;AAEA,QAAA,OAAA,CAAQ,KAAA,CAAM,6BAA6B,KAAK,CAAA;AAChD,QAAA,MAAM,KAAA;AAAA,MACV;AAAA,IACJ;AAAA,EACJ;AACJ;;;ACvFA,SAAS,YAAY,IAAA,EAAyB;AAC1C,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,KAAK,QAAA,CAAS,IAAA;AAAA,IACpB,IAAA,EAAM,KAAK,QAAA,CAAS,IAAA;AAAA,IACpB,KAAA,EAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA;AAAA,IACzB,MAAA,EAAQ;AAAA,MACJ,SAAA,EAAW,CAAC,IAAA,CAAK,OAAA,IAAW,CAAC,IAAA,CAAK,cAAA;AAAA,MAClC,MAAA,EAAQ,CAAC,IAAA,CAAK;AAAA,KAClB;AAAA,IACA,aAAA,EAAe;AAAA,MACX,OAAO,IAAA,CAAK,OAAA,GAAU,OAAA,GAAU,IAAA,CAAK,iBAAiB,cAAA,GAAiB,SAAA;AAAA,MACvE,iBAAiB,IAAA,CAAK,eAAA;AAAA,MACtB,aAAa,IAAA,CAAK,SAAA,GAAY,OAAO,IAAA,CAAK,SAAS,IAAI,GAAA,GAAO;AAAA,KAClE;AAAA,IACA,OAAA,EAAS,KAAK,OAAA,IAAW,EAAA;AAAA,IACzB,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,WAAW,IAAI,IAAA,CAAK,OAAO,IAAA,CAAK,SAAS,IAAI,GAAI,CAAA;AAAA,IACjD,YAAY,IAAA,CAAK,UAAA;AAAA,IACjB,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,QAAQ,IAAA,CAAK,MAAA;AAAA,IACb,MAAA,EAAQ,IAAA,CAAK,MAAA,EAAQ,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,MAC7B,SAAS,CAAA,CAAE,OAAA;AAAA,MACX,MAAA,EAAQ,MAAA,CAAO,CAAA,CAAE,MAAM;AAAA,KAC3B,CAAE;AAAA,GACN;AACJ;AAeO,IAAM,mBAAA,GAAN,cAAkCC,qCAAA,CAAoB;AAAA,EACzD,WAAA,CAAY,YAAoBF,2CAAA,EAA2B;AACvD,IAAA,KAAA,CAAM,SAAS,CAAA;AAAA,EACnB;AAAA,EAEA,OAAgB,eAAA,CACZ,cAAA,EACA,WAAA,EAC2C;AAE3C,IAAA,MAAM,aAAA,GACF,OAAO,SAAA,KAAc,WAAA,IAAe,UAAU,OAAA,KAAY,aAAA;AAE9D,IAAA,MAAM,YAAY,MAAM,YAAA,EAAa,CAAE,KAAA,CAAM,CAAC,KAAA,KAAU;AAEpD,MAAA,IAAI,aAAA,EAAe;AACf,QAAA,MAAM,IAAI,KAAA;AAAA,UACN;AAAA,SAGJ;AAAA,MACJ;AACA,MAAA,MAAM,KAAA;AAAA,IACV,CAAC,CAAA;AAED,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,SAAS,mCAAmC,cAAc,CAAA,CAAA;AAE9E,IAAA,OAAO,CAAC,YAAY,OAAA,EAAS;AACzB,MAAA,IAAI;AACA,QAAA,OAAO,iBAAA;AAAA,UACH,GAAA;AAAA,UACA,WAAA;AAAA,UACA,SAAA;AAAA,UACA,EAAE,gBAAgB,kBAAA,EAAmB;AAAA,UACrC,CAAC,IAAA,KAAsC;AAEnC,YAAA,IAAI,IAAA,CAAK,cAAc,KAAA,CAAA,EAAW;AAE9B,cAAA,OAAO,IAAA;AAAA,YACX;AAEA,YAAA,IAAI,KAAK,KAAA,EAAO;AACZ,cAAA,OAAO;AAAA,gBACH,IAAA,EAAM,KAAK,KAAA,CAAM,IAAA;AAAA,gBACjB,OAAA,EAAS,IAAA,CAAK,KAAA,CAAM,OAAA,IAAW,EAAC;AAAA,gBAChC,WAAW,IAAA,CAAK,KAAA,CAAM,YAAY,EAAC,EAAG,IAAI,WAAW,CAAA;AAAA,gBACrD,aAAa,IAAA,CAAK,KAAA,CAAM,cAAc,EAAC,EAAG,IAAI,WAAW,CAAA;AAAA,gBACzD,aAAa,IAAA,CAAK,KAAA,CAAM,cAAc,EAAC,EAAG,IAAI,WAAW,CAAA;AAAA,gBACzD,EAAA,EAAI,KAAK,KAAA,CAAM,EAAA;AAAA,gBACf,aAAA,EAAe,KAAK,KAAA,CAAM;AAAA,eAC9B;AAAA,YACJ;AACA,YAAA,OAAO,IAAA;AAAA,UACX;AAAA,SACJ;AAAA,MACJ,SAAS,KAAA,EAAO;AACZ,QAAA,IAAI,KAAA,YAAiB,KAAA,IAAS,KAAA,CAAM,IAAA,KAAS,YAAA,EAAc;AACvD,UAAA;AAAA,QACJ;AAIA,QAAA,IAAIC,qCAAA,CAAoB,KAAK,CAAA,EAAG;AAC5B,UAAA,OAAA,CAAQ,MAAM,uBAAuB,CAAA;AACrC,UAAA;AAAA,QACJ;AAEA,QAAA,OAAA,CAAQ,KAAA,CAAM,uBAAuB,KAAK,CAAA;AAC1C,QAAA,MAAM,KAAA;AAAA,MACV;AAAA,IACJ;AAAA,EACJ;AACJ","file":"chunk-3HUZAIKI.cjs","sourcesContent":["import { fetch, buildVersion, sdkVersion } from \"../utils/fetch\";\n\n/**\n * Dynamically imports expo/fetch with fallback to standard fetch.\n * @returns A fetch function suitable for SSE streaming\n */\nexport async function getExpoFetch(options?: { requireExpo?: boolean }): Promise<typeof fetch> {\n    const requireExpo = options?.requireExpo ?? false;\n\n    try {\n        const expoFetchModule = await import(\"expo/fetch\");\n        console.debug(\"Using expo/fetch for streaming\");\n        const expoFetchWithHeader = (input: RequestInfo, init?: RequestInit) => {\n            const headers = new Headers(init?.headers);\n            headers.set(\"X-Build-Version\", buildVersion);\n            headers.set(\"X-SDK-VERSION\", sdkVersion);\n            return expoFetchModule.fetch(input, { ...init, headers });\n        };\n        return expoFetchWithHeader as unknown as typeof fetch;\n    } catch (error) {\n        if (requireExpo) {\n            throw new Error(\n                \"expo/fetch is unavailable in this environment. \" +\n                    \"Please ensure expo/fetch is installed and properly configured.\",\n            );\n        }\n\n        console.warn(\n            \"Using standard fetch instead of expo/fetch. \" +\n                \"Streaming may not be fully supported in some environments.\",\n            error,\n        );\n        return fetch;\n    }\n}\n\n/**\n * Generic SSE stream processor using fetch API with ReadableStream.\n * Handles SSE format parsing, buffer management, and abort signals.\n *\n * @param url - The SSE endpoint URL\n * @param abortSignal - Signal to abort the stream\n * @param fetchFn - Fetch function to use (defaults to standard fetch)\n * @param headers - Additional headers to send\n * @param parseData - Function to parse and yield data from SSE events\n */\nexport async function* sseStreamIterator<T>(\n    url: string,\n    abortSignal: AbortSignal,\n    fetchFn: typeof fetch,\n    headers: Record<string, string>,\n    parseData: (data: any) => T | null,\n): AsyncGenerator<T, void, unknown> {\n    const fetchController = new AbortController();\n    const cleanup = () => fetchController.abort();\n    abortSignal?.addEventListener(\"abort\", cleanup, { once: true });\n\n    try {\n        const response = await fetchFn(url, {\n            headers: {\n                Accept: \"text/event-stream\",\n                ...headers,\n            },\n            signal: fetchController.signal,\n        });\n\n        if (!response.ok) {\n            throw new Error(`Unexpected status ${response.status} when fetching SSE stream`);\n        }\n\n        if (!response.body) {\n            throw new Error(\"Response body is null\");\n        }\n\n        const reader = response.body.getReader();\n        const decoder = new TextDecoder();\n        let buffer = \"\";\n\n        while (!abortSignal?.aborted) {\n            const { done, value } = await reader.read();\n            if (done) {\n                break;\n            }\n\n            buffer += decoder.decode(value, { stream: true });\n            const lines = buffer.split(\"\\n\");\n\n            for (let i = 0; i < lines.length - 1; i++) {\n                const line = lines[i].trim();\n                if (!line) continue;\n\n                if (line.startsWith(\"data:\")) {\n                    const jsonStr = line.substring(5).trim();\n                    if (!jsonStr) continue;\n\n                    try {\n                        const data = JSON.parse(jsonStr);\n                        const parsed = parseData(data);\n                        if (parsed !== null) {\n                            yield parsed;\n                        }\n                    } catch (parseError) {\n                        console.error(\"Failed to parse SSE data:\", parseError);\n                        throw parseError;\n                    }\n                }\n            }\n\n            buffer = lines[lines.length - 1];\n        }\n    } finally {\n        abortSignal?.removeEventListener(\"abort\", cleanup);\n    }\n}\n","import { DEFAULT_ARKADE_SERVER_URL } from \"../networks\";\nimport { RestArkProvider, SettlementEvent, TxNotification, isFetchTimeoutError } from \"./ark\";\nimport { getExpoFetch, sseStreamIterator } from \"./expoUtils\";\n\n/**\n * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.\n * This provider works specifically in React Native/Expo environments where\n * standard EventSource is not available but expo/fetch provides SSE capabilities.\n *\n * @example\n * ```typescript\n * import { ExpoArkProvider } from '@arkade-os/sdk/providers/expo';\n *\n * const provider = new ExpoArkProvider('https://arkade.computer');\n * const info = await provider.getInfo();\n * ```\n */\nexport class ExpoArkProvider extends RestArkProvider {\n    constructor(serverUrl: string = DEFAULT_ARKADE_SERVER_URL) {\n        super(serverUrl);\n    }\n\n    override async *getEventStream(\n        signal: AbortSignal,\n        topics: string[],\n    ): AsyncIterableIterator<SettlementEvent> {\n        const expoFetch = await getExpoFetch();\n        const url = `${this.serverUrl}/v1/batch/events`;\n        const queryParams =\n            topics.length > 0\n                ? `?${topics.map((topic) => `topics=${encodeURIComponent(topic)}`).join(\"&\")}`\n                : \"\";\n\n        while (!signal?.aborted) {\n            try {\n                yield* sseStreamIterator(url + queryParams, signal, expoFetch, {}, (data) => {\n                    // Handle different response structures\n                    // v8 mesh API might wrap in {result: ...} or send directly\n                    const eventData = data.result || data;\n\n                    // Skip heartbeat messages\n                    if (eventData.heartbeat !== undefined) {\n                        return null;\n                    }\n\n                    return this.parseSettlementEvent(eventData);\n                });\n            } catch (error) {\n                if (error instanceof Error && error.name === \"AbortError\") {\n                    break;\n                }\n\n                // ignore timeout errors, they're expected when the server is not sending anything for 5 min\n                // these timeouts are set by expo/fetch function\n                if (isFetchTimeoutError(error)) {\n                    console.debug(\"Timeout error ignored\");\n                    continue;\n                }\n\n                console.error(\"Event stream error:\", error);\n                throw error;\n            }\n        }\n    }\n\n    override async *getTransactionsStream(signal: AbortSignal): AsyncIterableIterator<{\n        commitmentTx?: TxNotification;\n        arkTx?: TxNotification;\n    }> {\n        const expoFetch = await getExpoFetch();\n        const url = `${this.serverUrl}/v1/txs`;\n\n        while (!signal?.aborted) {\n            try {\n                yield* sseStreamIterator(url, signal, expoFetch, {}, (data) => {\n                    return this.parseTransactionNotification(data.result);\n                });\n            } catch (error) {\n                if (error instanceof Error && error.name === \"AbortError\") {\n                    break;\n                }\n\n                // ignore timeout errors, they're expected when the server is not sending anything for 5 min\n                // these timeouts are set by expo/fetch function\n                if (isFetchTimeoutError(error)) {\n                    console.debug(\"Timeout error ignored\");\n                    continue;\n                }\n\n                console.error(\"Transaction stream error:\", error);\n                throw error;\n            }\n        }\n    }\n}\n","import { RestIndexerProvider, SubscriptionResponse, Vtxo } from \"./indexer\";\nimport { isFetchTimeoutError } from \"./ark\";\nimport { VirtualCoin } from \"../wallet\";\nimport { getExpoFetch, sseStreamIterator } from \"./expoUtils\";\nimport { DEFAULT_ARKADE_SERVER_URL } from \"../networks\";\n\n// Helper function to convert Vtxo to VirtualCoin (same as in indexer.ts)\nfunction convertVtxo(vtxo: Vtxo): VirtualCoin {\n    return {\n        txid: vtxo.outpoint.txid,\n        vout: vtxo.outpoint.vout,\n        value: Number(vtxo.amount),\n        status: {\n            confirmed: !vtxo.isSwept && !vtxo.isPreconfirmed,\n            isLeaf: !vtxo.isPreconfirmed,\n        },\n        virtualStatus: {\n            state: vtxo.isSwept ? \"swept\" : vtxo.isPreconfirmed ? \"preconfirmed\" : \"settled\",\n            commitmentTxIds: vtxo.commitmentTxids,\n            batchExpiry: vtxo.expiresAt ? Number(vtxo.expiresAt) * 1000 : undefined,\n        },\n        spentBy: vtxo.spentBy ?? \"\",\n        settledBy: vtxo.settledBy,\n        arkTxId: vtxo.arkTxid,\n        createdAt: new Date(Number(vtxo.createdAt) * 1000),\n        isUnrolled: vtxo.isUnrolled,\n        isSpent: vtxo.isSpent,\n        script: vtxo.script,\n        assets: vtxo.assets?.map((a) => ({\n            assetId: a.assetId,\n            amount: BigInt(a.amount),\n        })),\n    };\n}\n\n/**\n * Expo-compatible Indexer provider implementation using expo/fetch for streaming support.\n * This provider works specifically in React Native/Expo environments where\n * standard fetch streaming may not work properly but expo/fetch provides streaming capabilities.\n *\n * @example\n * ```typescript\n * import { ExpoIndexerProvider } from '@arkade-os/sdk/adapters/expo';\n *\n * const provider = new ExpoIndexerProvider('https://indexer.example.com');\n * const vtxos = await provider.getVtxos({ scripts: ['script1'] });\n * ```\n */\nexport class ExpoIndexerProvider extends RestIndexerProvider {\n    constructor(serverUrl: string = DEFAULT_ARKADE_SERVER_URL) {\n        super(serverUrl);\n    }\n\n    override async *getSubscription(\n        subscriptionId: string,\n        abortSignal: AbortSignal,\n    ): AsyncIterableIterator<SubscriptionResponse> {\n        // Detect if we're running in React Native/Expo environment\n        const isReactNative =\n            typeof navigator !== \"undefined\" && navigator.product === \"ReactNative\";\n\n        const expoFetch = await getExpoFetch().catch((error) => {\n            // In React Native/Expo, expo/fetch is required for proper streaming support\n            if (isReactNative) {\n                throw new Error(\n                    \"expo/fetch is unavailable in React Native environment. \" +\n                        \"Please ensure expo/fetch is installed and properly configured. \" +\n                        \"Streaming support may not work with standard fetch in React Native.\",\n                );\n            }\n            throw error;\n        });\n\n        const url = `${this.serverUrl}/v1/indexer/script/subscription/${subscriptionId}`;\n\n        while (!abortSignal.aborted) {\n            try {\n                yield* sseStreamIterator(\n                    url,\n                    abortSignal,\n                    expoFetch,\n                    { \"Content-Type\": \"application/json\" },\n                    (data): SubscriptionResponse | null => {\n                        // Handle new v8 proto format with heartbeat or event\n                        if (data.heartbeat !== undefined) {\n                            // Skip heartbeat messages\n                            return null;\n                        }\n                        // Process event messages\n                        if (data.event) {\n                            return {\n                                txid: data.event.txid,\n                                scripts: data.event.scripts || [],\n                                newVtxos: (data.event.newVtxos || []).map(convertVtxo),\n                                spentVtxos: (data.event.spentVtxos || []).map(convertVtxo),\n                                sweptVtxos: (data.event.sweptVtxos || []).map(convertVtxo),\n                                tx: data.event.tx,\n                                checkpointTxs: data.event.checkpointTxs,\n                            };\n                        }\n                        return null;\n                    },\n                );\n            } catch (error) {\n                if (error instanceof Error && error.name === \"AbortError\") {\n                    break;\n                }\n\n                // ignore timeout errors, they're expected when the server is not sending anything for 5 min\n                // these timeouts are set by expo/fetch function\n                if (isFetchTimeoutError(error)) {\n                    console.debug(\"Timeout error ignored\");\n                    continue;\n                }\n\n                console.error(\"Subscription error:\", error);\n                throw error;\n            }\n        }\n    }\n}\n"]}

package/dist/chunk-4AIHKC65.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/worker/expo/taskRunner.ts","../src/worker/expo/processors/contractPollProcessor.ts"],"names":[],"mappings":"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","file":"chunk-4AIHKC65.js","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 type { TaskItem, TaskResult } from \"../taskQueue\";\nimport type { TaskProcessor, TaskDependencies } from \"../taskRunner\";\nimport type { ExtendedVirtualCoin } from \"../../../wallet\";\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 all contracts 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        const contracts = await contractRepository.getContracts();\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 indexerProvider.getVtxos({\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"]}