@arkade-os/sdk 0.3.0-alpha.8 → 0.3.0

package/dist/types/providers/ark.d.ts

@@ -11,7 +11,7 @@ export declare enum SettlementEventType {
     BatchFinalized = "batch_finalized",
     BatchFailed = "batch_failed",
     TreeSigningStarted = "tree_signing_started",
-    TreeNoncesAggregated = "tree_nonces_aggregated",
+    TreeNonces = "tree_nonces",
     TreeTx = "tree_tx",
     TreeSignature = "tree_signature"
 }
@@ -36,10 +36,12 @@ export type TreeSigningStartedEvent = {
     cosignersPublicKeys: string[];
     unsignedCommitmentTx: string;
 };
-export type TreeNoncesAggregatedEvent = {
-    type: SettlementEventType.TreeNoncesAggregated;
+export type TreeNoncesEvent = {
+    type: SettlementEventType.TreeNonces;
     id: string;
-    treeNonces: TreeNonces;
+    topic: string[];
+    txid: string;
+    nonces: TreeNonces;
 };
 export type BatchStartedEvent = {
     type: SettlementEventType.BatchStarted;
@@ -62,32 +64,57 @@ export type TreeSignatureEvent = {
     txid: string;
     signature: string;
 };
-export type SettlementEvent = BatchFinalizationEvent | BatchFinalizedEvent | BatchFailedEvent | TreeSigningStartedEvent | TreeNoncesAggregatedEvent | BatchStartedEvent | TreeTxEvent | TreeSignatureEvent;
-export interface MarketHour {
-    nextStartTime: bigint;
+export type SettlementEvent = BatchFinalizationEvent | BatchFinalizedEvent | BatchFailedEvent | TreeSigningStartedEvent | TreeNoncesEvent | BatchStartedEvent | TreeTxEvent | TreeSignatureEvent;
+export interface ScheduledSession {
+    duration: bigint;
+    fees: FeeInfo;
     nextEndTime: bigint;
+    nextStartTime: bigint;
     period: bigint;
-    roundInterval: bigint;
 }
+export interface IntentFeeInfo {
+    offchainInput: string;
+    offchainOutput: string;
+    onchainInput: string;
+    onchainOutput: string;
+}
+export interface FeeInfo {
+    intentFee: IntentFeeInfo;
+    txFeeRate: string;
+}
+export interface PendingTx {
+    arkTxid: string;
+    finalArkTx: string;
+    signedCheckpointTxs: string[];
+}
+export interface DeprecatedSigner {
+    cutoffDate: bigint;
+    pubkey: string;
+}
+export type ServiceStatus = Record<string, string>;
 export interface ArkInfo {
-    signerPubkey: string;
-    vtxoTreeExpiry: bigint;
-    unilateralExitDelay: bigint;
-    roundInterval: bigint;
-    network: string;
+    boardingExitDelay: bigint;
+    checkpointTapscript: string;
+    deprecatedSigners: DeprecatedSigner[];
+    digest: string;
     dust: bigint;
+    fees: FeeInfo;
     forfeitAddress: string;
-    marketHour?: MarketHour;
-    version: string;
-    utxoMinAmount: bigint;
+    forfeitPubkey: string;
+    network: string;
+    scheduledSession: ScheduledSession;
+    serviceStatus: ServiceStatus;
+    sessionDuration: bigint;
+    signerPubkey: string;
+    unilateralExitDelay: bigint;
     utxoMaxAmount: bigint;
-    vtxoMinAmount: bigint;
+    utxoMinAmount: bigint;
+    version: string;
     vtxoMaxAmount: bigint;
-    boardingExitDelay: bigint;
-    checkpointExitClosure: string;
+    vtxoMinAmount: bigint;
 }
-export interface Intent {
-    signature: string;
+export interface SignedIntent {
+    proof: string;
     message: string;
 }
 export interface TxNotification {
@@ -108,8 +135,8 @@ export interface ArkProvider {
         signedCheckpointTxs: string[];
     }>;
     finalizeTx(arkTxid: string, finalCheckpointTxs: string[]): Promise<void>;
-    registerIntent(intent: Intent): Promise<string>;
-    deleteIntent(intent: Intent): Promise<void>;
+    registerIntent(intent: SignedIntent): Promise<string>;
+    deleteIntent(intent: SignedIntent): Promise<void>;
     confirmRegistration(intentId: string): Promise<void>;
     submitTreeNonces(batchId: string, pubkey: string, nonces: TreeNonces): Promise<void>;
     submitTreeSignatures(batchId: string, pubkey: string, signatures: TreePartialSigs): Promise<void>;
@@ -119,6 +146,7 @@ export interface ArkProvider {
         commitmentTx?: TxNotification;
         arkTx?: TxNotification;
     }>;
+    getPendingTxs(intent: SignedIntent): Promise<PendingTx[]>;
 }
 /**
  * REST-based Ark provider implementation.
@@ -139,8 +167,8 @@ export declare class RestArkProvider implements ArkProvider {
         signedCheckpointTxs: string[];
     }>;
     finalizeTx(arkTxid: string, finalCheckpointTxs: string[]): Promise<void>;
-    registerIntent(intent: Intent): Promise<string>;
-    deleteIntent(intent: Intent): Promise<void>;
+    registerIntent(intent: SignedIntent): Promise<string>;
+    deleteIntent(intent: SignedIntent): Promise<void>;
     confirmRegistration(intentId: string): Promise<void>;
     submitTreeNonces(batchId: string, pubkey: string, nonces: TreeNonces): Promise<void>;
     submitTreeSignatures(batchId: string, pubkey: string, signatures: TreePartialSigs): Promise<void>;
@@ -150,6 +178,7 @@ export declare class RestArkProvider implements ArkProvider {
         commitmentTx?: TxNotification;
         arkTx?: TxNotification;
     }>;
+    getPendingTxs(intent: SignedIntent): Promise<PendingTx[]>;
     protected parseSettlementEvent(data: ProtoTypes.GetEventStreamResponse): SettlementEvent | null;
     protected parseTransactionNotification(data: ProtoTypes.GetTransactionsStreamResponse): {
         commitmentTx?: TxNotification;
@@ -181,7 +210,13 @@ declare namespace ProtoTypes {
     }
     interface TreeNoncesAggregatedEvent {
         id: string;
-        treeNonces: string;
+        treeNonces: Record<string, string>;
+    }
+    interface TreeNoncesEvent {
+        id: string;
+        topic: string[];
+        txid: string;
+        nonces: Record<string, string>;
     }
     interface TreeTxEvent {
         id: string;
@@ -225,6 +260,7 @@ declare namespace ProtoTypes {
         batchFinalized?: BatchFinalizedEvent;
         treeSigningStarted?: TreeSigningStartedEvent;
         treeNoncesAggregated?: TreeNoncesAggregatedEvent;
+        treeNonces?: TreeNoncesEvent;
         treeTx?: TreeTxEvent;
         treeSignature?: TreeSignatureEvent;
         heartbeat?: Heartbeat;

package/dist/types/providers/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class ArkError extends Error {
+    readonly code: number;
+    readonly message: string;
+    readonly name: string;
+    readonly metadata?: Record<string, string> | undefined;
+    constructor(code: number, message: string, name: string, metadata?: Record<string, string> | undefined);
+}
+/**
+ * Try to convert an error to an ArkError class, returning undefined if the error is not an ArkError
+ * @param error - The error to parse
+ * @returns The parsed ArkError, or undefined if the error is not an ArkError
+ */
+export declare function maybeArkError(error: any): ArkError | undefined;

package/dist/types/providers/expoIndexer.d.ts

@@ -1,4 +1,4 @@
-import { RestIndexerProvider } from "./indexer";
+import { RestIndexerProvider, SubscriptionResponse } from "./indexer";
 /**
  * Expo-compatible Indexer provider implementation using expo/fetch for streaming support.
  * This provider works specifically in React Native/Expo environments where
@@ -14,13 +14,5 @@ import { RestIndexerProvider } from "./indexer";
  */
 export declare class ExpoIndexerProvider extends RestIndexerProvider {
     constructor(serverUrl: string);
-    getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncGenerator<{
-        txid: any;
-        scripts: any;
-        newVtxos: any;
-        spentVtxos: any;
-        sweptVtxos: any;
-        tx: any;
-        checkpointTxs: any;
-    }, void, unknown>;
+    getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncIterableIterator<SubscriptionResponse>;
 }

package/dist/types/providers/expoUtils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Dynamically imports expo/fetch with fallback to standard fetch.
+ * @returns A fetch function suitable for SSE streaming
+ */
+export declare function getExpoFetch(options?: {
+    requireExpo?: boolean;
+}): Promise<typeof fetch>;
+/**
+ * Generic SSE stream processor using fetch API with ReadableStream.
+ * Handles SSE format parsing, buffer management, and abort signals.
+ *
+ * @param url - The SSE endpoint URL
+ * @param abortSignal - Signal to abort the stream
+ * @param fetchFn - Fetch function to use (defaults to standard fetch)
+ * @param headers - Additional headers to send
+ * @param parseData - Function to parse and yield data from SSE events
+ */
+export declare function sseStreamIterator<T>(url: string, abortSignal: AbortSignal, fetchFn: typeof fetch, headers: Record<string, string>, parseData: (data: any) => T | null): AsyncGenerator<T, void, unknown>;

package/dist/types/providers/indexer.d.ts

@@ -165,15 +165,7 @@ export declare class RestIndexerProvider implements IndexerProvider {
         txids: string[];
         page?: PageResponse;
     }>;
-    getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncGenerator<{
-        txid: any;
-        scripts: any;
-        newVtxos: any;
-        spentVtxos: any;
-        sweptVtxos: any;
-        tx: any;
-        checkpointTxs: any;
-    }, void, unknown>;
+    getSubscription(subscriptionId: string, abortSignal: AbortSignal): AsyncIterableIterator<SubscriptionResponse>;
     getVirtualTxs(txids: string[], opts?: PaginationOptions): Promise<{
         txs: string[];
         page?: PageResponse;

package/dist/types/providers/onchain.d.ts

@@ -49,8 +49,12 @@ export interface OnchainProvider {
  */
 export declare class EsploraProvider implements OnchainProvider {
     private baseUrl;
-    private polling;
-    constructor(baseUrl: string);
+    readonly pollingInterval: number;
+    readonly forcePolling: boolean;
+    constructor(baseUrl: string, opts?: {
+        pollingInterval?: number;
+        forcePolling?: boolean;
+    });
     getCoins(address: string): Promise<Coin[]>;
     getFeeRate(): Promise<number | undefined>;
     broadcastTransaction(...txs: string[]): Promise<string>;

package/dist/types/repositories/walletRepository.d.ts

@@ -1,17 +1,19 @@
 import { StorageAdapter } from "../storage";
-import { ArkTransaction, ExtendedVirtualCoin } from "../wallet";
+import { ArkTransaction, ExtendedCoin, ExtendedVirtualCoin } from "../wallet";
 export interface WalletState {
     lastSyncTime?: number;
     settings?: Record<string, any>;
 }
 export interface WalletRepository {
     getVtxos(address: string): Promise<ExtendedVirtualCoin[]>;
-    saveVtxo(address: string, vtxo: ExtendedVirtualCoin): Promise<void>;
     saveVtxos(address: string, vtxos: ExtendedVirtualCoin[]): Promise<void>;
     removeVtxo(address: string, vtxoId: string): Promise<void>;
     clearVtxos(address: string): Promise<void>;
+    getUtxos(address: string): Promise<ExtendedCoin[]>;
+    saveUtxos(address: string, utxos: ExtendedCoin[]): Promise<void>;
+    removeUtxo(address: string, utxoId: string): Promise<void>;
+    clearUtxos(address: string): Promise<void>;
     getTransactionHistory(address: string): Promise<ArkTransaction[]>;
-    saveTransaction(address: string, tx: ArkTransaction): Promise<void>;
     saveTransactions(address: string, txs: ArkTransaction[]): Promise<void>;
     clearTransactions(address: string): Promise<void>;
     getWalletState(): Promise<WalletState | null>;
@@ -22,12 +24,14 @@ export declare class WalletRepositoryImpl implements WalletRepository {
     private cache;
     constructor(storage: StorageAdapter);
     getVtxos(address: string): Promise<ExtendedVirtualCoin[]>;
-    saveVtxo(address: string, vtxo: ExtendedVirtualCoin): Promise<void>;
     saveVtxos(address: string, vtxos: ExtendedVirtualCoin[]): Promise<void>;
     removeVtxo(address: string, vtxoId: string): Promise<void>;
     clearVtxos(address: string): Promise<void>;
+    getUtxos(address: string): Promise<ExtendedCoin[]>;
+    saveUtxos(address: string, utxos: ExtendedCoin[]): Promise<void>;
+    removeUtxo(address: string, utxoId: string): Promise<void>;
+    clearUtxos(address: string): Promise<void>;
     getTransactionHistory(address: string): Promise<ArkTransaction[]>;
-    saveTransaction(address: string, tx: ArkTransaction): Promise<void>;
     saveTransactions(address: string, txs: ArkTransaction[]): Promise<void>;
     clearTransactions(address: string): Promise<void>;
     getWalletState(): Promise<WalletState | null>;

package/dist/types/script/base.d.ts

@@ -1,4 +1,6 @@
-import { BTC_NETWORK, Bytes } from "@scure/btc-signer/utils.js";
+import { NETWORK } from "@scure/btc-signer";
+import { PSBTOutput } from "@scure/btc-signer/psbt.js";
+import { Bytes } from "@scure/btc-signer/utils.js";
 import { ArkAddress } from "./address";
 import { ConditionCSVMultisigTapscript, CSVMultisigTapscript } from "./tapscript";
 export type TapLeafScript = [
@@ -9,6 +11,7 @@ export type TapLeafScript = [
     },
     Bytes
 ];
+export declare const TapTreeCoder: (typeof PSBTOutput.tapTree)[2];
 export declare function scriptFromTapLeafScript(leaf: TapLeafScript): Bytes;
 /**
  * VtxoScript is a script that contains a list of tapleaf scripts.
@@ -27,7 +30,7 @@ export declare class VtxoScript {
     encode(): Bytes;
     address(prefix: string, serverPubKey: Bytes): ArkAddress;
     get pkScript(): Bytes;
-    onchainAddress(network: BTC_NETWORK): string;
+    onchainAddress(network: typeof NETWORK): string;
     findLeaf(scriptHex: string): TapLeafScript;
     exitPaths(): Array<CSVMultisigTapscript.Type | ConditionCSVMultisigTapscript.Type>;
 }

package/dist/types/tree/signingSession.d.ts

@@ -2,14 +2,17 @@ import * as musig2 from "../musig2";
 import { TxTree } from "./txTree";
 export declare const ErrMissingVtxoGraph: Error;
 export declare const ErrMissingAggregateKey: Error;
-export type TreeNonces = Map<string, Pick<musig2.Nonces, "pubNonce">>;
+export type Musig2PublicNonce = Pick<musig2.Nonces, "pubNonce">;
+export type TreeNonces = Map<string, Musig2PublicNonce>;
 export type TreePartialSigs = Map<string, musig2.PartialSig>;
 export interface SignerSession {
-    getPublicKey(): Uint8Array;
-    init(tree: TxTree, scriptRoot: Uint8Array, rootInputAmount: bigint): void;
-    getNonces(): TreeNonces;
-    setAggregatedNonces(nonces: TreeNonces): void;
-    sign(): TreePartialSigs;
+    getPublicKey(): Promise<Uint8Array>;
+    init(tree: TxTree, scriptRoot: Uint8Array, rootInputAmount: bigint): Promise<void>;
+    getNonces(): Promise<TreeNonces>;
+    aggregatedNonces(txid: string, noncesByPubkey: TreeNonces): Promise<{
+        hasAllNonces: boolean;
+    }>;
+    sign(): Promise<TreePartialSigs>;
 }
 export declare class TreeSignerSession implements SignerSession {
     private secretKey;
@@ -21,11 +24,13 @@ export declare class TreeSignerSession implements SignerSession {
     private rootSharedOutputAmount;
     constructor(secretKey: Uint8Array);
     static random(): TreeSignerSession;
-    init(tree: TxTree, scriptRoot: Uint8Array, rootInputAmount: bigint): void;
-    getPublicKey(): Uint8Array;
-    getNonces(): TreeNonces;
-    setAggregatedNonces(nonces: TreeNonces): void;
-    sign(): TreePartialSigs;
+    init(tree: TxTree, scriptRoot: Uint8Array, rootInputAmount: bigint): Promise<void>;
+    getPublicKey(): Promise<Uint8Array>;
+    getNonces(): Promise<TreeNonces>;
+    aggregatedNonces(txid: string, noncesByPubkey: TreeNonces): Promise<{
+        hasAllNonces: boolean;
+    }>;
+    sign(): Promise<TreePartialSigs>;
     private generateNonces;
     private signPartial;
 }

package/dist/types/utils/anchor.d.ts

@@ -1,5 +1,5 @@
-import { Transaction } from "@scure/btc-signer/transaction.js";
-import { TransactionInputUpdate } from "@scure/btc-signer/psbt";
+import { Transaction } from "@scure/btc-signer";
+import { TransactionInputUpdate } from "@scure/btc-signer/psbt.js";
 export declare const ANCHOR_VALUE = 0n;
 export declare const ANCHOR_PKSCRIPT: Uint8Array<ArrayBuffer>;
 /**

package/dist/types/utils/arkTransaction.d.ts

@@ -1,13 +1,11 @@
-import { Transaction } from "@scure/btc-signer/transaction.js";
+import { TransactionOutput } from "@scure/btc-signer/psbt.js";
 import { ExtendedCoin, VirtualCoin } from "../wallet";
 import { RelativeTimelock } from "../script/tapscript";
 import { EncodedVtxoScript, TapLeafScript } from "../script/base";
 import { CSVMultisigTapscript } from "../script/tapscript";
-import { TransactionOutput } from "@scure/btc-signer/psbt.js";
-import { Bytes } from "@scure/btc-signer/utils.js";
+import { Transaction } from "./transaction";
 export type ArkTxInput = {
     tapLeafScript: TapLeafScript;
-    checkpointTapLeafScript?: Bytes;
 } & EncodedVtxoScript & Pick<VirtualCoin, "txid" | "vout" | "value">;
 export type OffchainTx = {
     arkTx: Transaction;
@@ -27,3 +25,13 @@ export type OffchainTx = {
  */
 export declare function buildOffchainTx(inputs: ArkTxInput[], outputs: TransactionOutput[], serverUnrollScript: CSVMultisigTapscript.Type): OffchainTx;
 export declare function hasBoardingTxExpired(coin: ExtendedCoin, boardingTimelock: RelativeTimelock): boolean;
+/**
+ * Verify tapscript signatures on a transaction input
+ * @param tx Transaction to verify
+ * @param inputIndex Index of the input to verify
+ * @param requiredSigners List of required signer pubkeys (hex encoded)
+ * @param excludePubkeys List of pubkeys to exclude from verification (hex encoded, e.g., server key not yet signed)
+ * @param allowedSighashTypes List of allowed sighash types (defaults to [SigHash.DEFAULT])
+ * @throws Error if verification fails
+ */
+export declare function verifyTapscriptSignatures(tx: Transaction, inputIndex: number, requiredSigners: string[], excludePubkeys?: string[], allowedSighashTypes?: number[]): void;

package/dist/types/utils/transaction.d.ts

@@ -0,0 +1,13 @@
+import { Transaction as BtcSignerTransaction } from "@scure/btc-signer";
+import { TxOpts } from "@scure/btc-signer/transaction";
+import { Bytes } from "@scure/btc-signer/utils";
+/**
+ * Transaction is a wrapper around the @scure/btc-signer Transaction class.
+ * It adds the Ark protocol specific options to the transaction.
+ */
+export declare class Transaction extends BtcSignerTransaction {
+    static ARK_TX_OPTS: TxOpts;
+    constructor(opts?: TxOpts);
+    static fromPSBT(psbt_: Bytes, opts?: TxOpts): Transaction;
+    static fromRaw(raw: Bytes, opts?: TxOpts): Transaction;
+}

package/dist/types/utils/unknownFields.d.ts

@@ -1,5 +1,5 @@
-import { Transaction } from "@scure/btc-signer/transaction.js";
-import { TransactionInputUpdate } from "@scure/btc-signer/psbt";
+import { Transaction } from "@scure/btc-signer";
+import { TransactionInputUpdate } from "@scure/btc-signer/psbt.js";
 /**
  * ArkPsbtFieldKey is the key values for ark psbt fields.
  */
@@ -11,9 +11,9 @@ export declare enum ArkPsbtFieldKey {
 }
 /**
  * ArkPsbtFieldKeyType is the type of the ark psbt field key.
- * Every ark psbt field has key type 255.
+ * Every ark psbt field has key type 222.
  */
-export declare const ArkPsbtFieldKeyType = 255;
+export declare const ArkPsbtFieldKeyType = 222;
 /**
  * ArkPsbtFieldCoder is the coder for the ark psbt fields.
  * each type has its own coder.

package/dist/types/wallet/index.d.ts

@@ -1,11 +1,12 @@
-import { Output, SettlementEvent, ArkProvider } from "../providers/ark";
-import { IndexerProvider } from "../providers/indexer";
-import { OnchainProvider } from "../providers/onchain";
+import { Bytes } from "@scure/btc-signer/utils.js";
+import { ArkProvider, Output, SettlementEvent } from "../providers/ark";
 import { Identity } from "../identity";
 import { RelativeTimelock } from "../script/tapscript";
 import { EncodedVtxoScript, TapLeafScript } from "../script/base";
-import { Bytes } from "@scure/btc-signer/utils.js";
 import { StorageAdapter } from "../storage";
+import { RenewalConfig } from "./vtxo-manager";
+import { IndexerProvider } from "../providers/indexer";
+import { OnchainProvider } from "../providers/onchain";
 /**
  * Configuration options for wallet initialization.
  *
@@ -50,6 +51,7 @@ export interface WalletConfig {
     arkProvider?: ArkProvider;
     indexerProvider?: IndexerProvider;
     onchainProvider?: OnchainProvider;
+    renewalConfig?: RenewalConfig;
 }
 /**
  * Provider class constructor interface for dependency injection.

package/dist/types/wallet/onchain.d.ts

@@ -3,8 +3,8 @@ import { Coin, SendBitcoinParams } from ".";
 import { Identity } from "../identity";
 import { Network, NetworkName } from "../networks";
 import { OnchainProvider } from "../providers/onchain";
-import { Transaction } from "@scure/btc-signer/transaction.js";
 import { AnchorBumper } from "../utils/anchor";
+import { Transaction } from "../utils/transaction";
 /**
  * Onchain Bitcoin wallet implementation for traditional Bitcoin transactions.
  *

package/dist/types/wallet/serviceWorker/response.d.ts

@@ -1,10 +1,11 @@
-import { WalletBalance, VirtualCoin, ArkTransaction, IWallet } from "..";
+import { WalletBalance, VirtualCoin, ArkTransaction, IWallet, Coin } from "..";
+import { ExtendedVirtualCoin } from "../..";
 import { SettlementEvent } from "../../providers/ark";
 /**
  * Response is the namespace that contains the response types for the service worker.
  */
 export declare namespace Response {
-    type Type = "WALLET_INITIALIZED" | "WALLET_RELOADED" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "BOARDING_ADDRESS" | "BALANCE" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE";
+    type Type = "WALLET_INITIALIZED" | "WALLET_RELOADED" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "BOARDING_ADDRESS" | "BALANCE" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE" | "VTXO_UPDATE" | "UTXO_UPDATE";
     interface Base {
         type: Type;
         success: boolean;
@@ -106,4 +107,17 @@ export declare namespace Response {
     }
     function isWalletReloaded(response: Base): response is WalletReloaded;
     function walletReloaded(id: string, success: boolean): WalletReloaded;
+    interface VtxoUpdate extends Base {
+        type: "VTXO_UPDATE";
+        spentVtxos: ExtendedVirtualCoin[];
+        newVtxos: ExtendedVirtualCoin[];
+    }
+    function isVtxoUpdate(response: Base): response is VtxoUpdate;
+    function vtxoUpdate(newVtxos: ExtendedVirtualCoin[], spentVtxos: ExtendedVirtualCoin[]): VtxoUpdate;
+    interface UtxoUpdate extends Base {
+        type: "UTXO_UPDATE";
+        coins: Coin[];
+    }
+    function isUtxoUpdate(response: Base): response is UtxoUpdate;
+    function utxoUpdate(coins: Coin[]): UtxoUpdate;
 }

package/dist/types/wallet/serviceWorker/utils.d.ts

@@ -1,3 +1,4 @@
+export declare const DEFAULT_DB_NAME = "arkade-service-worker";
 /**
  * setupServiceWorker sets up the service worker.
  * @param path - the path to the service worker script

package/dist/types/wallet/serviceWorker/wallet.d.ts

@@ -2,7 +2,6 @@ import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, ArkTransaction
 import { Response } from "./response";
 import { SettlementEvent } from "../../providers/ark";
 import { Identity } from "../../identity";
-import { StorageAdapter } from "../../storage";
 import { WalletRepository } from "../../repositories/walletRepository";
 import { ContractRepository } from "../../repositories/contractRepository";
 export type PrivateKeyIdentity = Identity & {
@@ -44,8 +43,9 @@ interface ServiceWorkerWalletOptions {
     arkServerPublicKey?: string;
     arkServerUrl: string;
     esploraUrl?: string;
+    dbName?: string;
+    dbVersion?: number;
     identity: PrivateKeyIdentity;
-    storage?: StorageAdapter;
 }
 export type ServiceWorkerWalletCreateOptions = ServiceWorkerWalletOptions & {
     serviceWorker: ServiceWorker;

package/dist/types/wallet/serviceWorker/worker.d.ts

@@ -3,6 +3,8 @@
  * it aims to be run in a service worker context
  */
 export declare class Worker {
+    readonly dbName: string;
+    readonly dbVersion: number;
     private readonly messageCallback;
     private wallet;
     private arkProvider;
@@ -10,7 +12,7 @@ export declare class Worker {
     private incomingFundsSubscription;
     private walletRepository;
     private storage;
-    constructor(messageCallback?: (message: ExtendableMessageEvent) => void);
+    constructor(dbName?: string, dbVersion?: number, messageCallback?: (message: ExtendableMessageEvent) => void);
     /**
      * Get spendable vtxos for the current wallet address
      */
@@ -23,6 +25,10 @@ export declare class Worker {
      * Get all vtxos categorized by type
      */
     private getAllVtxos;
+    /**
+     * Get all boarding utxos from wallet repository
+     */
+    private getAllBoardingUtxos;
     start(withServiceWorkerUpdate?: boolean): Promise<void>;
     clear(): Promise<void>;
     reload(): Promise<void>;

package/dist/types/wallet/unroll.d.ts

@@ -1,9 +1,9 @@
-import { Transaction } from "@scure/btc-signer/transaction.js";
 import { ChainTx, IndexerProvider } from "../providers/indexer";
 import { AnchorBumper } from "../utils/anchor";
 import { OnchainProvider } from "../providers/onchain";
 import { Outpoint } from ".";
 import { Wallet } from "./wallet";
+import { Transaction } from "../utils/transaction";
 export declare namespace Unroll {
     enum StepType {
         UNROLL = 0,

package/dist/types/wallet/utils.d.ts

@@ -1,2 +1,3 @@
-import type { ExtendedVirtualCoin, VirtualCoin, Wallet } from "..";
+import type { Coin, ExtendedCoin, ExtendedVirtualCoin, VirtualCoin, Wallet } from "..";
 export declare function extendVirtualCoin(wallet: Wallet, vtxo: VirtualCoin): ExtendedVirtualCoin;
+export declare function extendCoin(wallet: Wallet, utxo: Coin): ExtendedCoin;