@arkade-os/sdk 0.3.8 → 0.3.10

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

@@ -5,12 +5,16 @@ import { DefaultVtxo } from "../script/default";
 import { Network, NetworkName } from "../networks";
 import { OnchainProvider } from "../providers/onchain";
 import { SettlementEvent, ArkProvider, SignedIntent } from "../providers/ark";
-import { Identity } from "../identity";
-import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IWallet, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig } from ".";
+import { SignerSession } from "../tree/signingSession";
+import { Identity, ReadonlyIdentity } from "../identity";
+import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IReadonlyWallet, IWallet, ReadonlyWalletConfig, SendBitcoinParams, SettleParams, VirtualCoin, WalletBalance, WalletConfig } from ".";
+import { TapLeafScript } from "../script/base";
 import { CSVMultisigTapscript } from "../script/tapscript";
+import { Intent } from "../intent";
 import { IndexerProvider } from "../providers/indexer";
-import { WalletRepository } from "../repositories/walletRepository";
-import { ContractRepository } from "../repositories/contractRepository";
+import { WalletRepository, WalletRepositoryImpl } from "../repositories/walletRepository";
+import { ContractRepository, ContractRepositoryImpl } from "../repositories/contractRepository";
+import { Batch } from "./batch";
 export type IncomingFunds = {
     type: "utxo";
     coins: Coin[];
@@ -19,6 +23,52 @@ export type IncomingFunds = {
     newVtxos: ExtendedVirtualCoin[];
     spentVtxos: ExtendedVirtualCoin[];
 };
+export declare class ReadonlyWallet implements IReadonlyWallet {
+    readonly identity: ReadonlyIdentity;
+    readonly network: Network;
+    readonly onchainProvider: OnchainProvider;
+    readonly indexerProvider: IndexerProvider;
+    readonly arkServerPublicKey: Bytes;
+    readonly offchainTapscript: DefaultVtxo.Script;
+    readonly boardingTapscript: DefaultVtxo.Script;
+    readonly dustAmount: bigint;
+    readonly walletRepository: WalletRepository;
+    readonly contractRepository: ContractRepository;
+    protected constructor(identity: ReadonlyIdentity, network: Network, onchainProvider: OnchainProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script, boardingTapscript: DefaultVtxo.Script, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository);
+    /**
+     * Protected helper to set up shared wallet configuration.
+     * Extracts common logic used by both ReadonlyWallet.create() and Wallet.create().
+     */
+    protected static setupWalletConfig(config: ReadonlyWalletConfig, pubkey: Uint8Array): Promise<{
+        arkProvider: ArkProvider;
+        indexerProvider: IndexerProvider;
+        onchainProvider: OnchainProvider;
+        network: Network;
+        networkName: NetworkName;
+        serverPubKey: Uint8Array<ArrayBuffer>;
+        offchainTapscript: DefaultVtxo.Script;
+        boardingTapscript: DefaultVtxo.Script;
+        dustAmount: bigint;
+        walletRepository: WalletRepositoryImpl;
+        contractRepository: ContractRepositoryImpl;
+        info: import("../providers/ark").ArkInfo;
+    }>;
+    static create(config: ReadonlyWalletConfig): Promise<ReadonlyWallet>;
+    get arkAddress(): ArkAddress;
+    getAddress(): Promise<string>;
+    getBoardingAddress(): Promise<string>;
+    getBalance(): Promise<WalletBalance>;
+    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
+    protected getVirtualCoins(filter?: GetVtxosFilter): Promise<VirtualCoin[]>;
+    getTransactionHistory(): Promise<ArkTransaction[]>;
+    getBoardingTxs(): Promise<{
+        boardingTxs: ArkTransaction[];
+        commitmentsToIgnore: Set<string>;
+    }>;
+    getBoardingUtxos(): Promise<ExtendedCoin[]>;
+    notifyIncomingFunds(eventCallback: (coins: IncomingFunds) => void): Promise<() => void>;
+    fetchPendingTxs(): Promise<string[]>;
+}
 /**
  * Main wallet implementation for Bitcoin transactions with Ark protocol support.
  * The wallet does not store any data locally and relies on Ark and onchain
@@ -52,52 +102,52 @@ export type IncomingFunds = {
  * });
  * ```
  */
-export declare class Wallet implements IWallet {
-    readonly identity: Identity;
-    readonly network: Network;
+export declare class Wallet extends ReadonlyWallet implements IWallet {
     readonly networkName: NetworkName;
-    readonly onchainProvider: OnchainProvider;
     readonly arkProvider: ArkProvider;
-    readonly indexerProvider: IndexerProvider;
-    readonly arkServerPublicKey: Bytes;
-    readonly offchainTapscript: DefaultVtxo.Script;
-    readonly boardingTapscript: DefaultVtxo.Script;
     readonly serverUnrollScript: CSVMultisigTapscript.Type;
     readonly forfeitOutputScript: Bytes;
     readonly forfeitPubkey: Bytes;
-    readonly dustAmount: bigint;
     static MIN_FEE_RATE: number;
-    readonly walletRepository: WalletRepository;
-    readonly contractRepository: ContractRepository;
+    readonly identity: Identity;
     readonly renewalConfig: Required<Omit<WalletConfig["renewalConfig"], "enabled">> & {
         enabled: boolean;
         thresholdMs: number;
     };
-    private constructor();
+    protected constructor(identity: Identity, network: Network, networkName: NetworkName, onchainProvider: OnchainProvider, arkProvider: ArkProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script, boardingTapscript: DefaultVtxo.Script, serverUnrollScript: CSVMultisigTapscript.Type, forfeitOutputScript: Bytes, forfeitPubkey: Bytes, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, renewalConfig?: WalletConfig["renewalConfig"]);
     static create(config: WalletConfig): Promise<Wallet>;
-    get arkAddress(): ArkAddress;
-    getAddress(): Promise<string>;
-    getBoardingAddress(): Promise<string>;
-    getBalance(): Promise<WalletBalance>;
-    getVtxos(filter?: GetVtxosFilter): Promise<ExtendedVirtualCoin[]>;
-    private getVirtualCoins;
-    getTransactionHistory(): Promise<ArkTransaction[]>;
-    getBoardingTxs(): Promise<{
-        boardingTxs: ArkTransaction[];
-        commitmentsToIgnore: Set<string>;
-    }>;
-    getBoardingUtxos(): Promise<ExtendedCoin[]>;
+    /**
+     * Convert this wallet to a readonly wallet.
+     *
+     * @returns A readonly wallet with the same configuration but readonly identity
+     * @example
+     * ```typescript
+     * const wallet = await Wallet.create({ identity: SingleKey.fromHex('...'), ... });
+     * const readonlyWallet = await wallet.toReadonly();
+     *
+     * // Can query balance and addresses
+     * const balance = await readonlyWallet.getBalance();
+     * const address = await readonlyWallet.getAddress();
+     *
+     * // But cannot send transactions (type error)
+     * // readonlyWallet.sendBitcoin(...); // TypeScript error
+     * ```
+     */
+    toReadonly(): Promise<ReadonlyWallet>;
     sendBitcoin(params: SendBitcoinParams): Promise<string>;
     settle(params?: SettleParams, eventCallback?: (event: SettlementEvent) => void): Promise<string>;
-    notifyIncomingFunds(eventCallback: (coins: IncomingFunds) => void): Promise<() => void>;
-    private handleBatchStartedEvent;
-    private handleSettlementSigningEvent;
-    private handleSettlementTreeNoncesEvent;
     private handleSettlementFinalizationEvent;
-    safeRegisterIntent(intent: SignedIntent): Promise<string>;
-    makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[]): Promise<SignedIntent>;
-    makeDeleteIntentSignature(coins: ExtendedCoin[]): Promise<SignedIntent>;
-    makeGetPendingTxIntentSignature(vtxos: ExtendedVirtualCoin[]): Promise<SignedIntent>;
+    /**
+     * @implements Batch.Handler interface.
+     * @param intentId - The intent ID.
+     * @param inputs - The inputs of the intent.
+     * @param session - The musig2 signing session, if not provided, the signing will be skipped.
+     */
+    createBatchHandler(intentId: string, inputs: ExtendedCoin[], session?: SignerSession): Batch.Handler;
+    safeRegisterIntent(intent: SignedIntent<Intent.RegisterMessage>): Promise<string>;
+    makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[]): Promise<SignedIntent<Intent.RegisterMessage>>;
+    makeDeleteIntentSignature(coins: ExtendedCoin[]): Promise<SignedIntent<Intent.DeleteMessage>>;
+    makeGetPendingTxIntentSignature(vtxos: ExtendedVirtualCoin[]): Promise<SignedIntent<Intent.GetPendingTxMessage>>;
     /**
      * Finalizes pending transactions by retrieving them from the server and finalizing each one.
      * @param vtxos - Optional list of VTXOs to use instead of retrieving them from the server
@@ -109,6 +159,7 @@ export declare class Wallet implements IWallet {
     }>;
     private prepareIntentProofInputs;
 }
+export declare function getSequence(tapLeafScript: TapLeafScript): number | undefined;
 /**
  * Wait for incoming funds to the wallet
  * @param wallet - The wallet to wait for incoming funds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "Bitcoin wallet SDK with Taproot and Ark integration",
   "type": "module",
   "main": "./dist/cjs/index.js",