@arkade-os/sdk 0.5.0-rc.2 → 0.5.0-rc.20

package/dist/index.js

@@ -1,7 +1,6 @@
-export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, AbortError, ActivityRegistry, AmbiguousRouteError, ArkNote, ArkadeCash, ArkadeCashCreateError, AssetManager, BIP21, BIP21Error, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, CachingArkProvider, ChainedTxType, ConnectionDisposedError, ContractManager, ContractRepositoryImpl, ContractWatcher, DEFAULT_MESSAGE_TIMEOUTS, DEFAULT_MIN_BATCH_EXPIRY_SECONDS, DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, DatabaseUpgradeBlockedError, DelegateManagerImpl, DelegateNotConfiguredError, DelegatorManagerImpl, DelegatorNotConfiguredError, DescriptorIdentity, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EmulatorPacket, EsploraProvider, Estimator, Extension, ExtensionNotFoundError, ForeignDescriptorError, HDDescriptorProvider, INTENT_TERMINAL_STATES, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MIGRATION_KEY, MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, P2A, PaymentRouter, PrevTxUnavailableError, REGTEST_MIN_BATCH_EXPIRY_SECONDS, REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestDelegatorProvider, RestEmulatorProvider, SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, TxTree, TxType, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, VtxoManager, Wallet, WalletCannotAllocateAddressError, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WalletRepositoryImpl, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, arkade_exports as arkade, assertFinalCommitmentMatchesValidated, assertNoAssets, assertRecipientArkadeAddress, assertSendableAmount, assertSubmittedArkTxid, assertValidBatchExpiry, assertValidServerUnrollScript, assetMintResolver, assetsOf, attachPrevArkTxs, attachPrevoutTxs, awaitTransaction, boardingResolver, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, claimWithPreimageIdentity, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, collabExitResolver, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultActivityRegistry, createDefaultPaymentRouter, createExitChainResolver, createManagedConnection, decodeArkContract, defaultBatchExpiryPolicy, defaultCheckpointExitDelayPolicy, deleteByIndex, deserializeExitPackage, encodeArkContract, exitObserverFor, gateExclusion, gatedContracts, getAllByIndexValues, getMigrationStatus, getRandomId, hasBoardingTxExpired, hasCandidates, invoiceTarget, isAddressAllocationCapable, isArkContract, isBatchSignable, isBtcAddress, isContractGenericallySpendable, isCooperativelyMigratable, isDeterministicSigner, isDiscoverable, isHDAllocationCapable, isHDDeterministicSignCapable, isHDWalletCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isSigningIdentity, isSubdust, isTerminalIntentState, isValidArkAddress, isVtxoExpiringSoon, logExcludedVtxos, makeHandle, matchServerCheckpoints, migrateWalletRepository, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, promisifyRequest, provisionClaimSecret, provisionRefundKey, requiresMigration, resolveAssetAmount, resolveBatchExpiryPolicy, resolveCheckpointExitDelayPolicy, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, rollbackMigration, selectCoinsWithAsset, selectVirtualCoins, serializeExitPackage, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, withPrevTxs } from './chunk-ZRNQV6HV.js';
-export { ChainTxType, DEFAULT_VTXO_PAGE_SIZE, IndexerTxType, RestIndexerProvider, asset_exports as asset } from './chunk-4PKLULWT.js';
-export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, VHTLC, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, identityDescriptor, isCltvSatisfied, isCsvSpendable, normalizeToDescriptor, parseHDDescriptor, toXOnly } from './chunk-3R476TDV.js';
-export { ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DigestMismatchError, EventSourceUnavailableError, FetchError, Intent, MUTINYNET_EMULATOR_PUBKEY, MultisigTapscript, PrevArkTxField, PrevoutTxField, ProviderUnavailableError, REGTEST_EMULATOR_PUBKEY, RestArkProvider, ServerResponseMismatchError, SettlementEventType, TapTreeCoder, Transaction, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, assembleBtcdTaprootTree, assertAllowedSighashTypes, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, decodeTapscript, defaultEmulatorPubkey, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, hasTerminalSpend, isArkError, isEventSourceUnavailableError, isExpired, isPastExpiry, isRecoverable, isRetryableProviderError, isSpendable, isVirtualCoin, maybeArkError, networkFromArkadeInfo, networks, resolveEmulatorPubkey, resolveEventSource, scriptFromTapLeafScript, sdkVersion, sequenceToTimelock, setArkPsbtField, timelockToSequence } from './chunk-ISO4TI5J.js';
-import './chunk-NSBPE2FW.js';
+export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, AbortError, ActivityRegistry, AmbiguousRouteError, ArkNote, ArkadeCash, ArkadeCashCreateError, AssetManager, BIP21, BIP21Error, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, CachingArkProvider, ChainedTxType, ConnectionDisposedError, ContractManager, ContractWatcher, DEFAULT_MESSAGE_TIMEOUTS, DEFAULT_MIN_BATCH_EXPIRY_SECONDS, DEFAULT_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, DatabaseUpgradeBlockedError, DelegateManagerImpl, DelegateNotConfiguredError, DescriptorIdentity, DescriptorSigningProviderMissingError, DustChangeError, ELECTRUM_TCP_HOST, ELECTRUM_WS_URL, ESPLORA_URL, ElectrumOnchainProvider, EmulatorPacket, EsploraProvider, Estimator, Extension, ExtensionNotFoundError, ForeignDescriptorError, HDDescriptorProvider, INTENT_TERMINAL_STATES, InMemoryContractRepository, InMemoryIntentRepository, InMemoryVirtualTxRepository, InMemoryWalletRepository, IndexedDBContractRepository, IndexedDBIntentRepository, IndexedDBVirtualTxRepository, IndexedDBWalletRepository, KeyringDescriptorProvider, MAX_PAGE_SIZE, MAX_USED_SIGNING_DESCRIPTORS_LOOK_AHEAD, MESSAGE_BUS_INITIALIZING, MESSAGE_BUS_NOT_INITIALIZED, MUTINYNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, OversizedChangeError, P2A, PaymentRouter, PrevTxUnavailableError, REGTEST_MIN_BATCH_EXPIRY_SECONDS, REGTEST_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestEmulatorProvider, SIGNET_MIN_CHECKPOINT_EXIT_DELAY_SECONDS, SeedIdentity, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, StaticDescriptorProvider, TxTree, TxType, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, VtxoManager, Wallet, WalletCannotAllocateAddressError, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, arkade_exports as arkade, assertFinalCommitmentMatchesValidated, assertNoAssets, assertNoSelection, assertPageRequest, assertRecipientArkadeAddress, assertSendableAmount, assertSubmittedArkTxid, assertValidBatchExpiry, assertValidServerUnrollScript, assetMintResolver, assetsOf, attachPrevArkTxs, attachPrevoutTxs, awaitTransaction, boardingResolver, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, claimWithPreimageIdentity, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, collabExitResolver, collectContracts, collectIntents, collectPages, collectScriptVtxos, collectTransactionHistory, collectUtxos, collectVtxos, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultActivityRegistry, createDefaultPaymentRouter, createExitChainResolver, createManagedConnection, decodeArkContract, defaultBatchExpiryPolicy, defaultCheckpointExitDelayPolicy, deleteByIndex, deserializeExitPackage, encodeArkContract, exitObserverFor, gateExclusion, gatedContracts, getAllByIndexValues, getRandomId, hasBoardingTxExpired, hasCandidates, invoiceTarget, isAddressAllocationCapable, isArkContract, isBatchSignable, isBtcAddress, isContractGenericallySpendable, isContractVtxoEvent, isCooperativelyMigratable, isDeterministicSigner, isDiscoverable, isHDAllocationCapable, isHDDeterministicSignCapable, isHDWalletCapable, isLightningInvoice, isLnurl, isMessageBusInitializingError, isMessageBusNotInitializedError, isPerArtifactDescriptor, isSigningIdentity, isSubdust, isTerminalIntentState, isValidArkAddress, isVtxoExpiringSoon, iteratePages, logExcludedVtxos, makeHandle, matchServerCheckpoints, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, pageResult, promisifyRequest, provisionClaimSecret, provisionRefundKey, registerWalletRestoreHook, resolveAssetAmount, resolveBatchExpiryPolicy, resolveCheckpointExitDelayPolicy, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, selectCoinsWithAsset, selectVirtualCoins, selectionOf, serializeExitPackage, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, walletFeeSource, withPrevTxs } from './chunk-O2ZZD5Z6.js';
+export { ChainTxType, DEFAULT_VTXO_PAGE_SIZE, IndexerTxType, RestIndexerProvider, asset_exports as asset } from './chunk-AARSVV3S.js';
+export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, VHTLC, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, identityDescriptor, isCltvSatisfied, isCsvSpendable, normalizeToDescriptor, parseHDDescriptor, toXOnly } from './chunk-TIVYJIIX.js';
+export { ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DigestMismatchError, EventSourceUnavailableError, FetchError, Intent, MUTINYNET_EMULATOR_PUBKEY, MultisigTapscript, PrevArkTxField, PrevoutTxField, ProviderUnavailableError, READ_TIMEOUT_MS, REGTEST_EMULATOR_PUBKEY, RestArkProvider, ServerResponseMismatchError, SettlementEventType, TapTreeCoder, Transaction, VtxoScript, VtxoTaprootTree, VtxoTreeExpiry, assembleBtcdTaprootTree, assertAllowedSighashTypes, assertNonNegativeMs, assertTimerMs, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, decodeTapscript, defaultEmulatorPubkey, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, isArkError, isEventSourceUnavailableError, isPastExpiry, isRetryableProviderError, isVirtualCoin, isVtxoSpent, maybeArkError, networkFromArkadeInfo, networks, resolveEmulatorPubkey, resolveEventSource, scriptFromTapLeafScript, sdkVersion, sequenceToTimelock, setArkPsbtField, timelockToSequence } from './chunk-NR4XYTN3.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/repositories/realm/index.cjs

@@ -1,10 +1,9 @@
 'use strict';
 
-var chunkGMZZQXV5_cjs = require('../../chunk-GMZZQXV5.cjs');
-require('../../chunk-NVZJSKZS.cjs');
-require('../../chunk-43FKNLX4.cjs');
-require('../../chunk-JZWLXNHV.cjs');
-require('../../chunk-5BLDMQED.cjs');
+var chunkQARA4IYT_cjs = require('../../chunk-QARA4IYT.cjs');
+require('../../chunk-P42MGA4K.cjs');
+require('../../chunk-5SLUXXWQ.cjs');
+var chunkT6N6B7HK_cjs = require('../../chunk-T6N6B7HK.cjs');
 
 // src/repositories/realm/walletRepository.ts
 var RealmWalletRepository = class {
@@ -12,7 +11,7 @@ var RealmWalletRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 1;
+  version = 2;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -29,16 +28,14 @@ var RealmWalletRepository = class {
     });
   }
   // ── VTXO management ────────────────────────────────────────────────
-  async getVtxos(address) {
-    await this.ensureInit();
-    const results = this.realm.objects("ArkVtxo").filtered("address == $0", address);
-    return [...results].map(vtxoObjectToDomain);
+  async getVtxosPage(address, page) {
+    return this.pageByAddress("ArkVtxo", address, page, vtxoObjectToDomain);
   }
   async saveVtxos(address, vtxos) {
     await this.ensureInit();
     this.realm.write(() => {
       for (const vtxo of vtxos) {
-        const s = chunkGMZZQXV5_cjs.serializeVtxo(vtxo);
+        const s = chunkQARA4IYT_cjs.serializeVtxo(vtxo);
         this.realm.create(
           "ArkVtxo",
           {
@@ -53,10 +50,14 @@ var RealmWalletRepository = class {
             intentCb: s.intentTapLeafScript.cb,
             intentS: s.intentTapLeafScript.s,
             statusJson: JSON.stringify(s.status),
-            virtualStatusJson: JSON.stringify(s.virtualStatus),
-            createdAt: typeof s.createdAt === "string" ? s.createdAt : s.createdAt instanceof Date ? s.createdAt.toISOString() : new Date(s.createdAt).toISOString(),
+            createdAt: chunkQARA4IYT_cjs.createdAtToIso(s.createdAt),
             isUnrolled: s.isUnrolled ?? false,
             isSpent: s.isSpent === void 0 ? null : s.isSpent,
+            isSwept: s.isSwept === void 0 ? null : s.isSwept,
+            isPreconfirmed: s.isPreconfirmed === void 0 ? null : s.isPreconfirmed,
+            commitmentTxIdsJson: s.commitmentTxIds ? JSON.stringify(s.commitmentTxIds) : null,
+            expiresAt: s.expiresAt === void 0 ? null : new Date(s.expiresAt).toISOString(),
+            expiresAtHeight: s.expiresAtHeight ?? null,
             spentBy: s.spentBy ?? null,
             settledBy: s.settledBy ?? null,
             arkTxId: s.arkTxId ?? null,
@@ -70,48 +71,84 @@ var RealmWalletRepository = class {
     });
   }
   async deleteVtxos(address) {
-    await this.ensureInit();
-    this.realm.write(() => {
-      const toDelete = this.realm.objects("ArkVtxo").filtered("address == $0", address);
-      this.realm.delete(toDelete);
-    });
+    return this.deleteWhere("ArkVtxo", "address", address);
   }
-  async getVtxosForScript(script) {
+  async getVtxosForScriptPage(script, page, options) {
+    chunkQARA4IYT_cjs.assertPageRequest(page);
     await this.ensureInit();
-    const results = this.realm.objects("ArkVtxo").filtered("script == $0", script);
-    return [...results].map(vtxoObjectToDomain);
-  }
-  async saveVtxosForScript(key, vtxos) {
-    if (!key.address) {
-      throw new Error("RealmWalletRepository requires an address");
+    let results = this.realm.objects("ArkVtxo").filtered("script == $0", script);
+    if (options?.unspentOnly) {
+      results = results.filtered(
+        "(isSpent == null OR isSpent == $0) AND (spentBy == null OR spentBy == $1) AND (settledBy == null OR settledBy == $1)",
+        false,
+        ""
+      );
     }
-    for (const vtxo of vtxos) {
-      if (!chunkGMZZQXV5_cjs.isVtxoForScript(vtxo, key.script)) {
-        throw new Error(
-          `VTXO ${vtxo.txid}:${vtxo.vout} script mismatch: expected ${key.script}, got ${vtxo.script}`
-        );
-      }
+    if (page.after) {
+      results = results.filtered(
+        "address > $0 OR (address == $0 AND (txid > $1 OR (txid == $1 AND vout > $2)))",
+        page.after.address,
+        page.after.txid,
+        page.after.vout
+      );
     }
-    return this.saveVtxos(key.address, vtxos);
+    const rows = [];
+    for (const row of results.sorted([
+      ["address", false],
+      ["txid", false],
+      ["vout", false]
+    ])) {
+      rows.push({ address: row.address, vtxo: vtxoObjectToDomain(row) });
+      if (rows.length > page.limit) break;
+    }
+    const result = chunkQARA4IYT_cjs.pageResult(rows, page.limit, (row) => ({
+      address: row.address,
+      txid: row.vtxo.txid,
+      vout: row.vtxo.vout
+    }));
+    return options?.unspentOnly ? { ...result, items: result.items.filter((row) => !chunkT6N6B7HK_cjs.isVtxoSpent(row.vtxo)) } : result;
+  }
+  async saveVtxosForScript(key, vtxos) {
+    return this.saveVtxos(chunkQARA4IYT_cjs.checkSaveVtxosForScript("RealmWalletRepository", key, vtxos), vtxos);
   }
   async deleteVtxosForScript(script) {
-    await this.ensureInit();
-    this.realm.write(() => {
-      const toDelete = this.realm.objects("ArkVtxo").filtered("script == $0", script);
-      this.realm.delete(toDelete);
-    });
+    return this.deleteWhere("ArkVtxo", "script", script);
   }
   // ── UTXO management ────────────────────────────────────────────────
-  async getUtxos(address) {
+  async getUtxosPage(address, page) {
+    return this.pageByAddress("ArkUtxo", address, page, utxoObjectToDomain);
+  }
+  async pageByAddress(schema, address, page, deserialize) {
+    chunkQARA4IYT_cjs.assertPageRequest(page);
     await this.ensureInit();
-    const results = this.realm.objects("ArkUtxo").filtered("address == $0", address);
-    return [...results].map(utxoObjectToDomain);
+    let results = this.realm.objects(schema).filtered("address == $0", address);
+    if (page.after) {
+      results = results.filtered(
+        "txid > $0 OR (txid == $0 AND vout > $1)",
+        page.after.txid,
+        page.after.vout
+      );
+    }
+    const rows = [];
+    for (const row of results.sorted([
+      ["txid", false],
+      ["vout", false]
+    ])) {
+      rows.push({ key: { txid: row.txid, vout: row.vout }, item: deserialize(row) });
+      if (rows.length > page.limit) break;
+    }
+    const result = chunkQARA4IYT_cjs.pageResult(rows, page.limit, (row) => row.key);
+    return { items: result.items.map((row) => row.item), nextCursor: result.nextCursor };
   }
-  async saveUtxos(address, utxos) {
+  async saveUtxos(addressOrBatch, utxos) {
     await this.ensureInit();
+    const rows = chunkQARA4IYT_cjs.utxoEntries(addressOrBatch, utxos).flatMap(
+      ([address, list]) => list.map((utxo) => ({ address, utxo }))
+    );
+    if (rows.length === 0) return;
     this.realm.write(() => {
-      for (const utxo of utxos) {
-        const s = chunkGMZZQXV5_cjs.serializeUtxo(utxo);
+      for (const { address, utxo } of rows) {
+        const s = chunkQARA4IYT_cjs.serializeUtxo(utxo);
         this.realm.create(
           "ArkUtxo",
           {
@@ -134,19 +171,31 @@ var RealmWalletRepository = class {
     });
   }
   async deleteUtxos(address) {
-    await this.ensureInit();
-    this.realm.write(() => {
-      const toDelete = this.realm.objects("ArkUtxo").filtered("address == $0", address);
-      this.realm.delete(toDelete);
-    });
+    return this.deleteWhere("ArkUtxo", "address", address);
   }
   // ── Transaction history ────────────────────────────────────────────
-  async getTransactionHistory(address) {
-    await this.ensureInit();
-    const results = this.realm.objects("ArkTransaction").filtered("address == $0", address);
-    const txs = [...results].map(txObjectToDomain);
-    txs.sort((a, b) => a.createdAt - b.createdAt);
-    return txs;
+  async getTransactionHistoryPage(filter, page) {
+    chunkQARA4IYT_cjs.assertPageRequest(page);
+    chunkQARA4IYT_cjs.assertHistoryPageFilter(filter);
+    let results = this.realm.objects("ArkTransaction").filtered("address == $0", filter.address);
+    results = results.filtered(
+      "createdAt >= $0",
+      Math.max(filter.since ?? 0, page.after?.createdAt ?? 0)
+    );
+    const rows = [];
+    for (const row of results.sorted([
+      ["createdAt", false],
+      ["boardingTxid", false],
+      ["commitmentTxid", false],
+      ["arkTxid", false]
+    ])) {
+      const tx = txObjectToDomain(row);
+      if (page.after !== void 0 && chunkQARA4IYT_cjs.compareHistoryCursors({ createdAt: tx.createdAt, key: tx.key }, page.after) <= 0)
+        continue;
+      rows.push(tx);
+      if (rows.length > page.limit) break;
+    }
+    return chunkQARA4IYT_cjs.pageResult(rows, page.limit, (tx) => ({ createdAt: tx.createdAt, key: tx.key }));
   }
   async saveTransactions(address, txs) {
     await this.ensureInit();
@@ -164,7 +213,7 @@ var RealmWalletRepository = class {
             amount: tx.amount,
             settled: tx.settled,
             createdAt: tx.createdAt,
-            assetsJson: tx.assets ? JSON.stringify(chunkGMZZQXV5_cjs.serializeAssets(tx.assets)) : null
+            assetsJson: tx.assets ? JSON.stringify(chunkQARA4IYT_cjs.serializeAssets(tx.assets)) : null
           },
           "modified"
         );
@@ -172,9 +221,12 @@ var RealmWalletRepository = class {
     });
   }
   async deleteTransactions(address) {
+    return this.deleteWhere("ArkTransaction", "address", address);
+  }
+  async deleteWhere(objectType, field, value) {
     await this.ensureInit();
     this.realm.write(() => {
-      const toDelete = this.realm.objects("ArkTransaction").filtered("address == $0", address);
+      const toDelete = this.realm.objects(objectType).filtered(`${field} == $0`, value);
       this.realm.delete(toDelete);
     });
   }
@@ -222,10 +274,14 @@ function vtxoObjectToDomain(obj) {
       s: obj.intentS
     },
     status: JSON.parse(obj.statusJson),
-    virtualStatus: JSON.parse(obj.virtualStatusJson),
     createdAt: new Date(obj.createdAt),
     isUnrolled: obj.isUnrolled,
     isSpent: obj.isSpent === null ? void 0 : obj.isSpent,
+    isSwept: obj.isSwept == null ? void 0 : obj.isSwept,
+    isPreconfirmed: obj.isPreconfirmed == null ? void 0 : obj.isPreconfirmed,
+    commitmentTxIds: obj.commitmentTxIdsJson ? JSON.parse(obj.commitmentTxIdsJson) : void 0,
+    expiresAt: obj.expiresAt ? new Date(obj.expiresAt) : void 0,
+    expiresAtHeight: obj.expiresAtHeight ?? void 0,
     spentBy: obj.spentBy ?? void 0,
     settledBy: obj.settledBy ?? void 0,
     arkTxId: obj.arkTxId ?? void 0,
@@ -234,9 +290,9 @@ function vtxoObjectToDomain(obj) {
     // Post-migration every row has `script`, but the backfill is
     // idempotent: derive from `address` if the legacy column is still
     // null (e.g. the migration hasn't run yet on this handle).
-    script: obj.script ?? chunkGMZZQXV5_cjs.scriptFromArkAddress(obj.address)
+    script: obj.script ?? chunkQARA4IYT_cjs.scriptFromArkAddress(obj.address)
   };
-  return chunkGMZZQXV5_cjs.deserializeVtxo(serialized);
+  return chunkQARA4IYT_cjs.deserializeVtxo(serialized);
 }
 function utxoObjectToDomain(obj) {
   const serialized = {
@@ -255,7 +311,7 @@ function utxoObjectToDomain(obj) {
     status: JSON.parse(obj.statusJson),
     extraWitness: obj.extraWitnessJson ? JSON.parse(obj.extraWitnessJson) : void 0
   };
-  return chunkGMZZQXV5_cjs.deserializeUtxo(serialized);
+  return chunkQARA4IYT_cjs.deserializeUtxo(serialized);
 }
 function txObjectToDomain(obj) {
   const tx = {
@@ -270,7 +326,7 @@ function txObjectToDomain(obj) {
     createdAt: obj.createdAt
   };
   if (obj.assetsJson) {
-    tx.assets = chunkGMZZQXV5_cjs.deserializeAssets(JSON.parse(obj.assetsJson));
+    tx.assets = chunkQARA4IYT_cjs.deserializeAssets(JSON.parse(obj.assetsJson));
   }
   return tx;
 }
@@ -281,7 +337,7 @@ var RealmContractRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 2;
+  version = 3;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -295,41 +351,47 @@ var RealmContractRepository = class {
     });
   }
   // ── Contract management ────────────────────────────────────────────
-  async getContracts(filter) {
-    await this.ensureInit();
+  async getContractsPage(filter, page) {
+    chunkQARA4IYT_cjs.assertPageRequest(page);
+    if (chunkQARA4IYT_cjs.contractFilterMatchesNothing(filter)) return { items: [] };
+    const toPage = (rows) => chunkQARA4IYT_cjs.pageResult(rows.map(contractObjectToDomain), page.limit, (contract) => contract.script);
+    if (filter?.watch === void 0 || filter.script !== void 0) {
+      return toPage(this.readRows(filter, page));
+    }
+    const merged = [...new Set([filter.watch].flat())].flatMap((state) => state === "watched" ? [state, null] : [state]).flatMap(
+      (state) => state === "retained" ? this.readRows({ ...filter, watch: state }, page) : this.readRows({ ...filter, watch: void 0 }, page, state)
+    ).map((row) => ({ script: row.script, row })).sort((a, b) => a.script < b.script ? -1 : a.script > b.script ? 1 : 0);
+    return toPage(merged.slice(0, page.limit + 1).map(({ row }) => row));
+  }
+  /** Up to `limit + 1` rows in script order, led by `watch == leadingWatch` when one is given. */
+  readRows(filter, page, leadingWatch) {
     let results = this.realm.objects("ArkContract");
+    const parts = [];
+    const args = [];
+    let argIndex = 0;
     if (filter) {
-      const filterParts = [];
-      const filterArgs = [];
-      let argIndex = 0;
-      argIndex = this.addFilterCondition(
-        filterParts,
-        filterArgs,
-        "script",
-        filter.script,
-        argIndex
-      );
-      argIndex = this.addFilterCondition(
-        filterParts,
-        filterArgs,
-        "state",
-        filter.state,
-        argIndex
-      );
-      argIndex = this.addFilterCondition(
-        filterParts,
-        filterArgs,
-        "type",
-        filter.type,
-        argIndex
-      );
-      argIndex = this.addWatchCondition(filterParts, filterArgs, filter.watch, argIndex);
-      if (filterParts.length > 0) {
-        const query = filterParts.join(" AND ");
-        results = results.filtered(query, ...filterArgs);
-      }
+      argIndex = this.addFilterCondition(parts, args, "script", filter.script, argIndex);
+      argIndex = this.addFilterCondition(parts, args, "state", filter.state, argIndex);
+      argIndex = this.addFilterCondition(parts, args, "type", filter.type, argIndex);
+      argIndex = this.addWatchCondition(parts, args, filter.watch, argIndex);
+    }
+    if (page.after !== void 0) {
+      parts.push(`script > $${argIndex}`);
+      args.push(page.after);
     }
-    return [...results].map(contractObjectToDomain);
+    let query = parts.join(" AND ");
+    if (leadingWatch !== void 0) {
+      const lead = leadingWatch === null ? "watch == null" : `watch == $${args.length}`;
+      if (leadingWatch !== null) args.push(leadingWatch);
+      query = query ? `${lead} AND (${query})` : lead;
+    }
+    if (query) results = results.filtered(query, ...args);
+    const rows = [];
+    for (const row of results.sorted("script")) {
+      rows.push(row);
+      if (rows.length > page.limit) break;
+    }
+    return rows;
   }
   async saveContract(contract) {
     await this.ensureInit();
@@ -450,7 +512,7 @@ var RealmIntentRepository = class {
         const clashes = [
           ...this.realm.objects("ArkIntent").filtered("intentId == $0", intent.intentId)
         ].map(toIntent);
-        chunkGMZZQXV5_cjs.assertIntentIdUnique(intent, clashes);
+        chunkQARA4IYT_cjs.assertIntentIdUnique(intent, clashes);
       }
       this.realm.create(
         "ArkIntent",
@@ -477,16 +539,23 @@ var RealmIntentRepository = class {
       );
     });
   }
-  async getIntents(filter) {
-    const all = [...this.realm.objects("ArkIntent")].map(toIntent).sort((a, b) => a.createdAt - b.createdAt || a.intentTxId.localeCompare(b.intentTxId));
-    const out = filter ? all.filter((i) => chunkGMZZQXV5_cjs.intentMatchesFilter(i, filter)) : all;
-    const { skip, end } = chunkGMZZQXV5_cjs.intentPageBounds(filter, out.length);
-    return out.slice(skip, end);
+  async getIntentsPage(filter, page) {
+    chunkQARA4IYT_cjs.assertPageRequest(page);
+    let results = this.realm.objects("ArkIntent");
+    if (page.after !== void 0) results = results.filtered("intentTxId > $0", page.after);
+    const rows = [];
+    for (const row of results.sorted("intentTxId")) {
+      const intent = toIntent(row);
+      if (filter && !chunkQARA4IYT_cjs.intentMatchesFilter(intent, filter)) continue;
+      rows.push(intent);
+      if (rows.length > page.limit) break;
+    }
+    return chunkQARA4IYT_cjs.pageResult(rows, page.limit, (intent) => intent.intentTxId);
   }
   async getLockedVtxoOutpoints() {
     const out = [];
     for (const o of [...this.realm.objects("ArkIntent")].map(toIntent))
-      if (!chunkGMZZQXV5_cjs.isTerminalIntentState(o.state)) out.push(...o.intentVtxos);
+      if (!chunkQARA4IYT_cjs.isTerminalIntentState(o.state)) out.push(...o.intentVtxos);
     return out;
   }
   async [Symbol.asyncDispose]() {
@@ -528,7 +597,7 @@ var RealmVirtualTxRepository = class {
             txid: t.txid,
             psbt: t.psbt ?? prev?.psbt ?? null,
             expiresAt: t.expiresAt ?? prev?.expiresAt ?? null,
-            type: chunkGMZZQXV5_cjs.mergeChainedTxType(t.type, prev?.type)
+            type: chunkQARA4IYT_cjs.mergeChainedTxType(t.type, prev?.type)
           },
           "modified"
         );
@@ -619,7 +688,6 @@ var ArkVtxoSchema = {
     intentS: "string",
     extraWitnessJson: "string?",
     statusJson: "string",
-    virtualStatusJson: "string",
     spentBy: "string?",
     settledBy: "string?",
     arkTxId: "string?",
@@ -627,6 +695,12 @@ var ArkVtxoSchema = {
     // ISO 8601
     isUnrolled: "bool",
     isSpent: "bool?",
+    isSwept: "bool?",
+    isPreconfirmed: "bool?",
+    commitmentTxIdsJson: "string?",
+    expiresAt: "string?",
+    // ISO 8601
+    expiresAtHeight: "int?",
     assetsJson: "string?",
     // scriptPubKey (hex) locking this VTXO, indexed so contract-scoped
     // queries can resolve ownership without touching address mapping.
@@ -756,13 +830,34 @@ var ArkExperimentalRealmSchemas = [
   ArkVirtualTxSchema,
   ArkVtxoBranchSchema
 ];
-var ARK_REALM_SCHEMA_VERSION = 3;
+var ARK_REALM_SCHEMA_VERSION = 5;
 function runArkRealmMigrations(oldRealm, newRealm) {
+  const legacyByPk = /* @__PURE__ */ new Map();
+  const oldVtxos = oldRealm?.objects?.("ArkVtxo") ?? [];
+  for (let i = 0; i < oldVtxos.length; i++) {
+    const raw = oldVtxos[i].virtualStatusJson;
+    if (raw) legacyByPk.set(oldVtxos[i].pk, raw);
+  }
   const newVtxos = newRealm.objects("ArkVtxo");
   for (let i = 0; i < newVtxos.length; i++) {
     const newVtxo = newVtxos[i];
     if (!newVtxo.script) {
-      newVtxo.script = chunkGMZZQXV5_cjs.scriptFromArkAddress(newVtxo.address);
+      newVtxo.script = chunkQARA4IYT_cjs.scriptFromArkAddress(newVtxo.address);
+    }
+    const facts = chunkQARA4IYT_cjs.legacyVtxoFacts(legacyByPk.get(newVtxo.pk));
+    if (facts) {
+      if (newVtxo.isSpent == null) newVtxo.isSpent = facts.isSpent;
+      if (newVtxo.isSwept == null) newVtxo.isSwept = facts.isSwept;
+      if (newVtxo.isPreconfirmed == null) newVtxo.isPreconfirmed = facts.isPreconfirmed;
+      if (newVtxo.commitmentTxIdsJson == null && facts.commitmentTxIds) {
+        newVtxo.commitmentTxIdsJson = JSON.stringify(facts.commitmentTxIds);
+      }
+      if (newVtxo.expiresAt == null && facts.expiresAt) {
+        newVtxo.expiresAt = facts.expiresAt.toISOString();
+      }
+      if (newVtxo.expiresAtHeight == null && facts.expiresAtHeight !== void 0) {
+        newVtxo.expiresAtHeight = facts.expiresAtHeight;
+      }
     }
   }
   const oldHasVirtualTx = Array.isArray(oldRealm?.schema) && oldRealm.schema.some((s) => s.name === "ArkVirtualTx");
@@ -779,7 +874,7 @@ function runArkRealmMigrations(oldRealm, newRealm) {
 
 Object.defineProperty(exports, "ChainedTxType", {
   enumerable: true,
-  get: function () { return chunkGMZZQXV5_cjs.ChainedTxType; }
+  get: function () { return chunkQARA4IYT_cjs.ChainedTxType; }
 });
 exports.ARK_REALM_SCHEMA_VERSION = ARK_REALM_SCHEMA_VERSION;
 exports.ArkExperimentalRealmSchemas = ArkExperimentalRealmSchemas;