trac-msb 0.2.17 → 0.2.19

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 (365) hide show
  1. package/README.md +62 -2
  2. package/SECURITY.md +9 -6
  3. package/cli/commandHandler.js +272 -0
  4. package/cli/handlers.js +210 -0
  5. package/cli/interactive.js +182 -0
  6. package/msb.mjs +7 -8
  7. package/package.json +33 -11
  8. package/rpc/create_server.js +44 -44
  9. package/rpc/handlers.js +43 -56
  10. package/rpc/routes/index.js +8 -8
  11. package/rpc/rpc_server.js +6 -2
  12. package/rpc/utils/helpers.js +46 -66
  13. package/scripts/pear-runner.js +170 -0
  14. package/src/config/args.js +60 -13
  15. package/src/config/config.js +163 -14
  16. package/src/config/env.js +57 -25
  17. package/src/core/network/Network.js +121 -56
  18. package/src/core/network/protocols/LegacyProtocol.js +21 -11
  19. package/src/core/network/protocols/NetworkMessages.js +38 -17
  20. package/src/core/network/protocols/ProtocolInterface.js +15 -3
  21. package/src/core/network/protocols/ProtocolSession.js +144 -17
  22. package/src/core/network/protocols/V1Protocol.js +37 -18
  23. package/src/core/network/protocols/connectionPolicies.js +174 -0
  24. package/src/core/network/protocols/legacy/NetworkMessageRouter.js +26 -20
  25. package/src/core/network/protocols/{shared/handlers/base/BaseOperationHandler.js → legacy/handlers/BaseStateOperationHandler.js} +25 -14
  26. package/src/core/network/protocols/legacy/handlers/{GetRequestHandler.js → LegacyGetRequestHandler.js} +9 -9
  27. package/src/core/network/protocols/legacy/handlers/LegacyResponseHandler.js +23 -0
  28. package/src/core/network/protocols/{shared/handlers/RoleOperationHandler.js → legacy/handlers/LegacyRoleOperationHandler.js} +19 -12
  29. package/src/core/network/protocols/{shared/handlers/SubnetworkOperationHandler.js → legacy/handlers/LegacySubnetworkOperationHandler.js} +29 -18
  30. package/src/core/network/protocols/{shared/handlers/TransferOperationHandler.js → legacy/handlers/LegacyTransferOperationHandler.js} +18 -12
  31. package/src/core/network/protocols/legacy/validators/base/BaseResponse.js +7 -10
  32. package/src/core/network/protocols/shared/validators/{PartialBootstrapDeployment.js → PartialBootstrapDeploymentValidator.js} +9 -4
  33. package/src/core/network/protocols/shared/validators/{base/PartialOperation.js → PartialOperationValidator.js} +53 -31
  34. package/src/core/network/protocols/shared/validators/{PartialRoleAccess.js → PartialRoleAccessValidator.js} +51 -17
  35. package/src/core/network/protocols/shared/validators/{PartialTransaction.js → PartialTransactionValidator.js} +21 -7
  36. package/src/core/network/protocols/shared/validators/{PartialTransfer.js → PartialTransferValidator.js} +32 -14
  37. package/src/core/network/protocols/v1/NetworkMessageRouter.js +91 -7
  38. package/src/core/network/protocols/v1/V1ProtocolError.js +27 -0
  39. package/src/core/network/protocols/v1/handlers/V1BaseOperationHandler.js +66 -0
  40. package/src/core/network/protocols/v1/handlers/V1BroadcastTransactionOperationHandler.js +272 -0
  41. package/src/core/network/protocols/v1/handlers/V1LivenessOperationHandler.js +88 -0
  42. package/src/core/network/protocols/v1/handlers/broadcastTransaction/BroadcastTransactionErrorMapper.js +84 -0
  43. package/src/core/network/protocols/v1/handlers/broadcastTransaction/BroadcastTransactionOperationStrategies.js +128 -0
  44. package/src/core/network/protocols/v1/handlers/broadcastTransaction/BroadcastTransactionPayloadUtils.js +26 -0
  45. package/src/core/network/protocols/v1/validators/V1BaseOperation.js +212 -0
  46. package/src/core/network/protocols/v1/validators/V1BroadcastTransactionRequest.js +28 -0
  47. package/src/core/network/protocols/v1/validators/V1BroadcastTransactionResponse.js +260 -0
  48. package/src/core/network/protocols/v1/validators/V1LivenessRequest.js +15 -0
  49. package/src/core/network/protocols/v1/validators/V1LivenessResponse.js +17 -0
  50. package/src/core/network/protocols/v1/validators/V1ValidationSchema.js +210 -0
  51. package/src/core/network/services/ConnectionManager.js +149 -96
  52. package/src/core/network/services/MessageOrchestrator.js +197 -37
  53. package/src/core/network/services/PendingRequestService.js +175 -0
  54. package/src/core/network/services/TransactionCommitService.js +149 -0
  55. package/src/core/network/services/TransactionPoolService.js +129 -18
  56. package/src/core/network/services/TransactionRateLimiterService.js +57 -35
  57. package/src/core/network/services/ValidatorHealthCheckService.js +127 -0
  58. package/src/core/network/services/ValidatorObserverService.js +400 -121
  59. package/src/core/state/State.js +259 -156
  60. package/src/core/state/utils/address.js +4 -9
  61. package/src/core/state/utils/balance.js +7 -7
  62. package/src/core/state/utils/roles.js +1 -1
  63. package/src/index.js +320 -278
  64. package/src/messages/network/v1/NetworkMessageBuilder.js +71 -100
  65. package/src/messages/network/v1/NetworkMessageDirector.js +16 -50
  66. package/src/messages/network/v1/networkMessageFactory.js +1 -1
  67. package/src/messages/state/ApplyStateMessageBuilder.js +6 -6
  68. package/src/messages/state/applyStateMessageFactory.js +1 -1
  69. package/src/utils/Scheduler.js +0 -8
  70. package/src/utils/buffer.js +1 -1
  71. package/src/utils/check.js +12 -13
  72. package/src/utils/constants.js +78 -5
  73. package/src/utils/deepEqualApplyPayload.js +40 -0
  74. package/src/utils/errors.js +20 -0
  75. package/src/utils/fileUtils.js +12 -3
  76. package/src/utils/helpers.js +10 -1
  77. package/src/utils/logger.js +25 -0
  78. package/src/utils/migrationUtils.js +3 -3
  79. package/src/utils/normalizers.js +38 -0
  80. package/src/utils/protobuf/networkV1.generated.cjs +2460 -0
  81. package/src/utils/protobuf/operationHelpers.js +24 -3
  82. package/.dockerignore +0 -16
  83. package/.github/workflows/acceptance-tests.yml +0 -38
  84. package/.github/workflows/lint-pr-title.yml +0 -26
  85. package/.github/workflows/publish.yml +0 -33
  86. package/.github/workflows/unit-tests.yml +0 -34
  87. package/CODE_OF_CONDUCT.md +0 -128
  88. package/docker-compose.yml +0 -17
  89. package/dockerfile +0 -41
  90. package/docs/fee_distribution.md +0 -89
  91. package/docs/trac_network_http_api.openapi.yaml +0 -889
  92. package/migration/.gitkeep +0 -0
  93. package/proto/applyOperations.proto +0 -117
  94. package/proto/network.proto +0 -74
  95. package/rpc/rpc_services.js +0 -163
  96. package/scripts/generate-protobufs.js +0 -42
  97. package/src/core/network/identity/NetworkWalletFactory.js +0 -77
  98. package/src/core/network/protocols/legacy/handlers/ResponseHandler.js +0 -37
  99. package/src/utils/cli.js +0 -130
  100. package/src/utils/cliCommands.js +0 -280
  101. package/src/utils/protobuf/network.cjs +0 -840
  102. package/tests/acceptance/v1/account/account.test.mjs +0 -123
  103. package/tests/acceptance/v1/balance/balance.test.mjs +0 -54
  104. package/tests/acceptance/v1/broadcast-transaction/broadcast-transaction.test.mjs +0 -116
  105. package/tests/acceptance/v1/confirmed-length/confirmed-length.test.mjs +0 -19
  106. package/tests/acceptance/v1/fee/fee.test.mjs +0 -11
  107. package/tests/acceptance/v1/health/health.test.mjs +0 -33
  108. package/tests/acceptance/v1/rpc.test.mjs +0 -95
  109. package/tests/acceptance/v1/tx/tx.test.mjs +0 -111
  110. package/tests/acceptance/v1/tx-details/tx-details.test.mjs +0 -213
  111. package/tests/acceptance/v1/tx-hashes/tx-hashes.test.mjs +0 -72
  112. package/tests/acceptance/v1/tx-payloads-bulk/tx-payloads-bulk.test.mjs +0 -27
  113. package/tests/acceptance/v1/txv/txv.test.mjs +0 -11
  114. package/tests/acceptance/v1/unconfirmed-length/unconfirmed-length.test.mjs +0 -11
  115. package/tests/fixtures/apply.fixtures.js +0 -77
  116. package/tests/fixtures/assembleMessage.fixtures.js +0 -41
  117. package/tests/fixtures/check.fixtures.js +0 -428
  118. package/tests/fixtures/networkV1.fixtures.js +0 -85
  119. package/tests/fixtures/protobuf.fixtures.js +0 -388
  120. package/tests/helpers/StateNetworkFactory.js +0 -155
  121. package/tests/helpers/address.js +0 -6
  122. package/tests/helpers/autobaseTestHelpers.js +0 -419
  123. package/tests/helpers/config.js +0 -4
  124. package/tests/helpers/createTestSignature.js +0 -13
  125. package/tests/helpers/regexHelper.js +0 -3
  126. package/tests/helpers/setupApplyTests.js +0 -587
  127. package/tests/helpers/transactionPayloads.mjs +0 -92
  128. package/tests/helpers/wrapper.js +0 -28
  129. package/tests/unit/messages/messages.test.js +0 -12
  130. package/tests/unit/messages/network/NetworkMessageBuilder.test.js +0 -276
  131. package/tests/unit/messages/network/NetworkMessageDirector.test.js +0 -201
  132. package/tests/unit/messages/state/applyStateMessageBuilder.complete.test.js +0 -525
  133. package/tests/unit/messages/state/applyStateMessageBuilder.partial.test.js +0 -237
  134. package/tests/unit/network/ConnectionManager.test.js +0 -191
  135. package/tests/unit/network/NetworkWalletFactory.test.js +0 -156
  136. package/tests/unit/network/networkModule.test.js +0 -10
  137. package/tests/unit/state/State.test.js +0 -80
  138. package/tests/unit/state/apply/addAdmin/addAdminHappyPathScenario.js +0 -42
  139. package/tests/unit/state/apply/addAdmin/addAdminScenarioHelpers.js +0 -276
  140. package/tests/unit/state/apply/addAdmin/adminEntryEncodingFailureScenario.js +0 -30
  141. package/tests/unit/state/apply/addAdmin/adminEntryExistsScenario.js +0 -78
  142. package/tests/unit/state/apply/addAdmin/nodeEntryInitializationFailureScenario.js +0 -30
  143. package/tests/unit/state/apply/addAdmin/nonBootstrapNodeScenario.js +0 -68
  144. package/tests/unit/state/apply/addAdmin/state.apply.addAdmin.test.js +0 -159
  145. package/tests/unit/state/apply/addIndexer/addIndexerHappyPathScenario.js +0 -39
  146. package/tests/unit/state/apply/addIndexer/addIndexerMultipleIndexersInTheNetworkScenario.js +0 -167
  147. package/tests/unit/state/apply/addIndexer/addIndexerPretenderAlreadyIndexerScenario.js +0 -21
  148. package/tests/unit/state/apply/addIndexer/addIndexerPretenderNotWriterScenario.js +0 -21
  149. package/tests/unit/state/apply/addIndexer/addIndexerRemoveAndReAddScenario.js +0 -186
  150. package/tests/unit/state/apply/addIndexer/addIndexerScenarioHelpers.js +0 -443
  151. package/tests/unit/state/apply/addIndexer/addIndexerWriterKeyAlreadyRegisteredScenario.js +0 -32
  152. package/tests/unit/state/apply/addIndexer/state.apply.addIndexer.test.js +0 -297
  153. package/tests/unit/state/apply/addWriter/addWriterHappyPathScenario.js +0 -41
  154. package/tests/unit/state/apply/addWriter/addWriterInvalidValidatorSignatureScenario.js +0 -32
  155. package/tests/unit/state/apply/addWriter/addWriterNewWkScenario.js +0 -149
  156. package/tests/unit/state/apply/addWriter/addWriterRequesterAlreadyWriterScenario.js +0 -21
  157. package/tests/unit/state/apply/addWriter/addWriterRequesterBalanceInsufficientScenario.js +0 -21
  158. package/tests/unit/state/apply/addWriter/addWriterRequesterEntryDecodeFailureScenario.js +0 -19
  159. package/tests/unit/state/apply/addWriter/addWriterRequesterEntryMissingScenario.js +0 -19
  160. package/tests/unit/state/apply/addWriter/addWriterRequesterIndexerScenario.js +0 -21
  161. package/tests/unit/state/apply/addWriter/addWriterRequesterNotWhitelistedScenario.js +0 -21
  162. package/tests/unit/state/apply/addWriter/addWriterScenarioHelpers.js +0 -766
  163. package/tests/unit/state/apply/addWriter/addWriterStakeBalanceUpdateFailureScenario.js +0 -50
  164. package/tests/unit/state/apply/addWriter/addWriterStakeInsufficientBalanceScenario.js +0 -29
  165. package/tests/unit/state/apply/addWriter/addWriterStakeInvalidBalanceScenario.js +0 -29
  166. package/tests/unit/state/apply/addWriter/addWriterStakeInvalidEntryScenario.js +0 -21
  167. package/tests/unit/state/apply/addWriter/addWriterStakeStakedBalanceFailureScenario.js +0 -37
  168. package/tests/unit/state/apply/addWriter/addWriterStakeSubtractFailureScenario.js +0 -42
  169. package/tests/unit/state/apply/addWriter/addWriterValidatorRewardScenario.js +0 -106
  170. package/tests/unit/state/apply/addWriter/addWriterWriterKeyMismatchScenario.js +0 -54
  171. package/tests/unit/state/apply/addWriter/addWriterWriterKeyOwnershipScenario.js +0 -54
  172. package/tests/unit/state/apply/addWriter/addWriterZeroWriterKeyScenario.js +0 -29
  173. package/tests/unit/state/apply/addWriter/state.apply.addWriter.test.js +0 -309
  174. package/tests/unit/state/apply/adminRecovery/adminRecoveryHappyPathScenario.js +0 -30
  175. package/tests/unit/state/apply/adminRecovery/adminRecoveryScenarioHelpers.js +0 -881
  176. package/tests/unit/state/apply/adminRecovery/state.apply.adminRecovery.test.js +0 -435
  177. package/tests/unit/state/apply/appendWhitelist/appendWhitelistBanAndReapplyScenario.js +0 -78
  178. package/tests/unit/state/apply/appendWhitelist/appendWhitelistExistingReaderHappyPathScenario.js +0 -98
  179. package/tests/unit/state/apply/appendWhitelist/appendWhitelistFeeAfterDisableScenario.js +0 -66
  180. package/tests/unit/state/apply/appendWhitelist/appendWhitelistHappyPathScenario.js +0 -55
  181. package/tests/unit/state/apply/appendWhitelist/appendWhitelistInsufficientAdminBalanceScenario.js +0 -103
  182. package/tests/unit/state/apply/appendWhitelist/appendWhitelistNodeAlreadyWhitelistedScenario.js +0 -60
  183. package/tests/unit/state/apply/appendWhitelist/appendWhitelistScenarioHelpers.js +0 -189
  184. package/tests/unit/state/apply/appendWhitelist/state.apply.appendWhitelist.test.js +0 -220
  185. package/tests/unit/state/apply/balanceInitialization/balanceInitializationHappyPathScenario.js +0 -82
  186. package/tests/unit/state/apply/balanceInitialization/balanceInitializationScenarioHelpers.js +0 -111
  187. package/tests/unit/state/apply/balanceInitialization/invalidAmountScenario.js +0 -45
  188. package/tests/unit/state/apply/balanceInitialization/nodeEntryBalanceUpdateFailureScenario.js +0 -82
  189. package/tests/unit/state/apply/balanceInitialization/state.apply.balanceInitialization.test.js +0 -189
  190. package/tests/unit/state/apply/banValidator/banValidatorBanAndReWhitelistScenario.js +0 -156
  191. package/tests/unit/state/apply/banValidator/banValidatorHappyPathScenario.js +0 -36
  192. package/tests/unit/state/apply/banValidator/banValidatorScenarioHelpers.js +0 -531
  193. package/tests/unit/state/apply/banValidator/banValidatorSequentialBansScenario.js +0 -74
  194. package/tests/unit/state/apply/banValidator/banValidatorTargetDecodeFailureScenario.js +0 -19
  195. package/tests/unit/state/apply/banValidator/banValidatorTargetIndexerScenario.js +0 -32
  196. package/tests/unit/state/apply/banValidator/banValidatorTargetNodeEntryMissingScenario.js +0 -19
  197. package/tests/unit/state/apply/banValidator/banValidatorTargetRoleUpdateFailureScenario.js +0 -19
  198. package/tests/unit/state/apply/banValidator/banValidatorWhitelistedNonWriterScenario.js +0 -38
  199. package/tests/unit/state/apply/banValidator/banValidatorWhitelistedZeroBalanceScenario.js +0 -91
  200. package/tests/unit/state/apply/banValidator/banValidatorWithdrawFailureScenario.js +0 -19
  201. package/tests/unit/state/apply/banValidator/state.apply.banValidator.test.js +0 -266
  202. package/tests/unit/state/apply/bootstrapDeployment/bootstrapDeploymentDuplicateRegistrationScenario.js +0 -143
  203. package/tests/unit/state/apply/bootstrapDeployment/bootstrapDeploymentHappyPathScenario.js +0 -26
  204. package/tests/unit/state/apply/bootstrapDeployment/bootstrapDeploymentIncompleteOperationScenario.js +0 -94
  205. package/tests/unit/state/apply/bootstrapDeployment/bootstrapDeploymentInvalidDeploymentEntryScenario.js +0 -37
  206. package/tests/unit/state/apply/bootstrapDeployment/bootstrapDeploymentMultipleBootstrapScenario.js +0 -86
  207. package/tests/unit/state/apply/bootstrapDeployment/bootstrapDeploymentScenarioHelpers.js +0 -347
  208. package/tests/unit/state/apply/bootstrapDeployment/invalidValidatorNodeEntryScenario.js +0 -57
  209. package/tests/unit/state/apply/bootstrapDeployment/state.apply.bootstrapDeployment.test.js +0 -429
  210. package/tests/unit/state/apply/common/access-control/adminConsistencyMismatchScenario.js +0 -120
  211. package/tests/unit/state/apply/common/access-control/adminEntryDecodeFailureScenario.js +0 -130
  212. package/tests/unit/state/apply/common/access-control/adminEntryExistsScenario.js +0 -93
  213. package/tests/unit/state/apply/common/access-control/adminEntryMissingScenario.js +0 -108
  214. package/tests/unit/state/apply/common/access-control/adminOnlyGuardScenario.js +0 -126
  215. package/tests/unit/state/apply/common/access-control/adminPublicKeyDecodeFailureScenario.js +0 -121
  216. package/tests/unit/state/apply/common/access-control/roleAccessOperationValidationScenario.js +0 -50
  217. package/tests/unit/state/apply/common/adminControlOperationValidationScenario.js +0 -56
  218. package/tests/unit/state/apply/common/balances/adminEntryUpdateFailureScenario.js +0 -52
  219. package/tests/unit/state/apply/common/balances/base/requesterBalanceScenarioBase.js +0 -198
  220. package/tests/unit/state/apply/common/balances/feeDecodeFailureScenario.js +0 -52
  221. package/tests/unit/state/apply/common/balances/requesterBalanceDecodeFailureScenario.js +0 -15
  222. package/tests/unit/state/apply/common/balances/requesterBalanceFeeApplicationFailureScenario.js +0 -11
  223. package/tests/unit/state/apply/common/balances/requesterBalanceInsufficientScenario.js +0 -15
  224. package/tests/unit/state/apply/common/balances/requesterBalanceUpdateFailureScenario.js +0 -11
  225. package/tests/unit/state/apply/common/balances/validatorEntryRewardFailureScenario.js +0 -11
  226. package/tests/unit/state/apply/common/balances/validatorEntryUpdateFailureScenario.js +0 -11
  227. package/tests/unit/state/apply/common/balances/validatorNodeEntryDecodeFailureScenario.js +0 -40
  228. package/tests/unit/state/apply/common/base/OperationValidationScenarioBase.js +0 -114
  229. package/tests/unit/state/apply/common/commonScenarioHelper.js +0 -103
  230. package/tests/unit/state/apply/common/indexer/indexerNodeEntryDecodeFailureScenario.js +0 -36
  231. package/tests/unit/state/apply/common/indexer/indexerNodeEntryMissingScenario.js +0 -36
  232. package/tests/unit/state/apply/common/indexer/indexerRoleUpdateFailureScenario.js +0 -29
  233. package/tests/unit/state/apply/common/indexer/indexerSequenceStateInvalidScenario.js +0 -66
  234. package/tests/unit/state/apply/common/invalidMessageComponentValidationScenario.js +0 -84
  235. package/tests/unit/state/apply/common/nodeEntryInitializationFailureScenario.js +0 -47
  236. package/tests/unit/state/apply/common/operationAlreadyAppliedScenario.js +0 -85
  237. package/tests/unit/state/apply/common/payload-structure/addressWithInvalidPublicKeyScenario.js +0 -52
  238. package/tests/unit/state/apply/common/payload-structure/initializationDisabledScenario.js +0 -54
  239. package/tests/unit/state/apply/common/payload-structure/invalidAddressValidationScenario.js +0 -73
  240. package/tests/unit/state/apply/common/payload-structure/invalidHashValidationScenario.js +0 -71
  241. package/tests/unit/state/apply/common/payload-structure/invalidPayloadValidationScenario.js +0 -31
  242. package/tests/unit/state/apply/common/payload-structure/invalidSignatureValidationScenario.js +0 -142
  243. package/tests/unit/state/apply/common/payload-structure/partialOperationValidationScenario.js +0 -87
  244. package/tests/unit/state/apply/common/requester/requesterNodeEntryBufferMissingScenario.js +0 -71
  245. package/tests/unit/state/apply/common/requester/requesterNodeEntryDecodeFailureScenario.js +0 -73
  246. package/tests/unit/state/apply/common/requester/requesterNodeEntryMissingScenario.js +0 -36
  247. package/tests/unit/state/apply/common/requesterAddressValidationScenario.js +0 -44
  248. package/tests/unit/state/apply/common/requesterPublicKeyValidationScenario.js +0 -25
  249. package/tests/unit/state/apply/common/transactionValidityMismatchScenario.js +0 -98
  250. package/tests/unit/state/apply/common/validatorConsistency/base/validatorConsistencyScenarioBase.js +0 -202
  251. package/tests/unit/state/apply/common/validatorConsistency/validatorEntryDecodeFailureScenario.js +0 -17
  252. package/tests/unit/state/apply/common/validatorConsistency/validatorEntryMissingScenario.js +0 -44
  253. package/tests/unit/state/apply/common/validatorConsistency/validatorInactiveScenario.js +0 -19
  254. package/tests/unit/state/apply/common/validatorConsistency/validatorWriterKeyMismatchScenario.js +0 -18
  255. package/tests/unit/state/apply/common/validatorEntryValidation/base/validatorEntryValidationScenarioBase.js +0 -315
  256. package/tests/unit/state/apply/common/validatorEntryValidation/validatorEntryInvalidBalanceScenario.js +0 -18
  257. package/tests/unit/state/apply/common/writerKeyExistsValidationScenario.js +0 -43
  258. package/tests/unit/state/apply/disableInitialization/disableInitializationAlreadyDisabledScenario.js +0 -53
  259. package/tests/unit/state/apply/disableInitialization/disableInitializationHappyPathScenario.js +0 -24
  260. package/tests/unit/state/apply/disableInitialization/disableInitializationScenarioHelpers.js +0 -204
  261. package/tests/unit/state/apply/disableInitialization/state.apply.disableInitialization.test.js +0 -161
  262. package/tests/unit/state/apply/missing-tests.md +0 -18
  263. package/tests/unit/state/apply/removeIndexer/removeIndexerHappyPathScenario.js +0 -58
  264. package/tests/unit/state/apply/removeIndexer/removeIndexerReAddAndRemoveAgainScenario.js +0 -98
  265. package/tests/unit/state/apply/removeIndexer/removeIndexerRemoveMultipleIndexersScenario.js +0 -167
  266. package/tests/unit/state/apply/removeIndexer/removeIndexerScenarioHelpers.js +0 -429
  267. package/tests/unit/state/apply/removeIndexer/removeIndexerTargetNotIndexerScenario.js +0 -22
  268. package/tests/unit/state/apply/removeIndexer/removeIndexerWriterKeyMissingScenario.js +0 -20
  269. package/tests/unit/state/apply/removeIndexer/state.apply.removeIndexer.test.js +0 -291
  270. package/tests/unit/state/apply/removeWriter/removeWriterAndAddWriterAgainScenario.js +0 -87
  271. package/tests/unit/state/apply/removeWriter/removeWriterHappyPathScenario.js +0 -38
  272. package/tests/unit/state/apply/removeWriter/removeWriterInvalidValidatorSignatureScenario.js +0 -32
  273. package/tests/unit/state/apply/removeWriter/removeWriterRequesterBalanceInsufficientScenario.js +0 -21
  274. package/tests/unit/state/apply/removeWriter/removeWriterRequesterEntryDecodeFailureScenario.js +0 -19
  275. package/tests/unit/state/apply/removeWriter/removeWriterRequesterEntryMissingScenario.js +0 -19
  276. package/tests/unit/state/apply/removeWriter/removeWriterRequesterIndexerScenario.js +0 -21
  277. package/tests/unit/state/apply/removeWriter/removeWriterRequesterNotWriterScenario.js +0 -21
  278. package/tests/unit/state/apply/removeWriter/removeWriterRequesterRoleUpdateFailureScenario.js +0 -19
  279. package/tests/unit/state/apply/removeWriter/removeWriterScenarioHelpers.js +0 -348
  280. package/tests/unit/state/apply/removeWriter/removeWriterThroughWriterValidatorScenario.js +0 -113
  281. package/tests/unit/state/apply/removeWriter/removeWriterUnstakeFailureScenario.js +0 -33
  282. package/tests/unit/state/apply/removeWriter/removeWriterWriterKeyMismatchScenario.js +0 -21
  283. package/tests/unit/state/apply/removeWriter/removeWriterWriterKeyOwnershipScenario.js +0 -26
  284. package/tests/unit/state/apply/removeWriter/removeWriterWriterKeyRegistryMissingScenario.js +0 -22
  285. package/tests/unit/state/apply/removeWriter/state.apply.removeWriter.test.js +0 -307
  286. package/tests/unit/state/apply/state.apply.test.js +0 -24
  287. package/tests/unit/state/apply/transfer/state.apply.transfer.test.js +0 -819
  288. package/tests/unit/state/apply/transfer/transferContractSchemaValidationScenario.js +0 -22
  289. package/tests/unit/state/apply/transfer/transferDoubleSpendAcrossValidatorsScenario.js +0 -146
  290. package/tests/unit/state/apply/transfer/transferDoubleSpendSameBatchScenario.js +0 -63
  291. package/tests/unit/state/apply/transfer/transferDoubleSpendSingleValidatorScenario.js +0 -67
  292. package/tests/unit/state/apply/transfer/transferExistingRecipientAmountScenario.js +0 -31
  293. package/tests/unit/state/apply/transfer/transferExistingRecipientZeroAmountScenario.js +0 -31
  294. package/tests/unit/state/apply/transfer/transferHandlerGuardScenarios.js +0 -22
  295. package/tests/unit/state/apply/transfer/transferHappyPathScenario.js +0 -8
  296. package/tests/unit/state/apply/transfer/transferInvalidIncomingDataScenario.js +0 -66
  297. package/tests/unit/state/apply/transfer/transferNewRecipientAmountScenario.js +0 -31
  298. package/tests/unit/state/apply/transfer/transferNewRecipientZeroAmountScenario.js +0 -31
  299. package/tests/unit/state/apply/transfer/transferScenarioHelpers.js +0 -1170
  300. package/tests/unit/state/apply/transfer/transferSelfTransferAmountScenario.js +0 -38
  301. package/tests/unit/state/apply/transfer/transferSelfTransferZeroAmountScenario.js +0 -38
  302. package/tests/unit/state/apply/transfer/transferValidatorRecipientAmountScenario.js +0 -38
  303. package/tests/unit/state/apply/transfer/transferValidatorRecipientZeroAmountScenario.js +0 -38
  304. package/tests/unit/state/apply/txOperation/state.apply.txOperation.test.js +0 -318
  305. package/tests/unit/state/apply/txOperation/txOperationBootstrapNotRegisteredScenario.js +0 -70
  306. package/tests/unit/state/apply/txOperation/txOperationDifferentValidatorCreatorHappyPathScenario.js +0 -23
  307. package/tests/unit/state/apply/txOperation/txOperationInvalidDeploymentEntryScenario.js +0 -48
  308. package/tests/unit/state/apply/txOperation/txOperationInvalidFeeAmountScenario.js +0 -39
  309. package/tests/unit/state/apply/txOperation/txOperationInvalidSubnetCreatorAddressScenario.js +0 -46
  310. package/tests/unit/state/apply/txOperation/txOperationRequesterCreatorHappyPathScenario.js +0 -21
  311. package/tests/unit/state/apply/txOperation/txOperationScenarioHelpers.js +0 -432
  312. package/tests/unit/state/apply/txOperation/txOperationStandardHappyPathScenario.js +0 -21
  313. package/tests/unit/state/apply/txOperation/txOperationTransferFeeAddCreatorBalanceFailureScenario.js +0 -26
  314. package/tests/unit/state/apply/txOperation/txOperationTransferFeeAddValidatorBalanceFailureScenario.js +0 -25
  315. package/tests/unit/state/apply/txOperation/txOperationTransferFeeAddValidatorBonusFailureScenario.js +0 -27
  316. package/tests/unit/state/apply/txOperation/txOperationTransferFeeDecodeCreatorEntryScenario.js +0 -18
  317. package/tests/unit/state/apply/txOperation/txOperationTransferFeeDecodeRequesterEntryScenario.js +0 -17
  318. package/tests/unit/state/apply/txOperation/txOperationTransferFeeDecodeValidatorEntryScenario.js +0 -31
  319. package/tests/unit/state/apply/txOperation/txOperationTransferFeeGuardBypassScenario.js +0 -49
  320. package/tests/unit/state/apply/txOperation/txOperationTransferFeeGuardScenarioFactory.js +0 -93
  321. package/tests/unit/state/apply/txOperation/txOperationTransferFeeInsufficientRequesterBalanceScenario.js +0 -28
  322. package/tests/unit/state/apply/txOperation/txOperationTransferFeeInvalidCreatorBalanceScenario.js +0 -29
  323. package/tests/unit/state/apply/txOperation/txOperationTransferFeeInvalidRequesterBalanceScenario.js +0 -28
  324. package/tests/unit/state/apply/txOperation/txOperationTransferFeeInvalidRequesterEntryScenario.js +0 -17
  325. package/tests/unit/state/apply/txOperation/txOperationTransferFeeInvalidValidatorBalanceScenario.js +0 -33
  326. package/tests/unit/state/apply/txOperation/txOperationTransferFeeMissingCreatorEntryScenario.js +0 -18
  327. package/tests/unit/state/apply/txOperation/txOperationTransferFeeSubtractFailureScenario.js +0 -25
  328. package/tests/unit/state/apply/txOperation/txOperationTransferFeeUpdateCreatorBalanceFailureScenario.js +0 -26
  329. package/tests/unit/state/apply/txOperation/txOperationTransferFeeUpdateFailureScenario.js +0 -25
  330. package/tests/unit/state/apply/txOperation/txOperationTransferFeeUpdateValidatorBalanceFailureScenario.js +0 -26
  331. package/tests/unit/state/apply/txOperation/txOperationTransferFeeUpdateValidatorBonusFailureScenario.js +0 -27
  332. package/tests/unit/state/apply/txOperation/txOperationValidatorCreatorHappyPathScenario.js +0 -21
  333. package/tests/unit/state/stateModule.test.js +0 -23
  334. package/tests/unit/state/stateTestUtils.js +0 -32
  335. package/tests/unit/state/utils/address.test.js +0 -63
  336. package/tests/unit/state/utils/adminEntry.test.js +0 -52
  337. package/tests/unit/state/utils/balance.test.js +0 -320
  338. package/tests/unit/state/utils/lengthEntry.test.js +0 -54
  339. package/tests/unit/state/utils/nodeEntry.test.js +0 -298
  340. package/tests/unit/state/utils/roles.test.js +0 -44
  341. package/tests/unit/unit.test.js +0 -14
  342. package/tests/unit/utils/amountSerialization/amountSerialization.test.js +0 -237
  343. package/tests/unit/utils/buffer/buffer.test.js +0 -251
  344. package/tests/unit/utils/check/adminControlOperation.test.js +0 -156
  345. package/tests/unit/utils/check/balanceInitializationOperation.test.js +0 -54
  346. package/tests/unit/utils/check/bootstrapDeploymentOperation.test.js +0 -104
  347. package/tests/unit/utils/check/check.test.js +0 -17
  348. package/tests/unit/utils/check/common.test.js +0 -419
  349. package/tests/unit/utils/check/coreAdminOperation.test.js +0 -95
  350. package/tests/unit/utils/check/roleAccessOperation.test.js +0 -255
  351. package/tests/unit/utils/check/transactionOperation.test.js +0 -107
  352. package/tests/unit/utils/check/transferOperation.test.js +0 -102
  353. package/tests/unit/utils/fileUtils/readAddressesFromWhitelistFile.test.js +0 -95
  354. package/tests/unit/utils/fileUtils/readBalanceMigrationFile.test.js +0 -149
  355. package/tests/unit/utils/helpers/helpers.test.js +0 -11
  356. package/tests/unit/utils/helpers/isHexString.test.js +0 -12
  357. package/tests/unit/utils/helpers/normalizeHex.test.js +0 -82
  358. package/tests/unit/utils/migrationUtils/validateAddressFromIncomingFile.test.js +0 -100
  359. package/tests/unit/utils/normalizers/normalizers.test.js +0 -469
  360. package/tests/unit/utils/protobuf/applyOperations.test.js +0 -91
  361. package/tests/unit/utils/protobuf/operationHelpers.test.js +0 -305
  362. package/tests/unit/utils/protobuf/protobuf.test.js +0 -12
  363. package/tests/unit/utils/type/type.test.js +0 -25
  364. package/tests/unit/utils/utils.test.js +0 -20
  365. package/whitelist/.gitkeep +0 -0
@@ -1,36 +0,0 @@
1
- import { test } from 'brittle';
2
- import { eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
3
- import { selectWriterPeer } from '../addWriter/addWriterScenarioHelpers.js';
4
- import {
5
- setupBanValidatorScenario,
6
- buildBanValidatorPayload,
7
- assertBanValidatorSuccessState
8
- } from './banValidatorScenarioHelpers.js';
9
-
10
- export default function banValidatorHappyPathScenario() {
11
- test('State.apply banValidator removes validator privileges - happy path', async t => {
12
- const context = await setupBanValidatorScenario(t);
13
- const adminPeer = context.adminBootstrap;
14
- const validatorPeer = context.banValidatorScenario?.validatorPeer ?? selectWriterPeer(context);
15
-
16
- const validatorEntryBefore = await adminPeer.base.view.get(validatorPeer.wallet.address);
17
- t.ok(validatorEntryBefore, 'validator entry exists before banValidator');
18
-
19
- const adminEntryBefore = await adminPeer.base.view.get(adminPeer.wallet.address);
20
- t.ok(adminEntryBefore, 'admin entry exists before banValidator');
21
-
22
- const payload = await buildBanValidatorPayload(context, { adminPeer, validatorPeer });
23
-
24
- await adminPeer.base.append(payload);
25
- await adminPeer.base.update();
26
- await eventFlush();
27
-
28
- await assertBanValidatorSuccessState(t, context, {
29
- validatorPeer,
30
- adminPeer,
31
- validatorEntryBefore,
32
- adminEntryBefore,
33
- payload
34
- });
35
- });
36
- }
@@ -1,531 +0,0 @@
1
- import b4a from 'b4a';
2
- import PeerWallet from 'trac-wallet';
3
- import { deriveIndexerSequenceState, eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
4
- import { applyStateMessageFactory } from '../../../../../src/messages/state/applyStateMessageFactory.js';
5
- import nodeEntryUtils, { ZERO_LICENSE } from '../../../../../src/core/state/utils/nodeEntry.js';
6
- import addressUtils from '../../../../../src/core/state/utils/address.js';
7
- import lengthEntryUtils from '../../../../../src/core/state/utils/lengthEntry.js';
8
- import { EntryType } from '../../../../../src/utils/constants.js';
9
- import { BALANCE_FEE, BALANCE_ZERO, toBalance } from '../../../../../src/core/state/utils/balance.js';
10
- import { safeDecodeApplyOperation, safeEncodeApplyOperation } from '../../../../../src/utils/protobuf/operationHelpers.js';
11
- import {
12
- setupAddWriterScenario,
13
- selectWriterPeer,
14
- promotePeerToWriter
15
- } from '../addWriter/addWriterScenarioHelpers.js';
16
- import { setupAdminAndWhitelistedReaderNetwork } from '../common/commonScenarioHelper.js';
17
- import { applyWithRequesterEntryRemoval } from '../addWriter/addWriterScenarioHelpers.js';
18
- import { createMessage } from '../../../../../src/utils/buffer.js';
19
- import { OperationType } from '../../../../../src/utils/constants.js';
20
- import { config } from '../../../../helpers/config.js';
21
-
22
- export async function setupBanValidatorScenario(
23
- t,
24
- { promoteToWriter = true, nodes = 2, readerInitialBalance = null } = {}
25
- ) {
26
- if (promoteToWriter) {
27
- const addWriterOptions = { nodes };
28
- if (readerInitialBalance) {
29
- addWriterOptions.writerInitialBalance = readerInitialBalance;
30
- }
31
- const context = await setupAddWriterScenario(t, addWriterOptions);
32
- const validatorPeer = selectWriterPeer(context);
33
- await promotePeerToWriter(t, context, { readerPeer: validatorPeer });
34
- const adminEntry = await context.adminBootstrap.base.view.get(context.adminBootstrap.wallet.address);
35
- const validatorEntry = await context.adminBootstrap.base.view.get(validatorPeer.wallet.address);
36
- context.banValidatorScenario = {
37
- validatorPeer,
38
- adminEntryBefore: adminEntry ? { ...adminEntry, value: b4a.from(adminEntry.value) } : null,
39
- validatorEntryBefore: validatorEntry ? { ...validatorEntry, value: b4a.from(validatorEntry.value) } : null
40
- };
41
- return context;
42
- }
43
-
44
- const context = await setupAdminAndWhitelistedReaderNetwork(t, {
45
- nodes,
46
- readerInitialBalance
47
- });
48
- const validatorPeer = selectWriterPeer(context);
49
- const adminEntry = await context.adminBootstrap.base.view.get(context.adminBootstrap.wallet.address);
50
- const validatorEntry = await context.adminBootstrap.base.view.get(validatorPeer.wallet.address);
51
- context.banValidatorScenario = {
52
- validatorPeer,
53
- adminEntryBefore: adminEntry ? { ...adminEntry, value: b4a.from(adminEntry.value) } : null,
54
- validatorEntryBefore: validatorEntry ? { ...validatorEntry, value: b4a.from(validatorEntry.value) } : null
55
- };
56
- return context;
57
- }
58
-
59
- export async function buildBanValidatorPayload(
60
- context,
61
- { adminPeer = context.adminBootstrap, validatorPeer = selectWriterPeer(context) } = {}
62
- /* cover tests */
63
- ) {
64
- const txValidity = await deriveIndexerSequenceState(adminPeer.base);
65
- return safeEncodeApplyOperation(
66
- await applyStateMessageFactory(adminPeer.wallet, config)
67
- .buildCompleteBanWriterMessage(adminPeer.wallet.address, validatorPeer.wallet.address, txValidity)
68
- );
69
- }
70
-
71
- export async function buildBanValidatorPayloadWithTxValidity(
72
- context,
73
- mutatedTxValidity,
74
- { adminPeer = context.adminBootstrap, validatorPeer = selectWriterPeer(context) } = {}
75
- ) {
76
- return safeEncodeApplyOperation(
77
- await applyStateMessageFactory(adminPeer.wallet, config)
78
- .buildCompleteBanWriterMessage(adminPeer.wallet.address, validatorPeer.wallet.address, mutatedTxValidity)
79
- );
80
- }
81
-
82
- export async function assertBanValidatorSuccessState(
83
- t,
84
- context,
85
- {
86
- validatorPeer = selectWriterPeer(context),
87
- adminPeer = context.adminBootstrap,
88
- validatorEntryBefore,
89
- adminEntryBefore,
90
- payload,
91
- expectedInitialRoles = { isWhitelisted: true, isWriter: true, isIndexer: false },
92
- expectWriterRegistry = null,
93
- skipSync = false
94
- } = {}
95
- ) {
96
- if (!validatorEntryBefore?.value) {
97
- throw new Error('assertBanValidatorSuccessState requires the validator entry before ban.');
98
- }
99
- if (!adminEntryBefore?.value) {
100
- throw new Error('assertBanValidatorSuccessState requires the admin entry before ban.');
101
- }
102
- if (!payload) {
103
- throw new Error('assertBanValidatorSuccessState requires the banValidator payload.');
104
- }
105
-
106
- const decodedBefore = nodeEntryUtils.decode(validatorEntryBefore.value);
107
- t.ok(decodedBefore, 'validator entry before banValidator decodes');
108
- if (!decodedBefore) return;
109
- const expectWriterBefore = expectedInitialRoles?.isWriter !== false;
110
- const expectWhitelistedBefore = expectedInitialRoles?.isWhitelisted !== false;
111
- const expectIndexerBefore = expectedInitialRoles?.isIndexer === true;
112
-
113
- t.is(decodedBefore.isWhitelisted, expectWhitelistedBefore, 'validator whitelist status before banValidator');
114
- t.is(decodedBefore.isWriter, expectWriterBefore, 'validator writer status before banValidator');
115
- t.is(decodedBefore.isIndexer, expectIndexerBefore, 'validator indexer status before banValidator');
116
-
117
- const balanceBefore = toBalance(decodedBefore.balance);
118
- const stakedBefore = toBalance(decodedBefore.stakedBalance);
119
- t.ok(balanceBefore, 'validator balance before banValidator decodes');
120
- t.ok(stakedBefore, 'validator staked balance before banValidator decodes');
121
-
122
- const validatorEntryAfter = await adminPeer.base.view.get(validatorPeer.wallet.address);
123
- t.ok(validatorEntryAfter, 'validator entry exists after banValidator');
124
- const decodedAfter = nodeEntryUtils.decode(validatorEntryAfter?.value);
125
- t.ok(decodedAfter, 'validator entry decodes after banValidator');
126
- if (!decodedAfter || !balanceBefore || !stakedBefore) return;
127
-
128
- t.is(decodedAfter.isWhitelisted, false, 'validator whitelist flag cleared');
129
- t.is(decodedAfter.isWriter, false, 'validator writer flag cleared');
130
- t.is(decodedAfter.isIndexer, false, 'validator indexer flag remains cleared');
131
- t.ok(b4a.equals(decodedAfter.wk, decodedBefore.wk), 'validator writing key preserved');
132
-
133
- const expectedBalance = balanceBefore.add(stakedBefore);
134
- t.ok(expectedBalance, 'validator balance after unstaking computed');
135
- if (expectedBalance) {
136
- t.ok(
137
- b4a.equals(decodedAfter.balance, expectedBalance.value),
138
- 'validator balance includes unstaked amount'
139
- );
140
- }
141
- t.ok(
142
- b4a.equals(decodedAfter.stakedBalance, BALANCE_ZERO.value),
143
- 'validator staked balance cleared after ban'
144
- );
145
-
146
- t.ok(!b4a.equals(decodedAfter.license, ZERO_LICENSE), 'validator license retained after ban');
147
- t.ok(
148
- b4a.equals(decodedAfter.license, decodedBefore.license),
149
- 'validator license unchanged after ban'
150
- );
151
-
152
- const licenseId = lengthEntryUtils.decodeBE(decodedAfter.license);
153
- const licenseIndexEntry = await adminPeer.base.view.get(`${EntryType.LICENSE_INDEX}${licenseId}`);
154
- t.ok(licenseIndexEntry, 'license index entry persists after banValidator');
155
- if (licenseIndexEntry?.value) {
156
- const validatorAddressBuffer = addressUtils.addressToBuffer(validatorPeer.wallet.address, config.addressPrefix);
157
- t.ok(
158
- b4a.equals(licenseIndexEntry.value, validatorAddressBuffer),
159
- 'license index still maps to validator address'
160
- );
161
- }
162
-
163
- const shouldCheckRegistry = expectWriterRegistry ?? expectWriterBefore;
164
- if (shouldCheckRegistry) {
165
- const registryKey = EntryType.WRITER_ADDRESS + decodedBefore.wk.toString('hex');
166
- const registryEntry = await adminPeer.base.view.get(registryKey);
167
- t.ok(registryEntry, 'writer registry entry persists after banValidator');
168
- if (registryEntry?.value) {
169
- const validatorAddressBuffer = addressUtils.addressToBuffer(validatorPeer.wallet.address, config.addressPrefix);
170
- t.ok(
171
- b4a.equals(registryEntry.value, validatorAddressBuffer),
172
- 'writer registry maps writing key to validator address'
173
- );
174
- }
175
- }
176
-
177
- const decodedAdminBefore = nodeEntryUtils.decode(adminEntryBefore.value);
178
- t.ok(decodedAdminBefore, 'admin entry before banValidator decodes');
179
- const adminBalanceBefore = toBalance(decodedAdminBefore?.balance);
180
- t.ok(adminBalanceBefore, 'admin balance before banValidator decodes');
181
- if (decodedAdminBefore && adminBalanceBefore) {
182
- const adminEntryAfter = await adminPeer.base.view.get(adminPeer.wallet.address);
183
- t.ok(adminEntryAfter, 'admin entry exists after banValidator');
184
- const decodedAdminAfter = nodeEntryUtils.decode(adminEntryAfter?.value);
185
- t.ok(decodedAdminAfter, 'admin entry decodes after banValidator');
186
- if (decodedAdminAfter) {
187
- const expectedAdminBalance = adminBalanceBefore.sub(BALANCE_FEE);
188
- t.ok(expectedAdminBalance, 'admin balance after fee computation succeeds');
189
- if (expectedAdminBalance) {
190
- t.ok(
191
- b4a.equals(decodedAdminAfter.balance, expectedAdminBalance.value),
192
- 'admin balance reduced by banValidator fee'
193
- );
194
- }
195
- t.ok(
196
- b4a.equals(decodedAdminAfter.stakedBalance, decodedAdminBefore.stakedBalance),
197
- 'admin staked balance unchanged after banValidator'
198
- );
199
- }
200
- }
201
-
202
- await assertBanValidatorPayloadMetadata(t, adminPeer.base, payload, {
203
- adminAddress: adminPeer.wallet.address,
204
- targetAddress: validatorPeer.wallet.address
205
- });
206
-
207
- if (!skipSync) {
208
- await context.sync();
209
- await assertBannedValidatorReplicated(t, validatorPeer.base, {
210
- address: validatorPeer.wallet.address,
211
- writingKey: decodedBefore.wk,
212
- expectedBalance: expectedBalance?.value,
213
- expectedLicense: decodedBefore.license
214
- });
215
- }
216
- }
217
-
218
- export async function assertBanValidatorFailureState(
219
- t,
220
- context,
221
- {
222
- validatorPeer = selectWriterPeer(context),
223
- adminPeer = context.adminBootstrap,
224
- validatorEntryBefore = null,
225
- adminEntryBefore = null,
226
- expectedRoles = null,
227
- allowEntryMutation = false,
228
- skipSync = false
229
- } = {}
230
- ) {
231
- const validatorSnapshot = validatorEntryBefore ?? context.banValidatorScenario?.validatorEntryBefore ?? null;
232
- const adminSnapshot = adminEntryBefore ?? context.banValidatorScenario?.adminEntryBefore ?? null;
233
-
234
- const entry = await adminPeer.base.view.get(validatorPeer.wallet.address);
235
- t.ok(entry, 'validator entry persists after failed banValidator');
236
- const decoded = nodeEntryUtils.decode(entry?.value);
237
- t.ok(decoded, 'validator entry decodes after failed banValidator');
238
- if (decoded) {
239
- let expectedWhitelisted = expectedRoles?.isWhitelisted ?? true;
240
- let expectedWriter = expectedRoles?.isWriter ?? true;
241
- let expectedIndexer = expectedRoles?.isIndexer ?? false;
242
-
243
- if (validatorSnapshot?.value) {
244
- const decodedBefore = nodeEntryUtils.decode(validatorSnapshot.value);
245
- if (decodedBefore) {
246
- expectedWhitelisted =
247
- expectedRoles?.isWhitelisted !== undefined
248
- ? expectedRoles.isWhitelisted
249
- : decodedBefore.isWhitelisted;
250
- expectedWriter =
251
- expectedRoles?.isWriter !== undefined ? expectedRoles.isWriter : decodedBefore.isWriter;
252
- expectedIndexer =
253
- expectedRoles?.isIndexer !== undefined ? expectedRoles.isIndexer : decodedBefore.isIndexer;
254
- }
255
- }
256
-
257
- t.is(decoded.isWhitelisted, expectedWhitelisted, 'validator remains whitelisted after failure');
258
- t.is(decoded.isWriter, expectedWriter, 'validator retains writer role after failure');
259
- t.is(decoded.isIndexer, expectedIndexer, 'validator not promoted to indexer after failure');
260
- }
261
- if (validatorSnapshot?.value && !allowEntryMutation) {
262
- t.ok(
263
- b4a.equals(entry?.value, validatorSnapshot.value),
264
- 'validator entry remains unchanged after failure'
265
- );
266
- }
267
-
268
- if (adminSnapshot?.value && !allowEntryMutation) {
269
- const adminEntryAfter = await adminPeer.base.view.get(adminPeer.wallet.address);
270
- if (adminEntryAfter?.value) {
271
- t.ok(
272
- b4a.equals(adminEntryAfter.value, adminSnapshot.value),
273
- 'admin entry remains unchanged after failure'
274
- );
275
- }
276
- }
277
-
278
- if (!skipSync) {
279
- await context.sync();
280
- const peerEntry = await validatorPeer.base.view.get(validatorPeer.wallet.address);
281
- t.ok(peerEntry, 'validator entry replicated after failed banValidator');
282
- if (validatorEntryBefore?.value && peerEntry?.value) {
283
- t.ok(
284
- b4a.equals(peerEntry.value, validatorEntryBefore.value),
285
- 'validator peer sees unchanged entry after failure'
286
- );
287
- }
288
- }
289
- }
290
-
291
- export async function applyWithTargetNodeEntryRemoval(context, invalidPayload, { peer = null } = {}) {
292
- const targetPeer = peer ?? context.banValidatorScenario?.validatorPeer ?? selectWriterPeer(context);
293
- await applyWithRequesterEntryRemoval(context, invalidPayload, { peer: targetPeer });
294
- }
295
-
296
- export async function applyInvalidTargetAddressPayload(context, validPayload) {
297
- const adminPeer = context.adminBootstrap;
298
- const decoded = safeDecodeApplyOperation(validPayload);
299
- if (!decoded?.aco) return;
300
-
301
- const invalidAddress = b4a.from(decoded.aco.ia); // preserve length
302
- invalidAddress[0] ^= 0xff; // corrupt address buffer without changing shape
303
- decoded.aco.ia = invalidAddress;
304
-
305
- const message = createMessage(
306
- config.networkId,
307
- decoded.aco.txv,
308
- decoded.aco.ia,
309
- decoded.aco.in,
310
- OperationType.BAN_VALIDATOR
311
- );
312
- const newHash = await PeerWallet.blake3(message);
313
- decoded.aco.tx = newHash;
314
- decoded.aco.is = adminPeer.wallet.sign(newHash);
315
-
316
- const invalidPayload = safeEncodeApplyOperation(decoded);
317
- await adminPeer.base.append(invalidPayload);
318
- await adminPeer.base.update();
319
- await eventFlush();
320
- }
321
-
322
- export async function applyInvalidIndexerSequenceStatePayload(context, validPayload) {
323
- const adminPeer = context.adminBootstrap;
324
- const base = adminPeer.base;
325
- const originalIndexers = base.system?.indexers;
326
-
327
- base.system.indexers = null;
328
- try {
329
- await adminPeer.base.append(validPayload);
330
- await adminPeer.base.update();
331
- await eventFlush();
332
- } finally {
333
- base.system.indexers = originalIndexers;
334
- }
335
- }
336
-
337
- export async function promoteValidatorToIndexer(
338
- context,
339
- { adminPeer = context.adminBootstrap, validatorPeer = selectWriterPeer(context) } = {}
340
- ) {
341
- const txValidity = await deriveIndexerSequenceState(adminPeer.base);
342
- const payload = safeEncodeApplyOperation(
343
- await applyStateMessageFactory(adminPeer.wallet, config)
344
- .buildCompleteAddIndexerMessage(adminPeer.wallet.address, validatorPeer.wallet.address, txValidity)
345
- );
346
-
347
- await adminPeer.base.append(payload);
348
- await adminPeer.base.update();
349
- await eventFlush();
350
-
351
- const updatedEntry = await adminPeer.base.view.get(validatorPeer.wallet.address);
352
- if (updatedEntry?.value) {
353
- context.banValidatorScenario = {
354
- ...(context.banValidatorScenario ?? {}),
355
- validatorEntryBefore: { ...updatedEntry, value: b4a.from(updatedEntry.value) }
356
- };
357
- }
358
-
359
- const adminEntry = await adminPeer.base.view.get(adminPeer.wallet.address);
360
- if (adminEntry?.value) {
361
- context.banValidatorScenario = {
362
- ...(context.banValidatorScenario ?? {}),
363
- adminEntryBefore: { ...adminEntry, value: b4a.from(adminEntry.value) }
364
- };
365
- }
366
-
367
- return payload;
368
- }
369
-
370
- export async function applyWithBanValidatorRoleUpdateFailure(context, invalidPayload) {
371
- const node = context.adminBootstrap ?? context.bootstrap ?? context.peers?.[0] ?? null;
372
- if (!node?.base) {
373
- throw new Error('Ban validator role update failure scenario requires a writable node.');
374
- }
375
-
376
- const originalSetRole = nodeEntryUtils.setRole;
377
- let shouldFailNextCall = true;
378
-
379
- nodeEntryUtils.setRole = function patchedSetRole(...args) {
380
- if (shouldFailNextCall) {
381
- shouldFailNextCall = false;
382
- return null;
383
- }
384
- return originalSetRole.apply(this, args);
385
- };
386
-
387
- try {
388
- await node.base.append(invalidPayload);
389
- await node.base.update();
390
- await eventFlush();
391
- } finally {
392
- nodeEntryUtils.setRole = originalSetRole;
393
- }
394
- }
395
-
396
- export async function applyWithBanValidatorRoleDecodeFailure(context, invalidPayload) {
397
- const node = context.adminBootstrap ?? context.bootstrap ?? context.peers?.[0] ?? null;
398
- if (!node?.base) {
399
- throw new Error('Ban validator role decode failure scenario requires a writable node.');
400
- }
401
-
402
- const originalSetRole = nodeEntryUtils.setRole;
403
- nodeEntryUtils.setRole = function patchedSetRole(...args) {
404
- // return an intentionally undecodable buffer to hit the decode guard
405
- return b4a.alloc(1);
406
- };
407
-
408
- try {
409
- await node.base.append(invalidPayload);
410
- await node.base.update();
411
- await eventFlush();
412
- } finally {
413
- nodeEntryUtils.setRole = originalSetRole;
414
- }
415
- }
416
-
417
- export async function applyWithBanValidatorWithdrawFailure(context, invalidPayload) {
418
- const targetPeer = context.banValidatorScenario?.validatorPeer ?? selectWriterPeer(context);
419
- const targetAddress = targetPeer.wallet.address;
420
- const targetBuffer = addressUtils.addressToBuffer(targetAddress, config.addressPrefix);
421
- const adminPeer = context.adminBootstrap;
422
- const base = adminPeer.base;
423
- const originalApply = base._handlers.apply;
424
-
425
- base._handlers.apply = async function patchedApply(nodes, view, baseCtx) {
426
- const originalBatch = view.batch;
427
- view.batch = function patchedBatch(...args) {
428
- const batch = originalBatch.apply(this, args);
429
- if (!batch?.get) return batch;
430
-
431
- const originalGet = batch.get.bind(batch);
432
- batch.get = async key => {
433
- const entry = await originalGet(key);
434
- if (!entry || !entry.value) return entry;
435
- if (isTargetKey(key, targetAddress, targetBuffer)) {
436
- const mutatedValue = nodeEntryUtils.setStakedBalance(
437
- b4a.from(entry.value),
438
- BALANCE_ZERO.value
439
- );
440
- if (mutatedValue) {
441
- return { ...entry, value: mutatedValue };
442
- }
443
- }
444
- return entry;
445
- };
446
-
447
- return batch;
448
- };
449
-
450
- try {
451
- return await originalApply.call(this, nodes, view, baseCtx);
452
- } finally {
453
- view.batch = originalBatch;
454
- }
455
- };
456
-
457
- try {
458
- await adminPeer.base.append(invalidPayload);
459
- await adminPeer.base.update();
460
- await eventFlush();
461
- } finally {
462
- base._handlers.apply = originalApply;
463
- }
464
- }
465
-
466
- function isTargetKey(key, targetAddressString, targetAddressBuffer) {
467
- if (typeof key === 'string') {
468
- return key === targetAddressString;
469
- }
470
- if (b4a.isBuffer(key) && targetAddressBuffer) {
471
- return b4a.equals(key, targetAddressBuffer);
472
- }
473
- return false;
474
- }
475
-
476
- async function assertBanValidatorPayloadMetadata(t, base, payload, { adminAddress, targetAddress }) {
477
- const decodedPayload = safeDecodeApplyOperation(payload);
478
- t.ok(decodedPayload, 'banValidator payload decodes');
479
- if (!decodedPayload) return;
480
-
481
- const requesterAddress = addressUtils.bufferToAddress(decodedPayload.address, config.addressPrefix);
482
- t.ok(requesterAddress, 'banValidator requester address decodes');
483
- if (requesterAddress) {
484
- t.is(requesterAddress, adminAddress, 'banValidator payload signed by admin');
485
- }
486
-
487
- const targetAddressDecoded = addressUtils.bufferToAddress(decodedPayload?.aco?.ia, config.addressPrefix);
488
- t.ok(targetAddressDecoded, 'banValidator target address decodes');
489
- if (targetAddressDecoded) {
490
- t.is(targetAddressDecoded, targetAddress, 'banValidator payload targets expected validator');
491
- }
492
-
493
- const txHashBuffer = decodedPayload?.aco?.tx;
494
- t.ok(txHashBuffer, 'banValidator tx hash extracted');
495
- if (txHashBuffer) {
496
- const txEntry = await base.view.get(txHashBuffer.toString('hex'));
497
- t.ok(txEntry, 'banValidator transaction recorded for replay protection');
498
- }
499
- }
500
-
501
- async function assertBannedValidatorReplicated(
502
- t,
503
- base,
504
- { address, writingKey, expectedBalance, expectedLicense }
505
- ) {
506
- const entry = await base.view.get(address);
507
- t.ok(entry, 'validator entry replicated to peer after banValidator');
508
- const decoded = nodeEntryUtils.decode(entry?.value);
509
- t.ok(decoded, 'replicated validator entry decodes');
510
- if (!decoded) return;
511
- t.is(decoded.isWhitelisted, false, 'replicated entry not whitelisted');
512
- t.is(decoded.isWriter, false, 'replicated entry writer flag cleared');
513
- t.is(decoded.isIndexer, false, 'replicated entry indexer flag cleared');
514
- t.ok(b4a.equals(decoded.wk, writingKey), 'replicated entry preserves writing key');
515
- t.ok(
516
- b4a.equals(decoded.stakedBalance, BALANCE_ZERO.value),
517
- 'replicated entry staked balance cleared'
518
- );
519
- if (expectedBalance) {
520
- t.ok(
521
- b4a.equals(decoded.balance, expectedBalance),
522
- 'replicated entry balance matches expected amount'
523
- );
524
- }
525
- if (expectedLicense) {
526
- t.ok(
527
- b4a.equals(decoded.license, expectedLicense),
528
- 'replicated entry license preserved'
529
- );
530
- }
531
- }
@@ -1,74 +0,0 @@
1
- import { test } from 'brittle';
2
- import { eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
3
- import {
4
- selectWriterPeer,
5
- promotePeerToWriter,
6
- defaultWriterFunding
7
- } from '../addWriter/addWriterScenarioHelpers.js';
8
- import {
9
- setupBanValidatorScenario,
10
- buildBanValidatorPayload,
11
- assertBanValidatorSuccessState
12
- } from './banValidatorScenarioHelpers.js';
13
- import { initializeBalances, whitelistAddress } from '../common/commonScenarioHelper.js';
14
-
15
- export default function banValidatorSequentialBansScenario() {
16
- test('State.apply banValidator processes two sequential bans', async t => {
17
- const context = await setupBanValidatorScenario(t, { nodes: 3 });
18
- const adminPeer = context.adminBootstrap;
19
-
20
- const firstValidator = context.banValidatorScenario?.validatorPeer ?? selectWriterPeer(context);
21
-
22
- const secondValidator =
23
- context.peers.find(
24
- p =>
25
- p.wallet.address !== adminPeer.wallet.address &&
26
- p.wallet.address !== firstValidator.wallet.address
27
- ) ?? null;
28
- t.ok(secondValidator, 'second validator peer available');
29
- if (!secondValidator) return;
30
-
31
- const funding = context.addWriterScenario?.writerInitialBalance ?? defaultWriterFunding;
32
- await initializeBalances(context, [[secondValidator.wallet.address, funding]]);
33
- await whitelistAddress(context, secondValidator.wallet.address);
34
- await promotePeerToWriter(t, context, { readerPeer: secondValidator, expectedWriterIndex: 2 });
35
-
36
- const firstEntryBefore = await adminPeer.base.view.get(firstValidator.wallet.address);
37
- const adminEntryBeforeFirst = await adminPeer.base.view.get(adminPeer.wallet.address);
38
- const payload1 = await buildBanValidatorPayload(context, {
39
- adminPeer,
40
- validatorPeer: firstValidator
41
- });
42
-
43
- await adminPeer.base.append(payload1);
44
- await adminPeer.base.update();
45
- await eventFlush();
46
-
47
- await assertBanValidatorSuccessState(t, context, {
48
- validatorPeer: firstValidator,
49
- adminPeer,
50
- validatorEntryBefore: firstEntryBefore,
51
- adminEntryBefore: adminEntryBeforeFirst,
52
- payload: payload1
53
- });
54
-
55
- const secondEntryBefore = await adminPeer.base.view.get(secondValidator.wallet.address);
56
- const adminEntryBeforeSecond = await adminPeer.base.view.get(adminPeer.wallet.address);
57
- const payload2 = await buildBanValidatorPayload(context, {
58
- adminPeer,
59
- validatorPeer: secondValidator
60
- });
61
-
62
- await adminPeer.base.append(payload2);
63
- await adminPeer.base.update();
64
- await eventFlush();
65
-
66
- await assertBanValidatorSuccessState(t, context, {
67
- validatorPeer: secondValidator,
68
- adminPeer,
69
- validatorEntryBefore: secondEntryBefore,
70
- adminEntryBefore: adminEntryBeforeSecond,
71
- payload: payload2
72
- });
73
- });
74
- }
@@ -1,19 +0,0 @@
1
- import OperationValidationScenarioBase from '../common/base/OperationValidationScenarioBase.js';
2
- import {
3
- setupBanValidatorScenario,
4
- buildBanValidatorPayload,
5
- assertBanValidatorFailureState,
6
- applyWithBanValidatorRoleDecodeFailure
7
- } from './banValidatorScenarioHelpers.js';
8
-
9
- export default function banValidatorTargetDecodeFailureScenario() {
10
- new OperationValidationScenarioBase({
11
- title: 'State.apply banValidator rejects payloads when target node entry cannot be decoded after role update',
12
- setupScenario: setupBanValidatorScenario,
13
- buildValidPayload: context => buildBanValidatorPayload(context),
14
- mutatePayload: (_t, payload) => payload,
15
- applyInvalidPayload: applyWithBanValidatorRoleDecodeFailure,
16
- assertStateUnchanged: (t, context) => assertBanValidatorFailureState(t, context, { skipSync: true }),
17
- expectedLogs: ['Failed to decode target node entry.']
18
- }).performScenario();
19
- }
@@ -1,32 +0,0 @@
1
- import OperationValidationScenarioBase from '../common/base/OperationValidationScenarioBase.js';
2
- import {
3
- setupBanValidatorScenario,
4
- buildBanValidatorPayload,
5
- assertBanValidatorFailureState,
6
- promoteValidatorToIndexer
7
- } from './banValidatorScenarioHelpers.js';
8
- import { eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
9
-
10
- export default function banValidatorTargetIndexerScenario() {
11
- new OperationValidationScenarioBase({
12
- title: 'State.apply banValidator rejects payloads when target node is an indexer',
13
- setupScenario: async t => {
14
- const context = await setupBanValidatorScenario(t);
15
- await promoteValidatorToIndexer(context);
16
- return context;
17
- },
18
- buildValidPayload: context => buildBanValidatorPayload(context),
19
- mutatePayload: (_t, payload) => payload,
20
- applyInvalidPayload: async (context, payload) => {
21
- await context.adminBootstrap.base.append(payload);
22
- await context.adminBootstrap.base.update();
23
- await eventFlush();
24
- },
25
- assertStateUnchanged: (t, context) =>
26
- assertBanValidatorFailureState(t, context, {
27
- expectedRoles: { isWhitelisted: true, isWriter: true, isIndexer: true },
28
- skipSync: true
29
- }),
30
- expectedLogs: ['Only writer/whitelisted node can be banned.']
31
- }).performScenario();
32
- }