@bsv/wallet-toolbox 2.1.0-beta.3 → 2.1.2

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.
Files changed (78) hide show
  1. package/CHANGELOG.md +31 -1
  2. package/docs/client.md +581 -199
  3. package/docs/monitor.md +30 -11
  4. package/docs/services.md +78 -27
  5. package/docs/storage.md +18 -82
  6. package/docs/wallet.md +581 -199
  7. package/out/src/Setup.js +1 -4
  8. package/out/src/Setup.js.map +1 -1
  9. package/out/src/WalletPermissionsManager.d.ts +4 -2
  10. package/out/src/WalletPermissionsManager.d.ts.map +1 -1
  11. package/out/src/WalletPermissionsManager.js +127 -35
  12. package/out/src/WalletPermissionsManager.js.map +1 -1
  13. package/out/src/__tests/WalletPermissionsManager.flows.test.js +113 -1
  14. package/out/src/__tests/WalletPermissionsManager.flows.test.js.map +1 -1
  15. package/out/src/mockchain/MockChainMigrations.js +1 -1
  16. package/out/src/mockchain/MockChainMigrations.js.map +1 -1
  17. package/out/src/sdk/WalletStorage.interfaces.d.ts +2 -0
  18. package/out/src/sdk/WalletStorage.interfaces.d.ts.map +1 -1
  19. package/out/src/services/Services.d.ts +15 -0
  20. package/out/src/services/Services.d.ts.map +1 -1
  21. package/out/src/services/Services.js +59 -4
  22. package/out/src/services/Services.js.map +1 -1
  23. package/out/src/services/chaintracker/chaintracks/Chaintracks.d.ts.map +1 -1
  24. package/out/src/services/chaintracker/chaintracks/Chaintracks.js +20 -4
  25. package/out/src/services/chaintracker/chaintracks/Chaintracks.js.map +1 -1
  26. package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksKnexMigrations.js +1 -1
  27. package/out/src/services/chaintracker/chaintracks/Storage/ChaintracksKnexMigrations.js.map +1 -1
  28. package/out/src/services/chaintracker/chaintracks/__tests/bulkIngestorFailures.test.d.ts +2 -0
  29. package/out/src/services/chaintracker/chaintracks/__tests/bulkIngestorFailures.test.d.ts.map +1 -0
  30. package/out/src/services/chaintracker/chaintracks/__tests/bulkIngestorFailures.test.js +109 -0
  31. package/out/src/services/chaintracker/chaintracks/__tests/bulkIngestorFailures.test.js.map +1 -0
  32. package/out/src/storage/StorageIdb.d.ts.map +1 -1
  33. package/out/src/storage/StorageIdb.js +4 -0
  34. package/out/src/storage/StorageIdb.js.map +1 -1
  35. package/out/src/storage/StorageKnex.d.ts +8 -0
  36. package/out/src/storage/StorageKnex.d.ts.map +1 -1
  37. package/out/src/storage/StorageKnex.js +125 -71
  38. package/out/src/storage/StorageKnex.js.map +1 -1
  39. package/out/src/storage/StorageProvider.d.ts +8 -0
  40. package/out/src/storage/StorageProvider.d.ts.map +1 -1
  41. package/out/src/storage/StorageProvider.js +42 -0
  42. package/out/src/storage/StorageProvider.js.map +1 -1
  43. package/out/src/storage/methods/ListOutputsSpecOp.d.ts.map +1 -1
  44. package/out/src/storage/methods/ListOutputsSpecOp.js +24 -7
  45. package/out/src/storage/methods/ListOutputsSpecOp.js.map +1 -1
  46. package/out/src/storage/methods/createAction.d.ts.map +1 -1
  47. package/out/src/storage/methods/createAction.js +69 -32
  48. package/out/src/storage/methods/createAction.js.map +1 -1
  49. package/out/src/storage/methods/listActionsIdb.d.ts.map +1 -1
  50. package/out/src/storage/methods/listActionsIdb.js +17 -3
  51. package/out/src/storage/methods/listActionsIdb.js.map +1 -1
  52. package/out/src/storage/methods/listActionsKnex.d.ts.map +1 -1
  53. package/out/src/storage/methods/listActionsKnex.js +28 -2
  54. package/out/src/storage/methods/listActionsKnex.js.map +1 -1
  55. package/out/src/storage/methods/listOutputsKnex.d.ts.map +1 -1
  56. package/out/src/storage/methods/listOutputsKnex.js +83 -50
  57. package/out/src/storage/methods/listOutputsKnex.js.map +1 -1
  58. package/out/src/storage/remoting/StorageServer.d.ts +1 -0
  59. package/out/src/storage/remoting/StorageServer.d.ts.map +1 -1
  60. package/out/src/storage/remoting/StorageServer.js +58 -8
  61. package/out/src/storage/remoting/StorageServer.js.map +1 -1
  62. package/out/src/storage/remoting/__test/StorageClient.man.test.js +361 -96
  63. package/out/src/storage/remoting/__test/StorageClient.man.test.js.map +1 -1
  64. package/out/src/storage/schema/KnexMigrations.d.ts.map +1 -1
  65. package/out/src/storage/schema/KnexMigrations.js +41 -1
  66. package/out/src/storage/schema/KnexMigrations.js.map +1 -1
  67. package/out/src/storage/sync/StorageMySQLDojoReader.d.ts.map +1 -1
  68. package/out/src/storage/sync/StorageMySQLDojoReader.js +4 -0
  69. package/out/src/storage/sync/StorageMySQLDojoReader.js.map +1 -1
  70. package/out/src/utility/brc114ActionTimeLabels.d.ts +9 -0
  71. package/out/src/utility/brc114ActionTimeLabels.d.ts.map +1 -0
  72. package/out/src/utility/brc114ActionTimeLabels.js +51 -0
  73. package/out/src/utility/brc114ActionTimeLabels.js.map +1 -0
  74. package/package.json +3 -3
  75. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.d.ts +0 -2
  76. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.d.ts.map +0 -1
  77. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.js +0 -102
  78. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.js.map +0 -1
package/docs/client.md CHANGED
@@ -6,80 +6,82 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
6
6
 
7
7
  | | | |
8
8
  | --- | --- | --- |
9
- | [AdminStatsResult](#interface-adminstatsresult) | [GenerateChangeSdkChangeOutput](#interface-generatechangesdkchangeoutput) | [StatusForTxidResult](#interface-statusfortxidresult) |
10
- | [ArcConfig](#interface-arcconfig) | [GenerateChangeSdkInput](#interface-generatechangesdkinput) | [StorageAdminStats](#interface-storageadminstats) |
11
- | [ArcMinerGetTxData](#interface-arcminergettxdata) | [GenerateChangeSdkOutput](#interface-generatechangesdkoutput) | [StorageCreateActionResult](#interface-storagecreateactionresult) |
12
- | [AuthId](#interface-authid) | [GenerateChangeSdkParams](#interface-generatechangesdkparams) | [StorageCreateTransactionSdkInput](#interface-storagecreatetransactionsdkinput) |
13
- | [AuthPayload](#interface-authpayload) | [GenerateChangeSdkResult](#interface-generatechangesdkresult) | [StorageCreateTransactionSdkOutput](#interface-storagecreatetransactionsdkoutput) |
14
- | [BaseBlockHeader](#interface-baseblockheader) | [GenerateChangeSdkStorageChange](#interface-generatechangesdkstoragechange) | [StorageFeeModel](#interface-storagefeemodel) |
15
- | [BitailsConfig](#interface-bitailsconfig) | [GetHeaderByteFileLinksResult](#interface-getheaderbytefilelinksresult) | [StorageGetBeefOptions](#interface-storagegetbeefoptions) |
16
- | [BitailsMerkleProof](#interface-bitailsmerkleproof) | [GetMerklePathResult](#interface-getmerklepathresult) | [StorageIdbOptions](#interface-storageidboptions) |
17
- | [BlockHeader](#interface-blockheader) | [GetRawTxResult](#interface-getrawtxresult) | [StorageIdbSchema](#interface-storageidbschema) |
18
- | [BsvExchangeRate](#interface-bsvexchangerate) | [GetReqsAndBeefDetail](#interface-getreqsandbeefdetail) | [StorageIdentity](#interface-storageidentity) |
19
- | [BulkFileDataManagerMergeResult](#interface-bulkfiledatamanagermergeresult) | [GetReqsAndBeefResult](#interface-getreqsandbeefresult) | [StorageInternalizeActionResult](#interface-storageinternalizeactionresult) |
20
- | [BulkFileDataManagerOptions](#interface-bulkfiledatamanageroptions) | [GetScriptHashHistory](#interface-getscripthashhistory) | [StorageProcessActionArgs](#interface-storageprocessactionargs) |
21
- | [BulkHeaderFileInfo](#interface-bulkheaderfileinfo) | [GetScriptHashHistoryResult](#interface-getscripthashhistoryresult) | [StorageProcessActionResults](#interface-storageprocessactionresults) |
22
- | [BulkHeaderFilesInfo](#interface-bulkheaderfilesinfo) | [GetStatusForTxidsResult](#interface-getstatusfortxidsresult) | [StorageProvenOrReq](#interface-storageprovenorreq) |
23
- | [BulkIngestorApi](#interface-bulkingestorapi) | [GetUtxoStatusDetails](#interface-getutxostatusdetails) | [StorageProviderOptions](#interface-storageprovideroptions) |
24
- | [BulkIngestorBaseOptions](#interface-bulkingestorbaseoptions) | [GetUtxoStatusResult](#interface-getutxostatusresult) | [StorageReaderOptions](#interface-storagereaderoptions) |
25
- | [BulkIngestorCDNOptions](#interface-bulkingestorcdnoptions) | [GroupedPermissionRequest](#interface-groupedpermissionrequest) | [StorageReaderWriterOptions](#interface-storagereaderwriteroptions) |
26
- | [BulkIngestorWhatsOnChainOptions](#interface-bulkingestorwhatsonchainoptions) | [GroupedPermissions](#interface-groupedpermissions) | [StorageSyncReaderOptions](#interface-storagesyncreaderoptions) |
27
- | [BulkStorageApi](#interface-bulkstorageapi) | [HeightRangeApi](#interface-heightrangeapi) | [SyncChunk](#interface-syncchunk) |
28
- | [BulkStorageBaseOptions](#interface-bulkstoragebaseoptions) | [HeightRanges](#interface-heightranges) | [SyncError](#interface-syncerror) |
29
- | [BulkSyncResult](#interface-bulksyncresult) | [KeyPair](#interface-keypair) | [SyncMap](#interface-syncmap) |
30
- | [CertOpsWallet](#interface-certopswallet) | [KeyPairAddress](#interface-keypairaddress) | [TableCertificate](#interface-tablecertificate) |
31
- | [Certifier](#interface-certifier) | [ListActionsSpecOp](#interface-listactionsspecop) | [TableCertificateField](#interface-tablecertificatefield) |
32
- | [ChaintracksApi](#interface-chaintracksapi) | [ListOutputsSpecOp](#interface-listoutputsspecop) | [TableCertificateX](#interface-tablecertificatex) |
33
- | [ChaintracksAppendableFileApi](#interface-chaintracksappendablefileapi) | [LiveBlockHeader](#interface-liveblockheader) | [TableCommission](#interface-tablecommission) |
34
- | [ChaintracksChainTrackerOptions](#interface-chaintrackschaintrackeroptions) | [LiveIngestorApi](#interface-liveingestorapi) | [TableMonitorEvent](#interface-tablemonitorevent) |
35
- | [ChaintracksClientApi](#interface-chaintracksclientapi) | [LiveIngestorBaseOptions](#interface-liveingestorbaseoptions) | [TableOutput](#interface-tableoutput) |
36
- | [ChaintracksFetchApi](#interface-chaintracksfetchapi) | [LiveIngestorWhatsOnChainOptions](#interface-liveingestorwhatsonchainoptions) | [TableOutputBasket](#interface-tableoutputbasket) |
37
- | [ChaintracksFsApi](#interface-chaintracksfsapi) | [MonitorOptions](#interface-monitoroptions) | [TableOutputTag](#interface-tableoutputtag) |
38
- | [ChaintracksInfoApi](#interface-chaintracksinfoapi) | [OutPoint](#interface-outpoint) | [TableOutputTagMap](#interface-tableoutputtagmap) |
39
- | [ChaintracksManagementApi](#interface-chaintracksmanagementapi) | [Paged](#interface-paged) | [TableOutputX](#interface-tableoutputx) |
40
- | [ChaintracksOptions](#interface-chaintracksoptions) | [PendingSignAction](#interface-pendingsignaction) | [TableProvenTx](#interface-tableproventx) |
41
- | [ChaintracksPackageInfoApi](#interface-chaintrackspackageinfoapi) | [PendingStorageInput](#interface-pendingstorageinput) | [TableProvenTxReq](#interface-tableproventxreq) |
42
- | [ChaintracksReadableFileApi](#interface-chaintracksreadablefileapi) | [PermissionRequest](#interface-permissionrequest) | [TableProvenTxReqDynamics](#interface-tableproventxreqdynamics) |
43
- | [ChaintracksServiceClientOptions](#interface-chaintracksserviceclientoptions) | [PermissionToken](#interface-permissiontoken) | [TableSettings](#interface-tablesettings) |
44
- | [ChaintracksStorageApi](#interface-chaintracksstorageapi) | [PermissionsManagerConfig](#interface-permissionsmanagerconfig) | [TableSyncState](#interface-tablesyncstate) |
45
- | [ChaintracksStorageBaseOptions](#interface-chaintracksstoragebaseoptions) | [PermissionsModule](#interface-permissionsmodule) | [TableTransaction](#interface-tabletransaction) |
46
- | [ChaintracksStorageBulkFileApi](#interface-chaintracksstoragebulkfileapi) | [PostBeefResult](#interface-postbeefresult) | [TableTxLabel](#interface-tabletxlabel) |
47
- | [ChaintracksStorageIdbOptions](#interface-chaintracksstorageidboptions) | [PostBeefResultForTxidApi](#interface-postbeefresultfortxidapi) | [TableTxLabelMap](#interface-tabletxlabelmap) |
48
- | [ChaintracksStorageIdbSchema](#interface-chaintracksstorageidbschema) | [PostReqsToNetworkDetails](#interface-postreqstonetworkdetails) | [TableUser](#interface-tableuser) |
49
- | [ChaintracksStorageIngestApi](#interface-chaintracksstorageingestapi) | [PostReqsToNetworkResult](#interface-postreqstonetworkresult) | [TaskPurgeParams](#interface-taskpurgeparams) |
50
- | [ChaintracksStorageNoDbOptions](#interface-chaintracksstoragenodboptions) | [PostTxResultForTxid](#interface-posttxresultfortxid) | [TrustSettings](#interface-trustsettings) |
51
- | [ChaintracksStorageQueryApi](#interface-chaintracksstoragequeryapi) | [PostTxResultForTxidError](#interface-posttxresultfortxiderror) | [TrxToken](#interface-trxtoken) |
52
- | [ChaintracksWritableFileApi](#interface-chaintrackswritablefileapi) | [PostTxsResult](#interface-posttxsresult) | [TscMerkleProofApi](#interface-tscmerkleproofapi) |
53
- | [CommitNewTxResults](#interface-commitnewtxresults) | [ProcessSyncChunkResult](#interface-processsyncchunkresult) | [TxScriptOffsets](#interface-txscriptoffsets) |
54
- | [CompleteAuthResponse](#interface-completeauthresponse) | [Profile](#interface-profile) | [UMPToken](#interface-umptoken) |
55
- | [CounterpartyPermissionRequest](#interface-counterpartypermissionrequest) | [ProvenOrRawTx](#interface-provenorrawtx) | [UMPTokenInteractor](#interface-umptokeninteractor) |
56
- | [CounterpartyPermissions](#interface-counterpartypermissions) | [ProvenTransactionStatus](#interface-proventransactionstatus) | [UpdateProvenTxReqWithNewProvenTxArgs](#interface-updateproventxreqwithnewproventxargs) |
57
- | [CreateActionResultX](#interface-createactionresultx) | [ProvenTxFromTxidResult](#interface-proventxfromtxidresult) | [UpdateProvenTxReqWithNewProvenTxResult](#interface-updateproventxreqwithnewproventxresult) |
58
- | [DeactivedHeader](#interface-deactivedheader) | [ProvenTxReqHistory](#interface-proventxreqhistory) | [ValidateGenerateChangeSdkParamsResult](#interface-validategeneratechangesdkparamsresult) |
59
- | [EntitySyncMap](#interface-entitysyncmap) | [ProvenTxReqHistorySummaryApi](#interface-proventxreqhistorysummaryapi) | [VerifyAndRepairBeefResult](#interface-verifyandrepairbeefresult) |
60
- | [EntityTimeStamp](#interface-entitytimestamp) | [ProvenTxReqNotify](#interface-proventxreqnotify) | [WalletArgs](#interface-walletargs) |
61
- | [ExchangeRatesIoApi](#interface-exchangeratesioapi) | [ProviderCallHistory](#interface-providercallhistory) | [WalletBalance](#interface-walletbalance) |
62
- | [ExtendedVerifiableCertificate](#interface-extendedverifiablecertificate) | [PurgeParams](#interface-purgeparams) | [WalletLoggerArgs](#interface-walletloggerargs) |
63
- | [FiatExchangeRates](#interface-fiatexchangerates) | [PurgeResults](#interface-purgeresults) | [WalletPermissionsManagerCallbacks](#interface-walletpermissionsmanagercallbacks) |
64
- | [FindCertificateFieldsArgs](#interface-findcertificatefieldsargs) | [ReproveHeaderResult](#interface-reproveheaderresult) | [WalletServices](#interface-walletservices) |
65
- | [FindCertificatesArgs](#interface-findcertificatesargs) | [ReproveProvenResult](#interface-reproveprovenresult) | [WalletServicesOptions](#interface-walletservicesoptions) |
66
- | [FindCommissionsArgs](#interface-findcommissionsargs) | [RequestSyncChunkArgs](#interface-requestsyncchunkargs) | [WalletSettings](#interface-walletsettings) |
67
- | [FindForUserSincePagedArgs](#interface-findforusersincepagedargs) | [ReviewActionResult](#interface-reviewactionresult) | [WalletSettingsManagerConfig](#interface-walletsettingsmanagerconfig) |
68
- | [FindMonitorEventsArgs](#interface-findmonitoreventsargs) | [ScriptTemplateParamsBRC29](#interface-scripttemplateparamsbrc29) | [WalletSigner](#interface-walletsigner) |
69
- | [FindOutputBasketsArgs](#interface-findoutputbasketsargs) | [ScriptTemplateUnlock](#interface-scripttemplateunlock) | [WalletStorage](#interface-walletstorage) |
70
- | [FindOutputTagMapsArgs](#interface-findoutputtagmapsargs) | [ServiceCall](#interface-servicecall) | [WalletStorageInfo](#interface-walletstorageinfo) |
71
- | [FindOutputTagsArgs](#interface-findoutputtagsargs) | [ServiceCall](#interface-servicecall) | [WalletStorageProvider](#interface-walletstorageprovider) |
72
- | [FindOutputsArgs](#interface-findoutputsargs) | [ServiceCallHistory](#interface-servicecallhistory) | [WalletStorageReader](#interface-walletstoragereader) |
73
- | [FindPartialSincePagedArgs](#interface-findpartialsincepagedargs) | [ServiceCallHistoryCounts](#interface-servicecallhistorycounts) | [WalletStorageSync](#interface-walletstoragesync) |
74
- | [FindProvenTxReqsArgs](#interface-findproventxreqsargs) | [ServiceToCall](#interface-servicetocall) | [WalletStorageSyncReader](#interface-walletstoragesyncreader) |
75
- | [FindProvenTxsArgs](#interface-findproventxsargs) | [SetupClientWalletArgs](#interface-setupclientwalletargs) | [WalletStorageWriter](#interface-walletstoragewriter) |
76
- | [FindSincePagedArgs](#interface-findsincepagedargs) | [SetupClientWalletClientArgs](#interface-setupclientwalletclientargs) | [WalletTheme](#interface-wallettheme) |
77
- | [FindSyncStatesArgs](#interface-findsyncstatesargs) | [SetupWallet](#interface-setupwallet) | [WhatsOnChainServicesOptions](#interface-whatsonchainservicesoptions) |
78
- | [FindTransactionsArgs](#interface-findtransactionsargs) | [SetupWalletClient](#interface-setupwalletclient) | [WocChainInfo](#interface-wocchaininfo) |
79
- | [FindTxLabelMapsArgs](#interface-findtxlabelmapsargs) | [SetupWalletIdb](#interface-setupwalletidb) | [WocGetHeaderByteFileLinks](#interface-wocgetheaderbytefilelinks) |
80
- | [FindTxLabelsArgs](#interface-findtxlabelsargs) | [SetupWalletIdbArgs](#interface-setupwalletidbargs) | [WocGetHeadersHeader](#interface-wocgetheadersheader) |
81
- | [FindUsersArgs](#interface-findusersargs) | [SignActionResultX](#interface-signactionresultx) | [WocHeader](#interface-wocheader) |
82
- | [GenerateChangeSdkChangeInput](#interface-generatechangesdkchangeinput) | [StartAuthResponse](#interface-startauthresponse) | [XValidCreateActionOutput](#interface-xvalidcreateactionoutput) |
9
+ | [AdminStatsResult](#interface-adminstatsresult) | [GenerateChangeSdkOutput](#interface-generatechangesdkoutput) | [StatusForTxidResult](#interface-statusfortxidresult) |
10
+ | [ArcConfig](#interface-arcconfig) | [GenerateChangeSdkParams](#interface-generatechangesdkparams) | [StorageAdminStats](#interface-storageadminstats) |
11
+ | [ArcMinerGetTxData](#interface-arcminergettxdata) | [GenerateChangeSdkResult](#interface-generatechangesdkresult) | [StorageCreateActionResult](#interface-storagecreateactionresult) |
12
+ | [AuthId](#interface-authid) | [GenerateChangeSdkStorageChange](#interface-generatechangesdkstoragechange) | [StorageCreateTransactionSdkInput](#interface-storagecreatetransactionsdkinput) |
13
+ | [AuthPayload](#interface-authpayload) | [GetHeaderByteFileLinksResult](#interface-getheaderbytefilelinksresult) | [StorageCreateTransactionSdkOutput](#interface-storagecreatetransactionsdkoutput) |
14
+ | [BaseBlockHeader](#interface-baseblockheader) | [GetMerklePathResult](#interface-getmerklepathresult) | [StorageFeeModel](#interface-storagefeemodel) |
15
+ | [BitailsConfig](#interface-bitailsconfig) | [GetRawTxResult](#interface-getrawtxresult) | [StorageGetBeefOptions](#interface-storagegetbeefoptions) |
16
+ | [BitailsMerkleProof](#interface-bitailsmerkleproof) | [GetReqsAndBeefDetail](#interface-getreqsandbeefdetail) | [StorageIdbOptions](#interface-storageidboptions) |
17
+ | [BlockHeader](#interface-blockheader) | [GetReqsAndBeefResult](#interface-getreqsandbeefresult) | [StorageIdbSchema](#interface-storageidbschema) |
18
+ | [BsvExchangeRate](#interface-bsvexchangerate) | [GetScriptHashHistory](#interface-getscripthashhistory) | [StorageIdentity](#interface-storageidentity) |
19
+ | [BulkFileDataManagerMergeResult](#interface-bulkfiledatamanagermergeresult) | [GetScriptHashHistoryResult](#interface-getscripthashhistoryresult) | [StorageInternalizeActionResult](#interface-storageinternalizeactionresult) |
20
+ | [BulkFileDataManagerOptions](#interface-bulkfiledatamanageroptions) | [GetStatusForTxidsResult](#interface-getstatusfortxidsresult) | [StorageProcessActionArgs](#interface-storageprocessactionargs) |
21
+ | [BulkHeaderFileInfo](#interface-bulkheaderfileinfo) | [GetUtxoStatusDetails](#interface-getutxostatusdetails) | [StorageProcessActionResults](#interface-storageprocessactionresults) |
22
+ | [BulkHeaderFilesInfo](#interface-bulkheaderfilesinfo) | [GetUtxoStatusResult](#interface-getutxostatusresult) | [StorageProvenOrReq](#interface-storageprovenorreq) |
23
+ | [BulkIngestorApi](#interface-bulkingestorapi) | [GroupedPermissionRequest](#interface-groupedpermissionrequest) | [StorageProviderOptions](#interface-storageprovideroptions) |
24
+ | [BulkIngestorBaseOptions](#interface-bulkingestorbaseoptions) | [GroupedPermissions](#interface-groupedpermissions) | [StorageReaderOptions](#interface-storagereaderoptions) |
25
+ | [BulkIngestorCDNOptions](#interface-bulkingestorcdnoptions) | [HeightRangeApi](#interface-heightrangeapi) | [StorageReaderWriterOptions](#interface-storagereaderwriteroptions) |
26
+ | [BulkIngestorWhatsOnChainOptions](#interface-bulkingestorwhatsonchainoptions) | [HeightRanges](#interface-heightranges) | [StorageSyncReaderOptions](#interface-storagesyncreaderoptions) |
27
+ | [BulkStorageApi](#interface-bulkstorageapi) | [KeyPair](#interface-keypair) | [SyncChunk](#interface-syncchunk) |
28
+ | [BulkStorageBaseOptions](#interface-bulkstoragebaseoptions) | [KeyPairAddress](#interface-keypairaddress) | [SyncError](#interface-syncerror) |
29
+ | [BulkSyncResult](#interface-bulksyncresult) | [ListActionsSpecOp](#interface-listactionsspecop) | [SyncMap](#interface-syncmap) |
30
+ | [CertOpsWallet](#interface-certopswallet) | [ListOutputsSpecOp](#interface-listoutputsspecop) | [TableCertificate](#interface-tablecertificate) |
31
+ | [Certifier](#interface-certifier) | [LiveBlockHeader](#interface-liveblockheader) | [TableCertificateField](#interface-tablecertificatefield) |
32
+ | [ChaintracksApi](#interface-chaintracksapi) | [LiveIngestorApi](#interface-liveingestorapi) | [TableCertificateX](#interface-tablecertificatex) |
33
+ | [ChaintracksAppendableFileApi](#interface-chaintracksappendablefileapi) | [LiveIngestorBaseOptions](#interface-liveingestorbaseoptions) | [TableCommission](#interface-tablecommission) |
34
+ | [ChaintracksChainTrackerOptions](#interface-chaintrackschaintrackeroptions) | [LiveIngestorWhatsOnChainOptions](#interface-liveingestorwhatsonchainoptions) | [TableMonitorEvent](#interface-tablemonitorevent) |
35
+ | [ChaintracksClientApi](#interface-chaintracksclientapi) | [MockChainBlockHeaderRow](#interface-mockchainblockheaderrow) | [TableOutput](#interface-tableoutput) |
36
+ | [ChaintracksFetchApi](#interface-chaintracksfetchapi) | [MockChainTransactionRow](#interface-mockchaintransactionrow) | [TableOutputBasket](#interface-tableoutputbasket) |
37
+ | [ChaintracksFsApi](#interface-chaintracksfsapi) | [MockChainUtxoRow](#interface-mockchainutxorow) | [TableOutputTag](#interface-tableoutputtag) |
38
+ | [ChaintracksInfoApi](#interface-chaintracksinfoapi) | [MonitorOptions](#interface-monitoroptions) | [TableOutputTagMap](#interface-tableoutputtagmap) |
39
+ | [ChaintracksManagementApi](#interface-chaintracksmanagementapi) | [OutPoint](#interface-outpoint) | [TableOutputX](#interface-tableoutputx) |
40
+ | [ChaintracksOptions](#interface-chaintracksoptions) | [Paged](#interface-paged) | [TableProvenTx](#interface-tableproventx) |
41
+ | [ChaintracksPackageInfoApi](#interface-chaintrackspackageinfoapi) | [PendingSignAction](#interface-pendingsignaction) | [TableProvenTxReq](#interface-tableproventxreq) |
42
+ | [ChaintracksReadableFileApi](#interface-chaintracksreadablefileapi) | [PendingStorageInput](#interface-pendingstorageinput) | [TableProvenTxReqDynamics](#interface-tableproventxreqdynamics) |
43
+ | [ChaintracksServiceClientOptions](#interface-chaintracksserviceclientoptions) | [PermissionRequest](#interface-permissionrequest) | [TableSettings](#interface-tablesettings) |
44
+ | [ChaintracksStorageApi](#interface-chaintracksstorageapi) | [PermissionToken](#interface-permissiontoken) | [TableSyncState](#interface-tablesyncstate) |
45
+ | [ChaintracksStorageBaseOptions](#interface-chaintracksstoragebaseoptions) | [PermissionsManagerConfig](#interface-permissionsmanagerconfig) | [TableTransaction](#interface-tabletransaction) |
46
+ | [ChaintracksStorageBulkFileApi](#interface-chaintracksstoragebulkfileapi) | [PermissionsModule](#interface-permissionsmodule) | [TableTxLabel](#interface-tabletxlabel) |
47
+ | [ChaintracksStorageIdbOptions](#interface-chaintracksstorageidboptions) | [PostBeefResult](#interface-postbeefresult) | [TableTxLabelMap](#interface-tabletxlabelmap) |
48
+ | [ChaintracksStorageIdbSchema](#interface-chaintracksstorageidbschema) | [PostBeefResultForTxidApi](#interface-postbeefresultfortxidapi) | [TableUser](#interface-tableuser) |
49
+ | [ChaintracksStorageIngestApi](#interface-chaintracksstorageingestapi) | [PostReqsToNetworkDetails](#interface-postreqstonetworkdetails) | [TaskPurgeParams](#interface-taskpurgeparams) |
50
+ | [ChaintracksStorageNoDbOptions](#interface-chaintracksstoragenodboptions) | [PostReqsToNetworkResult](#interface-postreqstonetworkresult) | [TrustSettings](#interface-trustsettings) |
51
+ | [ChaintracksStorageQueryApi](#interface-chaintracksstoragequeryapi) | [PostTxResultForTxid](#interface-posttxresultfortxid) | [TrxToken](#interface-trxtoken) |
52
+ | [ChaintracksWritableFileApi](#interface-chaintrackswritablefileapi) | [PostTxResultForTxidError](#interface-posttxresultfortxiderror) | [TscMerkleProofApi](#interface-tscmerkleproofapi) |
53
+ | [CommitNewTxResults](#interface-commitnewtxresults) | [PostTxsResult](#interface-posttxsresult) | [TxScriptOffsets](#interface-txscriptoffsets) |
54
+ | [CompleteAuthResponse](#interface-completeauthresponse) | [ProcessSyncChunkResult](#interface-processsyncchunkresult) | [UMPToken](#interface-umptoken) |
55
+ | [CounterpartyPermissionRequest](#interface-counterpartypermissionrequest) | [Profile](#interface-profile) | [UMPTokenInteractor](#interface-umptokeninteractor) |
56
+ | [CounterpartyPermissions](#interface-counterpartypermissions) | [ProvenOrRawTx](#interface-provenorrawtx) | [UpdateProvenTxReqWithNewProvenTxArgs](#interface-updateproventxreqwithnewproventxargs) |
57
+ | [CreateActionResultX](#interface-createactionresultx) | [ProvenTransactionStatus](#interface-proventransactionstatus) | [UpdateProvenTxReqWithNewProvenTxResult](#interface-updateproventxreqwithnewproventxresult) |
58
+ | [DeactivedHeader](#interface-deactivedheader) | [ProvenTxFromTxidResult](#interface-proventxfromtxidresult) | [ValidateGenerateChangeSdkParamsResult](#interface-validategeneratechangesdkparamsresult) |
59
+ | [EntitySyncMap](#interface-entitysyncmap) | [ProvenTxReqHistory](#interface-proventxreqhistory) | [VerifyAndRepairBeefResult](#interface-verifyandrepairbeefresult) |
60
+ | [EntityTimeStamp](#interface-entitytimestamp) | [ProvenTxReqHistorySummaryApi](#interface-proventxreqhistorysummaryapi) | [WalletArgs](#interface-walletargs) |
61
+ | [ExchangeRatesIoApi](#interface-exchangeratesioapi) | [ProvenTxReqNotify](#interface-proventxreqnotify) | [WalletBalance](#interface-walletbalance) |
62
+ | [ExtendedVerifiableCertificate](#interface-extendedverifiablecertificate) | [ProviderCallHistory](#interface-providercallhistory) | [WalletLoggerArgs](#interface-walletloggerargs) |
63
+ | [FiatExchangeRates](#interface-fiatexchangerates) | [PurgeParams](#interface-purgeparams) | [WalletPermissionsManagerCallbacks](#interface-walletpermissionsmanagercallbacks) |
64
+ | [FindCertificateFieldsArgs](#interface-findcertificatefieldsargs) | [PurgeResults](#interface-purgeresults) | [WalletServices](#interface-walletservices) |
65
+ | [FindCertificatesArgs](#interface-findcertificatesargs) | [ReorgResult](#interface-reorgresult) | [WalletServicesOptions](#interface-walletservicesoptions) |
66
+ | [FindCommissionsArgs](#interface-findcommissionsargs) | [ReproveHeaderResult](#interface-reproveheaderresult) | [WalletSettings](#interface-walletsettings) |
67
+ | [FindForUserSincePagedArgs](#interface-findforusersincepagedargs) | [ReproveProvenResult](#interface-reproveprovenresult) | [WalletSettingsManagerConfig](#interface-walletsettingsmanagerconfig) |
68
+ | [FindMonitorEventsArgs](#interface-findmonitoreventsargs) | [RequestSyncChunkArgs](#interface-requestsyncchunkargs) | [WalletSigner](#interface-walletsigner) |
69
+ | [FindOutputBasketsArgs](#interface-findoutputbasketsargs) | [ReviewActionResult](#interface-reviewactionresult) | [WalletStorage](#interface-walletstorage) |
70
+ | [FindOutputTagMapsArgs](#interface-findoutputtagmapsargs) | [ScriptTemplateParamsBRC29](#interface-scripttemplateparamsbrc29) | [WalletStorageInfo](#interface-walletstorageinfo) |
71
+ | [FindOutputTagsArgs](#interface-findoutputtagsargs) | [ScriptTemplateUnlock](#interface-scripttemplateunlock) | [WalletStorageProvider](#interface-walletstorageprovider) |
72
+ | [FindOutputsArgs](#interface-findoutputsargs) | [ServiceCall](#interface-servicecall) | [WalletStorageReader](#interface-walletstoragereader) |
73
+ | [FindPartialSincePagedArgs](#interface-findpartialsincepagedargs) | [ServiceCall](#interface-servicecall) | [WalletStorageSync](#interface-walletstoragesync) |
74
+ | [FindProvenTxReqsArgs](#interface-findproventxreqsargs) | [ServiceCallHistory](#interface-servicecallhistory) | [WalletStorageSyncReader](#interface-walletstoragesyncreader) |
75
+ | [FindProvenTxsArgs](#interface-findproventxsargs) | [ServiceCallHistoryCounts](#interface-servicecallhistorycounts) | [WalletStorageWriter](#interface-walletstoragewriter) |
76
+ | [FindSincePagedArgs](#interface-findsincepagedargs) | [ServiceToCall](#interface-servicetocall) | [WalletTheme](#interface-wallettheme) |
77
+ | [FindSyncStatesArgs](#interface-findsyncstatesargs) | [SetupClientWalletArgs](#interface-setupclientwalletargs) | [WhatsOnChainServicesOptions](#interface-whatsonchainservicesoptions) |
78
+ | [FindTransactionsArgs](#interface-findtransactionsargs) | [SetupClientWalletClientArgs](#interface-setupclientwalletclientargs) | [WocChainInfo](#interface-wocchaininfo) |
79
+ | [FindTxLabelMapsArgs](#interface-findtxlabelmapsargs) | [SetupWallet](#interface-setupwallet) | [WocGetHeaderByteFileLinks](#interface-wocgetheaderbytefilelinks) |
80
+ | [FindTxLabelsArgs](#interface-findtxlabelsargs) | [SetupWalletClient](#interface-setupwalletclient) | [WocGetHeadersHeader](#interface-wocgetheadersheader) |
81
+ | [FindUsersArgs](#interface-findusersargs) | [SetupWalletIdb](#interface-setupwalletidb) | [WocHeader](#interface-wocheader) |
82
+ | [GenerateChangeSdkChangeInput](#interface-generatechangesdkchangeinput) | [SetupWalletIdbArgs](#interface-setupwalletidbargs) | [XValidCreateActionOutput](#interface-xvalidcreateactionoutput) |
83
+ | [GenerateChangeSdkChangeOutput](#interface-generatechangesdkchangeoutput) | [SignActionResultX](#interface-signactionresultx) | |
84
+ | [GenerateChangeSdkInput](#interface-generatechangesdkinput) | [StartAuthResponse](#interface-startauthresponse) | |
83
85
 
84
86
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
85
87
 
@@ -2331,8 +2333,9 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
2331
2333
  export interface CounterpartyPermissions {
2332
2334
  description?: string;
2333
2335
  protocols: Array<{
2334
- protocolID: WalletProtocol;
2335
- description: string;
2336
+ protocolName: string;
2337
+ protocolID?: WalletProtocol;
2338
+ description?: string;
2336
2339
  }>;
2337
2340
  }
2338
2341
  ```
@@ -2705,6 +2708,8 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
2705
2708
  export interface FindTransactionsArgs extends FindSincePagedArgs {
2706
2709
  partial: Partial<TableTransaction>;
2707
2710
  status?: TransactionStatus[];
2711
+ from?: Date;
2712
+ to?: Date;
2708
2713
  noRawTx?: boolean;
2709
2714
  }
2710
2715
  ```
@@ -3641,13 +3646,68 @@ userAgent: string
3641
3646
 
3642
3647
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
3643
3648
 
3649
+ ---
3650
+ ##### Interface: MockChainBlockHeaderRow
3651
+
3652
+ ```ts
3653
+ export interface MockChainBlockHeaderRow {
3654
+ height: number;
3655
+ hash: string;
3656
+ previousHash: string;
3657
+ merkleRoot: string;
3658
+ version: number;
3659
+ time: number;
3660
+ bits: number;
3661
+ nonce: number;
3662
+ coinbaseTxid: string;
3663
+ created_at?: Date | string;
3664
+ }
3665
+ ```
3666
+
3667
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
3668
+
3669
+ ---
3670
+ ##### Interface: MockChainTransactionRow
3671
+
3672
+ ```ts
3673
+ export interface MockChainTransactionRow {
3674
+ txid: string;
3675
+ rawTx: number[] | Buffer | Uint8Array;
3676
+ blockHeight: number | null;
3677
+ blockIndex: number | null;
3678
+ created_at?: Date | string;
3679
+ }
3680
+ ```
3681
+
3682
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
3683
+
3684
+ ---
3685
+ ##### Interface: MockChainUtxoRow
3686
+
3687
+ ```ts
3688
+ export interface MockChainUtxoRow {
3689
+ id?: number;
3690
+ txid: string;
3691
+ vout: number;
3692
+ lockingScript: number[] | Buffer | Uint8Array;
3693
+ satoshis: number;
3694
+ scriptHash: string;
3695
+ spentByTxid: string | null;
3696
+ isCoinbase: boolean;
3697
+ blockHeight: number | null;
3698
+ created_at?: Date | string;
3699
+ }
3700
+ ```
3701
+
3702
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
3703
+
3644
3704
  ---
3645
3705
  ##### Interface: MonitorOptions
3646
3706
 
3647
3707
  ```ts
3648
3708
  export interface MonitorOptions {
3649
3709
  chain: Chain;
3650
- services: Services;
3710
+ services: Services | WalletServices;
3651
3711
  storage: MonitorStorage;
3652
3712
  chaintracks: ChaintracksClientApi;
3653
3713
  chaintracksWithEvents?: Chaintracks;
@@ -3661,7 +3721,7 @@ export interface MonitorOptions {
3661
3721
  }
3662
3722
  ```
3663
3723
 
3664
- See also: [Chain](./client.md#type-chain), [Chaintracks](./services.md#class-chaintracks), [ChaintracksClientApi](./services.md#interface-chaintracksclientapi), [MonitorStorage](./monitor.md#type-monitorstorage), [ProvenTransactionStatus](./client.md#interface-proventransactionstatus), [ReviewActionResult](./client.md#interface-reviewactionresult), [Services](./services.md#class-services)
3724
+ See also: [Chain](./client.md#type-chain), [Chaintracks](./services.md#class-chaintracks), [ChaintracksClientApi](./services.md#interface-chaintracksclientapi), [MonitorStorage](./monitor.md#type-monitorstorage), [ProvenTransactionStatus](./client.md#interface-proventransactionstatus), [ReviewActionResult](./client.md#interface-reviewactionresult), [Services](./services.md#class-services), [WalletServices](./client.md#interface-walletservices)
3665
3725
 
3666
3726
  ###### Property msecsWaitPerMerkleProofServiceReq
3667
3727
 
@@ -4778,6 +4838,21 @@ export interface PurgeResults {
4778
4838
 
4779
4839
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
4780
4840
 
4841
+ ---
4842
+ ##### Interface: ReorgResult
4843
+
4844
+ ```ts
4845
+ export interface ReorgResult {
4846
+ oldTip: BlockHeader;
4847
+ newTip: BlockHeader;
4848
+ deactivatedHeaders: BlockHeader[];
4849
+ }
4850
+ ```
4851
+
4852
+ See also: [BlockHeader](./client.md#interface-blockheader)
4853
+
4854
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
4855
+
4781
4856
  ---
4782
4857
  ##### Interface: ReproveHeaderResult
4783
4858
 
@@ -8200,41 +8275,43 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
8200
8275
 
8201
8276
  | | | |
8202
8277
  | --- | --- | --- |
8203
- | [ARC](#class-arc) | [EntityProvenTx](#class-entityproventx) | [TaskReorg](#class-taskreorg) |
8204
- | [AuthMethodInteractor](#class-authmethodinteractor) | [EntityProvenTxReq](#class-entityproventxreq) | [TaskReviewStatus](#class-taskreviewstatus) |
8205
- | [BHServiceClient](#class-bhserviceclient) | [EntitySyncState](#class-entitysyncstate) | [TaskSendWaiting](#class-tasksendwaiting) |
8206
- | [Bitails](#class-bitails) | [EntityTransaction](#class-entitytransaction) | [TaskSyncWhenIdle](#class-tasksyncwhenidle) |
8207
- | [BulkFileDataManager](#class-bulkfiledatamanager) | [EntityTxLabel](#class-entitytxlabel) | [TaskUnFail](#class-taskunfail) |
8208
- | [BulkFileDataReader](#class-bulkfiledatareader) | [EntityTxLabelMap](#class-entitytxlabelmap) | [TwilioPhoneInteractor](#class-twiliophoneinteractor) |
8209
- | [BulkFilesReader](#class-bulkfilesreader) | [EntityUser](#class-entityuser) | [WABClient](#class-wabclient) |
8210
- | [BulkFilesReaderFs](#class-bulkfilesreaderfs) | [HeightRange](#class-heightrange) | [WERR_BAD_REQUEST](#class-werr_bad_request) |
8211
- | [BulkFilesReaderStorage](#class-bulkfilesreaderstorage) | [LiveIngestorBase](#class-liveingestorbase) | [WERR_BROADCAST_UNAVAILABLE](#class-werr_broadcast_unavailable) |
8212
- | [BulkHeaderFile](#class-bulkheaderfile) | [LiveIngestorWhatsOnChainPoll](#class-liveingestorwhatsonchainpoll) | [WERR_INSUFFICIENT_FUNDS](#class-werr_insufficient_funds) |
8213
- | [BulkHeaderFileFs](#class-bulkheaderfilefs) | [MergeEntity](#class-mergeentity) | [WERR_INTERNAL](#class-werr_internal) |
8214
- | [BulkHeaderFileStorage](#class-bulkheaderfilestorage) | [Monitor](#class-monitor) | [WERR_INVALID_MERKLE_ROOT](#class-werr_invalid_merkle_root) |
8215
- | [BulkHeaderFiles](#class-bulkheaderfiles) | [OverlayUMPTokenInteractor](#class-overlayumptokeninteractor) | [WERR_INVALID_OPERATION](#class-werr_invalid_operation) |
8216
- | [BulkIngestorBase](#class-bulkingestorbase) | [PersonaIDInteractor](#class-personaidinteractor) | [WERR_INVALID_PARAMETER](#class-werr_invalid_parameter) |
8217
- | [BulkIngestorCDN](#class-bulkingestorcdn) | [PrivilegedKeyManager](#class-privilegedkeymanager) | [WERR_INVALID_PUBLIC_KEY](#class-werr_invalid_public_key) |
8218
- | [BulkIngestorCDNBabbage](#class-bulkingestorcdnbabbage) | [ScriptTemplateBRC29](#class-scripttemplatebrc29) | [WERR_MISSING_PARAMETER](#class-werr_missing_parameter) |
8219
- | [BulkIngestorWhatsOnChainCdn](#class-bulkingestorwhatsonchaincdn) | [SdkWhatsOnChain](#class-sdkwhatsonchain) | [WERR_NETWORK_CHAIN](#class-werr_network_chain) |
8220
- | [BulkStorageBase](#class-bulkstoragebase) | [ServiceCollection](#class-servicecollection) | [WERR_NOT_ACTIVE](#class-werr_not_active) |
8221
- | [CWIStyleWalletManager](#class-cwistylewalletmanager) | [Services](#class-services) | [WERR_NOT_IMPLEMENTED](#class-werr_not_implemented) |
8222
- | [Chaintracks](#class-chaintracks) | [SetupClient](#class-setupclient) | [WERR_REVIEW_ACTIONS](#class-werr_review_actions) |
8223
- | [ChaintracksChainTracker](#class-chaintrackschaintracker) | [SimpleWalletManager](#class-simplewalletmanager) | [WERR_UNAUTHORIZED](#class-werr_unauthorized) |
8224
- | [ChaintracksFetch](#class-chaintracksfetch) | [SingleWriterMultiReaderLock](#class-singlewritermultireaderlock) | [Wallet](#class-wallet) |
8225
- | [ChaintracksServiceClient](#class-chaintracksserviceclient) | [StorageClient](#class-storageclient) | [WalletAuthenticationManager](#class-walletauthenticationmanager) |
8226
- | [ChaintracksStorageBase](#class-chaintracksstoragebase) | [StorageIdb](#class-storageidb) | [WalletError](#class-walleterror) |
8227
- | [ChaintracksStorageIdb](#class-chaintracksstorageidb) | [StorageProvider](#class-storageprovider) | [WalletLogger](#class-walletlogger) |
8228
- | [ChaintracksStorageNoDb](#class-chaintracksstoragenodb) | [StorageReader](#class-storagereader) | [WalletMonitorTask](#class-walletmonitortask) |
8229
- | [DevConsoleInteractor](#class-devconsoleinteractor) | [StorageReaderWriter](#class-storagereaderwriter) | [WalletPermissionsManager](#class-walletpermissionsmanager) |
8230
- | [EntityBase](#class-entitybase) | [StorageSyncReader](#class-storagesyncreader) | [WalletSettingsManager](#class-walletsettingsmanager) |
8231
- | [EntityCertificate](#class-entitycertificate) | [TaskCheckForProofs](#class-taskcheckforproofs) | [WalletSigner](#class-walletsigner) |
8232
- | [EntityCertificateField](#class-entitycertificatefield) | [TaskCheckNoSends](#class-taskchecknosends) | [WalletStorageManager](#class-walletstoragemanager) |
8233
- | [EntityCommission](#class-entitycommission) | [TaskClock](#class-taskclock) | [WhatsOnChain](#class-whatsonchain) |
8234
- | [EntityOutput](#class-entityoutput) | [TaskFailAbandoned](#class-taskfailabandoned) | [WhatsOnChainNoServices](#class-whatsonchainnoservices) |
8235
- | [EntityOutputBasket](#class-entityoutputbasket) | [TaskMonitorCallHistory](#class-taskmonitorcallhistory) | [WhatsOnChainServices](#class-whatsonchainservices) |
8236
- | [EntityOutputTag](#class-entityoutputtag) | [TaskNewHeader](#class-tasknewheader) | |
8237
- | [EntityOutputTagMap](#class-entityoutputtagmap) | [TaskPurge](#class-taskpurge) | |
8278
+ | [ARC](#class-arc) | [EntitySyncState](#class-entitysyncstate) | [TaskNewHeader](#class-tasknewheader) |
8279
+ | [AuthMethodInteractor](#class-authmethodinteractor) | [EntityTransaction](#class-entitytransaction) | [TaskPurge](#class-taskpurge) |
8280
+ | [BHServiceClient](#class-bhserviceclient) | [EntityTxLabel](#class-entitytxlabel) | [TaskReorg](#class-taskreorg) |
8281
+ | [Bitails](#class-bitails) | [EntityTxLabelMap](#class-entitytxlabelmap) | [TaskReviewStatus](#class-taskreviewstatus) |
8282
+ | [BulkFileDataManager](#class-bulkfiledatamanager) | [EntityUser](#class-entityuser) | [TaskSendWaiting](#class-tasksendwaiting) |
8283
+ | [BulkFileDataReader](#class-bulkfiledatareader) | [HeightRange](#class-heightrange) | [TaskSyncWhenIdle](#class-tasksyncwhenidle) |
8284
+ | [BulkFilesReader](#class-bulkfilesreader) | [LiveIngestorBase](#class-liveingestorbase) | [TaskUnFail](#class-taskunfail) |
8285
+ | [BulkFilesReaderFs](#class-bulkfilesreaderfs) | [LiveIngestorWhatsOnChainPoll](#class-liveingestorwhatsonchainpoll) | [TwilioPhoneInteractor](#class-twiliophoneinteractor) |
8286
+ | [BulkFilesReaderStorage](#class-bulkfilesreaderstorage) | [MergeEntity](#class-mergeentity) | [WABClient](#class-wabclient) |
8287
+ | [BulkHeaderFile](#class-bulkheaderfile) | [MockChainMigrations](#class-mockchainmigrations) | [WERR_BAD_REQUEST](#class-werr_bad_request) |
8288
+ | [BulkHeaderFileFs](#class-bulkheaderfilefs) | [MockChainStorage](#class-mockchainstorage) | [WERR_BROADCAST_UNAVAILABLE](#class-werr_broadcast_unavailable) |
8289
+ | [BulkHeaderFileStorage](#class-bulkheaderfilestorage) | [MockChainTracker](#class-mockchaintracker) | [WERR_INSUFFICIENT_FUNDS](#class-werr_insufficient_funds) |
8290
+ | [BulkHeaderFiles](#class-bulkheaderfiles) | [MockMiner](#class-mockminer) | [WERR_INTERNAL](#class-werr_internal) |
8291
+ | [BulkIngestorBase](#class-bulkingestorbase) | [MockServices](#class-mockservices) | [WERR_INVALID_MERKLE_ROOT](#class-werr_invalid_merkle_root) |
8292
+ | [BulkIngestorCDN](#class-bulkingestorcdn) | [Monitor](#class-monitor) | [WERR_INVALID_OPERATION](#class-werr_invalid_operation) |
8293
+ | [BulkIngestorCDNBabbage](#class-bulkingestorcdnbabbage) | [OverlayUMPTokenInteractor](#class-overlayumptokeninteractor) | [WERR_INVALID_PARAMETER](#class-werr_invalid_parameter) |
8294
+ | [BulkIngestorWhatsOnChainCdn](#class-bulkingestorwhatsonchaincdn) | [PersonaIDInteractor](#class-personaidinteractor) | [WERR_INVALID_PUBLIC_KEY](#class-werr_invalid_public_key) |
8295
+ | [BulkStorageBase](#class-bulkstoragebase) | [PrivilegedKeyManager](#class-privilegedkeymanager) | [WERR_MISSING_PARAMETER](#class-werr_missing_parameter) |
8296
+ | [CWIStyleWalletManager](#class-cwistylewalletmanager) | [ScriptTemplateBRC29](#class-scripttemplatebrc29) | [WERR_NETWORK_CHAIN](#class-werr_network_chain) |
8297
+ | [Chaintracks](#class-chaintracks) | [SdkWhatsOnChain](#class-sdkwhatsonchain) | [WERR_NOT_ACTIVE](#class-werr_not_active) |
8298
+ | [ChaintracksChainTracker](#class-chaintrackschaintracker) | [ServiceCollection](#class-servicecollection) | [WERR_NOT_IMPLEMENTED](#class-werr_not_implemented) |
8299
+ | [ChaintracksFetch](#class-chaintracksfetch) | [Services](#class-services) | [WERR_REVIEW_ACTIONS](#class-werr_review_actions) |
8300
+ | [ChaintracksServiceClient](#class-chaintracksserviceclient) | [SetupClient](#class-setupclient) | [WERR_UNAUTHORIZED](#class-werr_unauthorized) |
8301
+ | [ChaintracksStorageBase](#class-chaintracksstoragebase) | [SimpleWalletManager](#class-simplewalletmanager) | [Wallet](#class-wallet) |
8302
+ | [ChaintracksStorageIdb](#class-chaintracksstorageidb) | [SingleWriterMultiReaderLock](#class-singlewritermultireaderlock) | [WalletAuthenticationManager](#class-walletauthenticationmanager) |
8303
+ | [ChaintracksStorageNoDb](#class-chaintracksstoragenodb) | [StorageClient](#class-storageclient) | [WalletError](#class-walleterror) |
8304
+ | [DevConsoleInteractor](#class-devconsoleinteractor) | [StorageIdb](#class-storageidb) | [WalletLogger](#class-walletlogger) |
8305
+ | [EntityBase](#class-entitybase) | [StorageProvider](#class-storageprovider) | [WalletMonitorTask](#class-walletmonitortask) |
8306
+ | [EntityCertificate](#class-entitycertificate) | [StorageReader](#class-storagereader) | [WalletPermissionsManager](#class-walletpermissionsmanager) |
8307
+ | [EntityCertificateField](#class-entitycertificatefield) | [StorageReaderWriter](#class-storagereaderwriter) | [WalletSettingsManager](#class-walletsettingsmanager) |
8308
+ | [EntityCommission](#class-entitycommission) | [StorageSyncReader](#class-storagesyncreader) | [WalletSigner](#class-walletsigner) |
8309
+ | [EntityOutput](#class-entityoutput) | [TaskCheckForProofs](#class-taskcheckforproofs) | [WalletStorageManager](#class-walletstoragemanager) |
8310
+ | [EntityOutputBasket](#class-entityoutputbasket) | [TaskCheckNoSends](#class-taskchecknosends) | [WhatsOnChain](#class-whatsonchain) |
8311
+ | [EntityOutputTag](#class-entityoutputtag) | [TaskClock](#class-taskclock) | [WhatsOnChainNoServices](#class-whatsonchainnoservices) |
8312
+ | [EntityOutputTagMap](#class-entityoutputtagmap) | [TaskFailAbandoned](#class-taskfailabandoned) | [WhatsOnChainServices](#class-whatsonchainservices) |
8313
+ | [EntityProvenTx](#class-entityproventx) | [TaskMineBlock](#class-taskmineblock) | |
8314
+ | [EntityProvenTxReq](#class-entityproventxreq) | [TaskMonitorCallHistory](#class-taskmonitorcallhistory) | |
8238
8315
 
8239
8316
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
8240
8317
 
@@ -9344,19 +9421,28 @@ export class Chaintracks implements ChaintracksManagementApi {
9344
9421
  async startListening(): Promise<void>
9345
9422
  private async syncBulkStorageNoLock(presentHeight: number, initialRanges: HeightRanges): Promise<void> {
9346
9423
  let newLiveHeaders: BlockHeader[] = [];
9347
- let bulkDone = false;
9348
9424
  let before = initialRanges;
9349
9425
  let after = before;
9350
9426
  let added = HeightRange.empty;
9427
+ const maxSyncRounds = Math.max(1, this.bulkIngestors.length * 2);
9351
9428
  let done = false;
9352
- for (; !done;) {
9429
+ for (let round = 1; !done && round <= maxSyncRounds; round++) {
9353
9430
  let bulkSyncError: WalletError | undefined;
9431
+ let roundMadeProgress = false;
9432
+ let roundHadSuccess = false;
9354
9433
  for (const bulk of this.bulkIngestors) {
9355
9434
  try {
9435
+ const beforeBulkMax = before.bulk.maxHeight;
9436
+ const beforeLiveRange = HeightRange.from(newLiveHeaders);
9356
9437
  const r = await bulk.synchronize(presentHeight, before, newLiveHeaders);
9438
+ roundHadSuccess = true;
9357
9439
  newLiveHeaders = r.liveHeaders;
9358
9440
  after = await this.storage.getAvailableHeightRanges();
9359
9441
  added = after.bulk.above(before.bulk);
9442
+ const afterLiveRange = HeightRange.from(newLiveHeaders);
9443
+ if (after.bulk.maxHeight > beforeBulkMax || afterLiveRange.maxHeight > beforeLiveRange.maxHeight) {
9444
+ roundMadeProgress = true;
9445
+ }
9360
9446
  before = after;
9361
9447
  this.log(`Bulk Ingestor: ${added.length} added with ${newLiveHeaders.length} live headers from ${bulk.constructor.name}`);
9362
9448
  if (r.done) {
@@ -9371,12 +9457,19 @@ export class Chaintracks implements ChaintracksManagementApi {
9371
9457
  break;
9372
9458
  }
9373
9459
  }
9374
- if (!bulkDone && !this.available && bulkSyncError) {
9460
+ if (!this.available && bulkSyncError && !roundHadSuccess) {
9375
9461
  this.startupError = bulkSyncError;
9376
9462
  break;
9377
9463
  }
9378
- if (bulkDone)
9464
+ if (done)
9465
+ break;
9466
+ if (!roundMadeProgress) {
9467
+ this.log(`Bulk sync stalled after round ${round}. Deferring further bulk sync attempts to continue live header processing.`);
9379
9468
  break;
9469
+ }
9470
+ if (round === maxSyncRounds) {
9471
+ this.log(`Bulk sync paused after ${maxSyncRounds} rounds to avoid runaway retries. Will retry in a later sync cycle.`);
9472
+ }
9380
9473
  }
9381
9474
  if (!this.startupError) {
9382
9475
  this.liveHeaders.unshift(...newLiveHeaders);
@@ -11226,6 +11319,146 @@ Argument Details
11226
11319
 
11227
11320
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
11228
11321
 
11322
+ ---
11323
+ ##### Class: MockChainMigrations
11324
+
11325
+ ```ts
11326
+ export class MockChainMigrations implements MigrationSource<string> {
11327
+ migrations: Record<string, Migration> = {};
11328
+ constructor()
11329
+ async getMigrations(): Promise<string[]>
11330
+ getMigrationName(migration: string)
11331
+ async getMigration(migration: string): Promise<Migration>
11332
+ setupMigrations(): Record<string, Migration>
11333
+ }
11334
+ ```
11335
+
11336
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
11337
+
11338
+ ---
11339
+ ##### Class: MockChainStorage
11340
+
11341
+ ```ts
11342
+ export class MockChainStorage {
11343
+ constructor(public knex: Knex)
11344
+ async migrate(): Promise<void>
11345
+ async insertTransaction(txid: string, rawTx: number[]): Promise<void>
11346
+ async getTransaction(txid: string): Promise<MockChainTransactionRow | undefined>
11347
+ async getUnminedTransactions(): Promise<MockChainTransactionRow[]>
11348
+ async setTransactionBlock(txid: string, height: number, index: number): Promise<void>
11349
+ async insertUtxo(txid: string, vout: number, lockingScript: number[], satoshis: number, scriptHash: string, isCoinbase = false, blockHeight: number | null = null): Promise<void>
11350
+ async getUtxo(txid: string, vout: number): Promise<MockChainUtxoRow | undefined>
11351
+ async getUtxosByScriptHash(scriptHash: string): Promise<MockChainUtxoRow[]>
11352
+ async markUtxoSpent(txid: string, vout: number, spentByTxid: string): Promise<void>
11353
+ async insertBlockHeader(header: MockChainBlockHeaderRow): Promise<void>
11354
+ async getBlockHeaderByHeight(height: number): Promise<BlockHeader | undefined>
11355
+ async getBlockHeaderByHash(hash: string): Promise<BlockHeader | undefined>
11356
+ async getChainTip(): Promise<BlockHeader | undefined>
11357
+ async getTransactionsInBlock(height: number): Promise<MockChainTransactionRow[]>
11358
+ async deleteBlockHeader(height: number): Promise<void>
11359
+ async deleteTransaction(txid: string): Promise<void>
11360
+ async deleteUtxosByTxid(txid: string): Promise<void>
11361
+ async setUtxoBlockHeight(txid: string, blockHeight: number | null): Promise<void>
11362
+ async unspendUtxo(txid: string, vout: number): Promise<void>
11363
+ }
11364
+ ```
11365
+
11366
+ See also: [BlockHeader](./client.md#interface-blockheader), [MockChainBlockHeaderRow](./client.md#interface-mockchainblockheaderrow), [MockChainTransactionRow](./client.md#interface-mockchaintransactionrow), [MockChainUtxoRow](./client.md#interface-mockchainutxorow)
11367
+
11368
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
11369
+
11370
+ ---
11371
+ ##### Class: MockChainTracker
11372
+
11373
+ ```ts
11374
+ export class MockChainTracker implements ChaintracksClientApi {
11375
+ constructor(public chain: Chain, public storage: MockChainStorage)
11376
+ async currentHeight(): Promise<number>
11377
+ async isValidRootForHeight(root: string, height: number): Promise<boolean>
11378
+ async getChain(): Promise<Chain>
11379
+ async getInfo(): Promise<ChaintracksInfoApi>
11380
+ async getPresentHeight(): Promise<number>
11381
+ async getHeaders(height: number, count: number): Promise<string>
11382
+ async findChainTipHeader(): Promise<BlockHeader>
11383
+ async findChainTipHash(): Promise<string>
11384
+ async findHeaderForHeight(height: number): Promise<BlockHeader | undefined>
11385
+ async findHeaderForBlockHash(hash: string): Promise<BlockHeader | undefined>
11386
+ async addHeader(_header: BaseBlockHeader): Promise<void>
11387
+ async startListening(): Promise<void>
11388
+ async listening(): Promise<void>
11389
+ async isListening(): Promise<boolean>
11390
+ async isSynchronized(): Promise<boolean>
11391
+ async subscribeHeaders(_listener: HeaderListener): Promise<string>
11392
+ async subscribeReorgs(_listener: ReorgListener): Promise<string>
11393
+ async unsubscribe(_subscriptionId: string): Promise<boolean>
11394
+ }
11395
+ ```
11396
+
11397
+ See also: [BaseBlockHeader](./client.md#interface-baseblockheader), [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain), [ChaintracksClientApi](./services.md#interface-chaintracksclientapi), [ChaintracksInfoApi](./services.md#interface-chaintracksinfoapi), [HeaderListener](./services.md#type-headerlistener), [MockChainStorage](./client.md#class-mockchainstorage), [ReorgListener](./services.md#type-reorglistener)
11398
+
11399
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
11400
+
11401
+ ---
11402
+ ##### Class: MockMiner
11403
+
11404
+ ```ts
11405
+ export class MockMiner {
11406
+ async mineBlock(storage: MockChainStorage): Promise<BlockHeader>
11407
+ }
11408
+ ```
11409
+
11410
+ See also: [BlockHeader](./client.md#interface-blockheader), [MockChainStorage](./client.md#class-mockchainstorage)
11411
+
11412
+ ###### Method mineBlock
11413
+
11414
+ Mine a new block containing all unmined transactions.
11415
+ Returns the new block header.
11416
+
11417
+ ```ts
11418
+ async mineBlock(storage: MockChainStorage): Promise<BlockHeader>
11419
+ ```
11420
+ See also: [BlockHeader](./client.md#interface-blockheader), [MockChainStorage](./client.md#class-mockchainstorage)
11421
+
11422
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
11423
+
11424
+ ---
11425
+ ##### Class: MockServices
11426
+
11427
+ ```ts
11428
+ export class MockServices implements WalletServices {
11429
+ chain: Chain = "mock";
11430
+ storage: MockChainStorage;
11431
+ tracker: MockChainTracker;
11432
+ miner: MockMiner;
11433
+ constructor(public knex: Knex)
11434
+ async initialize(): Promise<void>
11435
+ async mineBlock(): Promise<BlockHeader>
11436
+ async postBeef(beef: Beef, txids: string[]): Promise<PostBeefResult[]>
11437
+ async reorg(startingHeight: number, numBlocks: number, txidMap?: Record<string, number>): Promise<ReorgResult>
11438
+ async getRawTx(txid: string): Promise<GetRawTxResult>
11439
+ async getMerklePath(txid: string): Promise<GetMerklePathResult>
11440
+ async getUtxoStatus(output: string, outputFormat?: GetUtxoStatusOutputFormat, outpoint?: string): Promise<GetUtxoStatusResult>
11441
+ async getStatusForTxids(txids: string[]): Promise<GetStatusForTxidsResult>
11442
+ async getScriptHashHistory(hash: string): Promise<GetScriptHashHistoryResult>
11443
+ async getChainTracker(): Promise<ChainTracker>
11444
+ async getHeaderForHeight(height: number): Promise<number[]>
11445
+ async getHeight(): Promise<number>
11446
+ async hashToHeader(hash: string): Promise<BlockHeader>
11447
+ hashOutputScript(script: string): string
11448
+ async isUtxo(output: TableOutput): Promise<boolean>
11449
+ async getBsvExchangeRate(): Promise<number>
11450
+ async getFiatExchangeRate(currency: FiatCurrencyCode, base?: FiatCurrencyCode): Promise<number>
11451
+ async getFiatExchangeRates(targetCurrencies: FiatCurrencyCode[]): Promise<FiatExchangeRates>
11452
+ async nLockTimeIsFinal(tx: string | number[] | BsvTransaction | number): Promise<boolean>
11453
+ async getBeefForTxid(txid: string): Promise<Beef>
11454
+ getServicesCallHistory(): ServicesCallHistory
11455
+ }
11456
+ ```
11457
+
11458
+ See also: [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain), [FiatCurrencyCode](./client.md#type-fiatcurrencycode), [FiatExchangeRates](./client.md#interface-fiatexchangerates), [GetMerklePathResult](./client.md#interface-getmerklepathresult), [GetRawTxResult](./client.md#interface-getrawtxresult), [GetScriptHashHistoryResult](./client.md#interface-getscripthashhistoryresult), [GetStatusForTxidsResult](./client.md#interface-getstatusfortxidsresult), [GetUtxoStatusOutputFormat](./client.md#type-getutxostatusoutputformat), [GetUtxoStatusResult](./client.md#interface-getutxostatusresult), [MockChainStorage](./client.md#class-mockchainstorage), [MockChainTracker](./client.md#class-mockchaintracker), [MockMiner](./client.md#class-mockminer), [PostBeefResult](./client.md#interface-postbeefresult), [ReorgResult](./client.md#interface-reorgresult), [ServicesCallHistory](./client.md#type-servicescallhistory), [TableOutput](./storage.md#interface-tableoutput), [WalletServices](./client.md#interface-walletservices), [getBeefForTxid](./services.md#function-getbeeffortxid)
11459
+
11460
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
11461
+
11229
11462
  ---
11230
11463
  ##### Class: Monitor
11231
11464
 
@@ -11236,7 +11469,7 @@ and potentially that reorgs update proofs that were already received.
11236
11469
  export class Monitor {
11237
11470
  static createDefaultWalletMonitorOptions(chain: Chain, storage: MonitorStorage, services?: Services, chaintracks?: Chaintracks): MonitorOptions
11238
11471
  options: MonitorOptions;
11239
- services: Services;
11472
+ services: Services | WalletServices;
11240
11473
  chain: Chain;
11241
11474
  storage: MonitorStorage;
11242
11475
  chaintracks: ChaintracksClientApi;
@@ -11287,7 +11520,7 @@ export class Monitor {
11287
11520
  }
11288
11521
  ```
11289
11522
 
11290
- See also: [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain), [Chaintracks](./services.md#class-chaintracks), [ChaintracksClientApi](./services.md#interface-chaintracksclientapi), [DeactivedHeader](./monitor.md#interface-deactivedheader), [MonitorOptions](./monitor.md#interface-monitoroptions), [MonitorStorage](./monitor.md#type-monitorstorage), [ProvenTransactionStatus](./client.md#interface-proventransactionstatus), [ReviewActionResult](./client.md#interface-reviewactionresult), [Services](./services.md#class-services), [TaskPurgeParams](./monitor.md#interface-taskpurgeparams), [WalletMonitorTask](./monitor.md#class-walletmonitortask)
11523
+ See also: [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain), [Chaintracks](./services.md#class-chaintracks), [ChaintracksClientApi](./services.md#interface-chaintracksclientapi), [DeactivedHeader](./monitor.md#interface-deactivedheader), [MonitorOptions](./monitor.md#interface-monitoroptions), [MonitorStorage](./monitor.md#type-monitorstorage), [ProvenTransactionStatus](./client.md#interface-proventransactionstatus), [ReviewActionResult](./client.md#interface-reviewactionresult), [Services](./services.md#class-services), [TaskPurgeParams](./monitor.md#interface-taskpurgeparams), [WalletMonitorTask](./monitor.md#class-walletmonitortask), [WalletServices](./client.md#interface-walletservices)
11291
11524
 
11292
11525
  ###### Property _otherTasks
11293
11526
 
@@ -11597,7 +11830,7 @@ export default class SdkWhatsOnChain implements ChainTracker {
11597
11830
  readonly apiKey: string;
11598
11831
  protected readonly URL: string;
11599
11832
  protected readonly httpClient: HttpClient;
11600
- constructor(network: "main" | "test" | "stn" = "main", config: WhatsOnChainConfig = {})
11833
+ constructor(network: "main" | "test" | "stn" | "teratest" = "main", config: WhatsOnChainConfig = {})
11601
11834
  async isValidRootForHeight(root: string, height: number): Promise<boolean>
11602
11835
  async currentHeight(): Promise<number>
11603
11836
  protected getHttpHeaders(): Record<string, string>
@@ -11609,7 +11842,7 @@ export default class SdkWhatsOnChain implements ChainTracker {
11609
11842
  Constructs an instance of the WhatsOnChain ChainTracker.
11610
11843
 
11611
11844
  ```ts
11612
- constructor(network: "main" | "test" | "stn" = "main", config: WhatsOnChainConfig = {})
11845
+ constructor(network: "main" | "test" | "stn" | "teratest" = "main", config: WhatsOnChainConfig = {})
11613
11846
  ```
11614
11847
 
11615
11848
  Argument Details
@@ -11730,6 +11963,9 @@ export class Services implements WalletServices {
11730
11963
  async getUtxoStatus(output: string, outputFormat?: GetUtxoStatusOutputFormat, outpoint?: string, useNext?: boolean, logger?: WalletLoggerInterface): Promise<GetUtxoStatusResult>
11731
11964
  async getScriptHashHistory(hash: string, useNext?: boolean, logger?: WalletLoggerInterface): Promise<GetScriptHashHistoryResult>
11732
11965
  postBeefMode: "PromiseAll" | "UntilSuccess" = "UntilSuccess";
11966
+ postBeefUntilSuccessSoftTimeoutMs = 5000;
11967
+ postBeefUntilSuccessSoftTimeoutPerKbMs = 50;
11968
+ postBeefUntilSuccessSoftTimeoutMaxMs = 30000;
11733
11969
  async postBeef(beef: Beef, txids: string[], logger?: WalletLoggerInterface): Promise<PostBeefResult[]>
11734
11970
  async getRawTx(txid: string, useNext?: boolean): Promise<GetRawTxResult>
11735
11971
  async invokeChaintracksWithRetry<R>(method: () => Promise<R>): Promise<R>
@@ -11745,6 +11981,32 @@ export class Services implements WalletServices {
11745
11981
 
11746
11982
  See also: [ARC](./services.md#class-arc), [Bitails](./services.md#class-bitails), [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain), [FiatCurrencyCode](./client.md#type-fiatcurrencycode), [FiatExchangeRates](./client.md#interface-fiatexchangerates), [GetMerklePathResult](./client.md#interface-getmerklepathresult), [GetMerklePathService](./client.md#type-getmerklepathservice), [GetRawTxResult](./client.md#interface-getrawtxresult), [GetRawTxService](./client.md#type-getrawtxservice), [GetScriptHashHistoryResult](./client.md#interface-getscripthashhistoryresult), [GetScriptHashHistoryService](./client.md#type-getscripthashhistoryservice), [GetStatusForTxidsResult](./client.md#interface-getstatusfortxidsresult), [GetStatusForTxidsService](./client.md#type-getstatusfortxidsservice), [GetUtxoStatusOutputFormat](./client.md#type-getutxostatusoutputformat), [GetUtxoStatusResult](./client.md#interface-getutxostatusresult), [GetUtxoStatusService](./client.md#type-getutxostatusservice), [PostBeefResult](./client.md#interface-postbeefresult), [PostBeefService](./client.md#type-postbeefservice), [ServiceCollection](./services.md#class-servicecollection), [ServicesCallHistory](./client.md#type-servicescallhistory), [TableOutput](./storage.md#interface-tableoutput), [UpdateFiatExchangeRateService](./client.md#type-updatefiatexchangerateservice), [WalletServices](./client.md#interface-walletservices), [WalletServicesOptions](./client.md#interface-walletservicesoptions), [WhatsOnChain](./services.md#class-whatsonchain), [getBeefForTxid](./services.md#function-getbeeffortxid), [logger](./client.md#variable-logger)
11747
11983
 
11984
+ ###### Property postBeefUntilSuccessSoftTimeoutMaxMs
11985
+
11986
+ Upper bound for adaptive soft-timeout in `UntilSuccess` mode.
11987
+
11988
+ ```ts
11989
+ postBeefUntilSuccessSoftTimeoutMaxMs = 30000
11990
+ ```
11991
+
11992
+ ###### Property postBeefUntilSuccessSoftTimeoutMs
11993
+
11994
+ Soft timeout used for each provider call in `UntilSuccess` mode.
11995
+ This bounds request latency when a provider hangs before failover.
11996
+
11997
+ ```ts
11998
+ postBeefUntilSuccessSoftTimeoutMs = 5000
11999
+ ```
12000
+
12001
+ ###### Property postBeefUntilSuccessSoftTimeoutPerKbMs
12002
+
12003
+ Additional soft-timeout budget (ms) per KiB of serialized Beef payload.
12004
+ Helps avoid false timeout failover on legitimately large submissions.
12005
+
12006
+ ```ts
12007
+ postBeefUntilSuccessSoftTimeoutPerKbMs = 50
12008
+ ```
12009
+
11748
12010
  ###### Method hashOutputScript
11749
12011
 
11750
12012
  ```ts
@@ -13183,6 +13445,14 @@ export abstract class StorageProvider extends StorageReaderWriter implements Wal
13183
13445
  abstract listActions(auth: AuthId, args: Validation.ValidListActionsArgs): Promise<ListActionsResult>;
13184
13446
  abstract listOutputs(auth: AuthId, args: Validation.ValidListOutputsArgs): Promise<ListOutputsResult>;
13185
13447
  abstract countChangeInputs(userId: number, basketId: number, excludeSending: boolean): Promise<number>;
13448
+ async findOutputsByIds(outputIds: number[], trx?: TrxToken): Promise<Record<number, TableOutput>>
13449
+ async findOutputsByOutpoints(userId: number, outpoints: Array<{
13450
+ txid: string;
13451
+ vout: number;
13452
+ }>, trx?: TrxToken): Promise<Record<string, TableOutput>>
13453
+ async findOrInsertOutputBasketsBulk(userId: number, names: string[], trx?: TrxToken): Promise<Record<string, TableOutputBasket>>
13454
+ async findOrInsertOutputTagsBulk(userId: number, tags: string[], trx?: TrxToken): Promise<Record<string, TableOutputTag>>
13455
+ async sumSpendableSatoshisInBasket(userId: number, basketId: number, excludeSending: boolean, trx?: TrxToken): Promise<number>
13186
13456
  abstract findCertificatesAuth(auth: AuthId, args: FindCertificatesArgs): Promise<TableCertificateX[]>;
13187
13457
  abstract findOutputBasketsAuth(auth: AuthId, args: FindOutputBasketsArgs): Promise<TableOutputBasket[]>;
13188
13458
  abstract findOutputsAuth(auth: AuthId, args: FindOutputsArgs): Promise<TableOutput[]>;
@@ -13653,6 +13923,25 @@ See also: [Monitor](./monitor.md#class-monitor), [WalletMonitorTask](./monitor.m
13653
13923
 
13654
13924
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
13655
13925
 
13926
+ ---
13927
+ ##### Class: TaskMineBlock
13928
+
13929
+ ```ts
13930
+ export class TaskMineBlock extends WalletMonitorTask {
13931
+ static taskName = "MineBlock";
13932
+ static mineNow = false;
13933
+ constructor(monitor: Monitor, public triggerMsecs = 10 * Monitor.oneMinute)
13934
+ trigger(nowMsecsSinceEpoch: number): {
13935
+ run: boolean;
13936
+ }
13937
+ async runTask(): Promise<string>
13938
+ }
13939
+ ```
13940
+
13941
+ See also: [Monitor](./monitor.md#class-monitor), [WalletMonitorTask](./monitor.md#class-walletmonitortask)
13942
+
13943
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
13944
+
13656
13945
  ---
13657
13946
  ##### Class: TaskMonitorCallHistory
13658
13947
 
@@ -16108,52 +16397,54 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
16108
16397
 
16109
16398
  | | | |
16110
16399
  | --- | --- | --- |
16111
- | [WalletErrorFromJson](#function-walleterrorfromjson) | [getBeefForTransaction](#function-getbeeffortransaction) | [serializeBaseBlockHeaders](#function-serializebaseblockheaders) |
16112
- | [WocHeadersBulkListener](#function-wocheadersbulklistener) | [getBeefForTxid](#function-getbeeffortxid) | [setDisableDoubleSpendCheckForTest](#function-setdisabledoublespendcheckfortest) |
16113
- | [WocHeadersBulkListener_test](#function-wocheadersbulklistener_test) | [getExchangeRatesIo](#function-getexchangeratesio) | [sha256Hash](#function-sha256hash) |
16114
- | [WocHeadersLiveListener](#function-wocheaderslivelistener) | [getIdentityKey](#function-getidentitykey) | [sha256HashOfBinaryFile](#function-sha256hashofbinaryfile) |
16115
- | [WocHeadersLiveListener_test](#function-wocheaderslivelistener_test) | [getListOutputsSpecOp](#function-getlistoutputsspecop) | [shareReqsWithWorld](#function-sharereqswithworld) |
16116
- | [acquireDirectCertificate](#function-acquiredirectcertificate) | [getProofs](#function-getproofs) | [signAction](#function-signaction) |
16117
- | [addWork](#function-addwork) | [getSyncChunk](#function-getsyncchunk) | [stampLog](#function-stamplog) |
16118
- | [arcDefaultUrl](#function-arcdefaulturl) | [getWhatsOnChainBlockHeaderByHash](#function-getwhatsonchainblockheaderbyhash) | [stampLogFormat](#function-stamplogformat) |
16119
- | [arcGorillaPoolUrl](#function-arcgorillapoolurl) | [internalizeAction](#function-internalizeaction) | [subWork](#function-subwork) |
16120
- | [arraysEqual](#function-arraysequal) | [internalizeAction](#function-internalizeaction) | [swapByteOrder](#function-swapbyteorder) |
16121
- | [asArray](#function-asarray) | [isBaseBlockHeader](#function-isbaseblockheader) | [throwDummyReviewActions](#function-throwdummyreviewactions) |
16122
- | [asBsvSdkPrivateKey](#function-asbsvsdkprivatekey) | [isBlockHeader](#function-isblockheader) | [toBinaryBaseBlockHeader](#function-tobinarybaseblockheader) |
16123
- | [asBsvSdkPublickKey](#function-asbsvsdkpublickkey) | [isCreateActionSpecOp](#function-iscreateactionspecop) | [toWalletNetwork](#function-towalletnetwork) |
16124
- | [asBsvSdkScript](#function-asbsvsdkscript) | [isKnownValidBulkHeaderFile](#function-isknownvalidbulkheaderfile) | [transactionInputSize](#function-transactioninputsize) |
16125
- | [asBsvSdkTx](#function-asbsvsdktx) | [isListActionsSpecOp](#function-islistactionsspecop) | [transactionOutputSize](#function-transactionoutputsize) |
16126
- | [asString](#function-asstring) | [isListOutputsSpecOp](#function-islistoutputsspecop) | [transactionSize](#function-transactionsize) |
16127
- | [asUint8Array](#function-asuint8array) | [isLive](#function-islive) | [updateChaintracksFiatExchangeRates](#function-updatechaintracksfiatexchangerates) |
16128
- | [attemptToPostReqsToNetwork](#function-attempttopostreqstonetwork) | [isLiveBlockHeader](#function-isliveblockheader) | [updateExchangeratesapi](#function-updateexchangeratesapi) |
16129
- | [blockHash](#function-blockhash) | [isMoreWork](#function-ismorework) | [validBulkHeaderFilesByFileHash](#function-validbulkheaderfilesbyfilehash) |
16130
- | [buildSignableTransaction](#function-buildsignabletransaction) | [keyOffsetToHashedSecret](#function-keyoffsettohashedsecret) | [validateAgainstDirtyHashes](#function-validateagainstdirtyhashes) |
16131
- | [completeSignedTransaction](#function-completesignedtransaction) | [listActionsIdb](#function-listactionsidb) | [validateBufferOfHeaders](#function-validatebufferofheaders) |
16132
- | [convertBitsToTarget](#function-convertbitstotarget) | [listCertificates](#function-listcertificates) | [validateBulkFileData](#function-validatebulkfiledata) |
16133
- | [convertBitsToWork](#function-convertbitstowork) | [listOutputsIdb](#function-listoutputsidb) | [validateGenerateChangeSdkParams](#function-validategeneratechangesdkparams) |
16134
- | [convertBufferToUint32](#function-convertbuffertouint32) | [lockScriptWithKeyOffsetFromPubKey](#function-lockscriptwithkeyoffsetfrompubkey) | [validateGenerateChangeSdkResult](#function-validategeneratechangesdkresult) |
16135
- | [convertProofToMerklePath](#function-convertprooftomerklepath) | [logCreateActionArgs](#function-logcreateactionargs) | [validateGenesisHeader](#function-validategenesisheader) |
16136
- | [convertUint32ToBuffer](#function-convertuint32tobuffer) | [logWalletError](#function-logwalleterror) | [validateHeaderDifficulty](#function-validateheaderdifficulty) |
16137
- | [convertWocToBlockHeaderHex](#function-convertwoctoblockheaderhex) | [makeAtomicBeef](#function-makeatomicbeef) | [validateHeaderFormat](#function-validateheaderformat) |
16400
+ | [WalletErrorFromJson](#function-walleterrorfromjson) | [genesisHeader](#function-genesisheader) | [serializeBaseBlockHeader](#function-serializebaseblockheader) |
16401
+ | [WocHeadersBulkListener](#function-wocheadersbulklistener) | [getBeefForTransaction](#function-getbeeffortransaction) | [serializeBaseBlockHeaders](#function-serializebaseblockheaders) |
16402
+ | [WocHeadersBulkListener_test](#function-wocheadersbulklistener_test) | [getBeefForTxid](#function-getbeeffortxid) | [setDisableDoubleSpendCheckForTest](#function-setdisabledoublespendcheckfortest) |
16403
+ | [WocHeadersLiveListener](#function-wocheaderslivelistener) | [getExchangeRatesIo](#function-getexchangeratesio) | [sha256Hash](#function-sha256hash) |
16404
+ | [WocHeadersLiveListener_test](#function-wocheaderslivelistener_test) | [getIdentityKey](#function-getidentitykey) | [sha256HashOfBinaryFile](#function-sha256hashofbinaryfile) |
16405
+ | [acquireDirectCertificate](#function-acquiredirectcertificate) | [getListOutputsSpecOp](#function-getlistoutputsspecop) | [shareReqsWithWorld](#function-sharereqswithworld) |
16406
+ | [addWork](#function-addwork) | [getProofs](#function-getproofs) | [signAction](#function-signaction) |
16407
+ | [arcDefaultUrl](#function-arcdefaulturl) | [getSyncChunk](#function-getsyncchunk) | [stampLog](#function-stamplog) |
16408
+ | [arcGorillaPoolUrl](#function-arcgorillapoolurl) | [getWhatsOnChainBlockHeaderByHash](#function-getwhatsonchainblockheaderbyhash) | [stampLogFormat](#function-stamplogformat) |
16409
+ | [arraysEqual](#function-arraysequal) | [internalizeAction](#function-internalizeaction) | [subWork](#function-subwork) |
16410
+ | [asArray](#function-asarray) | [internalizeAction](#function-internalizeaction) | [swapByteOrder](#function-swapbyteorder) |
16411
+ | [asBsvSdkPrivateKey](#function-asbsvsdkprivatekey) | [isBaseBlockHeader](#function-isbaseblockheader) | [throwDummyReviewActions](#function-throwdummyreviewactions) |
16412
+ | [asBsvSdkPublickKey](#function-asbsvsdkpublickkey) | [isBlockHeader](#function-isblockheader) | [toBinaryBaseBlockHeader](#function-tobinarybaseblockheader) |
16413
+ | [asBsvSdkScript](#function-asbsvsdkscript) | [isCreateActionSpecOp](#function-iscreateactionspecop) | [toLookupNetworkPreset](#function-tolookupnetworkpreset) |
16414
+ | [asBsvSdkTx](#function-asbsvsdktx) | [isKnownValidBulkHeaderFile](#function-isknownvalidbulkheaderfile) | [toWalletNetwork](#function-towalletnetwork) |
16415
+ | [asString](#function-asstring) | [isListActionsSpecOp](#function-islistactionsspecop) | [transactionInputSize](#function-transactioninputsize) |
16416
+ | [asUint8Array](#function-asuint8array) | [isListOutputsSpecOp](#function-islistoutputsspecop) | [transactionOutputSize](#function-transactionoutputsize) |
16417
+ | [attemptToPostReqsToNetwork](#function-attempttopostreqstonetwork) | [isLive](#function-islive) | [transactionSize](#function-transactionsize) |
16418
+ | [blockHash](#function-blockhash) | [isLiveBlockHeader](#function-isliveblockheader) | [updateChaintracksFiatExchangeRates](#function-updatechaintracksfiatexchangerates) |
16419
+ | [buildSignableTransaction](#function-buildsignabletransaction) | [isMoreWork](#function-ismorework) | [updateExchangeratesapi](#function-updateexchangeratesapi) |
16420
+ | [completeSignedTransaction](#function-completesignedtransaction) | [keyOffsetToHashedSecret](#function-keyoffsettohashedsecret) | [validBulkHeaderFilesByFileHash](#function-validbulkheaderfilesbyfilehash) |
16421
+ | [computeMerklePath](#function-computemerklepath) | [listActionsIdb](#function-listactionsidb) | [validateAgainstDirtyHashes](#function-validateagainstdirtyhashes) |
16422
+ | [computeMerkleRoot](#function-computemerkleroot) | [listCertificates](#function-listcertificates) | [validateBufferOfHeaders](#function-validatebufferofheaders) |
16423
+ | [convertBitsToTarget](#function-convertbitstotarget) | [listOutputsIdb](#function-listoutputsidb) | [validateBulkFileData](#function-validatebulkfiledata) |
16424
+ | [convertBitsToWork](#function-convertbitstowork) | [lockScriptWithKeyOffsetFromPubKey](#function-lockscriptwithkeyoffsetfrompubkey) | [validateGenerateChangeSdkParams](#function-validategeneratechangesdkparams) |
16425
+ | [convertBufferToUint32](#function-convertbuffertouint32) | [logCreateActionArgs](#function-logcreateactionargs) | [validateGenerateChangeSdkResult](#function-validategeneratechangesdkresult) |
16426
+ | [convertProofToMerklePath](#function-convertprooftomerklepath) | [logWalletError](#function-logwalleterror) | [validateGenesisHeader](#function-validategenesisheader) |
16427
+ | [convertUint32ToBuffer](#function-convertuint32tobuffer) | [makeAtomicBeef](#function-makeatomicbeef) | [validateHeaderDifficulty](#function-validateheaderdifficulty) |
16428
+ | [convertWocToBlockHeaderHex](#function-convertwoctoblockheaderhex) | [makeBrc114ActionTimeLabel](#function-makebrc114actiontimelabel) | [validateHeaderFormat](#function-validateheaderformat) |
16138
16429
  | [createAction](#function-createaction) | [makeChangeLock](#function-makechangelock) | [validateScriptHash](#function-validatescripthash) |
16139
16430
  | [createAction](#function-createaction) | [maxDate](#function-maxdate) | [validateSecondsSinceEpoch](#function-validatesecondssinceepoch) |
16140
- | [createDefaultIdbChaintracksOptions](#function-createdefaultidbchaintracksoptions) | [offsetPrivKey](#function-offsetprivkey) | [validateStorageFeeModel](#function-validatestoragefeemodel) |
16141
- | [createDefaultNoDbChaintracksOptions](#function-createdefaultnodbchaintracksoptions) | [offsetPubKey](#function-offsetpubkey) | [varUintSize](#function-varuintsize) |
16142
- | [createDefaultWalletServicesOptions](#function-createdefaultwalletservicesoptions) | [optionalArraysEqual](#function-optionalarraysequal) | [verifyHexString](#function-verifyhexstring) |
16143
- | [createIdbChaintracks](#function-createidbchaintracks) | [parseTxScriptOffsets](#function-parsetxscriptoffsets) | [verifyId](#function-verifyid) |
16144
- | [createNoDbChaintracks](#function-createnodbchaintracks) | [processAction](#function-processaction) | [verifyInteger](#function-verifyinteger) |
16145
- | [createStorageServiceChargeScript](#function-createstorageservicechargescript) | [processAction](#function-processaction) | [verifyNumber](#function-verifynumber) |
16146
- | [createSyncMap](#function-createsyncmap) | [proveCertificate](#function-provecertificate) | [verifyOne](#function-verifyone) |
16147
- | [deserializeBaseBlockHeader](#function-deserializebaseblockheader) | [purgeDataIdb](#function-purgedataidb) | [verifyOneOrNone](#function-verifyoneornone) |
16148
- | [deserializeBaseBlockHeaders](#function-deserializebaseblockheaders) | [randomBytes](#function-randombytes) | [verifyOptionalHexString](#function-verifyoptionalhexstring) |
16149
- | [deserializeBlockHeader](#function-deserializeblockheader) | [randomBytesBase64](#function-randombytesbase64) | [verifyTruthy](#function-verifytruthy) |
16150
- | [deserializeBlockHeaders](#function-deserializeblockheaders) | [randomBytesHex](#function-randombyteshex) | [verifyUnlockScripts](#function-verifyunlockscripts) |
16151
- | [doubleSha256BE](#function-doublesha256be) | [readUInt32BE](#function-readuint32be) | [wait](#function-wait) |
16152
- | [doubleSha256LE](#function-doublesha256le) | [readUInt32LE](#function-readuint32le) | [wocGetHeadersHeaderToBlockHeader](#function-wocgetheadersheadertoblockheader) |
16153
- | [generateChangeSdk](#function-generatechangesdk) | [redeemServiceCharges](#function-redeemservicecharges) | [workBNtoBuffer](#function-workbntobuffer) |
16154
- | [generateChangeSdkMakeStorage](#function-generatechangesdkmakestorage) | [reviewStatusIdb](#function-reviewstatusidb) | [writeUInt32BE](#function-writeuint32be) |
16155
- | [genesisBuffer](#function-genesisbuffer) | [selectBulkHeaderFiles](#function-selectbulkheaderfiles) | [writeUInt32LE](#function-writeuint32le) |
16156
- | [genesisHeader](#function-genesisheader) | [serializeBaseBlockHeader](#function-serializebaseblockheader) | |
16431
+ | [createCoinbaseTransaction](#function-createcoinbasetransaction) | [offsetPrivKey](#function-offsetprivkey) | [validateStorageFeeModel](#function-validatestoragefeemodel) |
16432
+ | [createDefaultIdbChaintracksOptions](#function-createdefaultidbchaintracksoptions) | [offsetPubKey](#function-offsetpubkey) | [varUintSize](#function-varuintsize) |
16433
+ | [createDefaultNoDbChaintracksOptions](#function-createdefaultnodbchaintracksoptions) | [optionalArraysEqual](#function-optionalarraysequal) | [verifyHexString](#function-verifyhexstring) |
16434
+ | [createDefaultWalletServicesOptions](#function-createdefaultwalletservicesoptions) | [parseBrc114ActionTimeLabels](#function-parsebrc114actiontimelabels) | [verifyId](#function-verifyid) |
16435
+ | [createIdbChaintracks](#function-createidbchaintracks) | [parseTxScriptOffsets](#function-parsetxscriptoffsets) | [verifyInteger](#function-verifyinteger) |
16436
+ | [createNoDbChaintracks](#function-createnodbchaintracks) | [processAction](#function-processaction) | [verifyNumber](#function-verifynumber) |
16437
+ | [createStorageServiceChargeScript](#function-createstorageservicechargescript) | [processAction](#function-processaction) | [verifyOne](#function-verifyone) |
16438
+ | [createSyncMap](#function-createsyncmap) | [proveCertificate](#function-provecertificate) | [verifyOneOrNone](#function-verifyoneornone) |
16439
+ | [deserializeBaseBlockHeader](#function-deserializebaseblockheader) | [purgeDataIdb](#function-purgedataidb) | [verifyOptionalHexString](#function-verifyoptionalhexstring) |
16440
+ | [deserializeBaseBlockHeaders](#function-deserializebaseblockheaders) | [randomBytes](#function-randombytes) | [verifyTruthy](#function-verifytruthy) |
16441
+ | [deserializeBlockHeader](#function-deserializeblockheader) | [randomBytesBase64](#function-randombytesbase64) | [verifyUnlockScripts](#function-verifyunlockscripts) |
16442
+ | [deserializeBlockHeaders](#function-deserializeblockheaders) | [randomBytesHex](#function-randombyteshex) | [wait](#function-wait) |
16443
+ | [doubleSha256BE](#function-doublesha256be) | [readUInt32BE](#function-readuint32be) | [wocGetHeadersHeaderToBlockHeader](#function-wocgetheadersheadertoblockheader) |
16444
+ | [doubleSha256LE](#function-doublesha256le) | [readUInt32LE](#function-readuint32le) | [workBNtoBuffer](#function-workbntobuffer) |
16445
+ | [generateChangeSdk](#function-generatechangesdk) | [redeemServiceCharges](#function-redeemservicecharges) | [writeUInt32BE](#function-writeuint32be) |
16446
+ | [generateChangeSdkMakeStorage](#function-generatechangesdkmakestorage) | [reviewStatusIdb](#function-reviewstatusidb) | [writeUInt32LE](#function-writeuint32le) |
16447
+ | [genesisBuffer](#function-genesisbuffer) | [selectBulkHeaderFiles](#function-selectbulkheaderfiles) | |
16157
16448
 
16158
16449
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
16159
16450
 
@@ -16568,6 +16859,31 @@ See also: [PendingSignAction](./client.md#interface-pendingsignaction), [Wallet]
16568
16859
 
16569
16860
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
16570
16861
 
16862
+ ---
16863
+ ##### Function: computeMerklePath
16864
+
16865
+ Compute the MerklePath for a target transaction at `targetIndex` within a block at `blockHeight`.
16866
+ `txids` is the ordered list of all txids in the block (big-endian hex).
16867
+
16868
+ ```ts
16869
+ export function computeMerklePath(txids: string[], targetIndex: number, blockHeight: number): MerklePath
16870
+ ```
16871
+
16872
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
16873
+
16874
+ ---
16875
+ ##### Function: computeMerkleRoot
16876
+
16877
+ Compute the merkle root from an array of txids (big-endian hex strings).
16878
+ Returns the root as a big-endian hex string (reversed byte order from the
16879
+ natural double-SHA256 result, matching the standard block header format).
16880
+
16881
+ ```ts
16882
+ export function computeMerkleRoot(txids: string[]): string
16883
+ ```
16884
+
16885
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
16886
+
16571
16887
  ---
16572
16888
  ##### Function: convertBitsToTarget
16573
16889
 
@@ -16704,6 +17020,18 @@ See also: [AuthId](./client.md#interface-authid), [StorageCreateActionResult](./
16704
17020
 
16705
17021
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
16706
17022
 
17023
+ ---
17024
+ ##### Function: createCoinbaseTransaction
17025
+
17026
+ Creates a coinbase transaction for the given block height.
17027
+ Uses OP_TRUE (0x51) as the output script so anyone can spend it.
17028
+
17029
+ ```ts
17030
+ export function createCoinbaseTransaction(height: number): Transaction
17031
+ ```
17032
+
17033
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
17034
+
16707
17035
  ---
16708
17036
  ##### Function: createDefaultIdbChaintracksOptions
16709
17037
 
@@ -16960,27 +17288,33 @@ Returns the genesis block for the specified chain.
16960
17288
 
16961
17289
  ```ts
16962
17290
  export function genesisHeader(chain: Chain): BlockHeader {
16963
- return chain === "main"
16964
- ? {
16965
- version: 1,
16966
- previousHash: "0000000000000000000000000000000000000000000000000000000000000000",
16967
- merkleRoot: "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
16968
- time: 1231006505,
16969
- bits: 486604799,
16970
- nonce: 2083236893,
16971
- height: 0,
16972
- hash: "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f"
16973
- }
16974
- : {
16975
- version: 1,
16976
- previousHash: "0000000000000000000000000000000000000000000000000000000000000000",
16977
- merkleRoot: "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
16978
- time: 1296688602,
16979
- bits: 486604799,
16980
- nonce: 414098458,
16981
- height: 0,
16982
- hash: "000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943"
16983
- };
17291
+ switch (chain) {
17292
+ case "main":
17293
+ return {
17294
+ version: 1,
17295
+ previousHash: "0000000000000000000000000000000000000000000000000000000000000000",
17296
+ merkleRoot: "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
17297
+ time: 1231006505,
17298
+ bits: 486604799,
17299
+ nonce: 2083236893,
17300
+ height: 0,
17301
+ hash: "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f"
17302
+ };
17303
+ case "test":
17304
+ case "teratest":
17305
+ return {
17306
+ version: 1,
17307
+ previousHash: "0000000000000000000000000000000000000000000000000000000000000000",
17308
+ merkleRoot: "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
17309
+ time: 1296688602,
17310
+ bits: 486604799,
17311
+ nonce: 414098458,
17312
+ height: 0,
17313
+ hash: "000000000933ea01ad0ee984209779baaec3ced90fa3f408719526f8d77f4943"
17314
+ };
17315
+ case "mock":
17316
+ throw new Error(`genesisHeader does not support 'mock' chain. Mock chain generates its own genesis block.`);
17317
+ }
16984
17318
  }
16985
17319
  ```
16986
17320
 
@@ -17454,6 +17788,15 @@ export function makeAtomicBeef(tx: Transaction, beef: number[] | Beef): number[]
17454
17788
 
17455
17789
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
17456
17790
 
17791
+ ---
17792
+ ##### Function: makeBrc114ActionTimeLabel
17793
+
17794
+ ```ts
17795
+ export function makeBrc114ActionTimeLabel(unixMillis: number): string
17796
+ ```
17797
+
17798
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
17799
+
17457
17800
  ---
17458
17801
  ##### Function: makeChangeLock
17459
17802
 
@@ -17509,6 +17852,17 @@ export function optionalArraysEqual(arr1?: Number[], arr2?: Number[])
17509
17852
 
17510
17853
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
17511
17854
 
17855
+ ---
17856
+ ##### Function: parseBrc114ActionTimeLabels
17857
+
17858
+ ```ts
17859
+ export function parseBrc114ActionTimeLabels(labels: string[] | undefined): ParsedBrc114ActionTimeLabels
17860
+ ```
17861
+
17862
+ See also: [ParsedBrc114ActionTimeLabels](./client.md#type-parsedbrc114actiontimelabels)
17863
+
17864
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
17865
+
17512
17866
  ---
17513
17867
  ##### Function: parseTxScriptOffsets
17514
17868
 
@@ -17927,6 +18281,20 @@ Returns
17927
18281
 
17928
18282
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
17929
18283
 
18284
+ ---
18285
+ ##### Function: toLookupNetworkPreset
18286
+
18287
+ Maps a Chain to a network preset suitable for LookupResolver / SHIPBroadcaster.
18288
+ Unlike `toWalletNetwork`, this returns `'local'` for `mock` chain.
18289
+
18290
+ ```ts
18291
+ export function toLookupNetworkPreset(chain: Chain): "mainnet" | "testnet" | "local"
18292
+ ```
18293
+
18294
+ See also: [Chain](./client.md#type-chain)
18295
+
18296
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
18297
+
17930
18298
  ---
17931
18299
  ##### Function: toWalletNetwork
17932
18300
 
@@ -18454,18 +18822,18 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
18454
18822
 
18455
18823
  | | | |
18456
18824
  | --- | --- | --- |
18457
- | [Chain](#type-chain) | [GetUtxoStatusService](#type-getutxostatusservice) | [ReviewActionResultStatus](#type-reviewactionresultstatus) |
18458
- | [CounterpartyPermissionEventHandler](#type-counterpartypermissioneventhandler) | [GroupedPermissionEventHandler](#type-groupedpermissioneventhandler) | [ScriptHashFormat](#type-scripthashformat) |
18459
- | [DBType](#type-dbtype) | [HeaderListener](#type-headerlistener) | [ServicesCallHistory](#type-servicescallhistory) |
18460
- | [EnqueueHandler](#type-enqueuehandler) | [InsertHeaderResult](#type-insertheaderresult) | [StopListenerToken](#type-stoplistenertoken) |
18461
- | [EntityStorage](#type-entitystorage) | [MonitorStorage](#type-monitorstorage) | [StorageProvidedBy](#type-storageprovidedby) |
18462
- | [ErrorHandler](#type-errorhandler) | [PermissionEventHandler](#type-permissioneventhandler) | [SyncProtocolVersion](#type-syncprotocolversion) |
18463
- | [FiatCurrencyCode](#type-fiatcurrencycode) | [PostBeefService](#type-postbeefservice) | [SyncStatus](#type-syncstatus) |
18464
- | [GetMerklePathService](#type-getmerklepathservice) | [PostReqsToNetworkDetailsStatus](#type-postreqstonetworkdetailsstatus) | [TransactionStatus](#type-transactionstatus) |
18465
- | [GetRawTxService](#type-getrawtxservice) | [PostTxsService](#type-posttxsservice) | [UpdateFiatExchangeRateService](#type-updatefiatexchangerateservice) |
18466
- | [GetScriptHashHistoryService](#type-getscripthashhistoryservice) | [ProvenTxReqStatus](#type-proventxreqstatus) | [WalletLoggerLevel](#type-walletloggerlevel) |
18467
- | [GetStatusForTxidsService](#type-getstatusfortxidsservice) | [ReorgListener](#type-reorglistener) | |
18468
- | [GetUtxoStatusOutputFormat](#type-getutxostatusoutputformat) | [ReqHistoryNote](#type-reqhistorynote) | |
18825
+ | [Chain](#type-chain) | [GetUtxoStatusService](#type-getutxostatusservice) | [ReqHistoryNote](#type-reqhistorynote) |
18826
+ | [CounterpartyPermissionEventHandler](#type-counterpartypermissioneventhandler) | [GroupedPermissionEventHandler](#type-groupedpermissioneventhandler) | [ReviewActionResultStatus](#type-reviewactionresultstatus) |
18827
+ | [DBType](#type-dbtype) | [HeaderListener](#type-headerlistener) | [ScriptHashFormat](#type-scripthashformat) |
18828
+ | [EnqueueHandler](#type-enqueuehandler) | [InsertHeaderResult](#type-insertheaderresult) | [ServicesCallHistory](#type-servicescallhistory) |
18829
+ | [EntityStorage](#type-entitystorage) | [MonitorStorage](#type-monitorstorage) | [StopListenerToken](#type-stoplistenertoken) |
18830
+ | [ErrorHandler](#type-errorhandler) | [ParsedBrc114ActionTimeLabels](#type-parsedbrc114actiontimelabels) | [StorageProvidedBy](#type-storageprovidedby) |
18831
+ | [FiatCurrencyCode](#type-fiatcurrencycode) | [PermissionEventHandler](#type-permissioneventhandler) | [SyncProtocolVersion](#type-syncprotocolversion) |
18832
+ | [GetMerklePathService](#type-getmerklepathservice) | [PostBeefService](#type-postbeefservice) | [SyncStatus](#type-syncstatus) |
18833
+ | [GetRawTxService](#type-getrawtxservice) | [PostReqsToNetworkDetailsStatus](#type-postreqstonetworkdetailsstatus) | [TransactionStatus](#type-transactionstatus) |
18834
+ | [GetScriptHashHistoryService](#type-getscripthashhistoryservice) | [PostTxsService](#type-posttxsservice) | [UpdateFiatExchangeRateService](#type-updatefiatexchangerateservice) |
18835
+ | [GetStatusForTxidsService](#type-getstatusfortxidsservice) | [ProvenTxReqStatus](#type-proventxreqstatus) | [WalletLoggerLevel](#type-walletloggerlevel) |
18836
+ | [GetUtxoStatusOutputFormat](#type-getutxostatusoutputformat) | [ReorgListener](#type-reorglistener) | |
18469
18837
 
18470
18838
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
18471
18839
 
@@ -18474,7 +18842,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
18474
18842
  ##### Type: Chain
18475
18843
 
18476
18844
  ```ts
18477
- export type Chain = "main" | "test"
18845
+ export type Chain = "main" | "test" | "teratest" | "mock"
18478
18846
  ```
18479
18847
 
18480
18848
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
@@ -18662,6 +19030,20 @@ See also: [WalletStorageManager](./storage.md#class-walletstoragemanager)
18662
19030
 
18663
19031
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
18664
19032
 
19033
+ ---
19034
+ ##### Type: ParsedBrc114ActionTimeLabels
19035
+
19036
+ ```ts
19037
+ export type ParsedBrc114ActionTimeLabels = {
19038
+ from?: number;
19039
+ to?: number;
19040
+ timeFilterRequested: boolean;
19041
+ remainingLabels: string[];
19042
+ }
19043
+ ```
19044
+
19045
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
19046
+
18665
19047
  ---
18666
19048
  ##### Type: PermissionEventHandler
18667
19049