@arkade-os/sdk 0.5.0-rc.9 → 0.5.1

package/dist/index.js

@@ -1,6 +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, 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, 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, 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, TxTree, TxType, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, VtxoManager, Wallet, WalletCannotAllocateAddressError, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, 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, 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, logExcludedVtxos, makeHandle, matchServerCheckpoints, notifyExitObserved, onchainRail, openDatabase, outpointExclusion, outpointReasons, promisifyRequest, provisionClaimSecret, provisionRefundKey, registerWalletRestoreHook, resolveAssetAmount, resolveBatchExpiryPolicy, resolveCheckpointExitDelayPolicy, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, selectCoinsWithAsset, selectVirtualCoins, serializeExitPackage, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, walletFeeSource, withPrevTxs } from './chunk-3TCWQPAC.js';
-export { ChainTxType, DEFAULT_VTXO_PAGE_SIZE, IndexerTxType, RestIndexerProvider, asset_exports as asset } from './chunk-J2K7WWMJ.js';
-export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, VHTLC, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, identityDescriptor, isCltvSatisfied, isCsvSpendable, normalizeToDescriptor, parseHDDescriptor, toXOnly } from './chunk-R4KRWX7R.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, buildVersion, canRecoverOnchain, canSpendOffchain, canSweepOnchain, configureEventSource, decodeTapscript, defaultEmulatorPubkey, getAllNormalizedVtxos, getArkPsbtFields, getConfiguredEventSource, getNetwork, getNormalizedVtxos, getSequence, hasTerminalSpend, isArkError, isEventSourceUnavailableError, isPastExpiry, isRetryableProviderError, isVirtualCoin, maybeArkError, networkFromArkadeInfo, networks, resolveEmulatorPubkey, resolveEventSource, scriptFromTapLeafScript, sdkVersion, sequenceToTimelock, setArkPsbtField, timelockToSequence } from './chunk-JFZBKPSV.js';
+export { ARKADE_MAGIC, ARKADE_SALTED_PREIMAGE_TAG, ARKADE_SWAP_PREIMAGE_TAG, ASSET_CARRIER_SATS, AbortError, ActivityRegistry, AmbiguousRouteError, ArkNote, Arkade, ArkadeCash, ArkadeCashCreateError, ArkadeCashOperatorMismatchError, AssetManager, BIP21, BIP21Error, BIP322, BLOCKED_UPGRADE_TIMEOUT_MS, Batch, CachingArkProvider, ChainedTxType, ConnectionDisposedError, ContractManager, ContractWatcher, DEFAULT_MESSAGE_TIMEOUTS, DEFAULT_MIN_BATCH_EXPIRY_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, MessageBus, MessageBusInitializingError, MessageBusNotInitializedError, MissingSigningDescriptorError, MnemonicIdentity, OnchainWallet, OversizedChangeError, P2A, PaymentRouter, PrevTxUnavailableError, REGTEST_MIN_BATCH_EXPIRY_SECONDS, Ramps, ReadonlyAssetManager, ReadonlyDescriptorIdentity, ReadonlySingleKey, ReadonlyWallet, ReadonlyWalletError, RestDelegateProvider, RestEmulatorProvider, SeedIdentity, SendDeadlineExceededError, ServiceWorkerReadonlyWallet, ServiceWorkerTimeoutError, ServiceWorkerWallet, SingleKey, StaticDescriptorProvider, TxTree, TxType, TxWeightEstimator, UnannotatableInputError, UnilateralExit, UnknownPacket, Unroll, VtxoManager, VtxoReservedError, Wallet, WalletCannotAllocateAddressError, WalletCannotSignError, WalletMessageHandler, WalletNotInitializedError, WsElectrumChainSource, adoptContractDescriptor, arkAssetRail, arkRail, arkTarget, arkade_exports as arkade, assertFinalCommitmentMatchesValidated, assertNoAssets, assertNoSelection, assertPageRequest, assertRecipientArkadeAddress, assertSendDeadline, assertSendableAmount, assertSubmittedArkTxid, assertValidBatchExpiry, assertValidServerUnrollScript, assetMintResolver, assetsOf, attachPrevArkTxs, attachPrevoutTxs, awaitTransaction, boardingResolver, btcTarget, buildForfeitTx, buildOffchainTx, buildPreimageMessage, buildSaltedPreimageMessage, captureSendDeadline, claimWithPreimageIdentity, classifyAgainstSignerSet, classifyContractSigner, closeDatabase, collabExitResolver, collectContracts, collectIntents, collectPages, collectScriptVtxos, collectTransactionHistory, collectUtxos, collectVtxos, combineTapscriptSigs, contractFromArkContract, contractFromArkContractWithAddress, contractPreimage, contractSigner, createAssetPacket, createDefaultActivityRegistry, createDefaultPaymentRouter, createExitChainResolver, createManagedConnection, decodeArkContract, defaultBatchExpiryPolicy, 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, resolveDescriptorSigner, resolvePrevTxs, resolveSendAmount, selectCoinsWithAsset, selectVirtualCoins, selectionOf, serializeExitPackage, setupServiceWorker, signAndSubmitOffchainTx, signerSetFromInfo, signingDescriptorIndex, strictSigningDescriptorIndex, submitViaEmulator, toXOnlySignerHex, tryResolveSendAmount, validateBatchRecipients, validateConnectorsTxGraph, validateVtxoTxGraph, verifyTapscriptSignatures, waitForIncomingFunds, walletFeeSource, withPrevTxs } from './chunk-NKKJEA3Z.js';
+export { ChainTxType, DEFAULT_VTXO_PAGE_SIZE, IndexerTxType, RestIndexerProvider, asset_exports as asset } from './chunk-6MIGYYWB.js';
+export { ArkadeContractHandler, BoardingContractHandler, DefaultContractHandler, DefaultVtxo, DelegateContractHandler, DelegateVtxo, UnsupportedProgramVersionError, VHTLC, VHTLCContractHandler, VHTLCV2ContractHandler, contractHandlers, deriveDescriptorLeafCompressedPubKey, deriveDescriptorLeafPubKey, identityDescriptor, isCltvSatisfied, isCsvSpendable, normalizeToDescriptor, parseHDDescriptor, toXOnly } from './chunk-3M22PJVB.js';
+export { ArkAddress, ArkError, ArkErrorName, ArkPsbtFieldKey, ArkPsbtFieldKeyType, BITCOIN_EMULATOR_PUBKEY, CLTVMultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, ConditionWitness, CosignerPublicKey, DEFAULT_ARKADE_EMULATOR_URL, 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, toOffchainInputFeeParams } from './chunk-QFB55EOZ.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/repositories/realm/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkPKD5VPYX_cjs = require('../../chunk-PKD5VPYX.cjs');
-require('../../chunk-V4JZOFYT.cjs');
-require('../../chunk-VMVHRKXM.cjs');
-require('../../chunk-VTXMC4N7.cjs');
+var chunkQKNSMVBW_cjs = require('../../chunk-QKNSMVBW.cjs');
+require('../../chunk-HQNQ3CLQ.cjs');
+require('../../chunk-GW42FS2X.cjs');
+var chunkXLHUGP3G_cjs = require('../../chunk-XLHUGP3G.cjs');
 
 // src/repositories/realm/walletRepository.ts
 var RealmWalletRepository = class {
@@ -11,7 +11,7 @@ var RealmWalletRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 1;
+  version = 2;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -28,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 = chunkPKD5VPYX_cjs.serializeVtxo(vtxo);
+        const s = chunkQKNSMVBW_cjs.serializeVtxo(vtxo);
         this.realm.create(
           "ArkVtxo",
           {
@@ -52,13 +50,13 @@ var RealmWalletRepository = class {
             intentCb: s.intentTapLeafScript.cb,
             intentS: s.intentTapLeafScript.s,
             statusJson: JSON.stringify(s.status),
-            createdAt: typeof s.createdAt === "string" ? s.createdAt : s.createdAt instanceof Date ? s.createdAt.toISOString() : new Date(s.createdAt).toISOString(),
+            createdAt: chunkQKNSMVBW_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 : s.expiresAt instanceof Date ? s.expiresAt.toISOString() : new Date(s.expiresAt).toISOString(),
+            expiresAt: s.expiresAt === void 0 ? null : new Date(s.expiresAt).toISOString(),
             expiresAtHeight: s.expiresAtHeight ?? null,
             spentBy: s.spentBy ?? null,
             settledBy: s.settledBy ?? null,
@@ -73,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) {
+    chunkQKNSMVBW_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 (!chunkPKD5VPYX_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
+      );
+    }
+    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;
     }
-    return this.saveVtxos(key.address, vtxos);
+    const result = chunkQKNSMVBW_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) => !chunkXLHUGP3G_cjs.isVtxoSpent(row.vtxo)) } : result;
+  }
+  async saveVtxosForScript(key, vtxos) {
+    return this.saveVtxos(chunkQKNSMVBW_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) {
+    chunkQKNSMVBW_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 = chunkQKNSMVBW_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 = chunkQKNSMVBW_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 = chunkPKD5VPYX_cjs.serializeUtxo(utxo);
+      for (const { address, utxo } of rows) {
+        const s = chunkQKNSMVBW_cjs.serializeUtxo(utxo);
         this.realm.create(
           "ArkUtxo",
           {
@@ -137,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) {
+    chunkQKNSMVBW_cjs.assertPageRequest(page);
+    chunkQKNSMVBW_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 && chunkQKNSMVBW_cjs.compareHistoryCursors({ createdAt: tx.createdAt, key: tx.key }, page.after) <= 0)
+        continue;
+      rows.push(tx);
+      if (rows.length > page.limit) break;
+    }
+    return chunkQKNSMVBW_cjs.pageResult(rows, page.limit, (tx) => ({ createdAt: tx.createdAt, key: tx.key }));
   }
   async saveTransactions(address, txs) {
     await this.ensureInit();
@@ -167,7 +213,7 @@ var RealmWalletRepository = class {
             amount: tx.amount,
             settled: tx.settled,
             createdAt: tx.createdAt,
-            assetsJson: tx.assets ? JSON.stringify(chunkPKD5VPYX_cjs.serializeAssets(tx.assets)) : null
+            assetsJson: tx.assets ? JSON.stringify(chunkQKNSMVBW_cjs.serializeAssets(tx.assets)) : null
           },
           "modified"
         );
@@ -175,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);
     });
   }
@@ -241,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 ?? chunkPKD5VPYX_cjs.scriptFromArkAddress(obj.address)
+    script: obj.script ?? chunkQKNSMVBW_cjs.scriptFromArkAddress(obj.address)
   };
-  return chunkPKD5VPYX_cjs.deserializeVtxo(serialized);
+  return chunkQKNSMVBW_cjs.deserializeVtxo(serialized);
 }
 function utxoObjectToDomain(obj) {
   const serialized = {
@@ -262,7 +311,7 @@ function utxoObjectToDomain(obj) {
     status: JSON.parse(obj.statusJson),
     extraWitness: obj.extraWitnessJson ? JSON.parse(obj.extraWitnessJson) : void 0
   };
-  return chunkPKD5VPYX_cjs.deserializeUtxo(serialized);
+  return chunkQKNSMVBW_cjs.deserializeUtxo(serialized);
 }
 function txObjectToDomain(obj) {
   const tx = {
@@ -277,7 +326,7 @@ function txObjectToDomain(obj) {
     createdAt: obj.createdAt
   };
   if (obj.assetsJson) {
-    tx.assets = chunkPKD5VPYX_cjs.deserializeAssets(JSON.parse(obj.assetsJson));
+    tx.assets = chunkQKNSMVBW_cjs.deserializeAssets(JSON.parse(obj.assetsJson));
   }
   return tx;
 }
@@ -288,7 +337,7 @@ var RealmContractRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 2;
+  version = 3;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -302,41 +351,47 @@ var RealmContractRepository = class {
     });
   }
   // ── Contract management ────────────────────────────────────────────
-  async getContracts(filter) {
-    await this.ensureInit();
+  async getContractsPage(filter, page) {
+    chunkQKNSMVBW_cjs.assertPageRequest(page);
+    if (chunkQKNSMVBW_cjs.contractFilterMatchesNothing(filter)) return { items: [] };
+    const toPage = (rows) => chunkQKNSMVBW_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);
+    }
+    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;
     }
-    return [...results].map(contractObjectToDomain);
+    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();
@@ -457,7 +512,7 @@ var RealmIntentRepository = class {
         const clashes = [
           ...this.realm.objects("ArkIntent").filtered("intentId == $0", intent.intentId)
         ].map(toIntent);
-        chunkPKD5VPYX_cjs.assertIntentIdUnique(intent, clashes);
+        chunkQKNSMVBW_cjs.assertIntentIdUnique(intent, clashes);
       }
       this.realm.create(
         "ArkIntent",
@@ -484,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) => chunkPKD5VPYX_cjs.intentMatchesFilter(i, filter)) : all;
-    const { skip, end } = chunkPKD5VPYX_cjs.intentPageBounds(filter, out.length);
-    return out.slice(skip, end);
+  async getIntentsPage(filter, page) {
+    chunkQKNSMVBW_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 && !chunkQKNSMVBW_cjs.intentMatchesFilter(intent, filter)) continue;
+      rows.push(intent);
+      if (rows.length > page.limit) break;
+    }
+    return chunkQKNSMVBW_cjs.pageResult(rows, page.limit, (intent) => intent.intentTxId);
   }
   async getLockedVtxoOutpoints() {
     const out = [];
     for (const o of [...this.realm.objects("ArkIntent")].map(toIntent))
-      if (!chunkPKD5VPYX_cjs.isTerminalIntentState(o.state)) out.push(...o.intentVtxos);
+      if (!chunkQKNSMVBW_cjs.isTerminalIntentState(o.state)) out.push(...o.intentVtxos);
     return out;
   }
   async [Symbol.asyncDispose]() {
@@ -535,7 +597,7 @@ var RealmVirtualTxRepository = class {
             txid: t.txid,
             psbt: t.psbt ?? prev?.psbt ?? null,
             expiresAt: t.expiresAt ?? prev?.expiresAt ?? null,
-            type: chunkPKD5VPYX_cjs.mergeChainedTxType(t.type, prev?.type)
+            type: chunkQKNSMVBW_cjs.mergeChainedTxType(t.type, prev?.type)
           },
           "modified"
         );
@@ -780,9 +842,9 @@ function runArkRealmMigrations(oldRealm, newRealm) {
   for (let i = 0; i < newVtxos.length; i++) {
     const newVtxo = newVtxos[i];
     if (!newVtxo.script) {
-      newVtxo.script = chunkPKD5VPYX_cjs.scriptFromArkAddress(newVtxo.address);
+      newVtxo.script = chunkQKNSMVBW_cjs.scriptFromArkAddress(newVtxo.address);
     }
-    const facts = chunkPKD5VPYX_cjs.legacyVtxoFacts(legacyByPk.get(newVtxo.pk));
+    const facts = chunkQKNSMVBW_cjs.legacyVtxoFacts(legacyByPk.get(newVtxo.pk));
     if (facts) {
       if (newVtxo.isSpent == null) newVtxo.isSpent = facts.isSpent;
       if (newVtxo.isSwept == null) newVtxo.isSwept = facts.isSwept;
@@ -812,7 +874,7 @@ function runArkRealmMigrations(oldRealm, newRealm) {
 
 Object.defineProperty(exports, "ChainedTxType", {
   enumerable: true,
-  get: function () { return chunkPKD5VPYX_cjs.ChainedTxType; }
+  get: function () { return chunkQKNSMVBW_cjs.ChainedTxType; }
 });
 exports.ARK_REALM_SCHEMA_VERSION = ARK_REALM_SCHEMA_VERSION;
 exports.ArkExperimentalRealmSchemas = ArkExperimentalRealmSchemas;