@bsv/wallet-toolbox-client 2.4.22 → 2.6.0

package/out/index.client.d.mts

@@ -92,7 +92,7 @@ interface OutPoint {
    */
   vout: number;
 }
-type Chain = 'main' | 'test' | 'ttn' | 'tstn' | 'mock';
+type Chain = 'main' | 'test' | 'stn' | 'ttn' | 'tstn' | 'mock';
 /**
  * Initial status (attempts === 0):
  *
@@ -813,6 +813,17 @@ interface ChaintracksInfoApi {
   bulkIngestors: string[];
   liveIngestors: string[];
   packages: ChaintracksPackageInfoApi[];
+  /** Last observed source state. Additive and omitted by older services. */
+  sources?: ChaintracksSourceStatusApi[];
+}
+/** @public */
+interface ChaintracksSourceStatusApi {
+  name: string;
+  role: 'bulk' | 'live';
+  state: 'unknown' | 'healthy' | 'degraded';
+  lastSuccess?: string;
+  lastFailure?: string;
+  error?: string;
 }
 /**
  * Chaintracks client API excluding events and callbacks
@@ -2093,6 +2104,7 @@ interface FindProvenTxReqsArgs extends FindSincePagedArgs {
 }
 interface FindProvenTxsArgs extends FindSincePagedArgs {
   partial: Partial<TableProvenTx>;
+  txids?: string[];
 }
 interface FindStaleMerkleRootsArgs {
   height: number;
@@ -2603,7 +2615,8 @@ declare class ScriptTemplateBRC29 implements ScriptTemplate {
   getKeyID(): string;
   getKeyDeriver(privKey: PrivateKey | HexString): KeyDeriverApi;
   lock(lockerPrivKey: string, unlockerPubKey: string): LockingScript;
-  unlock(unlockerPrivKey: string, lockerPubKey: string, sourceSatoshis?: number, lockingScript?: Script): ScriptTemplateUnlock;
+  unlock(unlockerPrivKey: PrivateKey | HexString, lockerPubKey: PublicKey | string, sourceSatoshis?: number, lockingScript?: Script): ScriptTemplateUnlock;
+  unlockWithDerivedPrivateKey(derivedPrivateKey: PrivateKey, sourceSatoshis?: number, lockingScript?: Script): ScriptTemplateUnlock;
   /**
    * P2PKH unlock estimateLength is a constant
    */
@@ -3166,8 +3179,9 @@ declare class EntityProvenTx extends EntityBase<TableProvenTx> {
   /**
    * @returns desirialized `MerklePath` object, value is cached.
    */
-  getMerklePath(): MerklePath;
+  getMerklePath(validateRoots?: boolean): MerklePath;
   _mp?: MerklePath;
+  _mpUnchecked?: MerklePath;
   get provenTxId(): number;
   set provenTxId(v: number);
   get created_at(): Date;
@@ -3873,6 +3887,9 @@ declare abstract class StorageReaderWriter extends StorageReader {
 }
 interface StorageReaderWriterOptions extends StorageReaderOptions {}
 //#endregion
+//#region ../src/storage/methods/availableManagedChange.d.ts
+type ManagedChangeInputCandidate = Pick<TableOutput, 'outputId' | 'transactionId' | 'satoshis' | 'txid' | 'vout'>;
+//#endregion
 //#region ../src/storage/StorageProvider.d.ts
 declare abstract class StorageProvider extends StorageReaderWriter implements WalletStorageProvider {
   isDirty: boolean;
@@ -3899,11 +3916,30 @@ declare abstract class StorageProvider extends StorageReaderWriter implements Wa
   abstract allocateChangeInput(userId: number, basketId: number, targetSatoshis: number, exactSatoshis: number | undefined, excludeSending: boolean, transactionId: number): Promise<TableOutput | undefined>;
   /** Mark a planned set of change inputs spent within the caller's transaction. */
   markChangeInputsSpent(outputIds: number[], transactionId: number, trx: TrxToken): Promise<number>;
+  /**
+   * Insert outputs that do not need their generated ids returned to the
+   * caller. Engines with a multi-row insert override this common-path helper;
+   * the fallback preserves existing storage implementations unchanged.
+   */
+  insertOutputs(outputs: TableOutput[], trx?: TrxToken): Promise<void>;
   /** Return unreserved wallet-managed outputs eligible for automatic funding. */
   findAvailableManagedChangeInputs(userId: number, basketId: number, excludeSending: boolean, trx?: TrxToken): Promise<TableOutput[]>;
+  /** Read only the fields needed by the in-memory funding planner. */
+  findAvailableManagedChangeInputCandidates(userId: number, basketId: number, excludeSending: boolean, trx?: TrxToken): Promise<ManagedChangeInputCandidate[]>;
   /** Read the current status of a set of source transactions without loading raw transaction bytes. */
   findTransactionStatusesByIds(userId: number, transactionIds: number[], trx?: TrxToken): Promise<Map<number, TransactionStatus>>;
+  /**
+   * Lock and return the selected funding rows whose source transaction and
+   * action-batch reservation state still permit allocation.
+   */
+  findFundingOutputsForUpdate(userId: number, outputIds: number[], statuses: TransactionStatus[], trx: TrxToken): Promise<Record<number, TableOutput>>;
   abstract getProvenOrRawTx(txid: string, trx?: TrxToken): Promise<ProvenOrRawTx>;
+  /**
+   * Resolve several transaction proofs in one storage operation when the
+   * backend supports it. The default preserves compatibility for custom
+   * providers; SQL and IndexedDB providers override this hot path.
+   */
+  getProvenOrRawTxs(txids: string[], trx?: TrxToken): Promise<Map<string, ProvenOrRawTx>>;
   abstract getRawTxOfKnownValidTransaction(txid?: string, offset?: number, length?: number, trx?: TrxToken): Promise<number[] | undefined>;
   abstract getLabelsForTransactionId(transactionId?: number, trx?: TrxToken): Promise<TableTxLabel[]>;
   abstract getTagsForOutputId(outputId: number, trx?: TrxToken): Promise<TableOutputTag[]>;
@@ -3927,6 +3963,8 @@ declare abstract class StorageProvider extends StorageReaderWriter implements Wa
   deleteActionBatchBlobRecords(_actionBatchId: number, _trx?: TrxToken): Promise<void>;
   getCapabilities(): Promise<StorageCapabilities>;
   protected supportsActionBatchPersistence(): boolean;
+  /** Custom providers may require physical expiry cleanup before reservations are queried. */
+  protected requiresActionBatchCleanupBeforeCreateAction(): boolean;
   beginActionBatch(auth: AuthId, args: BeginActionBatchArgs): Promise<BeginActionBatchResult>;
   extendActionBatch(auth: AuthId, args: ExtendActionBatchArgs): Promise<ExtendActionBatchResult>;
   renewActionBatch(auth: AuthId, batchId: string): Promise<RenewActionBatchResult>;
@@ -4037,6 +4075,7 @@ declare abstract class StorageProvider extends StorageReaderWriter implements Wa
   private handleProvenTxBranch;
   getValidBeefForTxid(...[txid, mergeToBeef, trustSelf, knownTxids, trx, requiredLevels, chainTracker, skipInvalidProofs]: [txid: string, mergeToBeef?: Beef, trustSelf?: TrustSelf, knownTxids?: string[], trx?: TrxToken, requiredLevels?: number, chainTracker?: ChainTracker, skipInvalidProofs?: boolean]): Promise<Beef | undefined>;
   getBeefForTransaction(txid: string, options: StorageGetBeefOptions): Promise<Beef>;
+  getBeefForTransactions(txids: string[], options: StorageGetBeefOptions): Promise<Beef>;
   findMonitorEventById(id: number, trx?: TrxToken): Promise<TableMonitorEvent | undefined>;
   relinquishCertificate(auth: AuthId, args: RelinquishCertificateArgs): Promise<number>;
   relinquishOutput(auth: AuthId, args: RelinquishOutputArgs): Promise<number>;
@@ -4579,6 +4618,7 @@ declare class StorageIdb extends StorageProvider implements WalletStorageProvide
   db?: IDBPDatabase<StorageIdbSchema>;
   constructor(options: StorageIdbOptions);
   protected supportsActionBatchPersistence(): boolean;
+  protected requiresActionBatchCleanupBeforeCreateAction(): boolean;
   /**
    * This method must be called at least once before any other method accesses the database,
    * and each time the schema may have updated.
@@ -4646,6 +4686,7 @@ declare class StorageIdb extends StorageProvider implements WalletStorageProvide
    */
   allocateChangeInput(userId: number, basketId: number, targetSatoshis: number, exactSatoshis: number | undefined, excludeSending: boolean, transactionId: number): Promise<TableOutput | undefined>;
   getProvenOrRawTx(txid: string, trx?: TrxToken): Promise<ProvenOrRawTx>;
+  getProvenOrRawTxs(txids: string[], trx?: TrxToken): Promise<Map<string, ProvenOrRawTx>>;
   getRawTxOfKnownValidTransaction(txid?: string, offset?: number, length?: number, trx?: TrxToken): Promise<number[] | undefined>;
   private getRawTxForSlice;
   private getRawTxFull;
@@ -6151,7 +6192,7 @@ interface ChaintracksStorageApi extends ChaintracksStorageQueryApi, ChaintracksS
 //#region ../src/services/chaintracker/chaintracks/Api/BulkIngestorApi.d.ts
 interface BulkIngestorBaseOptions {
   /**
-   * The target chain: "main" or "test"
+   * The target chain.
    */
   chain: Chain;
   /**
@@ -6382,6 +6423,7 @@ declare class Chaintracks implements ChaintracksManagementApi {
   private lastPresentHeightMsecs;
   private readonly lastPresentHeightMaxAge;
   private readonly lock;
+  private readonly sourceStatus;
   constructor(options: ChaintracksOptions);
   getChain(): Promise<Chain>;
   /**
@@ -6441,6 +6483,9 @@ declare class Chaintracks implements ChaintracksManagementApi {
   private syncBulkStorage;
   private syncBulkStorageNoLock;
   private runBulkSyncRound;
+  private sourceName;
+  private markSourceSuccess;
+  private markSourceFailure;
   private getMissingBlockHeader;
   private invalidInsertHeaderResult;
   private addLiveHeader;
@@ -6514,6 +6559,12 @@ interface GoChaintracksServiceClientOptions {
    */
   apiPrefix?: string;
   fetch?: typeof fetch;
+  /** Timeout for HTTP requests and the initial SSE handshake. */
+  requestTimeoutMsecs?: number;
+  /** Initial delay before reconnecting a closed or failed SSE stream. */
+  reconnectWaitMsecs?: number;
+  /** Maximum SSE reconnect delay. */
+  reconnectWaitMaxMsecs?: number;
 }
 /**
  * Client for go-chaintracks compatible HTTP services, including Arcade's
@@ -6525,6 +6576,9 @@ declare class GoChaintracksServiceClient implements ChaintracksClientApi {
   chain: Chain;
   private readonly baseUrl;
   private readonly fetcher;
+  private readonly requestTimeoutMsecs;
+  private readonly reconnectWaitMsecs;
+  private readonly reconnectWaitMaxMsecs;
   private readonly subscriptions;
   private nextSubscriptionId;
   constructor(chain: Chain, serviceUrl: string, options?: GoChaintracksServiceClientOptions);
@@ -6547,11 +6601,14 @@ declare class GoChaintracksServiceClient implements ChaintracksClientApi {
   subscribeReorgs(listener: ReorgListener): Promise<string>;
   unsubscribe(subscriptionId: string): Promise<boolean>;
   private subscribe;
+  private runSseWithReconnect;
+  private waitForReconnect;
   private runSse;
   private processSseBuffer;
   private getJson;
   private getJsonOrUndefined;
   private getBinary;
+  private fetchWithTimeout;
   private url;
   private normalizeChain;
 }
@@ -7064,8 +7121,14 @@ declare function validateScriptHash(output: string, outputFormat?: GetUtxoStatus
 declare function toBinaryBaseBlockHeader(header: BaseBlockHeader): number[];
 //#endregion
 //#region ../src/services/providers/WhatsOnChain.d.ts
+interface WalletToolboxWhatsOnChainConfig extends WhatsOnChainConfig {
+  /** Optional request-start gate used by ChainTracks' shared public-rate scheduler. */
+  requestGate?: () => Promise<void>;
+}
 declare class WhatsOnChainNoServices extends SdkWhatsOnChain {
-  constructor(chain?: Chain, config?: WhatsOnChainConfig);
+  private readonly requestGate?;
+  constructor(chain?: Chain, config?: WalletToolboxWhatsOnChainConfig);
+  private requestWithAnonymousAuthFallback;
   /**
    * POST
    * https://api.whatsonchain.com/v1/bsv/main/txs/status
@@ -7151,7 +7214,7 @@ declare class WhatsOnChainNoServices extends SdkWhatsOnChain {
  */
 declare class WhatsOnChain extends WhatsOnChainNoServices {
   services: Services;
-  constructor(chain?: Chain, config?: WhatsOnChainConfig, services?: Services);
+  constructor(chain?: Chain, config?: WalletToolboxWhatsOnChainConfig, services?: Services);
   /**
    * @param txid
    * @returns
@@ -7187,14 +7250,14 @@ declare function parseFileLink(file: string): {
 } | undefined;
 interface WhatsOnChainServicesOptions {
   /**
-   * Which chain is being tracked: main, test, or stn.
+   * Which chain is being tracked. The public WhatsOnChain fallback is only
+   * configured automatically for mainnet and testnet.
    */
   chain: Chain;
   /**
-   * WhatsOnChain.com API Key
-   * https://docs.taal.com/introduction/get-an-api-key
-   * If unknown or empty, maximum request rate is limited.
-   * https://developers.whatsonchain.com/#rate-limits
+   * Optional WhatsOnChain API key. ChainTracks works without one and limits
+   * anonymous traffic to the documented public rate.
+   * https://docs.whatsonchain.com/
    */
   apiKey?: string;
   /**
@@ -7213,6 +7276,8 @@ interface WhatsOnChainServicesOptions {
    * How long chainInfo is considered still valid before updating (msecs).
    */
   chainInfoMsecs: number;
+  /** Minimum interval between keyless API request starts. Defaults below 3 requests/second. */
+  minRequestIntervalMsecs?: number;
 }
 declare class WhatsOnChainServices {
   options: WhatsOnChainServicesOptions;
@@ -7220,6 +7285,9 @@ declare class WhatsOnChainServices {
   static readonly chainInfo: Array<WocChainInfo | undefined>;
   static readonly chainInfoTime: Array<Date | undefined>;
   static readonly chainInfoMsecs: number[];
+  static readonly chainInfoPromise: Partial<Record<Chain, Promise<WocChainInfo>>>;
+  private static requestTail;
+  private static nextRequestMsecs;
   chain: Chain;
   woc: WhatsOnChain;
   constructor(options: WhatsOnChainServicesOptions);
@@ -7233,6 +7301,7 @@ declare class WhatsOnChainServices {
    */
   getHeaders(fetch?: ChaintracksFetchApi): Promise<WocGetHeadersHeader[]>;
   getHeaderByteFileLinks(neededRange: HeightRange, fetch?: ChaintracksFetchApi): Promise<GetHeaderByteFileLinksResult[]>;
+  private waitForRateLimit;
 }
 interface WocGetHeaderByteFileLinks {
   files: string[];
@@ -7319,6 +7388,28 @@ declare class BulkIngestorWhatsOnChainCdn extends BulkIngestorBase {
   fetchHeaders(before: HeightRanges, fetchRange: HeightRange, bulkRange: HeightRange, priorLiveHeaders: BlockHeader[]): Promise<BlockHeader[]>;
 }
 //#endregion
+//#region ../src/services/chaintracker/chaintracks/Ingest/BulkIngestorChaintracks.d.ts
+interface BulkIngestorChaintracksOptions extends BulkIngestorBaseOptions {
+  chain: Chain;
+  chaintracks: ChaintracksClientApi;
+  /** Maximum headers requested from the upstream service at once. */
+  maxHeadersPerRequest?: number;
+}
+/**
+ * Uses a go-chaintracks/Arcade-compatible service as a validated bulk source.
+ * Retrieved bytes still pass through ChainTracks' local serialization, hash,
+ * continuity, and genesis checks before storage.
+ */
+declare class BulkIngestorChaintracks extends BulkIngestorBase {
+  private readonly chaintracks;
+  private readonly maxHeadersPerRequest;
+  private networkChecked;
+  constructor(options: BulkIngestorChaintracksOptions);
+  getPresentHeight(): Promise<number>;
+  fetchHeaders(_before: HeightRanges, fetchRange: HeightRange, bulkRange: HeightRange, priorLiveHeaders: BlockHeader[]): Promise<BlockHeader[]>;
+  private ensureNetwork;
+}
+//#endregion
 //#region ../src/services/chaintracker/chaintracks/Ingest/LiveIngestorWhatsOnChainPoll.d.ts
 interface LiveIngestorWhatsOnChainOptions extends LiveIngestorBaseOptions, WhatsOnChainServicesOptions {
   /**
@@ -7432,6 +7523,9 @@ interface ChaintracksStorageNoDbOptions extends ChaintracksStorageBaseOptions {}
 declare class ChaintracksStorageNoDb extends ChaintracksStorageBase {
   static readonly mainData: ChaintracksNoDbData;
   static readonly testData: ChaintracksNoDbData;
+  static readonly stnData: ChaintracksNoDbData;
+  static readonly ttnData: ChaintracksNoDbData;
+  static readonly tstnData: ChaintracksNoDbData;
   constructor(options: ChaintracksStorageNoDbOptions);
   destroy(): Promise<void>;
   getData(): Promise<ChaintracksNoDbData>;
@@ -7544,8 +7638,67 @@ interface ChaintracksStorageIdbSchema {
 }
 //#endregion
 //#region ../src/services/chaintracker/chaintracks/configureChaintracksIngestors.d.ts
-type ChaintracksArgumentsTail = [whatsonchainApiKey?: string, maxPerFile?: number, maxRetained?: number, fetch?: ChaintracksFetchApi, cdnUrl?: string, liveHeightThreshold?: number, reorgHeightThreshold?: number, bulkMigrationChunkSize?: number, batchInsertLimit?: number, addLiveRecursionLimit?: number];
+interface ChaintracksSourceOptions {
+  /** Preferred go-chaintracks or Arcade source. */
+  chaintracks?: ChaintracksClientApi;
+  /** Disable the credential-free public Arcade default. */
+  disableChaintracks?: boolean;
+  /** Maximum number of headers requested from the remote source at once. */
+  remoteMaxHeadersPerRequest?: number;
+  /** Disable the configured CDN source without changing its URL. */
+  disableCdn?: boolean;
+  /** Disable the keyless WhatsOnChain fallback on mainnet/testnet. */
+  disableWhatsOnChain?: boolean;
+}
+type ChaintracksArgumentsTail = [whatsonchainApiKey?: string, maxPerFile?: number, maxRetained?: number, fetch?: ChaintracksFetchApi, cdnUrl?: string, liveHeightThreshold?: number, reorgHeightThreshold?: number, bulkMigrationChunkSize?: number, batchInsertLimit?: number, addLiveRecursionLimit?: number, sources?: ChaintracksSourceOptions];
 type DefaultChaintracksArguments = [chain: Chain, ...options: ChaintracksArgumentsTail];
+/**
+ * Shared parameters for configuring Chaintracks ingestors.
+ */
+interface ChaintracksIngestorParams {
+  chain: Chain;
+  whatsonchainApiKey: string;
+  maxPerFile: number;
+  fetch: ChaintracksFetchApi;
+  cdnUrl: string;
+  addLiveRecursionLimit: number;
+  sources: ChaintracksSourceOptions;
+}
+interface ResolvedDefaultChaintracksParams extends ChaintracksIngestorParams {
+  maxRetained: number;
+  liveHeightThreshold: number;
+  reorgHeightThreshold: number;
+  bulkMigrationChunkSize: number;
+  batchInsertLimit: number;
+}
+interface CreatedChaintracks<TStorage extends ChaintracksOptions['storage']> {
+  chain: Chain;
+  maxPerFile: number;
+  fetch: ChaintracksFetchApi;
+  storage: TStorage;
+  chaintracks: Chaintracks;
+  available: Promise<void>;
+}
+declare function resolveDefaultChaintracksArguments(args: DefaultChaintracksArguments): ResolvedDefaultChaintracksParams;
+declare function toDefaultChaintracksArguments(params: ResolvedDefaultChaintracksParams): DefaultChaintracksArguments;
+declare function createDefaultBulkFileDataManager(params: ResolvedDefaultChaintracksParams): BulkFileDataManager;
+declare function createDefaultChaintracksStorageOptions(params: ResolvedDefaultChaintracksParams): {
+  chain: Chain;
+  bulkFileDataManager: BulkFileDataManager;
+  liveHeightThreshold: number;
+  reorgHeightThreshold: number;
+  bulkMigrationChunkSize: number;
+  batchInsertLimit: number;
+};
+declare function startChaintracks<TStorage extends ChaintracksOptions['storage']>(params: ResolvedDefaultChaintracksParams, options: ChaintracksOptions): CreatedChaintracks<TStorage>;
+declare function createAndStartDefaultChaintracks<TStorage extends ChaintracksOptions['storage']>(args: DefaultChaintracksArguments, createOptions: (...args: DefaultChaintracksArguments) => ChaintracksOptions): CreatedChaintracks<TStorage>;
+/**
+ * Builds the shared portion of ChaintracksOptions that all storage backends
+ * (Knex, Idb, NoDb) have in common: the options shell and bulk/live ingestors.
+ *
+ * The caller is responsible for providing the storage implementation.
+ */
+declare function buildChaintracksOptionsWithIngestors(params: ChaintracksIngestorParams, storage: ChaintracksOptions['storage']): ChaintracksOptions;
 //#endregion
 //#region ../src/services/chaintracker/chaintracks/createDefaultNoDbChaintracksOptions.d.ts
 declare function createDefaultNoDbChaintracksOptions(...args: DefaultChaintracksArguments): ChaintracksOptions;
@@ -8264,9 +8417,9 @@ interface WalletArgs {
    */
   makeLogger?: MakeWalletLogger;
   /**
-   * Internal Wallet Toolbox optimization policy. `auto` negotiates the optional
-   * action-batch storage capability; `legacy` always uses per-action storage.
-   * This does not change the BRC-100 wallet interface.
+   * Internal Wallet Toolbox optimization policy. `auto` (the default)
+   * negotiates the optional action-batch storage capability; `legacy` always
+   * uses per-action storage. This does not change the BRC-100 wallet interface.
    */
   actionBatchMode?: ActionBatchMode;
   /**
@@ -8857,7 +9010,7 @@ interface UMPTokenInteractor {
    *
    * @param hash The hash of the presentation key.
    * @returns The UMP token if found; otherwise, undefined.
-   * @throws Implementations should throw when absence cannot be established authoritatively.
+   * @throws Implementations should throw when no verified token or clean empty response is available.
    */
   findByPresentationKeyHash: (hash: number[]) => Promise<UMPToken | undefined>;
   /**
@@ -8866,7 +9019,7 @@ interface UMPTokenInteractor {
    *
    * @param hash The hash of the recovery key.
    * @returns The UMP token if found; otherwise, undefined.
-   * @throws Implementations should throw when absence cannot be established authoritatively.
+   * @throws Implementations should throw when no verified token or clean empty response is available.
    */
   findByRecoveryKeyHash: (hash: number[]) => Promise<UMPToken | undefined>;
   /**
@@ -8894,7 +9047,7 @@ interface UMPTokenLookupDiagnostics {
 }
 type UMPTokenLookupFailureReason = 'lookup-unavailable' | 'lookup-incomplete' | 'token-malformed' | 'token-ambiguous';
 /**
- * Raised when UMP absence cannot be established authoritatively.
+ * Raised when a UMP lookup yields neither a verified token nor a clean empty response.
  *
  * Callers must offer retry/recovery rather than treating this error as a new
  * account. Diagnostics contain counts only and never hashes, keys, or tokens.
@@ -8954,9 +9107,37 @@ declare class OverlayUMPTokenInteractor implements UMPTokenInteractor {
    */
   findByRecoveryKeyHash(hash: number[]): Promise<UMPToken | undefined>;
   private findToken;
+  /**
+   * Picks the newest rendition among distinct verified tokens, when possible.
+   *
+   * The on-chain UMP protocol expresses token updates by consumption: the
+   * transaction creating a new rendition spends the previous rendition's
+   * outpoint (there is no rendition counter field in the current format).
+   * A candidate is therefore superseded when any other candidate's ancestry
+   * (available from its BEEF) spends the candidate's outpoint.
+   *
+   * @returns The single unsuperseded candidate, or undefined when supersession
+   * cannot be established for every stale candidate (e.g. forked tokens).
+   */
+  private resolveNewestToken;
+  /**
+   * Whether `tx` spends an input whose source output (available in the BEEF)
+   * decodes as a UMP token sharing the candidate's presentation or recovery
+   * hash — on-chain proof that the candidate is an update of a same-identity
+   * predecessor rather than an independently minted token.
+   */
+  private consumesSameIdentityToken;
+  /**
+   * Accumulates every outpoint spent by `tx` and by the ancestor transactions
+   * embedded in its BEEF, so supersession is detected even when intermediate
+   * renditions are absent from the lookup answer. Iterative so arbitrarily
+   * long update chains cannot exhaust the call stack.
+   */
+  private collectSpentOutpoints;
   private emptyLookupDiagnostics;
   private toLookupDiagnostics;
   private lookupDiagnosticAttributes;
+  private captureLookupCompleted;
   private captureLookupFailure;
   /**
    * Creates or updates (replaces) a UMP token on-chain. If `oldTokenToConsume` is provided,
@@ -9265,6 +9446,11 @@ declare class CWIStyleWalletManager implements WalletInterface {
 }
 //#endregion
 //#region ../src/services/createDefaultWalletServicesOptions.d.ts
+/**
+ * Returns the credential-free default ChainTracks client for a supported
+ * public network, or an operator-configured client for stn/tstn.
+ */
+declare function createDefaultChaintracksClient(chain: Exclude<Chain, 'mock'>): ChaintracksClientApi;
 declare function createDefaultWalletServicesOptions(...[chain, arcCallbackUrl, arcCallbackToken, taalArcApiKey, gorillaPoolArcApiKey, bitailsApiKey, deploymentId, chaintracks, arcadeUrl, arcadeApiKey, arcadeCallbackToken]: [chain: Chain, arcCallbackUrl?: string, arcCallbackToken?: string, taalArcApiKey?: string, gorillaPoolArcApiKey?: string, bitailsApiKey?: string, deploymentId?: string, chaintracks?: ChaintracksClientApi,
 /**
  * Optional Arcade endpoint. When provided (or when a default exists for the chain via
@@ -9281,7 +9467,7 @@ arcadeApiKey?: string,
 arcadeCallbackToken?: string]): WalletServicesOptions;
 /**
  * Default Arcade (bsv-blockchain/arcade) endpoint per chain.
- * Returns undefined when no public default is known for the chain (e.g. testnet not yet deployed).
+ * Returns undefined when no public default is known for the chain.
  */
 declare function arcadeDefaultUrl(chain: Chain): string | undefined;
 declare function arcDefaultUrl(chain: Chain): string;
@@ -10782,5 +10968,5 @@ declare class WalletPermissionsManager implements WalletInterface {
   private buildActiveRequestKey;
 }
 //#endregion
-export { ARGON2ID_DEFAULT_HASH_LENGTH, ARGON2ID_DEFAULT_ITERATIONS, ARGON2ID_DEFAULT_MEMORY_KIB, ARGON2ID_DEFAULT_PARALLELISM, ARGON2ID_MAX_ITERATIONS, ARGON2ID_MAX_MEMORY_KIB, ARGON2ID_MAX_PARALLELISM, ActionBatchStatus, AdminStatsResult, AnyBlockHeader, AuthMethodInteractor, AuthPayload, BHServiceClient, BRC38ImportOptions, BRC38ImportResult, BRC38Tables, BRC38WalletData, BRC39Options, type BaseBlockHeader, type BlockHeader, BulkFileDataManager, BulkFileDataManagerMergeResult, BulkFileDataManagerOptions, BulkFileDataReader, BulkFilesReader, BulkFilesReaderFs, BulkFilesReaderStorage, BulkIngestorApi, BulkIngestorBase, BulkIngestorBaseOptions, BulkIngestorCDN, BulkIngestorCDNBabbage, BulkIngestorCDNOptions, BulkIngestorWhatsOnChainCdn, BulkIngestorWhatsOnChainOptions, BulkStorageApi, BulkStorageBase, BulkStorageBaseOptions, BulkSyncResult, ByteEncoding, ByteInput, CWIStyleWalletManager, Certifier, type Chain, Chaintracks, ChaintracksAppendableFileApi, ChaintracksChainTracker, ChaintracksChainTrackerOptions, ChaintracksFetch, ChaintracksFetchApi, ChaintracksFetchError, ChaintracksFsApi, ChaintracksManagementApi, ChaintracksOptions, ChaintracksReadableFileApi, ChaintracksServiceClient, ChaintracksServiceClientOptions, ChaintracksStorageApi, ChaintracksStorageBase, ChaintracksStorageBaseOptions, ChaintracksStorageBulkFileApi, ChaintracksStorageIdb, ChaintracksStorageIdbOptions, ChaintracksStorageIdbSchema, ChaintracksStorageIngestApi, ChaintracksStorageNoDb, ChaintracksStorageNoDbOptions, ChaintracksStorageQueryApi, ChaintracksWritableFileApi, CompleteAuthResponse, ContactRecord, ContactSource, CounterpartyPermissionEventHandler, CounterpartyPermissionRequest, CounterpartyPermissions, DEFAULT_PROFILE_ID, DEFAULT_SETTINGS, DeactivedHeader, DevConsoleInteractor, EnqueueHandler, EntityBase, EntityCertificate, EntityCertificateField, EntityCommission, EntityOutput, EntityOutputBasket, EntityOutputTag, EntityOutputTagMap, EntityProvenTx, EntityProvenTxReq, EntityStorage, EntitySyncMap, EntitySyncState, EntityTransaction, EntityTxLabel, EntityTxLabelMap, EntityUser, ErrorHandler, GetHeaderByteFileLinksResult, GoChaintracksServiceClient, GoChaintracksServiceClientOptions, GroupedPermissionEventHandler, GroupedPermissionRequest, GroupedPermissions, HeightRange, HeightRangeApi, HeightRanges, InsertHeaderResult, KDF_MAX_HASH_LENGTH, KdfConfig, KeyPairAddress, LineItemType, ListActionsSpecOp, ListOutputsSpecOp, LiveBlockHeader, LiveIngestorApi, LiveIngestorBase, LiveIngestorBaseOptions, LiveIngestorChaintracksSSE, LiveIngestorChaintracksSSEOptions, LiveIngestorWhatsOnChainOptions, LiveIngestorWhatsOnChainPoll, MAX_STATE_SNAPSHOT_BYTES, MergeEntity, Monitor, MonitorOptions, MonitorStartupTaskMode, MonitorStorage, OverlayUMPTokenInteractor, PBKDF2_MAX_ITERATIONS, PBKDF2_NUM_ROUNDS, ParsedBrc114ActionTimeLabels, PendingSignAction, PendingStorageInput, PermissionEventHandler, PermissionRequest, PermissionToken, PermissionsManagerConfig, PermissionsModule, PersonaIDInteractor, PrivilegedKeyManager, Profile, ProvenTxFromTxidResult, ProvenTxReqHistory, ProvenTxReqHistorySummaryApi, ProvenTxReqNotify, ScriptTemplateBRC29, ScriptTemplateParamsBRC29, SecurityLevel, Services, SetupClient, SetupClientWalletArgs, SetupClientWalletClientArgs, SetupWallet, SetupWalletClient, SetupWalletIdb, SetupWalletIdbArgs, SimpleWalletManager, StartAuthResponse, StorageAdminStats, StorageClient, StorageIdb, StorageIdbOptions, StorageProvider, StorageProviderOptions, StorageSyncReader, SyncError, SyncMap, TESTNET_DEFAULT_SETTINGS, TableActionBatch, TableActionBatchBlob, TableActionBatchOutput, TableAuthSession, TableCertificate, TableCertificateField, TableCertificateX, TableCommission, TableMonitorEvent, TableOutput, TableOutputBasket, TableOutputTag, TableOutputTagMap, TableOutputX, TableProvenTx, TableProvenTxReq, TableProvenTxReqDynamics, TableSettings, TableSyncState, TableTransaction, TableTxLabel, TableTxLabelMap, TableUser, TrustSettings, TscMerkleProofApi, TwilioPhoneInteractor, TxScriptOffsets, UMPToken, UMPTokenInteractor, UMPTokenLookupDiagnostics, UMPTokenLookupError, UMPTokenLookupFailureReason, VerifyAndRepairBeefResult, WABAccountContinuityError, WABClient, WABClientError, WABClientErrorCode, WABClientErrorOptions, WABClientOptions, WABFaucetResponse, WABOperationResponse, WABRequestOptions, WABServerInfo, WABTransport, WABTransportOptions, Wallet, WalletArgs, WalletAuthenticationManager, WalletAuthenticationManagerOptions, WalletLogger, WalletLoggerArgs, WalletLoggerLevel, WalletPermissionsManager, WalletPermissionsManagerCallbacks, WalletSettings, WalletSettingsManager, WalletSettingsManagerConfig, WalletSigner, WalletStorageManager, WalletTheme, WhatsOnChainServices, WhatsOnChainServicesOptions, WocGetHeaderByteFileLinks, WocGetHeadersHeader, arcDefaultUrl, arcGorillaPoolUrl, arcadeDefaultUrl, arraysEqual, asArray, asBsvSdkPrivateKey, asBsvSdkPublickKey, asBsvSdkScript, asBsvSdkTx, asString, asUint8Array, brc29ProtocolID, convertProofToMerklePath, createDefaultIdbChaintracksOptions, createDefaultNoDbChaintracksOptions, createDefaultWalletServicesOptions, createIdbChaintracks, createNoDbChaintracks, createSyncMap, decryptBRC39, doubleSha256BE, doubleSha256LE, encryptBRC39, exportBRC38, exportBRC38Json, exportBRC39, getIdentityKey, getLabelToSpecOp, getListOutputsSpecOp, importBRC38, importBRC39, isAutoSpendableChangeOutput, isBaseBlockHeader, isBlockHeader, isLive, isLiveBlockHeader, isManagedChangeOutput, logCreateActionArgs, logWalletError, logger, makeAtomicBeef, makeBrc114ActionTimeLabel, managedChangeOutputFields, maxDate, optionalArraysEqual, outputColumnsWithoutLockingScript, parseBRC38Json, parseBrc114ActionTimeLabels, parseFileLink, parseTxScriptOffsets, partitionActionLabels, randomBytes, randomBytesBase64, randomBytesHex, index_d_exports as sdk, selectBulkHeaderFiles, sha256Hash, stampLog, stampLogFormat, tableAuthSessionToPeerSession, throwDummyReviewActions, toBinaryBaseBlockHeader, toLookupNetworkPreset, toWalletNetwork, transactionColumnsWithoutRawTx, blockHeaderUtilities_d_exports as utils, validateScriptHash, validateSecondsSinceEpoch, validateStorageFeeModel, verifyHexString, verifyId, verifyInteger, verifyNumber, verifyOne, verifyOneOrNone, verifyOptionalHexString, verifyTruthy, wait, wocGetHeadersHeaderToBlockHeader };
+export { ARGON2ID_DEFAULT_HASH_LENGTH, ARGON2ID_DEFAULT_ITERATIONS, ARGON2ID_DEFAULT_MEMORY_KIB, ARGON2ID_DEFAULT_PARALLELISM, ARGON2ID_MAX_ITERATIONS, ARGON2ID_MAX_MEMORY_KIB, ARGON2ID_MAX_PARALLELISM, ActionBatchStatus, AdminStatsResult, AnyBlockHeader, AuthMethodInteractor, AuthPayload, BHServiceClient, BRC38ImportOptions, BRC38ImportResult, BRC38Tables, BRC38WalletData, BRC39Options, type BaseBlockHeader, type BlockHeader, BulkFileDataManager, BulkFileDataManagerMergeResult, BulkFileDataManagerOptions, BulkFileDataReader, BulkFilesReader, BulkFilesReaderFs, BulkFilesReaderStorage, BulkIngestorApi, BulkIngestorBase, BulkIngestorBaseOptions, BulkIngestorCDN, BulkIngestorCDNBabbage, BulkIngestorCDNOptions, BulkIngestorChaintracks, BulkIngestorChaintracksOptions, BulkIngestorWhatsOnChainCdn, BulkIngestorWhatsOnChainOptions, BulkStorageApi, BulkStorageBase, BulkStorageBaseOptions, BulkSyncResult, ByteEncoding, ByteInput, CWIStyleWalletManager, Certifier, type Chain, Chaintracks, ChaintracksApi, ChaintracksAppendableFileApi, ChaintracksArgumentsTail, ChaintracksChainTracker, ChaintracksChainTrackerOptions, ChaintracksClientApi, ChaintracksFetch, ChaintracksFetchApi, ChaintracksFetchError, ChaintracksFsApi, ChaintracksInfoApi, ChaintracksIngestorParams, ChaintracksManagementApi, ChaintracksOptions, ChaintracksPackageInfoApi, ChaintracksReadableFileApi, ChaintracksServiceClient, ChaintracksServiceClientOptions, ChaintracksSourceOptions, ChaintracksSourceStatusApi, ChaintracksStorageApi, ChaintracksStorageBase, ChaintracksStorageBaseOptions, ChaintracksStorageBulkFileApi, ChaintracksStorageIdb, ChaintracksStorageIdbOptions, ChaintracksStorageIdbSchema, ChaintracksStorageIngestApi, ChaintracksStorageNoDb, ChaintracksStorageNoDbOptions, ChaintracksStorageQueryApi, ChaintracksWritableFileApi, CompleteAuthResponse, ContactRecord, ContactSource, CounterpartyPermissionEventHandler, CounterpartyPermissionRequest, CounterpartyPermissions, CreatedChaintracks, DEFAULT_PROFILE_ID, DEFAULT_SETTINGS, DeactivedHeader, DefaultChaintracksArguments, DevConsoleInteractor, EnqueueHandler, EntityBase, EntityCertificate, EntityCertificateField, EntityCommission, EntityOutput, EntityOutputBasket, EntityOutputTag, EntityOutputTagMap, EntityProvenTx, EntityProvenTxReq, EntityStorage, EntitySyncMap, EntitySyncState, EntityTransaction, EntityTxLabel, EntityTxLabelMap, EntityUser, ErrorHandler, GetHeaderByteFileLinksResult, GoChaintracksServiceClient, GoChaintracksServiceClientOptions, GroupedPermissionEventHandler, GroupedPermissionRequest, GroupedPermissions, HeaderListener, HeightRange, HeightRangeApi, HeightRanges, InsertHeaderResult, KDF_MAX_HASH_LENGTH, KdfConfig, KeyPairAddress, LineItemType, ListActionsSpecOp, ListOutputsSpecOp, LiveBlockHeader, LiveIngestorApi, LiveIngestorBase, LiveIngestorBaseOptions, LiveIngestorChaintracksSSE, LiveIngestorChaintracksSSEOptions, LiveIngestorWhatsOnChainOptions, LiveIngestorWhatsOnChainPoll, MAX_STATE_SNAPSHOT_BYTES, MergeEntity, Monitor, MonitorOptions, MonitorStartupTaskMode, MonitorStorage, OverlayUMPTokenInteractor, PBKDF2_MAX_ITERATIONS, PBKDF2_NUM_ROUNDS, ParsedBrc114ActionTimeLabels, PendingSignAction, PendingStorageInput, PermissionEventHandler, PermissionRequest, PermissionToken, PermissionsManagerConfig, PermissionsModule, PersonaIDInteractor, PrivilegedKeyManager, Profile, ProvenTxFromTxidResult, ProvenTxReqHistory, ProvenTxReqHistorySummaryApi, ProvenTxReqNotify, ReorgListener, ResolvedDefaultChaintracksParams, ScriptTemplateBRC29, ScriptTemplateParamsBRC29, SecurityLevel, Services, SetupClient, SetupClientWalletArgs, SetupClientWalletClientArgs, SetupWallet, SetupWalletClient, SetupWalletIdb, SetupWalletIdbArgs, SimpleWalletManager, StartAuthResponse, StorageAdminStats, StorageClient, StorageIdb, StorageIdbOptions, StorageProvider, StorageProviderOptions, StorageSyncReader, SyncError, SyncMap, TESTNET_DEFAULT_SETTINGS, TableActionBatch, TableActionBatchBlob, TableActionBatchOutput, TableAuthSession, TableCertificate, TableCertificateField, TableCertificateX, TableCommission, TableMonitorEvent, TableOutput, TableOutputBasket, TableOutputTag, TableOutputTagMap, TableOutputX, TableProvenTx, TableProvenTxReq, TableProvenTxReqDynamics, TableSettings, TableSyncState, TableTransaction, TableTxLabel, TableTxLabelMap, TableUser, TrustSettings, TscMerkleProofApi, TwilioPhoneInteractor, TxScriptOffsets, UMPToken, UMPTokenInteractor, UMPTokenLookupDiagnostics, UMPTokenLookupError, UMPTokenLookupFailureReason, VerifyAndRepairBeefResult, WABAccountContinuityError, WABClient, WABClientError, WABClientErrorCode, WABClientErrorOptions, WABClientOptions, WABFaucetResponse, WABOperationResponse, WABRequestOptions, WABServerInfo, WABTransport, WABTransportOptions, Wallet, WalletArgs, WalletAuthenticationManager, WalletAuthenticationManagerOptions, WalletLogger, WalletLoggerArgs, WalletLoggerLevel, WalletPermissionsManager, WalletPermissionsManagerCallbacks, WalletSettings, WalletSettingsManager, WalletSettingsManagerConfig, WalletSigner, WalletStorageManager, WalletTheme, WhatsOnChainServices, WhatsOnChainServicesOptions, WocGetHeaderByteFileLinks, WocGetHeadersHeader, arcDefaultUrl, arcGorillaPoolUrl, arcadeDefaultUrl, arraysEqual, asArray, asBsvSdkPrivateKey, asBsvSdkPublickKey, asBsvSdkScript, asBsvSdkTx, asString, asUint8Array, brc29ProtocolID, buildChaintracksOptionsWithIngestors, convertProofToMerklePath, createAndStartDefaultChaintracks, createDefaultBulkFileDataManager, createDefaultChaintracksClient, createDefaultChaintracksStorageOptions, createDefaultIdbChaintracksOptions, createDefaultNoDbChaintracksOptions, createDefaultWalletServicesOptions, createIdbChaintracks, createNoDbChaintracks, createSyncMap, decryptBRC39, doubleSha256BE, doubleSha256LE, encryptBRC39, exportBRC38, exportBRC38Json, exportBRC39, getIdentityKey, getLabelToSpecOp, getListOutputsSpecOp, importBRC38, importBRC39, isAutoSpendableChangeOutput, isBaseBlockHeader, isBlockHeader, isLive, isLiveBlockHeader, isManagedChangeOutput, logCreateActionArgs, logWalletError, logger, makeAtomicBeef, makeBrc114ActionTimeLabel, managedChangeOutputFields, maxDate, optionalArraysEqual, outputColumnsWithoutLockingScript, parseBRC38Json, parseBrc114ActionTimeLabels, parseFileLink, parseTxScriptOffsets, partitionActionLabels, randomBytes, randomBytesBase64, randomBytesHex, resolveDefaultChaintracksArguments, index_d_exports as sdk, selectBulkHeaderFiles, sha256Hash, stampLog, stampLogFormat, startChaintracks, tableAuthSessionToPeerSession, throwDummyReviewActions, toBinaryBaseBlockHeader, toDefaultChaintracksArguments, toLookupNetworkPreset, toWalletNetwork, transactionColumnsWithoutRawTx, blockHeaderUtilities_d_exports as utils, validateScriptHash, validateSecondsSinceEpoch, validateStorageFeeModel, verifyHexString, verifyId, verifyInteger, verifyNumber, verifyOne, verifyOneOrNone, verifyOptionalHexString, verifyTruthy, wait, wocGetHeadersHeaderToBlockHeader };
 //# sourceMappingURL=index.client.d.mts.map