@bsv/wallet-toolbox 1.6.33 → 1.6.34
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +7 -0
- package/docs/client.md +340 -93
- package/docs/monitor.md +34 -12
- package/docs/storage.md +49 -1
- package/docs/wallet.md +340 -93
- package/mobile/out/src/monitor/tasks/TaskReorg.d.ts.map +1 -1
- package/mobile/out/src/monitor/tasks/TaskReorg.js +5 -1
- package/mobile/out/src/monitor/tasks/TaskReorg.js.map +1 -1
- package/mobile/out/src/sdk/WERR_errors.d.ts +8 -0
- package/mobile/out/src/sdk/WERR_errors.d.ts.map +1 -1
- package/mobile/out/src/sdk/WERR_errors.js +33 -0
- package/mobile/out/src/sdk/WERR_errors.js.map +1 -1
- package/mobile/out/src/sdk/WalletError.d.ts +19 -0
- package/mobile/out/src/sdk/WalletError.d.ts.map +1 -1
- package/mobile/out/src/sdk/WalletError.js +42 -1
- package/mobile/out/src/sdk/WalletError.js.map +1 -1
- package/mobile/out/src/sdk/WalletErrorFromJson.d.ts +12 -0
- package/mobile/out/src/sdk/WalletErrorFromJson.d.ts.map +1 -0
- package/mobile/out/src/sdk/WalletErrorFromJson.js +69 -0
- package/mobile/out/src/sdk/WalletErrorFromJson.js.map +1 -0
- package/mobile/out/src/sdk/index.d.ts +1 -0
- package/mobile/out/src/sdk/index.d.ts.map +1 -1
- package/mobile/out/src/sdk/index.js +1 -0
- package/mobile/out/src/sdk/index.js.map +1 -1
- package/mobile/out/src/services/chaintracker/ChaintracksChainTracker.js +1 -1
- package/mobile/out/src/services/chaintracker/ChaintracksChainTracker.js.map +1 -1
- package/mobile/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.d.ts.map +1 -1
- package/mobile/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.js +16 -9
- package/mobile/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.js.map +1 -1
- package/mobile/out/src/storage/WalletStorageManager.d.ts.map +1 -1
- package/mobile/out/src/storage/WalletStorageManager.js.map +1 -1
- package/mobile/out/src/storage/remoting/StorageClient.d.ts.map +1 -1
- package/mobile/out/src/storage/remoting/StorageClient.js +3 -5
- package/mobile/out/src/storage/remoting/StorageClient.js.map +1 -1
- package/mobile/package-lock.json +2 -2
- package/mobile/package.json +1 -1
- package/out/src/monitor/tasks/TaskReorg.d.ts.map +1 -1
- package/out/src/monitor/tasks/TaskReorg.js +5 -1
- package/out/src/monitor/tasks/TaskReorg.js.map +1 -1
- package/out/src/sdk/WERR_errors.d.ts +8 -0
- package/out/src/sdk/WERR_errors.d.ts.map +1 -1
- package/out/src/sdk/WERR_errors.js +33 -0
- package/out/src/sdk/WERR_errors.js.map +1 -1
- package/out/src/sdk/WalletError.d.ts +19 -0
- package/out/src/sdk/WalletError.d.ts.map +1 -1
- package/out/src/sdk/WalletError.js +42 -1
- package/out/src/sdk/WalletError.js.map +1 -1
- package/out/src/sdk/WalletErrorFromJson.d.ts +12 -0
- package/out/src/sdk/WalletErrorFromJson.d.ts.map +1 -0
- package/out/src/sdk/WalletErrorFromJson.js +69 -0
- package/out/src/sdk/WalletErrorFromJson.js.map +1 -0
- package/out/src/sdk/__test/WalletError.test.d.ts +2 -0
- package/out/src/sdk/__test/WalletError.test.d.ts.map +1 -0
- package/out/src/sdk/__test/WalletError.test.js +255 -0
- package/out/src/sdk/__test/WalletError.test.js.map +1 -0
- package/out/src/sdk/index.d.ts +1 -0
- package/out/src/sdk/index.d.ts.map +1 -1
- package/out/src/sdk/index.js +1 -0
- package/out/src/sdk/index.js.map +1 -1
- package/out/src/services/__tests/verifyBeef.test.js.map +1 -1
- package/out/src/services/chaintracker/ChaintracksChainTracker.js +1 -1
- package/out/src/services/chaintracker/ChaintracksChainTracker.js.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.d.ts.map +1 -1
- package/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.js +16 -9
- package/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.js.map +1 -1
- package/out/src/storage/WalletStorageManager.d.ts.map +1 -1
- package/out/src/storage/WalletStorageManager.js.map +1 -1
- package/out/src/storage/remoting/StorageClient.d.ts.map +1 -1
- package/out/src/storage/remoting/StorageClient.js +3 -5
- package/out/src/storage/remoting/StorageClient.js.map +1 -1
- package/out/src/storage/remoting/StorageServer.d.ts.map +1 -1
- package/out/src/storage/remoting/StorageServer.js +12 -10
- package/out/src/storage/remoting/StorageServer.js.map +1 -1
- package/out/test/Wallet/specOps/specOps.man.test.js +8 -6
- package/out/test/Wallet/specOps/specOps.man.test.js.map +1 -1
- package/out/tsconfig.all.tsbuildinfo +1 -1
- package/package.json +1 -1
- package/src/monitor/tasks/TaskReorg.ts +5 -1
- package/src/sdk/WERR_errors.ts +34 -0
- package/src/sdk/WalletError.ts +42 -1
- package/src/sdk/WalletErrorFromJson.ts +80 -0
- package/src/sdk/WalletStorage.interfaces.ts +3 -3
- package/src/sdk/__test/WalletError.test.ts +318 -0
- package/src/sdk/index.ts +1 -0
- package/src/services/__tests/verifyBeef.test.ts +0 -1
- package/src/services/chaintracker/ChaintracksChainTracker.ts +1 -1
- package/src/services/chaintracker/chaintracks/util/ChaintracksFetch.ts +18 -11
- package/src/storage/WalletStorageManager.ts +16 -19
- package/src/storage/methods/internalizeAction.ts +1 -1
- package/src/storage/remoting/StorageClient.ts +4 -6
- package/src/storage/remoting/StorageServer.ts +13 -11
- package/test/Wallet/specOps/specOps.man.test.ts +6 -4
package/docs/wallet.md
CHANGED
|
@@ -13,86 +13,87 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
13
13
|
|
|
14
14
|
| | | |
|
|
15
15
|
| --- | --- | --- |
|
|
16
|
-
| [AdminStatsResult](#interface-adminstatsresult) | [
|
|
17
|
-
| [ArcConfig](#interface-arcconfig) | [
|
|
18
|
-
| [ArcMinerGetTxData](#interface-arcminergettxdata) | [
|
|
19
|
-
| [AuthId](#interface-authid) | [
|
|
20
|
-
| [AuthPayload](#interface-authpayload) | [
|
|
21
|
-
| [BaseBlockHeader](#interface-baseblockheader) | [
|
|
22
|
-
| [BitailsConfig](#interface-bitailsconfig) | [
|
|
23
|
-
| [BitailsMerkleProof](#interface-bitailsmerkleproof) | [
|
|
24
|
-
| [BlockHeader](#interface-blockheader) | [
|
|
25
|
-
| [BsvExchangeRate](#interface-bsvexchangerate) | [
|
|
26
|
-
| [BulkFileDataManagerMergeResult](#interface-bulkfiledatamanagermergeresult) | [
|
|
27
|
-
| [BulkFileDataManagerOptions](#interface-bulkfiledatamanageroptions) | [
|
|
28
|
-
| [BulkHeaderFileInfo](#interface-bulkheaderfileinfo) | [
|
|
29
|
-
| [BulkHeaderFilesInfo](#interface-bulkheaderfilesinfo) | [
|
|
30
|
-
| [BulkIngestorApi](#interface-bulkingestorapi) | [
|
|
31
|
-
| [BulkIngestorBaseOptions](#interface-bulkingestorbaseoptions) | [
|
|
32
|
-
| [BulkIngestorCDNOptions](#interface-bulkingestorcdnoptions) | [
|
|
33
|
-
| [BulkIngestorWhatsOnChainOptions](#interface-bulkingestorwhatsonchainoptions) | [
|
|
34
|
-
| [BulkStorageApi](#interface-bulkstorageapi) | [
|
|
35
|
-
| [BulkStorageBaseOptions](#interface-bulkstoragebaseoptions) | [
|
|
36
|
-
| [BulkSyncResult](#interface-bulksyncresult) | [
|
|
37
|
-
| [CertOpsWallet](#interface-certopswallet) | [
|
|
38
|
-
| [Certifier](#interface-certifier) | [
|
|
39
|
-
| [ChaintracksApi](#interface-chaintracksapi) | [
|
|
40
|
-
| [ChaintracksAppendableFileApi](#interface-chaintracksappendablefileapi) | [
|
|
41
|
-
| [ChaintracksChainTrackerOptions](#interface-chaintrackschaintrackeroptions) | [
|
|
42
|
-
| [ChaintracksClientApi](#interface-chaintracksclientapi) | [
|
|
43
|
-
| [ChaintracksFetchApi](#interface-chaintracksfetchapi) | [
|
|
44
|
-
| [ChaintracksFsApi](#interface-chaintracksfsapi) | [
|
|
45
|
-
| [ChaintracksInfoApi](#interface-chaintracksinfoapi) | [
|
|
46
|
-
| [ChaintracksManagementApi](#interface-chaintracksmanagementapi) | [
|
|
47
|
-
| [ChaintracksOptions](#interface-chaintracksoptions) | [
|
|
48
|
-
| [ChaintracksPackageInfoApi](#interface-chaintrackspackageinfoapi) | [
|
|
49
|
-
| [ChaintracksReadableFileApi](#interface-chaintracksreadablefileapi) | [
|
|
50
|
-
| [ChaintracksServiceClientOptions](#interface-chaintracksserviceclientoptions) | [
|
|
51
|
-
| [ChaintracksStorageApi](#interface-chaintracksstorageapi) | [
|
|
52
|
-
| [ChaintracksStorageBaseOptions](#interface-chaintracksstoragebaseoptions) | [
|
|
53
|
-
| [ChaintracksStorageBulkFileApi](#interface-chaintracksstoragebulkfileapi) | [
|
|
54
|
-
| [ChaintracksStorageIdbOptions](#interface-chaintracksstorageidboptions) | [
|
|
55
|
-
| [ChaintracksStorageIdbSchema](#interface-chaintracksstorageidbschema) | [
|
|
56
|
-
| [ChaintracksStorageIngestApi](#interface-chaintracksstorageingestapi) | [
|
|
57
|
-
| [ChaintracksStorageNoDbOptions](#interface-chaintracksstoragenodboptions) | [
|
|
58
|
-
| [ChaintracksStorageQueryApi](#interface-chaintracksstoragequeryapi) | [
|
|
59
|
-
| [ChaintracksWritableFileApi](#interface-chaintrackswritablefileapi) | [
|
|
60
|
-
| [CommitNewTxResults](#interface-commitnewtxresults) | [
|
|
61
|
-
| [CompleteAuthResponse](#interface-completeauthresponse) | [
|
|
62
|
-
| [CreateActionResultX](#interface-createactionresultx) | [
|
|
63
|
-
| [DeactivedHeader](#interface-deactivedheader) | [
|
|
64
|
-
| [EntitySyncMap](#interface-entitysyncmap) | [
|
|
65
|
-
| [EntityTimeStamp](#interface-entitytimestamp) | [
|
|
66
|
-
| [ExchangeRatesIoApi](#interface-exchangeratesioapi) | [
|
|
16
|
+
| [AdminStatsResult](#interface-adminstatsresult) | [GetReqsAndBeefDetail](#interface-getreqsandbeefdetail) | [StorageSyncReaderOptions](#interface-storagesyncreaderoptions) |
|
|
17
|
+
| [ArcConfig](#interface-arcconfig) | [GetReqsAndBeefResult](#interface-getreqsandbeefresult) | [SyncChunk](#interface-syncchunk) |
|
|
18
|
+
| [ArcMinerGetTxData](#interface-arcminergettxdata) | [GetScriptHashHistory](#interface-getscripthashhistory) | [SyncError](#interface-syncerror) |
|
|
19
|
+
| [AuthId](#interface-authid) | [GetScriptHashHistoryResult](#interface-getscripthashhistoryresult) | [SyncMap](#interface-syncmap) |
|
|
20
|
+
| [AuthPayload](#interface-authpayload) | [GetStatusForTxidsResult](#interface-getstatusfortxidsresult) | [TableCertificate](#interface-tablecertificate) |
|
|
21
|
+
| [BaseBlockHeader](#interface-baseblockheader) | [GetUtxoStatusDetails](#interface-getutxostatusdetails) | [TableCertificateField](#interface-tablecertificatefield) |
|
|
22
|
+
| [BitailsConfig](#interface-bitailsconfig) | [GetUtxoStatusResult](#interface-getutxostatusresult) | [TableCertificateX](#interface-tablecertificatex) |
|
|
23
|
+
| [BitailsMerkleProof](#interface-bitailsmerkleproof) | [GroupedPermissionRequest](#interface-groupedpermissionrequest) | [TableCommission](#interface-tablecommission) |
|
|
24
|
+
| [BlockHeader](#interface-blockheader) | [GroupedPermissions](#interface-groupedpermissions) | [TableMonitorEvent](#interface-tablemonitorevent) |
|
|
25
|
+
| [BsvExchangeRate](#interface-bsvexchangerate) | [HeightRangeApi](#interface-heightrangeapi) | [TableOutput](#interface-tableoutput) |
|
|
26
|
+
| [BulkFileDataManagerMergeResult](#interface-bulkfiledatamanagermergeresult) | [HeightRanges](#interface-heightranges) | [TableOutputBasket](#interface-tableoutputbasket) |
|
|
27
|
+
| [BulkFileDataManagerOptions](#interface-bulkfiledatamanageroptions) | [KeyPair](#interface-keypair) | [TableOutputTag](#interface-tableoutputtag) |
|
|
28
|
+
| [BulkHeaderFileInfo](#interface-bulkheaderfileinfo) | [KeyPairAddress](#interface-keypairaddress) | [TableOutputTagMap](#interface-tableoutputtagmap) |
|
|
29
|
+
| [BulkHeaderFilesInfo](#interface-bulkheaderfilesinfo) | [ListActionsSpecOp](#interface-listactionsspecop) | [TableOutputX](#interface-tableoutputx) |
|
|
30
|
+
| [BulkIngestorApi](#interface-bulkingestorapi) | [ListOutputsSpecOp](#interface-listoutputsspecop) | [TableProvenTx](#interface-tableproventx) |
|
|
31
|
+
| [BulkIngestorBaseOptions](#interface-bulkingestorbaseoptions) | [LiveBlockHeader](#interface-liveblockheader) | [TableProvenTxReq](#interface-tableproventxreq) |
|
|
32
|
+
| [BulkIngestorCDNOptions](#interface-bulkingestorcdnoptions) | [LiveIngestorApi](#interface-liveingestorapi) | [TableProvenTxReqDynamics](#interface-tableproventxreqdynamics) |
|
|
33
|
+
| [BulkIngestorWhatsOnChainOptions](#interface-bulkingestorwhatsonchainoptions) | [LiveIngestorBaseOptions](#interface-liveingestorbaseoptions) | [TableSettings](#interface-tablesettings) |
|
|
34
|
+
| [BulkStorageApi](#interface-bulkstorageapi) | [LiveIngestorWhatsOnChainOptions](#interface-liveingestorwhatsonchainoptions) | [TableSyncState](#interface-tablesyncstate) |
|
|
35
|
+
| [BulkStorageBaseOptions](#interface-bulkstoragebaseoptions) | [MonitorOptions](#interface-monitoroptions) | [TableTransaction](#interface-tabletransaction) |
|
|
36
|
+
| [BulkSyncResult](#interface-bulksyncresult) | [OutPoint](#interface-outpoint) | [TableTxLabel](#interface-tabletxlabel) |
|
|
37
|
+
| [CertOpsWallet](#interface-certopswallet) | [Paged](#interface-paged) | [TableTxLabelMap](#interface-tabletxlabelmap) |
|
|
38
|
+
| [Certifier](#interface-certifier) | [PendingSignAction](#interface-pendingsignaction) | [TableUser](#interface-tableuser) |
|
|
39
|
+
| [ChaintracksApi](#interface-chaintracksapi) | [PendingStorageInput](#interface-pendingstorageinput) | [TaskPurgeParams](#interface-taskpurgeparams) |
|
|
40
|
+
| [ChaintracksAppendableFileApi](#interface-chaintracksappendablefileapi) | [PermissionRequest](#interface-permissionrequest) | [TrustSettings](#interface-trustsettings) |
|
|
41
|
+
| [ChaintracksChainTrackerOptions](#interface-chaintrackschaintrackeroptions) | [PermissionToken](#interface-permissiontoken) | [TrxToken](#interface-trxtoken) |
|
|
42
|
+
| [ChaintracksClientApi](#interface-chaintracksclientapi) | [PermissionsManagerConfig](#interface-permissionsmanagerconfig) | [TscMerkleProofApi](#interface-tscmerkleproofapi) |
|
|
43
|
+
| [ChaintracksFetchApi](#interface-chaintracksfetchapi) | [PostBeefResult](#interface-postbeefresult) | [TxScriptOffsets](#interface-txscriptoffsets) |
|
|
44
|
+
| [ChaintracksFsApi](#interface-chaintracksfsapi) | [PostBeefResultForTxidApi](#interface-postbeefresultfortxidapi) | [UMPToken](#interface-umptoken) |
|
|
45
|
+
| [ChaintracksInfoApi](#interface-chaintracksinfoapi) | [PostReqsToNetworkDetails](#interface-postreqstonetworkdetails) | [UMPTokenInteractor](#interface-umptokeninteractor) |
|
|
46
|
+
| [ChaintracksManagementApi](#interface-chaintracksmanagementapi) | [PostReqsToNetworkResult](#interface-postreqstonetworkresult) | [UpdateProvenTxReqWithNewProvenTxArgs](#interface-updateproventxreqwithnewproventxargs) |
|
|
47
|
+
| [ChaintracksOptions](#interface-chaintracksoptions) | [PostTxResultForTxid](#interface-posttxresultfortxid) | [UpdateProvenTxReqWithNewProvenTxResult](#interface-updateproventxreqwithnewproventxresult) |
|
|
48
|
+
| [ChaintracksPackageInfoApi](#interface-chaintrackspackageinfoapi) | [PostTxResultForTxidError](#interface-posttxresultfortxiderror) | [ValidAbortActionArgs](#interface-validabortactionargs) |
|
|
49
|
+
| [ChaintracksReadableFileApi](#interface-chaintracksreadablefileapi) | [PostTxsResult](#interface-posttxsresult) | [ValidAcquireCertificateArgs](#interface-validacquirecertificateargs) |
|
|
50
|
+
| [ChaintracksServiceClientOptions](#interface-chaintracksserviceclientoptions) | [ProcessSyncChunkResult](#interface-processsyncchunkresult) | [ValidAcquireDirectCertificateArgs](#interface-validacquiredirectcertificateargs) |
|
|
51
|
+
| [ChaintracksStorageApi](#interface-chaintracksstorageapi) | [Profile](#interface-profile) | [ValidAcquireIssuanceCertificateArgs](#interface-validacquireissuancecertificateargs) |
|
|
52
|
+
| [ChaintracksStorageBaseOptions](#interface-chaintracksstoragebaseoptions) | [ProvenOrRawTx](#interface-provenorrawtx) | [ValidBasketInsertion](#interface-validbasketinsertion) |
|
|
53
|
+
| [ChaintracksStorageBulkFileApi](#interface-chaintracksstoragebulkfileapi) | [ProvenTransactionStatus](#interface-proventransactionstatus) | [ValidCreateActionArgs](#interface-validcreateactionargs) |
|
|
54
|
+
| [ChaintracksStorageIdbOptions](#interface-chaintracksstorageidboptions) | [ProvenTxFromTxidResult](#interface-proventxfromtxidresult) | [ValidCreateActionInput](#interface-validcreateactioninput) |
|
|
55
|
+
| [ChaintracksStorageIdbSchema](#interface-chaintracksstorageidbschema) | [ProvenTxReqHistory](#interface-proventxreqhistory) | [ValidCreateActionOptions](#interface-validcreateactionoptions) |
|
|
56
|
+
| [ChaintracksStorageIngestApi](#interface-chaintracksstorageingestapi) | [ProvenTxReqHistorySummaryApi](#interface-proventxreqhistorysummaryapi) | [ValidCreateActionOutput](#interface-validcreateactionoutput) |
|
|
57
|
+
| [ChaintracksStorageNoDbOptions](#interface-chaintracksstoragenodboptions) | [ProvenTxReqNotify](#interface-proventxreqnotify) | [ValidDiscoverByAttributesArgs](#interface-validdiscoverbyattributesargs) |
|
|
58
|
+
| [ChaintracksStorageQueryApi](#interface-chaintracksstoragequeryapi) | [ProviderCallHistory](#interface-providercallhistory) | [ValidDiscoverByIdentityKeyArgs](#interface-validdiscoverbyidentitykeyargs) |
|
|
59
|
+
| [ChaintracksWritableFileApi](#interface-chaintrackswritablefileapi) | [PurgeParams](#interface-purgeparams) | [ValidInternalizeActionArgs](#interface-validinternalizeactionargs) |
|
|
60
|
+
| [CommitNewTxResults](#interface-commitnewtxresults) | [PurgeResults](#interface-purgeresults) | [ValidInternalizeOutput](#interface-validinternalizeoutput) |
|
|
61
|
+
| [CompleteAuthResponse](#interface-completeauthresponse) | [ReproveHeaderResult](#interface-reproveheaderresult) | [ValidListActionsArgs](#interface-validlistactionsargs) |
|
|
62
|
+
| [CreateActionResultX](#interface-createactionresultx) | [ReproveProvenResult](#interface-reproveprovenresult) | [ValidListCertificatesArgs](#interface-validlistcertificatesargs) |
|
|
63
|
+
| [DeactivedHeader](#interface-deactivedheader) | [RequestSyncChunkArgs](#interface-requestsyncchunkargs) | [ValidListOutputsArgs](#interface-validlistoutputsargs) |
|
|
64
|
+
| [EntitySyncMap](#interface-entitysyncmap) | [ReviewActionResult](#interface-reviewactionresult) | [ValidProcessActionArgs](#interface-validprocessactionargs) |
|
|
65
|
+
| [EntityTimeStamp](#interface-entitytimestamp) | [ScriptTemplateParamsBRC29](#interface-scripttemplateparamsbrc29) | [ValidProcessActionOptions](#interface-validprocessactionoptions) |
|
|
66
|
+
| [ExchangeRatesIoApi](#interface-exchangeratesioapi) | [ScriptTemplateUnlock](#interface-scripttemplateunlock) | [ValidProveCertificateArgs](#interface-validprovecertificateargs) |
|
|
67
67
|
| [ExtendedVerifiableCertificate](#interface-extendedverifiablecertificate) | [ServiceCall](#interface-servicecall) | [ValidRelinquishCertificateArgs](#interface-validrelinquishcertificateargs) |
|
|
68
|
-
| [FiatExchangeRates](#interface-fiatexchangerates) | [
|
|
69
|
-
| [FindCertificateFieldsArgs](#interface-findcertificatefieldsargs) | [
|
|
70
|
-
| [FindCertificatesArgs](#interface-findcertificatesargs) | [
|
|
71
|
-
| [FindCommissionsArgs](#interface-findcommissionsargs) | [
|
|
72
|
-
| [FindForUserSincePagedArgs](#interface-findforusersincepagedargs) | [
|
|
73
|
-
| [FindMonitorEventsArgs](#interface-findmonitoreventsargs) | [
|
|
74
|
-
| [FindOutputBasketsArgs](#interface-findoutputbasketsargs) | [
|
|
75
|
-
| [FindOutputTagMapsArgs](#interface-findoutputtagmapsargs) | [
|
|
76
|
-
| [FindOutputTagsArgs](#interface-findoutputtagsargs) | [
|
|
77
|
-
| [FindOutputsArgs](#interface-findoutputsargs) | [
|
|
78
|
-
| [FindPartialSincePagedArgs](#interface-findpartialsincepagedargs) | [
|
|
79
|
-
| [FindProvenTxReqsArgs](#interface-findproventxreqsargs) | [
|
|
80
|
-
| [FindProvenTxsArgs](#interface-findproventxsargs) | [
|
|
81
|
-
| [FindSincePagedArgs](#interface-findsincepagedargs) | [
|
|
82
|
-
| [FindSyncStatesArgs](#interface-findsyncstatesargs) | [
|
|
83
|
-
| [FindTransactionsArgs](#interface-findtransactionsargs) | [
|
|
84
|
-
| [FindTxLabelMapsArgs](#interface-findtxlabelmapsargs) | [
|
|
85
|
-
| [FindTxLabelsArgs](#interface-findtxlabelsargs) | [
|
|
86
|
-
| [FindUsersArgs](#interface-findusersargs) | [
|
|
87
|
-
| [GenerateChangeSdkChangeInput](#interface-generatechangesdkchangeinput) | [
|
|
88
|
-
| [GenerateChangeSdkChangeOutput](#interface-generatechangesdkchangeoutput) | [
|
|
89
|
-
| [GenerateChangeSdkInput](#interface-generatechangesdkinput) | [
|
|
90
|
-
| [GenerateChangeSdkOutput](#interface-generatechangesdkoutput) | [
|
|
91
|
-
| [GenerateChangeSdkParams](#interface-generatechangesdkparams) | [
|
|
92
|
-
| [GenerateChangeSdkResult](#interface-generatechangesdkresult) | [
|
|
93
|
-
| [GenerateChangeSdkStorageChange](#interface-generatechangesdkstoragechange) | [
|
|
94
|
-
| [GetHeaderByteFileLinksResult](#interface-getheaderbytefilelinksresult) | [
|
|
95
|
-
| [GetMerklePathResult](#interface-getmerklepathresult) | [
|
|
68
|
+
| [FiatExchangeRates](#interface-fiatexchangerates) | [ServiceCall](#interface-servicecall) | [ValidRelinquishOutputArgs](#interface-validrelinquishoutputargs) |
|
|
69
|
+
| [FindCertificateFieldsArgs](#interface-findcertificatefieldsargs) | [ServiceCallHistory](#interface-servicecallhistory) | [ValidSignActionArgs](#interface-validsignactionargs) |
|
|
70
|
+
| [FindCertificatesArgs](#interface-findcertificatesargs) | [ServiceCallHistoryCounts](#interface-servicecallhistorycounts) | [ValidSignActionOptions](#interface-validsignactionoptions) |
|
|
71
|
+
| [FindCommissionsArgs](#interface-findcommissionsargs) | [ServiceToCall](#interface-servicetocall) | [ValidWalletPayment](#interface-validwalletpayment) |
|
|
72
|
+
| [FindForUserSincePagedArgs](#interface-findforusersincepagedargs) | [SetupClientWalletArgs](#interface-setupclientwalletargs) | [ValidWalletSignerArgs](#interface-validwalletsignerargs) |
|
|
73
|
+
| [FindMonitorEventsArgs](#interface-findmonitoreventsargs) | [SetupClientWalletClientArgs](#interface-setupclientwalletclientargs) | [ValidateGenerateChangeSdkParamsResult](#interface-validategeneratechangesdkparamsresult) |
|
|
74
|
+
| [FindOutputBasketsArgs](#interface-findoutputbasketsargs) | [SetupWallet](#interface-setupwallet) | [WalletArgs](#interface-walletargs) |
|
|
75
|
+
| [FindOutputTagMapsArgs](#interface-findoutputtagmapsargs) | [SetupWalletClient](#interface-setupwalletclient) | [WalletBalance](#interface-walletbalance) |
|
|
76
|
+
| [FindOutputTagsArgs](#interface-findoutputtagsargs) | [SetupWalletIdb](#interface-setupwalletidb) | [WalletPermissionsManagerCallbacks](#interface-walletpermissionsmanagercallbacks) |
|
|
77
|
+
| [FindOutputsArgs](#interface-findoutputsargs) | [SetupWalletIdbArgs](#interface-setupwalletidbargs) | [WalletServices](#interface-walletservices) |
|
|
78
|
+
| [FindPartialSincePagedArgs](#interface-findpartialsincepagedargs) | [SignActionResultX](#interface-signactionresultx) | [WalletServicesOptions](#interface-walletservicesoptions) |
|
|
79
|
+
| [FindProvenTxReqsArgs](#interface-findproventxreqsargs) | [StartAuthResponse](#interface-startauthresponse) | [WalletSettings](#interface-walletsettings) |
|
|
80
|
+
| [FindProvenTxsArgs](#interface-findproventxsargs) | [StatusForTxidResult](#interface-statusfortxidresult) | [WalletSettingsManagerConfig](#interface-walletsettingsmanagerconfig) |
|
|
81
|
+
| [FindSincePagedArgs](#interface-findsincepagedargs) | [StorageAdminStats](#interface-storageadminstats) | [WalletSigner](#interface-walletsigner) |
|
|
82
|
+
| [FindSyncStatesArgs](#interface-findsyncstatesargs) | [StorageCreateActionResult](#interface-storagecreateactionresult) | [WalletStorage](#interface-walletstorage) |
|
|
83
|
+
| [FindTransactionsArgs](#interface-findtransactionsargs) | [StorageCreateTransactionSdkInput](#interface-storagecreatetransactionsdkinput) | [WalletStorageInfo](#interface-walletstorageinfo) |
|
|
84
|
+
| [FindTxLabelMapsArgs](#interface-findtxlabelmapsargs) | [StorageCreateTransactionSdkOutput](#interface-storagecreatetransactionsdkoutput) | [WalletStorageProvider](#interface-walletstorageprovider) |
|
|
85
|
+
| [FindTxLabelsArgs](#interface-findtxlabelsargs) | [StorageFeeModel](#interface-storagefeemodel) | [WalletStorageReader](#interface-walletstoragereader) |
|
|
86
|
+
| [FindUsersArgs](#interface-findusersargs) | [StorageGetBeefOptions](#interface-storagegetbeefoptions) | [WalletStorageSync](#interface-walletstoragesync) |
|
|
87
|
+
| [GenerateChangeSdkChangeInput](#interface-generatechangesdkchangeinput) | [StorageIdbOptions](#interface-storageidboptions) | [WalletStorageSyncReader](#interface-walletstoragesyncreader) |
|
|
88
|
+
| [GenerateChangeSdkChangeOutput](#interface-generatechangesdkchangeoutput) | [StorageIdbSchema](#interface-storageidbschema) | [WalletStorageWriter](#interface-walletstoragewriter) |
|
|
89
|
+
| [GenerateChangeSdkInput](#interface-generatechangesdkinput) | [StorageIdentity](#interface-storageidentity) | [WalletTheme](#interface-wallettheme) |
|
|
90
|
+
| [GenerateChangeSdkOutput](#interface-generatechangesdkoutput) | [StorageInternalizeActionResult](#interface-storageinternalizeactionresult) | [WhatsOnChainServicesOptions](#interface-whatsonchainservicesoptions) |
|
|
91
|
+
| [GenerateChangeSdkParams](#interface-generatechangesdkparams) | [StorageProcessActionArgs](#interface-storageprocessactionargs) | [WocChainInfo](#interface-wocchaininfo) |
|
|
92
|
+
| [GenerateChangeSdkResult](#interface-generatechangesdkresult) | [StorageProcessActionResults](#interface-storageprocessactionresults) | [WocGetHeaderByteFileLinks](#interface-wocgetheaderbytefilelinks) |
|
|
93
|
+
| [GenerateChangeSdkStorageChange](#interface-generatechangesdkstoragechange) | [StorageProvenOrReq](#interface-storageprovenorreq) | [WocGetHeadersHeader](#interface-wocgetheadersheader) |
|
|
94
|
+
| [GetHeaderByteFileLinksResult](#interface-getheaderbytefilelinksresult) | [StorageProviderOptions](#interface-storageprovideroptions) | [WocHeader](#interface-wocheader) |
|
|
95
|
+
| [GetMerklePathResult](#interface-getmerklepathresult) | [StorageReaderOptions](#interface-storagereaderoptions) | [XValidCreateActionOutput](#interface-xvalidcreateactionoutput) |
|
|
96
|
+
| [GetRawTxResult](#interface-getrawtxresult) | [StorageReaderWriterOptions](#interface-storagereaderwriteroptions) | |
|
|
96
97
|
|
|
97
98
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
98
99
|
|
|
@@ -4628,6 +4629,124 @@ export interface PurgeResults {
|
|
|
4628
4629
|
|
|
4629
4630
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
4630
4631
|
|
|
4632
|
+
---
|
|
4633
|
+
##### Interface: ReproveHeaderResult
|
|
4634
|
+
|
|
4635
|
+
Returned results from WalletStorageManager reproveHeader method.
|
|
4636
|
+
|
|
4637
|
+
```ts
|
|
4638
|
+
export interface ReproveHeaderResult {
|
|
4639
|
+
log: string;
|
|
4640
|
+
updated: {
|
|
4641
|
+
was: TableProvenTx;
|
|
4642
|
+
update: Partial<TableProvenTx>;
|
|
4643
|
+
logUpdate: string;
|
|
4644
|
+
}[];
|
|
4645
|
+
unchanged: TableProvenTx[];
|
|
4646
|
+
unavailable: TableProvenTx[];
|
|
4647
|
+
}
|
|
4648
|
+
```
|
|
4649
|
+
|
|
4650
|
+
See also: [TableProvenTx](./storage.md#interface-tableproventx)
|
|
4651
|
+
|
|
4652
|
+
###### Property log
|
|
4653
|
+
|
|
4654
|
+
Human readable log of the reproveHeader process.
|
|
4655
|
+
|
|
4656
|
+
```ts
|
|
4657
|
+
log: string
|
|
4658
|
+
```
|
|
4659
|
+
|
|
4660
|
+
###### Property unavailable
|
|
4661
|
+
|
|
4662
|
+
List of proven_txs records that were checked but currently proof data is unavailable.
|
|
4663
|
+
|
|
4664
|
+
```ts
|
|
4665
|
+
unavailable: TableProvenTx[]
|
|
4666
|
+
```
|
|
4667
|
+
See also: [TableProvenTx](./storage.md#interface-tableproventx)
|
|
4668
|
+
|
|
4669
|
+
###### Property unchanged
|
|
4670
|
+
|
|
4671
|
+
List of proven_txs records that were checked but currently available proof is unchanged.
|
|
4672
|
+
|
|
4673
|
+
```ts
|
|
4674
|
+
unchanged: TableProvenTx[]
|
|
4675
|
+
```
|
|
4676
|
+
See also: [TableProvenTx](./storage.md#interface-tableproventx)
|
|
4677
|
+
|
|
4678
|
+
###### Property updated
|
|
4679
|
+
|
|
4680
|
+
List of proven_txs records that were updated with new proof data.
|
|
4681
|
+
|
|
4682
|
+
```ts
|
|
4683
|
+
updated: {
|
|
4684
|
+
was: TableProvenTx;
|
|
4685
|
+
update: Partial<TableProvenTx>;
|
|
4686
|
+
logUpdate: string;
|
|
4687
|
+
}[]
|
|
4688
|
+
```
|
|
4689
|
+
See also: [TableProvenTx](./storage.md#interface-tableproventx)
|
|
4690
|
+
|
|
4691
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
4692
|
+
|
|
4693
|
+
---
|
|
4694
|
+
##### Interface: ReproveProvenResult
|
|
4695
|
+
|
|
4696
|
+
Returned results from WalletStorageManager reproveProven method.
|
|
4697
|
+
|
|
4698
|
+
```ts
|
|
4699
|
+
export interface ReproveProvenResult {
|
|
4700
|
+
log: string;
|
|
4701
|
+
updated?: {
|
|
4702
|
+
update: Partial<TableProvenTx>;
|
|
4703
|
+
logUpdate: string;
|
|
4704
|
+
};
|
|
4705
|
+
unchanged: boolean;
|
|
4706
|
+
unavailable: boolean;
|
|
4707
|
+
}
|
|
4708
|
+
```
|
|
4709
|
+
|
|
4710
|
+
See also: [TableProvenTx](./storage.md#interface-tableproventx)
|
|
4711
|
+
|
|
4712
|
+
###### Property log
|
|
4713
|
+
|
|
4714
|
+
Human readable log of the reproveProven process.
|
|
4715
|
+
|
|
4716
|
+
```ts
|
|
4717
|
+
log: string
|
|
4718
|
+
```
|
|
4719
|
+
|
|
4720
|
+
###### Property unavailable
|
|
4721
|
+
|
|
4722
|
+
True if proof data for proven_txs record is currently unavailable.
|
|
4723
|
+
|
|
4724
|
+
```ts
|
|
4725
|
+
unavailable: boolean
|
|
4726
|
+
```
|
|
4727
|
+
|
|
4728
|
+
###### Property unchanged
|
|
4729
|
+
|
|
4730
|
+
True if proof data for proven_txs record was found to be unchanged.
|
|
4731
|
+
|
|
4732
|
+
```ts
|
|
4733
|
+
unchanged: boolean
|
|
4734
|
+
```
|
|
4735
|
+
|
|
4736
|
+
###### Property updated
|
|
4737
|
+
|
|
4738
|
+
Valid if proof data for proven_txs record is available and has changed.
|
|
4739
|
+
|
|
4740
|
+
```ts
|
|
4741
|
+
updated?: {
|
|
4742
|
+
update: Partial<TableProvenTx>;
|
|
4743
|
+
logUpdate: string;
|
|
4744
|
+
}
|
|
4745
|
+
```
|
|
4746
|
+
See also: [TableProvenTx](./storage.md#interface-tableproventx)
|
|
4747
|
+
|
|
4748
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
4749
|
+
|
|
4631
4750
|
---
|
|
4632
4751
|
##### Interface: RequestSyncChunkArgs
|
|
4633
4752
|
|
|
@@ -11426,6 +11545,18 @@ callOnProvenTransaction(txStatus: ProvenTransactionStatus): void
|
|
|
11426
11545
|
```
|
|
11427
11546
|
See also: [ProvenTransactionStatus](./client.md#interface-proventransactionstatus)
|
|
11428
11547
|
|
|
11548
|
+
###### Method processHeader
|
|
11549
|
+
|
|
11550
|
+
Handler for new header events from Chaintracks.
|
|
11551
|
+
|
|
11552
|
+
To minimize reorg processing, new headers are aged before processing via TaskNewHeader.
|
|
11553
|
+
Therefore this handler is intentionally a no-op.
|
|
11554
|
+
|
|
11555
|
+
```ts
|
|
11556
|
+
processHeader(header: BlockHeader): void
|
|
11557
|
+
```
|
|
11558
|
+
See also: [BlockHeader](./client.md#interface-blockheader)
|
|
11559
|
+
|
|
11429
11560
|
###### Method processNewBlockHeader
|
|
11430
11561
|
|
|
11431
11562
|
Process new chain header event received from Chaintracks
|
|
@@ -13872,7 +14003,7 @@ They must be shifted out as they are processed.
|
|
|
13872
14003
|
The current implementation ages deactivation notifications by 10 minutes with each retry.
|
|
13873
14004
|
If a successful proof update confirms original proof data after 3 retries, the original is retained.
|
|
13874
14005
|
|
|
13875
|
-
In normal operation there should
|
|
14006
|
+
In normal operation there should rarely be any work for this task to perform.
|
|
13876
14007
|
The most common result is that there are no matching proven_txs records because
|
|
13877
14008
|
generating new proven_txs records intentionally lags new block generation to
|
|
13878
14009
|
minimize this disruption.
|
|
@@ -13882,17 +14013,8 @@ It is very disruptive to update a proven_txs record because:
|
|
|
13882
14013
|
- Generated beefs are impacted.
|
|
13883
14014
|
- Updated proof data may be unavailable at the time a reorg is first reported.
|
|
13884
14015
|
|
|
13885
|
-
|
|
13886
|
-
|
|
13887
|
-
createAction fails to verify against the chaintracker.
|
|
13888
|
-
|
|
13889
|
-
An alternate approach to processing these events is to revert the proven_txs record to a proven_tx_reqs record.
|
|
13890
|
-
Pros:
|
|
13891
|
-
- The same multiple attempt logic that already exists is reused.
|
|
13892
|
-
- Failing to obtain a new proof already has transaction failure handling in place.
|
|
13893
|
-
- Generated beefs automatically become one generation deeper, potentially allowing transaction outputs to be spent.
|
|
13894
|
-
Cons:
|
|
13895
|
-
- Transactions must revert to un-proven / un-mined.
|
|
14016
|
+
Proper reorg handling also requires repairing invalid beefs for new transactions when
|
|
14017
|
+
createAction fails to verify a generated beef against the chaintracker.
|
|
13896
14018
|
|
|
13897
14019
|
```ts
|
|
13898
14020
|
export class TaskReorg extends WalletMonitorTask {
|
|
@@ -13908,6 +14030,25 @@ export class TaskReorg extends WalletMonitorTask {
|
|
|
13908
14030
|
|
|
13909
14031
|
See also: [DeactivedHeader](./monitor.md#interface-deactivedheader), [Monitor](./monitor.md#class-monitor), [WalletMonitorTask](./monitor.md#class-walletmonitortask)
|
|
13910
14032
|
|
|
14033
|
+
###### Method trigger
|
|
14034
|
+
|
|
14035
|
+
Shift aged deactivated headers onto `process` array.
|
|
14036
|
+
|
|
14037
|
+
```ts
|
|
14038
|
+
trigger(nowMsecsSinceEpoch: number): {
|
|
14039
|
+
run: boolean;
|
|
14040
|
+
}
|
|
14041
|
+
```
|
|
14042
|
+
|
|
14043
|
+
Returns
|
|
14044
|
+
|
|
14045
|
+
`run` true iff there are aged deactivated headers to process.
|
|
14046
|
+
|
|
14047
|
+
Argument Details
|
|
14048
|
+
|
|
14049
|
+
+ **nowMsecsSinceEpoch**
|
|
14050
|
+
+ current time in milliseconds since epoch.
|
|
14051
|
+
|
|
13911
14052
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
13912
14053
|
|
|
13913
14054
|
---
|
|
@@ -14249,6 +14390,7 @@ to pay the fee to unlock and spend the outputs used to provide the additional sa
|
|
|
14249
14390
|
```ts
|
|
14250
14391
|
export class WERR_INSUFFICIENT_FUNDS extends WalletError {
|
|
14251
14392
|
constructor(public totalSatoshisNeeded: number, public moreSatoshisNeeded: number)
|
|
14393
|
+
override toJson(): string
|
|
14252
14394
|
}
|
|
14253
14395
|
```
|
|
14254
14396
|
|
|
@@ -14313,6 +14455,7 @@ This is an example of an error object with a custom property `parameter` and tem
|
|
|
14313
14455
|
```ts
|
|
14314
14456
|
export class WERR_INVALID_PARAMETER extends WalletError {
|
|
14315
14457
|
constructor(public parameter: string, mustBe?: string)
|
|
14458
|
+
override toJson(): string
|
|
14316
14459
|
}
|
|
14317
14460
|
```
|
|
14318
14461
|
|
|
@@ -14326,6 +14469,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
14326
14469
|
```ts
|
|
14327
14470
|
export class WERR_INVALID_PUBLIC_KEY extends WalletError {
|
|
14328
14471
|
constructor(public key: string, network: WalletNetwork = "mainnet")
|
|
14472
|
+
protected override toJson(): string
|
|
14329
14473
|
}
|
|
14330
14474
|
```
|
|
14331
14475
|
|
|
@@ -14356,6 +14500,7 @@ This is an example of an error object with a custom property `parameter`
|
|
|
14356
14500
|
```ts
|
|
14357
14501
|
export class WERR_MISSING_PARAMETER extends WalletError {
|
|
14358
14502
|
constructor(public parameter: string)
|
|
14503
|
+
override toJson(): string
|
|
14359
14504
|
}
|
|
14360
14505
|
```
|
|
14361
14506
|
|
|
@@ -14418,6 +14563,7 @@ paid to processing errors.
|
|
|
14418
14563
|
```ts
|
|
14419
14564
|
export class WERR_REVIEW_ACTIONS extends WalletError {
|
|
14420
14565
|
constructor(public reviewActionResults: ReviewActionResult[], public sendWithResults: SendWithResult[], public txid?: TXIDHexString, public tx?: AtomicBEEF, public noSendChange?: OutpointString[])
|
|
14566
|
+
override toJson(): string
|
|
14421
14567
|
}
|
|
14422
14568
|
```
|
|
14423
14569
|
|
|
@@ -14789,6 +14935,8 @@ export class WalletError extends Error implements WalletErrorObject {
|
|
|
14789
14935
|
code: string;
|
|
14790
14936
|
description: string;
|
|
14791
14937
|
}
|
|
14938
|
+
protected toJson(): string
|
|
14939
|
+
static unknownToJson(error: unknown | WalletError): string
|
|
14792
14940
|
}
|
|
14793
14941
|
```
|
|
14794
14942
|
|
|
@@ -14815,6 +14963,37 @@ static fromUnknown(err: unknown): WalletError
|
|
|
14815
14963
|
```
|
|
14816
14964
|
See also: [WalletError](./client.md#class-walleterror)
|
|
14817
14965
|
|
|
14966
|
+
###### Method toJson
|
|
14967
|
+
|
|
14968
|
+
Base class default JSON serialization.
|
|
14969
|
+
Captures just the name and message properties.
|
|
14970
|
+
|
|
14971
|
+
Override this method to safely (avoid deep, large, circular issues) serialize
|
|
14972
|
+
derived class properties.
|
|
14973
|
+
|
|
14974
|
+
```ts
|
|
14975
|
+
protected toJson(): string
|
|
14976
|
+
```
|
|
14977
|
+
|
|
14978
|
+
Returns
|
|
14979
|
+
|
|
14980
|
+
stringified JSON representation of the WalletError.
|
|
14981
|
+
|
|
14982
|
+
###### Method unknownToJson
|
|
14983
|
+
|
|
14984
|
+
Safely serializes a WalletError derived, WERR_REVIEW_ACTIONS (special case), Error or unknown error to JSON.
|
|
14985
|
+
|
|
14986
|
+
Safely means avoiding deep, large, circular issues.
|
|
14987
|
+
|
|
14988
|
+
```ts
|
|
14989
|
+
static unknownToJson(error: unknown | WalletError): string
|
|
14990
|
+
```
|
|
14991
|
+
See also: [WalletError](./client.md#class-walleterror)
|
|
14992
|
+
|
|
14993
|
+
Returns
|
|
14994
|
+
|
|
14995
|
+
stringified JSON representation of the error such that it can be desirialized to a WalletError.
|
|
14996
|
+
|
|
14818
14997
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
14819
14998
|
|
|
14820
14999
|
---
|
|
@@ -15546,6 +15725,9 @@ export class WalletStorageManager implements sdk.WalletStorage {
|
|
|
15546
15725
|
async findOutputBaskets(args: sdk.FindOutputBasketsArgs): Promise<TableOutputBasket[]>
|
|
15547
15726
|
async findOutputs(args: sdk.FindOutputsArgs): Promise<TableOutput[]>
|
|
15548
15727
|
async findProvenTxReqs(args: sdk.FindProvenTxReqsArgs): Promise<TableProvenTxReq[]>
|
|
15728
|
+
async reproveHeader(deactivatedHash: string): Promise<sdk.ReproveHeaderResult>
|
|
15729
|
+
async verifyAndRepairBeef(beef: Beef, allowTxidOnly?: boolean): Promise<boolean>
|
|
15730
|
+
async reproveProven(ptx: TableProvenTx, noUpdate?: boolean): Promise<sdk.ReproveProvenResult>
|
|
15549
15731
|
async syncFromReader(identityKey: string, reader: sdk.WalletStorageSyncReader, activeSync?: sdk.WalletStorageSync, log: string = ""): Promise<{
|
|
15550
15732
|
inserts: number;
|
|
15551
15733
|
updates: number;
|
|
@@ -15563,7 +15745,7 @@ export class WalletStorageManager implements sdk.WalletStorage {
|
|
|
15563
15745
|
}
|
|
15564
15746
|
```
|
|
15565
15747
|
|
|
15566
|
-
See also: [AuthId](./client.md#interface-authid), [FindCertificatesArgs](./client.md#interface-findcertificatesargs), [FindOutputBasketsArgs](./client.md#interface-findoutputbasketsargs), [FindOutputsArgs](./client.md#interface-findoutputsargs), [FindProvenTxReqsArgs](./client.md#interface-findproventxreqsargs), [StorageCreateActionResult](./client.md#interface-storagecreateactionresult), [StorageInternalizeActionResult](./client.md#interface-storageinternalizeactionresult), [StorageProcessActionArgs](./client.md#interface-storageprocessactionargs), [StorageProcessActionResults](./client.md#interface-storageprocessactionresults), [StorageProvider](./storage.md#class-storageprovider), [TableCertificate](./storage.md#interface-tablecertificate), [TableCertificateX](./storage.md#interface-tablecertificatex), [TableOutput](./storage.md#interface-tableoutput), [TableOutputBasket](./storage.md#interface-tableoutputbasket), [TableProvenTxReq](./storage.md#interface-tableproventxreq), [TableSettings](./storage.md#interface-tablesettings), [TableUser](./storage.md#interface-tableuser), [ValidCreateActionArgs](./client.md#interface-validcreateactionargs), [ValidListActionsArgs](./client.md#interface-validlistactionsargs), [ValidListCertificatesArgs](./client.md#interface-validlistcertificatesargs), [ValidListOutputsArgs](./client.md#interface-validlistoutputsargs), [WalletServices](./client.md#interface-walletservices), [WalletStorage](./client.md#interface-walletstorage), [WalletStorageInfo](./client.md#interface-walletstorageinfo), [WalletStorageProvider](./client.md#interface-walletstorageprovider), [WalletStorageReader](./client.md#interface-walletstoragereader), [WalletStorageSync](./client.md#interface-walletstoragesync), [WalletStorageSyncReader](./client.md#interface-walletstoragesyncreader), [WalletStorageWriter](./client.md#interface-walletstoragewriter), [createAction](./storage.md#function-createaction), [internalizeAction](./storage.md#function-internalizeaction), [listActions](./storage.md#function-listactions), [listCertificates](./storage.md#function-listcertificates), [listOutputs](./storage.md#function-listoutputs), [processAction](./storage.md#function-processaction)
|
|
15748
|
+
See also: [AuthId](./client.md#interface-authid), [FindCertificatesArgs](./client.md#interface-findcertificatesargs), [FindOutputBasketsArgs](./client.md#interface-findoutputbasketsargs), [FindOutputsArgs](./client.md#interface-findoutputsargs), [FindProvenTxReqsArgs](./client.md#interface-findproventxreqsargs), [ReproveHeaderResult](./client.md#interface-reproveheaderresult), [ReproveProvenResult](./client.md#interface-reproveprovenresult), [StorageCreateActionResult](./client.md#interface-storagecreateactionresult), [StorageInternalizeActionResult](./client.md#interface-storageinternalizeactionresult), [StorageProcessActionArgs](./client.md#interface-storageprocessactionargs), [StorageProcessActionResults](./client.md#interface-storageprocessactionresults), [StorageProvider](./storage.md#class-storageprovider), [TableCertificate](./storage.md#interface-tablecertificate), [TableCertificateX](./storage.md#interface-tablecertificatex), [TableOutput](./storage.md#interface-tableoutput), [TableOutputBasket](./storage.md#interface-tableoutputbasket), [TableProvenTx](./storage.md#interface-tableproventx), [TableProvenTxReq](./storage.md#interface-tableproventxreq), [TableSettings](./storage.md#interface-tablesettings), [TableUser](./storage.md#interface-tableuser), [ValidCreateActionArgs](./client.md#interface-validcreateactionargs), [ValidListActionsArgs](./client.md#interface-validlistactionsargs), [ValidListCertificatesArgs](./client.md#interface-validlistcertificatesargs), [ValidListOutputsArgs](./client.md#interface-validlistoutputsargs), [WalletServices](./client.md#interface-walletservices), [WalletStorage](./client.md#interface-walletstorage), [WalletStorageInfo](./client.md#interface-walletstorageinfo), [WalletStorageProvider](./client.md#interface-walletstorageprovider), [WalletStorageReader](./client.md#interface-walletstoragereader), [WalletStorageSync](./client.md#interface-walletstoragesync), [WalletStorageSyncReader](./client.md#interface-walletstoragesyncreader), [WalletStorageWriter](./client.md#interface-walletstoragewriter), [createAction](./storage.md#function-createaction), [internalizeAction](./storage.md#function-internalizeaction), [listActions](./storage.md#function-listactions), [listCertificates](./storage.md#function-listcertificates), [listOutputs](./storage.md#function-listoutputs), [processAction](./storage.md#function-processaction)
|
|
15567
15749
|
|
|
15568
15750
|
###### Constructor
|
|
15569
15751
|
|
|
@@ -15681,6 +15863,39 @@ Throws
|
|
|
15681
15863
|
|
|
15682
15864
|
WERR_INVALID_PARAMETER if canMakeAvailable returns false.
|
|
15683
15865
|
|
|
15866
|
+
###### Method reproveHeader
|
|
15867
|
+
|
|
15868
|
+
For each proven_txs record currently sourcing its transaction merkle proof from the given deactivated header,
|
|
15869
|
+
attempt to reprove the transaction against the current chain,
|
|
15870
|
+
updating the proven_txs record if a new valid proof is found.
|
|
15871
|
+
|
|
15872
|
+
```ts
|
|
15873
|
+
async reproveHeader(deactivatedHash: string): Promise<sdk.ReproveHeaderResult>
|
|
15874
|
+
```
|
|
15875
|
+
See also: [ReproveHeaderResult](./client.md#interface-reproveheaderresult)
|
|
15876
|
+
|
|
15877
|
+
Argument Details
|
|
15878
|
+
|
|
15879
|
+
+ **deactivatedHash**
|
|
15880
|
+
+ An orphaned header than may have served as a proof source for proven_txs records.
|
|
15881
|
+
|
|
15882
|
+
###### Method reproveProven
|
|
15883
|
+
|
|
15884
|
+
Attempt to reprove the transaction against the current chain,
|
|
15885
|
+
If a new valid proof is found and noUpdate is not true,
|
|
15886
|
+
update the proven_txs record with new block and merkle proof data.
|
|
15887
|
+
If noUpdate is true, the update to be applied is available in the returned result.
|
|
15888
|
+
|
|
15889
|
+
```ts
|
|
15890
|
+
async reproveProven(ptx: TableProvenTx, noUpdate?: boolean): Promise<sdk.ReproveProvenResult>
|
|
15891
|
+
```
|
|
15892
|
+
See also: [ReproveProvenResult](./client.md#interface-reproveprovenresult), [TableProvenTx](./storage.md#interface-tableproventx)
|
|
15893
|
+
|
|
15894
|
+
Argument Details
|
|
15895
|
+
|
|
15896
|
+
+ **ptx**
|
|
15897
|
+
+ proven_txs record to reprove
|
|
15898
|
+
|
|
15684
15899
|
###### Method runAsSync
|
|
15685
15900
|
|
|
15686
15901
|
```ts
|
|
@@ -15710,6 +15925,18 @@ Argument Details
|
|
|
15710
15925
|
+ **storageIdentityKey**
|
|
15711
15926
|
+ of current backup storage provider that is to become the new active provider.
|
|
15712
15927
|
|
|
15928
|
+
###### Method verifyAndRepairBeef
|
|
15929
|
+
|
|
15930
|
+
Extends the Beef `verify` function to handle BUMPs that have become invalid due to a chain reorg.
|
|
15931
|
+
|
|
15932
|
+
Any merkle root that fails `isValidRootForHeight` triggers a reprove attempt for that block header.
|
|
15933
|
+
This results in proven_txs with invalid proofs being updated with new valid proofs where possible.
|
|
15934
|
+
Finally, a new beef is generated and verified against the chaintracker.
|
|
15935
|
+
|
|
15936
|
+
```ts
|
|
15937
|
+
async verifyAndRepairBeef(beef: Beef, allowTxidOnly?: boolean): Promise<boolean>
|
|
15938
|
+
```
|
|
15939
|
+
|
|
15713
15940
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
15714
15941
|
|
|
15715
15942
|
---
|
|
@@ -15895,6 +16122,7 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
15895
16122
|
|
|
15896
16123
|
| | | |
|
|
15897
16124
|
| --- | --- | --- |
|
|
16125
|
+
| [WalletErrorFromJson](#function-walleterrorfromjson) | [internalizeAction](#function-internalizeaction) | [validateAcquireDirectCertificateArgs](#function-validateacquiredirectcertificateargs) |
|
|
15898
16126
|
| [WocHeadersBulkListener](#function-wocheadersbulklistener) | [isBaseBlockHeader](#function-isbaseblockheader) | [validateAcquireIssuanceCertificateArgs](#function-validateacquireissuancecertificateargs) |
|
|
15899
16127
|
| [WocHeadersBulkListener_test](#function-wocheadersbulklistener_test) | [isBlockHeader](#function-isblockheader) | [validateAgainstDirtyHashes](#function-validateagainstdirtyhashes) |
|
|
15900
16128
|
| [WocHeadersLiveListener](#function-wocheaderslivelistener) | [isCreateActionSpecOp](#function-iscreateactionspecop) | [validateBasketInsertion](#function-validatebasketinsertion) |
|
|
@@ -15948,12 +16176,31 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
15948
16176
|
| [getSyncChunk](#function-getsyncchunk) | [validBulkHeaderFilesByFileHash](#function-validbulkheaderfilesbyfilehash) | [workBNtoBuffer](#function-workbntobuffer) |
|
|
15949
16177
|
| [getWhatsOnChainBlockHeaderByHash](#function-getwhatsonchainblockheaderbyhash) | [validateAbortActionArgs](#function-validateabortactionargs) | [writeUInt32BE](#function-writeuint32be) |
|
|
15950
16178
|
| [internalizeAction](#function-internalizeaction) | [validateAcquireCertificateArgs](#function-validateacquirecertificateargs) | [writeUInt32LE](#function-writeuint32le) |
|
|
15951
|
-
| [internalizeAction](#function-internalizeaction) | [validateAcquireDirectCertificateArgs](#function-validateacquiredirectcertificateargs) | |
|
|
15952
16179
|
|
|
15953
16180
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
15954
16181
|
|
|
15955
16182
|
---
|
|
15956
16183
|
|
|
16184
|
+
##### Function: WalletErrorFromJson
|
|
16185
|
+
|
|
16186
|
+
Reconstruct the correct derived WalletError from a JSON object created by `WalletError.unknownToJson`.
|
|
16187
|
+
|
|
16188
|
+
This function is implemented as a separate function instead of a WalletError class static
|
|
16189
|
+
to avoid circular dependencies.
|
|
16190
|
+
|
|
16191
|
+
```ts
|
|
16192
|
+
export function WalletErrorFromJson(json: object): WalletError
|
|
16193
|
+
```
|
|
16194
|
+
|
|
16195
|
+
See also: [WalletError](./client.md#class-walleterror)
|
|
16196
|
+
|
|
16197
|
+
Returns
|
|
16198
|
+
|
|
16199
|
+
a WalletError derived error object, typically for re-throw.
|
|
16200
|
+
|
|
16201
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
16202
|
+
|
|
16203
|
+
---
|
|
15957
16204
|
##### Function: WocHeadersBulkListener
|
|
15958
16205
|
|
|
15959
16206
|
High speed WebSocket based based old block header listener
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"TaskReorg.d.ts","sourceRoot":"","sources":["../../../../../src/monitor/tasks/TaskReorg.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,SAAU,SAAQ,iBAAiB;IAOrC,SAAS;IACT,UAAU;IAPnB,MAAM,CAAC,QAAQ,SAAU;IAEzB,OAAO,EAAE,eAAe,EAAE,CAAK;gBAG7B,OAAO,EAAE,OAAO,EACT,SAAS,SAAyB,EAClC,UAAU,SAAI;IAKvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE;IAa/C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"TaskReorg.d.ts","sourceRoot":"","sources":["../../../../../src/monitor/tasks/TaskReorg.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,SAAU,SAAQ,iBAAiB;IAOrC,SAAS;IACT,UAAU;IAPnB,MAAM,CAAC,QAAQ,SAAU;IAEzB,OAAO,EAAE,eAAe,EAAE,CAAK;gBAG7B,OAAO,EAAE,OAAO,EACT,SAAS,SAAyB,EAClC,UAAU,SAAI;IAKvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE;IAa/C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CA4BjC"}
|
|
@@ -66,7 +66,11 @@ class TaskReorg extends WalletMonitorTask_1.WalletMonitorTask {
|
|
|
66
66
|
}
|
|
67
67
|
else {
|
|
68
68
|
log += ` retrying...\n`;
|
|
69
|
-
this.monitor.deactivatedHeaders.push({
|
|
69
|
+
this.monitor.deactivatedHeaders.push({
|
|
70
|
+
header: header.header,
|
|
71
|
+
whenMsecs: Date.now(),
|
|
72
|
+
tries: header.tries + 1
|
|
73
|
+
});
|
|
70
74
|
}
|
|
71
75
|
}
|
|
72
76
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"TaskReorg.js","sourceRoot":"","sources":["../../../../../src/monitor/tasks/TaskReorg.ts"],"names":[],"mappings":";;;AAEA,wCAAqD;AACrD,2DAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,SAAU,SAAQ,qCAAiB;IAK9C,YACE,OAAgB,EACT,YAAY,iBAAO,CAAC,SAAS,GAAG,EAAE,EAClC,aAAa,CAAC;QAErB,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;QAH3B,cAAS,GAAT,SAAS,CAAyB;QAClC,eAAU,GAAV,UAAU,CAAI;QALvB,YAAO,GAAsB,EAAE,CAAA;IAQ/B,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,kBAA0B;QAChC,MAAM,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAA;QAClD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAA;QACzC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAC/C,iFAAiF;YACjF,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,EAAG,CAAA;YACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC3B,CAAC;QACD,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;SAC7B,CAAA;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,GAAG,GAAG,EAAE,CAAA;QAEZ,SAAS,CAAC;YACR,2CAA2C;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;YACnC,IAAI,CAAC,MAAM;gBAAE,MAAK;YAElB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAE9D,GAAG,IAAI,CAAC,CAAC,GAAG,CAAA;YAEZ,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvD,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxC,GAAG,IAAI,yBAAyB,IAAI,CAAC,UAAU,aAAa,CAAA;gBAC9D,CAAC;qBAAM,CAAC;oBACN,GAAG,IAAI,mBAAmB,CAAA;oBAC1B,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"TaskReorg.js","sourceRoot":"","sources":["../../../../../src/monitor/tasks/TaskReorg.ts"],"names":[],"mappings":";;;AAEA,wCAAqD;AACrD,2DAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,SAAU,SAAQ,qCAAiB;IAK9C,YACE,OAAgB,EACT,YAAY,iBAAO,CAAC,SAAS,GAAG,EAAE,EAClC,aAAa,CAAC;QAErB,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAA;QAH3B,cAAS,GAAT,SAAS,CAAyB;QAClC,eAAU,GAAV,UAAU,CAAI;QALvB,YAAO,GAAsB,EAAE,CAAA;IAQ/B,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,kBAA0B;QAChC,MAAM,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAA;QAClD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAA;QACzC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAC/C,iFAAiF;YACjF,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,EAAG,CAAA;YACzB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC3B,CAAC;QACD,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;SAC7B,CAAA;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,GAAG,GAAG,EAAE,CAAA;QAEZ,SAAS,CAAC;YACR,2CAA2C;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;YACnC,IAAI,CAAC,MAAM;gBAAE,MAAK;YAElB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAE9D,GAAG,IAAI,CAAC,CAAC,GAAG,CAAA;YAEZ,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvD,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxC,GAAG,IAAI,yBAAyB,IAAI,CAAC,UAAU,aAAa,CAAA;gBAC9D,CAAC;qBAAM,CAAC;oBACN,GAAG,IAAI,mBAAmB,CAAA;oBAC1B,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC;wBACnC,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;wBACrB,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC;qBACxB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAA;IACZ,CAAC;;AA1DH,8BA2DC;AA1DQ,kBAAQ,GAAG,OAAO,AAAV,CAAU"}
|