@arkade-os/sdk 0.5.0-rc.8 → 0.5.0

package/dist/repositories/realm/index.js

@@ -1,8 +1,8 @@
-import { serializeVtxo, isVtxoForScript, serializeUtxo, serializeAssets, scriptFromArkAddress, deserializeVtxo, deserializeUtxo, deserializeAssets, assertIntentIdUnique, intentMatchesFilter, intentPageBounds, isTerminalIntentState, mergeChainedTxType, legacyVtxoFacts } from '../../chunk-LN4ZJZK4.js';
-export { ChainedTxType } from '../../chunk-LN4ZJZK4.js';
-import '../../chunk-G6S4XSFI.js';
-import '../../chunk-XCNAGBFR.js';
-import '../../chunk-MTYQXZ2T.js';
+import { serializeVtxo, createdAtToIso, assertPageRequest, pageResult, checkSaveVtxosForScript, utxoEntries, serializeUtxo, assertHistoryPageFilter, compareHistoryCursors, serializeAssets, scriptFromArkAddress, deserializeVtxo, deserializeUtxo, deserializeAssets, contractFilterMatchesNothing, assertIntentIdUnique, intentMatchesFilter, isTerminalIntentState, mergeChainedTxType, legacyVtxoFacts } from '../../chunk-GWJWXVUB.js';
+export { ChainedTxType } from '../../chunk-GWJWXVUB.js';
+import '../../chunk-HABGVRLF.js';
+import '../../chunk-K352GMVL.js';
+import { isVtxoSpent } from '../../chunk-ZOEB53NQ.js';
 
 // src/repositories/realm/walletRepository.ts
 var RealmWalletRepository = class {
@@ -10,7 +10,7 @@ var RealmWalletRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 1;
+  version = 2;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -27,10 +27,8 @@ 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();
@@ -51,13 +49,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: 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,
@@ -72,47 +70,83 @@ 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) {
+    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 (!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 = 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) => !isVtxoSpent(row.vtxo)) } : result;
+  }
+  async saveVtxosForScript(key, vtxos) {
+    return this.saveVtxos(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) {
+    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 = 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 = utxoEntries(addressOrBatch, utxos).flatMap(
+      ([address, list]) => list.map((utxo) => ({ address, utxo }))
+    );
+    if (rows.length === 0) return;
     this.realm.write(() => {
-      for (const utxo of utxos) {
+      for (const { address, utxo } of rows) {
         const s = serializeUtxo(utxo);
         this.realm.create(
           "ArkUtxo",
@@ -136,19 +170,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) {
+    assertPageRequest(page);
+    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 && compareHistoryCursors({ createdAt: tx.createdAt, key: tx.key }, page.after) <= 0)
+        continue;
+      rows.push(tx);
+      if (rows.length > page.limit) break;
+    }
+    return pageResult(rows, page.limit, (tx) => ({ createdAt: tx.createdAt, key: tx.key }));
   }
   async saveTransactions(address, txs) {
     await this.ensureInit();
@@ -174,9 +220,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);
     });
   }
@@ -287,7 +336,7 @@ var RealmContractRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 2;
+  version = 3;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -301,41 +350,47 @@ var RealmContractRepository = class {
     });
   }
   // ── Contract management ────────────────────────────────────────────
-  async getContracts(filter) {
-    await this.ensureInit();
+  async getContractsPage(filter, page) {
+    assertPageRequest(page);
+    if (contractFilterMatchesNothing(filter)) return { items: [] };
+    const toPage = (rows) => 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();
@@ -483,11 +538,18 @@ 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) => intentMatchesFilter(i, filter)) : all;
-    const { skip, end } = intentPageBounds(filter, out.length);
-    return out.slice(skip, end);
+  async getIntentsPage(filter, page) {
+    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 && !intentMatchesFilter(intent, filter)) continue;
+      rows.push(intent);
+      if (rows.length > page.limit) break;
+    }
+    return pageResult(rows, page.limit, (intent) => intent.intentTxId);
   }
   async getLockedVtxoOutpoints() {
     const out = [];