@arkade-os/sdk 0.2.3 → 0.3.0-alpha.1

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

@@ -1,5 +1,5 @@
 import { TapLeafScript, VtxoScript } from "../script/base";
-import { Bytes } from "@scure/btc-signer/utils";
+import { Bytes } from "@scure/btc-signer/utils.js";
 import { ExtendedCoin, Status } from "../wallet";
 /**
  * ArkNotes are special virtual coins in the Ark protocol that can be created

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

@@ -1,5 +1,5 @@
-import { Transaction } from "@scure/btc-signer";
-import { TransactionInput, TransactionOutput } from "@scure/btc-signer/psbt";
+import { Transaction } from "@scure/btc-signer/transaction.js";
+import { TransactionInput, TransactionOutput } from "@scure/btc-signer/psbt.js";
 /**
  * BIP-322 signature implementation for Bitcoin message signing.
  *

package/dist/types/forfeit.d.ts

@@ -1,3 +1,3 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { TransactionInputUpdate } from "@scure/btc-signer/psbt";
 export declare function buildForfeitTx(inputs: TransactionInputUpdate[], forfeitPkScript: Uint8Array, txLocktime?: number): Transaction;

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

@@ -1,7 +1,9 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { SignerSession } from "../tree/signingSession";
 export interface Identity {
     sign(tx: Transaction, inputIndexes?: number[]): Promise<Transaction>;
-    xOnlyPublicKey(): Uint8Array;
+    xOnlyPublicKey(): Promise<Uint8Array>;
     signerSession(): SignerSession;
+    signMessage(message: string): Promise<Uint8Array>;
 }
+export * from "./singleKey";

package/dist/types/identity/singleKey.d.ts

@@ -1,4 +1,4 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { Identity } from ".";
 import { SignerSession } from "../tree/signingSession";
 /**
@@ -12,6 +12,9 @@ import { SignerSession } from "../tree/signingSession";
  * // Create from raw bytes
  * const key = SingleKey.fromPrivateKey(privateKeyBytes);
  *
+ * // Create random key
+ * const randomKey = SingleKey.fromRandomBytes();
+ *
  * // Sign a transaction
  * const signedTx = await key.sign(transaction);
  * ```
@@ -21,7 +24,15 @@ export declare class SingleKey implements Identity {
     private constructor();
     static fromPrivateKey(privateKey: Uint8Array): SingleKey;
     static fromHex(privateKeyHex: string): SingleKey;
+    static fromRandomBytes(): SingleKey;
+    /**
+     * Export the private key as a hex string.
+     *
+     * @returns The private key as a hex string
+     */
+    toHex(): string;
     sign(tx: Transaction, inputIndexes?: number[]): Promise<Transaction>;
-    xOnlyPublicKey(): Uint8Array;
+    xOnlyPublicKey(): Promise<Uint8Array>;
     signerSession(): SignerSession;
+    signMessage(message: string): Promise<Uint8Array>;
 }

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { SingleKey } from "./identity/singleKey";
 import { Identity } from "./identity";
 import { ArkAddress } from "./script/address";
@@ -23,13 +23,13 @@ import { buildOffchainTx, ArkTxInput, OffchainTx } from "./utils/arkTransaction"
 import { VtxoTaprootTree, ConditionWitness, getArkPsbtFields, setArkPsbtField, ArkPsbtFieldCoder, ArkPsbtFieldKey, ArkPsbtFieldKeyType, CosignerPublicKey, VtxoTreeExpiry } from "./utils/unknownFields";
 import { BIP322 } from "./bip322";
 import { ArkNote } from "./arknote";
-import { IndexedDBVtxoRepository } from "./wallet/serviceWorker/db/vtxo/idb";
-import { VtxoRepository } from "./wallet/serviceWorker/db/vtxo";
 import { networks, Network, NetworkName } from "./networks";
 import { RestIndexerProvider, IndexerProvider, IndexerTxType, ChainTxType, PageResponse, Batch, ChainTx, CommitmentTx, TxHistoryRecord, VtxoChain, Tx, Vtxo, PaginationOptions, SubscriptionResponse } from "./providers/indexer";
 import { Nonces } from "./musig2/nonces";
 import { PartialSig } from "./musig2/sign";
 import { AnchorBumper, P2A } from "./utils/anchor";
 import { Unroll } from "./wallet/unroll";
-export { Wallet, SingleKey, OnchainWallet, Ramps, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, Worker, ServiceWorkerWallet, Request, Response, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, waitForIncomingFunds, ArkNote, networks, IndexedDBVtxoRepository, BIP322, TxTree, P2A, Unroll, Transaction, };
-export type { Identity, IWallet, WalletConfig, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, WalletBalance, SendBitcoinParams, Recipient, SettleParams, Status, VirtualStatus, Outpoint, VirtualCoin, TxKey, TapscriptType, VtxoRepository, ArkTxInput, OffchainTx, TapLeaves, IncomingFunds, IndexerProvider, PageResponse, Batch, ChainTx, CommitmentTx, TxHistoryRecord, Vtxo, VtxoChain, Tx, OnchainProvider, ArkProvider, SettlementEvent, ArkInfo, Intent, Output, TxNotification, ExplorerTransaction, BatchFinalizationEvent, BatchFinalizedEvent, BatchFailedEvent, TreeSigningStartedEvent, TreeNoncesAggregatedEvent, BatchStartedEvent, TreeTxEvent, TreeSignatureEvent, MarketHour, PaginationOptions, SubscriptionResponse, Network, NetworkName, ArkTapscript, RelativeTimelock, EncodedVtxoScript, TapLeafScript, SignerSession, TreeNonces, TreePartialSigs, GetVtxosFilter, Nonces, PartialSig, ArkPsbtFieldCoder, TxTreeNode, AnchorBumper, };
+import { WalletRepositoryImpl } from "./repositories/walletRepository";
+import { ContractRepositoryImpl } from "./repositories/contractRepository";
+export { Wallet, SingleKey, OnchainWallet, Ramps, ESPLORA_URL, EsploraProvider, RestArkProvider, RestIndexerProvider, ArkAddress, DefaultVtxo, VtxoScript, VHTLC, TxType, IndexerTxType, ChainTxType, SettlementEventType, setupServiceWorker, Worker, ServiceWorkerWallet, Request, Response, decodeTapscript, MultisigTapscript, CSVMultisigTapscript, ConditionCSVMultisigTapscript, ConditionMultisigTapscript, CLTVMultisigTapscript, ArkPsbtFieldKey, ArkPsbtFieldKeyType, setArkPsbtField, getArkPsbtFields, CosignerPublicKey, VtxoTreeExpiry, VtxoTaprootTree, ConditionWitness, buildOffchainTx, waitForIncomingFunds, ArkNote, networks, WalletRepositoryImpl, ContractRepositoryImpl, BIP322, TxTree, P2A, Unroll, Transaction, };
+export type { Identity, IWallet, WalletConfig, ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, WalletBalance, SendBitcoinParams, Recipient, SettleParams, Status, VirtualStatus, Outpoint, VirtualCoin, TxKey, TapscriptType, ArkTxInput, OffchainTx, TapLeaves, IncomingFunds, IndexerProvider, PageResponse, Batch, ChainTx, CommitmentTx, TxHistoryRecord, Vtxo, VtxoChain, Tx, OnchainProvider, ArkProvider, SettlementEvent, ArkInfo, Intent, Output, TxNotification, ExplorerTransaction, BatchFinalizationEvent, BatchFinalizedEvent, BatchFailedEvent, TreeSigningStartedEvent, TreeNoncesAggregatedEvent, BatchStartedEvent, TreeTxEvent, TreeSignatureEvent, MarketHour, PaginationOptions, SubscriptionResponse, Network, NetworkName, ArkTapscript, RelativeTimelock, EncodedVtxoScript, TapLeafScript, SignerSession, TreeNonces, TreePartialSigs, GetVtxosFilter, Nonces, PartialSig, ArkPsbtFieldCoder, TxTreeNode, AnchorBumper, };

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

@@ -0,0 +1,20 @@
+import { StorageAdapter } from "../storage";
+export interface ContractRepository {
+    getContractData<T>(contractId: string, key: string): Promise<T | null>;
+    setContractData<T>(contractId: string, key: string, data: T): Promise<void>;
+    deleteContractData(contractId: string, key: string): Promise<void>;
+    getContractCollection<T>(contractType: string): Promise<ReadonlyArray<T>>;
+    saveToContractCollection<T, K extends keyof T>(contractType: string, item: T, idField: K): Promise<void>;
+    removeFromContractCollection<T, K extends keyof T>(contractType: string, id: T[K], idField: K): Promise<void>;
+}
+export declare class ContractRepositoryImpl implements ContractRepository {
+    private storage;
+    private cache;
+    constructor(storage: StorageAdapter);
+    getContractData<T>(contractId: string, key: string): Promise<T | null>;
+    setContractData<T>(contractId: string, key: string, data: T): Promise<void>;
+    deleteContractData(contractId: string, key: string): Promise<void>;
+    getContractCollection<T>(contractType: string): Promise<ReadonlyArray<T>>;
+    saveToContractCollection<T, K extends keyof T>(contractType: string, item: T, idField: K): Promise<void>;
+    removeFromContractCollection<T, K extends keyof T>(contractType: string, id: T[K], idField: K): Promise<void>;
+}

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

@@ -0,0 +1,2 @@
+export * from "./walletRepository";
+export * from "./contractRepository";

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

@@ -0,0 +1,38 @@
+import { StorageAdapter } from "../storage";
+import { ExtendedVirtualCoin } from "../wallet";
+export interface WalletState {
+    lastSyncTime?: number;
+    settings?: Record<string, any>;
+}
+export interface Transaction {
+    id: string;
+    timestamp: number;
+    amount: number;
+    type: "send" | "receive";
+    status: "pending" | "confirmed" | "failed";
+}
+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>;
+    getTransactionHistory(address: string): Promise<Transaction[]>;
+    saveTransaction(address: string, tx: Transaction): Promise<void>;
+    getWalletState(): Promise<WalletState | null>;
+    saveWalletState(state: WalletState): Promise<void>;
+}
+export declare class WalletRepositoryImpl implements WalletRepository {
+    private storage;
+    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>;
+    getTransactionHistory(address: string): Promise<Transaction[]>;
+    saveTransaction(address: string, tx: Transaction): Promise<void>;
+    getWalletState(): Promise<WalletState | null>;
+    saveWalletState(state: WalletState): Promise<void>;
+}

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

@@ -1,4 +1,4 @@
-import { Bytes } from "@scure/btc-signer/utils";
+import { Bytes } from "@scure/btc-signer/utils.js";
 /**
  * ArkAddress allows to create and decode bech32m encoded ark address.
  * An ark address is composed of:

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

@@ -1,4 +1,4 @@
-import { BTC_NETWORK, Bytes } from "@scure/btc-signer/utils";
+import { BTC_NETWORK, Bytes } from "@scure/btc-signer/utils.js";
 import { ArkAddress } from "./address";
 import { ConditionCSVMultisigTapscript, CSVMultisigTapscript } from "./tapscript";
 export type TapLeafScript = [

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

@@ -1,4 +1,4 @@
-import { Bytes } from "@scure/btc-signer/utils";
+import { Bytes } from "@scure/btc-signer/utils.js";
 import { TapLeafScript, VtxoScript } from "./base";
 import { RelativeTimelock } from "./tapscript";
 /**

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

@@ -1,4 +1,4 @@
-import { Bytes } from "@scure/btc-signer/utils";
+import { Bytes } from "@scure/btc-signer/utils.js";
 /**
  * RelativeTimelock lets to create timelocked with CHECKSEQUENCEVERIFY script.
  *

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

@@ -1,4 +1,4 @@
-import { Bytes } from "@scure/btc-signer/utils";
+import { Bytes } from "@scure/btc-signer/utils.js";
 import { RelativeTimelock } from "./tapscript";
 import { TapLeafScript, VtxoScript } from "./base";
 /**

package/dist/types/storage/asyncStorage.d.ts

@@ -0,0 +1,9 @@
+import type { StorageAdapter } from "./index";
+export declare class AsyncStorageAdapter implements StorageAdapter {
+    private AsyncStorage;
+    constructor();
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/types/storage/fileSystem.d.ts

@@ -0,0 +1,11 @@
+import type { StorageAdapter } from "./index";
+export declare class FileSystemStorageAdapter implements StorageAdapter {
+    private readonly basePath;
+    constructor(dirPath: string);
+    private validateAndGetFilePath;
+    private ensureDirectory;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/types/storage/inMemory.d.ts

@@ -0,0 +1,8 @@
+import type { StorageAdapter } from "./index";
+export declare class InMemoryStorageAdapter implements StorageAdapter {
+    private store;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

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

@@ -0,0 +1,6 @@
+export interface StorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/types/storage/indexedDB.d.ts

@@ -0,0 +1,12 @@
+import type { StorageAdapter } from "./index";
+export declare class IndexedDBStorageAdapter implements StorageAdapter {
+    private dbName;
+    private version;
+    private db;
+    constructor(dbName: string, version?: number);
+    private getDB;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/types/storage/localStorage.d.ts

@@ -0,0 +1,8 @@
+import type { StorageAdapter } from "./index";
+export declare class LocalStorageAdapter implements StorageAdapter {
+    private getSafeLocalStorage;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

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

@@ -1,4 +1,4 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 /**
  * TxTreeNode is a node of the tree.
  * It contains the transaction id, the transaction and the children.

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

@@ -1,4 +1,4 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { TxTree } from "./txTree";
 export declare const ErrInvalidSettlementTx: (tx: string) => Error;
 export declare const ErrInvalidSettlementTxOutputs: Error;

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

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

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

@@ -1,9 +1,9 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { VirtualCoin } from "../wallet";
 import { EncodedVtxoScript, TapLeafScript } from "../script/base";
 import { CSVMultisigTapscript } from "../script/tapscript";
-import { TransactionOutput } from "@scure/btc-signer/psbt";
-import { Bytes } from "@scure/btc-signer/utils";
+import { TransactionOutput } from "@scure/btc-signer/psbt.js";
+import { Bytes } from "@scure/btc-signer/utils.js";
 export type ArkTxInput = {
     tapLeafScript: TapLeafScript;
     checkpointTapLeafScript?: Bytes;

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

@@ -1,4 +1,4 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { TransactionInputUpdate } from "@scure/btc-signer/psbt";
 /**
  * ArkPsbtFieldKey is the key values for ark psbt fields.

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

@@ -2,7 +2,8 @@ import { 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";
+import { Bytes } from "@scure/btc-signer/utils.js";
+import { StorageAdapter } from "../storage";
 /**
  * Configuration options for wallet initialization.
  *
@@ -18,6 +19,7 @@ export interface WalletConfig {
     arkServerPublicKey?: string;
     boardingTimelock?: RelativeTimelock;
     exitTimelock?: RelativeTimelock;
+    storage?: StorageAdapter;
 }
 export interface WalletBalance {
     boarding: {
@@ -113,6 +115,7 @@ export type GetVtxosFilter = {
  * operations, and transaction management including sending, settling, and unrolling.
  */
 export interface IWallet {
+    identity: Identity;
     getAddress(): Promise<string>;
     getBoardingAddress(): Promise<string>;
     getBalance(): Promise<WalletBalance>;

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

@@ -1,9 +1,9 @@
-import { P2TR } from "@scure/btc-signer/payment";
+import { P2TR } from "@scure/btc-signer/payment.js";
 import { Coin, SendBitcoinParams } from ".";
 import { Identity } from "../identity";
 import { Network, NetworkName } from "../networks";
 import { OnchainProvider } from "../providers/onchain";
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { AnchorBumper } from "../utils/anchor";
 /**
  * Onchain Bitcoin wallet implementation for traditional Bitcoin transactions.
@@ -14,7 +14,7 @@ import { AnchorBumper } from "../utils/anchor";
  *
  * @example
  * ```typescript
- * const wallet = new OnchainWallet(identity, 'mainnet');
+ * const wallet = await OnchainWallet.create(identity, 'mainnet');
  * const balance = await wallet.getBalance();
  * const txid = await wallet.send({
  *   address: 'bc1...',
@@ -29,7 +29,8 @@ export declare class OnchainWallet implements AnchorBumper {
     readonly onchainP2TR: P2TR;
     readonly provider: OnchainProvider;
     readonly network: Network;
-    constructor(identity: Identity, network: NetworkName, provider?: OnchainProvider);
+    private constructor();
+    static create(identity: Identity, networkName: NetworkName, provider?: OnchainProvider): Promise<OnchainWallet>;
     get address(): string;
     getCoins(): Promise<Coin[]>;
     getBalance(): Promise<number>;

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

@@ -3,7 +3,7 @@ import { SettleParams, SendBitcoinParams, GetVtxosFilter } from "..";
  * Request is the namespace that contains the request types for the service worker.
  */
 export declare namespace Request {
-    type Type = "INIT_WALLET" | "SETTLE" | "GET_ADDRESS" | "GET_BOARDING_ADDRESS" | "GET_BALANCE" | "GET_VTXOS" | "GET_VIRTUAL_COINS" | "GET_BOARDING_UTXOS" | "SEND_BITCOIN" | "GET_TRANSACTION_HISTORY" | "GET_STATUS" | "CLEAR" | "SIGN";
+    type Type = "INIT_WALLET" | "SETTLE" | "GET_ADDRESS" | "GET_BOARDING_ADDRESS" | "GET_BALANCE" | "GET_VTXOS" | "GET_VIRTUAL_COINS" | "GET_BOARDING_UTXOS" | "SEND_BITCOIN" | "GET_TRANSACTION_HISTORY" | "GET_STATUS" | "CLEAR";
     interface Base {
         type: Type;
         id: string;
@@ -62,10 +62,4 @@ export declare namespace Request {
     interface Clear extends Base {
         type: "CLEAR";
     }
-    interface Sign extends Base {
-        type: "SIGN";
-        tx: string;
-        inputIndexes?: number[];
-    }
-    function isSign(message: Base): message is Sign;
 }

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

@@ -4,7 +4,7 @@ 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" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "BOARDING_ADDRESS" | "BALANCE" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE" | "SIGN_SUCCESS";
+    type Type = "WALLET_INITIALIZED" | "SETTLE_EVENT" | "SETTLE_SUCCESS" | "ADDRESS" | "BOARDING_ADDRESS" | "BALANCE" | "VTXOS" | "VIRTUAL_COINS" | "BOARDING_UTXOS" | "SEND_BITCOIN_SUCCESS" | "TRANSACTION_HISTORY" | "WALLET_STATUS" | "ERROR" | "CLEAR_RESPONSE";
     interface Base {
         type: Type;
         success: boolean;
@@ -101,11 +101,4 @@ export declare namespace Response {
     }
     function isClearResponse(response: Base): response is ClearResponse;
     function clearResponse(id: string, success: boolean): ClearResponse;
-    interface SignSuccess extends Base {
-        type: "SIGN_SUCCESS";
-        success: true;
-        tx: string;
-    }
-    function signSuccess(id: string, tx: string): SignSuccess;
-    function isSignSuccess(response: Base): response is SignSuccess;
 }

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

@@ -1,9 +1,13 @@
-import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, ArkTransaction, WalletConfig, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter } from "..";
+import { IWallet, WalletBalance, SendBitcoinParams, SettleParams, ArkTransaction, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter } from "..";
 import { Response } from "./response";
 import { SettlementEvent } from "../../providers/ark";
 import { Identity } from "../../identity";
-import { SignerSession } from "../../tree/signingSession";
-import { Transaction } from "@scure/btc-signer";
+import { StorageAdapter } from "../../storage";
+import { WalletRepository } from "../../repositories/walletRepository";
+import { ContractRepository } from "../../repositories/contractRepository";
+export type PrivateKeyIdentity = Identity & {
+    toHex(): string;
+};
 /**
  * Service Worker-based wallet implementation for browser environments.
  *
@@ -14,12 +18,21 @@ import { Transaction } from "@scure/btc-signer";
  *
  * @example
  * ```typescript
- * // Create and initialize the service worker wallet
+ * // SIMPLE: Recommended approach
+ * const identity = SingleKey.fromHex('your_private_key_hex');
+ * const wallet = await ServiceWorkerWallet.setup({
+ *   serviceWorkerPath: '/service-worker.js',
+ *   arkServerUrl: 'https://mutinynet.arkade.sh',
+ *   identity
+ * });
+ *
+ * // ADVANCED: Manual setup with service worker control
  * const serviceWorker = await setupServiceWorker("/service-worker.js");
- * const wallet = new ServiceWorkerWallet(serviceWorker);
- * await wallet.init({
- *   privateKey: 'your_private_key_hex',
- *   arkServerUrl: 'https://ark.example.com'
+ * const identity = SingleKey.fromHex('your_private_key_hex');
+ * const wallet = await ServiceWorkerWallet.create({
+ *   serviceWorker,
+ *   identity,
+ *   arkServerUrl: 'https://mutinynet.arkade.sh'
  * });
  *
  * // Use like any other wallet
@@ -27,25 +40,58 @@ import { Transaction } from "@scure/btc-signer";
  * const balance = await wallet.getBalance();
  * ```
  */
-export declare class ServiceWorkerWallet implements IWallet, Identity {
+interface ServiceWorkerWalletOptions {
+    arkServerPublicKey?: string;
+    arkServerUrl: string;
+    esploraUrl?: string;
+    identity: PrivateKeyIdentity;
+    storage?: StorageAdapter;
+}
+export type ServiceWorkerWalletCreateOptions = ServiceWorkerWalletOptions & {
+    serviceWorker: ServiceWorker;
+};
+export type ServiceWorkerWalletSetupOptions = ServiceWorkerWalletOptions & {
+    serviceWorkerPath: string;
+};
+export declare class ServiceWorkerWallet implements IWallet {
     readonly serviceWorker: ServiceWorker;
-    private cachedXOnlyPublicKey;
-    constructor(serviceWorker: ServiceWorker);
-    getStatus(): Promise<Response.WalletStatus["status"]>;
-    init(config: Omit<WalletConfig, "identity"> & {
-        privateKey: string;
-    }, failIfInitialized?: boolean): Promise<void>;
-    clear(): Promise<void>;
+    readonly walletRepository: WalletRepository;
+    readonly contractRepository: ContractRepository;
+    readonly identity: Identity;
+    private constructor();
+    static create(options: ServiceWorkerWalletCreateOptions): Promise<ServiceWorkerWallet>;
+    /**
+     * Simplified setup method that handles service worker registration,
+     * identity creation, and wallet initialization automatically.
+     *
+     * @example
+     * ```typescript
+     * // One-liner setup - handles everything automatically!
+     * const wallet = await ServiceWorkerWallet.setup({
+     *   serviceWorkerPath: '/service-worker.js',
+     *   arkServerUrl: 'https://mutinynet.arkade.sh'
+     * });
+     *
+     * // With custom identity
+     * const identity = SingleKey.fromHex('your_private_key_hex');
+     * const wallet = await ServiceWorkerWallet.setup({
+     *   serviceWorkerPath: '/service-worker.js',
+     *   arkServerUrl: 'https://mutinynet.arkade.sh',
+     *   identity
+     * });
+     * ```
+     */
+    static setup(options: ServiceWorkerWalletSetupOptions): Promise<ServiceWorkerWallet>;
     private sendMessage;
+    clear(): Promise<void>;
     getAddress(): Promise<string>;
     getBoardingAddress(): Promise<string>;
     getBalance(): Promise<WalletBalance>;
-    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
     getBoardingUtxos(): Promise<ExtendedCoin[]>;
+    getStatus(): Promise<Response.WalletStatus["status"]>;
+    getTransactionHistory(): Promise<ArkTransaction[]>;
+    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
     sendBitcoin(params: SendBitcoinParams): Promise<string>;
     settle(params?: SettleParams, callback?: (event: SettlementEvent) => void): Promise<string>;
-    getTransactionHistory(): Promise<ArkTransaction[]>;
-    xOnlyPublicKey(): Uint8Array;
-    signerSession(): SignerSession;
-    sign(tx: Transaction, inputIndexes?: number[]): Promise<Transaction>;
 }
+export {};

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

@@ -1,16 +1,28 @@
-import { VtxoRepository } from "./db/vtxo";
 /**
  * Worker is a class letting to interact with ServiceWorkerWallet from the client
  * it aims to be run in a service worker context
  */
 export declare class Worker {
-    private readonly vtxoRepository;
     private readonly messageCallback;
     private wallet;
     private arkProvider;
     private indexerProvider;
     private vtxoSubscription;
-    constructor(vtxoRepository?: VtxoRepository, messageCallback?: (message: ExtendableMessageEvent) => void);
+    private walletRepository;
+    private storage;
+    constructor(messageCallback?: (message: ExtendableMessageEvent) => void);
+    /**
+     * Get spendable vtxos for the current wallet address
+     */
+    private getSpendableVtxos;
+    /**
+     * Get swept vtxos for the current wallet address
+     */
+    private getSweptVtxos;
+    /**
+     * Get all vtxos categorized by type
+     */
+    private getAllVtxos;
     start(withServiceWorkerUpdate?: boolean): Promise<void>;
     clear(): Promise<void>;
     reload(): Promise<void>;
@@ -27,6 +39,6 @@ export declare class Worker {
     private handleGetBoardingUtxos;
     private handleGetTransactionHistory;
     private handleGetStatus;
-    private handleSign;
     private handleMessage;
+    private sendMessageToAllClients;
 }

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

@@ -1,4 +1,4 @@
-import { Transaction } from "@scure/btc-signer";
+import { Transaction } from "@scure/btc-signer/transaction.js";
 import { ChainTx, IndexerProvider } from "../providers/indexer";
 import { AnchorBumper } from "../utils/anchor";
 import { OnchainProvider } from "../providers/onchain";

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

@@ -5,9 +5,11 @@ import { OnchainProvider } from "../providers/onchain";
 import { SettlementEvent, ArkProvider } from "../providers/ark";
 import { Identity } from "../identity";
 import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IWallet, SendBitcoinParams, SettleParams, VirtualCoin, WalletBalance, WalletConfig } from ".";
-import { Bytes } from "@scure/btc-signer/utils";
+import { Bytes } from "@scure/btc-signer/utils.js";
 import { CSVMultisigTapscript } from "../script/tapscript";
 import { IndexerProvider } from "../providers/indexer";
+import { WalletRepository } from "../repositories/walletRepository";
+import { ContractRepository } from "../repositories/contractRepository";
 export type IncomingFunds = {
     type: "utxo";
     coins: Coin[];
@@ -54,6 +56,8 @@ export declare class Wallet implements IWallet {
     readonly forfeitOutputScript: Bytes;
     readonly dustAmount: bigint;
     static MIN_FEE_RATE: number;
+    readonly walletRepository: WalletRepository;
+    readonly contractRepository: ContractRepository;
     private constructor();
     static create(config: WalletConfig): Promise<Wallet>;
     get arkAddress(): ArkAddress;