@bopen-io/wallet-toolbox 2.15.0-bopen.2 → 2.15.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/CHANGELOG.md +183 -0
- package/README.md +127 -25
- package/docs/client.md +312 -154
- package/docs/monitor.md +2 -2
- package/docs/no-send-expiry.md +7 -2
- package/docs/services.md +143 -60
- package/docs/wallet.md +208 -117
- package/out/src/CWIStyleWalletManager.d.ts +36 -5
- package/out/src/CWIStyleWalletManager.d.ts.map +1 -1
- package/out/src/CWIStyleWalletManager.js +356 -60
- package/out/src/CWIStyleWalletManager.js.map +1 -1
- package/out/src/Wallet.d.ts.map +1 -1
- package/out/src/Wallet.js +8 -3
- package/out/src/Wallet.js.map +1 -1
- package/out/src/WalletAuthenticationManager.d.ts +3 -0
- package/out/src/WalletAuthenticationManager.d.ts.map +1 -1
- package/out/src/WalletAuthenticationManager.js +86 -3
- package/out/src/WalletAuthenticationManager.js.map +1 -1
- package/out/src/WalletPermissionsManager.d.ts +63 -9
- package/out/src/WalletPermissionsManager.d.ts.map +1 -1
- package/out/src/WalletPermissionsManager.js +213 -49
- package/out/src/WalletPermissionsManager.js.map +1 -1
- package/out/src/monitor/Monitor.js +1 -1
- package/out/src/monitor/Monitor.js.map +1 -1
- package/out/src/monitor/monitorValidation.d.ts +2 -1
- package/out/src/monitor/monitorValidation.d.ts.map +1 -1
- package/out/src/monitor/monitorValidation.js +2 -2
- package/out/src/monitor/monitorValidation.js.map +1 -1
- package/out/src/monitor/tasks/TaskNewHeader.d.ts.map +1 -1
- package/out/src/monitor/tasks/TaskNewHeader.js +1 -1
- package/out/src/monitor/tasks/TaskNewHeader.js.map +1 -1
- package/out/src/monitor/tasks/TaskReviewUtxos.d.ts.map +1 -1
- package/out/src/monitor/tasks/TaskReviewUtxos.js +2 -1
- package/out/src/monitor/tasks/TaskReviewUtxos.js.map +1 -1
- package/out/src/sdk/WERR_errors.d.ts +4 -0
- package/out/src/sdk/WERR_errors.d.ts.map +1 -1
- package/out/src/sdk/WERR_errors.js +4 -0
- package/out/src/sdk/WERR_errors.js.map +1 -1
- package/out/src/sdk/WalletErrorFromJson.d.ts.map +1 -1
- package/out/src/sdk/WalletErrorFromJson.js +23 -2
- package/out/src/sdk/WalletErrorFromJson.js.map +1 -1
- package/out/src/sdk/WalletStorage.interfaces.d.ts +11 -0
- package/out/src/sdk/WalletStorage.interfaces.d.ts.map +1 -1
- package/out/src/sdk/types.d.ts +12 -1
- package/out/src/sdk/types.d.ts.map +1 -1
- package/out/src/sdk/types.js +19 -2
- package/out/src/sdk/types.js.map +1 -1
- package/out/src/services/Services.d.ts.map +1 -1
- package/out/src/services/Services.js +5 -3
- package/out/src/services/Services.js.map +1 -1
- package/out/src/services/chaintracker/BHServiceClient.js +2 -2
- package/out/src/services/chaintracker/BHServiceClient.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Chaintracks.js +2 -2
- package/out/src/services/chaintracker/chaintracks/Chaintracks.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/ChaintracksServiceClient.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/ChaintracksServiceClient.js +3 -1
- package/out/src/services/chaintracker/chaintracks/ChaintracksServiceClient.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/GoChaintracksServiceClient.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/GoChaintracksServiceClient.js +3 -1
- package/out/src/services/chaintracker/chaintracks/GoChaintracksServiceClient.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorBase.js +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/BulkIngestorBase.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.js +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorBase.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorChaintracksSSE.js +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/LiveIngestorChaintracksSSE.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.js +2 -0
- package/out/src/services/chaintracker/chaintracks/Ingest/WhatsOnChainIngestorWs.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Storage/BulkStorageBase.js +2 -2
- package/out/src/services/chaintracker/chaintracks/Storage/BulkStorageBase.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageBase.js +6 -6
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageBase.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageIdb.js +2 -2
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageIdb.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageKnex.js +2 -2
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageKnex.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageNoDb.d.ts +1 -0
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageNoDb.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageNoDb.js +11 -3
- package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksStorageNoDb.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/BulkFileDataManager.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/BulkFileDataManager.js +13 -9
- package/out/src/services/chaintracker/chaintracks/util/BulkFileDataManager.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/BulkFilesReader.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/BulkFilesReader.js +2 -2
- package/out/src/services/chaintracker/chaintracks/util/BulkFilesReader.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/InlineBulkFileDataValidator.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/InlineBulkFileDataValidator.js +2 -2
- package/out/src/services/chaintracker/chaintracks/util/InlineBulkFileDataValidator.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.d.ts +23 -5
- package/out/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.js +58 -16
- package/out/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.js.map +1 -1
- package/out/src/services/createDefaultWalletServicesOptions.d.ts +6 -3
- package/out/src/services/createDefaultWalletServicesOptions.d.ts.map +1 -1
- package/out/src/services/createDefaultWalletServicesOptions.js +18 -6
- package/out/src/services/createDefaultWalletServicesOptions.js.map +1 -1
- package/out/src/services/networkConfig.d.ts +7 -0
- package/out/src/services/networkConfig.d.ts.map +1 -1
- package/out/src/services/networkConfig.js +25 -2
- package/out/src/services/networkConfig.js.map +1 -1
- package/out/src/services/providers/SdkWhatsOnChain.d.ts +8 -2
- package/out/src/services/providers/SdkWhatsOnChain.d.ts.map +1 -1
- package/out/src/services/providers/SdkWhatsOnChain.js +17 -6
- package/out/src/services/providers/SdkWhatsOnChain.js.map +1 -1
- package/out/src/services/validateMerklePathResult.d.ts +4 -3
- package/out/src/services/validateMerklePathResult.d.ts.map +1 -1
- package/out/src/services/validateMerklePathResult.js +6 -6
- package/out/src/services/validateMerklePathResult.js.map +1 -1
- package/out/src/signer/actionBatch/ActionBatchWorkspace.d.ts.map +1 -1
- package/out/src/signer/actionBatch/ActionBatchWorkspace.js +3 -2
- package/out/src/signer/actionBatch/ActionBatchWorkspace.js.map +1 -1
- package/out/src/signer/methods/createAction.d.ts +32 -1
- package/out/src/signer/methods/createAction.d.ts.map +1 -1
- package/out/src/signer/methods/createAction.js +56 -1
- package/out/src/signer/methods/createAction.js.map +1 -1
- package/out/src/signer/methods/internalizeAction.js +1 -1
- package/out/src/signer/methods/internalizeAction.js.map +1 -1
- package/out/src/signer/methods/signAction.js +8 -1
- package/out/src/signer/methods/signAction.js.map +1 -1
- package/out/src/storage/StorageIdb.js +4 -4
- package/out/src/storage/StorageIdb.js.map +1 -1
- package/out/src/storage/StorageKnex.d.ts +6 -2
- package/out/src/storage/StorageKnex.d.ts.map +1 -1
- package/out/src/storage/StorageKnex.js +114 -0
- package/out/src/storage/StorageKnex.js.map +1 -1
- package/out/src/storage/WalletStorageManager.d.ts.map +1 -1
- package/out/src/storage/WalletStorageManager.js +5 -0
- package/out/src/storage/WalletStorageManager.js.map +1 -1
- package/out/src/storage/methods/ListOutputsSpecOp.d.ts.map +1 -1
- package/out/src/storage/methods/ListOutputsSpecOp.js +84 -0
- package/out/src/storage/methods/ListOutputsSpecOp.js.map +1 -1
- package/out/src/storage/methods/attemptToPostReqsToNetwork.d.ts.map +1 -1
- package/out/src/storage/methods/attemptToPostReqsToNetwork.js +7 -3
- package/out/src/storage/methods/attemptToPostReqsToNetwork.js.map +1 -1
- package/out/src/storage/methods/createAction.d.ts +5 -0
- package/out/src/storage/methods/createAction.d.ts.map +1 -1
- package/out/src/storage/methods/createAction.js +13 -6
- package/out/src/storage/methods/createAction.js.map +1 -1
- package/out/src/storage/methods/generateChange.d.ts +6 -0
- package/out/src/storage/methods/generateChange.d.ts.map +1 -1
- package/out/src/storage/methods/generateChange.js +10 -3
- package/out/src/storage/methods/generateChange.js.map +1 -1
- package/out/src/storage/methods/internalizeAction.d.ts +8 -1
- package/out/src/storage/methods/internalizeAction.d.ts.map +1 -1
- package/out/src/storage/methods/internalizeAction.js +106 -42
- package/out/src/storage/methods/internalizeAction.js.map +1 -1
- package/out/src/storage/methods/listOutputsKnex.js +1 -1
- package/out/src/storage/methods/listOutputsKnex.js.map +1 -1
- package/out/src/storage/methods/noSendExpiry.d.ts.map +1 -1
- package/out/src/storage/methods/noSendExpiry.js +14 -4
- package/out/src/storage/methods/noSendExpiry.js.map +1 -1
- package/out/src/storage/remoting/StorageClientBase.d.ts.map +1 -1
- package/out/src/storage/remoting/StorageClientBase.js +15 -5
- package/out/src/storage/remoting/StorageClientBase.js.map +1 -1
- package/out/src/storage/remoting/StorageServer.d.ts.map +1 -1
- package/out/src/storage/remoting/StorageServer.js +12 -1
- package/out/src/storage/remoting/StorageServer.js.map +1 -1
- package/out/src/storage/remoting/syncChunkBinary.d.ts +10 -0
- package/out/src/storage/remoting/syncChunkBinary.d.ts.map +1 -1
- package/out/src/storage/remoting/syncChunkBinary.js +15 -11
- package/out/src/storage/remoting/syncChunkBinary.js.map +1 -1
- package/out/src/storage/schema/KnexMigrations.d.ts +1 -0
- package/out/src/storage/schema/KnexMigrations.d.ts.map +1 -1
- package/out/src/storage/schema/KnexMigrations.js +26 -4
- package/out/src/storage/schema/KnexMigrations.js.map +1 -1
- package/out/src/storage/sync/liveSyncGuards.d.ts +11 -0
- package/out/src/storage/sync/liveSyncGuards.d.ts.map +1 -0
- package/out/src/storage/sync/liveSyncGuards.js +22 -0
- package/out/src/storage/sync/liveSyncGuards.js.map +1 -0
- package/out/src/utility/actionOutputAuthorizations.d.ts +10 -0
- package/out/src/utility/actionOutputAuthorizations.d.ts.map +1 -0
- package/out/src/utility/actionOutputAuthorizations.js +25 -0
- package/out/src/utility/actionOutputAuthorizations.js.map +1 -0
- package/out/src/utility/index.all.d.ts +1 -0
- package/out/src/utility/index.all.d.ts.map +1 -1
- package/out/src/utility/index.all.js +1 -0
- package/out/src/utility/index.all.js.map +1 -1
- package/out/src/utility/index.client.d.ts +1 -0
- package/out/src/utility/index.client.d.ts.map +1 -1
- package/out/src/utility/index.client.js +1 -0
- package/out/src/utility/index.client.js.map +1 -1
- package/out/src/utility/numericTotalOutputs.d.ts +7 -0
- package/out/src/utility/numericTotalOutputs.d.ts.map +1 -0
- package/out/src/utility/numericTotalOutputs.js +15 -0
- package/out/src/utility/numericTotalOutputs.js.map +1 -0
- package/out/src/utility/utilityHelpers.d.ts.map +1 -1
- package/out/src/utility/utilityHelpers.js +2 -0
- package/out/src/utility/utilityHelpers.js.map +1 -1
- package/package.json +18 -22
package/docs/wallet.md
CHANGED
|
@@ -4975,6 +4975,18 @@ nextCheckpoint?: SyncCheckpoint
|
|
|
4975
4975
|
```
|
|
4976
4976
|
See also: [SyncCheckpoint](./client.md#interface-synccheckpoint)
|
|
4977
4977
|
|
|
4978
|
+
###### Property error
|
|
4979
|
+
|
|
4980
|
+
Optional non-throwing failure from a custom writer. First-party
|
|
4981
|
+
`StorageProvider` implementations throw instead of setting this field.
|
|
4982
|
+
`WalletStorageManager.syncToWriter` and `syncFromReader` throw `error`
|
|
4983
|
+
immediately and do not request another chunk.
|
|
4984
|
+
|
|
4985
|
+
```ts
|
|
4986
|
+
error?: WalletError
|
|
4987
|
+
```
|
|
4988
|
+
See also: [WalletError](./client.md#class-walleterror)
|
|
4989
|
+
|
|
4978
4990
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
4979
4991
|
|
|
4980
4992
|
---
|
|
@@ -11104,7 +11116,8 @@ export default class SdkWhatsOnChain implements ChainTracker {
|
|
|
11104
11116
|
protected readonly URL: string;
|
|
11105
11117
|
protected readonly httpClient: HttpClient;
|
|
11106
11118
|
protected readonly requestTimeoutMsecs: number;
|
|
11107
|
-
constructor(network: "main" | "test" | "stn" | "ttn" | "tstn" = "main", config: LocalWhatsOnChainConfig = {})
|
|
11119
|
+
constructor(network: "main" | "test" | "stn" | "ttn" | "tstn" | "regtest" = "main", config: LocalWhatsOnChainConfig = {})
|
|
11120
|
+
get isAvailable(): boolean
|
|
11108
11121
|
protected async request<T, Data = unknown>(url: string, options: HttpClientRequestOptions<Data>): Promise<HttpClientResponse<T>>
|
|
11109
11122
|
async isValidRootForHeight(root: string, height: number): Promise<boolean>
|
|
11110
11123
|
async currentHeight(): Promise<number>
|
|
@@ -11115,9 +11128,10 @@ export default class SdkWhatsOnChain implements ChainTracker {
|
|
|
11115
11128
|
###### Constructor
|
|
11116
11129
|
|
|
11117
11130
|
Constructs an instance of the WhatsOnChain ChainTracker.
|
|
11131
|
+
`tstn` and `regtest` have no WhatsOnChain service, so every request made for them is refused.
|
|
11118
11132
|
|
|
11119
11133
|
```ts
|
|
11120
|
-
constructor(network: "main" | "test" | "stn" | "ttn" | "tstn" = "main", config: LocalWhatsOnChainConfig = {})
|
|
11134
|
+
constructor(network: "main" | "test" | "stn" | "ttn" | "tstn" | "regtest" = "main", config: LocalWhatsOnChainConfig = {})
|
|
11121
11135
|
```
|
|
11122
11136
|
|
|
11123
11137
|
Argument Details
|
|
@@ -12804,6 +12818,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
12804
12818
|
|
|
12805
12819
|
Configured network chain is invalid or does not match across services.
|
|
12806
12820
|
|
|
12821
|
+
Live `WalletStorageManager.syncToWriter` and `syncFromReader` throw this
|
|
12822
|
+
before any sync chunk moves when the reader and writer `TableSettings.chain`
|
|
12823
|
+
values differ.
|
|
12824
|
+
|
|
12807
12825
|
```ts
|
|
12808
12826
|
export class WERR_NETWORK_CHAIN extends WalletError {
|
|
12809
12827
|
constructor(message?: string)
|
|
@@ -13862,104 +13880,104 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
13862
13880
|
|
|
13863
13881
|
| | | |
|
|
13864
13882
|
| --- | --- | --- |
|
|
13865
|
-
| [WalletErrorFromJson](#function-walleterrorfromjson) | [
|
|
13866
|
-
| [abortActionBatch](#function-abortactionbatch) | [
|
|
13867
|
-
| [acquireDirectCertificate](#function-acquiredirectcertificate) | [
|
|
13868
|
-
| [actionBatchBlobDigest](#function-actionbatchblobdigest) | [
|
|
13869
|
-
| [actionBatchBootstrap](#function-actionbatchbootstrap) | [
|
|
13870
|
-
| [actionBatchManifestDigest](#function-actionbatchmanifestdigest) | [
|
|
13871
|
-
| [actionBatchPackLength](#function-actionbatchpacklength) | [
|
|
13872
|
-
| [activateNoSendExpiry](#function-activatenosendexpiry) | [
|
|
13873
|
-
| [addPlannerOutputs](#function-addplanneroutputs) | [
|
|
13874
|
-
| [addWork](#function-addwork) | [
|
|
13875
|
-
| [additionalFundingTarget](#function-additionalfundingtarget) | [
|
|
13876
|
-
| [arcDefaultUrl](#function-arcdefaulturl) | [
|
|
13877
|
-
| [arcGorillaPoolUrl](#function-arcgorillapoolurl) | [
|
|
13878
|
-
| [arcadeDefaultUrl](#function-arcadedefaulturl) | [
|
|
13879
|
-
| [armNoSendExpiry](#function-armnosendexpiry) | [
|
|
13880
|
-
| [arraysEqual](#function-arraysequal) | [
|
|
13881
|
-
| [asArray](#function-asarray) | [
|
|
13882
|
-
| [asBsvSdkPrivateKey](#function-asbsvsdkprivatekey) | [
|
|
13883
|
-
| [asBsvSdkPublickKey](#function-asbsvsdkpublickkey) | [
|
|
13884
|
-
| [asBsvSdkScript](#function-asbsvsdkscript) | [
|
|
13885
|
-
| [asBsvSdkTx](#function-asbsvsdktx) | [
|
|
13886
|
-
| [asString](#function-asstring) | [
|
|
13887
|
-
| [asUint8Array](#function-asuint8array) | [
|
|
13888
|
-
| [assertAbortResult](#function-assertabortresult) | [
|
|
13889
|
-
| [assertInternalizeAccepted](#function-assertinternalizeaccepted) | [
|
|
13890
|
-
| [assertStorageMutationSucceeded](#function-assertstoragemutationsucceeded) | [
|
|
13891
|
-
| [assertSyncProofReplacementAuthorized](#function-assertsyncproofreplacementauthorized) | [
|
|
13892
|
-
| [attemptToPostReqsToNetwork](#function-attempttopostreqstonetwork) | [
|
|
13893
|
-
| [authenticateMerklePathResult](#function-authenticatemerklepathresult) | [
|
|
13894
|
-
| [availableManagedChange](#function-availablemanagedchange) | [
|
|
13895
|
-
| [beefForTxids](#function-beeffortxids) | [
|
|
13896
|
-
| [beginActionBatch](#function-beginactionbatch) | [
|
|
13897
|
-
| [blockHash](#function-blockhash) | [
|
|
13898
|
-
| [brc177NoSendExpiryStateRank](#function-brc177nosendexpirystaterank) | [
|
|
13899
|
-
| [buildSignableTransaction](#function-buildsignabletransaction) | [
|
|
13900
|
-
| [canonicalizeAtomicBeef](#function-canonicalizeatomicbeef) | [
|
|
13901
|
-
| [canonicalizeSyncProofIdentifiers](#function-canonicalizesyncproofidentifiers) | [
|
|
13902
|
-
| [classifyArcadeRejection](#function-classifyarcaderejection) | [
|
|
13903
|
-
| [classifyBroadcastInputSpendEvidence](#function-classifybroadcastinputspendevidence) | [
|
|
13904
|
-
| [classifyMerklePathResponse](#function-classifymerklepathresponse) | [
|
|
13905
|
-
| [classifyOutputUtxo](#function-classifyoutpututxo) | [
|
|
13906
|
-
| [classifyReqStatus](#function-classifyreqstatus) | [
|
|
13907
|
-
| [cleanupExpiredActionBatches](#function-cleanupexpiredactionbatches) | [
|
|
13908
|
-
| [commitActionBatch](#function-commitactionbatch) | [
|
|
13909
|
-
| [commitActionBatchByDigest](#function-commitactionbatchbydigest) | [
|
|
13910
|
-
| [completeSignedTransaction](#function-completesignedtransaction) | [
|
|
13911
|
-
| [compressActionBatchPack](#function-compressactionbatchpack) | [
|
|
13912
|
-
| [compressActionBatchPackItems](#function-compressactionbatchpackitems) | [
|
|
13913
|
-
| [computeMerklePath](#function-computemerklepath) | [
|
|
13914
|
-
| [computeMerkleRoot](#function-computemerkleroot) | [
|
|
13915
|
-
| [containsControlCharacter](#function-containscontrolcharacter) | [
|
|
13916
|
-
| [convertBitsToTarget](#function-convertbitstotarget) | [
|
|
13917
|
-
| [convertBitsToWork](#function-convertbitstowork) | [
|
|
13918
|
-
| [convertBufferToUint32](#function-convertbuffertouint32) | [
|
|
13919
|
-
| [convertProofToMerklePath](#function-convertprooftomerklepath) | [
|
|
13920
|
-
| [convertUint32ToBuffer](#function-convertuint32tobuffer) | [
|
|
13921
|
-
| [convertWocToBlockHeaderHex](#function-convertwoctoblockheaderhex) | [
|
|
13922
|
-
| [copyMonitorTags](#function-copymonitortags) | [
|
|
13923
|
-
| [copyRawTransactionBytes](#function-copyrawtransactionbytes) | [
|
|
13924
|
-
| [copyValidatedBlockHeader](#function-copyvalidatedblockheader) | [
|
|
13925
|
-
| [copyValidatedMonitorHeader](#function-copyvalidatedmonitorheader) | [
|
|
13926
|
-
| [createAction](#function-createaction) | [
|
|
13927
|
-
| [
|
|
13928
|
-
| [
|
|
13929
|
-
| [
|
|
13930
|
-
| [
|
|
13931
|
-
| [
|
|
13932
|
-
| [
|
|
13933
|
-
| [
|
|
13934
|
-
| [
|
|
13935
|
-
| [
|
|
13936
|
-
| [
|
|
13937
|
-
| [
|
|
13938
|
-
| [
|
|
13939
|
-
| [
|
|
13940
|
-
| [
|
|
13941
|
-
| [
|
|
13942
|
-
| [
|
|
13943
|
-
| [
|
|
13944
|
-
| [
|
|
13945
|
-
| [
|
|
13946
|
-
| [
|
|
13947
|
-
| [
|
|
13948
|
-
| [
|
|
13949
|
-
| [
|
|
13950
|
-
| [
|
|
13951
|
-
| [
|
|
13952
|
-
| [
|
|
13953
|
-
| [
|
|
13954
|
-
| [
|
|
13955
|
-
| [
|
|
13956
|
-
| [
|
|
13957
|
-
| [
|
|
13958
|
-
| [
|
|
13959
|
-
| [
|
|
13960
|
-
| [
|
|
13961
|
-
| [
|
|
13962
|
-
| [
|
|
13883
|
+
| [WalletErrorFromJson](#function-walleterrorfromjson) | [handleScriptHashHistoryCatch](#function-handlescripthashhistorycatch) | [resumeActionBatch](#function-resumeactionbatch) |
|
|
13884
|
+
| [abortActionBatch](#function-abortactionbatch) | [handleScriptHashHistoryResponse](#function-handlescripthashhistoryresponse) | [reviewUtxoOutputs](#function-reviewutxooutputs) |
|
|
13885
|
+
| [acquireDirectCertificate](#function-acquiredirectcertificate) | [handleUtxoConnReset](#function-handleutxoconnreset) | [safeDiagnostic](#function-safediagnostic) |
|
|
13886
|
+
| [actionBatchBlobDigest](#function-actionbatchblobdigest) | [hasBrc177NoSendExpiryLabel](#function-hasbrc177nosendexpirylabel) | [sameSyncProof](#function-samesyncproof) |
|
|
13887
|
+
| [actionBatchBootstrap](#function-actionbatchbootstrap) | [inputSourceTxid](#function-inputsourcetxid) | [selectBulkHeaderFiles](#function-selectbulkheaderfiles) |
|
|
13888
|
+
| [actionBatchManifestDigest](#function-actionbatchmanifestdigest) | [internalizeAction](#function-internalizeaction) | [selectCanonicalChange](#function-selectcanonicalchange) |
|
|
13889
|
+
| [actionBatchPackLength](#function-actionbatchpacklength) | [isArcAcceptedTxStatus](#function-isarcacceptedtxstatus) | [selectNoSendExpiryFundingAnchor](#function-selectnosendexpiryfundinganchor) |
|
|
13890
|
+
| [activateNoSendExpiry](#function-activatenosendexpiry) | [isArcDoubleSpendTxStatus](#function-isarcdoublespendtxstatus) | [serializeBaseBlockHeader](#function-serializebaseblockheader) |
|
|
13891
|
+
| [addPlannerOutputs](#function-addplanneroutputs) | [isArcInvalidTxStatus](#function-isarcinvalidtxstatus) | [serializeBaseBlockHeaders](#function-serializebaseblockheaders) |
|
|
13892
|
+
| [addWork](#function-addwork) | [isArcServiceErrorStatus](#function-isarcserviceerrorstatus) | [setDisableDoubleSpendCheckForTest](#function-setdisabledoublespendcheckfortest) |
|
|
13893
|
+
| [additionalFundingTarget](#function-additionalfundingtarget) | [isAutoSpendableChangeOutput](#function-isautospendablechangeoutput) | [setResultBeef](#function-setresultbeef) |
|
|
13894
|
+
| [arcDefaultUrl](#function-arcdefaulturl) | [isBaseBlockHeader](#function-isbaseblockheader) | [sha256Hash](#function-sha256hash) |
|
|
13895
|
+
| [arcGorillaPoolUrl](#function-arcgorillapoolurl) | [isBlockHeader](#function-isblockheader) | [sha256HashOfBinaryFile](#function-sha256hashofbinaryfile) |
|
|
13896
|
+
| [arcadeDefaultUrl](#function-arcadedefaulturl) | [isCreateActionSpecOp](#function-iscreateactionspecop) | [shareReqsWithWorld](#function-sharereqswithworld) |
|
|
13897
|
+
| [armNoSendExpiry](#function-armnosendexpiry) | [isKnownValidBulkHeaderFile](#function-isknownvalidbulkheaderfile) | [signAction](#function-signaction) |
|
|
13898
|
+
| [arraysEqual](#function-arraysequal) | [isLegacyManagedChangeBasketDefault](#function-islegacymanagedchangebasketdefault) | [snapshotMerklePathResult](#function-snapshotmerklepathresult) |
|
|
13899
|
+
| [asArray](#function-asarray) | [isListActionsSpecOp](#function-islistactionsspecop) | [snapshotPostBeefRequest](#function-snapshotpostbeefrequest) |
|
|
13900
|
+
| [asBsvSdkPrivateKey](#function-asbsvsdkprivatekey) | [isListOutputsSpecOp](#function-islistoutputsspecop) | [stageTransactionOutputs](#function-stagetransactionoutputs) |
|
|
13901
|
+
| [asBsvSdkPublickKey](#function-asbsvsdkpublickkey) | [isLive](#function-islive) | [stampLog](#function-stamplog) |
|
|
13902
|
+
| [asBsvSdkScript](#function-asbsvsdkscript) | [isLiveBlockHeader](#function-isliveblockheader) | [stampLogFormat](#function-stamplogformat) |
|
|
13903
|
+
| [asBsvSdkTx](#function-asbsvsdktx) | [isManagedChangeOutput](#function-ismanagedchangeoutput) | [stnArcadeUrl](#function-stnarcadeurl) |
|
|
13904
|
+
| [asString](#function-asstring) | [isMoreWork](#function-ismorework) | [stnChaintracksUrl](#function-stnchaintracksurl) |
|
|
13905
|
+
| [asUint8Array](#function-asuint8array) | [isValidFiatRate](#function-isvalidfiatrate) | [subWork](#function-subwork) |
|
|
13906
|
+
| [assertAbortResult](#function-assertabortresult) | [keyOffsetToHashedSecret](#function-keyoffsettohashedsecret) | [supportedActionBatchPackEncodings](#function-supportedactionbatchpackencodings) |
|
|
13907
|
+
| [assertInternalizeAccepted](#function-assertinternalizeaccepted) | [listCertificates](#function-listcertificates) | [swapByteOrder](#function-swapbyteorder) |
|
|
13908
|
+
| [assertStorageMutationSucceeded](#function-assertstoragemutationsucceeded) | [lockScriptWithKeyOffsetFromPubKey](#function-lockscriptwithkeyoffsetfrompubkey) | [syncProofUpdatedAt](#function-syncproofupdatedat) |
|
|
13909
|
+
| [assertSyncProofReplacementAuthorized](#function-assertsyncproofreplacementauthorized) | [lookupPreparedBeefs](#function-lookuppreparedbeefs) | [targetForStorage](#function-targetforstorage) |
|
|
13910
|
+
| [attemptToPostReqsToNetwork](#function-attempttopostreqstonetwork) | [makeAtomicBeef](#function-makeatomicbeef) | [throwDummyReviewActions](#function-throwdummyreviewactions) |
|
|
13911
|
+
| [authenticateMerklePathResult](#function-authenticatemerklepathresult) | [makeChangeLock](#function-makechangelock) | [toBinaryBaseBlockHeader](#function-tobinarybaseblockheader) |
|
|
13912
|
+
| [availableManagedChange](#function-availablemanagedchange) | [makeMerklePathNote](#function-makemerklepathnote) | [toLookupNetworkPreset](#function-tolookupnetworkpreset) |
|
|
13913
|
+
| [beefForTxids](#function-beeffortxids) | [makeNoSendExpiryFundingArgs](#function-makenosendexpiryfundingargs) | [toWalletNetwork](#function-towalletnetwork) |
|
|
13914
|
+
| [beginActionBatch](#function-beginactionbatch) | [makePostBeefServiceError](#function-makepostbeefserviceerror) | [transactionInputSize](#function-transactioninputsize) |
|
|
13915
|
+
| [blockHash](#function-blockhash) | [manifestPhysicalDigests](#function-manifestphysicaldigests) | [transactionOutputSize](#function-transactionoutputsize) |
|
|
13916
|
+
| [brc177NoSendExpiryStateRank](#function-brc177nosendexpirystaterank) | [mapWithConcurrency](#function-mapwithconcurrency) | [transactionSize](#function-transactionsize) |
|
|
13917
|
+
| [buildSignableTransaction](#function-buildsignabletransaction) | [markConfirmedStaleReqInputs](#function-markconfirmedstalereqinputs) | [tstnArcadeUrl](#function-tstnarcadeurl) |
|
|
13918
|
+
| [canonicalizeAtomicBeef](#function-canonicalizeatomicbeef) | [markStaleInputsAsSpent](#function-markstaleinputsasspent) | [tstnChaintracksUrl](#function-tstnchaintracksurl) |
|
|
13919
|
+
| [canonicalizeSyncProofIdentifiers](#function-canonicalizesyncproofidentifiers) | [markSyncProofInsertOnly](#function-marksyncproofinsertonly) | [updateChaintracksFiatExchangeRates](#function-updatechaintracksfiatexchangerates) |
|
|
13920
|
+
| [classifyArcadeRejection](#function-classifyarcaderejection) | [markSyncProofReconciled](#function-marksyncproofreconciled) | [updateExchangeratesapi](#function-updateexchangeratesapi) |
|
|
13921
|
+
| [classifyBroadcastInputSpendEvidence](#function-classifybroadcastinputspendevidence) | [markUserInputsSpent](#function-markuserinputsspent) | [updateReqsFromAggregateResults](#function-updatereqsfromaggregateresults) |
|
|
13922
|
+
| [classifyMerklePathResponse](#function-classifymerklepathresponse) | [maxDate](#function-maxdate) | [upgradeLegacyManagedChangeBasketDefault](#function-upgradelegacymanagedchangebasketdefault) |
|
|
13923
|
+
| [classifyOutputUtxo](#function-classifyoutpututxo) | [mergeInputBeefs](#function-mergeinputbeefs) | [validBulkHeaderFilesByFileHash](#function-validbulkheaderfilesbyfilehash) |
|
|
13924
|
+
| [classifyReqStatus](#function-classifyreqstatus) | [mergeInputsIntoBeef](#function-mergeinputsintobeef) | [validateActionBatchInlinePayload](#function-validateactionbatchinlinepayload) |
|
|
13925
|
+
| [cleanupExpiredActionBatches](#function-cleanupexpiredactionbatches) | [mergePlannerBeef](#function-mergeplannerbeef) | [validateActionBatchSendWith](#function-validateactionbatchsendwith) |
|
|
13926
|
+
| [commitActionBatch](#function-commitactionbatch) | [normalizeArcProviderConfig](#function-normalizearcproviderconfig) | [validateAgainstDirtyHashes](#function-validateagainstdirtyhashes) |
|
|
13927
|
+
| [commitActionBatchByDigest](#function-commitactionbatchbydigest) | [normalizeBulkFileDataValidationRequest](#function-normalizebulkfiledatavalidationrequest) | [validateArcadeTxData](#function-validatearcadetxdata) |
|
|
13928
|
+
| [completeSignedTransaction](#function-completesignedtransaction) | [normalizeBulkHeaderFileInfo](#function-normalizebulkheaderfileinfo) | [validateBaseBlockHeaderFormat](#function-validatebaseblockheaderformat) |
|
|
13929
|
+
| [compressActionBatchPack](#function-compressactionbatchpack) | [normalizeBulkHeaderFileSequence](#function-normalizebulkheaderfilesequence) | [validateBufferOfHeaders](#function-validatebufferofheaders) |
|
|
13930
|
+
| [compressActionBatchPackItems](#function-compressactionbatchpackitems) | [normalizeBulkHeaderFilesInfo](#function-normalizebulkheaderfilesinfo) | [validateBulkFileData](#function-validatebulkfiledata) |
|
|
13931
|
+
| [computeMerklePath](#function-computemerklepath) | [normalizeFiatCurrencies](#function-normalizefiatcurrencies) | [validateCompactManifest](#function-validatecompactmanifest) |
|
|
13932
|
+
| [computeMerkleRoot](#function-computemerkleroot) | [normalizeFiatCurrency](#function-normalizefiatcurrency) | [validateGenerateChangeSdkParams](#function-validategeneratechangesdkparams) |
|
|
13933
|
+
| [containsControlCharacter](#function-containscontrolcharacter) | [normalizeFiatExchangeRates](#function-normalizefiatexchangerates) | [validateGenerateChangeSdkResult](#function-validategeneratechangesdkresult) |
|
|
13934
|
+
| [convertBitsToTarget](#function-convertbitstotarget) | [normalizeFiatRate](#function-normalizefiatrate) | [validateGenesisHeader](#function-validategenesisheader) |
|
|
13935
|
+
| [convertBitsToWork](#function-convertbitstowork) | [normalizeFiatRateTimestamps](#function-normalizefiatratetimestamps) | [validateHeaderDifficulty](#function-validateheaderdifficulty) |
|
|
13936
|
+
| [convertBufferToUint32](#function-convertbuffertouint32) | [normalizeFiatTimestamp](#function-normalizefiattimestamp) | [validateHeaderFormat](#function-validateheaderformat) |
|
|
13937
|
+
| [convertProofToMerklePath](#function-convertprooftomerklepath) | [normalizeMonitorIdentityKey](#function-normalizemonitoridentitykey) | [validateHeaderProofOfWork](#function-validateheaderproofofwork) |
|
|
13938
|
+
| [convertUint32ToBuffer](#function-convertuint32tobuffer) | [normalizePostRawHex](#function-normalizepostrawhex) | [validateManagedChangePolicy](#function-validatemanagedchangepolicy) |
|
|
13939
|
+
| [convertWocToBlockHeaderHex](#function-convertwoctoblockheaderhex) | [normalizePostTxids](#function-normalizeposttxids) | [validateManifestActions](#function-validatemanifestactions) |
|
|
13940
|
+
| [copyMonitorTags](#function-copymonitortags) | [normalizeTxid](#function-normalizetxid) | [validateMerklePathResult](#function-validatemerklepathresult) |
|
|
13941
|
+
| [copyRawTransactionBytes](#function-copyrawtransactionbytes) | [normalizeWalletOutpoint](#function-normalizewalletoutpoint) | [validateMonitorOptions](#function-validatemonitoroptions) |
|
|
13942
|
+
| [copyValidatedBlockHeader](#function-copyvalidatedblockheader) | [notifyTransactionsOfProof](#function-notifytransactionsofproof) | [validateNoSendExpiryRequest](#function-validatenosendexpiryrequest) |
|
|
13943
|
+
| [copyValidatedMonitorHeader](#function-copyvalidatedmonitorheader) | [offsetPrivKey](#function-offsetprivkey) | [validatePostBeefResult](#function-validatepostbeefresult) |
|
|
13944
|
+
| [createAction](#function-createaction) | [offsetPubKey](#function-offsetpubkey) | [validatePostBeefResultOrServiceError](#function-validatepostbeefresultorserviceerror) |
|
|
13945
|
+
| [createCoinbaseTransaction](#function-createcoinbasetransaction) | [optionalArraysEqual](#function-optionalarraysequal) | [validatePostTxResult](#function-validateposttxresult) |
|
|
13946
|
+
| [createDefaultChaintracksClient](#function-createdefaultchaintracksclient) | [optionalMonitorInteger](#function-optionalmonitorinteger) | [validatePostTxResultOrServiceError](#function-validateposttxresultorserviceerror) |
|
|
13947
|
+
| [createDefaultWalletServicesOptions](#function-createdefaultwalletservicesoptions) | [parseBrc177NoSendExpiryLabels](#function-parsebrc177nosendexpirylabels) | [validatePreparedBeefPolicy](#function-validatepreparedbeefpolicy) |
|
|
13948
|
+
| [createNoSendExpiryAction](#function-createnosendexpiryaction) | [parseResults$](#function-parseresults$) | [validateRawTxResult](#function-validaterawtxresult) |
|
|
13949
|
+
| [createStorageServiceChargeScript](#function-createstorageservicechargescript) | [parseTxScriptOffsets](#function-parsetxscriptoffsets) | [validateRequiredInputs](#function-validaterequiredinputs) |
|
|
13950
|
+
| [createSyncMap](#function-createsyncmap) | [planAction](#function-planaction) | [validateRequiredOutputs](#function-validaterequiredoutputs) |
|
|
13951
|
+
| [decodeActionBatchPack](#function-decodeactionbatchpack) | [plannerInputLockingScript](#function-plannerinputlockingscript) | [validateScriptHash](#function-validatescripthash) |
|
|
13952
|
+
| [decompressActionBatchPack](#function-decompressactionbatchpack) | [plannerOutputLockingScript](#function-planneroutputlockingscript) | [validateScriptHashHistoryResult](#function-validatescripthashhistoryresult) |
|
|
13953
|
+
| [defaultManagedChangePolicy](#function-defaultmanagedchangepolicy) | [populateUtxoDetails](#function-populateutxodetails) | [validateSecondsSinceEpoch](#function-validatesecondssinceepoch) |
|
|
13954
|
+
| [defaultPreparedBeefPolicy](#function-defaultpreparedbeefpolicy) | [prepareActionBatchCommit](#function-prepareactionbatchcommit) | [validateStatusForTxidsResult](#function-validatestatusfortxidsresult) |
|
|
13955
|
+
| [deserializeBaseBlockHeader](#function-deserializebaseblockheader) | [prepareNoSendExpiry](#function-preparenosendexpiry) | [validateStorageFeeModel](#function-validatestoragefeemodel) |
|
|
13956
|
+
| [deserializeBaseBlockHeaders](#function-deserializebaseblockheaders) | [processAction](#function-processaction) | [validateSyncCheckpoint](#function-validatesynccheckpoint) |
|
|
13957
|
+
| [deserializeBlockHeader](#function-deserializeblockheader) | [processNoSendExpiryLifecycle](#function-processnosendexpirylifecycle) | [validateSyncProof](#function-validatesyncproof) |
|
|
13958
|
+
| [deserializeBlockHeaders](#function-deserializeblockheaders) | [proofOfWorkLimitBits](#function-proofofworklimitbits) | [validateTrustSettings](#function-validatetrustsettings) |
|
|
13959
|
+
| [doubleSha256BE](#function-doublesha256be) | [proveCertificate](#function-provecertificate) | [validateUtxoStatusResult](#function-validateutxostatusresult) |
|
|
13960
|
+
| [doubleSha256LE](#function-doublesha256le) | [pruneBeefForTxids](#function-prunebeeffortxids) | [validateWalletSettings](#function-validatewalletsettings) |
|
|
13961
|
+
| [encodeActionBatchPack](#function-encodeactionbatchpack) | [publicArcadeUrl](#function-publicarcadeurl) | [validateWocChainInfo](#function-validatewocchaininfo) |
|
|
13962
|
+
| [extendActionBatch](#function-extendactionbatch) | [putActionBatchBlob](#function-putactionbatchblob) | [varUintSize](#function-varuintsize) |
|
|
13963
|
+
| [filterCertificatesByAttributes](#function-filtercertificatesbyattributes) | [putActionBatchPack](#function-putactionbatchpack) | [verifyActionBatchManifestDigest](#function-verifyactionbatchmanifestdigest) |
|
|
13964
|
+
| [filterCertificatesByIdentityKey](#function-filtercertificatesbyidentitykey) | [quarantineReqInputs](#function-quarantinereqinputs) | [verifyHexString](#function-verifyhexstring) |
|
|
13965
|
+
| [fundingRunwayExtension](#function-fundingrunwayextension) | [quarantineReqInputsFromFailedParents](#function-quarantinereqinputsfromfailedparents) | [verifyId](#function-verifyid) |
|
|
13966
|
+
| [generateChangeSdk](#function-generatechangesdk) | [randomBytes](#function-randombytes) | [verifyInteger](#function-verifyinteger) |
|
|
13967
|
+
| [generateChangeSdkMakeStorage](#function-generatechangesdkmakestorage) | [randomBytesBase64](#function-randombytesbase64) | [verifyNumber](#function-verifynumber) |
|
|
13968
|
+
| [genesisBuffer](#function-genesisbuffer) | [randomBytesHex](#function-randombyteshex) | [verifyOne](#function-verifyone) |
|
|
13969
|
+
| [genesisHeader](#function-genesisheader) | [randomizeOutputVouts](#function-randomizeoutputvouts) | [verifyOneOrNone](#function-verifyoneornone) |
|
|
13970
|
+
| [getActionBatchCapabilities](#function-getactionbatchcapabilities) | [rawTransactionBytes](#function-rawtransactionbytes) | [verifyOptionalHexString](#function-verifyoptionalhexstring) |
|
|
13971
|
+
| [getBeefForTransaction](#function-getbeeffortransaction) | [readUInt32BE](#function-readuint32be) | [verifyRequestedOutputsUnchanged](#function-verifyrequestedoutputsunchanged) |
|
|
13972
|
+
| [getBeefForTransactions](#function-getbeeffortransactions) | [readUInt32LE](#function-readuint32le) | [verifyTruthy](#function-verifytruthy) |
|
|
13973
|
+
| [getBeefForTxid](#function-getbeeffortxid) | [redeemServiceCharges](#function-redeemservicecharges) | [verifyUnlockScripts](#function-verifyunlockscripts) |
|
|
13974
|
+
| [getExchangeRatesIo](#function-getexchangeratesio) | [regtestArcadeUrl](#function-regtestarcadeurl) | [verifyUnlockScriptsBatch](#function-verifyunlockscriptsbatch) |
|
|
13975
|
+
| [getIdentityKey](#function-getidentitykey) | [regtestChaintracksUrl](#function-regtestchaintracksurl) | [verifyUnrequestedOutputsAreChangeOrCommission](#function-verifyunrequestedoutputsarechangeorcommission) |
|
|
13976
|
+
| [getProofs](#function-getproofs) | [renewActionBatch](#function-renewactionbatch) | [wait](#function-wait) |
|
|
13977
|
+
| [getResultBeef](#function-getresultbeef) | [repeatableRandom](#function-repeatablerandom) | [workBNtoBuffer](#function-workbntobuffer) |
|
|
13978
|
+
| [getSyncChunk](#function-getsyncchunk) | [requireConclusiveUtxo](#function-requireconclusiveutxo) | [writeUInt32BE](#function-writeuint32be) |
|
|
13979
|
+
| [getWhatsOnChainBlockHeaderByHash](#function-getwhatsonchainblockheaderbyhash) | [requireMonitorInteger](#function-requiremonitorinteger) | [writeUInt32LE](#function-writeuint32le) |
|
|
13980
|
+
| [handlePostRawTxErrorResponse](#function-handlepostrawtxerrorresponse) | [restoreInputsToSpendable](#function-restoreinputstospendable) | |
|
|
13963
13981
|
|
|
13964
13982
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
13965
13983
|
|
|
@@ -14406,10 +14424,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
14406
14424
|
##### Function: authenticateMerklePathResult
|
|
14407
14425
|
|
|
14408
14426
|
```ts
|
|
14409
|
-
export async function authenticateMerklePathResult(requestedTxid: unknown, result: GetMerklePathResult, validator: MerkleRootValidator, requireProofOfWork = false, requireHeaderFormat = true): Promise<ValidatedMerklePathResult>
|
|
14427
|
+
export async function authenticateMerklePathResult(requestedTxid: unknown, result: GetMerklePathResult, validator: MerkleRootValidator, requireProofOfWork = false, requireHeaderFormat = true, chain?: Chain): Promise<ValidatedMerklePathResult>
|
|
14410
14428
|
```
|
|
14411
14429
|
|
|
14412
|
-
See also: [GetMerklePathResult](./client.md#interface-getmerklepathresult), [MerkleRootValidator](./services.md#interface-merklerootvalidator), [ValidatedMerklePathResult](./services.md#interface-validatedmerklepathresult)
|
|
14430
|
+
See also: [Chain](./client.md#type-chain), [GetMerklePathResult](./client.md#interface-getmerklepathresult), [MerkleRootValidator](./services.md#interface-merklerootvalidator), [ValidatedMerklePathResult](./services.md#interface-validatedmerklepathresult)
|
|
14413
14431
|
|
|
14414
14432
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
14415
14433
|
|
|
@@ -14744,9 +14762,11 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
14744
14762
|
Computes "chainWork" value for 4 byte Bitcoin block header "bits" value.
|
|
14745
14763
|
|
|
14746
14764
|
```ts
|
|
14747
|
-
export function convertBitsToWork(bits: number | number[]): string
|
|
14765
|
+
export function convertBitsToWork(bits: number | number[], chain?: Chain): string
|
|
14748
14766
|
```
|
|
14749
14767
|
|
|
14768
|
+
See also: [Chain](./client.md#type-chain)
|
|
14769
|
+
|
|
14750
14770
|
Returns
|
|
14751
14771
|
|
|
14752
14772
|
32 byte Buffer with "chainWork" value
|
|
@@ -14755,6 +14775,9 @@ Argument Details
|
|
|
14755
14775
|
|
|
14756
14776
|
+ **bits**
|
|
14757
14777
|
+ number or converted from Buffer using `readUint32LE`
|
|
14778
|
+
+ **chain**
|
|
14779
|
+
+ Optional chain the header belongs to. Selects its proof-of-work limit
|
|
14780
|
+
(see `proofOfWorkLimitBits`); omitted means the mainnet limit.
|
|
14758
14781
|
|
|
14759
14782
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
14760
14783
|
|
|
@@ -14866,10 +14889,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
14866
14889
|
##### Function: copyValidatedBlockHeader
|
|
14867
14890
|
|
|
14868
14891
|
```ts
|
|
14869
|
-
export function copyValidatedBlockHeader(value: unknown, requireProofOfWork = false, requireHeaderFormat = true): BlockHeader
|
|
14892
|
+
export function copyValidatedBlockHeader(value: unknown, requireProofOfWork = false, requireHeaderFormat = true, chain?: Chain): BlockHeader
|
|
14870
14893
|
```
|
|
14871
14894
|
|
|
14872
|
-
See also: [BlockHeader](./client.md#interface-blockheader)
|
|
14895
|
+
See also: [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain)
|
|
14873
14896
|
|
|
14874
14897
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
14875
14898
|
|
|
@@ -14877,10 +14900,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
14877
14900
|
##### Function: copyValidatedMonitorHeader
|
|
14878
14901
|
|
|
14879
14902
|
```ts
|
|
14880
|
-
export function copyValidatedMonitorHeader(value: unknown, name = "header", requireProofOfWork = true): BlockHeader
|
|
14903
|
+
export function copyValidatedMonitorHeader(value: unknown, name = "header", requireProofOfWork = true, chain?: Chain): BlockHeader
|
|
14881
14904
|
```
|
|
14882
14905
|
|
|
14883
|
-
See also: [BlockHeader](./client.md#interface-blockheader)
|
|
14906
|
+
See also: [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain)
|
|
14884
14907
|
|
|
14885
14908
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
14886
14909
|
|
|
@@ -15331,6 +15354,17 @@ export function genesisHeader(chain: Chain): BlockHeader {
|
|
|
15331
15354
|
height: 0,
|
|
15332
15355
|
hash: "000000005d221c0e023cb56b5682cf094f32cd959958b40bc931e5797cae706c"
|
|
15333
15356
|
};
|
|
15357
|
+
case "regtest":
|
|
15358
|
+
return {
|
|
15359
|
+
version: 1,
|
|
15360
|
+
previousHash: "0000000000000000000000000000000000000000000000000000000000000000",
|
|
15361
|
+
merkleRoot: "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
|
|
15362
|
+
time: 1296688602,
|
|
15363
|
+
bits: 545259519,
|
|
15364
|
+
nonce: 2,
|
|
15365
|
+
height: 0,
|
|
15366
|
+
hash: "0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206"
|
|
15367
|
+
};
|
|
15334
15368
|
case "mock":
|
|
15335
15369
|
throw new Error("genesisHeader does not support 'mock' chain. Mock chain generates its own genesis block.");
|
|
15336
15370
|
}
|
|
@@ -16601,6 +16635,23 @@ See also: [NoSendExpiryLifecycleResult](./storage.md#interface-nosendexpirylifec
|
|
|
16601
16635
|
|
|
16602
16636
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
16603
16637
|
|
|
16638
|
+
---
|
|
16639
|
+
##### Function: proofOfWorkLimitBits
|
|
16640
|
+
|
|
16641
|
+
The compact encoding of the highest proof-of-work target `chain` admits.
|
|
16642
|
+
|
|
16643
|
+
Only `'regtest'` raises the limit. Every other chain — and an omitted chain,
|
|
16644
|
+
which is how every caller that predates this parameter asks — keeps the mainnet
|
|
16645
|
+
limit, so no existing validation is relaxed.
|
|
16646
|
+
|
|
16647
|
+
```ts
|
|
16648
|
+
export function proofOfWorkLimitBits(chain?: Chain): number
|
|
16649
|
+
```
|
|
16650
|
+
|
|
16651
|
+
See also: [Chain](./client.md#type-chain)
|
|
16652
|
+
|
|
16653
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
16654
|
+
|
|
16604
16655
|
---
|
|
16605
16656
|
##### Function: proveCertificate
|
|
16606
16657
|
|
|
@@ -16785,6 +16836,29 @@ See also: [TableCommission](./storage.md#interface-tablecommission)
|
|
|
16785
16836
|
|
|
16786
16837
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
16787
16838
|
|
|
16839
|
+
---
|
|
16840
|
+
##### Function: regtestArcadeUrl
|
|
16841
|
+
|
|
16842
|
+
Arcade broadcaster / ARC endpoint for regtest, or `undefined` when `REGTEST_ARCADE_URL` is unset.
|
|
16843
|
+
|
|
16844
|
+
```ts
|
|
16845
|
+
export function regtestArcadeUrl(): string | undefined
|
|
16846
|
+
```
|
|
16847
|
+
|
|
16848
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
16849
|
+
|
|
16850
|
+
---
|
|
16851
|
+
##### Function: regtestChaintracksUrl
|
|
16852
|
+
|
|
16853
|
+
ChainTracks service URL for regtest. Falls back to `${REGTEST_ARCADE_URL}/chaintracks/v1` when
|
|
16854
|
+
`REGTEST_CHAINTRACKS_URL` is unset (mirrors the tstn layout). Throws when neither is configured.
|
|
16855
|
+
|
|
16856
|
+
```ts
|
|
16857
|
+
export function regtestChaintracksUrl(): string
|
|
16858
|
+
```
|
|
16859
|
+
|
|
16860
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
16861
|
+
|
|
16788
16862
|
---
|
|
16789
16863
|
##### Function: renewActionBatch
|
|
16790
16864
|
|
|
@@ -17528,12 +17602,14 @@ Validate headers contained in an array of bytes. The headers must be consecutive
|
|
|
17528
17602
|
where the hash of each header equals the previousHash of the following header.
|
|
17529
17603
|
|
|
17530
17604
|
```ts
|
|
17531
|
-
export function validateBufferOfHeaders(buffer: Uint8Array, previousHash: string, offset = 0, count = -1, previousChainWork?: string): {
|
|
17605
|
+
export function validateBufferOfHeaders(buffer: Uint8Array, previousHash: string, offset = 0, count = -1, previousChainWork?: string, chain?: Chain): {
|
|
17532
17606
|
lastHeaderHash: string;
|
|
17533
17607
|
lastChainWork: string | undefined;
|
|
17534
17608
|
}
|
|
17535
17609
|
```
|
|
17536
17610
|
|
|
17611
|
+
See also: [Chain](./client.md#type-chain)
|
|
17612
|
+
|
|
17537
17613
|
Returns
|
|
17538
17614
|
|
|
17539
17615
|
Header hash of last header validated or previousHash if there where none.
|
|
@@ -17548,6 +17624,11 @@ Argument Details
|
|
|
17548
17624
|
+ Optional starting offset within `buffer`.
|
|
17549
17625
|
+ **count**
|
|
17550
17626
|
+ Optional number of headers to validate. Validates to end of buffer if missing.
|
|
17627
|
+
+ **previousChainWork**
|
|
17628
|
+
+ Optional chain work through `previousHash`; when present, the result carries it forward.
|
|
17629
|
+
+ **chain**
|
|
17630
|
+
+ Optional chain the headers belong to. Selects its proof-of-work limit
|
|
17631
|
+
(see `proofOfWorkLimitBits`); omitted means the mainnet limit.
|
|
17551
17632
|
|
|
17552
17633
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
17553
17634
|
|
|
@@ -17634,17 +17715,24 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
17634
17715
|
Ensures that a header has a valid proof-of-work target and hash.
|
|
17635
17716
|
|
|
17636
17717
|
```ts
|
|
17637
|
-
export function validateHeaderDifficulty(hash: number[] | Uint8Array, bits: number)
|
|
17718
|
+
export function validateHeaderDifficulty(hash: number[] | Uint8Array, bits: number, chain?: Chain)
|
|
17638
17719
|
```
|
|
17639
17720
|
|
|
17721
|
+
See also: [Chain](./client.md#type-chain)
|
|
17722
|
+
|
|
17640
17723
|
Returns
|
|
17641
17724
|
|
|
17642
17725
|
true if the header is valid
|
|
17643
17726
|
|
|
17644
17727
|
Argument Details
|
|
17645
17728
|
|
|
17646
|
-
+ **
|
|
17647
|
-
+ The header
|
|
17729
|
+
+ **hash**
|
|
17730
|
+
+ The header hash, big-endian.
|
|
17731
|
+
+ **bits**
|
|
17732
|
+
+ The header's compact target.
|
|
17733
|
+
+ **chain**
|
|
17734
|
+
+ Optional chain the header belongs to. Selects its proof-of-work limit
|
|
17735
|
+
(see `proofOfWorkLimitBits`); omitted means the mainnet limit.
|
|
17648
17736
|
|
|
17649
17737
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
17650
17738
|
|
|
@@ -17666,13 +17754,13 @@ Ensures that a structured header's computed hash satisfies its declared
|
|
|
17666
17754
|
proof-of-work target.
|
|
17667
17755
|
|
|
17668
17756
|
```ts
|
|
17669
|
-
export function validateHeaderProofOfWork(header: BlockHeader): true {
|
|
17670
|
-
validateConsensusProofOfWork(header.hash, header.bits);
|
|
17757
|
+
export function validateHeaderProofOfWork(header: BlockHeader, chain?: Chain): true {
|
|
17758
|
+
validateConsensusProofOfWork(header.hash, header.bits, chain);
|
|
17671
17759
|
return true;
|
|
17672
17760
|
}
|
|
17673
17761
|
```
|
|
17674
17762
|
|
|
17675
|
-
See also: [BlockHeader](./client.md#interface-blockheader)
|
|
17763
|
+
See also: [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain)
|
|
17676
17764
|
|
|
17677
17765
|
Returns
|
|
17678
17766
|
|
|
@@ -17682,6 +17770,9 @@ Argument Details
|
|
|
17682
17770
|
|
|
17683
17771
|
+ **header**
|
|
17684
17772
|
+ Header whose format and hash have already been checked.
|
|
17773
|
+
+ **chain**
|
|
17774
|
+
+ Optional chain the header belongs to. Selects its proof-of-work limit
|
|
17775
|
+
(see `proofOfWorkLimitBits`); omitted means the mainnet limit.
|
|
17685
17776
|
|
|
17686
17777
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
17687
17778
|
|
|
@@ -17715,10 +17806,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
17715
17806
|
##### Function: validateMerklePathResult
|
|
17716
17807
|
|
|
17717
17808
|
```ts
|
|
17718
|
-
export function validateMerklePathResult(requestedTxid: unknown, result: GetMerklePathResult, requireProofOfWork = false, requireHeaderFormat = true): ValidatedMerklePathResult
|
|
17809
|
+
export function validateMerklePathResult(requestedTxid: unknown, result: GetMerklePathResult, requireProofOfWork = false, requireHeaderFormat = true, chain?: Chain): ValidatedMerklePathResult
|
|
17719
17810
|
```
|
|
17720
17811
|
|
|
17721
|
-
See also: [GetMerklePathResult](./client.md#interface-getmerklepathresult), [ValidatedMerklePathResult](./services.md#interface-validatedmerklepathresult)
|
|
17812
|
+
See also: [Chain](./client.md#type-chain), [GetMerklePathResult](./client.md#interface-getmerklepathresult), [ValidatedMerklePathResult](./services.md#interface-validatedmerklepathresult)
|
|
17722
17813
|
|
|
17723
17814
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
17724
17815
|
|
|
@@ -18472,7 +18563,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
18472
18563
|
##### Type: Chain
|
|
18473
18564
|
|
|
18474
18565
|
```ts
|
|
18475
|
-
export type Chain = "main" | "test" | "stn" | "ttn" | "tstn" | "mock"
|
|
18566
|
+
export type Chain = "main" | "test" | "stn" | "ttn" | "tstn" | "regtest" | "mock"
|
|
18476
18567
|
```
|
|
18477
18568
|
|
|
18478
18569
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|