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

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

@@ -1,9 +1,9 @@
-import { W as WalletRepository, z as ExtendedVirtualCoin, B as VtxoRepositoryKey, E as ExtendedCoin, g as ArkTransaction, D as WalletState, C as ContractRepository, F as ContractFilter, y as Contract, H as IntentRepository, J as ArkIntent, K as IntentFilter, O as Outpoint, L as VirtualTxRepository, M as VirtualTx, P as VtxoBranch } from '../../index-BIL9boGL.js';
-export { Q as ChainedTxType } from '../../index-BIL9boGL.js';
+import { W as WalletRepository, P as PageRequest, O as Outpoint, F as PageResult, D as ExtendedVirtualCoin, H as ScriptVtxoCursor, J as ScriptVtxoPageOptions, K as StoredVtxo, L as VtxoRepositoryKey, E as ExtendedCoin, M as TransactionHistoryPageFilter, Q as TransactionHistoryPageCursor, h as ArkTransaction, U as WalletState, C as ContractRepository, X as ContractFilter, B as Contract, Y as IntentRepository, Z as ArkIntent, _ as IntentPageFilter, $ as VirtualTxRepository, a0 as VirtualTx, a1 as VtxoBranch } from '../../index-CZw-MMfY.js';
+export { a2 as ChainedTxType } from '../../index-CZw-MMfY.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
@@ -81,18 +83,24 @@ declare class SQLiteWalletRepository implements WalletRepository {
      */
     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>;
@@ -114,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;
@@ -124,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 {
@@ -146,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>;
 }
@@ -166,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>;