@bsv/wallet-toolbox 2.0.23 → 2.0.26-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/docs/client.md +350 -109
  3. package/docs/monitor.md +73 -3
  4. package/docs/services.md +183 -20
  5. package/docs/storage.md +16 -0
  6. package/docs/wallet.md +350 -109
  7. package/out/src/Setup.js +1 -4
  8. package/out/src/Setup.js.map +1 -1
  9. package/out/src/index.all.d.ts +1 -0
  10. package/out/src/index.all.d.ts.map +1 -1
  11. package/out/src/index.all.js +1 -0
  12. package/out/src/index.all.js.map +1 -1
  13. package/out/src/index.mobile.d.ts +1 -0
  14. package/out/src/index.mobile.d.ts.map +1 -1
  15. package/out/src/index.mobile.js +1 -0
  16. package/out/src/index.mobile.js.map +1 -1
  17. package/out/src/mockchain/MockChainMigrations.d.ts +20 -0
  18. package/out/src/mockchain/MockChainMigrations.d.ts.map +1 -0
  19. package/out/src/mockchain/MockChainMigrations.js +67 -0
  20. package/out/src/mockchain/MockChainMigrations.js.map +1 -0
  21. package/out/src/mockchain/MockChainStorage.d.ts +58 -0
  22. package/out/src/mockchain/MockChainStorage.d.ts.map +1 -0
  23. package/out/src/mockchain/MockChainStorage.js +101 -0
  24. package/out/src/mockchain/MockChainStorage.js.map +1 -0
  25. package/out/src/mockchain/MockChainTracker.d.ts +28 -0
  26. package/out/src/mockchain/MockChainTracker.d.ts.map +1 -0
  27. package/out/src/mockchain/MockChainTracker.js +95 -0
  28. package/out/src/mockchain/MockChainTracker.js.map +1 -0
  29. package/out/src/mockchain/MockMiner.d.ts +16 -0
  30. package/out/src/mockchain/MockMiner.d.ts.map +1 -0
  31. package/out/src/mockchain/MockMiner.js +136 -0
  32. package/out/src/mockchain/MockMiner.js.map +1 -0
  33. package/out/src/mockchain/MockServices.d.ts +44 -0
  34. package/out/src/mockchain/MockServices.d.ts.map +1 -0
  35. package/out/src/mockchain/MockServices.js +504 -0
  36. package/out/src/mockchain/MockServices.js.map +1 -0
  37. package/out/src/mockchain/index.d.ts +9 -0
  38. package/out/src/mockchain/index.d.ts.map +1 -0
  39. package/out/src/mockchain/index.js +18 -0
  40. package/out/src/mockchain/index.js.map +1 -0
  41. package/out/src/mockchain/merkleTree.d.ts +13 -0
  42. package/out/src/mockchain/merkleTree.d.ts.map +1 -0
  43. package/out/src/mockchain/merkleTree.js +113 -0
  44. package/out/src/mockchain/merkleTree.js.map +1 -0
  45. package/out/src/monitor/Monitor.d.ts +23 -0
  46. package/out/src/monitor/Monitor.d.ts.map +1 -1
  47. package/out/src/monitor/Monitor.js +27 -0
  48. package/out/src/monitor/Monitor.js.map +1 -1
  49. package/out/src/monitor/tasks/TaskArcSSE.d.ts +24 -0
  50. package/out/src/monitor/tasks/TaskArcSSE.d.ts.map +1 -0
  51. package/out/src/monitor/tasks/TaskArcSSE.js +155 -0
  52. package/out/src/monitor/tasks/TaskArcSSE.js.map +1 -0
  53. package/out/src/monitor/tasks/TaskMineBlock.d.ts +13 -0
  54. package/out/src/monitor/tasks/TaskMineBlock.d.ts.map +1 -0
  55. package/out/src/monitor/tasks/TaskMineBlock.js +29 -0
  56. package/out/src/monitor/tasks/TaskMineBlock.js.map +1 -0
  57. package/out/src/services/Services.d.ts +15 -0
  58. package/out/src/services/Services.d.ts.map +1 -1
  59. package/out/src/services/Services.js +59 -4
  60. package/out/src/services/Services.js.map +1 -1
  61. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.d.ts +2 -0
  62. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.d.ts.map +1 -0
  63. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.js +102 -0
  64. package/out/src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.test.js.map +1 -0
  65. package/out/src/services/index.d.ts +1 -0
  66. package/out/src/services/index.d.ts.map +1 -1
  67. package/out/src/services/index.js +1 -0
  68. package/out/src/services/index.js.map +1 -1
  69. package/out/src/services/providers/ArcSSEClient.d.ts +56 -0
  70. package/out/src/services/providers/ArcSSEClient.d.ts.map +1 -0
  71. package/out/src/services/providers/ArcSSEClient.js +122 -0
  72. package/out/src/services/providers/ArcSSEClient.js.map +1 -0
  73. package/out/src/storage/StorageKnex.d.ts +8 -0
  74. package/out/src/storage/StorageKnex.d.ts.map +1 -1
  75. package/out/src/storage/StorageKnex.js +88 -0
  76. package/out/src/storage/StorageKnex.js.map +1 -1
  77. package/out/src/storage/StorageProvider.d.ts +8 -0
  78. package/out/src/storage/StorageProvider.d.ts.map +1 -1
  79. package/out/src/storage/StorageProvider.js +42 -0
  80. package/out/src/storage/StorageProvider.js.map +1 -1
  81. package/out/src/storage/methods/createAction.d.ts.map +1 -1
  82. package/out/src/storage/methods/createAction.js +66 -30
  83. package/out/src/storage/methods/createAction.js.map +1 -1
  84. package/out/src/storage/remoting/StorageServer.js +1 -1
  85. package/out/src/storage/remoting/StorageServer.js.map +1 -1
  86. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,12 @@ This document captures the history of significant changes to the wallet-toolbox
4
4
  The git commit history contains the details but is unable to draw
5
5
  attention to changes that materially alter behavior or extend functionality.
6
6
 
7
+ ## wallet-toolbox 2.0.24
8
+
9
+ Optimize createAction (fewer db transactions)
10
+ Add postBeef services soft timeout failover
11
+ PR 130 randomBytesHex in Setup
12
+
7
13
  ## wallet-toolbox 2.0.23
8
14
 
9
15
  Add output table indices to speed up listOutputs and createAction
package/docs/client.md CHANGED
@@ -6,80 +6,81 @@ 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) | [GenerateChangeSdkChangeInput](#interface-generatechangesdkchangeinput) | [StatusForTxidResult](#interface-statusfortxidresult) |
10
+ | [ArcConfig](#interface-arcconfig) | [GenerateChangeSdkChangeOutput](#interface-generatechangesdkchangeoutput) | [StorageAdminStats](#interface-storageadminstats) |
11
+ | [ArcMinerGetTxData](#interface-arcminergettxdata) | [GenerateChangeSdkInput](#interface-generatechangesdkinput) | [StorageCreateActionResult](#interface-storagecreateactionresult) |
12
+ | [ArcSSEClientOptions](#interface-arcsseclientoptions) | [GenerateChangeSdkOutput](#interface-generatechangesdkoutput) | [StorageCreateTransactionSdkInput](#interface-storagecreatetransactionsdkinput) |
13
+ | [ArcSSEEvent](#interface-arcsseevent) | [GenerateChangeSdkParams](#interface-generatechangesdkparams) | [StorageCreateTransactionSdkOutput](#interface-storagecreatetransactionsdkoutput) |
14
+ | [AuthId](#interface-authid) | [GenerateChangeSdkResult](#interface-generatechangesdkresult) | [StorageFeeModel](#interface-storagefeemodel) |
15
+ | [AuthPayload](#interface-authpayload) | [GenerateChangeSdkStorageChange](#interface-generatechangesdkstoragechange) | [StorageGetBeefOptions](#interface-storagegetbeefoptions) |
16
+ | [BaseBlockHeader](#interface-baseblockheader) | [GetHeaderByteFileLinksResult](#interface-getheaderbytefilelinksresult) | [StorageIdbOptions](#interface-storageidboptions) |
17
+ | [BitailsConfig](#interface-bitailsconfig) | [GetMerklePathResult](#interface-getmerklepathresult) | [StorageIdbSchema](#interface-storageidbschema) |
18
+ | [BitailsMerkleProof](#interface-bitailsmerkleproof) | [GetRawTxResult](#interface-getrawtxresult) | [StorageIdentity](#interface-storageidentity) |
19
+ | [BlockHeader](#interface-blockheader) | [GetReqsAndBeefDetail](#interface-getreqsandbeefdetail) | [StorageInternalizeActionResult](#interface-storageinternalizeactionresult) |
20
+ | [BsvExchangeRate](#interface-bsvexchangerate) | [GetReqsAndBeefResult](#interface-getreqsandbeefresult) | [StorageProcessActionArgs](#interface-storageprocessactionargs) |
21
+ | [BulkFileDataManagerMergeResult](#interface-bulkfiledatamanagermergeresult) | [GetScriptHashHistory](#interface-getscripthashhistory) | [StorageProcessActionResults](#interface-storageprocessactionresults) |
22
+ | [BulkFileDataManagerOptions](#interface-bulkfiledatamanageroptions) | [GetScriptHashHistoryResult](#interface-getscripthashhistoryresult) | [StorageProvenOrReq](#interface-storageprovenorreq) |
23
+ | [BulkHeaderFileInfo](#interface-bulkheaderfileinfo) | [GetStatusForTxidsResult](#interface-getstatusfortxidsresult) | [StorageProviderOptions](#interface-storageprovideroptions) |
24
+ | [BulkHeaderFilesInfo](#interface-bulkheaderfilesinfo) | [GetUtxoStatusDetails](#interface-getutxostatusdetails) | [StorageReaderOptions](#interface-storagereaderoptions) |
25
+ | [BulkIngestorApi](#interface-bulkingestorapi) | [GetUtxoStatusResult](#interface-getutxostatusresult) | [StorageReaderWriterOptions](#interface-storagereaderwriteroptions) |
26
+ | [BulkIngestorBaseOptions](#interface-bulkingestorbaseoptions) | [GroupedPermissionRequest](#interface-groupedpermissionrequest) | [StorageSyncReaderOptions](#interface-storagesyncreaderoptions) |
27
+ | [BulkIngestorCDNOptions](#interface-bulkingestorcdnoptions) | [GroupedPermissions](#interface-groupedpermissions) | [SyncChunk](#interface-syncchunk) |
28
+ | [BulkIngestorWhatsOnChainOptions](#interface-bulkingestorwhatsonchainoptions) | [HeightRangeApi](#interface-heightrangeapi) | [SyncError](#interface-syncerror) |
29
+ | [BulkStorageApi](#interface-bulkstorageapi) | [HeightRanges](#interface-heightranges) | [SyncMap](#interface-syncmap) |
30
+ | [BulkStorageBaseOptions](#interface-bulkstoragebaseoptions) | [KeyPair](#interface-keypair) | [TableCertificate](#interface-tablecertificate) |
31
+ | [BulkSyncResult](#interface-bulksyncresult) | [KeyPairAddress](#interface-keypairaddress) | [TableCertificateField](#interface-tablecertificatefield) |
32
+ | [CertOpsWallet](#interface-certopswallet) | [ListActionsSpecOp](#interface-listactionsspecop) | [TableCertificateX](#interface-tablecertificatex) |
33
+ | [Certifier](#interface-certifier) | [ListOutputsSpecOp](#interface-listoutputsspecop) | [TableCommission](#interface-tablecommission) |
34
+ | [ChaintracksApi](#interface-chaintracksapi) | [LiveBlockHeader](#interface-liveblockheader) | [TableMonitorEvent](#interface-tablemonitorevent) |
35
+ | [ChaintracksAppendableFileApi](#interface-chaintracksappendablefileapi) | [LiveIngestorApi](#interface-liveingestorapi) | [TableOutput](#interface-tableoutput) |
36
+ | [ChaintracksChainTrackerOptions](#interface-chaintrackschaintrackeroptions) | [LiveIngestorBaseOptions](#interface-liveingestorbaseoptions) | [TableOutputBasket](#interface-tableoutputbasket) |
37
+ | [ChaintracksClientApi](#interface-chaintracksclientapi) | [LiveIngestorWhatsOnChainOptions](#interface-liveingestorwhatsonchainoptions) | [TableOutputTag](#interface-tableoutputtag) |
38
+ | [ChaintracksFetchApi](#interface-chaintracksfetchapi) | [MonitorOptions](#interface-monitoroptions) | [TableOutputTagMap](#interface-tableoutputtagmap) |
39
+ | [ChaintracksFsApi](#interface-chaintracksfsapi) | [OutPoint](#interface-outpoint) | [TableOutputX](#interface-tableoutputx) |
40
+ | [ChaintracksInfoApi](#interface-chaintracksinfoapi) | [Paged](#interface-paged) | [TableProvenTx](#interface-tableproventx) |
41
+ | [ChaintracksManagementApi](#interface-chaintracksmanagementapi) | [PendingSignAction](#interface-pendingsignaction) | [TableProvenTxReq](#interface-tableproventxreq) |
42
+ | [ChaintracksOptions](#interface-chaintracksoptions) | [PendingStorageInput](#interface-pendingstorageinput) | [TableProvenTxReqDynamics](#interface-tableproventxreqdynamics) |
43
+ | [ChaintracksPackageInfoApi](#interface-chaintrackspackageinfoapi) | [PermissionRequest](#interface-permissionrequest) | [TableSettings](#interface-tablesettings) |
44
+ | [ChaintracksReadableFileApi](#interface-chaintracksreadablefileapi) | [PermissionToken](#interface-permissiontoken) | [TableSyncState](#interface-tablesyncstate) |
45
+ | [ChaintracksServiceClientOptions](#interface-chaintracksserviceclientoptions) | [PermissionsManagerConfig](#interface-permissionsmanagerconfig) | [TableTransaction](#interface-tabletransaction) |
46
+ | [ChaintracksStorageApi](#interface-chaintracksstorageapi) | [PermissionsModule](#interface-permissionsmodule) | [TableTxLabel](#interface-tabletxlabel) |
47
+ | [ChaintracksStorageBaseOptions](#interface-chaintracksstoragebaseoptions) | [PostBeefResult](#interface-postbeefresult) | [TableTxLabelMap](#interface-tabletxlabelmap) |
48
+ | [ChaintracksStorageBulkFileApi](#interface-chaintracksstoragebulkfileapi) | [PostBeefResultForTxidApi](#interface-postbeefresultfortxidapi) | [TableUser](#interface-tableuser) |
49
+ | [ChaintracksStorageIdbOptions](#interface-chaintracksstorageidboptions) | [PostReqsToNetworkDetails](#interface-postreqstonetworkdetails) | [TaskPurgeParams](#interface-taskpurgeparams) |
50
+ | [ChaintracksStorageIdbSchema](#interface-chaintracksstorageidbschema) | [PostReqsToNetworkResult](#interface-postreqstonetworkresult) | [TrustSettings](#interface-trustsettings) |
51
+ | [ChaintracksStorageIngestApi](#interface-chaintracksstorageingestapi) | [PostTxResultForTxid](#interface-posttxresultfortxid) | [TrxToken](#interface-trxtoken) |
52
+ | [ChaintracksStorageNoDbOptions](#interface-chaintracksstoragenodboptions) | [PostTxResultForTxidError](#interface-posttxresultfortxiderror) | [TscMerkleProofApi](#interface-tscmerkleproofapi) |
53
+ | [ChaintracksStorageQueryApi](#interface-chaintracksstoragequeryapi) | [PostTxsResult](#interface-posttxsresult) | [TxScriptOffsets](#interface-txscriptoffsets) |
54
+ | [ChaintracksWritableFileApi](#interface-chaintrackswritablefileapi) | [ProcessSyncChunkResult](#interface-processsyncchunkresult) | [UMPToken](#interface-umptoken) |
55
+ | [CommitNewTxResults](#interface-commitnewtxresults) | [Profile](#interface-profile) | [UMPTokenInteractor](#interface-umptokeninteractor) |
56
+ | [CompleteAuthResponse](#interface-completeauthresponse) | [ProvenOrRawTx](#interface-provenorrawtx) | [UpdateProvenTxReqWithNewProvenTxArgs](#interface-updateproventxreqwithnewproventxargs) |
57
+ | [CounterpartyPermissionRequest](#interface-counterpartypermissionrequest) | [ProvenTransactionStatus](#interface-proventransactionstatus) | [UpdateProvenTxReqWithNewProvenTxResult](#interface-updateproventxreqwithnewproventxresult) |
58
+ | [CounterpartyPermissions](#interface-counterpartypermissions) | [ProvenTxFromTxidResult](#interface-proventxfromtxidresult) | [ValidateGenerateChangeSdkParamsResult](#interface-validategeneratechangesdkparamsresult) |
59
+ | [CreateActionResultX](#interface-createactionresultx) | [ProvenTxReqHistory](#interface-proventxreqhistory) | [VerifyAndRepairBeefResult](#interface-verifyandrepairbeefresult) |
60
+ | [DeactivedHeader](#interface-deactivedheader) | [ProvenTxReqHistorySummaryApi](#interface-proventxreqhistorysummaryapi) | [WalletArgs](#interface-walletargs) |
61
+ | [EntitySyncMap](#interface-entitysyncmap) | [ProvenTxReqNotify](#interface-proventxreqnotify) | [WalletBalance](#interface-walletbalance) |
62
+ | [EntityTimeStamp](#interface-entitytimestamp) | [ProviderCallHistory](#interface-providercallhistory) | [WalletLoggerArgs](#interface-walletloggerargs) |
63
+ | [ExchangeRatesIoApi](#interface-exchangeratesioapi) | [PurgeParams](#interface-purgeparams) | [WalletPermissionsManagerCallbacks](#interface-walletpermissionsmanagercallbacks) |
64
+ | [ExtendedVerifiableCertificate](#interface-extendedverifiablecertificate) | [PurgeResults](#interface-purgeresults) | [WalletServices](#interface-walletservices) |
65
+ | [FiatExchangeRates](#interface-fiatexchangerates) | [ReproveHeaderResult](#interface-reproveheaderresult) | [WalletServicesOptions](#interface-walletservicesoptions) |
66
+ | [FindCertificateFieldsArgs](#interface-findcertificatefieldsargs) | [ReproveProvenResult](#interface-reproveprovenresult) | [WalletSettings](#interface-walletsettings) |
67
+ | [FindCertificatesArgs](#interface-findcertificatesargs) | [RequestSyncChunkArgs](#interface-requestsyncchunkargs) | [WalletSettingsManagerConfig](#interface-walletsettingsmanagerconfig) |
68
+ | [FindCommissionsArgs](#interface-findcommissionsargs) | [ReviewActionResult](#interface-reviewactionresult) | [WalletSigner](#interface-walletsigner) |
69
+ | [FindForUserSincePagedArgs](#interface-findforusersincepagedargs) | [ScriptTemplateParamsBRC29](#interface-scripttemplateparamsbrc29) | [WalletStorage](#interface-walletstorage) |
70
+ | [FindMonitorEventsArgs](#interface-findmonitoreventsargs) | [ScriptTemplateUnlock](#interface-scripttemplateunlock) | [WalletStorageInfo](#interface-walletstorageinfo) |
71
+ | [FindOutputBasketsArgs](#interface-findoutputbasketsargs) | [ServiceCall](#interface-servicecall) | [WalletStorageProvider](#interface-walletstorageprovider) |
72
+ | [FindOutputTagMapsArgs](#interface-findoutputtagmapsargs) | [ServiceCall](#interface-servicecall) | [WalletStorageReader](#interface-walletstoragereader) |
73
+ | [FindOutputTagsArgs](#interface-findoutputtagsargs) | [ServiceCallHistory](#interface-servicecallhistory) | [WalletStorageSync](#interface-walletstoragesync) |
74
+ | [FindOutputsArgs](#interface-findoutputsargs) | [ServiceCallHistoryCounts](#interface-servicecallhistorycounts) | [WalletStorageSyncReader](#interface-walletstoragesyncreader) |
75
+ | [FindPartialSincePagedArgs](#interface-findpartialsincepagedargs) | [ServiceToCall](#interface-servicetocall) | [WalletStorageWriter](#interface-walletstoragewriter) |
76
+ | [FindProvenTxReqsArgs](#interface-findproventxreqsargs) | [SetupClientWalletArgs](#interface-setupclientwalletargs) | [WalletTheme](#interface-wallettheme) |
77
+ | [FindProvenTxsArgs](#interface-findproventxsargs) | [SetupClientWalletClientArgs](#interface-setupclientwalletclientargs) | [WhatsOnChainServicesOptions](#interface-whatsonchainservicesoptions) |
78
+ | [FindSincePagedArgs](#interface-findsincepagedargs) | [SetupWallet](#interface-setupwallet) | [WocChainInfo](#interface-wocchaininfo) |
79
+ | [FindSyncStatesArgs](#interface-findsyncstatesargs) | [SetupWalletClient](#interface-setupwalletclient) | [WocGetHeaderByteFileLinks](#interface-wocgetheaderbytefilelinks) |
80
+ | [FindTransactionsArgs](#interface-findtransactionsargs) | [SetupWalletIdb](#interface-setupwalletidb) | [WocGetHeadersHeader](#interface-wocgetheadersheader) |
81
+ | [FindTxLabelMapsArgs](#interface-findtxlabelmapsargs) | [SetupWalletIdbArgs](#interface-setupwalletidbargs) | [WocHeader](#interface-wocheader) |
82
+ | [FindTxLabelsArgs](#interface-findtxlabelsargs) | [SignActionResultX](#interface-signactionresultx) | [XValidCreateActionOutput](#interface-xvalidcreateactionoutput) |
83
+ | [FindUsersArgs](#interface-findusersargs) | [StartAuthResponse](#interface-startauthresponse) | |
83
84
 
84
85
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
85
86
 
@@ -186,6 +187,104 @@ See also: [blockHash](./services.md#function-blockhash)
186
187
 
187
188
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
188
189
 
190
+ ---
191
+ ##### Interface: ArcSSEClientOptions
192
+
193
+ ```ts
194
+ export interface ArcSSEClientOptions {
195
+ baseUrl: string;
196
+ callbackToken: string;
197
+ onEvent: (event: ArcSSEEvent) => void;
198
+ onError?: (error: Event) => void;
199
+ onConnected?: () => void;
200
+ onDisconnected?: () => void;
201
+ lastEventId?: string;
202
+ }
203
+ ```
204
+
205
+ See also: [ArcSSEEvent](./services.md#interface-arcsseevent)
206
+
207
+ ###### Property baseUrl
208
+
209
+ Base URL of the Arcade instance (e.g. "https://arcade-us-1.bsvb.tech")
210
+
211
+ ```ts
212
+ baseUrl: string
213
+ ```
214
+
215
+ ###### Property callbackToken
216
+
217
+ Stable per-wallet token matching the X-CallbackToken sent on broadcast
218
+
219
+ ```ts
220
+ callbackToken: string
221
+ ```
222
+
223
+ ###### Property lastEventId
224
+
225
+ Initial lastEventId for catchup on first connect
226
+
227
+ ```ts
228
+ lastEventId?: string
229
+ ```
230
+
231
+ ###### Property onConnected
232
+
233
+ Called when connection is established
234
+
235
+ ```ts
236
+ onConnected?: () => void
237
+ ```
238
+
239
+ ###### Property onDisconnected
240
+
241
+ Called when connection is lost
242
+
243
+ ```ts
244
+ onDisconnected?: () => void
245
+ ```
246
+
247
+ ###### Property onError
248
+
249
+ Called when a connection error occurs
250
+
251
+ ```ts
252
+ onError?: (error: Event) => void
253
+ ```
254
+
255
+ ###### Property onEvent
256
+
257
+ Called for each status event received
258
+
259
+ ```ts
260
+ onEvent: (event: ArcSSEEvent) => void
261
+ ```
262
+ See also: [ArcSSEEvent](./services.md#interface-arcsseevent)
263
+
264
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
265
+
266
+ ---
267
+ ##### Interface: ArcSSEEvent
268
+
269
+ SSE (Server-Sent Events) client for Arcade transaction status updates.
270
+
271
+ Connects to Arcade's `GET /events?callbackToken=<token>` endpoint
272
+ and receives real-time status updates for transactions submitted
273
+ with the matching `X-CallbackToken` header.
274
+
275
+ Supports pause/resume for mobile app lifecycle (background/foreground)
276
+ with automatic catchup via the `Last-Event-ID` mechanism.
277
+
278
+ ```ts
279
+ export interface ArcSSEEvent {
280
+ txid: string;
281
+ txStatus: string;
282
+ timestamp: string;
283
+ }
284
+ ```
285
+
286
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
287
+
189
288
  ---
190
289
  ##### Interface: AuthId
191
290
 
@@ -3659,13 +3758,26 @@ export interface MonitorOptions {
3659
3758
  abandonedMsecs: number;
3660
3759
  unprovenAttemptsLimitTest: number;
3661
3760
  unprovenAttemptsLimitMain: number;
3761
+ callbackToken?: string;
3662
3762
  onTransactionBroadcasted?: (broadcastResult: ReviewActionResult) => Promise<void>;
3663
3763
  onTransactionProven?: (txStatus: ProvenTransactionStatus) => Promise<void>;
3764
+ onTransactionStatusChanged?: (txid: string, newStatus: string) => Promise<void>;
3664
3765
  }
3665
3766
  ```
3666
3767
 
3667
3768
  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)
3668
3769
 
3770
+ ###### Property callbackToken
3771
+
3772
+ Stable callback token for ARC SSE event streaming.
3773
+ When set, TaskArcSSE will open an SSE connection to Arcade's
3774
+ /events endpoint and receive real-time transaction status updates.
3775
+ Must match the X-CallbackToken header sent during broadcast.
3776
+
3777
+ ```ts
3778
+ callbackToken?: string
3779
+ ```
3780
+
3669
3781
  ###### Property msecsWaitPerMerkleProofServiceReq
3670
3782
 
3671
3783
  How many msecs to wait after each getMerkleProof service request.
@@ -8203,41 +8315,41 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
8203
8315
 
8204
8316
  | | | |
8205
8317
  | --- | --- | --- |
8206
- | [ARC](#class-arc) | [EntityProvenTx](#class-entityproventx) | [TaskReorg](#class-taskreorg) |
8207
- | [AuthMethodInteractor](#class-authmethodinteractor) | [EntityProvenTxReq](#class-entityproventxreq) | [TaskReviewStatus](#class-taskreviewstatus) |
8208
- | [BHServiceClient](#class-bhserviceclient) | [EntitySyncState](#class-entitysyncstate) | [TaskSendWaiting](#class-tasksendwaiting) |
8209
- | [Bitails](#class-bitails) | [EntityTransaction](#class-entitytransaction) | [TaskSyncWhenIdle](#class-tasksyncwhenidle) |
8210
- | [BulkFileDataManager](#class-bulkfiledatamanager) | [EntityTxLabel](#class-entitytxlabel) | [TaskUnFail](#class-taskunfail) |
8211
- | [BulkFileDataReader](#class-bulkfiledatareader) | [EntityTxLabelMap](#class-entitytxlabelmap) | [TwilioPhoneInteractor](#class-twiliophoneinteractor) |
8212
- | [BulkFilesReader](#class-bulkfilesreader) | [EntityUser](#class-entityuser) | [WABClient](#class-wabclient) |
8213
- | [BulkFilesReaderFs](#class-bulkfilesreaderfs) | [HeightRange](#class-heightrange) | [WERR_BAD_REQUEST](#class-werr_bad_request) |
8214
- | [BulkFilesReaderStorage](#class-bulkfilesreaderstorage) | [LiveIngestorBase](#class-liveingestorbase) | [WERR_BROADCAST_UNAVAILABLE](#class-werr_broadcast_unavailable) |
8215
- | [BulkHeaderFile](#class-bulkheaderfile) | [LiveIngestorWhatsOnChainPoll](#class-liveingestorwhatsonchainpoll) | [WERR_INSUFFICIENT_FUNDS](#class-werr_insufficient_funds) |
8216
- | [BulkHeaderFileFs](#class-bulkheaderfilefs) | [MergeEntity](#class-mergeentity) | [WERR_INTERNAL](#class-werr_internal) |
8217
- | [BulkHeaderFileStorage](#class-bulkheaderfilestorage) | [Monitor](#class-monitor) | [WERR_INVALID_MERKLE_ROOT](#class-werr_invalid_merkle_root) |
8218
- | [BulkHeaderFiles](#class-bulkheaderfiles) | [OverlayUMPTokenInteractor](#class-overlayumptokeninteractor) | [WERR_INVALID_OPERATION](#class-werr_invalid_operation) |
8219
- | [BulkIngestorBase](#class-bulkingestorbase) | [PersonaIDInteractor](#class-personaidinteractor) | [WERR_INVALID_PARAMETER](#class-werr_invalid_parameter) |
8220
- | [BulkIngestorCDN](#class-bulkingestorcdn) | [PrivilegedKeyManager](#class-privilegedkeymanager) | [WERR_INVALID_PUBLIC_KEY](#class-werr_invalid_public_key) |
8221
- | [BulkIngestorCDNBabbage](#class-bulkingestorcdnbabbage) | [ScriptTemplateBRC29](#class-scripttemplatebrc29) | [WERR_MISSING_PARAMETER](#class-werr_missing_parameter) |
8222
- | [BulkIngestorWhatsOnChainCdn](#class-bulkingestorwhatsonchaincdn) | [SdkWhatsOnChain](#class-sdkwhatsonchain) | [WERR_NETWORK_CHAIN](#class-werr_network_chain) |
8223
- | [BulkStorageBase](#class-bulkstoragebase) | [ServiceCollection](#class-servicecollection) | [WERR_NOT_ACTIVE](#class-werr_not_active) |
8224
- | [CWIStyleWalletManager](#class-cwistylewalletmanager) | [Services](#class-services) | [WERR_NOT_IMPLEMENTED](#class-werr_not_implemented) |
8225
- | [Chaintracks](#class-chaintracks) | [SetupClient](#class-setupclient) | [WERR_REVIEW_ACTIONS](#class-werr_review_actions) |
8226
- | [ChaintracksChainTracker](#class-chaintrackschaintracker) | [SimpleWalletManager](#class-simplewalletmanager) | [WERR_UNAUTHORIZED](#class-werr_unauthorized) |
8227
- | [ChaintracksFetch](#class-chaintracksfetch) | [SingleWriterMultiReaderLock](#class-singlewritermultireaderlock) | [Wallet](#class-wallet) |
8228
- | [ChaintracksServiceClient](#class-chaintracksserviceclient) | [StorageClient](#class-storageclient) | [WalletAuthenticationManager](#class-walletauthenticationmanager) |
8229
- | [ChaintracksStorageBase](#class-chaintracksstoragebase) | [StorageIdb](#class-storageidb) | [WalletError](#class-walleterror) |
8230
- | [ChaintracksStorageIdb](#class-chaintracksstorageidb) | [StorageProvider](#class-storageprovider) | [WalletLogger](#class-walletlogger) |
8231
- | [ChaintracksStorageNoDb](#class-chaintracksstoragenodb) | [StorageReader](#class-storagereader) | [WalletMonitorTask](#class-walletmonitortask) |
8232
- | [DevConsoleInteractor](#class-devconsoleinteractor) | [StorageReaderWriter](#class-storagereaderwriter) | [WalletPermissionsManager](#class-walletpermissionsmanager) |
8233
- | [EntityBase](#class-entitybase) | [StorageSyncReader](#class-storagesyncreader) | [WalletSettingsManager](#class-walletsettingsmanager) |
8234
- | [EntityCertificate](#class-entitycertificate) | [TaskCheckForProofs](#class-taskcheckforproofs) | [WalletSigner](#class-walletsigner) |
8235
- | [EntityCertificateField](#class-entitycertificatefield) | [TaskCheckNoSends](#class-taskchecknosends) | [WalletStorageManager](#class-walletstoragemanager) |
8236
- | [EntityCommission](#class-entitycommission) | [TaskClock](#class-taskclock) | [WhatsOnChain](#class-whatsonchain) |
8237
- | [EntityOutput](#class-entityoutput) | [TaskFailAbandoned](#class-taskfailabandoned) | [WhatsOnChainNoServices](#class-whatsonchainnoservices) |
8238
- | [EntityOutputBasket](#class-entityoutputbasket) | [TaskMonitorCallHistory](#class-taskmonitorcallhistory) | [WhatsOnChainServices](#class-whatsonchainservices) |
8239
- | [EntityOutputTag](#class-entityoutputtag) | [TaskNewHeader](#class-tasknewheader) | |
8240
- | [EntityOutputTagMap](#class-entityoutputtagmap) | [TaskPurge](#class-taskpurge) | |
8318
+ | [ARC](#class-arc) | [EntityOutputTagMap](#class-entityoutputtagmap) | [TaskNewHeader](#class-tasknewheader) |
8319
+ | [ArcSSEClient](#class-arcsseclient) | [EntityProvenTx](#class-entityproventx) | [TaskPurge](#class-taskpurge) |
8320
+ | [AuthMethodInteractor](#class-authmethodinteractor) | [EntityProvenTxReq](#class-entityproventxreq) | [TaskReorg](#class-taskreorg) |
8321
+ | [BHServiceClient](#class-bhserviceclient) | [EntitySyncState](#class-entitysyncstate) | [TaskReviewStatus](#class-taskreviewstatus) |
8322
+ | [Bitails](#class-bitails) | [EntityTransaction](#class-entitytransaction) | [TaskSendWaiting](#class-tasksendwaiting) |
8323
+ | [BulkFileDataManager](#class-bulkfiledatamanager) | [EntityTxLabel](#class-entitytxlabel) | [TaskSyncWhenIdle](#class-tasksyncwhenidle) |
8324
+ | [BulkFileDataReader](#class-bulkfiledatareader) | [EntityTxLabelMap](#class-entitytxlabelmap) | [TaskUnFail](#class-taskunfail) |
8325
+ | [BulkFilesReader](#class-bulkfilesreader) | [EntityUser](#class-entityuser) | [TwilioPhoneInteractor](#class-twiliophoneinteractor) |
8326
+ | [BulkFilesReaderFs](#class-bulkfilesreaderfs) | [HeightRange](#class-heightrange) | [WABClient](#class-wabclient) |
8327
+ | [BulkFilesReaderStorage](#class-bulkfilesreaderstorage) | [LiveIngestorBase](#class-liveingestorbase) | [WERR_BAD_REQUEST](#class-werr_bad_request) |
8328
+ | [BulkHeaderFile](#class-bulkheaderfile) | [LiveIngestorWhatsOnChainPoll](#class-liveingestorwhatsonchainpoll) | [WERR_BROADCAST_UNAVAILABLE](#class-werr_broadcast_unavailable) |
8329
+ | [BulkHeaderFileFs](#class-bulkheaderfilefs) | [MergeEntity](#class-mergeentity) | [WERR_INSUFFICIENT_FUNDS](#class-werr_insufficient_funds) |
8330
+ | [BulkHeaderFileStorage](#class-bulkheaderfilestorage) | [Monitor](#class-monitor) | [WERR_INTERNAL](#class-werr_internal) |
8331
+ | [BulkHeaderFiles](#class-bulkheaderfiles) | [OverlayUMPTokenInteractor](#class-overlayumptokeninteractor) | [WERR_INVALID_MERKLE_ROOT](#class-werr_invalid_merkle_root) |
8332
+ | [BulkIngestorBase](#class-bulkingestorbase) | [PersonaIDInteractor](#class-personaidinteractor) | [WERR_INVALID_OPERATION](#class-werr_invalid_operation) |
8333
+ | [BulkIngestorCDN](#class-bulkingestorcdn) | [PrivilegedKeyManager](#class-privilegedkeymanager) | [WERR_INVALID_PARAMETER](#class-werr_invalid_parameter) |
8334
+ | [BulkIngestorCDNBabbage](#class-bulkingestorcdnbabbage) | [ScriptTemplateBRC29](#class-scripttemplatebrc29) | [WERR_INVALID_PUBLIC_KEY](#class-werr_invalid_public_key) |
8335
+ | [BulkIngestorWhatsOnChainCdn](#class-bulkingestorwhatsonchaincdn) | [SdkWhatsOnChain](#class-sdkwhatsonchain) | [WERR_MISSING_PARAMETER](#class-werr_missing_parameter) |
8336
+ | [BulkStorageBase](#class-bulkstoragebase) | [ServiceCollection](#class-servicecollection) | [WERR_NETWORK_CHAIN](#class-werr_network_chain) |
8337
+ | [CWIStyleWalletManager](#class-cwistylewalletmanager) | [Services](#class-services) | [WERR_NOT_ACTIVE](#class-werr_not_active) |
8338
+ | [Chaintracks](#class-chaintracks) | [SetupClient](#class-setupclient) | [WERR_NOT_IMPLEMENTED](#class-werr_not_implemented) |
8339
+ | [ChaintracksChainTracker](#class-chaintrackschaintracker) | [SimpleWalletManager](#class-simplewalletmanager) | [WERR_REVIEW_ACTIONS](#class-werr_review_actions) |
8340
+ | [ChaintracksFetch](#class-chaintracksfetch) | [SingleWriterMultiReaderLock](#class-singlewritermultireaderlock) | [WERR_UNAUTHORIZED](#class-werr_unauthorized) |
8341
+ | [ChaintracksServiceClient](#class-chaintracksserviceclient) | [StorageClient](#class-storageclient) | [Wallet](#class-wallet) |
8342
+ | [ChaintracksStorageBase](#class-chaintracksstoragebase) | [StorageIdb](#class-storageidb) | [WalletAuthenticationManager](#class-walletauthenticationmanager) |
8343
+ | [ChaintracksStorageIdb](#class-chaintracksstorageidb) | [StorageProvider](#class-storageprovider) | [WalletError](#class-walleterror) |
8344
+ | [ChaintracksStorageNoDb](#class-chaintracksstoragenodb) | [StorageReader](#class-storagereader) | [WalletLogger](#class-walletlogger) |
8345
+ | [DevConsoleInteractor](#class-devconsoleinteractor) | [StorageReaderWriter](#class-storagereaderwriter) | [WalletMonitorTask](#class-walletmonitortask) |
8346
+ | [EntityBase](#class-entitybase) | [StorageSyncReader](#class-storagesyncreader) | [WalletPermissionsManager](#class-walletpermissionsmanager) |
8347
+ | [EntityCertificate](#class-entitycertificate) | [TaskArcSSE](#class-taskarcsse) | [WalletSettingsManager](#class-walletsettingsmanager) |
8348
+ | [EntityCertificateField](#class-entitycertificatefield) | [TaskCheckForProofs](#class-taskcheckforproofs) | [WalletSigner](#class-walletsigner) |
8349
+ | [EntityCommission](#class-entitycommission) | [TaskCheckNoSends](#class-taskchecknosends) | [WalletStorageManager](#class-walletstoragemanager) |
8350
+ | [EntityOutput](#class-entityoutput) | [TaskClock](#class-taskclock) | [WhatsOnChain](#class-whatsonchain) |
8351
+ | [EntityOutputBasket](#class-entityoutputbasket) | [TaskFailAbandoned](#class-taskfailabandoned) | [WhatsOnChainNoServices](#class-whatsonchainnoservices) |
8352
+ | [EntityOutputTag](#class-entityoutputtag) | [TaskMonitorCallHistory](#class-taskmonitorcallhistory) | [WhatsOnChainServices](#class-whatsonchainservices) |
8241
8353
 
8242
8354
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
8243
8355
 
@@ -8336,6 +8448,41 @@ See also: [PostTxResultForTxid](./client.md#interface-posttxresultfortxid)
8336
8448
 
8337
8449
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
8338
8450
 
8451
+ ---
8452
+ ##### Class: ArcSSEClient
8453
+
8454
+ ```ts
8455
+ export class ArcSSEClient {
8456
+ constructor(private readonly options: ArcSSEClientOptions)
8457
+ get lastEventId(): string | undefined
8458
+ get connected(): boolean
8459
+ connect(): void
8460
+ disconnect(): void
8461
+ pause(): void
8462
+ resume(): void
8463
+ }
8464
+ ```
8465
+
8466
+ See also: [ArcSSEClientOptions](./services.md#interface-arcsseclientoptions)
8467
+
8468
+ ###### Method pause
8469
+
8470
+ Close the SSE connection but preserve lastEventId for later catchup
8471
+
8472
+ ```ts
8473
+ pause(): void
8474
+ ```
8475
+
8476
+ ###### Method resume
8477
+
8478
+ Reopen the SSE connection; server replays missed events via Last-Event-ID
8479
+
8480
+ ```ts
8481
+ resume(): void
8482
+ ```
8483
+
8484
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
8485
+
8339
8486
  ---
8340
8487
  ##### Class: AuthMethodInteractor
8341
8488
 
@@ -11248,6 +11395,7 @@ export class Monitor {
11248
11395
  headersSubscriptionPromise?: Promise<string>;
11249
11396
  onTransactionBroadcasted?: (broadcastResult: ReviewActionResult) => Promise<void>;
11250
11397
  onTransactionProven?: (txStatus: ProvenTransactionStatus) => Promise<void>;
11398
+ onTransactionStatusChanged?: (txid: string, newStatus: string) => Promise<void>;
11251
11399
  constructor(options: MonitorOptions)
11252
11400
  async destroy(): Promise<void>
11253
11401
  static readonly oneSecond = 1000;
@@ -11284,6 +11432,9 @@ export class Monitor {
11284
11432
  processNewBlockHeader(header: BlockHeader): void
11285
11433
  callOnBroadcastedTransaction(broadcastResult: ReviewActionResult): void
11286
11434
  callOnProvenTransaction(txStatus: ProvenTransactionStatus): void
11435
+ callOnTransactionStatusChanged(txid: string, newStatus: string): void
11436
+ pauseSSE(): void
11437
+ resumeSSE(): void
11287
11438
  deactivatedHeaders: DeactivedHeader[] = [];
11288
11439
  processReorg(depth: number, oldTip: BlockHeader, newTip: BlockHeader, deactivatedHeaders?: BlockHeader[]): void
11289
11440
  processHeader(header: BlockHeader): void
@@ -11350,6 +11501,23 @@ callOnProvenTransaction(txStatus: ProvenTransactionStatus): void
11350
11501
  ```
11351
11502
  See also: [ProvenTransactionStatus](./client.md#interface-proventransactionstatus)
11352
11503
 
11504
+ ###### Method callOnTransactionStatusChanged
11505
+
11506
+ Called by TaskArcSSE when an SSE status event is received from Arcade.
11507
+
11508
+ ```ts
11509
+ callOnTransactionStatusChanged(txid: string, newStatus: string): void
11510
+ ```
11511
+
11512
+ ###### Method pauseSSE
11513
+
11514
+ Pause the SSE connection (e.g. when mobile app goes to background).
11515
+ The lastEventId is preserved for catchup on resume.
11516
+
11517
+ ```ts
11518
+ pauseSSE(): void
11519
+ ```
11520
+
11353
11521
  ###### Method processHeader
11354
11522
 
11355
11523
  Handler for new header events from Chaintracks.
@@ -11389,6 +11557,15 @@ processReorg(depth: number, oldTip: BlockHeader, newTip: BlockHeader, deactivate
11389
11557
  ```
11390
11558
  See also: [BlockHeader](./client.md#interface-blockheader)
11391
11559
 
11560
+ ###### Method resumeSSE
11561
+
11562
+ Resume the SSE connection (e.g. when mobile app returns to foreground).
11563
+ Missed events are replayed by the server via Last-Event-ID.
11564
+
11565
+ ```ts
11566
+ resumeSSE(): void
11567
+ ```
11568
+
11392
11569
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
11393
11570
 
11394
11571
  ---
@@ -11733,6 +11910,9 @@ export class Services implements WalletServices {
11733
11910
  async getUtxoStatus(output: string, outputFormat?: GetUtxoStatusOutputFormat, outpoint?: string, useNext?: boolean, logger?: WalletLoggerInterface): Promise<GetUtxoStatusResult>
11734
11911
  async getScriptHashHistory(hash: string, useNext?: boolean, logger?: WalletLoggerInterface): Promise<GetScriptHashHistoryResult>
11735
11912
  postBeefMode: "PromiseAll" | "UntilSuccess" = "UntilSuccess";
11913
+ postBeefUntilSuccessSoftTimeoutMs = 5000;
11914
+ postBeefUntilSuccessSoftTimeoutPerKbMs = 50;
11915
+ postBeefUntilSuccessSoftTimeoutMaxMs = 30000;
11736
11916
  async postBeef(beef: Beef, txids: string[], logger?: WalletLoggerInterface): Promise<PostBeefResult[]>
11737
11917
  async getRawTx(txid: string, useNext?: boolean): Promise<GetRawTxResult>
11738
11918
  async invokeChaintracksWithRetry<R>(method: () => Promise<R>): Promise<R>
@@ -11748,6 +11928,32 @@ export class Services implements WalletServices {
11748
11928
 
11749
11929
  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)
11750
11930
 
11931
+ ###### Property postBeefUntilSuccessSoftTimeoutMaxMs
11932
+
11933
+ Upper bound for adaptive soft-timeout in `UntilSuccess` mode.
11934
+
11935
+ ```ts
11936
+ postBeefUntilSuccessSoftTimeoutMaxMs = 30000
11937
+ ```
11938
+
11939
+ ###### Property postBeefUntilSuccessSoftTimeoutMs
11940
+
11941
+ Soft timeout used for each provider call in `UntilSuccess` mode.
11942
+ This bounds request latency when a provider hangs before failover.
11943
+
11944
+ ```ts
11945
+ postBeefUntilSuccessSoftTimeoutMs = 5000
11946
+ ```
11947
+
11948
+ ###### Property postBeefUntilSuccessSoftTimeoutPerKbMs
11949
+
11950
+ Additional soft-timeout budget (ms) per KiB of serialized Beef payload.
11951
+ Helps avoid false timeout failover on legitimately large submissions.
11952
+
11953
+ ```ts
11954
+ postBeefUntilSuccessSoftTimeoutPerKbMs = 50
11955
+ ```
11956
+
11751
11957
  ###### Method hashOutputScript
11752
11958
 
11753
11959
  ```ts
@@ -13186,6 +13392,14 @@ export abstract class StorageProvider extends StorageReaderWriter implements Wal
13186
13392
  abstract listActions(auth: AuthId, args: Validation.ValidListActionsArgs): Promise<ListActionsResult>;
13187
13393
  abstract listOutputs(auth: AuthId, args: Validation.ValidListOutputsArgs): Promise<ListOutputsResult>;
13188
13394
  abstract countChangeInputs(userId: number, basketId: number, excludeSending: boolean): Promise<number>;
13395
+ async findOutputsByIds(outputIds: number[], trx?: TrxToken): Promise<Record<number, TableOutput>>
13396
+ async findOutputsByOutpoints(userId: number, outpoints: Array<{
13397
+ txid: string;
13398
+ vout: number;
13399
+ }>, trx?: TrxToken): Promise<Record<string, TableOutput>>
13400
+ async findOrInsertOutputBasketsBulk(userId: number, names: string[], trx?: TrxToken): Promise<Record<string, TableOutputBasket>>
13401
+ async findOrInsertOutputTagsBulk(userId: number, tags: string[], trx?: TrxToken): Promise<Record<string, TableOutputTag>>
13402
+ async sumSpendableSatoshisInBasket(userId: number, basketId: number, excludeSending: boolean, trx?: TrxToken): Promise<number>
13189
13403
  abstract findCertificatesAuth(auth: AuthId, args: FindCertificatesArgs): Promise<TableCertificateX[]>;
13190
13404
  abstract findOutputBasketsAuth(auth: AuthId, args: FindOutputBasketsArgs): Promise<TableOutputBasket[]>;
13191
13405
  abstract findOutputsAuth(auth: AuthId, args: FindOutputsArgs): Promise<TableOutput[]>;
@@ -13512,6 +13726,33 @@ See also: [AuthId](./client.md#interface-authid), [RequestSyncChunkArgs](./clien
13512
13726
 
13513
13727
  Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
13514
13728
 
13729
+ ---
13730
+ ##### Class: TaskArcSSE
13731
+
13732
+ Monitor task that manages an SSE connection to Arcade for real-time
13733
+ transaction status updates.
13734
+
13735
+ Events are queued by the SSE callback and processed on each monitor cycle.
13736
+ On MINED events, triggers TaskCheckForProofs to fetch merkle proofs.
13737
+
13738
+ ```ts
13739
+ export class TaskArcSSE extends WalletMonitorTask {
13740
+ static taskName = "ArcSSE";
13741
+ constructor(monitor: Monitor)
13742
+ override async asyncSetup(): Promise<void>
13743
+ trigger(_nowMsecsSinceEpoch: number): {
13744
+ run: boolean;
13745
+ }
13746
+ async runTask(): Promise<string>
13747
+ pause(): void
13748
+ resume(): void
13749
+ }
13750
+ ```
13751
+
13752
+ See also: [Monitor](./monitor.md#class-monitor), [WalletMonitorTask](./monitor.md#class-walletmonitortask)
13753
+
13754
+ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
13755
+
13515
13756
  ---
13516
13757
  ##### Class: TaskCheckForProofs
13517
13758