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

package/dist/repositories/sqlite/index.d.ts

@@ -1,9 +1,9 @@
-import { W as WalletRepository, B as ExtendedVirtualCoin, D as VtxoRepositoryKey, E as ExtendedCoin, g as ArkTransaction, F as WalletState, C as ContractRepository, H as ContractFilter, z as Contract, J as IntentRepository, K as ArkIntent, L as IntentFilter, O as Outpoint, M as VirtualTxRepository, P as VirtualTx, Q as VtxoBranch } from '../../index-DUxufw76.js';
-export { U as ChainedTxType } from '../../index-DUxufw76.js';
+import { W as WalletRepository, P as PageRequest, O as Outpoint, D as PageResult, B as ExtendedVirtualCoin, F as ScriptVtxoCursor, H as ScriptVtxoPageOptions, J as StoredVtxo, K as VtxoRepositoryKey, E as ExtendedCoin, L as TransactionHistoryPageFilter, M as TransactionHistoryPageCursor, h as ArkTransaction, Q as WalletState, C as ContractRepository, U as ContractFilter, z as Contract, X as IntentRepository, Y as ArkIntent, Z as IntentPageFilter, _ as VirtualTxRepository, $ as VirtualTx, a0 as VtxoBranch } from '../../index-CK5QbTmZ.js';
+export { a1 as ChainedTxType } from '../../index-CK5QbTmZ.js';
 import '@scure/btc-signer/utils.js';
-import '@scure/btc-signer/transaction.js';
-import '@scure/btc-signer';
 import '@scure/btc-signer/psbt.js';
+import '@scure/btc-signer';
+import '@scure/btc-signer/transaction.js';
 
 /**
  * Minimal SQL execution interface that consumers implement
@@ -39,7 +39,7 @@ interface SQLiteWalletRepositoryOptions {
  */
 declare class SQLiteWalletRepository implements WalletRepository {
     private readonly db;
-    readonly version: 1;
+    readonly version: 2;
     private initPromise;
     private readonly prefix;
     private readonly tables;
@@ -49,13 +49,15 @@ declare class SQLiteWalletRepository implements WalletRepository {
     /**
      * 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
@@ -70,19 +72,35 @@ declare class SQLiteWalletRepository implements WalletRepository {
      * leave the next startup seeing no `vtxos` table.
      */
     private migrateVtxosTable;
+    /**
+     * Copy the canonical VTXO facts out of the legacy `virtual_status_json` blob.
+     *
+     * Scoped to rows that still have `is_swept` NULL, which is what "never backfilled" looks
+     * like: the copy writes 0 or 1 to every row it touches, so a second pass — a later column
+     * addition, say — cannot overwrite what an indexer sync has since corrected. Rows whose blob
+     * is missing or corrupt are left alone: a migration must not be stopped by one bad row, and
+     * the next sync repairs it.
+     */
+    private backfillCanonicalVtxoColumns;
     private vtxosCreateSql;
+    /**
+     * `INSERT OR REPLACE` rows, as many to a statement as the parameter budget allows.
+     * No enclosing transaction: on the shared connection it would take in other repos' writes.
+     */
+    private insertOrReplace;
     [Symbol.asyncDispose](): Promise<void>;
     clear(): Promise<void>;
-    getVtxos(address: string): Promise<ExtendedVirtualCoin[]>;
+    getVtxosPage(address: string, page: PageRequest<Outpoint>): Promise<PageResult<ExtendedVirtualCoin, Outpoint>>;
     saveVtxos(address: string, vtxos: ExtendedVirtualCoin[]): Promise<void>;
     deleteVtxos(address: string): Promise<void>;
-    getVtxosForScript(script: string): Promise<ExtendedVirtualCoin[]>;
+    getVtxosForScriptPage(script: string, page: PageRequest<ScriptVtxoCursor>, options?: ScriptVtxoPageOptions): Promise<PageResult<StoredVtxo, ScriptVtxoCursor>>;
     saveVtxosForScript(key: VtxoRepositoryKey, vtxos: ExtendedVirtualCoin[]): Promise<void>;
     deleteVtxosForScript(script: string): Promise<void>;
-    getUtxos(address: string): Promise<ExtendedCoin[]>;
-    saveUtxos(address: string, utxos: ExtendedCoin[]): Promise<void>;
+    getUtxosPage(address: string, page: PageRequest<Outpoint>): Promise<PageResult<ExtendedCoin, Outpoint>>;
+    private pageByAddress;
+    saveUtxos(addressOrBatch: string | ReadonlyMap<string, ExtendedCoin[]>, utxos?: ExtendedCoin[]): Promise<void>;
     deleteUtxos(address: string): Promise<void>;
-    getTransactionHistory(address: string): Promise<ArkTransaction[]>;
+    getTransactionHistoryPage(filter: TransactionHistoryPageFilter, page: PageRequest<TransactionHistoryPageCursor>): Promise<PageResult<ArkTransaction, TransactionHistoryPageCursor>>;
     saveTransactions(address: string, txs: ArkTransaction[]): Promise<void>;
     deleteTransactions(address: string): Promise<void>;
     getWalletState(): Promise<WalletState | null>;
@@ -104,7 +122,7 @@ interface SQLiteContractRepositoryOptions {
  */
 declare class SQLiteContractRepository implements ContractRepository {
     private readonly db;
-    readonly version: 2;
+    readonly version: 3;
     private initPromise;
     private readonly prefix;
     private readonly table;
@@ -114,15 +132,10 @@ declare class SQLiteContractRepository implements ContractRepository {
     private addColumnIfMissing;
     [Symbol.asyncDispose](): Promise<void>;
     clear(): Promise<void>;
-    getContracts(filter?: ContractFilter): Promise<Contract[]>;
+    getContractsPage(filter: ContractFilter | undefined, page: PageRequest): Promise<PageResult<Contract>>;
     saveContract(contract: Contract): Promise<void>;
     deleteContract(script: string): Promise<void>;
     private addFilterCondition;
-    /**
-     * Same as {@link addFilterCondition}, except a row predating the
-     * column stores NULL and must match `"watched"`.
-     */
-    private addWatchCondition;
 }
 
 declare class SQLiteIntentRepository implements IntentRepository {
@@ -136,10 +149,9 @@ declare class SQLiteIntentRepository implements IntentRepository {
     });
     private ensureInit;
     private init;
-    private withTx;
     clear(): Promise<void>;
     saveIntent(intent: ArkIntent): Promise<void>;
-    getIntents(filter?: IntentFilter): Promise<ArkIntent[]>;
+    getIntentsPage(filter: IntentPageFilter | undefined, page: PageRequest): Promise<PageResult<ArkIntent>>;
     getLockedVtxoOutpoints(): Promise<Outpoint[]>;
     [Symbol.asyncDispose](): Promise<void>;
 }
@@ -156,7 +168,6 @@ declare class SQLiteVirtualTxRepository implements VirtualTxRepository {
     });
     private ensureInit;
     private init;
-    private tx;
     clear(): Promise<void>;
     upsertVirtualTxs(txs: VirtualTx[]): Promise<void>;
     getVirtualTx(txid: string): Promise<VirtualTx | null>;