@arkade-os/sdk 0.4.17 → 0.4.19

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

@@ -7,7 +7,7 @@ import { OnchainProvider } from "../providers/onchain";
 import { ArkProvider, SettlementEvent, SignedIntent } from "../providers/ark";
 import { SignerSession } from "../tree/signingSession";
 import { Identity, ReadonlyIdentity } from "../identity";
-import { ArkTransaction, Recipient, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IReadonlyWallet, IWallet, ReadonlyWalletConfig, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig, IAssetManager, IReadonlyAssetManager } from ".";
+import { ArkTransaction, Coin, ExtendedCoin, ExtendedVirtualCoin, GetVtxosFilter, IAssetManager, IReadonlyAssetManager, IReadonlyWallet, IWallet, ReadonlyWalletConfig, Recipient, SendBitcoinParams, SettleParams, WalletBalance, WalletConfig } from ".";
 import { CSVMultisigTapscript } from "../script/tapscript";
 import { SettlementConfig, VtxoManager } from "./vtxo-manager";
 import { Intent } from "../intent";
@@ -44,6 +44,7 @@ export declare class ReadonlyWallet implements IReadonlyWallet {
     protected readonly watcherConfig?: ReadonlyWalletConfig["watcherConfig"];
     private readonly _assetManager;
     private _syncVtxosInflight?;
+    protected _pendingSpendOutpoints: Set<string>;
     get assetManager(): IReadonlyAssetManager;
     protected constructor(identity: ReadonlyIdentity, network: Network, onchainProvider: OnchainProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, delegatorProvider?: DelegatorProvider | undefined, watcherConfig?: ReadonlyWalletConfig["watcherConfig"]);
     /**
@@ -97,21 +98,10 @@ export declare class ReadonlyWallet implements IReadonlyWallet {
      */
     getTransactionHistory(): Promise<ArkTransaction[]>;
     /**
-     * Delta-sync wallet virtual outputs: fetch only changed virtual outputs since the last
-     * cursor, or do a full bootstrap when no cursor exists. Upserts
-     * the result into the cache and advances the sync cursors.
-     *
-     * Concurrent calls are deduplicated: if a sync is already in flight,
-     * subsequent callers receive the same promise instead of triggering
-     * a second network round-trip.
-     */
-    private syncVtxos;
-    private doSyncVtxos;
-    /**
-     * Clear all virtual output sync cursors, forcing a full re-bootstrap on next sync.
+     * Clear the global VTXO sync cursor, forcing a full re-bootstrap on next sync.
      * Useful for recovery after indexer reprocessing or debugging.
      */
-    clearSyncCursors(): Promise<void>;
+    clearSyncCursor(): Promise<void>;
     /**
      * Build a transaction history view for the wallet's boarding address.
      */
@@ -211,7 +201,6 @@ export declare class ReadonlyWallet implements IReadonlyWallet {
  * ```
  */
 export declare class Wallet extends ReadonlyWallet implements IWallet {
-    readonly networkName: NetworkName;
     readonly arkProvider: ArkProvider;
     readonly serverUnrollScript: CSVMultisigTapscript.Type;
     readonly forfeitOutputScript: Bytes;
@@ -229,6 +218,8 @@ export declare class Wallet extends ReadonlyWallet implements IWallet {
      * same VTXO inputs.
      */
     private _txLock;
+    private _addPendingSpends;
+    private _removePendingSpends;
     private _withTxLock;
     /** @deprecated Use settlementConfig instead */
     readonly renewalConfig: Required<Omit<WalletConfig["renewalConfig"], "enabled">> & {
@@ -236,7 +227,7 @@ export declare class Wallet extends ReadonlyWallet implements IWallet {
         thresholdMs: number;
     };
     readonly settlementConfig: SettlementConfig | false;
-    protected constructor(identity: Identity, network: Network, networkName: NetworkName, onchainProvider: OnchainProvider, arkProvider: ArkProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, serverUnrollScript: CSVMultisigTapscript.Type, forfeitOutputScript: Bytes, forfeitPubkey: Bytes, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, 
+    protected constructor(identity: Identity, network: Network, onchainProvider: OnchainProvider, arkProvider: ArkProvider, indexerProvider: IndexerProvider, arkServerPublicKey: Bytes, offchainTapscript: DefaultVtxo.Script | DelegateVtxo.Script, boardingTapscript: DefaultVtxo.Script, serverUnrollScript: CSVMultisigTapscript.Type, forfeitOutputScript: Bytes, forfeitPubkey: Bytes, dustAmount: bigint, walletRepository: WalletRepository, contractRepository: ContractRepository, 
     /** @deprecated Use settlementConfig */
     renewalConfig?: WalletConfig["renewalConfig"], delegatorProvider?: DelegatorProvider, watcherConfig?: WalletConfig["watcherConfig"], settlementConfig?: WalletConfig["settlementConfig"]);
     get assetManager(): IAssetManager;
@@ -302,7 +293,7 @@ export declare class Wallet extends ReadonlyWallet implements IWallet {
      * @param session - Optional musig2 signing session. When omitted, signing steps are skipped.
      */
     createBatchHandler(intentId: string, inputs: ExtendedCoin[], expectedRecipients: Recipient[], session?: SignerSession): Batch.Handler;
-    safeRegisterIntent(intent: SignedIntent<Intent.RegisterMessage>): Promise<string>;
+    safeRegisterIntent(intent: SignedIntent<Intent.RegisterMessage>, inputs: ExtendedCoin[]): Promise<string>;
     makeRegisterIntentSignature(coins: ExtendedCoin[], outputs: TransactionOutput[], onchainOutputsIndexes: number[], cosignerPubKeys: string[], validAt?: number): Promise<SignedIntent<Intent.RegisterMessage>>;
     makeDeleteIntentSignature(coins: ExtendedCoin[]): Promise<SignedIntent<Intent.DeleteMessage>>;
     makeGetPendingTxIntentSignature(coins: ExtendedVirtualCoin[]): Promise<SignedIntent<Intent.GetPendingTxMessage>>;

package/dist/types/worker/expo/processors/contractPollProcessor.d.ts

@@ -6,9 +6,14 @@ export declare const CONTRACT_POLL_TASK_TYPE = "contract-poll";
  *
  * Replicates the polling subset of @see ContractManager.initialize:
  * 1. Load all contracts from the contract repository.
- * 2. Mark expired active contracts as inactive.
- * 3. Paginated fetch of spendable VTXOs from the indexer.
- * 4. Extend each VTXO with tapscript data.
- * 5. Save to the wallet repository.
+ * 2. Paginated fetch of every VTXO (including spent) from the indexer.
+ * 3. Extend each VTXO with tapscript data.
+ * 4. Save to the wallet repository.
+ *
+ * NOTE: the indexer query deliberately omits `spendableOnly`. Every
+ * repository implements `saveVtxos` as an upsert with no batch delete,
+ * so filtering to spendable-only would leave VTXOs that became spent
+ * between polls marked as spendable forever. Fetching the full set lets
+ * the upsert overwrite stale records with their latest state.
  */
 export declare const contractPollProcessor: TaskProcessor;

package/dist/types/worker/expo/taskRunner.d.ts

@@ -5,16 +5,20 @@ import type { IndexerProvider } from "../../providers/indexer";
 import type { ArkProvider } from "../../providers/ark";
 import type { ExtendedVirtualCoin, VirtualCoin } from "../../wallet";
 import type { Contract } from "../../contracts/types";
-import type { ReadonlyWallet } from "../../wallet/wallet";
 /**
  * Shared dependencies injected into every processor at runtime.
+ *
+ * `extendVtxo` requires the owning contract — processors must resolve each
+ * vtxo's `script` to a known contract (via the contract repository) before
+ * calling this. The strict signature prevents the footgun where a missing
+ * contract silently falls back to the wallet's default tapscript.
  */
 export interface TaskDependencies {
     walletRepository: WalletRepository;
     contractRepository: ContractRepository;
     indexerProvider: IndexerProvider;
     arkProvider: ArkProvider;
-    extendVtxo: (vtxo: VirtualCoin, contract?: Contract) => ExtendedVirtualCoin;
+    extendVtxo: (vtxo: VirtualCoin, contract: Contract) => ExtendedVirtualCoin;
 }
 /**
  * A stateless unit that handles one type of task item.
@@ -49,7 +53,6 @@ export interface CreateTaskDependenciesOptions {
     contractRepository: ContractRepository;
     indexerProvider: IndexerProvider;
     arkProvider: ArkProvider;
-    offchainTapscript: ReadonlyWallet["offchainTapscript"];
 }
 /**
  * Build the @see TaskDependencies needed by task processors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkade-os/sdk",
-  "version": "0.4.17",
+  "version": "0.4.19",
   "description": "TypeScript SDK for building Bitcoin wallets using the Arkade protocol",
   "type": "module",
   "main": "./dist/cjs/index.js",