dash-platform-sdk 1.6.0-dev.2 → 1.6.0-dev.4

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 (125) hide show
  1. package/README.md +33 -15
  2. package/bundle.min.js +1 -1
  3. package/index.d.ts +3 -1
  4. package/index.js +2 -1
  5. package/package.json +2 -2
  6. package/proto/generated/platform.client.d.ts +10 -0
  7. package/proto/generated/platform.client.js +27 -20
  8. package/proto/generated/platform.d.ts +350 -2
  9. package/proto/generated/platform.js +737 -8
  10. package/src/DashPlatformSDK.d.ts +19 -1
  11. package/src/DashPlatformSDK.js +28 -10
  12. package/src/QueryExecutor.d.ts +122 -0
  13. package/src/QueryExecutor.js +205 -0
  14. package/src/constants.d.ts +6 -0
  15. package/src/constants.js +6 -0
  16. package/src/contestedResources/getContestedResourceVoteState.d.ts +2 -1
  17. package/src/contestedResources/getContestedResourceVoteState.js +69 -49
  18. package/src/contestedResources/getVotePollsByEndDate.d.ts +4 -0
  19. package/src/contestedResources/getVotePollsByEndDate.js +39 -0
  20. package/src/contestedResources/index.d.ts +16 -2
  21. package/src/contestedResources/index.js +19 -2
  22. package/src/dataContracts/getDataContractByIdentifier.d.ts +2 -1
  23. package/src/dataContracts/getDataContractByIdentifier.js +15 -27
  24. package/src/dataContracts/index.d.ts +4 -1
  25. package/src/dataContracts/index.js +5 -2
  26. package/src/documents/getActionFeeAgreement.d.ts +2 -1
  27. package/src/documents/getActionFeeAgreement.js +3 -3
  28. package/src/documents/index.d.ts +12 -8
  29. package/src/documents/index.js +16 -13
  30. package/src/documents/query.d.ts +2 -1
  31. package/src/documents/query.js +16 -8
  32. package/src/documents/queryAggregate.d.ts +8 -1
  33. package/src/documents/queryAggregate.js +49 -15
  34. package/src/documents/queryJoined.d.ts +3 -2
  35. package/src/documents/queryJoined.js +54 -13
  36. package/src/documents/queryRanked.d.ts +3 -2
  37. package/src/documents/queryRanked.js +49 -15
  38. package/src/documents/v1.d.ts +25 -8
  39. package/src/documents/v1.js +50 -14
  40. package/src/grpcConnectionPool.d.ts +30 -4
  41. package/src/grpcConnectionPool.js +169 -39
  42. package/src/identities/getIdentityBalance.d.ts +2 -1
  43. package/src/identities/getIdentityBalance.js +13 -27
  44. package/src/identities/getIdentityByIdentifier.d.ts +2 -1
  45. package/src/identities/getIdentityByIdentifier.js +14 -28
  46. package/src/identities/getIdentityByNonUniquePublicKeyHash.d.ts +2 -1
  47. package/src/identities/getIdentityByNonUniquePublicKeyHash.js +49 -28
  48. package/src/identities/getIdentityByPublicKeyHash.d.ts +2 -1
  49. package/src/identities/getIdentityByPublicKeyHash.js +14 -28
  50. package/src/identities/getIdentityContractNonce.d.ts +2 -1
  51. package/src/identities/getIdentityContractNonce.js +10 -27
  52. package/src/identities/getIdentityNonce.d.ts +2 -1
  53. package/src/identities/getIdentityNonce.js +10 -27
  54. package/src/identities/getIdentityPublicKeys.d.ts +2 -1
  55. package/src/identities/getIdentityPublicKeys.js +16 -29
  56. package/src/identities/index.d.ts +4 -1
  57. package/src/identities/index.js +11 -8
  58. package/src/names/index.d.ts +4 -1
  59. package/src/names/index.js +8 -5
  60. package/src/names/registerName.d.ts +2 -1
  61. package/src/names/registerName.js +4 -4
  62. package/src/names/searchByIdentity.d.ts +2 -1
  63. package/src/names/searchByIdentity.js +2 -2
  64. package/src/names/searchByName.d.ts +2 -1
  65. package/src/names/searchByName.js +2 -2
  66. package/src/node/epochInfos.d.ts +2 -1
  67. package/src/node/epochInfos.js +27 -31
  68. package/src/node/finalizedEpochInfos.d.ts +4 -3
  69. package/src/node/finalizedEpochInfos.js +45 -39
  70. package/src/node/index.d.ts +4 -1
  71. package/src/node/index.js +7 -4
  72. package/src/node/totalCredits.d.ts +2 -1
  73. package/src/node/totalCredits.js +10 -25
  74. package/src/platformAddresses/getAddressInfo.d.ts +2 -1
  75. package/src/platformAddresses/getAddressInfo.js +17 -31
  76. package/src/platformAddresses/getAddressesBranchState.d.ts +2 -1
  77. package/src/platformAddresses/getAddressesBranchState.js +22 -8
  78. package/src/platformAddresses/getAddressesInfos.d.ts +2 -1
  79. package/src/platformAddresses/getAddressesInfos.js +18 -29
  80. package/src/platformAddresses/getAddressesTrunkState.d.ts +2 -1
  81. package/src/platformAddresses/getAddressesTrunkState.js +25 -23
  82. package/src/platformAddresses/getRecentAddressBalanceChanges.d.ts +2 -1
  83. package/src/platformAddresses/getRecentAddressBalanceChanges.js +26 -26
  84. package/src/platformAddresses/getRecentCompactedAddressBalanceChanges.d.ts +2 -1
  85. package/src/platformAddresses/getRecentCompactedAddressBalanceChanges.js +30 -26
  86. package/src/platformAddresses/index.d.ts +4 -1
  87. package/src/platformAddresses/index.js +10 -7
  88. package/src/quorumKeyProvider.d.ts +23 -0
  89. package/src/quorumKeyProvider.js +28 -0
  90. package/src/shielded/getMostRecentShieldedAnchor.d.ts +2 -1
  91. package/src/shielded/getMostRecentShieldedAnchor.js +8 -25
  92. package/src/shielded/getShieldedAnchors.d.ts +2 -1
  93. package/src/shielded/getShieldedAnchors.js +8 -25
  94. package/src/shielded/getShieldedEncryptedNotes.d.ts +2 -1
  95. package/src/shielded/getShieldedEncryptedNotes.js +16 -30
  96. package/src/shielded/getShieldedNotesCount.d.ts +2 -1
  97. package/src/shielded/getShieldedNotesCount.js +8 -25
  98. package/src/shielded/getShieldedNullifiers.d.ts +2 -1
  99. package/src/shielded/getShieldedNullifiers.js +14 -28
  100. package/src/shielded/getShieldedPoolState.d.ts +2 -1
  101. package/src/shielded/getShieldedPoolState.js +8 -25
  102. package/src/shielded/index.d.ts +4 -1
  103. package/src/shielded/index.js +10 -7
  104. package/src/stateTransitions/index.d.ts +4 -1
  105. package/src/stateTransitions/index.js +5 -2
  106. package/src/stateTransitions/waitForStateTransitionResult.d.ts +2 -1
  107. package/src/stateTransitions/waitForStateTransitionResult.js +42 -44
  108. package/src/tokens/getIdentitiesTokenBalances.d.ts +2 -1
  109. package/src/tokens/getIdentitiesTokenBalances.js +17 -28
  110. package/src/tokens/getIdentityTokensBalances.d.ts +2 -1
  111. package/src/tokens/getIdentityTokensBalances.js +17 -28
  112. package/src/tokens/getTokenContractInfo.d.ts +2 -1
  113. package/src/tokens/getTokenContractInfo.js +16 -30
  114. package/src/tokens/getTokenDirectPurchasePrices.d.ts +2 -1
  115. package/src/tokens/getTokenDirectPurchasePrices.js +26 -28
  116. package/src/tokens/getTokenTotalSupply.d.ts +2 -1
  117. package/src/tokens/getTokenTotalSupply.js +16 -28
  118. package/src/tokens/index.d.ts +4 -1
  119. package/src/tokens/index.js +11 -8
  120. package/src/utils/ProofError.d.ts +9 -0
  121. package/src/utils/ProofError.js +10 -0
  122. package/src/utils/verifyTenderdashProof.js +2 -1
  123. package/test/unit/SDK.spec.js +42 -0
  124. package/src/utils/getQuorumPublicKey.d.ts +0 -1
  125. package/src/utils/getQuorumPublicKey.js +0 -19
@@ -1,11 +1,9 @@
1
1
  import { GetIdentityNonceRequest } from '../../proto/generated/platform.js';
2
2
  import { IdentifierWASM, verifyIdentityNonceProof } from 'pshenmic-dpp';
3
- import { getQuorumPublicKey } from '../utils/getQuorumPublicKey.js';
4
- import bytesToHex from '../utils/bytesToHex.js';
5
- import verifyTenderdashProof from '../utils/verifyTenderdashProof.js';
3
+ import QueryExecutor from '../QueryExecutor.js';
6
4
  import { LATEST_PLATFORM_VERSION } from '../constants.js';
7
5
  const IDENTITY_NONCE_VALUE_FILTER = BigInt(0xFFFFFFFFFF);
8
- export default async function getIdentityNonce(grpcPool, identifier) {
6
+ export default async function getIdentityNonce(grpcPool, quorumKeyProvider, identifier) {
9
7
  const id = new IdentifierWASM(identifier);
10
8
  const getIdentityNonceRequest = GetIdentityNonceRequest.create({
11
9
  version: {
@@ -16,27 +14,12 @@ export default async function getIdentityNonce(grpcPool, identifier) {
16
14
  }
17
15
  }
18
16
  });
19
- const { response } = await (await grpcPool.getClient()).getIdentityNonce(getIdentityNonceRequest);
20
- const { version } = response;
21
- if (version.oneofKind !== 'v0') {
22
- throw new Error('Unexpected oneOf type returned from DAPI (must be v0)');
23
- }
24
- const { v0 } = version;
25
- if (v0.result.oneofKind !== 'proof') {
26
- throw new Error('Unexpected oneOf type returned from DAPI (must be proof)');
27
- }
28
- const { result: { proof }, metadata } = v0;
29
- if (metadata == null) {
30
- throw new Error('Metadata not found');
31
- }
32
- const { rootHash, nonce } = verifyIdentityNonceProof(proof.grovedbProof, id.bytes(), true, LATEST_PLATFORM_VERSION);
33
- if (nonce == null) {
34
- return BigInt(0);
35
- }
36
- const quorumPublicKey = await getQuorumPublicKey(grpcPool.network, proof.quorumType, bytesToHex(proof.quorumHash));
37
- const verify = await verifyTenderdashProof(proof, metadata, rootHash, quorumPublicKey);
38
- if (!verify) {
39
- throw new Error('Failed to verify query');
40
- }
41
- return BigInt(nonce) & IDENTITY_NONCE_VALUE_FILTER;
17
+ return await QueryExecutor.build(grpcPool, quorumKeyProvider)
18
+ .setGrpcRequest('getIdentityNonce', getIdentityNonceRequest)
19
+ .setProofVerifier(verifyIdentityNonceProof, id.bytes(), true, LATEST_PLATFORM_VERSION)
20
+ .mapResponse(data => {
21
+ const nonce = data.proved ? data.verified.nonce : BigInt(data.result.identityNonce);
22
+ return nonce != null ? nonce & IDENTITY_NONCE_VALUE_FILTER : BigInt(0);
23
+ })
24
+ .execute();
42
25
  }
@@ -1,3 +1,4 @@
1
1
  import { IdentifierLike, IdentityPublicKeyWASM } from 'pshenmic-dpp';
2
2
  import { GRPCPool } from '../grpcConnectionPool.js';
3
- export default function getIdentityPublicKeys(grpcPool: GRPCPool, identifier: IdentifierLike, keyIds?: number[]): Promise<IdentityPublicKeyWASM[]>;
3
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
4
+ export default function getIdentityPublicKeys(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider, identifier: IdentifierLike, keyIds?: number[]): Promise<IdentityPublicKeyWASM[]>;
@@ -1,10 +1,8 @@
1
1
  import { GetIdentityKeysRequest, KeyRequestType } from '../../proto/generated/platform.js';
2
- import { IdentifierWASM, verifyIdentityKeysByIdentifierProof } from 'pshenmic-dpp';
3
- import { getQuorumPublicKey } from '../utils/getQuorumPublicKey.js';
4
- import bytesToHex from '../utils/bytesToHex.js';
5
- import verifyTenderdashProof from '../utils/verifyTenderdashProof.js';
2
+ import { IdentifierWASM, IdentityPublicKeyWASM, verifyIdentityKeysByIdentifierProof } from 'pshenmic-dpp';
3
+ import QueryExecutor from '../QueryExecutor.js';
6
4
  import { LATEST_PLATFORM_VERSION } from '../constants.js';
7
- export default async function getIdentityPublicKeys(grpcPool, identifier, keyIds) {
5
+ export default async function getIdentityPublicKeys(grpcPool, quorumKeyProvider, identifier, keyIds) {
8
6
  const id = new IdentifierWASM(identifier);
9
7
  let requestType = {
10
8
  request: {
@@ -30,28 +28,17 @@ export default async function getIdentityPublicKeys(grpcPool, identifier, keyIds
30
28
  }
31
29
  }
32
30
  });
33
- const { response } = await (await grpcPool.getClient()).getIdentityKeys(getIdentityKeysRequest);
34
- const { version } = response;
35
- if (version.oneofKind !== 'v0') {
36
- throw new Error('Unexpected oneOf type returned from DAPI (must be v0)');
37
- }
38
- const { v0 } = version;
39
- if (v0.result.oneofKind !== 'proof') {
40
- throw new Error('Unexpected oneOf type returned from DAPI (must be proof)');
41
- }
42
- const { result: { proof }, metadata } = v0;
43
- if (metadata == null) {
44
- throw new Error('Metadata not found');
45
- }
46
- const { rootHash, identity } = verifyIdentityKeysByIdentifierProof(proof.grovedbProof, id.bytes(), keyIds != null ? keyIds : null, false, false, true, null, null, LATEST_PLATFORM_VERSION);
47
- if (identity == null) {
48
- throw new Error(`Identity with identifier ${id.base58()} not found`);
49
- }
50
- const quorumPublicKey = await getQuorumPublicKey(grpcPool.network, proof.quorumType, bytesToHex(proof.quorumHash));
51
- const verify = await verifyTenderdashProof(proof, metadata, rootHash, quorumPublicKey);
52
- if (!verify) {
53
- throw new Error('Failed to verify query');
54
- }
55
- const loadedKeysIds = Object.keys(identity.loadedPublicKeys);
56
- return loadedKeysIds.map((id) => identity.loadedPublicKeys[id]);
31
+ return await QueryExecutor.build(grpcPool, quorumKeyProvider)
32
+ .setGrpcRequest('getIdentityKeys', getIdentityKeysRequest)
33
+ .setProofVerifier(verifyIdentityKeysByIdentifierProof, id.bytes(), keyIds ?? null, false, false, true, null, null, LATEST_PLATFORM_VERSION)
34
+ .mapResponse(data => {
35
+ const keys = data.proved
36
+ ? data.verified.identity?.loadedPublicKeys
37
+ : data.result.keys.keysBytes.map(bytes => IdentityPublicKeyWASM.fromBytes(bytes));
38
+ if (keys == null) {
39
+ throw new Error(`Identity with identifier ${id.base58()} not found`);
40
+ }
41
+ return Object.values(keys);
42
+ })
43
+ .execute();
57
44
  }
@@ -1,5 +1,6 @@
1
1
  import { IdentityTransitionParams } from '../../types.js';
2
2
  import { GRPCPool } from '../grpcConnectionPool.js';
3
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
3
4
  import { IdentifierLike, IdentityPublicKeyWASM, IdentityWASM, StateTransitionWASM } from 'pshenmic-dpp';
4
5
  /**
5
6
  * Collection of methods to query identities and its related data
@@ -9,7 +10,9 @@ import { IdentifierLike, IdentityPublicKeyWASM, IdentityWASM, StateTransitionWAS
9
10
  export declare class IdentitiesController {
10
11
  /** @ignore */
11
12
  grpcPool: GRPCPool;
12
- constructor(grpcPool: GRPCPool);
13
+ /** @ignore */
14
+ quorumKeyProvider: QuorumKeyProvider;
15
+ constructor(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider);
13
16
  /**
14
17
  * Get current balance of your Identity by identifier
15
18
  *
@@ -17,8 +17,11 @@ import { base58 } from '@scure/base';
17
17
  export class IdentitiesController {
18
18
  /** @ignore */
19
19
  grpcPool;
20
- constructor(grpcPool) {
20
+ /** @ignore */
21
+ quorumKeyProvider;
22
+ constructor(grpcPool, quorumKeyProvider) {
21
23
  this.grpcPool = grpcPool;
24
+ this.quorumKeyProvider = quorumKeyProvider;
22
25
  }
23
26
  /**
24
27
  * Get current balance of your Identity by identifier
@@ -28,7 +31,7 @@ export class IdentitiesController {
28
31
  * @return {Promise<bigint>}
29
32
  */
30
33
  async getIdentityBalance(identifier) {
31
- return await getIdentityBalance(this.grpcPool, identifier);
34
+ return await getIdentityBalance(this.grpcPool, this.quorumKeyProvider, identifier);
32
35
  }
33
36
  /**
34
37
  * Retrieves an Identity from the network by give public key hash
@@ -41,7 +44,7 @@ export class IdentitiesController {
41
44
  if (hex.length !== 40) {
42
45
  throw new Error('Public key hash should equal 40');
43
46
  }
44
- return await getIdentityByPublicKeyHash(this.grpcPool, hex);
47
+ return await getIdentityByPublicKeyHash(this.grpcPool, this.quorumKeyProvider, hex);
45
48
  }
46
49
  /**
47
50
  * Retrieves an Identity from the network by non-unique public key hash (like Voter Identity, SHA160)
@@ -54,7 +57,7 @@ export class IdentitiesController {
54
57
  if (hex.length !== 40) {
55
58
  throw new Error('Public key hash should equal 40');
56
59
  }
57
- return await getIdentityByNonUniquePublicKeyHash(this.grpcPool, hex);
60
+ return await getIdentityByNonUniquePublicKeyHash(this.grpcPool, this.quorumKeyProvider, hex);
58
61
  }
59
62
  /**
60
63
  * Retrieves Identity by identifier from the network
@@ -63,14 +66,14 @@ export class IdentitiesController {
63
66
  * @return {Promise<IdentityWASM>}
64
67
  */
65
68
  async getIdentityByIdentifier(identifier) {
66
- return await getIdentityByIdentifier(this.grpcPool, identifier);
69
+ return await getIdentityByIdentifier(this.grpcPool, this.quorumKeyProvider, identifier);
67
70
  }
68
71
  /**
69
72
  * Get Identity Nonce (usually used by Identity transitions)
70
73
  * @param identifier
71
74
  */
72
75
  async getIdentityNonce(identifier) {
73
- return await getIdentityNonce(this.grpcPool, identifier);
76
+ return await getIdentityNonce(this.grpcPool, this.quorumKeyProvider, identifier);
74
77
  }
75
78
  /**
76
79
  * Get Identity Contract Nonce (usually used by Document transitions)
@@ -80,7 +83,7 @@ export class IdentitiesController {
80
83
  * @return {Promise<bigint>}
81
84
  */
82
85
  async getIdentityContractNonce(identifier, dataContract) {
83
- return await getIdentityContractNonce(this.grpcPool, identifier, dataContract);
86
+ return await getIdentityContractNonce(this.grpcPool, this.quorumKeyProvider, identifier, dataContract);
84
87
  }
85
88
  /**
86
89
  * Retrieve given Identity's public keys
@@ -90,7 +93,7 @@ export class IdentitiesController {
90
93
  * @return {Promise<IdentityPublicKeyWASM[]>}
91
94
  */
92
95
  async getIdentityPublicKeys(identifier, keyIds) {
93
- return await getIdentityPublicKeys(this.grpcPool, identifier, keyIds);
96
+ return await getIdentityPublicKeys(this.grpcPool, this.quorumKeyProvider, identifier, keyIds);
94
97
  }
95
98
  /**
96
99
  * Helper function for creating {StateTransitionWASM} for Identity transitions
@@ -1,4 +1,5 @@
1
1
  import { GRPCPool } from '../grpcConnectionPool.js';
2
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
2
3
  import { DocumentWASM, IdentifierLike, PrivateKeyWASM } from 'pshenmic-dpp';
3
4
  /**
4
5
  * Functions related to DPNS names (usernames)
@@ -8,7 +9,9 @@ import { DocumentWASM, IdentifierLike, PrivateKeyWASM } from 'pshenmic-dpp';
8
9
  export declare class NamesController {
9
10
  /** @ignore **/
10
11
  grpcPool: GRPCPool;
11
- constructor(grpcPool: GRPCPool);
12
+ /** @ignore **/
13
+ quorumKeyProvider: QuorumKeyProvider;
14
+ constructor(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider);
12
15
  /**
13
16
  * Searches for a registered DPNS name in the network
14
17
  *
@@ -14,8 +14,11 @@ import testNameContested from './testNameContested.js';
14
14
  export class NamesController {
15
15
  /** @ignore **/
16
16
  grpcPool;
17
- constructor(grpcPool) {
17
+ /** @ignore **/
18
+ quorumKeyProvider;
19
+ constructor(grpcPool, quorumKeyProvider) {
18
20
  this.grpcPool = grpcPool;
21
+ this.quorumKeyProvider = quorumKeyProvider;
19
22
  }
20
23
  /**
21
24
  * Searches for a registered DPNS name in the network
@@ -36,7 +39,7 @@ export class NamesController {
36
39
  if (validation != null) {
37
40
  throw new Error(validation);
38
41
  }
39
- return await searchByName(this.grpcPool, name);
42
+ return await searchByName(this.grpcPool, this.quorumKeyProvider, name);
40
43
  }
41
44
  /**
42
45
  * Tests a given username against contested names rules.
@@ -57,7 +60,7 @@ export class NamesController {
57
60
  return testNameContested(normalizedLabel);
58
61
  }
59
62
  async searchByIdentity(identifier) {
60
- return await searchByIdentity(this.grpcPool, new IdentifierWASM(identifier));
63
+ return await searchByIdentity(this.grpcPool, this.quorumKeyProvider, new IdentifierWASM(identifier));
61
64
  }
62
65
  /**
63
66
  * Performs a DPNS name registration sequence
@@ -76,8 +79,8 @@ export class NamesController {
76
79
  if (validation != null) {
77
80
  throw new Error(validation);
78
81
  }
79
- const identity = await getIdentityByIdentifier(this.grpcPool, identityId);
80
- return await registerName(this.grpcPool, name, identity, privateKey, preorderSalt);
82
+ const identity = await getIdentityByIdentifier(this.grpcPool, this.quorumKeyProvider, identityId);
83
+ return await registerName(this.grpcPool, this.quorumKeyProvider, name, identity, privateKey, preorderSalt);
81
84
  }
82
85
  /**
83
86
  * Converts DPNS name to normalized format (ex. alice.dash -> al1ce.dash)
@@ -1,3 +1,4 @@
1
1
  import { IdentityWASM, PrivateKeyWASM } from 'pshenmic-dpp';
2
2
  import { GRPCPool } from '../grpcConnectionPool.js';
3
- export default function registerName(grpcPool: GRPCPool, name: string, identity: IdentityWASM, privateKey: PrivateKeyWASM, preorderSalt?: Uint8Array): Promise<Uint8Array>;
3
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
4
+ export default function registerName(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider, name: string, identity: IdentityWASM, privateKey: PrivateKeyWASM, preorderSalt?: Uint8Array): Promise<Uint8Array>;
@@ -9,7 +9,7 @@ import broadcast from '../stateTransitions/broadcast.js';
9
9
  import waitForStateTransitionResult from '../stateTransitions/waitForStateTransitionResult.js';
10
10
  import testNameContested from './testNameContested.js';
11
11
  import { DPNS_DATA_CONTRACT_ID } from '../constants.js';
12
- export default async function registerName(grpcPool, name, identity, privateKey, preorderSalt) {
12
+ export default async function registerName(grpcPool, quorumKeyProvider, name, identity, privateKey, preorderSalt) {
13
13
  const [identityPublicKey] = identity.getPublicKeys().filter(identityPublicKey => identityPublicKey.getPublicKeyHash() === privateKey.getPublicKeyHash());
14
14
  if (identityPublicKey == null) {
15
15
  throw new Error('Private key does not match the identity');
@@ -29,7 +29,7 @@ export default async function registerName(grpcPool, name, identity, privateKey,
29
29
  ...salt,
30
30
  ...new TextEncoder().encode(normalizedFullDomainName)
31
31
  ])));
32
- const identityContractNonce = await getIdentityContractNonce(grpcPool, identity.id, DPNS_DATA_CONTRACT_ID);
32
+ const identityContractNonce = await getIdentityContractNonce(grpcPool, quorumKeyProvider, identity.id, DPNS_DATA_CONTRACT_ID);
33
33
  // skip preorder if salt of existing preorder is provided
34
34
  const domainNonce = identityContractNonce + BigInt(preorderSalt == null ? 2 : 1);
35
35
  // salt is exposed in the error only once preorder exists (passed in or its broadcast accepted),
@@ -47,7 +47,7 @@ export default async function registerName(grpcPool, name, identity, privateKey,
47
47
  await broadcast(grpcPool, preorderStateTransition);
48
48
  preorderSent = true;
49
49
  // wait for state transition confirmation before next broadcast
50
- await waitForStateTransitionResult(grpcPool, preorderStateTransition);
50
+ await waitForStateTransitionResult(grpcPool, quorumKeyProvider, preorderStateTransition);
51
51
  }
52
52
  // 2. Create domain document
53
53
  const domainData = {
@@ -72,7 +72,7 @@ export default async function registerName(grpcPool, name, identity, privateKey,
72
72
  await domainStateTransition.sign(privateKey, identityPublicKey);
73
73
  await broadcast(grpcPool, domainStateTransition);
74
74
  // wait for the domain too, so the next transition reads a nonce past it
75
- await waitForStateTransitionResult(grpcPool, domainStateTransition);
75
+ await waitForStateTransitionResult(grpcPool, quorumKeyProvider, domainStateTransition);
76
76
  }
77
77
  catch (e) {
78
78
  if (preorderSent && e instanceof Error) {
@@ -1,3 +1,4 @@
1
1
  import { DocumentWASM, IdentifierWASM } from 'pshenmic-dpp';
2
2
  import { GRPCPool } from '../grpcConnectionPool.js';
3
- export default function searchByIdentity(grpcPool: GRPCPool, identifier: IdentifierWASM): Promise<DocumentWASM[]>;
3
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
4
+ export default function searchByIdentity(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider, identifier: IdentifierWASM): Promise<DocumentWASM[]>;
@@ -1,5 +1,5 @@
1
1
  import query from '../documents/query.js';
2
2
  const DPNS_DATA_CONTRACT_ID = 'GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec';
3
- export default async function searchByIdentity(grpcPool, identifier) {
4
- return await query(grpcPool, DPNS_DATA_CONTRACT_ID, 'domain', [['records.identity', '=', identifier.base58()]], [['records.identity', 'asc']]);
3
+ export default async function searchByIdentity(grpcPool, quorumKeyProvider, identifier) {
4
+ return await query(grpcPool, quorumKeyProvider, DPNS_DATA_CONTRACT_ID, 'domain', [['records.identity', '=', identifier.base58()]], [['records.identity', 'asc']]);
5
5
  }
@@ -1,3 +1,4 @@
1
1
  import { DocumentWASM } from 'pshenmic-dpp';
2
2
  import { GRPCPool } from '../grpcConnectionPool.js';
3
- export default function search(grpcPool: GRPCPool, name: string): Promise<DocumentWASM[]>;
3
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
4
+ export default function search(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider, name: string): Promise<DocumentWASM[]>;
@@ -1,7 +1,7 @@
1
1
  import convertToHomographSafeChars from '../utils/convertToHomographSafeChars.js';
2
2
  import query from '../documents/query.js';
3
3
  const DPNS_DATA_CONTRACT_ID = 'GWRSAVFMjXx8HpQFaNJMqBV7MBgMK4br5UESsB4S31Ec';
4
- export default async function search(grpcPool, name) {
4
+ export default async function search(grpcPool, quorumKeyProvider, name) {
5
5
  const [label, parentDomainName] = name.split('.');
6
6
  const normalizedParentDomainName = convertToHomographSafeChars(parentDomainName);
7
7
  const normalizedLabelPrefix = convertToHomographSafeChars(label);
@@ -12,5 +12,5 @@ export default async function search(grpcPool, name) {
12
12
  const orderBy = [
13
13
  ['normalizedLabel', 'asc']
14
14
  ];
15
- return await query(grpcPool, DPNS_DATA_CONTRACT_ID, 'domain', where, orderBy);
15
+ return await query(grpcPool, quorumKeyProvider, DPNS_DATA_CONTRACT_ID, 'domain', where, orderBy);
16
16
  }
@@ -1,4 +1,5 @@
1
1
  import { GRPCPool } from '../grpcConnectionPool.js';
2
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
2
3
  export interface EpochInfo {
3
4
  number: number;
4
5
  firstBlockHeight: number;
@@ -7,4 +8,4 @@ export interface EpochInfo {
7
8
  feeMultiplier: bigint;
8
9
  protocolVersion: 9;
9
10
  }
10
- export default function epochInfos(grpcPool: GRPCPool, count: number, ascending: boolean, start?: number): Promise<EpochInfo[]>;
11
+ export default function epochInfos(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider, count: number, ascending: boolean, start?: number): Promise<EpochInfo[]>;
@@ -1,11 +1,9 @@
1
1
  import { GetEpochsInfoRequest } from '../../proto/generated/platform.js';
2
2
  import { verifyEpochsInfoProof } from 'pshenmic-dpp';
3
- import { getQuorumPublicKey } from '../utils/getQuorumPublicKey.js';
4
- import bytesToHex from '../utils/bytesToHex.js';
5
- import verifyTenderdashProof from '../utils/verifyTenderdashProof.js';
3
+ import QueryExecutor from '../QueryExecutor.js';
6
4
  import { UInt32Value } from '../../proto/generated/google/protobuf/wrappers.js';
7
5
  import { LATEST_PLATFORM_VERSION } from '../constants.js';
8
- export default async function epochInfos(grpcPool, count, ascending, start) {
6
+ export default async function epochInfos(grpcPool, quorumKeyProvider, count, ascending, start) {
9
7
  const getEpochsInfoRequest = GetEpochsInfoRequest.create({
10
8
  version: {
11
9
  oneofKind: 'v0',
@@ -17,31 +15,29 @@ export default async function epochInfos(grpcPool, count, ascending, start) {
17
15
  }
18
16
  }
19
17
  });
20
- const { response } = await (await grpcPool.getClient()).getEpochsInfo(getEpochsInfoRequest);
21
- const { version } = response;
22
- if (version.oneofKind !== 'v0') {
23
- throw new Error('Unexpected oneOf type returned from DAPI (must be v0)');
24
- }
25
- const { v0 } = version;
26
- if (v0.result.oneofKind !== 'proof') {
27
- throw new Error('Unexpected oneOf type returned from DAPI (must be proof)');
28
- }
29
- const { result: { proof }, metadata } = v0;
30
- if (metadata == null) {
31
- throw new Error('Metadata not found');
32
- }
33
- const { rootHash, epochsInfo } = verifyEpochsInfoProof(proof.grovedbProof, metadata.epoch, start, count, ascending, LATEST_PLATFORM_VERSION);
34
- const quorumPublicKey = await getQuorumPublicKey(grpcPool.network, proof.quorumType, bytesToHex(proof.quorumHash));
35
- const verify = await verifyTenderdashProof(proof, metadata, rootHash, quorumPublicKey);
36
- if (!verify) {
37
- throw new Error('Failed to verify query');
38
- }
39
- return epochsInfo.map(info => ({
40
- number: info.index,
41
- firstBlockHeight: info.firstBlockHeight,
42
- firstCoreBlockHeight: info.firstCoreBlockHeight,
43
- startTime: info.firstBlockTime,
44
- feeMultiplier: info.feeMultiplierPermille,
45
- protocolVersion: info.protocolVersion
46
- }));
18
+ return await QueryExecutor.build(grpcPool, quorumKeyProvider)
19
+ .setGrpcRequest('getEpochsInfo', getEpochsInfoRequest)
20
+ .setProofVerifier(verifyEpochsInfoProof, ({ metadata }) => [metadata.epoch, start, count, ascending, LATEST_PLATFORM_VERSION])
21
+ .mapResponse(data => {
22
+ if (data.proved) {
23
+ return data.verified.epochsInfo.map(info => ({
24
+ number: info.index,
25
+ firstBlockHeight: info.firstBlockHeight,
26
+ firstCoreBlockHeight: info.firstCoreBlockHeight,
27
+ startTime: info.firstBlockTime,
28
+ feeMultiplier: info.feeMultiplierPermille,
29
+ protocolVersion: info.protocolVersion
30
+ }));
31
+ }
32
+ return data.result.epochs.epochInfos.map(info => ({
33
+ number: info.number,
34
+ firstBlockHeight: BigInt(info.firstBlockHeight),
35
+ firstCoreBlockHeight: info.firstCoreBlockHeight,
36
+ startTime: BigInt(info.startTime),
37
+ // returned as a fraction, e.g. 1.5 for 1500 permille
38
+ feeMultiplier: BigInt(Math.round(info.feeMultiplier * 1000)),
39
+ protocolVersion: info.protocolVersion
40
+ }));
41
+ })
42
+ .execute();
47
43
  }
@@ -1,4 +1,5 @@
1
1
  import { GRPCPool } from '../grpcConnectionPool.js';
2
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
2
3
  import { IdentifierWASM } from 'pshenmic-dpp';
3
4
  export interface FinalizedEpochInfo {
4
5
  epochIndex: number;
@@ -11,11 +12,11 @@ export interface FinalizedEpochInfo {
11
12
  totalDistributedStorageFees: bigint;
12
13
  totalCreatedStorageFees: bigint;
13
14
  coreBlockRewards: bigint;
14
- blockProposers: {
15
+ blockProposers: Array<{
15
16
  proposer: IdentifierWASM;
16
17
  count: bigint;
17
- }[];
18
+ }>;
18
19
  feeMultiplier: bigint;
19
20
  protocolVersion: number;
20
21
  }
21
- export default function getFinalizedEpochsInfo(grpcPool: GRPCPool, startEpochIndex: number, startEpochIndexIncluded: boolean, endEpochIndex: number, endEpochIndexIncluded: boolean): Promise<FinalizedEpochInfo[]>;
22
+ export default function getFinalizedEpochsInfo(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider, startEpochIndex: number, startEpochIndexIncluded: boolean, endEpochIndex: number, endEpochIndexIncluded: boolean): Promise<FinalizedEpochInfo[]>;
@@ -1,10 +1,8 @@
1
1
  import { GetFinalizedEpochInfosRequest } from '../../proto/generated/platform.js';
2
- import { verifyFinalizedEpochInfosProof } from 'pshenmic-dpp';
3
- import { getQuorumPublicKey } from '../utils/getQuorumPublicKey.js';
4
- import bytesToHex from '../utils/bytesToHex.js';
5
- import verifyTenderdashProof from '../utils/verifyTenderdashProof.js';
2
+ import { IdentifierWASM, verifyFinalizedEpochInfosProof } from 'pshenmic-dpp';
3
+ import QueryExecutor from '../QueryExecutor.js';
6
4
  import { LATEST_PLATFORM_VERSION } from '../constants.js';
7
- export default async function getFinalizedEpochsInfo(grpcPool, startEpochIndex, startEpochIndexIncluded, endEpochIndex, endEpochIndexIncluded) {
5
+ export default async function getFinalizedEpochsInfo(grpcPool, quorumKeyProvider, startEpochIndex, startEpochIndexIncluded, endEpochIndex, endEpochIndexIncluded) {
8
6
  const getEpochsInfoRequest = GetFinalizedEpochInfosRequest.create({
9
7
  version: {
10
8
  oneofKind: 'v0',
@@ -17,38 +15,46 @@ export default async function getFinalizedEpochsInfo(grpcPool, startEpochIndex,
17
15
  }
18
16
  }
19
17
  });
20
- const { response } = await (await grpcPool.getClient()).getFinalizedEpochInfos(getEpochsInfoRequest);
21
- const { version } = response;
22
- if (version.oneofKind !== 'v0') {
23
- throw new Error('Unexpected oneOf type returned from DAPI (must be v0)');
24
- }
25
- const { v0 } = version;
26
- if (v0.result.oneofKind !== 'proof') {
27
- throw new Error('Unexpected oneOf type returned from DAPI (must be proof)');
28
- }
29
- const { result: { proof }, metadata } = v0;
30
- if (metadata == null) {
31
- throw new Error('Metadata not found');
32
- }
33
- const { rootHash, epochInfos } = verifyFinalizedEpochInfosProof(proof.grovedbProof, startEpochIndex, startEpochIndexIncluded, endEpochIndex, endEpochIndexIncluded, LATEST_PLATFORM_VERSION);
34
- const quorumPublicKey = await getQuorumPublicKey(grpcPool.network, proof.quorumType, bytesToHex(proof.quorumHash));
35
- const verify = await verifyTenderdashProof(proof, metadata, rootHash, quorumPublicKey);
36
- if (!verify) {
37
- throw new Error('Failed to verify query');
38
- }
39
- return epochInfos.map(info => ({
40
- epochIndex: info.epochIndex,
41
- firstBlockTime: info.firstBlockTime,
42
- firstBlockHeight: info.firstBlockHeight,
43
- totalBlocksInEpoch: info.totalBlocksInEpoch,
44
- firstCoreBlockHeight: info.firstCoreBlockHeight,
45
- nextEpochStartCoreBlockHeight: info.nextEpochStartCoreBlockHeight,
46
- totalProcessingFees: info.totalProcessingFees,
47
- totalDistributedStorageFees: info.totalDistributedStorageFees,
48
- totalCreatedStorageFees: info.totalCreatedStorageFees,
49
- coreBlockRewards: info.coreBlockRewards,
50
- blockProposers: info.blockProposers,
51
- feeMultiplier: info.feeMultiplierPermille,
52
- protocolVersion: info.protocolVersion
53
- }));
18
+ return await QueryExecutor.build(grpcPool, quorumKeyProvider)
19
+ .setGrpcRequest('getFinalizedEpochInfos', getEpochsInfoRequest)
20
+ .setProofVerifier(verifyFinalizedEpochInfosProof, startEpochIndex, startEpochIndexIncluded, endEpochIndex, endEpochIndexIncluded, LATEST_PLATFORM_VERSION)
21
+ .mapResponse(data => {
22
+ if (data.proved) {
23
+ return data.verified.epochInfos.map(info => ({
24
+ epochIndex: info.epochIndex,
25
+ firstBlockTime: info.firstBlockTime,
26
+ firstBlockHeight: info.firstBlockHeight,
27
+ totalBlocksInEpoch: info.totalBlocksInEpoch,
28
+ firstCoreBlockHeight: info.firstCoreBlockHeight,
29
+ nextEpochStartCoreBlockHeight: info.nextEpochStartCoreBlockHeight,
30
+ totalProcessingFees: info.totalProcessingFees,
31
+ totalDistributedStorageFees: info.totalDistributedStorageFees,
32
+ totalCreatedStorageFees: info.totalCreatedStorageFees,
33
+ coreBlockRewards: info.coreBlockRewards,
34
+ blockProposers: info.blockProposers,
35
+ feeMultiplier: info.feeMultiplierPermille,
36
+ protocolVersion: info.protocolVersion
37
+ }));
38
+ }
39
+ return data.result.epochs.finalizedEpochInfos.map(info => ({
40
+ epochIndex: info.number,
41
+ firstBlockTime: new Date(Number(info.firstBlockTime)),
42
+ firstBlockHeight: BigInt(info.firstBlockHeight),
43
+ totalBlocksInEpoch: BigInt(info.totalBlocksInEpoch),
44
+ firstCoreBlockHeight: info.firstCoreBlockHeight,
45
+ nextEpochStartCoreBlockHeight: info.nextEpochStartCoreBlockHeight,
46
+ totalProcessingFees: BigInt(info.totalProcessingFees),
47
+ totalDistributedStorageFees: BigInt(info.totalDistributedStorageFees),
48
+ totalCreatedStorageFees: BigInt(info.totalCreatedStorageFees),
49
+ coreBlockRewards: BigInt(info.coreBlockRewards),
50
+ blockProposers: info.blockProposers.map(({ proposerId, blockCount }) => ({
51
+ proposer: new IdentifierWASM(proposerId),
52
+ count: BigInt(blockCount)
53
+ })),
54
+ // returned as a fraction, e.g. 1.5 for 1500 permille
55
+ feeMultiplier: BigInt(Math.round(info.feeMultiplier * 1000)),
56
+ protocolVersion: info.protocolVersion
57
+ }));
58
+ })
59
+ .execute();
54
60
  }
@@ -1,4 +1,5 @@
1
1
  import { GRPCPool } from '../grpcConnectionPool.js';
2
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
2
3
  import { NodeStatus } from '../../types.js';
3
4
  import { EpochInfo } from './epochInfos.js';
4
5
  import { FinalizedEpochInfo } from './finalizedEpochInfos.js';
@@ -11,7 +12,9 @@ import { CurrentQuorumsInfo } from './getCurrentQuorumsInfo.js';
11
12
  export declare class NodeController {
12
13
  /** @ignore **/
13
14
  grpcPool: GRPCPool;
14
- constructor(grpcPool: GRPCPool);
15
+ /** @ignore **/
16
+ quorumKeyProvider: QuorumKeyProvider;
17
+ constructor(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider);
15
18
  /**
16
19
  * Retrieves an info about node
17
20
  * Includes information about genesis, chain, software versions
package/src/node/index.js CHANGED
@@ -11,8 +11,11 @@ import getCurrentQuorumsInfo from './getCurrentQuorumsInfo.js';
11
11
  export class NodeController {
12
12
  /** @ignore **/
13
13
  grpcPool;
14
- constructor(grpcPool) {
14
+ /** @ignore **/
15
+ quorumKeyProvider;
16
+ constructor(grpcPool, quorumKeyProvider) {
15
17
  this.grpcPool = grpcPool;
18
+ this.quorumKeyProvider = quorumKeyProvider;
16
19
  }
17
20
  /**
18
21
  * Retrieves an info about node
@@ -29,7 +32,7 @@ export class NodeController {
29
32
  * @return {Promise<bigint>}
30
33
  */
31
34
  async totalCredits() {
32
- return await getTotalCredits(this.grpcPool);
35
+ return await getTotalCredits(this.grpcPool, this.quorumKeyProvider);
33
36
  }
34
37
  /**
35
38
  * Retrieves an info about epochs
@@ -38,7 +41,7 @@ export class NodeController {
38
41
  * @return {Promise<EpochInfo[]>}
39
42
  */
40
43
  async getEpochsInfo(count, ascending, start) {
41
- return await getEpochsInfo(this.grpcPool, count, ascending, start);
44
+ return await getEpochsInfo(this.grpcPool, this.quorumKeyProvider, count, ascending, start);
42
45
  }
43
46
  /**
44
47
  * Retrieves an finalized info about epochs
@@ -47,7 +50,7 @@ export class NodeController {
47
50
  * @return {Promise<FinalizedEpochInfo[]>}
48
51
  */
49
52
  async getFinalizedEpochsInfo(startEpochIndex, startEpochIndexIncluded, endEpochIndex, endEpochIndexIncluded) {
50
- return await getFinalizedEpochsInfo(this.grpcPool, startEpochIndex, startEpochIndexIncluded, endEpochIndex, endEpochIndexIncluded);
53
+ return await getFinalizedEpochsInfo(this.grpcPool, this.quorumKeyProvider, startEpochIndex, startEpochIndexIncluded, endEpochIndex, endEpochIndexIncluded);
51
54
  }
52
55
  /**
53
56
  * Retrieves an info about current validator sets (quorums)
@@ -1,2 +1,3 @@
1
1
  import { GRPCPool } from '../grpcConnectionPool.js';
2
- export default function totalCredits(grpcPool: GRPCPool): Promise<bigint>;
2
+ import { QuorumKeyProvider } from '../quorumKeyProvider.js';
3
+ export default function totalCredits(grpcPool: GRPCPool, quorumKeyProvider: QuorumKeyProvider): Promise<bigint>;