@arkade-os/sdk 0.4.25 → 0.4.27

package/dist/esm/providers/ark.js

@@ -1,7 +1,7 @@
 import { hex } from "@scure/base";
-import { eventSourceIterator, isEventSourceError } from './utils.js';
-import { maybeArkError } from './errors.js';
-import { Intent } from '../intent/index.js';
+import { eventSourceIterator, isEventSourceError } from "./utils.js";
+import { maybeArkError } from "./errors.js";
+import { Intent } from "../intent/index.js";
 export var SettlementEventType;
 (function (SettlementEventType) {
     SettlementEventType["BatchStarted"] = "batch_started";

package/dist/esm/providers/delegator.js

@@ -1,4 +1,4 @@
-import { Intent } from '../intent/index.js';
+import { Intent } from "../intent/index.js";
 /**
  * REST-based delegation provider implementation.
  * @example

package/dist/esm/providers/electrum.js

@@ -92,8 +92,8 @@ function parseBlockHeader(headerHex) {
  * @example
  * ```typescript
  * import { ElectrumWS } from "ws-electrumx-client";
- * import { WsElectrumChainSource } from './providers/electrum.js';
- * import { networks } from './networks.js';
+ * import { WsElectrumChainSource } from "./providers/electrum.js";
+ * import { networks } from "./networks.js";
  *
  * const ws = new ElectrumWS("wss://electrum.blockstream.info:50004");
  * const chain = new WsElectrumChainSource(ws, networks.bitcoin);

package/dist/esm/providers/expoArk.js

@@ -1,5 +1,5 @@
-import { RestArkProvider, isFetchTimeoutError, } from './ark.js';
-import { getExpoFetch, sseStreamIterator } from './expoUtils.js';
+import { RestArkProvider, isFetchTimeoutError, } from "./ark.js";
+import { getExpoFetch, sseStreamIterator } from "./expoUtils.js";
 /**
  * Expo-compatible Arkade provider implementation using expo/fetch for SSE support.
  * This provider works specifically in React Native/Expo environments where

package/dist/esm/providers/expoIndexer.js

@@ -1,6 +1,6 @@
-import { RestIndexerProvider } from './indexer.js';
-import { isFetchTimeoutError } from './ark.js';
-import { getExpoFetch, sseStreamIterator } from './expoUtils.js';
+import { RestIndexerProvider } from "./indexer.js";
+import { isFetchTimeoutError } from "./ark.js";
+import { getExpoFetch, sseStreamIterator } from "./expoUtils.js";
 // Helper function to convert Vtxo to VirtualCoin (same as in indexer.ts)
 function convertVtxo(vtxo) {
     return {

package/dist/esm/providers/indexer.js

@@ -1,7 +1,7 @@
 import { hex } from "@scure/base";
-import { isFetchTimeoutError } from './ark.js';
-import { eventSourceIterator, isEventSourceError } from './utils.js';
-import { MetadataList } from '../extension/asset/index.js';
+import { isFetchTimeoutError } from "./ark.js";
+import { eventSourceIterator, isEventSourceError } from "./utils.js";
+import { MetadataList } from "../extension/asset/index.js";
 export var IndexerTxType;
 (function (IndexerTxType) {
     IndexerTxType[IndexerTxType["INDEXER_TX_TYPE_UNSPECIFIED"] = 0] = "INDEXER_TX_TYPE_UNSPECIFIED";

package/dist/esm/repositories/inMemory/walletRepository.js

@@ -1,4 +1,4 @@
-import { isVtxoForScript } from '../../contracts/vtxoOwnership.js';
+import { isVtxoForScript } from "../../contracts/vtxoOwnership.js";
 /**
  * In-memory implementation of WalletRepository.
  * Data is ephemeral and scoped to the instance.

package/dist/esm/repositories/index.js

@@ -1,10 +1,10 @@
-export * from './walletRepository.js';
-export * from './contractRepository.js';
-export * from './inMemory/walletRepository.js';
-export * from './inMemory/contractRepository.js';
-export * from './indexedDB/contractRepository.js';
-export * from './indexedDB/walletRepository.js';
-export { MIGRATION_KEY, migrateWalletRepository, requiresMigration, getMigrationStatus, rollbackMigration, } from './migrations/fromStorageAdapter.js';
+export * from "./walletRepository.js";
+export * from "./contractRepository.js";
+export * from "./inMemory/walletRepository.js";
+export * from "./inMemory/contractRepository.js";
+export * from "./indexedDB/contractRepository.js";
+export * from "./indexedDB/walletRepository.js";
+export { MIGRATION_KEY, migrateWalletRepository, requiresMigration, getMigrationStatus, rollbackMigration, } from "./migrations/fromStorageAdapter.js";
 // Deprecated
-export { WalletRepositoryImpl } from './migrations/walletRepositoryImpl.js';
-export { ContractRepositoryImpl } from './migrations/contractRepositoryImpl.js';
+export { WalletRepositoryImpl } from "./migrations/walletRepositoryImpl.js";
+export { ContractRepositoryImpl } from "./migrations/contractRepositoryImpl.js";

package/dist/esm/repositories/indexedDB/contractRepository.js

@@ -1,7 +1,7 @@
-import { DB_VERSION, STORE_CONTRACTS } from './db.js';
-import { closeDatabase, openDatabase } from './manager.js';
-import { initDatabase } from './schema.js';
-import { DEFAULT_DB_NAME } from '../../worker/browser/utils.js';
+import { DB_VERSION, STORE_CONTRACTS } from "./db.js";
+import { closeDatabase, openDatabase } from "./manager.js";
+import { initDatabase } from "./schema.js";
+import { DEFAULT_DB_NAME } from "../../worker/browser/utils.js";
 /**
  * IndexedDB-based implementation of ContractRepository.
  *

package/dist/esm/repositories/indexedDB/db.js

@@ -1,4 +1,4 @@
-import { DB_VERSION, STORE_CONTRACTS, LEGACY_STORE_CONTRACT_COLLECTIONS, STORE_TRANSACTIONS, STORE_UTXOS, STORE_VTXOS, STORE_WALLET_STATE, } from './schema.js';
+import { DB_VERSION, STORE_CONTRACTS, LEGACY_STORE_CONTRACT_COLLECTIONS, STORE_TRANSACTIONS, STORE_UTXOS, STORE_VTXOS, STORE_WALLET_STATE, } from "./schema.js";
 export { STORE_VTXOS, STORE_UTXOS, STORE_TRANSACTIONS, STORE_WALLET_STATE, STORE_CONTRACTS, LEGACY_STORE_CONTRACT_COLLECTIONS, DB_VERSION, };
 // Serialization helpers (re-exported from shared module)
-export { serializeTapLeaf, serializeVtxo, serializeUtxo, deserializeTapLeaf, deserializeVtxo, deserializeUtxo, } from '../serialization.js';
+export { serializeTapLeaf, serializeVtxo, serializeUtxo, deserializeTapLeaf, deserializeVtxo, deserializeUtxo, } from "../serialization.js";

package/dist/esm/repositories/indexedDB/schema.js

@@ -1,4 +1,4 @@
-import { scriptFromArkAddress } from '../scriptFromAddress.js';
+import { scriptFromArkAddress } from "../scriptFromAddress.js";
 // Store names introduced in V2, they are all new to the migration
 export const STORE_VTXOS = "vtxos";
 export const STORE_UTXOS = "utxos";

package/dist/esm/repositories/indexedDB/walletRepository.js

@@ -1,9 +1,9 @@
-import { STORE_VTXOS, STORE_UTXOS, STORE_TRANSACTIONS, STORE_WALLET_STATE, serializeVtxo, serializeUtxo, deserializeVtxo, deserializeUtxo, DB_VERSION, } from './db.js';
-import { closeDatabase, openDatabase } from './manager.js';
-import { initDatabase } from './schema.js';
-import { scriptFromArkAddress } from '../scriptFromAddress.js';
-import { DEFAULT_DB_NAME } from '../../worker/browser/utils.js';
-import { isVtxoForScript } from '../../contracts/vtxoOwnership.js';
+import { STORE_VTXOS, STORE_UTXOS, STORE_TRANSACTIONS, STORE_WALLET_STATE, serializeVtxo, serializeUtxo, deserializeVtxo, deserializeUtxo, DB_VERSION, } from "./db.js";
+import { closeDatabase, openDatabase } from "./manager.js";
+import { initDatabase } from "./schema.js";
+import { scriptFromArkAddress } from "../scriptFromAddress.js";
+import { DEFAULT_DB_NAME } from "../../worker/browser/utils.js";
+import { isVtxoForScript } from "../../contracts/vtxoOwnership.js";
 /**
  * IndexedDB-based implementation of WalletRepository.
  */

package/dist/esm/repositories/migrations/fromStorageAdapter.js

@@ -1,4 +1,4 @@
-import { WalletRepositoryImpl } from './walletRepositoryImpl.js';
+import { WalletRepositoryImpl } from "./walletRepositoryImpl.js";
 export const MIGRATION_KEY = (repoType) => `migration-from-storage-adapter-${repoType}`;
 export async function getMigrationStatus(repoType, storageAdapter) {
     try {

package/dist/esm/repositories/migrations/walletRepositoryImpl.js

@@ -1,6 +1,6 @@
 import { hex } from "@scure/base";
 import { TaprootControlBlock } from "@scure/btc-signer";
-import { serializeAssets, deserializeAssets, serializeTransaction, deserializeTransaction, } from '../serialization.js';
+import { serializeAssets, deserializeAssets, serializeTransaction, deserializeTransaction, } from "../serialization.js";
 const getVtxosStorageKey = (address) => `vtxos:${address}`;
 const getUtxosStorageKey = (address) => `utxos:${address}`;
 const getTransactionsStorageKey = (address) => `tx:${address}`;

package/dist/esm/repositories/realm/index.js

@@ -1,3 +1,3 @@
-export { RealmWalletRepository } from './walletRepository.js';
-export { RealmContractRepository } from './contractRepository.js';
-export { ArkRealmSchemas, ARK_REALM_SCHEMA_VERSION, runArkRealmMigrations, } from './schemas.js';
+export { RealmWalletRepository } from "./walletRepository.js";
+export { RealmContractRepository } from "./contractRepository.js";
+export { ArkRealmSchemas, ARK_REALM_SCHEMA_VERSION, runArkRealmMigrations, } from "./schemas.js";

package/dist/esm/repositories/realm/schemas.js

@@ -8,7 +8,7 @@
  * schemas are defined as plain JS objects conforming to Realm's
  * ObjectSchema shape.
  */
-import { scriptFromArkAddress } from '../scriptFromAddress.js';
+import { scriptFromArkAddress } from "../scriptFromAddress.js";
 export const ArkVtxoSchema = {
     name: "ArkVtxo",
     primaryKey: "pk",

package/dist/esm/repositories/realm/walletRepository.js

@@ -1,6 +1,6 @@
-import { serializeVtxo, serializeUtxo, deserializeVtxo, deserializeUtxo, serializeAssets, deserializeAssets, } from '../serialization.js';
-import { scriptFromArkAddress } from '../scriptFromAddress.js';
-import { isVtxoForScript } from '../../contracts/vtxoOwnership.js';
+import { serializeVtxo, serializeUtxo, deserializeVtxo, deserializeUtxo, serializeAssets, deserializeAssets, } from "../serialization.js";
+import { scriptFromArkAddress } from "../scriptFromAddress.js";
+import { isVtxoForScript } from "../../contracts/vtxoOwnership.js";
 /**
  * Realm-based implementation of WalletRepository.
  *

package/dist/esm/repositories/scriptFromAddress.js

@@ -1,5 +1,5 @@
 import { hex } from "@scure/base";
-import { ArkAddress } from '../index.js';
+import { ArkAddress } from "../index.js";
 /**
  * Compute the hex-encoded `scriptPubKey` locking a VTXO from its owning Ark
  * address. Used by repository-layer migrations to backfill `script` on legacy

package/dist/esm/repositories/sqlite/index.js

@@ -1,2 +1,2 @@
-export { SQLiteWalletRepository } from './walletRepository.js';
-export { SQLiteContractRepository } from './contractRepository.js';
+export { SQLiteWalletRepository } from "./walletRepository.js";
+export { SQLiteContractRepository } from "./contractRepository.js";

package/dist/esm/repositories/sqlite/walletRepository.js

@@ -1,6 +1,6 @@
-import { serializeVtxo, serializeUtxo, deserializeVtxo, deserializeUtxo, serializeAssets, deserializeAssets, } from '../serialization.js';
-import { scriptFromArkAddress } from '../scriptFromAddress.js';
-import { isVtxoForScript } from '../../contracts/vtxoOwnership.js';
+import { serializeVtxo, serializeUtxo, deserializeVtxo, deserializeUtxo, serializeAssets, deserializeAssets, } from "../serialization.js";
+import { scriptFromArkAddress } from "../scriptFromAddress.js";
+import { isVtxoForScript } from "../../contracts/vtxoOwnership.js";
 /**
  * SQLite-based implementation of WalletRepository.
  *

package/dist/esm/script/address.js

@@ -1,6 +1,6 @@
 import { bech32m } from "@scure/base";
 import { Script } from "@scure/btc-signer/script.js";
-import { DEFAULT_ARKADE_HRP } from '../wallet/index.js';
+import { DEFAULT_ARKADE_HRP } from "../wallet/index.js";
 /**
  * ArkAddress allows creating and decoding bech32m-encoded Arkade addresses.
  *
@@ -32,10 +32,10 @@ import { DEFAULT_ARKADE_HRP } from '../wallet/index.js';
  */
 export class ArkAddress {
     /**
-     * Create an Arkade address from its server key, vtxo taproot public key, and prefix.
+     * Create an Arkade address from its server public key, Taproot output key, and prefix.
      *
      * @param serverPubKey - 32-byte Arkade server public key
-     * @param vtxoTaprootKey - 32-byte tweaked vtxo taproot public key
+     * @param vtxoTaprootKey - 32-byte Taproot output key (a.k.a. tweaked public key)
      * @param hrp - Bech32 human-readable prefix
      * @param version - Address version byte
      * @defaultValue `version = 0`

package/dist/esm/script/base.js

@@ -2,9 +2,9 @@ import { Script, Address, p2tr, taprootListToTree, TAPROOT_UNSPENDABLE_KEY, } fr
 import { TAP_LEAF_VERSION } from "@scure/btc-signer/payment.js";
 import { PSBTOutput } from "@scure/btc-signer/psbt.js";
 import { hex } from "@scure/base";
-import { ArkAddress } from './address.js';
-import { timelockToSequence } from '../utils/timelock.js';
-import { CLTVMultisigTapscript, ConditionCSVMultisigTapscript, CSVMultisigTapscript, } from './tapscript.js';
+import { ArkAddress } from "./address.js";
+import { timelockToSequence } from "../utils/timelock.js";
+import { CLTVMultisigTapscript, ConditionCSVMultisigTapscript, CSVMultisigTapscript, } from "./tapscript.js";
 export const TapTreeCoder = PSBTOutput.tapTree[2];
 export function scriptFromTapLeafScript(leaf) {
     return leaf[1].subarray(0, leaf[1].length - 1); // remove the version byte

package/dist/esm/script/default.js

@@ -1,5 +1,5 @@
-import { VtxoScript } from './base.js';
-import { CSVMultisigTapscript, MultisigTapscript, } from './tapscript.js';
+import { VtxoScript } from "./base.js";
+import { CSVMultisigTapscript, MultisigTapscript, } from "./tapscript.js";
 import { hex } from "@scure/base";
 /**
  * DefaultVtxo is the default implementation of a VtxoScript.

package/dist/esm/script/delegate.js

@@ -1,6 +1,6 @@
-import { DefaultVtxo } from './default.js';
-import { MultisigTapscript } from './tapscript.js';
-import { VtxoScript } from './base.js';
+import { DefaultVtxo } from "./default.js";
+import { MultisigTapscript } from "./tapscript.js";
+import { VtxoScript } from "./base.js";
 import { hex } from "@scure/base";
 /**
  * DelegateVtxo extends DefaultVtxo with an extra delegator path

package/dist/esm/script/tapscript.js

@@ -1,6 +1,6 @@
 import { Script, ScriptNum, p2tr_ms } from "@scure/btc-signer";
 import { hex } from "@scure/base";
-import { sequenceToTimelock, timelockToSequence } from '../utils/timelock.js';
+import { sequenceToTimelock, timelockToSequence } from "../utils/timelock.js";
 const MinimalScriptNum = ScriptNum(undefined, true);
 export var TapscriptType;
 (function (TapscriptType) {

package/dist/esm/script/vhtlc.js

@@ -1,7 +1,7 @@
 import { Script } from "@scure/btc-signer";
-import { CLTVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CSVMultisigTapscript, MultisigTapscript, } from './tapscript.js';
+import { CLTVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CSVMultisigTapscript, MultisigTapscript, } from "./tapscript.js";
 import { hex } from "@scure/base";
-import { VtxoScript } from './base.js';
+import { VtxoScript } from "./base.js";
 /** Virtual Hash Time Lock Contract (VHTLC) namespace. */
 export var VHTLC;
 (function (VHTLC) {

package/dist/esm/storage/indexedDB.js

@@ -1,4 +1,4 @@
-import { DB_VERSION } from '../repositories/indexedDB/db.js';
+import { DB_VERSION } from "../repositories/indexedDB/db.js";
 /**
  * @deprecated Use repository implementations via `StorageConfig` instead.
  */

package/dist/esm/tree/signingSession.js

@@ -1,10 +1,10 @@
-import * as musig2 from '../musig2/index.js';
+import * as musig2 from "../musig2/index.js";
 import { Script } from "@scure/btc-signer/script.js";
 import { SigHash } from "@scure/btc-signer/transaction.js";
 import { hex } from "@scure/base";
 import { schnorr, secp256k1 } from "@noble/curves/secp256k1.js";
 import { randomPrivateKeyBytes } from "@scure/btc-signer/utils.js";
-import { CosignerPublicKey, getArkPsbtFields } from '../utils/unknownFields.js';
+import { CosignerPublicKey, getArkPsbtFields } from "../utils/unknownFields.js";
 export const ErrMissingVtxoGraph = new Error("missing vtxo graph");
 export const ErrMissingAggregateKey = new Error("missing aggregate key");
 export class TreeSignerSession {

package/dist/esm/tree/validation.js

@@ -1,8 +1,8 @@
 import { hex } from "@scure/base";
 import { Transaction } from "@scure/btc-signer/transaction.js";
 import { base64 } from "@scure/base";
-import { aggregateKeys } from '../musig2/index.js';
-import { CosignerPublicKey, getArkPsbtFields } from '../utils/unknownFields.js';
+import { aggregateKeys } from "../musig2/index.js";
+import { CosignerPublicKey, getArkPsbtFields } from "../utils/unknownFields.js";
 export const ErrInvalidSettlementTx = (tx) => new Error(`invalid settlement transaction: ${tx}`);
 export const ErrInvalidSettlementTxOutputs = new Error("invalid settlement transaction outputs");
 export const ErrEmptyTree = new Error("empty tree");

package/dist/esm/utils/arkTransaction.js

@@ -2,13 +2,13 @@ import { schnorr } from "@noble/curves/secp256k1.js";
 import { hex } from "@scure/base";
 import { DEFAULT_SEQUENCE, Script, SigHash } from "@scure/btc-signer";
 import { tapLeafHash } from "@scure/btc-signer/payment.js";
-import { CLTVMultisigTapscript, decodeTapscript, } from '../script/tapscript.js';
-import { scriptFromTapLeafScript, VtxoScript, } from '../script/base.js';
-import { P2A } from './anchor.js';
-import { setArkPsbtField, VtxoTaprootTree } from './unknownFields.js';
-import { Transaction } from './transaction.js';
-import { ArkAddress } from '../script/address.js';
-import { Extension } from '../extension/index.js';
+import { CLTVMultisigTapscript, decodeTapscript, } from "../script/tapscript.js";
+import { scriptFromTapLeafScript, VtxoScript, } from "../script/base.js";
+import { P2A } from "./anchor.js";
+import { setArkPsbtField, VtxoTaprootTree } from "./unknownFields.js";
+import { Transaction } from "./transaction.js";
+import { ArkAddress } from "../script/address.js";
+import { Extension } from "../extension/index.js";
 /**
  * Builds an offchain transaction with checkpoint transactions.
  *

package/dist/esm/utils/transactionHistory.js

@@ -1,4 +1,4 @@
-import { TxType } from '../wallet/index.js';
+import { TxType } from "../wallet/index.js";
 const txKey = {
     commitmentTxid: "",
     boardingTxid: "",

package/dist/esm/utils/unknownFields.js

@@ -1,6 +1,6 @@
 import { RawWitness, ScriptNum } from "@scure/btc-signer";
 import { hex } from "@scure/base";
-import { sequenceToTimelock } from './timelock.js';
+import { sequenceToTimelock } from "./timelock.js";
 /**
  * ArkPsbtFieldKey are the available key names for the Arkade PSBT custom fields.
  */

package/dist/esm/wallet/asset-manager.js

@@ -1,8 +1,8 @@
-import { AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, Metadata, Packet, } from '../extension/asset/index.js';
-import { ArkAddress } from '../script/address.js';
-import { selectedCoinsToAssetInputs, selectCoinsWithAsset } from './asset.js';
-import { Extension } from '../extension/index.js';
-import { selectVirtualCoins } from './wallet.js';
+import { AssetGroup, AssetId, AssetInput, AssetOutput, AssetRef, Metadata, Packet, } from "../extension/asset/index.js";
+import { ArkAddress } from "../script/address.js";
+import { selectedCoinsToAssetInputs, selectCoinsWithAsset } from "./asset.js";
+import { Extension } from "../extension/index.js";
+import { selectVirtualCoins } from "./wallet.js";
 export class ReadonlyAssetManager {
     constructor(indexer) {
         this.indexer = indexer;

package/dist/esm/wallet/asset.js

@@ -1,4 +1,4 @@
-import { AssetGroup, AssetId, AssetInput, AssetOutput, Packet, } from '../extension/asset/index.js';
+import { AssetGroup, AssetId, AssetInput, AssetOutput, Packet, } from "../extension/asset/index.js";
 /**
  * Creates an asset packet from asset inputs and receivers.
  * Groups inputs and outputs by asset ID and creates the Packet object

package/dist/esm/wallet/batch.js

@@ -1,5 +1,5 @@
-import { SettlementEventType } from '../providers/ark.js';
-import { TxTree } from '../tree/txTree.js';
+import { SettlementEventType } from "../providers/ark.js";
+import { TxTree } from "../tree/txTree.js";
 import { hex } from "@scure/base";
 /**
  * Batch namespace provides utilities for joining and processing batch session.

package/dist/esm/wallet/delegator.js

@@ -1,12 +1,12 @@
-import { ArkAddress, decodeTapscript, Estimator, Intent, isRecoverable, MultisigTapscript, VtxoScript, } from '../index.js';
+import { ArkAddress, decodeTapscript, Estimator, Intent, isRecoverable, MultisigTapscript, VtxoScript, } from "../index.js";
 import { base64, hex } from "@scure/base";
-import { scriptFromTapLeafScript } from '../script/base.js';
-import { buildForfeitTxWithOutput } from '../forfeit.js';
+import { scriptFromTapLeafScript } from "../script/base.js";
+import { buildForfeitTxWithOutput } from "../forfeit.js";
 import { Address, OutScript, SigHash } from "@scure/btc-signer";
 import { equalBytes } from "@scure/btc-signer/utils.js";
-import { getNetwork } from '../networks.js';
-import { createAssetPacket } from './asset.js';
-import { Extension } from '../extension/index.js';
+import { getNetwork } from "../networks.js";
+import { createAssetPacket } from "./asset.js";
+import { Extension } from "../extension/index.js";
 export class DelegatorManagerImpl {
     /** Create a delegator manager from the configured provider, Arkade info source, and wallet identity. */
     constructor(delegatorProvider, arkInfoProvider, identity) {
@@ -25,10 +25,11 @@ export class DelegatorManagerImpl {
         // fetch server and delegator info once, shared across all groups
         const arkInfo = await this.arkInfoProvider.getInfo();
         const delegateInfo = await this.delegatorProvider.getDelegateInfo();
-        // keep only vtxos that can be signed by the delegate
-        const eligible = vtxos
-            .filter((v) => findDelegateTapLeaf(v, delegateInfo.pubkey) !== undefined)
-            .map((v) => v);
+        // keep only vtxos that can be signed by the delegate. The guard
+        // narrows ContractVtxo (with optional taproot fields) to the
+        // ExtendedVirtualCoin shape required by makeDelegateForfeitTx.
+        const eligible = vtxos.filter((v) => isAnnotated(v) &&
+            findDelegateTapLeaf(v, delegateInfo.pubkey) !== undefined);
         if (eligible.length === 0) {
             return { delegated: [], failed: [] };
         }
@@ -295,3 +296,8 @@ function findDelegateTapLeaf(vtxo, delegatePubkey) {
         return arkTapscript.params.pubkeys.map(hex.encode).includes(pk);
     });
 }
+function isAnnotated(v) {
+    return (v.tapTree !== undefined &&
+        v.forfeitTapLeafScript !== undefined &&
+        v.intentTapLeafScript !== undefined);
+}

package/dist/esm/wallet/expo/background.js

@@ -1,8 +1,8 @@
-import { runTasks, createTaskDependencies } from '../../worker/expo/taskRunner.js';
-import { contractPollProcessor, CONTRACT_POLL_TASK_TYPE, } from '../../worker/expo/processors/index.js';
-import { ExpoArkProvider } from '../../providers/expoArk.js';
-import { ExpoIndexerProvider } from '../../providers/expoIndexer.js';
-import { getRandomId } from '../utils.js';
+import { runTasks, createTaskDependencies } from "../../worker/expo/taskRunner.js";
+import { contractPollProcessor, CONTRACT_POLL_TASK_TYPE, } from "../../worker/expo/processors/index.js";
+import { ExpoArkProvider } from "../../providers/expoArk.js";
+import { ExpoIndexerProvider } from "../../providers/expoIndexer.js";
+import { getRandomId } from "../utils.js";
 function requireTaskManager() {
     try {
         return require("expo-task-manager");

package/dist/esm/wallet/expo/index.js

@@ -1,2 +1,2 @@
-export { ExpoWallet } from './wallet.js';
-export { defineExpoBackgroundTask, registerExpoBackgroundTask, unregisterExpoBackgroundTask, } from './background.js';
+export { ExpoWallet } from "./wallet.js";
+export { defineExpoBackgroundTask, registerExpoBackgroundTask, unregisterExpoBackgroundTask, } from "./background.js";

package/dist/esm/wallet/expo/wallet.js

@@ -1,10 +1,10 @@
 import { hex } from "@scure/base";
-import { Wallet } from '../wallet.js';
-import { RestArkProvider } from '../../providers/ark.js';
-import { runTasks } from '../../worker/expo/taskRunner.js';
-import { contractPollProcessor, CONTRACT_POLL_TASK_TYPE, } from '../../worker/expo/processors/index.js';
-import { extendVirtualCoinForContract, getRandomId } from '../utils.js';
-import { DefaultVtxo } from '../../script/default.js';
+import { Wallet } from "../wallet.js";
+import { RestArkProvider } from "../../providers/ark.js";
+import { runTasks } from "../../worker/expo/taskRunner.js";
+import { contractPollProcessor, CONTRACT_POLL_TASK_TYPE, } from "../../worker/expo/processors/index.js";
+import { extendVirtualCoinForContract, getRandomId } from "../utils.js";
+import { DefaultVtxo } from "../../script/default.js";
 /**
  * Expo/React Native wallet with built-in background task processing.
  *
@@ -96,7 +96,7 @@ export class ExpoWallet {
         // Activate OS-level background scheduling
         if (config.background.minimumBackgroundInterval) {
             try {
-                const { registerExpoBackgroundTask } = await import("./background");
+                const { registerExpoBackgroundTask } = await import("./background.js");
                 await registerExpoBackgroundTask(config.background.taskName, {
                     minimumInterval: config.background.minimumBackgroundInterval,
                 });
@@ -145,7 +145,7 @@ export class ExpoWallet {
             this.foregroundIntervalId = undefined;
         }
         try {
-            const { unregisterExpoBackgroundTask } = await import("./background");
+            const { unregisterExpoBackgroundTask } = await import("./background.js");
             await unregisterExpoBackgroundTask(this.taskName);
         }
         catch {

package/dist/esm/wallet/hdDescriptorProvider.js

@@ -1,6 +1,7 @@
 import { expand, networks } from "@bitcoinerlab/descriptors-scure";
-import { isMainnetDescriptor } from '../identity/descriptor.js';
-import { updateWalletState } from '../utils/syncCursors.js';
+import { isMainnetDescriptor } from "../identity/descriptor.js";
+import { updateWalletState } from "../utils/syncCursors.js";
+import { WalletReceiveRotator, } from "./walletReceiveRotator.js";
 /** Settings key under {@link WalletState.settings} where HD state lives. */
 const HD_SETTINGS_KEY = "hd";
 /**
@@ -60,6 +61,25 @@ export class HDDescriptorProvider {
             return this.materializeAt(next);
         });
     }
+    /**
+     * Re-derive the descriptor at the most recently allocated index
+     * WITHOUT advancing — i.e. read the same descriptor
+     * `getNextSigningDescriptor` last returned. Returns `undefined`
+     * when no descriptor has ever been allocated on this repo.
+     *
+     * Used by the boot path to keep the wallet's display address
+     * stable across restarts: when no tagged display contract exists
+     * (e.g. a fresh wallet that hasn't rotated yet, or a wallet whose
+     * baseline-only repo carries no rotation history), the boot should
+     * re-derive the existing index rather than burn a new one.
+     */
+    async getCurrentSigningDescriptor() {
+        const state = await this.walletRepository.getWalletState();
+        const settings = this.parseSettings(state ?? {});
+        if (settings.lastIndexUsed === undefined)
+            return undefined;
+        return this.materializeAt(settings.lastIndexUsed);
+    }
     /**
      * Returns true when the given descriptor is derivable from this wallet's
      * seed. Delegates to the underlying identity, which handles both HD and
@@ -80,6 +100,15 @@ export class HDDescriptorProvider {
     async signMessageWithDescriptor(descriptor, message, signatureType = "schnorr") {
         return this.identity.signMessageWithDescriptor(descriptor, message, signatureType);
     }
+    /**
+     * HD providers participate in receive rotation. The default
+     * factory boot (contract-repo lookup → allocate fresh descriptor)
+     * is exactly what we want, so this just delegates to
+     * {@link WalletReceiveRotator.defaultBoot}.
+     */
+    async createReceiveRotator(opts) {
+        return WalletReceiveRotator.defaultBoot(this, opts);
+    }
     // ── internals ────────────────────────────────────────────────────
     /**
      * Substitute the wildcard in the identity's account-descriptor template