@bsv/wallet-toolbox-client 2.7.1 → 2.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/out/index.client.cjs +3777 -3318
- package/out/index.client.cjs.map +1 -1
- package/out/index.client.d.cts +250 -10
- package/out/index.client.d.cts.map +1 -1
- package/out/index.client.d.mts +250 -10
- package/out/index.client.d.mts.map +1 -1
- package/out/index.client.mjs +3772 -3319
- package/out/index.client.mjs.map +1 -1
- package/package.json +2 -2
package/out/index.client.d.mts
CHANGED
|
@@ -816,6 +816,19 @@ interface ChaintracksInfoApi {
|
|
|
816
816
|
packages: ChaintracksPackageInfoApi[];
|
|
817
817
|
/** Last observed source state. Additive and omitted by older services. */
|
|
818
818
|
sources?: ChaintracksSourceStatusApi[];
|
|
819
|
+
/** Local bulk-header retrieval counters. Additive and omitted by older services. */
|
|
820
|
+
bulkData?: ChaintracksBulkDataStatsApi;
|
|
821
|
+
}
|
|
822
|
+
/** @public */
|
|
823
|
+
interface ChaintracksBulkDataStatsApi {
|
|
824
|
+
memoryHits: number;
|
|
825
|
+
storageHits: number;
|
|
826
|
+
persistentCacheHits: number;
|
|
827
|
+
persistentCacheMisses: number;
|
|
828
|
+
persistentCacheRejects: number;
|
|
829
|
+
coalescedLoads: number;
|
|
830
|
+
downloads: number;
|
|
831
|
+
downloadedBytes: number;
|
|
819
832
|
}
|
|
820
833
|
/** @public */
|
|
821
834
|
interface ChaintracksSourceStatusApi {
|
|
@@ -1132,6 +1145,14 @@ interface WalletServicesOptions {
|
|
|
1132
1145
|
chain: Chain;
|
|
1133
1146
|
/** Optional provider-neutral service and ChainTracks tracing. */
|
|
1134
1147
|
telemetry?: TelemetryConfig;
|
|
1148
|
+
/**
|
|
1149
|
+
* Optional SDK verifier returned directly by `getChainTracker`.
|
|
1150
|
+
*
|
|
1151
|
+
* Use this for a local-primary or otherwise composed verifier. When omitted,
|
|
1152
|
+
* Services preserves the existing behavior of wrapping `chaintracks` in a
|
|
1153
|
+
* `ChaintracksChainTracker`.
|
|
1154
|
+
*/
|
|
1155
|
+
chainTracker?: ChainTracker;
|
|
1135
1156
|
/**
|
|
1136
1157
|
* As of 2025-08-31 the `taalApiKey` is unused for default configured services.
|
|
1137
1158
|
* See `arcConfig` instead.
|
|
@@ -5667,7 +5688,7 @@ interface ChaintracksFsApi {
|
|
|
5667
5688
|
*/
|
|
5668
5689
|
interface ChaintracksFetchApi {
|
|
5669
5690
|
httpClient: HttpClient;
|
|
5670
|
-
download(url: string): Promise<Uint8Array>;
|
|
5691
|
+
download(url: string, maxResponseBytes?: number): Promise<Uint8Array>;
|
|
5671
5692
|
fetchJson<R>(url: string): Promise<R>;
|
|
5672
5693
|
pathJoin(baseUrl: string, subpath: string): string;
|
|
5673
5694
|
}
|
|
@@ -5693,6 +5714,32 @@ declare class BulkFileDataReader {
|
|
|
5693
5714
|
read(): Promise<Uint8Array | undefined>;
|
|
5694
5715
|
}
|
|
5695
5716
|
//#endregion
|
|
5717
|
+
//#region ../src/services/chaintracker/chaintracks/Api/BulkFileDataCacheApi.d.ts
|
|
5718
|
+
/**
|
|
5719
|
+
* Persistent backing cache for immutable bulk-header objects.
|
|
5720
|
+
*
|
|
5721
|
+
* Implementations may read packaged checkpoint assets, application storage,
|
|
5722
|
+
* or a filesystem. The manager validates the byte length and SHA-256 digest
|
|
5723
|
+
* before using any returned value or persisting a downloaded value.
|
|
5724
|
+
*
|
|
5725
|
+
* @public
|
|
5726
|
+
*/
|
|
5727
|
+
interface BulkFileDataCacheApi {
|
|
5728
|
+
get(file: Readonly<BulkHeaderFileInfo>): Promise<Uint8Array | undefined>;
|
|
5729
|
+
set(file: Readonly<BulkHeaderFileInfo>, data: Uint8Array): Promise<void>;
|
|
5730
|
+
delete?(file: Readonly<BulkHeaderFileInfo>): Promise<void>;
|
|
5731
|
+
}
|
|
5732
|
+
/**
|
|
5733
|
+
* A deployment-defined budget for remote bulk-header downloads.
|
|
5734
|
+
* Implementations should throw before the request when the requested byte
|
|
5735
|
+
* reservation would exceed the configured budget.
|
|
5736
|
+
*
|
|
5737
|
+
* @public
|
|
5738
|
+
*/
|
|
5739
|
+
interface BulkFileDownloadBudgetApi {
|
|
5740
|
+
consume(byteCount: number): void | Promise<void>;
|
|
5741
|
+
}
|
|
5742
|
+
//#endregion
|
|
5696
5743
|
//#region ../src/services/chaintracker/chaintracks/util/BulkFileDataManager.d.ts
|
|
5697
5744
|
interface BulkFileDataManagerOptions {
|
|
5698
5745
|
chain: Chain;
|
|
@@ -5700,6 +5747,21 @@ interface BulkFileDataManagerOptions {
|
|
|
5700
5747
|
maxRetained?: number;
|
|
5701
5748
|
fetch?: ChaintracksFetchApi;
|
|
5702
5749
|
fromKnownSourceUrl?: string;
|
|
5750
|
+
/** Persistent cache consulted before any remote bulk-file download. */
|
|
5751
|
+
cache?: BulkFileDataCacheApi;
|
|
5752
|
+
/** Optional process-local or shared reservation budget for remote bytes. */
|
|
5753
|
+
downloadBudget?: BulkFileDownloadBudgetApi;
|
|
5754
|
+
}
|
|
5755
|
+
/** @public */
|
|
5756
|
+
interface BulkFileDataManagerStats {
|
|
5757
|
+
memoryHits: number;
|
|
5758
|
+
storageHits: number;
|
|
5759
|
+
persistentCacheHits: number;
|
|
5760
|
+
persistentCacheMisses: number;
|
|
5761
|
+
persistentCacheRejects: number;
|
|
5762
|
+
coalescedLoads: number;
|
|
5763
|
+
downloads: number;
|
|
5764
|
+
downloadedBytes: number;
|
|
5703
5765
|
}
|
|
5704
5766
|
/**
|
|
5705
5767
|
* Manages bulk file data (typically 8MB chunks of 100,000 headers each).
|
|
@@ -5716,13 +5778,18 @@ declare class BulkFileDataManager {
|
|
|
5716
5778
|
private bfds;
|
|
5717
5779
|
private fileHashToIndex;
|
|
5718
5780
|
private readonly lock;
|
|
5781
|
+
private readonly inFlightLoads;
|
|
5719
5782
|
private storage?;
|
|
5783
|
+
private readonly stats;
|
|
5720
5784
|
readonly chain: Chain;
|
|
5721
5785
|
readonly maxPerFile: number;
|
|
5722
5786
|
readonly fetch?: ChaintracksFetchApi;
|
|
5723
5787
|
readonly maxRetained?: number;
|
|
5724
5788
|
readonly fromKnownSourceUrl?: string;
|
|
5789
|
+
readonly cache?: BulkFileDataCacheApi;
|
|
5790
|
+
readonly downloadBudget?: BulkFileDownloadBudgetApi;
|
|
5725
5791
|
constructor(options: BulkFileDataManagerOptions | Chain);
|
|
5792
|
+
getStats(): BulkFileDataManagerStats;
|
|
5726
5793
|
deleteBulkFiles(): Promise<void>;
|
|
5727
5794
|
private deleteBulkFilesNoLock;
|
|
5728
5795
|
/**
|
|
@@ -5815,6 +5882,8 @@ declare class BulkFileDataManager {
|
|
|
5815
5882
|
* @returns
|
|
5816
5883
|
*/
|
|
5817
5884
|
private ensureData;
|
|
5885
|
+
private loadAndValidateData;
|
|
5886
|
+
private validateRetrievedData;
|
|
5818
5887
|
private ensureMaxRetained;
|
|
5819
5888
|
exportHeadersToFs(toFs: ChaintracksFsApi, toHeadersPerFile: number, toFolder: string, sourceUrl?: string, maxHeight?: number): Promise<void>;
|
|
5820
5889
|
}
|
|
@@ -5940,7 +6009,8 @@ interface BulkHeaderFileInfo {
|
|
|
5940
6009
|
chain?: Chain;
|
|
5941
6010
|
data?: Uint8Array;
|
|
5942
6011
|
/**
|
|
5943
|
-
*
|
|
6012
|
+
* Advisory process-local validation state. Never trust this value after it
|
|
6013
|
+
* crosses a network or storage boundary; revalidate the object bytes.
|
|
5944
6014
|
*/
|
|
5945
6015
|
validated?: boolean;
|
|
5946
6016
|
/**
|
|
@@ -6014,6 +6084,13 @@ interface BulkHeaderFilesInfo {
|
|
|
6014
6084
|
*/
|
|
6015
6085
|
headersPerFile: number;
|
|
6016
6086
|
}
|
|
6087
|
+
declare abstract class BulkHeaderFiles implements BulkHeaderFilesInfo {
|
|
6088
|
+
rootFolder: string;
|
|
6089
|
+
jsonFilename: string;
|
|
6090
|
+
files: BulkHeaderFileInfo[];
|
|
6091
|
+
headersPerFile: number;
|
|
6092
|
+
constructor(rootFolder: string, jsonFilename: string, files: BulkHeaderFileInfo[], headersPerFile: number);
|
|
6093
|
+
}
|
|
6017
6094
|
//#endregion
|
|
6018
6095
|
//#region ../src/services/chaintracker/chaintracks/Api/ChaintracksStorageApi.d.ts
|
|
6019
6096
|
interface ChaintracksStorageBaseOptions {
|
|
@@ -7817,6 +7894,10 @@ interface ChaintracksSourceOptions {
|
|
|
7817
7894
|
disableCdn?: boolean;
|
|
7818
7895
|
/** Disable the keyless WhatsOnChain fallback on mainnet/testnet. */
|
|
7819
7896
|
disableWhatsOnChain?: boolean;
|
|
7897
|
+
/** Persistent checkpoint/cache storage used before any remote bulk download. */
|
|
7898
|
+
bulkFileCache?: BulkFileDataCacheApi;
|
|
7899
|
+
/** Optional byte budget applied before remote bulk-file downloads. */
|
|
7900
|
+
bulkFileDownloadBudget?: BulkFileDownloadBudgetApi;
|
|
7820
7901
|
}
|
|
7821
7902
|
type ChaintracksArgumentsTail = [whatsonchainApiKey?: string, maxPerFile?: number, maxRetained?: number, fetch?: ChaintracksFetchApi, cdnUrl?: string, liveHeightThreshold?: number, reorgHeightThreshold?: number, bulkMigrationChunkSize?: number, batchInsertLimit?: number, addLiveRecursionLimit?: number, sources?: ChaintracksSourceOptions];
|
|
7822
7903
|
type DefaultChaintracksArguments = [chain: Chain, ...options: ChaintracksArgumentsTail];
|
|
@@ -7955,6 +8036,18 @@ declare class BulkFilesReaderStorage extends BulkFilesReader {
|
|
|
7955
8036
|
}
|
|
7956
8037
|
//#endregion
|
|
7957
8038
|
//#region ../src/services/chaintracker/chaintracks/util/ChaintracksFetch.d.ts
|
|
8039
|
+
interface ChaintracksFetchOptions {
|
|
8040
|
+
/** Number of retries after the initial request. Defaults to three. */
|
|
8041
|
+
maxRetries?: number;
|
|
8042
|
+
/** Deadline covering connection, headers, and response body. */
|
|
8043
|
+
timeoutMsecs?: number;
|
|
8044
|
+
/** Maximum materialized response size for binary and JSON requests. */
|
|
8045
|
+
maxResponseBytes?: number;
|
|
8046
|
+
retryMsecs?: number;
|
|
8047
|
+
maxRetryMsecs?: number;
|
|
8048
|
+
/** Testable jitter source in the inclusive range 0..1. */
|
|
8049
|
+
random?: () => number;
|
|
8050
|
+
}
|
|
7958
8051
|
declare class ChaintracksFetchError extends Error {
|
|
7959
8052
|
readonly url: string;
|
|
7960
8053
|
readonly status: number;
|
|
@@ -7964,17 +8057,61 @@ declare class ChaintracksFetchError extends Error {
|
|
|
7964
8057
|
get retryable(): boolean;
|
|
7965
8058
|
}
|
|
7966
8059
|
/**
|
|
7967
|
-
*
|
|
7968
|
-
*
|
|
8060
|
+
* Bounded fetch implementation shared by ChainTracks sources.
|
|
8061
|
+
*
|
|
8062
|
+
* Retry policy lives here so callers never multiply attempts. Every attempt
|
|
8063
|
+
* has a deadline that remains active while the response body is consumed, and
|
|
8064
|
+
* every materialized response has an explicit byte ceiling.
|
|
7969
8065
|
*/
|
|
7970
8066
|
declare class ChaintracksFetch implements ChaintracksFetchApi {
|
|
7971
8067
|
httpClient: HttpClient;
|
|
7972
|
-
|
|
8068
|
+
private readonly maxRetries;
|
|
8069
|
+
private readonly timeoutMsecs;
|
|
8070
|
+
private readonly maxResponseBytes;
|
|
8071
|
+
private readonly retryMsecs;
|
|
8072
|
+
private readonly maxRetryMsecs;
|
|
8073
|
+
private readonly random;
|
|
8074
|
+
constructor(options?: ChaintracksFetchOptions);
|
|
8075
|
+
download(url: string, maxResponseBytes?: number): Promise<Uint8Array>;
|
|
7973
8076
|
fetchJson<R>(url: string): Promise<R>;
|
|
8077
|
+
private requestBytes;
|
|
8078
|
+
private requestAttempt;
|
|
8079
|
+
private readResponseBytes;
|
|
8080
|
+
private responseTooLarge;
|
|
8081
|
+
private retryWaitMsecs;
|
|
7974
8082
|
pathJoin(baseUrl: string, subpath: string): string;
|
|
7975
8083
|
}
|
|
8084
|
+
//#endregion
|
|
8085
|
+
//#region ../src/services/chaintracker/chaintracks/util/FixedWindowBulkFileDownloadBudget.d.ts
|
|
8086
|
+
interface FixedWindowBulkFileDownloadBudgetOptions {
|
|
8087
|
+
maxBytes: number;
|
|
8088
|
+
windowMsecs?: number;
|
|
8089
|
+
now?: () => number;
|
|
8090
|
+
}
|
|
8091
|
+
/**
|
|
8092
|
+
* Conservative process-local byte reservation budget for remote bulk-header
|
|
8093
|
+
* downloads. A reservation is retained even when the subsequent request
|
|
8094
|
+
* fails, preventing a failing upstream from bypassing the bound.
|
|
8095
|
+
*
|
|
8096
|
+
* @public
|
|
8097
|
+
*/
|
|
8098
|
+
declare class FixedWindowBulkFileDownloadBudget implements BulkFileDownloadBudgetApi {
|
|
8099
|
+
private readonly maxBytes;
|
|
8100
|
+
private readonly windowMsecs;
|
|
8101
|
+
private readonly now;
|
|
8102
|
+
private windowStartedAt;
|
|
8103
|
+
private consumedBytes;
|
|
8104
|
+
constructor(options: FixedWindowBulkFileDownloadBudgetOptions);
|
|
8105
|
+
consume(byteCount: number): void;
|
|
8106
|
+
snapshot(): {
|
|
8107
|
+
maxBytes: number;
|
|
8108
|
+
consumedBytes: number;
|
|
8109
|
+
windowStartedAt: number;
|
|
8110
|
+
windowMsecs: number;
|
|
8111
|
+
};
|
|
8112
|
+
}
|
|
7976
8113
|
declare namespace blockHeaderUtilities_d_exports {
|
|
7977
|
-
export { addWork, blockHash, convertBitsToTarget, convertBitsToWork, convertBufferToUint32, convertUint32ToBuffer, deserializeBaseBlockHeader, deserializeBaseBlockHeaders, deserializeBlockHeader, deserializeBlockHeaders, genesisBuffer, genesisHeader, isMoreWork, readUInt32BE, readUInt32LE, serializeBaseBlockHeader, serializeBaseBlockHeaders, sha256HashOfBinaryFile, subWork, swapByteOrder, validateBufferOfHeaders, validateBulkFileData, validateGenesisHeader, validateHeaderDifficulty, validateHeaderFormat, workBNtoBuffer, writeUInt32BE, writeUInt32LE };
|
|
8114
|
+
export { addWork, blockHash, convertBitsToTarget, convertBitsToWork, convertBufferToUint32, convertUint32ToBuffer, deserializeBaseBlockHeader, deserializeBaseBlockHeaders, deserializeBlockHeader, deserializeBlockHeaders, genesisBuffer, genesisHeader, isMoreWork, readUInt32BE, readUInt32LE, serializeBaseBlockHeader, serializeBaseBlockHeaders, sha256HashOfBinaryFile, subWork, swapByteOrder, validateBufferOfHeaders, validateBulkFileData, validateGenesisHeader, validateHeaderDifficulty, validateHeaderFormat, validateHeaderProofOfWork, workBNtoBuffer, writeUInt32BE, writeUInt32LE };
|
|
7978
8115
|
}
|
|
7979
8116
|
/**
|
|
7980
8117
|
* Computes sha256 hash of file contents read as bytes with no encoding.
|
|
@@ -8049,14 +8186,22 @@ declare function deserializeBaseBlockHeaders(buffer: number[] | Uint8Array, offs
|
|
|
8049
8186
|
declare function deserializeBlockHeaders(firstHeight: number, buffer: number[] | Uint8Array, offset?: number, count?: number | undefined): BlockHeader[];
|
|
8050
8187
|
declare function validateHeaderFormat(header: BlockHeader): void;
|
|
8051
8188
|
/**
|
|
8052
|
-
* Ensures that a header has a valid proof-of-work
|
|
8053
|
-
* Requires chain is 'main'
|
|
8189
|
+
* Ensures that a header has a valid proof-of-work target and hash.
|
|
8054
8190
|
*
|
|
8055
8191
|
* @param header The header to validate
|
|
8056
8192
|
*
|
|
8057
8193
|
* @returns true if the header is valid
|
|
8058
8194
|
*/
|
|
8059
|
-
declare function validateHeaderDifficulty(hash:
|
|
8195
|
+
declare function validateHeaderDifficulty(hash: number[] | Uint8Array, bits: number): boolean;
|
|
8196
|
+
/**
|
|
8197
|
+
* Ensures that a structured header's computed hash satisfies its declared
|
|
8198
|
+
* proof-of-work target.
|
|
8199
|
+
*
|
|
8200
|
+
* @param header Header whose format and hash have already been checked.
|
|
8201
|
+
* @returns true if the header has valid proof-of-work.
|
|
8202
|
+
* @publicbody
|
|
8203
|
+
*/
|
|
8204
|
+
declare function validateHeaderProofOfWork(header: BlockHeader): true;
|
|
8060
8205
|
/**
|
|
8061
8206
|
* Computes double sha256 hash of bitcoin block header
|
|
8062
8207
|
* bytes are reversed to bigendian order
|
|
@@ -8149,6 +8294,101 @@ declare class ChaintracksChainTracker implements ChainTracker {
|
|
|
8149
8294
|
private isValidRootForHeightCore;
|
|
8150
8295
|
}
|
|
8151
8296
|
//#endregion
|
|
8297
|
+
//#region ../src/services/chaintracker/LocalChainTracker.d.ts
|
|
8298
|
+
/** @public */
|
|
8299
|
+
type LocalChainTrackerMode = 'local-primary' | 'remote-only';
|
|
8300
|
+
/** @public */
|
|
8301
|
+
type LocalChainTrackerConsistency = 'unchecked' | 'agreed' | 'lagging' | 'diverged' | 'insufficient-references' | 'error';
|
|
8302
|
+
/** @public */
|
|
8303
|
+
interface LocalChainTrackerRecoveryEvidence {
|
|
8304
|
+
reason: 'lagging' | 'diverged';
|
|
8305
|
+
localHeight: number;
|
|
8306
|
+
referenceHeight: number;
|
|
8307
|
+
heightLag: number;
|
|
8308
|
+
comparisonHeight: number;
|
|
8309
|
+
expectedHash: string;
|
|
8310
|
+
referenceAgreement: number;
|
|
8311
|
+
}
|
|
8312
|
+
/** @public */
|
|
8313
|
+
interface LocalChainTrackerStatus {
|
|
8314
|
+
mode: LocalChainTrackerMode;
|
|
8315
|
+
activeSource: string;
|
|
8316
|
+
consistency: LocalChainTrackerConsistency;
|
|
8317
|
+
localHeight?: number;
|
|
8318
|
+
localTipHash?: string;
|
|
8319
|
+
referenceHeight?: number;
|
|
8320
|
+
heightLag?: number;
|
|
8321
|
+
comparisonHeight?: number;
|
|
8322
|
+
expectedHash?: string;
|
|
8323
|
+
referenceAgreement?: number;
|
|
8324
|
+
checkedAt?: string;
|
|
8325
|
+
recoveredAt?: string;
|
|
8326
|
+
lastFallbackAt?: string;
|
|
8327
|
+
lastError?: string;
|
|
8328
|
+
}
|
|
8329
|
+
/** @public */
|
|
8330
|
+
interface LocalChainTrackerOptions {
|
|
8331
|
+
/** Locally persisted, proof-of-work-validating ChainTracks client. */
|
|
8332
|
+
local: ChaintracksClientApi;
|
|
8333
|
+
/** Independent references used for diagnostics and exceptional fallback. */
|
|
8334
|
+
fallbacks?: ChaintracksClientApi[];
|
|
8335
|
+
mode?: LocalChainTrackerMode;
|
|
8336
|
+
fallbackOnLocalError?: boolean;
|
|
8337
|
+
/** Number of matching references needed for a fallback validation result. */
|
|
8338
|
+
requiredFallbackAgreement?: number;
|
|
8339
|
+
/** Number of matching references needed to declare local divergence. */
|
|
8340
|
+
requiredConsistencyAgreement?: number;
|
|
8341
|
+
/** Quorum-backed height lag tolerated before local state is considered stuck. */
|
|
8342
|
+
maxHeightLag?: number;
|
|
8343
|
+
autoRecover?: boolean;
|
|
8344
|
+
/** Clears/reseeds local state and returns the replacement local client. */
|
|
8345
|
+
recoverLocal?: (evidence: LocalChainTrackerRecoveryEvidence) => Promise<ChaintracksClientApi>;
|
|
8346
|
+
/** Clears local state and returns a fresh local client. */
|
|
8347
|
+
clearLocal?: () => Promise<ChaintracksClientApi>;
|
|
8348
|
+
now?: () => Date;
|
|
8349
|
+
}
|
|
8350
|
+
/**
|
|
8351
|
+
* Local-first SDK ChainTracker with explicit management and fallback state.
|
|
8352
|
+
*
|
|
8353
|
+
* A definitive local `false` validation is never overridden by a remote
|
|
8354
|
+
* source. Fallback is reserved for local exceptions or explicit remote-only
|
|
8355
|
+
* mode, and applications can require agreement across multiple independent
|
|
8356
|
+
* references before accepting a fallback result.
|
|
8357
|
+
*
|
|
8358
|
+
* @public
|
|
8359
|
+
*/
|
|
8360
|
+
declare class LocalChainTracker implements ChainTracker {
|
|
8361
|
+
private local;
|
|
8362
|
+
private readonly fallbacks;
|
|
8363
|
+
private readonly fallbackOnLocalError;
|
|
8364
|
+
private readonly requiredFallbackAgreement;
|
|
8365
|
+
private readonly requiredConsistencyAgreement;
|
|
8366
|
+
private readonly maxHeightLag;
|
|
8367
|
+
private readonly autoRecover;
|
|
8368
|
+
private readonly recoverLocal;
|
|
8369
|
+
private readonly clearLocal;
|
|
8370
|
+
private readonly now;
|
|
8371
|
+
private status;
|
|
8372
|
+
constructor(options: LocalChainTrackerOptions);
|
|
8373
|
+
getMode(): LocalChainTrackerMode;
|
|
8374
|
+
setMode(mode: LocalChainTrackerMode): void;
|
|
8375
|
+
getStatus(): LocalChainTrackerStatus;
|
|
8376
|
+
getLocalClient(): ChaintracksClientApi;
|
|
8377
|
+
currentHeight(): Promise<number>;
|
|
8378
|
+
isValidRootForHeight(root: string, height: number): Promise<boolean>;
|
|
8379
|
+
synchronize(): Promise<LocalChainTrackerStatus>;
|
|
8380
|
+
clearLocalData(): Promise<LocalChainTrackerStatus>;
|
|
8381
|
+
checkConsistency(): Promise<LocalChainTrackerStatus>;
|
|
8382
|
+
private checkConsistencyInternal;
|
|
8383
|
+
private fallbackHeight;
|
|
8384
|
+
private fallbackValidation;
|
|
8385
|
+
private recordFallback;
|
|
8386
|
+
private recordError;
|
|
8387
|
+
private errorMessage;
|
|
8388
|
+
private validateAgreement;
|
|
8389
|
+
private validateHeightLag;
|
|
8390
|
+
}
|
|
8391
|
+
//#endregion
|
|
8152
8392
|
//#region ../src/services/chaintracker/BHServiceClient.d.ts
|
|
8153
8393
|
declare class BHServiceClient implements ChaintracksServiceClient {
|
|
8154
8394
|
bhs: BlockHeadersService;
|
|
@@ -11158,5 +11398,5 @@ declare class WalletPermissionsManager implements WalletInterface {
|
|
|
11158
11398
|
private buildActiveRequestKey;
|
|
11159
11399
|
}
|
|
11160
11400
|
//#endregion
|
|
11161
|
-
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, BRC153_REFERENCE_PREFIX, 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_MANAGED_CHANGE_MAX_OUTPUTS_PER_ACTION, DEFAULT_MANAGED_CHANGE_MIGRATION_INPUTS_PER_ACTION, DEFAULT_MANAGED_CHANGE_MINIMUM_SATOSHIS, DEFAULT_MANAGED_CHANGE_PENDING_COMPARISON_INPUTS, DEFAULT_MANAGED_CHANGE_TARGET_UTXOS, 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, LEGACY_MANAGED_CHANGE_MINIMUM_SATOSHIS, LineItemType, ListActionsSpecOp, ListOutputsSpecOp, LiveBlockHeader, LiveIngestorApi, LiveIngestorBase, LiveIngestorBaseOptions, LiveIngestorChaintracksSSE, LiveIngestorChaintracksSSEOptions, LiveIngestorWhatsOnChainOptions, LiveIngestorWhatsOnChainPoll, MAX_STATE_SNAPSHOT_BYTES, ManagedChangeBasketDefaults, ManagedChangePolicy, ManagedChangePolicyOptions, 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, applyBrc153ReferenceLabel, 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, defaultManagedChangePolicy, doubleSha256BE, doubleSha256LE, encryptBRC39, exportBRC38, exportBRC38Json, exportBRC39, getIdentityKey, getLabelToSpecOp, getListOutputsSpecOp, importBRC38, importBRC39, isAutoSpendableChangeOutput, isBaseBlockHeader, isBlockHeader, isBrc153ReferenceLabel, isLegacyManagedChangeBasketDefault, isLive, isLiveBlockHeader, isManagedChangeOutput, logCreateActionArgs, logWalletError, logger, makeAtomicBeef, makeBrc114ActionTimeLabel, makeBrc153ReferenceLabel, managedChangeOutputFields, maxDate, optionalArraysEqual, outputColumnsWithoutLockingScript, parseBRC38Json, parseBrc114ActionTimeLabels, parseBrc153ReferenceLabel, parseFileLink, parseTxScriptOffsets, partitionActionLabels, randomBytes, randomBytesBase64, randomBytesHex, resolveDefaultChaintracksArguments, index_d_exports as sdk, selectBulkHeaderFiles, sha256Hash, stampLog, stampLogFormat, startChaintracks, tableAuthSessionToPeerSession, throwDummyReviewActions, toBinaryBaseBlockHeader, toDefaultChaintracksArguments, toLookupNetworkPreset, toWalletNetwork, transactionColumnsWithoutRawTx, upgradeLegacyManagedChangeBasketDefault, blockHeaderUtilities_d_exports as utils, validateManagedChangePolicy, validateScriptHash, validateSecondsSinceEpoch, validateStorageFeeModel, verifyHexString, verifyId, verifyInteger, verifyNumber, verifyOne, verifyOneOrNone, verifyOptionalHexString, verifyTruthy, wait, wocGetHeadersHeaderToBlockHeader };
|
|
11401
|
+
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, BRC153_REFERENCE_PREFIX, BRC38ImportOptions, BRC38ImportResult, BRC38Tables, BRC38WalletData, BRC39Options, type BaseBlockHeader, type BlockHeader, BulkFileDataCacheApi, BulkFileDataManager, BulkFileDataManagerMergeResult, BulkFileDataManagerOptions, BulkFileDataManagerStats, BulkFileDataReader, BulkFileDownloadBudgetApi, BulkFilesReader, BulkFilesReaderFs, BulkFilesReaderStorage, BulkHeaderFile, BulkHeaderFileFs, BulkHeaderFileInfo, BulkHeaderFileStorage, BulkHeaderFiles, BulkHeaderFilesInfo, BulkIngestorApi, BulkIngestorBase, BulkIngestorBaseOptions, BulkIngestorCDN, BulkIngestorCDNBabbage, BulkIngestorCDNOptions, BulkIngestorChaintracks, BulkIngestorChaintracksOptions, BulkIngestorWhatsOnChainCdn, BulkIngestorWhatsOnChainOptions, BulkStorageApi, BulkStorageBase, BulkStorageBaseOptions, BulkSyncResult, ByteEncoding, ByteInput, CWIStyleWalletManager, Certifier, type Chain, Chaintracks, ChaintracksApi, ChaintracksAppendableFileApi, ChaintracksArgumentsTail, ChaintracksBulkDataStatsApi, ChaintracksChainTracker, ChaintracksChainTrackerOptions, ChaintracksClientApi, ChaintracksFetch, ChaintracksFetchApi, ChaintracksFetchError, ChaintracksFetchOptions, 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_MANAGED_CHANGE_MAX_OUTPUTS_PER_ACTION, DEFAULT_MANAGED_CHANGE_MIGRATION_INPUTS_PER_ACTION, DEFAULT_MANAGED_CHANGE_MINIMUM_SATOSHIS, DEFAULT_MANAGED_CHANGE_PENDING_COMPARISON_INPUTS, DEFAULT_MANAGED_CHANGE_TARGET_UTXOS, 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, FixedWindowBulkFileDownloadBudget, FixedWindowBulkFileDownloadBudgetOptions, GetHeaderByteFileLinksResult, GoChaintracksServiceClient, GoChaintracksServiceClientOptions, GroupedPermissionEventHandler, GroupedPermissionRequest, GroupedPermissions, HeaderListener, HeightRange, HeightRangeApi, HeightRanges, InsertHeaderResult, KDF_MAX_HASH_LENGTH, KdfConfig, KeyPairAddress, LEGACY_MANAGED_CHANGE_MINIMUM_SATOSHIS, LineItemType, ListActionsSpecOp, ListOutputsSpecOp, LiveBlockHeader, LiveIngestorApi, LiveIngestorBase, LiveIngestorBaseOptions, LiveIngestorChaintracksSSE, LiveIngestorChaintracksSSEOptions, LiveIngestorWhatsOnChainOptions, LiveIngestorWhatsOnChainPoll, LocalChainTracker, LocalChainTrackerConsistency, LocalChainTrackerMode, LocalChainTrackerOptions, LocalChainTrackerRecoveryEvidence, LocalChainTrackerStatus, MAX_STATE_SNAPSHOT_BYTES, ManagedChangeBasketDefaults, ManagedChangePolicy, ManagedChangePolicyOptions, 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, applyBrc153ReferenceLabel, 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, defaultManagedChangePolicy, doubleSha256BE, doubleSha256LE, encryptBRC39, exportBRC38, exportBRC38Json, exportBRC39, getIdentityKey, getLabelToSpecOp, getListOutputsSpecOp, importBRC38, importBRC39, isAutoSpendableChangeOutput, isBaseBlockHeader, isBlockHeader, isBrc153ReferenceLabel, isLegacyManagedChangeBasketDefault, isLive, isLiveBlockHeader, isManagedChangeOutput, logCreateActionArgs, logWalletError, logger, makeAtomicBeef, makeBrc114ActionTimeLabel, makeBrc153ReferenceLabel, managedChangeOutputFields, maxDate, optionalArraysEqual, outputColumnsWithoutLockingScript, parseBRC38Json, parseBrc114ActionTimeLabels, parseBrc153ReferenceLabel, parseFileLink, parseTxScriptOffsets, partitionActionLabels, randomBytes, randomBytesBase64, randomBytesHex, resolveDefaultChaintracksArguments, index_d_exports as sdk, selectBulkHeaderFiles, sha256Hash, stampLog, stampLogFormat, startChaintracks, tableAuthSessionToPeerSession, throwDummyReviewActions, toBinaryBaseBlockHeader, toDefaultChaintracksArguments, toLookupNetworkPreset, toWalletNetwork, transactionColumnsWithoutRawTx, upgradeLegacyManagedChangeBasketDefault, blockHeaderUtilities_d_exports as utils, validateManagedChangePolicy, validateScriptHash, validateSecondsSinceEpoch, validateStorageFeeModel, verifyHexString, verifyId, verifyInteger, verifyNumber, verifyOne, verifyOneOrNone, verifyOptionalHexString, verifyTruthy, wait, wocGetHeadersHeaderToBlockHeader };
|
|
11162
11402
|
//# sourceMappingURL=index.client.d.mts.map
|