@arkade-os/sdk 0.4.25 → 0.4.27

package/dist/types/contracts/contractManager.d.ts

@@ -1,13 +1,30 @@
-import { IndexerProvider } from "../providers/indexer";
-import { WalletRepository } from "../repositories/walletRepository";
-import { Contract, ContractEventCallback, ContractState, ContractWithVtxos, GetContractsFilter, PathSelection } from "./types";
-import { ContractWatcherConfig } from "./contractWatcher";
-import { ExtendedVirtualCoin, Outpoint, VirtualCoin } from "../wallet";
-import { ContractRepository } from "../repositories";
+import { IndexerProvider } from "../providers/indexer.js";
+import { WalletRepository } from "../repositories/walletRepository.js";
+import { Contract, ContractEventCallback, ContractState, ContractWithVtxos, GetContractsFilter, PathSelection } from "./types.js";
+import { ContractWatcherConfig } from "./contractWatcher.js";
+import { ExtendedVirtualCoin, Outpoint, VirtualCoin } from "../wallet/index.js";
+import { ContractRepository } from "../repositories/index.js";
 export type RefreshVtxosOptions = {
     scripts?: string[];
     after?: number;
     before?: number;
+    /**
+     * When true and `scripts` is not set, refresh every contract in
+     * the repository — including those marked `inactive` and those
+     * that have dropped out of the watcher's active set. Useful for
+     * "did anyone send funds to a stale rotated display address?"
+     * audits.
+     *
+     * Because this is a *superset* of the watcher's watched set, the
+     * cursor invariant still holds and the cursor advances normally
+     * (unless an explicit `after` / `before` window is also supplied).
+     *
+     * Ignored when `scripts` is set (the explicit list already
+     * specifies what to refresh, regardless of contract state).
+     *
+     * @defaultValue `false`
+     */
+    includeInactive?: boolean;
 };
 export interface IContractManager extends Disposable {
     /**
@@ -320,9 +337,22 @@ export declare class ContractManager implements IContractManager {
     /**
      * Force refresh virtual outputs from the indexer.
      *
-     * Without options, re-fetches every contract and advances the global cursor.
-     * With options, narrows the refresh to specific scripts and/or a time window.
-     * Subset refreshes (scripts filter) intentionally do not advance the cursor.
+     * Without options, re-fetches every contract in the watcher's
+     * watched set and advances the global cursor.
+     *
+     * `scripts` narrows the refresh to a specific list (subset query —
+     * cursor is not advanced because contracts outside the list may
+     * have data we'd skip).
+     *
+     * `includeInactive: true` (and no `scripts`) widens the refresh to
+     * every contract in the repository, including ones marked
+     * `inactive` and ones that have dropped out of the watcher's
+     * active set. This is a *superset* of the watched set, so the
+     * cursor invariant still holds and the cursor advances normally.
+     *
+     * `after` / `before` apply a caller-supplied time window. The
+     * cursor never advances on a windowed query because the window
+     * may skip data outside its bounds.
      */
     refreshVtxos(opts?: RefreshVtxosOptions): Promise<void>;
     refreshOutpoints(outpoints: Outpoint[]): Promise<void>;

package/dist/types/contracts/contractWatcher.d.ts

@@ -1,6 +1,6 @@
-import { IndexerProvider } from "../providers/indexer";
-import { WalletRepository } from "../repositories/walletRepository";
-import { Contract, ContractEventCallback } from "./types";
+import { IndexerProvider } from "../providers/indexer.js";
+import { WalletRepository } from "../repositories/walletRepository.js";
+import { Contract, ContractEventCallback } from "./types.js";
 /**
  * Configuration for the ContractWatcher.
  *

package/dist/types/contracts/handlers/default.d.ts

@@ -1,6 +1,6 @@
-import { DefaultVtxo } from "../../script/default";
-import { RelativeTimelock } from "../../script/tapscript";
-import { ContractHandler } from "../types";
+import { DefaultVtxo } from "../../script/default.js";
+import { RelativeTimelock } from "../../script/tapscript.js";
+import { ContractHandler } from "../types.js";
 /**
  * Typed parameters for DefaultVtxo contracts.
  */

package/dist/types/contracts/handlers/delegate.d.ts

@@ -1,6 +1,6 @@
-import { DelegateVtxo } from "../../script/delegate";
-import { RelativeTimelock } from "../../script/tapscript";
-import { ContractHandler } from "../types";
+import { DelegateVtxo } from "../../script/delegate.js";
+import { RelativeTimelock } from "../../script/tapscript.js";
+import { ContractHandler } from "../types.js";
 /**
  * Typed parameters for DelegateVtxo contracts.
  */

package/dist/types/contracts/handlers/helpers.d.ts

@@ -1,4 +1,4 @@
-import { Contract, PathContext } from "../types";
+import { Contract, PathContext } from "../types.js";
 /**
  * Resolve wallet's role from explicit role or by matching descriptor/pubkey.
  */

package/dist/types/contracts/handlers/index.d.ts

@@ -1,7 +1,7 @@
-export { contractHandlers } from "./registry";
-export { DefaultContractHandler } from "./default";
-export type { DefaultContractParams } from "./default";
-export { DelegateContractHandler } from "./delegate";
-export type { DelegateContractParams } from "./delegate";
-export { VHTLCContractHandler } from "./vhtlc";
-export type { VHTLCContractParams } from "./vhtlc";
+export { contractHandlers } from "./registry.js";
+export { DefaultContractHandler } from "./default.js";
+export type { DefaultContractParams } from "./default.js";
+export { DelegateContractHandler } from "./delegate.js";
+export type { DelegateContractParams } from "./delegate.js";
+export { VHTLCContractHandler } from "./vhtlc.js";
+export type { VHTLCContractParams } from "./vhtlc.js";

package/dist/types/contracts/handlers/registry.d.ts

@@ -1,4 +1,4 @@
-import { ContractHandler } from "../types";
+import { ContractHandler } from "../types.js";
 /**
  * Registry for contract handlers.
  *

package/dist/types/contracts/handlers/vhtlc.d.ts

@@ -1,6 +1,6 @@
-import { VHTLC } from "../../script/vhtlc";
-import { RelativeTimelock } from "../../script/tapscript";
-import { ContractHandler } from "../types";
+import { VHTLC } from "../../script/vhtlc.js";
+import { RelativeTimelock } from "../../script/tapscript.js";
+import { ContractHandler } from "../types.js";
 /**
  * Typed parameters for VHTLC contracts.
  */

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

@@ -1,14 +1,14 @@
-export * from "./types";
-export { contractHandlers } from "./handlers";
-export { DefaultContractHandler } from "./handlers";
-export type { DefaultContractParams } from "./handlers";
-export { DelegateContractHandler } from "./handlers";
-export type { DelegateContractParams } from "./handlers";
-export { VHTLCContractHandler } from "./handlers";
-export type { VHTLCContractParams } from "./handlers";
-export { encodeArkContract, decodeArkContract, contractFromArkContract, contractFromArkContractWithAddress, isArkContract, } from "./arkcontract";
-export type { ParsedArkContract } from "./arkcontract";
-export { ContractWatcher } from "./contractWatcher";
-export type { ContractWatcherConfig } from "./contractWatcher";
-export { ContractManager } from "./contractManager";
-export type { ContractManagerConfig, CreateContractParams, RefreshVtxosOptions, } from "./contractManager";
+export * from "./types.js";
+export { contractHandlers } from "./handlers/index.js";
+export { DefaultContractHandler } from "./handlers/index.js";
+export type { DefaultContractParams } from "./handlers/index.js";
+export { DelegateContractHandler } from "./handlers/index.js";
+export type { DelegateContractParams } from "./handlers/index.js";
+export { VHTLCContractHandler } from "./handlers/index.js";
+export type { VHTLCContractParams } from "./handlers/index.js";
+export { encodeArkContract, decodeArkContract, contractFromArkContract, contractFromArkContractWithAddress, isArkContract, } from "./arkcontract.js";
+export type { ParsedArkContract } from "./arkcontract.js";
+export { ContractWatcher } from "./contractWatcher.js";
+export type { ContractWatcherConfig } from "./contractWatcher.js";
+export { ContractManager } from "./contractManager.js";
+export type { ContractManagerConfig, CreateContractParams, RefreshVtxosOptions, } from "./contractManager.js";

package/dist/types/contracts/types.d.ts

@@ -1,7 +1,7 @@
 import { Bytes } from "@scure/btc-signer/utils.js";
-import { EncodedVtxoScript, TapLeafScript, VtxoScript } from "../script/base";
-import { VirtualCoin, TapLeaves } from "../wallet";
-import { ContractFilter } from "../repositories";
+import { EncodedVtxoScript, TapLeafScript, VtxoScript } from "../script/base.js";
+import { ExtendedVirtualCoin, VirtualCoin, TapLeaves } from "../wallet/index.js";
+import { ContractFilter } from "../repositories/index.js";
 /**
  * Contract state indicating whether it should be actively monitored.
  */
@@ -70,6 +70,23 @@ export type ContractVtxo = VirtualCoin & Partial<TapLeaves & EncodedVtxoScript>
     extraWitness?: Bytes[];
     contractScript: string;
 };
+/**
+ * A {@link ContractVtxo} with all taproot annotation fields required.
+ *
+ * Mirrors the {@link ExtendedVirtualCoin} / {@link VirtualCoin} split:
+ * - {@link ContractVtxo} carries `TapLeaves` and `EncodedVtxoScript` as
+ *   `Partial<>` because VTXOs fetched raw from the indexer do not yet have
+ *   taproot data.
+ * - `ExtendedContractVtxo` narrows those fields to required, guaranteeing
+ *   that `annotateVtxos` has run and the taproot leaves are present.
+ *
+ * Use this type (instead of {@link ContractVtxo}) wherever the compiler
+ * should enforce that annotation has happened — e.g. `saveVtxos` and
+ * forfeit transaction construction.
+ */
+export type ExtendedContractVtxo = ExtendedVirtualCoin & {
+    contractScript: string;
+};
 /**
  * Result of path selection, including the tapleaf to use and any extra witness data.
  */
@@ -218,7 +235,7 @@ export type GetContractsFilter = ContractFilter;
  */
 export type ContractWithVtxos = {
     contract: Contract;
-    vtxos: ContractVtxo[];
+    vtxos: ExtendedContractVtxo[];
 };
 /**
  * Summary of a contract's balance.

package/dist/types/contracts/vtxoOwnership.d.ts

@@ -1,6 +1,6 @@
-import type { ExtendedVirtualCoin, VirtualCoin } from "../wallet";
-import type { WalletRepository } from "../repositories/walletRepository";
-import type { Contract } from "./types";
+import type { ExtendedVirtualCoin, VirtualCoin } from "../wallet/index.js";
+import type { WalletRepository } from "../repositories/walletRepository.js";
+import type { Contract } from "./types.js";
 /**
  * Tier 1 helpers that enforce VTXO ownership at call sites that already know
  * the intended contract script. Address-keyed repositories may still hand back

package/dist/types/extension/asset/assetGroup.d.ts

@@ -1,9 +1,9 @@
-import { AssetId } from "./assetId";
-import { AssetRef } from "./assetRef";
-import { AssetInput } from "./assetInput";
-import { AssetOutput } from "./assetOutput";
-import { Metadata } from "./metadata";
-import { BufferReader, BufferWriter } from "./utils";
+import { AssetId } from "./assetId.js";
+import { AssetRef } from "./assetRef.js";
+import { AssetInput } from "./assetInput.js";
+import { AssetOutput } from "./assetOutput.js";
+import { Metadata } from "./metadata.js";
+import { BufferReader, BufferWriter } from "./utils.js";
 /**
  * An asset group contains inputs, outputs, and all data related to a given asset id.
  *

package/dist/types/extension/asset/assetId.d.ts

@@ -1,4 +1,4 @@
-import { BufferReader, BufferWriter } from "./utils";
+import { BufferReader, BufferWriter } from "./utils.js";
 /**
  * AssetId identifies a specific asset.
  *

package/dist/types/extension/asset/assetInput.d.ts

@@ -1,5 +1,5 @@
-import { AssetInputType } from "./types";
-import { BufferReader, BufferWriter } from "./utils";
+import { AssetInputType } from "./types.js";
+import { BufferReader, BufferWriter } from "./utils.js";
 type AssetInputLocal = {
     type: AssetInputType.Local;
     vin: number;

package/dist/types/extension/asset/assetOutput.d.ts

@@ -1,4 +1,4 @@
-import { BufferReader, BufferWriter } from "./utils";
+import { BufferReader, BufferWriter } from "./utils.js";
 /**
  * AssetOutput references a real transaction output and specify the amount in satoshis.
  * it must be present in an AssetGroup.

package/dist/types/extension/asset/assetRef.d.ts

@@ -1,6 +1,6 @@
-import { AssetRefType } from "./types";
-import { AssetId } from "./assetId";
-import { BufferReader, BufferWriter } from "./utils";
+import { AssetRefType } from "./types.js";
+import { AssetId } from "./assetId.js";
+import { BufferReader, BufferWriter } from "./utils.js";
 type AssetRefByID = {
     type: AssetRefType.ByID;
     assetId: AssetId;

package/dist/types/extension/asset/index.d.ts

@@ -1,8 +1,8 @@
-export { AssetInputType, AssetRefType } from "./types";
-export { AssetId } from "./assetId";
-export { AssetRef } from "./assetRef";
-export { AssetInput, AssetInputs } from "./assetInput";
-export { AssetOutput, AssetOutputs } from "./assetOutput";
-export { Metadata, MetadataList } from "./metadata";
-export { AssetGroup } from "./assetGroup";
-export { Packet } from "./packet";
+export { AssetInputType, AssetRefType } from "./types.js";
+export { AssetId } from "./assetId.js";
+export { AssetRef } from "./assetRef.js";
+export { AssetInput, AssetInputs } from "./assetInput.js";
+export { AssetOutput, AssetOutputs } from "./assetOutput.js";
+export { Metadata, MetadataList } from "./metadata.js";
+export { AssetGroup } from "./assetGroup.js";
+export { Packet } from "./packet.js";

package/dist/types/extension/asset/metadata.d.ts

@@ -1,5 +1,5 @@
 import { Bytes } from "@scure/btc-signer/utils.js";
-import { BufferReader, BufferWriter } from "./utils";
+import { BufferReader, BufferWriter } from "./utils.js";
 /**
  * Metadata represents a key-value pair.
  * @param key - the key

package/dist/types/extension/asset/packet.d.ts

@@ -1,5 +1,5 @@
-import type { ExtensionPacket } from "../packet";
-import { AssetGroup } from "./assetGroup";
+import type { ExtensionPacket } from "../packet.js";
+import { AssetGroup } from "./assetGroup.js";
 /**
  * Packet represents a collection of asset groups.
  * It encodes/decodes as raw bytes only — OP_RETURN framing is handled by the Extension module.

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

@@ -1,9 +1,9 @@
-import { Packet } from "./asset/packet";
-import { ExtensionPacket } from "./packet";
-import type { TransactionOutput } from "@scure/btc-signer/psbt";
-import type { Transaction } from "../utils/transaction";
-export type { ExtensionPacket } from "./packet";
-export { UnknownPacket } from "./packet";
+import { Packet } from "./asset/packet.js";
+import { ExtensionPacket } from "./packet.js";
+import type { TransactionOutput } from "@scure/btc-signer/psbt.js";
+import type { Transaction } from "../utils/transaction.js";
+export type { ExtensionPacket } from "./packet.js";
+export { UnknownPacket } from "./packet.js";
 /**
  * ArkadeMagic is the 3-byte magic prefix ("ARK") that identifies an OP_RETURN
  * output as an Arkade extension blob.

package/dist/types/forfeit.d.ts

@@ -1,4 +1,4 @@
-import { Transaction } from "./utils/transaction";
+import { Transaction } from "./utils/transaction.js";
 import { TransactionInputUpdate, TransactionOutput } from "@scure/btc-signer/psbt.js";
 /**
  * Build a forfeit transaction that spends the provided inputs to a single forfeit output.

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

@@ -1,4 +1,4 @@
-import { Transaction } from "../utils/transaction";
+import { Transaction } from "../utils/transaction.js";
 /** A signing request that pairs a descriptor with a transaction. */
 export interface DescriptorSigningRequest {
     /** Descriptor identifying which key to sign with */
@@ -18,6 +18,13 @@ export interface DescriptorSigningRequest {
  * The provider has no read accessor for "current" — it is a pure descriptor
  * allocator. "What addresses am I currently bound to?" is a question the
  * contract repository answers, not the provider.
+ *
+ * Providers that want to participate in HD receive rotation can also
+ * implement the wallet-side `ReceiveRotatorFactory` interface (see
+ * `src/wallet/walletReceiveRotator.ts`). That extension is opt-in — the
+ * core `DescriptorProvider` contract intentionally stays free of
+ * wallet-specific concerns so HSM-backed and other minimal providers
+ * don't have to know about the receive-rotation lifecycle.
  */
 export interface DescriptorProvider {
     /**

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

@@ -1,6 +1,6 @@
-import { Identity, ReadonlyIdentity } from ".";
-import { DescriptorSigningRequest } from "./descriptorProvider";
-import { Transaction } from "../utils/transaction";
+import { Identity, ReadonlyIdentity } from "./index.js";
+import { DescriptorSigningRequest } from "./descriptorProvider.js";
+import { Transaction } from "../utils/transaction.js";
 /**
  * Read-side HD capability marker. Exposes the wildcard-suffixed account
  * descriptor *template* and the descriptor-membership predicate, but no
@@ -19,7 +19,13 @@ export interface ReadonlyHDCapableIdentity extends ReadonlyIdentity {
      * concrete descriptor by replacing the `*` with a derivation index.
      */
     readonly descriptor: string;
-    /** True iff `descriptor` derives from this identity's xpub/seed. */
+    /**
+     * True iff `descriptor` derives from this identity's xpub/seed.
+     *
+     * @deprecated Prefer `DescriptorProvider.isOurs()` via
+     * `HDDescriptorProvider` for rotating HD wallets or
+     * `StaticDescriptorProvider` for legacy single-key wallets.
+     */
     isOurs(descriptor: string): boolean;
 }
 /**
@@ -37,8 +43,29 @@ export interface ReadonlyHDCapableIdentity extends ReadonlyIdentity {
  *    explicitly-non-rotating use cases.
  */
 export interface HDCapableIdentity extends ReadonlyHDCapableIdentity, Identity {
-    /** Signs each request with the key derived from its descriptor. */
+    /**
+     * Signs each request with the key derived from its descriptor.
+     *
+     * @deprecated Prefer `DescriptorProvider.signWithDescriptor()` via
+     * `HDDescriptorProvider` or `StaticDescriptorProvider`. Identities keep
+     * this method only as backing implementation for descriptor providers.
+     */
     signWithDescriptor(requests: DescriptorSigningRequest[]): Promise<Transaction[]>;
-    /** Signs a message using the key derived from `descriptor`. */
+    /**
+     * Signs a message using the key derived from `descriptor`.
+     *
+     * @deprecated Prefer `DescriptorProvider.signMessageWithDescriptor()` via
+     * `HDDescriptorProvider` or `StaticDescriptorProvider`. Identities keep
+     * this method only as backing implementation for descriptor providers.
+     */
     signMessageWithDescriptor(descriptor: string, message: Uint8Array, signatureType?: "schnorr" | "ecdsa"): Promise<Uint8Array>;
 }
+/**
+ * Structural type guard for {@link HDCapableIdentity}. Returns `true`
+ * when the value exposes the four members the HD wallet flow relies on:
+ * `descriptor`, `isOurs`, `signWithDescriptor`, and
+ * `signMessageWithDescriptor`. Used by callers that need to opt into
+ * the HD path (e.g. installing an `HDDescriptorProvider`) without
+ * coupling to a concrete identity class.
+ */
+export declare function isHDCapableIdentity(value: unknown): value is HDCapableIdentity;

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

@@ -1,5 +1,5 @@
-import { Transaction } from "../utils/transaction";
-import { SignerSession } from "../tree/signingSession";
+import { Transaction } from "../utils/transaction.js";
+import { SignerSession } from "../tree/signingSession.js";
 export interface Identity extends ReadonlyIdentity {
     /** Returns a signer session used for musig2 tree signing flows. */
     signerSession(): SignerSession;
@@ -45,12 +45,13 @@ export interface BatchSignableIdentity extends Identity {
 }
 /** Type guard for identities that support batch signing. */
 export declare function isBatchSignable(identity: Identity): identity is BatchSignableIdentity;
-export * from "./singleKey";
-export type { NetworkOptions, DescriptorOptions, SeedIdentityOptions, MnemonicOptions, } from "./seedIdentity";
-export { SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, } from "./seedIdentity";
-export * from "./serialize";
-export { isDescriptor, normalizeToDescriptor, extractPubKey, parseHDDescriptor, } from "./descriptor";
-export type { ParsedHDDescriptor } from "./descriptor";
-export type { DescriptorProvider, DescriptorSigningRequest, } from "./descriptorProvider";
-export type { HDCapableIdentity, ReadonlyHDCapableIdentity, } from "./hdCapableIdentity";
-export { StaticDescriptorProvider } from "./staticDescriptorProvider";
+export * from "./singleKey.js";
+export type { NetworkOptions, DescriptorOptions, SeedIdentityOptions, MnemonicOptions, } from "./seedIdentity.js";
+export { SeedIdentity, MnemonicIdentity, ReadonlyDescriptorIdentity, } from "./seedIdentity.js";
+export * from "./serialize.js";
+export { isDescriptor, normalizeToDescriptor, extractPubKey, parseHDDescriptor, } from "./descriptor.js";
+export type { ParsedHDDescriptor } from "./descriptor.js";
+export type { DescriptorProvider, DescriptorSigningRequest, } from "./descriptorProvider.js";
+export type { HDCapableIdentity, ReadonlyHDCapableIdentity, } from "./hdCapableIdentity.js";
+export { isHDCapableIdentity } from "./hdCapableIdentity.js";
+export { StaticDescriptorProvider } from "./staticDescriptorProvider.js";

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

@@ -1,8 +1,8 @@
-import { Transaction } from "../utils/transaction";
-import { SignerSession } from "../tree/signingSession";
-import type { SerializedSigningIdentity, SerializedReadonlyIdentity } from "./serialize";
-import { DescriptorSigningRequest } from "./descriptorProvider";
-import { HDCapableIdentity, ReadonlyHDCapableIdentity } from "./hdCapableIdentity";
+import { Transaction } from "../utils/transaction.js";
+import { SignerSession } from "../tree/signingSession.js";
+import type { SerializedSigningIdentity, SerializedReadonlyIdentity } from "./serialize.js";
+import { DescriptorSigningRequest } from "./descriptorProvider.js";
+import { HDCapableIdentity, ReadonlyHDCapableIdentity } from "./hdCapableIdentity.js";
 /** Used for default BIP86 derivation with network selection. */
 export interface NetworkOptions {
     /**
@@ -117,15 +117,27 @@ export declare class SeedIdentity implements HDCapableIdentity {
      * Returns true when `descriptor` is derived from this identity's seed.
      * HD descriptors match by account xpub; bare `tr(pubkey)` descriptors
      * match by raw pubkey. See {@link descriptorIsOurs}.
+     *
+     * @deprecated Prefer `DescriptorProvider.isOurs()` via
+     * `HDDescriptorProvider` for rotating HD wallets or
+     * `StaticDescriptorProvider` for legacy single-key wallets.
      */
     isOurs(descriptor: string): boolean;
     /**
      * Signs each request with the key derived from its descriptor.
      * Each descriptor must share this identity's seed ({@link isOurs}).
+     *
+     * @deprecated Prefer `DescriptorProvider.signWithDescriptor()` via
+     * `HDDescriptorProvider` or `StaticDescriptorProvider`. Identities keep
+     * this method only as backing implementation for descriptor providers.
      */
     signWithDescriptor(requests: DescriptorSigningRequest[]): Promise<Transaction[]>;
     /**
      * Signs a message with the key derived from `descriptor`.
+     *
+     * @deprecated Prefer `DescriptorProvider.signMessageWithDescriptor()` via
+     * `HDDescriptorProvider` or `StaticDescriptorProvider`. Identities keep
+     * this method only as backing implementation for descriptor providers.
      */
     signMessageWithDescriptor(descriptor: string, message: Uint8Array, signatureType?: "schnorr" | "ecdsa"): Promise<Uint8Array>;
     private derivePrivateKeyForDescriptor;
@@ -212,6 +224,10 @@ export declare class ReadonlyDescriptorIdentity implements ReadonlyHDCapableIden
      * HD descriptors match by account xpub; bare `tr(pubkey)` descriptors
      * fall back to comparing against the index-0 x-only pubkey. See
      * {@link descriptorIsOurs}.
+     *
+     * @deprecated Prefer `DescriptorProvider.isOurs()` via
+     * `HDDescriptorProvider` for rotating HD wallets or
+     * `StaticDescriptorProvider` for legacy single-key wallets.
      */
     isOurs(descriptor: string): boolean;
 }

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

@@ -1,4 +1,4 @@
-import type { Identity, ReadonlyIdentity } from ".";
+import type { Identity, ReadonlyIdentity } from "./index.js";
 /**
  * Tagged envelope for a signing identity transported across the
  * service-worker boundary. All variants are structured-clone safe

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

@@ -1,6 +1,6 @@
-import { Identity, ReadonlyIdentity } from ".";
-import { Transaction } from "../utils/transaction";
-import { SignerSession } from "../tree/signingSession";
+import { Identity, ReadonlyIdentity } from "./index.js";
+import { Transaction } from "../utils/transaction.js";
+import { SignerSession } from "../tree/signingSession.js";
 /**
  * In-memory single key implementation for Bitcoin transaction signing.
  *

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

@@ -1,6 +1,6 @@
-import { Identity } from ".";
-import { DescriptorProvider, DescriptorSigningRequest } from "./descriptorProvider";
-import { Transaction } from "../utils/transaction";
+import { Identity } from "./index.js";
+import { DescriptorProvider, DescriptorSigningRequest } from "./descriptorProvider.js";
+import { Transaction } from "../utils/transaction.js";
 /**
  * Wraps a legacy Identity (single-key) as a DescriptorProvider.
  * The descriptor is always a simple tr(pubkey) format.