@arkade-os/sdk 0.5.0-rc.11 → 0.5.0-rc.13

package/dist/repositories/sqlite/index.js

@@ -1,8 +1,8 @@
-import { scriptFromArkAddress, legacyVtxoFacts, serializeVtxo, isVtxoForScript, serializeUtxo, serializeAssets, deserializeVtxo, deserializeUtxo, deserializeAssets, intentMatchesFilter, intentPageBounds, isTerminalIntentState, mergeChainedTxType } from '../../chunk-M2ZUPLKQ.js';
-export { ChainedTxType } from '../../chunk-M2ZUPLKQ.js';
-import '../../chunk-WSQAWSEH.js';
-import '../../chunk-OMJRW2D5.js';
-import '../../chunk-CMLSTGOC.js';
+import { scriptFromArkAddress, legacyVtxoFacts, serializeVtxo, createdAtToIso, assertPageRequest, pageResult, checkSaveVtxosForScript, serializeUtxo, assertHistoryPageFilter, serializeAssets, deserializeVtxo, deserializeUtxo, deserializeAssets, contractFilterMatchesNothing, intentMatchesFilter, isTerminalIntentState, mergeChainedTxType } from '../../chunk-IV2252XM.js';
+export { ChainedTxType } from '../../chunk-IV2252XM.js';
+import '../../chunk-3JLYJ5KZ.js';
+import '../../chunk-JOUPIZ32.js';
+import { isVtxoSpent } from '../../chunk-EJYWGTZ7.js';
 
 // src/repositories/sqlite/transaction.ts
 var writeChains = /* @__PURE__ */ new WeakMap();
@@ -29,11 +29,18 @@ function runInTransaction(db, fn) {
   return run;
 }
 
+// src/repositories/sqlite/prefix.ts
+var SAFE_PREFIX = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function sanitizeTablePrefix(p) {
+  if (!SAFE_PREFIX.test(p)) throw new Error(`Invalid table prefix "${p}"`);
+  return p;
+}
+
 // src/repositories/sqlite/walletRepository.ts
 var SQLiteWalletRepository = class {
   constructor(db, options) {
     this.db = db;
-    this.prefix = sanitizePrefix(options?.prefix ?? "ark_");
+    this.prefix = sanitizeTablePrefix(options?.prefix ?? "ark_");
     this.tables = {
       vtxos: `${this.prefix}vtxos`,
       utxos: `${this.prefix}utxos`,
@@ -42,7 +49,7 @@ var SQLiteWalletRepository = class {
     };
   }
   db;
-  version = 1;
+  version = 2;
   initPromise = null;
   prefix;
   tables;
@@ -98,23 +105,42 @@ var SQLiteWalletRepository = class {
     await this.db.run(
       `CREATE INDEX IF NOT EXISTS idx_${this.prefix}vtxos_script ON ${this.tables.vtxos} (script)`
     );
+    await this.db.run(
+      `CREATE INDEX IF NOT EXISTS idx_${this.prefix}vtxos_script_page ON ${this.tables.vtxos} (script, address, txid, vout)`
+    );
+    await this.db.run(
+      `CREATE INDEX IF NOT EXISTS idx_${this.prefix}vtxos_address_page ON ${this.tables.vtxos} (address, txid, vout)`
+    );
+    await this.db.run(`DROP INDEX IF EXISTS idx_${this.prefix}vtxos_live_script`);
+    await this.db.run(
+      `CREATE INDEX IF NOT EXISTS idx_${this.prefix}vtxos_live_script_page ON ${this.tables.vtxos} (script, address, txid, vout)
+             WHERE ${UNSPENT_VTXO_PREDICATE}`
+    );
     await this.db.run(
       `CREATE INDEX IF NOT EXISTS idx_${this.prefix}utxos_address ON ${this.tables.utxos} (address)`
     );
+    await this.db.run(
+      `CREATE INDEX IF NOT EXISTS idx_${this.prefix}utxos_address_page ON ${this.tables.utxos} (address, txid, vout)`
+    );
     await this.db.run(
       `CREATE INDEX IF NOT EXISTS idx_${this.prefix}transactions_address ON ${this.tables.transactions} (address)`
     );
+    await this.db.run(
+      `CREATE INDEX IF NOT EXISTS idx_${this.prefix}transactions_history ON ${this.tables.transactions} (address, created_at, boarding_txid, commitment_txid, ark_txid)`
+    );
   }
   /**
    * Bring the `vtxos` table to the current schema (v1 = `script` NOT NULL).
    *
-   * Three cases:
+   * Four cases:
    *   - Fresh install: create the v1 schema directly.
    *   - Legacy install without a `script` column: add it, backfill from
    *     `address`, then rebuild the table with NOT NULL (SQLite cannot add
    *     the NOT NULL constraint in place).
    *   - Legacy install with a nullable `script` column: backfill the NULLs
    *     and rebuild.
+   *   - 0.4.x install: `script` is already NOT NULL but `virtual_status_json
+   *     NOT NULL` is still there, and `saveVtxos` no longer writes it.
    *
    * The backfill derives `script` from the Ark address, matching what the
    * indexer would have returned — new rows from the indexer always carry a
@@ -158,10 +184,11 @@ var SQLiteWalletRepository = class {
           addedCanonicalColumns = true;
         }
       }
-      if (addedCanonicalColumns && cols.some((c) => c.name === "virtual_status_json")) {
+      const hasLegacyBlob = cols.some((c) => c.name === "virtual_status_json");
+      if (addedCanonicalColumns && hasLegacyBlob) {
         await this.backfillCanonicalVtxoColumns();
       }
-      if (scriptCol && scriptCol.notnull === 1) {
+      if (scriptCol && scriptCol.notnull === 1 && !hasLegacyBlob) {
         return;
       }
       if (!scriptCol) {
@@ -273,13 +300,8 @@ var SQLiteWalletRepository = class {
     await this.db.run(`DELETE FROM ${this.tables.walletState}`);
   }
   // ── VTXO management ────────────────────────────────────────────────
-  async getVtxos(address) {
-    await this.ensureInit();
-    const rows = await this.db.all(
-      `SELECT * FROM ${this.tables.vtxos} WHERE address = ?`,
-      [address]
-    );
-    return rows.map(vtxoRowToDomain);
+  async getVtxosPage(address, page) {
+    return this.pageByAddress(this.tables.vtxos, address, page, vtxoRowToDomain);
   }
   async saveVtxos(address, vtxos) {
     await this.ensureInit();
@@ -310,13 +332,13 @@ var SQLiteWalletRepository = class {
           s.intentTapLeafScript.cb,
           s.intentTapLeafScript.s,
           JSON.stringify(s.status),
-          typeof s.createdAt === "string" ? s.createdAt : s.createdAt instanceof Date ? s.createdAt.toISOString() : new Date(s.createdAt).toISOString(),
+          createdAtToIso(s.createdAt),
           s.isUnrolled ? 1 : 0,
           s.isSpent === void 0 ? null : s.isSpent ? 1 : 0,
           s.isSwept === void 0 ? null : s.isSwept ? 1 : 0,
           s.isPreconfirmed === void 0 ? null : s.isPreconfirmed ? 1 : 0,
           s.commitmentTxIds ? JSON.stringify(s.commitmentTxIds) : null,
-          s.expiresAt === void 0 ? null : s.expiresAt instanceof Date ? s.expiresAt.toISOString() : new Date(s.expiresAt).toISOString(),
+          s.expiresAt === void 0 ? null : new Date(s.expiresAt).toISOString(),
           s.expiresAtHeight ?? null,
           s.spentBy ?? null,
           s.settledBy ?? null,
@@ -332,39 +354,53 @@ var SQLiteWalletRepository = class {
     await this.ensureInit();
     await this.db.run(`DELETE FROM ${this.tables.vtxos} WHERE address = ?`, [address]);
   }
-  async getVtxosForScript(script) {
+  async getVtxosForScriptPage(script, page, options) {
+    assertPageRequest(page);
     await this.ensureInit();
+    const after = page.after;
     const rows = await this.db.all(
-      `SELECT * FROM ${this.tables.vtxos} WHERE script = ?`,
-      [script]
+      `SELECT * FROM ${this.tables.vtxos} WHERE script = ?
+             ${options?.unspentOnly ? `AND ${UNSPENT_VTXO_PREDICATE}` : ""}
+             ${after ? "AND (address > ? OR (address = ? AND (txid > ? OR (txid = ? AND vout > ?))))" : ""}
+             ORDER BY address, txid, vout LIMIT ?`,
+      after ? [
+        script,
+        after.address,
+        after.address,
+        after.txid,
+        after.txid,
+        after.vout,
+        page.limit + 1
+      ] : [script, page.limit + 1]
     );
-    return rows.map(vtxoRowToDomain);
+    const result = pageResult(
+      rows.map((row) => ({ address: row.address, vtxo: vtxoRowToDomain(row) })),
+      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) {
-    if (!key.address) {
-      throw new Error("SQLiteWalletRepository requires an address");
-    }
-    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}`
-        );
-      }
-    }
-    return this.saveVtxos(key.address, vtxos);
+    return this.saveVtxos(checkSaveVtxosForScript("SQLiteWalletRepository", key, vtxos), vtxos);
   }
   async deleteVtxosForScript(script) {
     await this.ensureInit();
     await this.db.run(`DELETE FROM ${this.tables.vtxos} WHERE script = ?`, [script]);
   }
   // ── UTXO management ────────────────────────────────────────────────
-  async getUtxos(address) {
+  async getUtxosPage(address, page) {
+    return this.pageByAddress(this.tables.utxos, address, page, utxoRowToDomain);
+  }
+  async pageByAddress(table, address, page, deserialize) {
+    assertPageRequest(page);
     await this.ensureInit();
     const rows = await this.db.all(
-      `SELECT * FROM ${this.tables.utxos} WHERE address = ?`,
-      [address]
+      `SELECT * FROM ${table} WHERE address = ? AND (txid, vout) > (?, ?)
+             ORDER BY txid, vout LIMIT ?`,
+      [address, page.after?.txid ?? "", page.after?.vout ?? -1, page.limit + 1]
     );
-    return rows.map(utxoRowToDomain);
+    const result = pageResult(rows, page.limit, ({ txid, vout }) => ({ txid, vout }));
+    return { items: result.items.map(deserialize), nextCursor: result.nextCursor };
   }
   async saveUtxos(address, utxos) {
     await this.ensureInit();
@@ -399,13 +435,36 @@ var SQLiteWalletRepository = class {
     await this.db.run(`DELETE FROM ${this.tables.utxos} WHERE address = ?`, [address]);
   }
   // ── Transaction history ────────────────────────────────────────────
-  async getTransactionHistory(address) {
+  async getTransactionHistoryPage(filter, page) {
+    assertPageRequest(page);
+    assertHistoryPageFilter(filter);
     await this.ensureInit();
+    const conditions = ["address = ?"];
+    const params = [filter.address];
+    if (filter.since !== void 0) {
+      conditions.push("created_at >= ?");
+      params.push(filter.since);
+    }
+    if (page.after !== void 0) {
+      conditions.push(
+        "(created_at, boarding_txid, commitment_txid, ark_txid) > (?, ?, ?, ?)"
+      );
+      params.push(
+        page.after.createdAt,
+        page.after.key.boardingTxid,
+        page.after.key.commitmentTxid,
+        page.after.key.arkTxid
+      );
+    }
     const rows = await this.db.all(
-      `SELECT * FROM ${this.tables.transactions} WHERE address = ? ORDER BY created_at ASC`,
-      [address]
+      `SELECT * FROM ${this.tables.transactions} WHERE ${conditions.join(" AND ")}
+             ORDER BY created_at, boarding_txid, commitment_txid, ark_txid LIMIT ?`,
+      [...params, page.limit + 1]
     );
-    return rows.map(txRowToDomain);
+    return pageResult(rows.map(txRowToDomain), page.limit, (tx) => ({
+      createdAt: tx.createdAt,
+      key: tx.key
+    }));
   }
   async saveTransactions(address, txs) {
     await this.ensureInit();
@@ -463,15 +522,7 @@ var SQLiteWalletRepository = class {
     );
   }
 };
-var SAFE_PREFIX = /^[a-zA-Z0-9_]+$/;
-function sanitizePrefix(prefix) {
-  if (!SAFE_PREFIX.test(prefix)) {
-    throw new Error(
-      `Invalid table prefix "${prefix}": only letters, digits, and underscores are allowed`
-    );
-  }
-  return prefix;
-}
+var UNSPENT_VTXO_PREDICATE = "(is_spent IS NULL OR is_spent = 0) AND (spent_by IS NULL OR spent_by = '') AND (settled_by IS NULL OR settled_by = '')";
 function vtxoRowToDomain(row) {
   const serialized = {
     txid: row.txid,
@@ -548,11 +599,11 @@ function txRowToDomain(row) {
 var SQLiteContractRepository = class {
   constructor(db, options) {
     this.db = db;
-    this.prefix = sanitizePrefix2(options?.prefix ?? "ark_");
+    this.prefix = sanitizeTablePrefix(options?.prefix ?? "ark_");
     this.table = `${this.prefix}contracts`;
   }
   db;
-  version = 2;
+  version = 3;
   initPromise = null;
   prefix;
   table;
@@ -599,8 +650,10 @@ var SQLiteContractRepository = class {
     await this.db.run(`DELETE FROM ${this.table}`);
   }
   // ── Contract management ────────────────────────────────────────────
-  async getContracts(filter) {
+  async getContractsPage(filter, page) {
+    assertPageRequest(page);
     await this.ensureInit();
+    if (contractFilterMatchesNothing(filter)) return { items: [] };
     const conditions = [];
     const params = [];
     if (filter) {
@@ -609,12 +662,16 @@ var SQLiteContractRepository = class {
       this.addFilterCondition(conditions, params, "type", filter.type);
       this.addWatchCondition(conditions, params, filter.watch);
     }
-    let sql = `SELECT * FROM ${this.table}`;
-    if (conditions.length > 0) {
-      sql += ` WHERE ${conditions.join(" AND ")}`;
+    if (page.after !== void 0) {
+      conditions.push("script > ?");
+      params.push(page.after);
     }
-    const rows = await this.db.all(sql, params);
-    return rows.map(contractRowToDomain);
+    const where = conditions.length ? ` WHERE ${conditions.join(" AND ")}` : "";
+    const rows = await this.db.all(
+      `SELECT * FROM ${this.table}${where} ORDER BY script LIMIT ?`,
+      [...params, page.limit + 1]
+    );
+    return pageResult(rows.map(contractRowToDomain), page.limit, (contract) => contract.script);
   }
   async saveContract(contract) {
     await this.ensureInit();
@@ -668,15 +725,6 @@ var SQLiteContractRepository = class {
     params.push(...wanted);
   }
 };
-var SAFE_PREFIX2 = /^[a-zA-Z0-9_]+$/;
-function sanitizePrefix2(prefix) {
-  if (!SAFE_PREFIX2.test(prefix)) {
-    throw new Error(
-      `Invalid table prefix "${prefix}": only letters, digits, and underscores are allowed`
-    );
-  }
-  return prefix;
-}
 function contractRowToDomain(row) {
   const contract = {
     script: row.script,
@@ -699,15 +747,10 @@ function contractRowToDomain(row) {
 }
 
 // src/repositories/sqlite/intentRepository.ts
-var SAFE_PREFIX3 = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-function sanitizePrefix3(p) {
-  if (!SAFE_PREFIX3.test(p)) throw new Error(`Invalid table prefix "${p}"`);
-  return p;
-}
 var SQLiteIntentRepository = class {
   constructor(db, options) {
     this.db = db;
-    this.prefix = sanitizePrefix3(options?.prefix ?? "ark_");
+    this.prefix = sanitizeTablePrefix(options?.prefix ?? "ark_");
     this.t = `${this.prefix}intents`;
   }
   db;
@@ -746,19 +789,16 @@ var SQLiteIntentRepository = class {
       `CREATE INDEX IF NOT EXISTS idx_${this.prefix}intent_state ON ${this.t} (state)`
     );
   }
-  withTx(fn) {
-    return runInTransaction(this.db, fn);
-  }
   async clear() {
     await this.ensureInit();
-    await this.withTx(async () => {
+    await runInTransaction(this.db, async () => {
       await this.db.run(`DELETE FROM ${this.t}`);
     });
   }
   async saveIntent(intent) {
     await this.ensureInit();
     const now = Date.now();
-    await this.withTx(async () => {
+    await runInTransaction(this.db, async () => {
       await this.db.run(
         `INSERT INTO ${this.t}
                  (intent_tx_id, intent_id, state, valid_from, valid_until,
@@ -806,15 +846,30 @@ var SQLiteIntentRepository = class {
       );
     });
   }
-  async getIntents(filter) {
+  async getIntentsPage(filter, page) {
+    assertPageRequest(page);
     await this.ensureInit();
-    const rows = await this.db.all(
-      `SELECT * FROM ${this.t} ORDER BY created_at ASC, intent_tx_id ASC`
-    );
-    let out = rows.map(rowToIntent);
-    if (filter) out = out.filter((i) => intentMatchesFilter(i, filter));
-    const { skip, end } = intentPageBounds(filter, out.length);
-    return out.slice(skip, end);
+    if (filter?.states?.length === 0) return { items: [] };
+    const stateSql = filter?.states ? ` AND state IN (${filter.states.map(() => "?").join(", ")})` : "";
+    const stateParams = filter?.states ?? [];
+    const batchSize = Math.max(64, page.limit + 1);
+    const rows = [];
+    let after = page.after;
+    while (rows.length <= page.limit) {
+      const batch = await this.db.all(
+        `SELECT * FROM ${this.t} WHERE intent_tx_id > ?${stateSql} ORDER BY intent_tx_id LIMIT ?`,
+        [after ?? "", ...stateParams, batchSize]
+      );
+      if (batch.length === 0) break;
+      for (const row of batch) {
+        after = row.intent_tx_id;
+        const intent = rowToIntent(row);
+        if (!filter || intentMatchesFilter(intent, filter)) rows.push(intent);
+        if (rows.length > page.limit) break;
+      }
+      if (batch.length < batchSize) break;
+    }
+    return pageResult(rows, page.limit, (intent) => intent.intentTxId);
   }
   async getLockedVtxoOutpoints() {
     await this.ensureInit();
@@ -852,15 +907,10 @@ function rowToIntent(r) {
 }
 
 // src/repositories/sqlite/virtualTxRepository.ts
-var SAFE_PREFIX4 = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-function sanitizePrefix4(p) {
-  if (!SAFE_PREFIX4.test(p)) throw new Error(`Invalid table prefix "${p}"`);
-  return p;
-}
 var SQLiteVirtualTxRepository = class {
   constructor(db, options) {
     this.db = db;
-    this.prefix = sanitizePrefix4(options?.prefix ?? "ark_");
+    this.prefix = sanitizeTablePrefix(options?.prefix ?? "ark_");
     this.tTx = `${this.prefix}virtual_txs`;
     this.tBranch = `${this.prefix}vtxo_branches`;
   }
@@ -892,12 +942,9 @@ var SQLiteVirtualTxRepository = class {
       `CREATE INDEX IF NOT EXISTS idx_${this.prefix}branch_vtxid ON ${this.tBranch} (virtual_txid)`
     );
   }
-  tx(fn) {
-    return runInTransaction(this.db, fn);
-  }
   async clear() {
     await this.ensureInit();
-    await this.tx(async () => {
+    await runInTransaction(this.db, async () => {
       await this.db.run(`DELETE FROM ${this.tTx}`);
       await this.db.run(`DELETE FROM ${this.tBranch}`);
     });
@@ -905,7 +952,7 @@ var SQLiteVirtualTxRepository = class {
   async upsertVirtualTxs(txs) {
     if (txs.length === 0) return;
     await this.ensureInit();
-    await this.tx(async () => {
+    await runInTransaction(this.db, async () => {
       const placeholders = txs.map(() => "?").join(", ");
       const existing = await this.db.all(
         `SELECT * FROM ${this.tTx} WHERE txid IN (${placeholders})`,
@@ -932,7 +979,7 @@ var SQLiteVirtualTxRepository = class {
   }
   async setBranch(vtxo, branch) {
     await this.ensureInit();
-    await this.tx(async () => {
+    await runInTransaction(this.db, async () => {
       await this.db.run(`DELETE FROM ${this.tBranch} WHERE vtxo_txid = ? AND vtxo_vout = ?`, [
         vtxo.txid,
         vtxo.vout
@@ -967,7 +1014,7 @@ var SQLiteVirtualTxRepository = class {
   }
   async pruneForSpentVtxo(vtxo) {
     await this.ensureInit();
-    await this.tx(async () => {
+    await runInTransaction(this.db, async () => {
       const removed = await this.db.all(
         `SELECT DISTINCT virtual_txid FROM ${this.tBranch} WHERE vtxo_txid = ? AND vtxo_vout = ?`,
         [vtxo.txid, vtxo.vout]
@@ -1000,13 +1047,6 @@ function rowToTx(r) {
   };
 }
 
-// src/repositories/sqlite/prefix.ts
-var SAFE_PREFIX5 = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-function sanitizeTablePrefix(p) {
-  if (!SAFE_PREFIX5.test(p)) throw new Error(`Invalid table prefix "${p}"`);
-  return p;
-}
-
 export { SQLiteContractRepository, SQLiteIntentRepository, SQLiteVirtualTxRepository, SQLiteWalletRepository, runInTransaction, sanitizeTablePrefix };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map