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

package/dist/repositories/realm/index.js

@@ -1,9 +1,8 @@
-import { serializeVtxo, isVtxoForScript, serializeUtxo, serializeAssets, scriptFromArkAddress, deserializeVtxo, deserializeUtxo, deserializeAssets, assertIntentIdUnique, intentMatchesFilter, intentPageBounds, isTerminalIntentState, mergeChainedTxType } from '../../chunk-ZRNQV6HV.js';
-export { ChainedTxType } from '../../chunk-ZRNQV6HV.js';
-import '../../chunk-4PKLULWT.js';
-import '../../chunk-3R476TDV.js';
-import '../../chunk-ISO4TI5J.js';
-import '../../chunk-NSBPE2FW.js';
+import { serializeVtxo, createdAtToIso, assertPageRequest, pageResult, checkSaveVtxosForScript, utxoEntries, serializeUtxo, assertHistoryPageFilter, compareHistoryCursors, serializeAssets, scriptFromArkAddress, deserializeVtxo, deserializeUtxo, deserializeAssets, contractFilterMatchesNothing, assertIntentIdUnique, intentMatchesFilter, isTerminalIntentState, mergeChainedTxType, legacyVtxoFacts } from '../../chunk-O2ZZD5Z6.js';
+export { ChainedTxType } from '../../chunk-O2ZZD5Z6.js';
+import '../../chunk-AARSVV3S.js';
+import '../../chunk-TIVYJIIX.js';
+import { isVtxoSpent } from '../../chunk-NR4XYTN3.js';
 
 // src/repositories/realm/walletRepository.ts
 var RealmWalletRepository = class {
@@ -11,7 +10,7 @@ var RealmWalletRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 1;
+  version = 2;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -28,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();
@@ -52,10 +49,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: 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,
@@ -69,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
+      );
     }
-    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 = 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",
@@ -133,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();
@@ -171,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);
     });
   }
@@ -221,10 +273,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,
@@ -280,7 +336,7 @@ var RealmContractRepository = class {
     this.realm = realm;
   }
   realm;
-  version = 2;
+  version = 3;
   // ── Lifecycle ──────────────────────────────────────────────────────
   async ensureInit() {
   }
@@ -294,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);
     }
-    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();
@@ -476,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 = [];
@@ -618,7 +687,6 @@ var ArkVtxoSchema = {
     intentS: "string",
     extraWitnessJson: "string?",
     statusJson: "string",
-    virtualStatusJson: "string",
     spentBy: "string?",
     settledBy: "string?",
     arkTxId: "string?",
@@ -626,6 +694,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.
@@ -755,14 +829,35 @@ 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 = scriptFromArkAddress(newVtxo.address);
     }
+    const facts = 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");
   if (oldHasVirtualTx) {