@bsv/wallet-toolbox 1.3.28 → 1.3.30
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 +24 -0
- package/docs/client.md +550 -172
- package/docs/monitor.md +25 -7
- package/docs/services.md +136 -23
- package/docs/storage.md +53 -22
- package/docs/wallet.md +550 -172
- package/mobile/out/src/monitor/Monitor.js +1 -1
- package/mobile/out/src/monitor/Monitor.js.map +1 -1
- package/mobile/out/src/sdk/WalletServices.interfaces.d.ts.map +1 -1
- package/mobile/out/src/services/ServiceCollection.d.ts +3 -2
- package/mobile/out/src/services/ServiceCollection.d.ts.map +1 -1
- package/mobile/out/src/services/ServiceCollection.js +5 -4
- package/mobile/out/src/services/ServiceCollection.js.map +1 -1
- package/mobile/out/src/services/Services.d.ts +1 -0
- package/mobile/out/src/services/Services.d.ts.map +1 -1
- package/mobile/out/src/services/Services.js +29 -7
- package/mobile/out/src/services/Services.js.map +1 -1
- package/mobile/out/src/services/createDefaultWalletServicesOptions.d.ts.map +1 -1
- package/mobile/out/src/services/createDefaultWalletServicesOptions.js +1 -3
- package/mobile/out/src/services/createDefaultWalletServicesOptions.js.map +1 -1
- package/mobile/out/src/signer/methods/completeSignedTransaction.d.ts +10 -0
- package/mobile/out/src/signer/methods/completeSignedTransaction.d.ts.map +1 -0
- package/mobile/out/src/signer/methods/completeSignedTransaction.js +104 -0
- package/mobile/out/src/signer/methods/completeSignedTransaction.js.map +1 -0
- package/mobile/out/src/signer/methods/createAction.d.ts +2 -3
- package/mobile/out/src/signer/methods/createAction.d.ts.map +1 -1
- package/mobile/out/src/signer/methods/createAction.js +8 -46
- package/mobile/out/src/signer/methods/createAction.js.map +1 -1
- package/mobile/out/src/signer/methods/signAction.d.ts +2 -4
- package/mobile/out/src/signer/methods/signAction.d.ts.map +1 -1
- package/mobile/out/src/signer/methods/signAction.js +7 -54
- package/mobile/out/src/signer/methods/signAction.js.map +1 -1
- package/mobile/out/src/storage/methods/createAction.d.ts.map +1 -1
- package/mobile/out/src/storage/methods/createAction.js.map +1 -1
- package/mobile/package-lock.json +2 -2
- package/mobile/package.json +1 -1
- package/out/src/monitor/Monitor.js +1 -1
- package/out/src/monitor/Monitor.js.map +1 -1
- package/out/src/sdk/WalletServices.interfaces.d.ts.map +1 -1
- package/out/src/services/ServiceCollection.d.ts +3 -2
- package/out/src/services/ServiceCollection.d.ts.map +1 -1
- package/out/src/services/ServiceCollection.js +5 -4
- package/out/src/services/ServiceCollection.js.map +1 -1
- package/out/src/services/Services.d.ts +1 -0
- package/out/src/services/Services.d.ts.map +1 -1
- package/out/src/services/Services.js +29 -7
- package/out/src/services/Services.js.map +1 -1
- package/out/src/services/createDefaultWalletServicesOptions.d.ts.map +1 -1
- package/out/src/services/createDefaultWalletServicesOptions.js +1 -3
- package/out/src/services/createDefaultWalletServicesOptions.js.map +1 -1
- package/out/src/signer/methods/completeSignedTransaction.d.ts +10 -0
- package/out/src/signer/methods/completeSignedTransaction.d.ts.map +1 -0
- package/out/src/signer/methods/completeSignedTransaction.js +104 -0
- package/out/src/signer/methods/completeSignedTransaction.js.map +1 -0
- package/out/src/signer/methods/createAction.d.ts +2 -3
- package/out/src/signer/methods/createAction.d.ts.map +1 -1
- package/out/src/signer/methods/createAction.js +8 -46
- package/out/src/signer/methods/createAction.js.map +1 -1
- package/out/src/signer/methods/signAction.d.ts +2 -4
- package/out/src/signer/methods/signAction.d.ts.map +1 -1
- package/out/src/signer/methods/signAction.js +7 -54
- package/out/src/signer/methods/signAction.js.map +1 -1
- package/out/src/storage/StorageKnex.d.ts.map +1 -1
- package/out/src/storage/StorageKnex.js +7 -2
- package/out/src/storage/StorageKnex.js.map +1 -1
- package/out/src/storage/methods/createAction.d.ts.map +1 -1
- package/out/src/storage/methods/createAction.js.map +1 -1
- package/out/test/Wallet/support/operations.man.test.js +23 -5
- package/out/test/Wallet/support/operations.man.test.js.map +1 -1
- package/out/test/wallet/action/createAction2.test.d.ts.map +1 -1
- package/out/test/wallet/action/createAction2.test.js +1 -0
- package/out/test/wallet/action/createAction2.test.js.map +1 -1
- package/out/tsconfig.all.tsbuildinfo +1 -1
- package/package.json +1 -1
- package/src/monitor/Monitor.ts +1 -1
- package/src/sdk/WalletServices.interfaces.ts +2 -2
- package/src/services/ServiceCollection.ts +15 -10
- package/src/services/Services.ts +53 -42
- package/src/services/createDefaultWalletServicesOptions.ts +1 -4
- package/src/signer/methods/completeSignedTransaction.ts +115 -0
- package/src/signer/methods/createAction.ts +9 -68
- package/src/signer/methods/signAction.ts +11 -78
- package/src/storage/StorageKnex.ts +45 -14
- package/src/storage/StorageProvider.ts +1 -1
- package/src/storage/methods/createAction.ts +4 -1
- package/test/Wallet/support/operations.man.test.ts +29 -10
- package/test/wallet/action/createAction2.test.ts +1 -0
package/docs/monitor.md
CHANGED
|
@@ -121,13 +121,13 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
121
121
|
|
|
122
122
|
| | |
|
|
123
123
|
| --- | --- |
|
|
124
|
-
| [Monitor](#class-monitor) | [
|
|
125
|
-
| [MonitorDaemon](#class-monitordaemon) | [
|
|
126
|
-
| [TaskCheckForProofs](#class-taskcheckforproofs) | [
|
|
127
|
-
| [TaskCheckNoSends](#class-taskchecknosends) | [
|
|
128
|
-
| [TaskClock](#class-taskclock) | [
|
|
129
|
-
| [TaskFailAbandoned](#class-taskfailabandoned) | [
|
|
130
|
-
| [
|
|
124
|
+
| [Monitor](#class-monitor) | [TaskNewHeader](#class-tasknewheader) |
|
|
125
|
+
| [MonitorDaemon](#class-monitordaemon) | [TaskPurge](#class-taskpurge) |
|
|
126
|
+
| [TaskCheckForProofs](#class-taskcheckforproofs) | [TaskReviewStatus](#class-taskreviewstatus) |
|
|
127
|
+
| [TaskCheckNoSends](#class-taskchecknosends) | [TaskSendWaiting](#class-tasksendwaiting) |
|
|
128
|
+
| [TaskClock](#class-taskclock) | [TaskSyncWhenIdle](#class-tasksyncwhenidle) |
|
|
129
|
+
| [TaskFailAbandoned](#class-taskfailabandoned) | [TaskUnFail](#class-taskunfail) |
|
|
130
|
+
| [TaskMonitorCallHistory](#class-taskmonitorcallhistory) | [WalletMonitorTask](#class-walletmonitortask) |
|
|
131
131
|
|
|
132
132
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
133
133
|
|
|
@@ -415,6 +415,24 @@ See also: [Monitor](./monitor.md#class-monitor), [WalletMonitorTask](./monitor.m
|
|
|
415
415
|
|
|
416
416
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
417
417
|
|
|
418
|
+
---
|
|
419
|
+
##### Class: TaskMonitorCallHistory
|
|
420
|
+
|
|
421
|
+
```ts
|
|
422
|
+
export class TaskMonitorCallHistory extends WalletMonitorTask {
|
|
423
|
+
static taskName = "MonitorCallHistory";
|
|
424
|
+
constructor(monitor: Monitor, public triggerMsecs = monitor.oneMinute * 12)
|
|
425
|
+
trigger(nowMsecsSinceEpoch: number): {
|
|
426
|
+
run: boolean;
|
|
427
|
+
}
|
|
428
|
+
async runTask(): Promise<string>
|
|
429
|
+
}
|
|
430
|
+
```
|
|
431
|
+
|
|
432
|
+
See also: [Monitor](./monitor.md#class-monitor), [WalletMonitorTask](./monitor.md#class-walletmonitortask)
|
|
433
|
+
|
|
434
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
435
|
+
|
|
418
436
|
---
|
|
419
437
|
##### Class: TaskNewHeader
|
|
420
438
|
|
package/docs/services.md
CHANGED
|
@@ -31,6 +31,8 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
31
31
|
| [BlockHeader](#interface-blockheader) |
|
|
32
32
|
| [ExchangeRatesIoApi](#interface-exchangeratesioapi) |
|
|
33
33
|
| [LiveBlockHeader](#interface-liveblockheader) |
|
|
34
|
+
| [ServiceCall](#interface-servicecall) |
|
|
35
|
+
| [ServiceToCall](#interface-servicetocall) |
|
|
34
36
|
|
|
35
37
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
36
38
|
|
|
@@ -345,6 +347,76 @@ previousHeaderId: number | null
|
|
|
345
347
|
|
|
346
348
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
347
349
|
|
|
350
|
+
---
|
|
351
|
+
##### Interface: ServiceCall
|
|
352
|
+
|
|
353
|
+
```ts
|
|
354
|
+
export interface ServiceCall {
|
|
355
|
+
when: Date | string;
|
|
356
|
+
msecs: number;
|
|
357
|
+
success: boolean;
|
|
358
|
+
result?: string;
|
|
359
|
+
error?: {
|
|
360
|
+
message: string;
|
|
361
|
+
code: string;
|
|
362
|
+
};
|
|
363
|
+
}
|
|
364
|
+
```
|
|
365
|
+
|
|
366
|
+
###### Property error
|
|
367
|
+
|
|
368
|
+
Error code and message iff success is false and a exception was thrown.
|
|
369
|
+
|
|
370
|
+
```ts
|
|
371
|
+
error?: {
|
|
372
|
+
message: string;
|
|
373
|
+
code: string;
|
|
374
|
+
}
|
|
375
|
+
```
|
|
376
|
+
|
|
377
|
+
###### Property result
|
|
378
|
+
|
|
379
|
+
Simple text summary of result. e.g. `not a valid utxo` or `valid utxo`
|
|
380
|
+
|
|
381
|
+
```ts
|
|
382
|
+
result?: string
|
|
383
|
+
```
|
|
384
|
+
|
|
385
|
+
###### Property success
|
|
386
|
+
|
|
387
|
+
true iff service provider successfully processed the request
|
|
388
|
+
false iff service provider failed to process the request which includes thrown errors.
|
|
389
|
+
|
|
390
|
+
```ts
|
|
391
|
+
success: boolean
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
###### Property when
|
|
395
|
+
|
|
396
|
+
string value must be Date's toISOString format.
|
|
397
|
+
|
|
398
|
+
```ts
|
|
399
|
+
when: Date | string
|
|
400
|
+
```
|
|
401
|
+
|
|
402
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
403
|
+
|
|
404
|
+
---
|
|
405
|
+
##### Interface: ServiceToCall
|
|
406
|
+
|
|
407
|
+
```ts
|
|
408
|
+
export interface ServiceToCall<T> {
|
|
409
|
+
providerName: string;
|
|
410
|
+
serviceName: string;
|
|
411
|
+
service: T;
|
|
412
|
+
call: ServiceCall;
|
|
413
|
+
}
|
|
414
|
+
```
|
|
415
|
+
|
|
416
|
+
See also: [ServiceCall](./services.md#interface-servicecall)
|
|
417
|
+
|
|
418
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
419
|
+
|
|
348
420
|
---
|
|
349
421
|
#### Classes
|
|
350
422
|
|
|
@@ -367,15 +439,16 @@ Represents an ARC transaction broadcaster.
|
|
|
367
439
|
|
|
368
440
|
```ts
|
|
369
441
|
export class ARC {
|
|
442
|
+
readonly name: string;
|
|
370
443
|
readonly URL: string;
|
|
371
444
|
readonly apiKey: string | undefined;
|
|
372
445
|
readonly deploymentId: string;
|
|
373
446
|
readonly callbackUrl: string | undefined;
|
|
374
447
|
readonly callbackToken: string | undefined;
|
|
375
448
|
readonly headers: Record<string, string> | undefined;
|
|
376
|
-
constructor(URL: string, config?: ArcConfig);
|
|
377
|
-
constructor(URL: string, apiKey?: string);
|
|
378
|
-
constructor(URL: string, config?: string | ArcConfig)
|
|
449
|
+
constructor(URL: string, config?: ArcConfig, name?: string);
|
|
450
|
+
constructor(URL: string, apiKey?: string, name?: string);
|
|
451
|
+
constructor(URL: string, config?: string | ArcConfig, name?: string)
|
|
379
452
|
async postRawTx(rawTx: HexString, txids?: string[]): Promise<sdk.PostTxResultForTxid>
|
|
380
453
|
async postBeef(beef: Beef, txids: string[]): Promise<sdk.PostBeefResult>
|
|
381
454
|
async getTxData(txid: string): Promise<ArcMinerGetTxData>
|
|
@@ -389,7 +462,7 @@ See also: [ArcConfig](./services.md#interface-arcconfig), [ArcMinerGetTxData](./
|
|
|
389
462
|
Constructs an instance of the ARC broadcaster.
|
|
390
463
|
|
|
391
464
|
```ts
|
|
392
|
-
constructor(URL: string, config?: ArcConfig)
|
|
465
|
+
constructor(URL: string, config?: ArcConfig, name?: string)
|
|
393
466
|
```
|
|
394
467
|
See also: [ArcConfig](./services.md#interface-arcconfig)
|
|
395
468
|
|
|
@@ -405,7 +478,7 @@ Argument Details
|
|
|
405
478
|
Constructs an instance of the ARC broadcaster.
|
|
406
479
|
|
|
407
480
|
```ts
|
|
408
|
-
constructor(URL: string, apiKey?: string)
|
|
481
|
+
constructor(URL: string, apiKey?: string, name?: string)
|
|
409
482
|
```
|
|
410
483
|
|
|
411
484
|
Argument Details
|
|
@@ -544,7 +617,9 @@ export class ServiceCollection<T> {
|
|
|
544
617
|
service: T;
|
|
545
618
|
}[];
|
|
546
619
|
_index: number;
|
|
547
|
-
|
|
620
|
+
readonly since: Date;
|
|
621
|
+
_historyByProvider: Record<string, ProviderCallHistory> = {};
|
|
622
|
+
constructor(public serviceName: string, services?: {
|
|
548
623
|
name: string;
|
|
549
624
|
service: T;
|
|
550
625
|
}[])
|
|
@@ -555,15 +630,45 @@ export class ServiceCollection<T> {
|
|
|
555
630
|
remove(name: string): void
|
|
556
631
|
get name()
|
|
557
632
|
get service()
|
|
633
|
+
getServiceToCall(i: number): ServiceToCall<T>
|
|
634
|
+
get serviceToCall(): ServiceToCall<T>
|
|
635
|
+
get allServicesToCall(): ServiceToCall<T>[]
|
|
558
636
|
get allServices()
|
|
559
637
|
get count()
|
|
560
638
|
get index()
|
|
561
639
|
reset()
|
|
562
640
|
next(): number
|
|
563
641
|
clone(): ServiceCollection<T>
|
|
642
|
+
_addServiceCall(providerName: string, call: ServiceCall): ProviderCallHistory
|
|
643
|
+
getDuration(since: Date | string): number
|
|
644
|
+
addServiceCallSuccess(stc: ServiceToCall<T>, result?: string): void
|
|
645
|
+
addServiceCallFailure(stc: ServiceToCall<T>, result?: string): void
|
|
646
|
+
addServiceCallError(stc: ServiceToCall<T>, error: WalletError): void
|
|
647
|
+
getServiceCallHistory(reset?: boolean): ServiceCallHistory
|
|
564
648
|
}
|
|
565
649
|
```
|
|
566
650
|
|
|
651
|
+
See also: [ProviderCallHistory](./client.md#interface-providercallhistory), [ServiceCall](./services.md#interface-servicecall), [ServiceCallHistory](./client.md#interface-servicecallhistory), [ServiceToCall](./services.md#interface-servicetocall), [WalletError](./client.md#class-walleterror)
|
|
652
|
+
|
|
653
|
+
###### Property since
|
|
654
|
+
|
|
655
|
+
Start of currentCounts interval. Initially instance construction time.
|
|
656
|
+
|
|
657
|
+
```ts
|
|
658
|
+
readonly since: Date
|
|
659
|
+
```
|
|
660
|
+
|
|
661
|
+
###### Method getServiceCallHistory
|
|
662
|
+
|
|
663
|
+
```ts
|
|
664
|
+
getServiceCallHistory(reset?: boolean): ServiceCallHistory
|
|
665
|
+
```
|
|
666
|
+
See also: [ServiceCallHistory](./client.md#interface-servicecallhistory)
|
|
667
|
+
|
|
668
|
+
Returns
|
|
669
|
+
|
|
670
|
+
A copy of current service call history
|
|
671
|
+
|
|
567
672
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
568
673
|
|
|
569
674
|
---
|
|
@@ -574,7 +679,8 @@ export class Services implements sdk.WalletServices {
|
|
|
574
679
|
static createDefaultOptions(chain: sdk.Chain): sdk.WalletServicesOptions
|
|
575
680
|
options: sdk.WalletServicesOptions;
|
|
576
681
|
whatsonchain: WhatsOnChain;
|
|
577
|
-
|
|
682
|
+
arcTaal: ARC;
|
|
683
|
+
arcGorillaPool?: ARC;
|
|
578
684
|
bitails: Bitails;
|
|
579
685
|
getMerklePathServices: ServiceCollection<sdk.GetMerklePathService>;
|
|
580
686
|
getRawTxServices: ServiceCollection<sdk.GetRawTxService>;
|
|
@@ -585,6 +691,7 @@ export class Services implements sdk.WalletServices {
|
|
|
585
691
|
updateFiatExchangeRateServices: ServiceCollection<sdk.UpdateFiatExchangeRateService>;
|
|
586
692
|
chain: sdk.Chain;
|
|
587
693
|
constructor(optionsOrChain: sdk.Chain | sdk.WalletServicesOptions)
|
|
694
|
+
getServicesCallHistory(reset?: boolean): ServicesCallHistory
|
|
588
695
|
async getChainTracker(): Promise<ChainTracker>
|
|
589
696
|
async getBsvExchangeRate(): Promise<number>
|
|
590
697
|
async getFiatExchangeRate(currency: "USD" | "GBP" | "EUR", base?: "USD" | "GBP" | "EUR"): Promise<number>
|
|
@@ -597,7 +704,7 @@ export class Services implements sdk.WalletServices {
|
|
|
597
704
|
async isUtxo(output: TableOutput): Promise<boolean>
|
|
598
705
|
async getUtxoStatus(output: string, outputFormat?: sdk.GetUtxoStatusOutputFormat, outpoint?: string, useNext?: boolean): Promise<sdk.GetUtxoStatusResult>
|
|
599
706
|
async getScriptHashHistory(hash: string, useNext?: boolean): Promise<sdk.GetScriptHashHistoryResult>
|
|
600
|
-
|
|
707
|
+
postBeefMode: "PromiseAll" | "UntilSuccess" = "UntilSuccess";
|
|
601
708
|
async postBeef(beef: Beef, txids: string[]): Promise<sdk.PostBeefResult[]>
|
|
602
709
|
async getRawTx(txid: string, useNext?: boolean): Promise<sdk.GetRawTxResult>
|
|
603
710
|
async invokeChaintracksWithRetry<R>(method: () => Promise<R>): Promise<R>
|
|
@@ -612,7 +719,7 @@ export class Services implements sdk.WalletServices {
|
|
|
612
719
|
}
|
|
613
720
|
```
|
|
614
721
|
|
|
615
|
-
See also: [ARC](./services.md#class-arc), [Bitails](./services.md#class-bitails), [BlockHeader](./services.md#interface-blockheader), [Chain](./client.md#type-chain), [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), [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)
|
|
722
|
+
See also: [ARC](./services.md#class-arc), [Bitails](./services.md#class-bitails), [BlockHeader](./services.md#interface-blockheader), [Chain](./client.md#type-chain), [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)
|
|
616
723
|
|
|
617
724
|
###### Method hashOutputScript
|
|
618
725
|
|
|
@@ -734,20 +841,15 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
734
841
|
---
|
|
735
842
|
#### Functions
|
|
736
843
|
|
|
737
|
-
| |
|
|
738
|
-
| --- |
|
|
739
|
-
| [arcDefaultUrl](#function-arcdefaulturl) |
|
|
740
|
-
| [
|
|
741
|
-
| [
|
|
742
|
-
| [
|
|
743
|
-
| [
|
|
744
|
-
| [
|
|
745
|
-
| [
|
|
746
|
-
| [isLiveBlockHeader](#function-isliveblockheader) |
|
|
747
|
-
| [toBinaryBaseBlockHeader](#function-tobinarybaseblockheader) |
|
|
748
|
-
| [updateChaintracksFiatExchangeRates](#function-updatechaintracksfiatexchangerates) |
|
|
749
|
-
| [updateExchangeratesapi](#function-updateexchangeratesapi) |
|
|
750
|
-
| [validateScriptHash](#function-validatescripthash) |
|
|
844
|
+
| | |
|
|
845
|
+
| --- | --- |
|
|
846
|
+
| [arcDefaultUrl](#function-arcdefaulturl) | [isLive](#function-islive) |
|
|
847
|
+
| [arcGorillaPoolUrl](#function-arcgorillapoolurl) | [isLiveBlockHeader](#function-isliveblockheader) |
|
|
848
|
+
| [createDefaultWalletServicesOptions](#function-createdefaultwalletservicesoptions) | [toBinaryBaseBlockHeader](#function-tobinarybaseblockheader) |
|
|
849
|
+
| [getBeefForTxid](#function-getbeeffortxid) | [updateChaintracksFiatExchangeRates](#function-updatechaintracksfiatexchangerates) |
|
|
850
|
+
| [getExchangeRatesIo](#function-getexchangeratesio) | [updateExchangeratesapi](#function-updateexchangeratesapi) |
|
|
851
|
+
| [isBaseBlockHeader](#function-isbaseblockheader) | [validateScriptHash](#function-validatescripthash) |
|
|
852
|
+
| [isBlockHeader](#function-isblockheader) | |
|
|
751
853
|
|
|
752
854
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
753
855
|
|
|
@@ -763,6 +865,17 @@ See also: [Chain](./client.md#type-chain)
|
|
|
763
865
|
|
|
764
866
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
765
867
|
|
|
868
|
+
---
|
|
869
|
+
##### Function: arcGorillaPoolUrl
|
|
870
|
+
|
|
871
|
+
```ts
|
|
872
|
+
export function arcGorillaPoolUrl(chain: sdk.Chain): string | undefined
|
|
873
|
+
```
|
|
874
|
+
|
|
875
|
+
See also: [Chain](./client.md#type-chain)
|
|
876
|
+
|
|
877
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
878
|
+
|
|
766
879
|
---
|
|
767
880
|
##### Function: createDefaultWalletServicesOptions
|
|
768
881
|
|
package/docs/storage.md
CHANGED
|
@@ -22,28 +22,43 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
|
|
|
22
22
|
|
|
23
23
|
| | | |
|
|
24
24
|
| --- | --- | --- |
|
|
25
|
-
| [
|
|
26
|
-
| [
|
|
27
|
-
| [
|
|
28
|
-
| [
|
|
29
|
-
| [
|
|
30
|
-
| [
|
|
31
|
-
| [
|
|
32
|
-
| [
|
|
33
|
-
| [
|
|
34
|
-
| [
|
|
35
|
-
| [
|
|
36
|
-
| [
|
|
37
|
-
| [
|
|
38
|
-
| [
|
|
39
|
-
| [
|
|
40
|
-
| [
|
|
41
|
-
| [
|
|
25
|
+
| [AdminStatsResult](#interface-adminstatsresult) | [ProvenTxReqHistory](#interface-proventxreqhistory) | [TableOutputBasket](#interface-tableoutputbasket) |
|
|
26
|
+
| [CommitNewTxResults](#interface-commitnewtxresults) | [ProvenTxReqHistorySummaryApi](#interface-proventxreqhistorysummaryapi) | [TableOutputTag](#interface-tableoutputtag) |
|
|
27
|
+
| [EntitySyncMap](#interface-entitysyncmap) | [ProvenTxReqNotify](#interface-proventxreqnotify) | [TableOutputTagMap](#interface-tableoutputtagmap) |
|
|
28
|
+
| [GenerateChangeSdkChangeInput](#interface-generatechangesdkchangeinput) | [StorageAdminStats](#interface-storageadminstats) | [TableOutputX](#interface-tableoutputx) |
|
|
29
|
+
| [GenerateChangeSdkChangeOutput](#interface-generatechangesdkchangeoutput) | [StorageIdbOptions](#interface-storageidboptions) | [TableProvenTx](#interface-tableproventx) |
|
|
30
|
+
| [GenerateChangeSdkInput](#interface-generatechangesdkinput) | [StorageIdbSchema](#interface-storageidbschema) | [TableProvenTxReq](#interface-tableproventxreq) |
|
|
31
|
+
| [GenerateChangeSdkOutput](#interface-generatechangesdkoutput) | [StorageKnexOptions](#interface-storageknexoptions) | [TableProvenTxReqDynamics](#interface-tableproventxreqdynamics) |
|
|
32
|
+
| [GenerateChangeSdkParams](#interface-generatechangesdkparams) | [StorageProviderOptions](#interface-storageprovideroptions) | [TableSettings](#interface-tablesettings) |
|
|
33
|
+
| [GenerateChangeSdkResult](#interface-generatechangesdkresult) | [StorageReaderOptions](#interface-storagereaderoptions) | [TableSyncState](#interface-tablesyncstate) |
|
|
34
|
+
| [GenerateChangeSdkStorageChange](#interface-generatechangesdkstoragechange) | [StorageReaderWriterOptions](#interface-storagereaderwriteroptions) | [TableTransaction](#interface-tabletransaction) |
|
|
35
|
+
| [GetReqsAndBeefDetail](#interface-getreqsandbeefdetail) | [SyncError](#interface-syncerror) | [TableTxLabel](#interface-tabletxlabel) |
|
|
36
|
+
| [GetReqsAndBeefResult](#interface-getreqsandbeefresult) | [SyncMap](#interface-syncmap) | [TableTxLabelMap](#interface-tabletxlabelmap) |
|
|
37
|
+
| [ListActionsSpecOp](#interface-listactionsspecop) | [TableCertificate](#interface-tablecertificate) | [TableUser](#interface-tableuser) |
|
|
38
|
+
| [ListOutputsSpecOp](#interface-listoutputsspecop) | [TableCertificateField](#interface-tablecertificatefield) | [ValidateGenerateChangeSdkParamsResult](#interface-validategeneratechangesdkparamsresult) |
|
|
39
|
+
| [PostBeefResultForTxidApi](#interface-postbeefresultfortxidapi) | [TableCertificateX](#interface-tablecertificatex) | [WalletStorageServerOptions](#interface-walletstorageserveroptions) |
|
|
40
|
+
| [PostReqsToNetworkDetails](#interface-postreqstonetworkdetails) | [TableCommission](#interface-tablecommission) | [XValidCreateActionOutput](#interface-xvalidcreateactionoutput) |
|
|
41
|
+
| [PostReqsToNetworkResult](#interface-postreqstonetworkresult) | [TableMonitorEvent](#interface-tablemonitorevent) | |
|
|
42
|
+
| [ProvenTxFromTxidResult](#interface-proventxfromtxidresult) | [TableOutput](#interface-tableoutput) | |
|
|
42
43
|
|
|
43
44
|
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
44
45
|
|
|
45
46
|
---
|
|
46
47
|
|
|
48
|
+
##### Interface: AdminStatsResult
|
|
49
|
+
|
|
50
|
+
```ts
|
|
51
|
+
export interface AdminStatsResult extends StorageAdminStats {
|
|
52
|
+
servicesStats?: ServicesCallHistory;
|
|
53
|
+
monitorStats?: ServicesCallHistory;
|
|
54
|
+
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
See also: [ServicesCallHistory](./client.md#type-servicescallhistory), [StorageAdminStats](./storage.md#interface-storageadminstats)
|
|
58
|
+
|
|
59
|
+
Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
|
|
60
|
+
|
|
61
|
+
---
|
|
47
62
|
##### Interface: CommitNewTxResults
|
|
48
63
|
|
|
49
64
|
```ts
|
|
@@ -3644,9 +3659,23 @@ export class StorageKnex extends StorageProvider implements sdk.WalletStoragePro
|
|
|
3644
3659
|
}
|
|
3645
3660
|
validateEntity<T extends sdk.EntityTimeStamp>(entity: T, dateFields?: string[], booleanFields?: string[]): T
|
|
3646
3661
|
validateEntities<T extends sdk.EntityTimeStamp>(entities: T[], dateFields?: string[], booleanFields?: string[]): T[]
|
|
3647
|
-
async adminStats(adminIdentityKey: string): Promise<
|
|
3662
|
+
async adminStats(adminIdentityKey: string): Promise<AdminStatsResult> {
|
|
3648
3663
|
if (this.dbtype !== "MySQL")
|
|
3649
3664
|
throw new sdk.WERR_NOT_IMPLEMENTED("adminStats, only MySQL is supported");
|
|
3665
|
+
const monitorEvent = verifyOneOrNone(await this.findMonitorEvents({
|
|
3666
|
+
partial: { event: "MonitorCallHistory" },
|
|
3667
|
+
orderDescending: true,
|
|
3668
|
+
paged: { limit: 1 }
|
|
3669
|
+
}));
|
|
3670
|
+
const monitorStats: ServicesCallHistory | undefined = monitorEvent ? JSON.parse(monitorEvent.details!) : undefined;
|
|
3671
|
+
const servicesStats = this.getServices().getServicesCallHistory(true);
|
|
3672
|
+
await this.insertMonitorEvent({
|
|
3673
|
+
event: "ServicesCallHistory",
|
|
3674
|
+
details: JSON.stringify(servicesStats),
|
|
3675
|
+
created_at: new Date(),
|
|
3676
|
+
updated_at: new Date(),
|
|
3677
|
+
id: 0
|
|
3678
|
+
});
|
|
3650
3679
|
const one_day_ago = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
|
|
3651
3680
|
const one_week_ago = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
|
|
3652
3681
|
const one_month_ago = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
|
|
@@ -3717,7 +3746,9 @@ select
|
|
|
3717
3746
|
(select count(*) from output_tags where created_at > '${one_month_ago}') as tagsMonth,
|
|
3718
3747
|
(select count(*) from output_tags) as tagsTotal
|
|
3719
3748
|
`);
|
|
3720
|
-
const r:
|
|
3749
|
+
const r: AdminStatsResult = {
|
|
3750
|
+
monitorStats,
|
|
3751
|
+
servicesStats,
|
|
3721
3752
|
requestedBy: adminIdentityKey,
|
|
3722
3753
|
when: new Date().toISOString(),
|
|
3723
3754
|
usersDay,
|
|
@@ -3790,7 +3821,7 @@ select
|
|
|
3790
3821
|
}
|
|
3791
3822
|
```
|
|
3792
3823
|
|
|
3793
|
-
See also: [AuthId](./client.md#interface-authid), [DBType](./storage.md#type-dbtype), [EntityTimeStamp](./client.md#interface-entitytimestamp), [FindCertificateFieldsArgs](./client.md#interface-findcertificatefieldsargs), [FindCertificatesArgs](./client.md#interface-findcertificatesargs), [FindCommissionsArgs](./client.md#interface-findcommissionsargs), [FindForUserSincePagedArgs](./client.md#interface-findforusersincepagedargs), [FindMonitorEventsArgs](./client.md#interface-findmonitoreventsargs), [FindOutputBasketsArgs](./client.md#interface-findoutputbasketsargs), [FindOutputTagMapsArgs](./client.md#interface-findoutputtagmapsargs), [FindOutputTagsArgs](./client.md#interface-findoutputtagsargs), [FindOutputsArgs](./client.md#interface-findoutputsargs), [FindPartialSincePagedArgs](./client.md#interface-findpartialsincepagedargs), [FindProvenTxReqsArgs](./client.md#interface-findproventxreqsargs), [FindProvenTxsArgs](./client.md#interface-findproventxsargs), [FindSyncStatesArgs](./client.md#interface-findsyncstatesargs), [FindTransactionsArgs](./client.md#interface-findtransactionsargs), [FindTxLabelMapsArgs](./client.md#interface-findtxlabelmapsargs), [FindTxLabelsArgs](./client.md#interface-findtxlabelsargs), [FindUsersArgs](./client.md#interface-findusersargs), [ProvenOrRawTx](./client.md#interface-provenorrawtx), [PurgeParams](./client.md#interface-purgeparams), [PurgeResults](./client.md#interface-purgeresults), [
|
|
3824
|
+
See also: [AdminStatsResult](./storage.md#interface-adminstatsresult), [AuthId](./client.md#interface-authid), [DBType](./storage.md#type-dbtype), [EntityTimeStamp](./client.md#interface-entitytimestamp), [FindCertificateFieldsArgs](./client.md#interface-findcertificatefieldsargs), [FindCertificatesArgs](./client.md#interface-findcertificatesargs), [FindCommissionsArgs](./client.md#interface-findcommissionsargs), [FindForUserSincePagedArgs](./client.md#interface-findforusersincepagedargs), [FindMonitorEventsArgs](./client.md#interface-findmonitoreventsargs), [FindOutputBasketsArgs](./client.md#interface-findoutputbasketsargs), [FindOutputTagMapsArgs](./client.md#interface-findoutputtagmapsargs), [FindOutputTagsArgs](./client.md#interface-findoutputtagsargs), [FindOutputsArgs](./client.md#interface-findoutputsargs), [FindPartialSincePagedArgs](./client.md#interface-findpartialsincepagedargs), [FindProvenTxReqsArgs](./client.md#interface-findproventxreqsargs), [FindProvenTxsArgs](./client.md#interface-findproventxsargs), [FindSyncStatesArgs](./client.md#interface-findsyncstatesargs), [FindTransactionsArgs](./client.md#interface-findtransactionsargs), [FindTxLabelMapsArgs](./client.md#interface-findtxlabelmapsargs), [FindTxLabelsArgs](./client.md#interface-findtxlabelsargs), [FindUsersArgs](./client.md#interface-findusersargs), [ProvenOrRawTx](./client.md#interface-provenorrawtx), [PurgeParams](./client.md#interface-purgeparams), [PurgeResults](./client.md#interface-purgeresults), [ServicesCallHistory](./client.md#type-servicescallhistory), [StorageKnexOptions](./storage.md#interface-storageknexoptions), [StorageProvider](./storage.md#class-storageprovider), [TableCertificate](./storage.md#interface-tablecertificate), [TableCertificateField](./storage.md#interface-tablecertificatefield), [TableCertificateX](./storage.md#interface-tablecertificatex), [TableCommission](./storage.md#interface-tablecommission), [TableMonitorEvent](./storage.md#interface-tablemonitorevent), [TableOutput](./storage.md#interface-tableoutput), [TableOutputBasket](./storage.md#interface-tableoutputbasket), [TableOutputTag](./storage.md#interface-tableoutputtag), [TableOutputTagMap](./storage.md#interface-tableoutputtagmap), [TableProvenTx](./storage.md#interface-tableproventx), [TableProvenTxReq](./storage.md#interface-tableproventxreq), [TableSettings](./storage.md#interface-tablesettings), [TableSyncState](./storage.md#interface-tablesyncstate), [TableTransaction](./storage.md#interface-tabletransaction), [TableTxLabel](./storage.md#interface-tabletxlabel), [TableTxLabelMap](./storage.md#interface-tabletxlabelmap), [TableUser](./storage.md#interface-tableuser), [TransactionStatus](./client.md#type-transactionstatus), [TrxToken](./client.md#interface-trxtoken), [ValidListActionsArgs](./client.md#interface-validlistactionsargs), [ValidListOutputsArgs](./client.md#interface-validlistoutputsargs), [WERR_NOT_IMPLEMENTED](./client.md#class-werr_not_implemented), [WalletStorageProvider](./client.md#interface-walletstorageprovider), [listActions](./storage.md#function-listactions), [listOutputs](./storage.md#function-listoutputs), [purgeData](./storage.md#function-purgedata), [reviewStatus](./storage.md#function-reviewstatus), [verifyOneOrNone](./client.md#function-verifyoneornone), [verifyTruthy](./client.md#function-verifytruthy)
|
|
3794
3825
|
|
|
3795
3826
|
###### Method allocateChangeInput
|
|
3796
3827
|
|
|
@@ -3916,7 +3947,7 @@ export abstract class StorageProvider extends StorageReaderWriter implements sdk
|
|
|
3916
3947
|
abstract findOutputBasketsAuth(auth: sdk.AuthId, args: sdk.FindOutputBasketsArgs): Promise<TableOutputBasket[]>;
|
|
3917
3948
|
abstract findOutputsAuth(auth: sdk.AuthId, args: sdk.FindOutputsArgs): Promise<TableOutput[]>;
|
|
3918
3949
|
abstract insertCertificateAuth(auth: sdk.AuthId, certificate: TableCertificateX): Promise<number>;
|
|
3919
|
-
abstract adminStats(adminIdentityKey: string): Promise<
|
|
3950
|
+
abstract adminStats(adminIdentityKey: string): Promise<AdminStatsResult>;
|
|
3920
3951
|
override isStorageProvider(): boolean
|
|
3921
3952
|
setServices(v: sdk.WalletServices)
|
|
3922
3953
|
getServices(): sdk.WalletServices
|
|
@@ -3949,7 +3980,7 @@ export abstract class StorageProvider extends StorageReaderWriter implements sdk
|
|
|
3949
3980
|
}
|
|
3950
3981
|
```
|
|
3951
3982
|
|
|
3952
|
-
See also: [AuthId](./client.md#interface-authid), [Chain](./client.md#type-chain), [EntityProvenTxReq](./storage.md#class-entityproventxreq), [FindCertificatesArgs](./client.md#interface-findcertificatesargs), [FindOutputBasketsArgs](./client.md#interface-findoutputbasketsargs), [FindOutputsArgs](./client.md#interface-findoutputsargs), [GetReqsAndBeefResult](./storage.md#interface-getreqsandbeefresult), [PostReqsToNetworkResult](./storage.md#interface-postreqstonetworkresult), [ProcessSyncChunkResult](./client.md#interface-processsyncchunkresult), [ProvenOrRawTx](./client.md#interface-provenorrawtx), [PurgeParams](./client.md#interface-purgeparams), [PurgeResults](./client.md#interface-purgeresults), [RequestSyncChunkArgs](./client.md#interface-requestsyncchunkargs), [
|
|
3983
|
+
See also: [AdminStatsResult](./storage.md#interface-adminstatsresult), [AuthId](./client.md#interface-authid), [Chain](./client.md#type-chain), [EntityProvenTxReq](./storage.md#class-entityproventxreq), [FindCertificatesArgs](./client.md#interface-findcertificatesargs), [FindOutputBasketsArgs](./client.md#interface-findoutputbasketsargs), [FindOutputsArgs](./client.md#interface-findoutputsargs), [GetReqsAndBeefResult](./storage.md#interface-getreqsandbeefresult), [PostReqsToNetworkResult](./storage.md#interface-postreqstonetworkresult), [ProcessSyncChunkResult](./client.md#interface-processsyncchunkresult), [ProvenOrRawTx](./client.md#interface-provenorrawtx), [PurgeParams](./client.md#interface-purgeparams), [PurgeResults](./client.md#interface-purgeresults), [RequestSyncChunkArgs](./client.md#interface-requestsyncchunkargs), [StorageCreateActionResult](./client.md#interface-storagecreateactionresult), [StorageFeeModel](./client.md#interface-storagefeemodel), [StorageGetBeefOptions](./client.md#interface-storagegetbeefoptions), [StorageInternalizeActionResult](./client.md#interface-storageinternalizeactionresult), [StorageProcessActionArgs](./client.md#interface-storageprocessactionargs), [StorageProcessActionResults](./client.md#interface-storageprocessactionresults), [StorageProvenOrReq](./client.md#interface-storageprovenorreq), [StorageProviderOptions](./storage.md#interface-storageprovideroptions), [StorageReaderWriter](./storage.md#class-storagereaderwriter), [SyncChunk](./client.md#interface-syncchunk), [TableCertificateX](./storage.md#interface-tablecertificatex), [TableMonitorEvent](./storage.md#interface-tablemonitorevent), [TableOutput](./storage.md#interface-tableoutput), [TableOutputBasket](./storage.md#interface-tableoutputbasket), [TableOutputTag](./storage.md#interface-tableoutputtag), [TableOutputX](./storage.md#interface-tableoutputx), [TableProvenTxReq](./storage.md#interface-tableproventxreq), [TableProvenTxReqDynamics](./storage.md#interface-tableproventxreqdynamics), [TableTxLabel](./storage.md#interface-tabletxlabel), [TransactionStatus](./client.md#type-transactionstatus), [TrxToken](./client.md#interface-trxtoken), [UpdateProvenTxReqWithNewProvenTxArgs](./client.md#interface-updateproventxreqwithnewproventxargs), [UpdateProvenTxReqWithNewProvenTxResult](./client.md#interface-updateproventxreqwithnewproventxresult), [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), [WalletStorageProvider](./client.md#interface-walletstorageprovider), [attemptToPostReqsToNetwork](./storage.md#function-attempttopostreqstonetwork), [createAction](./storage.md#function-createaction), [getBeefForTransaction](./storage.md#function-getbeeffortransaction), [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), [purgeData](./storage.md#function-purgedata), [reviewStatus](./storage.md#function-reviewstatus)
|
|
3953
3984
|
|
|
3954
3985
|
###### Method confirmSpendableOutputs
|
|
3955
3986
|
|