trac-msb 0.2.11 → 0.2.12

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 (114) hide show
  1. package/.github/workflows/acceptance-tests.yml +38 -0
  2. package/.github/workflows/lint-pr-title.yml +26 -0
  3. package/.github/workflows/publish.yml +33 -0
  4. package/.github/workflows/unit-tests.yml +34 -0
  5. package/package.json +5 -10
  6. package/proto/network.proto +74 -0
  7. package/rpc/rpc_services.js +4 -22
  8. package/scripts/generate-protobufs.js +12 -37
  9. package/src/config/config.js +5 -26
  10. package/src/config/env.js +11 -25
  11. package/src/core/network/Network.js +36 -73
  12. package/src/core/network/protocols/LegacyProtocol.js +11 -21
  13. package/src/core/network/protocols/NetworkMessages.js +17 -38
  14. package/src/core/network/protocols/ProtocolInterface.js +2 -14
  15. package/src/core/network/protocols/ProtocolSession.js +17 -144
  16. package/src/core/network/protocols/V1Protocol.js +18 -37
  17. package/src/core/network/protocols/legacy/NetworkMessageRouter.js +19 -25
  18. package/src/core/network/protocols/legacy/handlers/{LegacyGetRequestHandler.js → GetRequestHandler.js} +6 -6
  19. package/src/core/network/protocols/legacy/handlers/ResponseHandler.js +37 -0
  20. package/src/core/network/protocols/{legacy/handlers/LegacyRoleOperationHandler.js → shared/handlers/RoleOperationHandler.js} +11 -18
  21. package/src/core/network/protocols/{legacy/handlers/LegacySubnetworkOperationHandler.js → shared/handlers/SubnetworkOperationHandler.js} +17 -28
  22. package/src/core/network/protocols/{legacy/handlers/LegacyTransferOperationHandler.js → shared/handlers/TransferOperationHandler.js} +11 -17
  23. package/src/core/network/protocols/{legacy/handlers/BaseStateOperationHandler.js → shared/handlers/base/BaseOperationHandler.js} +12 -23
  24. package/src/core/network/protocols/shared/validators/{PartialBootstrapDeploymentValidator.js → PartialBootstrapDeployment.js} +4 -9
  25. package/src/core/network/protocols/shared/validators/{PartialRoleAccessValidator.js → PartialRoleAccess.js} +17 -51
  26. package/src/core/network/protocols/shared/validators/{PartialTransactionValidator.js → PartialTransaction.js} +7 -21
  27. package/src/core/network/protocols/shared/validators/{PartialTransferValidator.js → PartialTransfer.js} +9 -26
  28. package/src/core/network/protocols/shared/validators/{PartialOperationValidator.js → base/PartialOperation.js} +25 -47
  29. package/src/core/network/protocols/v1/NetworkMessageRouter.js +7 -91
  30. package/src/core/network/services/ConnectionManager.js +94 -146
  31. package/src/core/network/services/MessageOrchestrator.js +27 -151
  32. package/src/core/network/services/TransactionPoolService.js +18 -129
  33. package/src/core/network/services/TransactionRateLimiterService.js +34 -52
  34. package/src/core/network/services/ValidatorObserverService.js +26 -18
  35. package/src/core/state/State.js +19 -70
  36. package/src/index.js +4 -5
  37. package/src/messages/network/v1/NetworkMessageBuilder.js +79 -59
  38. package/src/messages/network/v1/NetworkMessageDirector.js +50 -16
  39. package/src/utils/Scheduler.js +8 -0
  40. package/src/utils/constants.js +5 -71
  41. package/src/utils/helpers.js +1 -10
  42. package/src/utils/normalizers.js +0 -38
  43. package/src/utils/protobuf/network.cjs +840 -0
  44. package/src/utils/protobuf/operationHelpers.js +3 -24
  45. package/tests/acceptance/v1/account/account.test.mjs +2 -8
  46. package/tests/acceptance/v1/tx/tx.test.mjs +1 -23
  47. package/tests/acceptance/v1/tx-details/tx-details.test.mjs +6 -34
  48. package/tests/fixtures/networkV1.fixtures.js +28 -2
  49. package/tests/helpers/transactionPayloads.mjs +2 -2
  50. package/tests/unit/messages/network/NetworkMessageBuilder.test.js +79 -239
  51. package/tests/unit/messages/network/NetworkMessageDirector.test.js +77 -223
  52. package/tests/unit/network/ConnectionManager.test.js +191 -0
  53. package/tests/unit/network/networkModule.test.js +1 -4
  54. package/tests/unit/unit.test.js +2 -2
  55. package/tests/unit/utils/protobuf/operationHelpers.test.js +4 -2
  56. package/tests/unit/utils/utils.test.js +0 -1
  57. package/proto/network/v1/enums/message_type.proto +0 -16
  58. package/proto/network/v1/enums/result_code.proto +0 -84
  59. package/proto/network/v1/messages/broadcast_transaction_request.proto +0 -9
  60. package/proto/network/v1/messages/broadcast_transaction_response.proto +0 -13
  61. package/proto/network/v1/messages/liveness_request.proto +0 -8
  62. package/proto/network/v1/messages/liveness_response.proto +0 -11
  63. package/proto/network/v1/network_message.proto +0 -22
  64. package/src/core/network/protocols/connectionPolicies.js +0 -88
  65. package/src/core/network/protocols/legacy/handlers/LegacyResponseHandler.js +0 -23
  66. package/src/core/network/protocols/shared/errors/SharedValidatorRejectionError.js +0 -27
  67. package/src/core/network/protocols/v1/V1ProtocolError.js +0 -91
  68. package/src/core/network/protocols/v1/handlers/V1BaseOperationHandler.js +0 -65
  69. package/src/core/network/protocols/v1/handlers/V1BroadcastTransactionOperationHandler.js +0 -389
  70. package/src/core/network/protocols/v1/handlers/V1LivenessOperationHandler.js +0 -87
  71. package/src/core/network/protocols/v1/validators/V1BaseOperation.js +0 -211
  72. package/src/core/network/protocols/v1/validators/V1BroadcastTransactionRequest.js +0 -26
  73. package/src/core/network/protocols/v1/validators/V1BroadcastTransactionResponse.js +0 -276
  74. package/src/core/network/protocols/v1/validators/V1LivenessRequest.js +0 -15
  75. package/src/core/network/protocols/v1/validators/V1LivenessResponse.js +0 -17
  76. package/src/core/network/protocols/v1/validators/V1ValidationSchema.js +0 -210
  77. package/src/core/network/services/PendingRequestService.js +0 -172
  78. package/src/core/network/services/TransactionCommitService.js +0 -149
  79. package/src/core/network/services/ValidatorHealthCheckService.js +0 -127
  80. package/src/utils/deepEqualApplyPayload.js +0 -40
  81. package/src/utils/logger.js +0 -25
  82. package/src/utils/protobuf/networkV1.generated.cjs +0 -2460
  83. package/tests/unit/network/LegacyNetworkMessageRouter.test.js +0 -54
  84. package/tests/unit/network/ProtocolSession.test.js +0 -127
  85. package/tests/unit/network/services/ConnectionManager.test.js +0 -450
  86. package/tests/unit/network/services/MessageOrchestrator.test.js +0 -445
  87. package/tests/unit/network/services/PendingRequestService.test.js +0 -431
  88. package/tests/unit/network/services/TransactionCommitService.test.js +0 -246
  89. package/tests/unit/network/services/TransactionPoolService.test.js +0 -489
  90. package/tests/unit/network/services/TransactionRateLimiterService.test.js +0 -139
  91. package/tests/unit/network/services/ValidatorHealthCheckService.test.js +0 -115
  92. package/tests/unit/network/services/services.test.js +0 -17
  93. package/tests/unit/network/utils/v1TestUtils.js +0 -153
  94. package/tests/unit/network/v1/NetworkMessageRouterV1.test.js +0 -151
  95. package/tests/unit/network/v1/V1BaseOperation.test.js +0 -356
  96. package/tests/unit/network/v1/V1BroadcastTransactionOperationHandler.test.js +0 -129
  97. package/tests/unit/network/v1/V1BroadcastTransactionRequest.test.js +0 -53
  98. package/tests/unit/network/v1/V1BroadcastTransactionResponse.test.js +0 -512
  99. package/tests/unit/network/v1/V1LivenessRequest.test.js +0 -32
  100. package/tests/unit/network/v1/V1LivenessResponse.test.js +0 -45
  101. package/tests/unit/network/v1/V1ResultCode.test.js +0 -84
  102. package/tests/unit/network/v1/V1ValidationSchema.test.js +0 -13
  103. package/tests/unit/network/v1/connectionPolicies.test.js +0 -49
  104. package/tests/unit/network/v1/handlers/V1BaseOperationHandler.test.js +0 -284
  105. package/tests/unit/network/v1/handlers/V1BroadcastTransactionOperationHandler.test.js +0 -794
  106. package/tests/unit/network/v1/handlers/V1LivenessOperationHandler.test.js +0 -193
  107. package/tests/unit/network/v1/v1.handlers.test.js +0 -15
  108. package/tests/unit/network/v1/v1.test.js +0 -19
  109. package/tests/unit/network/v1/v1ValidationSchema/broadcastTransactionRequest.test.js +0 -119
  110. package/tests/unit/network/v1/v1ValidationSchema/broadcastTransactionResponse.test.js +0 -136
  111. package/tests/unit/network/v1/v1ValidationSchema/common.test.js +0 -308
  112. package/tests/unit/network/v1/v1ValidationSchema/livenessRequest.test.js +0 -90
  113. package/tests/unit/network/v1/v1ValidationSchema/livenessResponse.test.js +0 -133
  114. package/tests/unit/utils/deepEqualApplyPayload/deepEqualApplyPayload.test.js +0 -102
@@ -1,17 +1,7 @@
1
1
  import applyOperations from './applyOperations.cjs';
2
- import networkV1Generated from './networkV1.generated.cjs';
2
+ import networkV1Operations from './network.cjs';
3
3
  import b4a from 'b4a';
4
4
 
5
- const networkV1Operations = networkV1Generated.network.v1;
6
- const NETWORK_TO_OBJECT_OPTIONS = Object.freeze({
7
- enums: Number,
8
- longs: Number,
9
- bytes: Buffer,
10
- defaults: true,
11
- arrays: true,
12
- oneofs: false
13
- });
14
-
15
5
  /**
16
6
  * Safely encodes an operation using `applyOperations.Operation.encode`.
17
7
  * If the encoding fails (e.g., due to an invalid payload), returns an empty Buffer.
@@ -46,14 +36,6 @@ export const safeDecodeApplyOperation = (payload) => {
46
36
  return null;
47
37
  }
48
38
 
49
- export const unsafeDecodeApplyOperation= (payload) => {
50
- return applyOperations.Operation.decode(payload);
51
- }
52
-
53
- export const unsafeEncodeApplyOperation = (payload) => {
54
- return applyOperations.Operation.encode(payload);
55
- }
56
-
57
39
  export const normalizeIncomingMessage = (message) => {
58
40
  if (!message) return null;
59
41
  if (b4a.isBuffer(message)) {
@@ -69,13 +51,10 @@ export const normalizeIncomingMessage = (message) => {
69
51
  };
70
52
 
71
53
  export const encodeV1networkOperation = (payload) => {
72
- return b4a.from(networkV1Operations.MessageHeader.encode(payload).finish());
54
+ return networkV1Operations.MessageHeader.encode(payload);
73
55
  }
74
56
 
75
57
 
76
58
  export const decodeV1networkOperation = (payload) => {
77
- return networkV1Operations.MessageHeader.toObject(
78
- networkV1Operations.MessageHeader.decode(payload),
79
- NETWORK_TO_OBJECT_OPTIONS
80
- );
59
+ return networkV1Operations.MessageHeader.decode(payload);
81
60
  }
@@ -108,17 +108,11 @@ export const registerAccountTests = (context) => {
108
108
 
109
109
  it("returns 500 on internal error", async () => {
110
110
  const originalGetNodeEntry = context.rpcMsb.state.getNodeEntry
111
- const failingAddress = randomAddress(context.rpcMsb.config.addressPrefix)
112
111
 
113
- context.rpcMsb.state.getNodeEntry = async (address) => {
114
- if (address === failingAddress) {
115
- throw new Error("test")
116
- }
117
- return originalGetNodeEntry.call(context.rpcMsb.state, address)
118
- }
112
+ context.rpcMsb.state.getNodeEntry = async () => { throw new Error("test") }
119
113
 
120
114
  try {
121
- const res = await request(context.server).get(`/v1/account/${failingAddress}`)
115
+ const res = await request(context.server).get(`/v1/account/${context.wallet.address}`)
122
116
  expect(res.statusCode).toBe(500)
123
117
  expect(res.body).toEqual({ error: 'An error occurred processing the request.' })
124
118
  } finally {
@@ -1,24 +1,5 @@
1
1
  import request from "supertest"
2
2
  import { buildRpcSelfTransferPayload, waitForConnection } from "../../../helpers/transactionPayloads.mjs"
3
- import { sleep } from "../../../../src/utils/helpers.js"
4
-
5
- const TX_ENDPOINT_TIMEOUT_MS = 4000
6
- const TX_ENDPOINT_RETRY_INTERVAL_MS = 100
7
-
8
- const waitForStatusCode = async (requestFactory, expectedStatusCode, timeoutMs = TX_ENDPOINT_TIMEOUT_MS) => {
9
- const startedAt = Date.now()
10
- let response = null
11
-
12
- while ((Date.now() - startedAt) < timeoutMs) {
13
- response = await requestFactory()
14
- if (response.statusCode === expectedStatusCode) {
15
- return response
16
- }
17
- await sleep(TX_ENDPOINT_RETRY_INTERVAL_MS)
18
- }
19
-
20
- return response
21
- }
22
3
 
23
4
  export const registerTxTests = (context) => {
24
5
  describe("GET /v1/tx/:hash", () => {
@@ -36,10 +17,7 @@ export const registerTxTests = (context) => {
36
17
  .send(JSON.stringify({ payload }))
37
18
  expect(broadcastRes.statusCode).toBe(200)
38
19
 
39
- const res = await waitForStatusCode(
40
- () => request(context.server).get(`/v1/tx/${txHashHex}`),
41
- 200
42
- )
20
+ const res = await request(context.server).get(`/v1/tx/${txHashHex}`)
43
21
  expect(res.statusCode).toBe(200)
44
22
  expect(res.body).toMatchObject({ txDetails: expect.any(Object) })
45
23
  })
@@ -1,24 +1,5 @@
1
1
  import request from "supertest"
2
2
  import { buildRpcSelfTransferPayload, waitForConnection } from "../../../helpers/transactionPayloads.mjs"
3
- import { sleep } from "../../../../src/utils/helpers.js"
4
-
5
- const TX_DETAILS_TIMEOUT_MS = 4000
6
- const TX_DETAILS_RETRY_INTERVAL_MS = 100
7
-
8
- const waitForStatusCode = async (requestFactory, expectedStatusCode, timeoutMs = TX_DETAILS_TIMEOUT_MS) => {
9
- const startedAt = Date.now()
10
- let response = null
11
-
12
- while ((Date.now() - startedAt) < timeoutMs) {
13
- response = await requestFactory()
14
- if (response.statusCode === expectedStatusCode) {
15
- return response
16
- }
17
- await sleep(TX_DETAILS_RETRY_INTERVAL_MS)
18
- }
19
-
20
- return response
21
- }
22
3
 
23
4
  export const registerTxDetailsTests = (context) => {
24
5
  describe("GET /v1/tx/details", () => {
@@ -36,11 +17,8 @@ export const registerTxDetailsTests = (context) => {
36
17
  .send(JSON.stringify({ payload }))
37
18
  expect(broadcastRes.statusCode).toBe(200)
38
19
 
39
- const resConfirmed = await waitForStatusCode(
40
- () => request(context.server)
41
- .get(`/v1/tx/details/${txHashHex}?confirmed=true`),
42
- 200
43
- )
20
+ const resConfirmed = await request(context.server)
21
+ .get(`/v1/tx/details/${txHashHex}?confirmed=true`)
44
22
  expect(resConfirmed.statusCode).toBe(200)
45
23
 
46
24
  expect(resConfirmed.body).toMatchObject({
@@ -49,11 +27,8 @@ export const registerTxDetailsTests = (context) => {
49
27
  fee: expect.any(String)
50
28
  })
51
29
 
52
- const resUnconfirmed = await waitForStatusCode(
53
- () => request(context.server)
54
- .get(`/v1/tx/details/${txHashHex}?confirmed=false`),
55
- 200
56
- )
30
+ const resUnconfirmed = await request(context.server)
31
+ .get(`/v1/tx/details/${txHashHex}?confirmed=false`)
57
32
  expect(resUnconfirmed.statusCode).toBe(200)
58
33
 
59
34
  expect(resUnconfirmed.body).toMatchObject({
@@ -82,11 +57,8 @@ export const registerTxDetailsTests = (context) => {
82
57
  .send(JSON.stringify({ payload }))
83
58
  expect(broadcastRes.statusCode).toBe(200)
84
59
 
85
- const res = await waitForStatusCode(
86
- () => request(context.server)
87
- .get(`/v1/tx/details/${txHashHex}?confirmed=false`),
88
- 200
89
- )
60
+ const res = await request(context.server)
61
+ .get(`/v1/tx/details/${txHashHex}?confirmed=false`)
90
62
  expect(res.statusCode).toBe(200)
91
63
 
92
64
  expect(res.body).toMatchObject({
@@ -1,6 +1,32 @@
1
1
  import b4a from 'b4a';
2
2
  import { v7 as uuidv7 } from 'uuid';
3
3
  import { NetworkOperationType, ResultCode as NetworkResultCode } from '../../src/utils/constants.js';
4
+ import { asAddress } from '../helpers/address.js';
5
+
6
+ const payloadValidatorConnectionRequest = {
7
+ type: NetworkOperationType.VALIDATOR_CONNECTION_REQUEST,
8
+ id: uuidv7(),
9
+ timestamp: 123,
10
+ validator_connection_request: {
11
+ issuer_address: asAddress('36fdaf941de4afe602cbb1e2f56dc582466ef23fad1da55c09fd6dd841cbd117'),
12
+ nonce: b4a.from('00', 'hex'),
13
+ signature: b4a.from('01', 'hex')
14
+ },
15
+ capabilities: ['cap:a', 'cap:b']
16
+ };
17
+
18
+ const payloadValidatorConnectionResponse = {
19
+ type: NetworkOperationType.VALIDATOR_CONNECTION_RESPONSE,
20
+ id: uuidv7(),
21
+ timestamp: 456,
22
+ validator_connection_response: {
23
+ issuer_address: asAddress('36fdaf941de4afe602cbb1e2f56dc582466ef23fad1da55c09fd6dd841cbd117'),
24
+ nonce: b4a.from('02', 'hex'),
25
+ signature: b4a.from('03', 'hex'),
26
+ result: NetworkResultCode.OK
27
+ },
28
+ capabilities: ['cap:a']
29
+ };
4
30
 
5
31
  const payloadLivenessRequest = {
6
32
  type: NetworkOperationType.LIVENESS_REQUEST,
@@ -44,14 +70,14 @@ const payloadBroadcastTransactionResponse = {
44
70
  broadcast_transaction_response: {
45
71
  nonce: b4a.from('0a', 'hex'),
46
72
  signature: b4a.from('0b', 'hex'),
47
- proof: b4a.from('0c', 'hex'),
48
- timestamp: 161719,
49
73
  result: NetworkResultCode.OK
50
74
  },
51
75
  capabilities: ['cap:b']
52
76
  };
53
77
 
54
78
  export default {
79
+ payloadValidatorConnectionRequest,
80
+ payloadValidatorConnectionResponse,
55
81
  payloadLivenessRequest,
56
82
  payloadLivenessResponse,
57
83
  payloadBroadcastTransactionRequest,
@@ -23,10 +23,10 @@ export const waitForConnection = async node => {
23
23
 
24
24
  /**
25
25
  * Build a base64-encoded transfer payload and matching tx hash
26
- * that are compatible with MSB's PartialTransferValidator validator.
26
+ * that are compatible with MSB's PartialTransfer validator.
27
27
  *
28
28
  * This helper mirrors the hashing/signing logic used by
29
- * PartialOperationValidator.validateSignature, so that tests broadcast
29
+ * PartialOperation.validateSignature, so that tests broadcast
30
30
  * transactions the node will accept without touching consensus code.
31
31
  *
32
32
  * @param {object} context - General context
@@ -17,6 +17,7 @@ import {
17
17
  idToBuffer,
18
18
  timestampToBuffer
19
19
  } from '../../../../src/utils/buffer.js';
20
+ import { addressToBuffer } from '../../../../src/core/state/utils/address.js';
20
21
  import { config } from '../../../helpers/config.js';
21
22
  import { asAddress } from '../../../helpers/address.js';
22
23
  import { testKeyPair1 } from '../../../fixtures/apply.fixtures.js';
@@ -37,6 +38,81 @@ function uniqueResultCodes() {
37
38
  return [...new Set(Object.values(NetworkResultCode))].sort((a, b) => a - b);
38
39
  }
39
40
 
41
+ test('NetworkMessageBuilder builds validator connection request and verifies signature', async t => {
42
+ const wallet = createWallet();
43
+ const builder = new NetworkMessageBuilder(wallet, config);
44
+
45
+ const id = uuidv7();
46
+ const caps = ['cap:b', 'cap:a'];
47
+
48
+ await builder
49
+ .setType(NetworkOperationType.VALIDATOR_CONNECTION_REQUEST)
50
+ .setId(id)
51
+ .setTimestamp()
52
+ .setIssuerAddress(wallet.address)
53
+ .setCapabilities(caps)
54
+ .buildPayload();
55
+
56
+ const payload = builder.getResult();
57
+ t.is(payload.type, NetworkOperationType.VALIDATOR_CONNECTION_REQUEST);
58
+ t.is(payload.id, id);
59
+ t.alike(payload.capabilities, caps);
60
+ t.ok(b4a.isBuffer(payload.validator_connection_request.nonce));
61
+ t.ok(b4a.isBuffer(payload.validator_connection_request.signature));
62
+
63
+ const message = createMessage(
64
+ payload.type,
65
+ idToBuffer(id),
66
+ timestampToBuffer(payload.timestamp),
67
+ addressToBuffer(wallet.address, config.addressPrefix),
68
+ payload.validator_connection_request.nonce,
69
+ encodeCapabilities(caps)
70
+ );
71
+ const hash = await PeerWallet.blake3(message);
72
+ t.ok(wallet.verify(payload.validator_connection_request.signature, hash, wallet.publicKey));
73
+
74
+ const roundTrip = decodeV1networkOperation(encodeV1networkOperation(payload));
75
+ t.is(roundTrip.type, NetworkOperationType.VALIDATOR_CONNECTION_REQUEST);
76
+ });
77
+
78
+ test('NetworkMessageBuilder iterates validator connection response ResultCode values', async t => {
79
+ const wallet = createWallet();
80
+ const builder = new NetworkMessageBuilder(wallet, config);
81
+ const id = uuidv7();
82
+ const otherAddress = asAddress('36fdaf941de4afe602cbb1e2f56dc582466ef23fad1da55c09fd6dd841cbd117');
83
+ const caps = ['cap:b', 'cap:a'];
84
+
85
+ for (const code of uniqueResultCodes()) {
86
+ await builder
87
+ .setType(NetworkOperationType.VALIDATOR_CONNECTION_RESPONSE)
88
+ .setId(id)
89
+ .setTimestamp()
90
+ .setIssuerAddress(otherAddress)
91
+ .setCapabilities(caps)
92
+ .setResultCode(code)
93
+ .buildPayload();
94
+
95
+ const payload = builder.getResult();
96
+ t.is(payload.type, NetworkOperationType.VALIDATOR_CONNECTION_RESPONSE);
97
+ t.is(payload.validator_connection_response.result, code);
98
+
99
+ const msg = createMessage(
100
+ payload.type,
101
+ idToBuffer(payload.id),
102
+ timestampToBuffer(payload.timestamp),
103
+ addressToBuffer(otherAddress, config.addressPrefix),
104
+ payload.validator_connection_response.nonce,
105
+ safeWriteUInt32BE(code, 0),
106
+ encodeCapabilities(caps)
107
+ );
108
+ const hash = await PeerWallet.blake3(msg);
109
+ t.ok(wallet.verify(payload.validator_connection_response.signature, hash, wallet.publicKey));
110
+
111
+ const decoded = decodeV1networkOperation(encodeV1networkOperation(payload));
112
+ t.is(decoded.validator_connection_response.result, code);
113
+ }
114
+ });
115
+
40
116
  test('NetworkMessageBuilder iterates liveness response ResultCode values', async t => {
41
117
  const wallet = createWallet();
42
118
  const builder = new NetworkMessageBuilder(wallet, config);
@@ -49,6 +125,7 @@ test('NetworkMessageBuilder iterates liveness response ResultCode values', async
49
125
  .setType(NetworkOperationType.LIVENESS_RESPONSE)
50
126
  .setId(id)
51
127
  .setTimestamp()
128
+ .setData(data)
52
129
  .setCapabilities(caps)
53
130
  .setResultCode(code)
54
131
  .buildPayload();
@@ -79,11 +156,13 @@ test('NetworkMessageBuilder builds liveness request and verifies signature (data
79
156
 
80
157
  const id = uuidv7();
81
158
  const caps = ['cap:b', 'cap:a'];
159
+ const data = b4a.from('ping', 'utf8');
82
160
 
83
161
  await builder
84
162
  .setType(NetworkOperationType.LIVENESS_REQUEST)
85
163
  .setId(id)
86
164
  .setTimestamp()
165
+ .setData(data)
87
166
  .setCapabilities(caps)
88
167
  .buildPayload();
89
168
 
@@ -108,275 +187,36 @@ test('NetworkMessageBuilder iterates broadcast transaction response ResultCode v
108
187
  const builder = new NetworkMessageBuilder(wallet, config);
109
188
  const id = uuidv7();
110
189
  const caps = ['cap:b', 'cap:a'];
111
- const proof = b4a.from('deadbeef', 'hex');
112
- const timestamp = Date.now();
113
- const emptyProof = b4a.alloc(0);
114
190
 
115
191
  for (const code of uniqueResultCodes()) {
116
- const includeProof = code === NetworkResultCode.OK;
117
- const proofUnavailable = code === NetworkResultCode.TX_ACCEPTED_PROOF_UNAVAILABLE;
118
- const responseProof = includeProof ? proof : emptyProof;
119
- const responseTimestampLedger = includeProof || proofUnavailable ? timestamp : 0;
120
192
  await builder
121
193
  .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
122
194
  .setId(id)
123
195
  .setTimestamp()
124
196
  .setCapabilities(caps)
125
- .setProof(responseProof)
126
- .setTimestampLedger(responseTimestampLedger)
127
197
  .setResultCode(code)
128
198
  .buildPayload();
129
199
 
130
200
  const payload = builder.getResult();
131
201
  t.is(payload.type, NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE);
132
202
  t.is(payload.broadcast_transaction_response.result, code);
133
- t.alike(payload.broadcast_transaction_response.proof, responseProof);
134
- t.is(payload.broadcast_transaction_response.timestamp, responseTimestampLedger);
135
203
 
136
204
  const msg = createMessage(
137
205
  payload.type,
138
206
  idToBuffer(payload.id),
139
207
  timestampToBuffer(payload.timestamp),
140
208
  payload.broadcast_transaction_response.nonce,
141
- responseProof,
142
- timestampToBuffer(responseTimestampLedger),
143
209
  safeWriteUInt32BE(code, 0),
144
210
  encodeCapabilities(caps)
145
211
  );
146
-
147
212
  const hash = await PeerWallet.blake3(msg);
148
213
  t.ok(wallet.verify(payload.broadcast_transaction_response.signature, hash, wallet.publicKey));
149
214
 
150
215
  const decoded = decodeV1networkOperation(encodeV1networkOperation(payload));
151
216
  t.is(decoded.broadcast_transaction_response.result, code);
152
- t.alike(decoded.broadcast_transaction_response.proof, responseProof);
153
- t.is(decoded.broadcast_transaction_response.timestamp, responseTimestampLedger);
154
217
  }
155
218
  });
156
219
 
157
- test('NetworkMessageBuilder builds broadcast transaction response with proof and timestamp', async t => {
158
- const wallet = createWallet();
159
- const builder = new NetworkMessageBuilder(wallet, config);
160
- const id = uuidv7();
161
- const caps = ['cap:b', 'cap:a'];
162
- const proof = b4a.from('deadbeef', 'hex');
163
- const timestamp = Date.now();
164
-
165
- await builder
166
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
167
- .setId(id)
168
- .setTimestamp()
169
- .setCapabilities(caps)
170
- .setProof(proof)
171
- .setTimestampLedger(timestamp)
172
- .setResultCode(NetworkResultCode.OK)
173
- .buildPayload();
174
-
175
- const payload = builder.getResult();
176
- t.alike(payload.broadcast_transaction_response.proof, proof);
177
- t.is(payload.broadcast_transaction_response.timestamp, timestamp);
178
-
179
- const msg = createMessage(
180
- payload.type,
181
- idToBuffer(payload.id),
182
- timestampToBuffer(payload.timestamp),
183
- payload.broadcast_transaction_response.nonce,
184
- proof,
185
- timestampToBuffer(timestamp),
186
- safeWriteUInt32BE(NetworkResultCode.OK, 0),
187
- encodeCapabilities(caps)
188
- );
189
- const hash = await PeerWallet.blake3(msg);
190
- t.ok(wallet.verify(payload.broadcast_transaction_response.signature, hash, wallet.publicKey));
191
-
192
- const decoded = decodeV1networkOperation(encodeV1networkOperation(payload));
193
- t.alike(decoded.broadcast_transaction_response.proof, proof);
194
- t.is(decoded.broadcast_transaction_response.timestamp, timestamp);
195
- });
196
-
197
- test('NetworkMessageBuilder rejects OK response when proof is provided without timestamp', async t => {
198
- const wallet = createWallet();
199
- const builder = new NetworkMessageBuilder(wallet, config);
200
- const id = uuidv7();
201
- const caps = ['cap:b', 'cap:a'];
202
- const proof = b4a.from('deadbeef', 'hex');
203
-
204
- await t.exception(
205
- () =>
206
- builder
207
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
208
- .setId(id)
209
- .setTimestamp()
210
- .setCapabilities(caps)
211
- .setProof(proof)
212
- .setResultCode(NetworkResultCode.OK)
213
- .buildPayload(),
214
- errorMessageIncludes('Result code OK requires non-empty proof and timestamp > 0.')
215
- );
216
- });
217
-
218
- test('NetworkMessageBuilder rejects OK response when timestamp is provided without proof', async t => {
219
- const wallet = createWallet();
220
- const builder = new NetworkMessageBuilder(wallet, config);
221
- const id = uuidv7();
222
- const caps = ['cap:b', 'cap:a'];
223
- const timestamp = Date.now();
224
-
225
- await t.exception(
226
- () =>
227
- builder
228
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
229
- .setId(id)
230
- .setTimestamp()
231
- .setCapabilities(caps)
232
- .setTimestampLedger(timestamp)
233
- .setResultCode(NetworkResultCode.OK)
234
- .buildPayload(),
235
- errorMessageIncludes('Result code OK requires non-empty proof and timestamp > 0.')
236
- );
237
- });
238
-
239
- test('NetworkMessageBuilder allows TX_ACCEPTED_PROOF_UNAVAILABLE response with timestamp and empty proof', async t => {
240
- const wallet = createWallet();
241
- const builder = new NetworkMessageBuilder(wallet, config);
242
- const id = uuidv7();
243
- const caps = ['cap:b', 'cap:a'];
244
- const timestamp = Date.now();
245
- const emptyProof = b4a.alloc(0);
246
-
247
- await builder
248
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
249
- .setId(id)
250
- .setTimestamp()
251
- .setCapabilities(caps)
252
- .setProof(emptyProof)
253
- .setTimestampLedger(timestamp)
254
- .setResultCode(NetworkResultCode.TX_ACCEPTED_PROOF_UNAVAILABLE)
255
- .buildPayload();
256
-
257
- const payload = builder.getResult();
258
- t.alike(payload.broadcast_transaction_response.proof, emptyProof);
259
- t.is(payload.broadcast_transaction_response.timestamp, timestamp);
260
- t.is(payload.broadcast_transaction_response.result, NetworkResultCode.TX_ACCEPTED_PROOF_UNAVAILABLE);
261
-
262
- const msg = createMessage(
263
- payload.type,
264
- idToBuffer(payload.id),
265
- timestampToBuffer(payload.timestamp),
266
- payload.broadcast_transaction_response.nonce,
267
- emptyProof,
268
- timestampToBuffer(timestamp),
269
- safeWriteUInt32BE(NetworkResultCode.TX_ACCEPTED_PROOF_UNAVAILABLE, 0),
270
- encodeCapabilities(caps)
271
- );
272
- const hash = await PeerWallet.blake3(msg);
273
- t.ok(wallet.verify(payload.broadcast_transaction_response.signature, hash, wallet.publicKey));
274
-
275
- const decoded = decodeV1networkOperation(encodeV1networkOperation(payload));
276
- t.is(decoded.broadcast_transaction_response.timestamp, timestamp);
277
- t.is(decoded.broadcast_transaction_response.result, NetworkResultCode.TX_ACCEPTED_PROOF_UNAVAILABLE);
278
- });
279
-
280
- test('NetworkMessageBuilder rejects OK response when proof and timestamp are both missing', async t => {
281
- const wallet = createWallet();
282
- const builder = new NetworkMessageBuilder(wallet, config);
283
- const id = uuidv7();
284
- const caps = ['cap:b', 'cap:a'];
285
-
286
- await t.exception(
287
- () =>
288
- builder
289
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
290
- .setId(id)
291
- .setTimestamp()
292
- .setCapabilities(caps)
293
- .setResultCode(NetworkResultCode.OK)
294
- .buildPayload(),
295
- errorMessageIncludes('Result code OK requires non-empty proof and timestamp > 0.')
296
- );
297
- });
298
-
299
- test('NetworkMessageBuilder rejects TX_ACCEPTED_PROOF_UNAVAILABLE response when timestamp is missing', async t => {
300
- const wallet = createWallet();
301
- const builder = new NetworkMessageBuilder(wallet, config);
302
- const id = uuidv7();
303
- const caps = ['cap:b', 'cap:a'];
304
-
305
- await t.exception(
306
- () =>
307
- builder
308
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
309
- .setId(id)
310
- .setTimestamp()
311
- .setCapabilities(caps)
312
- .setResultCode(NetworkResultCode.TX_ACCEPTED_PROOF_UNAVAILABLE)
313
- .buildPayload(),
314
- errorMessageIncludes('Result code TX_ACCEPTED_PROOF_UNAVAILABLE requires timestamp > 0.')
315
- );
316
- });
317
-
318
- test('NetworkMessageBuilder rejects TX_ACCEPTED_PROOF_UNAVAILABLE response when proof is non-empty', async t => {
319
- const wallet = createWallet();
320
- const builder = new NetworkMessageBuilder(wallet, config);
321
- const id = uuidv7();
322
- const caps = ['cap:b', 'cap:a'];
323
-
324
- await t.exception(
325
- () =>
326
- builder
327
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
328
- .setId(id)
329
- .setTimestamp()
330
- .setCapabilities(caps)
331
- .setProof(b4a.from('deadbeef', 'hex'))
332
- .setTimestampLedger(Date.now())
333
- .setResultCode(NetworkResultCode.TX_ACCEPTED_PROOF_UNAVAILABLE)
334
- .buildPayload(),
335
- errorMessageIncludes('Result code TX_ACCEPTED_PROOF_UNAVAILABLE requires empty proof.')
336
- );
337
- });
338
-
339
- test('NetworkMessageBuilder rejects non-OK response when proof is non-empty', async t => {
340
- const wallet = createWallet();
341
- const builder = new NetworkMessageBuilder(wallet, config);
342
- const id = uuidv7();
343
- const caps = ['cap:b', 'cap:a'];
344
-
345
- await t.exception(
346
- () =>
347
- builder
348
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
349
- .setId(id)
350
- .setTimestamp()
351
- .setCapabilities(caps)
352
- .setProof(b4a.from('deadbeef', 'hex'))
353
- .setTimestampLedger(0)
354
- .setResultCode(NetworkResultCode.INVALID_PAYLOAD)
355
- .buildPayload(),
356
- errorMessageIncludes('Non-OK result code requires empty proof.')
357
- );
358
- });
359
-
360
- test('NetworkMessageBuilder rejects non-OK response with timestamp > 0 unless proof is unavailable', async t => {
361
- const wallet = createWallet();
362
- const builder = new NetworkMessageBuilder(wallet, config);
363
- const id = uuidv7();
364
- const caps = ['cap:b', 'cap:a'];
365
-
366
- await t.exception(
367
- () =>
368
- builder
369
- .setType(NetworkOperationType.BROADCAST_TRANSACTION_RESPONSE)
370
- .setId(id)
371
- .setTimestamp()
372
- .setCapabilities(caps)
373
- .setTimestampLedger(Date.now())
374
- .setResultCode(NetworkResultCode.INVALID_PAYLOAD)
375
- .buildPayload(),
376
- errorMessageIncludes('Non-OK result code requires timestamp to be 0, except TX_ACCEPTED_PROOF_UNAVAILABLE.')
377
- );
378
- });
379
-
380
220
  test('NetworkMessageBuilder builds broadcast transaction request and verifies signature', async t => {
381
221
  const wallet = createWallet();
382
222
  const builder = new NetworkMessageBuilder(wallet, config);