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,42 +0,0 @@
1
- import { test } from 'brittle';
2
- import {
3
- eventFlush,
4
- deriveIndexerSequenceState
5
- } from '../../../../helpers/autobaseTestHelpers.js';
6
- import nodeEntryUtils from '../../../../../src/core/state/utils/nodeEntry.js';
7
- import { toTerm } from '../../../../../src/core/state/utils/balance.js';
8
- import { applyStateMessageFactory } from '../../../../../src/messages/state/applyStateMessageFactory.js';
9
- import { safeEncodeApplyOperation } from '../../../../../src/utils/protobuf/operationHelpers.js';
10
- import { setupAddAdminScenario, assertAdminState } from './addAdminScenarioHelpers.js';
11
- import { config } from '../../../../helpers/config.js';
12
-
13
- export default function addAdminHappyPathScenario() {
14
- test('State.apply addAdmin bootstraps admin node - happy path', async t => {
15
- const networkContext = await setupAddAdminScenario(t);
16
- const adminNode = networkContext.adminBootstrap;
17
- const readerNodes = networkContext.peers.slice(1);
18
- const reader = readerNodes[0];
19
-
20
- const txValidity = await deriveIndexerSequenceState(adminNode.base);
21
- const addAdminPayload = safeEncodeApplyOperation(
22
- await applyStateMessageFactory(adminNode.wallet, config)
23
- .buildCompleteAddAdminMessage(
24
- adminNode.wallet.address,
25
- adminNode.base.local.key,
26
- txValidity
27
- )
28
- );
29
-
30
- await adminNode.base.append(addAdminPayload);
31
- await adminNode.base.update();
32
- await eventFlush();
33
-
34
- await assertAdminState(t, adminNode.base, adminNode.wallet, adminNode.base.local.key, addAdminPayload);
35
-
36
- await networkContext.sync();
37
- await assertAdminState(t, reader.base, adminNode.wallet, adminNode.base.local.key, addAdminPayload);
38
-
39
- const readerNodeEntry = await reader.base.view.get(reader.wallet.address);
40
- t.is(readerNodeEntry, null, 'reader node remains without any role');
41
- });
42
- }
@@ -1,276 +0,0 @@
1
- import b4a from 'b4a';
2
- import { setupStateNetwork } from '../../../../helpers/StateNetworkFactory.js';
3
- import {
4
- seedBootstrapIndexer,
5
- defaultOpenHyperbeeView,
6
- deriveIndexerSequenceState,
7
- eventFlush
8
- } from '../../../../helpers/autobaseTestHelpers.js';
9
- import { applyStateMessageFactory } from '../../../../../src/messages/state/applyStateMessageFactory.js';
10
- import {
11
- safeDecodeApplyOperation,
12
- safeEncodeApplyOperation
13
- } from '../../../../../src/utils/protobuf/operationHelpers.js';
14
- import {
15
- AUTOBASE_VALUE_ENCODING,
16
- EntryType,
17
- ADMIN_INITIAL_BALANCE,
18
- ADMIN_INITIAL_STAKED_BALANCE
19
- } from '../../../../../src/utils/constants.js';
20
- import adminEntryUtils from '../../../../../src/core/state/utils/adminEntry.js';
21
- import nodeEntryUtils from '../../../../../src/core/state/utils/nodeEntry.js';
22
- import lengthEntryUtils from '../../../../../src/core/state/utils/lengthEntry.js';
23
- import addressUtils from '../../../../../src/core/state/utils/address.js';
24
- import { safeWriteUInt32BE } from '../../../../../src/utils/buffer.js';
25
- import { config } from '../../../../helpers/config.js';
26
-
27
- export async function setupAddAdminScenario(t) {
28
- const context = await setupStateNetwork({
29
- nodes: 2,
30
- valueEncoding: AUTOBASE_VALUE_ENCODING,
31
- open: defaultOpenHyperbeeView
32
- });
33
-
34
- seedBootstrapIndexer(context);
35
-
36
- t.teardown(async () => {
37
- await context.teardown();
38
- });
39
- return context;
40
- }
41
-
42
- export async function buildAddAdminRequesterPayload(context) {
43
- const adminNode = context.adminBootstrap;
44
- const txValidity = await deriveIndexerSequenceState(adminNode.base);
45
- return safeEncodeApplyOperation(
46
- await applyStateMessageFactory(adminNode.wallet, config)
47
- .buildCompleteAddAdminMessage(
48
- adminNode.wallet.address,
49
- adminNode.base.local.key,
50
- txValidity
51
- )
52
- );
53
- }
54
-
55
- export async function assertAddAdminRequesterFailureState(t, context) {
56
- const adminNode = context.adminBootstrap;
57
- const readerNodes = context.peers.slice(1);
58
-
59
- const adminEntryRecord = await adminNode.base.view.get(EntryType.ADMIN);
60
- t.is(adminEntryRecord, null, 'admin entry remains absent');
61
-
62
- const initializationEntry = await adminNode.base.view.get(EntryType.INITIALIZATION);
63
- t.is(initializationEntry, null, 'initialization flag not set');
64
-
65
- const writerRegistry = await adminNode.base.view.get(
66
- EntryType.WRITER_ADDRESS + adminNode.base.local.key.toString('hex')
67
- );
68
- t.is(writerRegistry, null, 'writer registry not created');
69
-
70
- await context.sync();
71
- for (const reader of readerNodes) {
72
- const readerAdminEntry = await reader.base.view.get(EntryType.ADMIN);
73
- t.is(readerAdminEntry, null, 'reader node never observes admin entry');
74
- }
75
- }
76
-
77
- export async function assertAddAdminRequesterFailureStateLocal(t, context) {
78
- const adminNode = context.adminBootstrap;
79
-
80
- const adminEntryRecord = await adminNode.base.view.get(EntryType.ADMIN);
81
- t.is(adminEntryRecord, null, 'admin entry remains absent');
82
-
83
- const initializationEntry = await adminNode.base.view.get(EntryType.INITIALIZATION);
84
- t.is(initializationEntry, null, 'initialization flag not set');
85
-
86
- const writerRegistry = await adminNode.base.view.get(
87
- EntryType.WRITER_ADDRESS + adminNode.base.local.key.toString('hex')
88
- );
89
- t.is(writerRegistry, null, 'writer registry not created');
90
-
91
- for (const reader of context.peers.slice(1)) {
92
- const readerAdminEntry = await reader.base.view.get(EntryType.ADMIN);
93
- t.is(readerAdminEntry, null, 'reader node never observes admin entry');
94
- }
95
- }
96
-
97
- export function mutateAddAdminPayloadForInvalidSchema(t, validPayload) {
98
- const decodedPayload = safeDecodeApplyOperation(validPayload);
99
- t.ok(decodedPayload, 'fixtures decode');
100
-
101
- decodedPayload.cao.tx = b4a.alloc(decodedPayload.cao.tx.length);
102
- return safeEncodeApplyOperation(decodedPayload);
103
- }
104
-
105
- export async function assertAdminState(t, base, wallet, writingKey, payload) {
106
- const adminEntryRecord = await base.view.get(EntryType.ADMIN);
107
- t.ok(adminEntryRecord, 'admin entry should exist');
108
-
109
- const decodedAdminEntry = adminEntryUtils.decode(adminEntryRecord.value, config.addressPrefix);
110
- t.ok(decodedAdminEntry, 'admin entry decodes');
111
- t.is(decodedAdminEntry.address, wallet.address, 'admin entry stores wallet address');
112
- t.ok(b4a.equals(decodedAdminEntry.wk, writingKey), 'admin entry stores writing key');
113
-
114
- const nodeEntryRecord = await base.view.get(wallet.address);
115
- t.ok(nodeEntryRecord, 'node entry should exist for admin address');
116
-
117
- const nodeEntry = nodeEntryUtils.decode(nodeEntryRecord.value);
118
- t.ok(nodeEntry, 'node entry decodes');
119
- t.is(nodeEntry.isWriter, true, 'node entry flagged as writer');
120
- t.is(nodeEntry.isIndexer, true, 'node entry flagged as indexer');
121
- t.ok(b4a.equals(nodeEntry?.wk, writingKey), 'node entry writing key matches');
122
- t.ok(b4a.equals(nodeEntry?.balance, ADMIN_INITIAL_BALANCE), 'admin initial balance is set');
123
- t.ok(
124
- b4a.equals(nodeEntry?.stakedBalance, ADMIN_INITIAL_STAKED_BALANCE),
125
- 'admin initial staked balance is set'
126
- );
127
- t.ok(
128
- b4a.equals(nodeEntry?.license, lengthEntryUtils.encodeBE(1)),
129
- 'admin license id assigned'
130
- );
131
-
132
- const adminAddressBuffer = addressUtils.addressToBuffer(wallet.address, config.addressPrefix);
133
- t.ok(adminAddressBuffer.length > 0, 'admin address encoded as buffer');
134
- const writerRegistry = await base.view.get(EntryType.WRITER_ADDRESS + writingKey.toString('hex'));
135
- t.ok(writerRegistry, 'writer registry entry exists');
136
- t.ok(
137
- b4a.equals(writerRegistry.value, adminAddressBuffer),
138
- 'writer registry links writing key to admin'
139
- );
140
-
141
- const writersLengthEntry = await base.view.get(EntryType.WRITERS_LENGTH);
142
- t.ok(writersLengthEntry, 'writers length entry exists');
143
- const writersLength = lengthEntryUtils.decodeBE(writersLengthEntry.value);
144
- t.is(writersLength, 1, 'writers length increments to 1');
145
-
146
- const writerIndexEntry = await base.view.get(`${EntryType.WRITERS_INDEX}0`);
147
- t.ok(writerIndexEntry, 'writer index entry exists');
148
- t.is(
149
- writerIndexEntry.value.toString('ascii'),
150
- adminAddressBuffer.toString('ascii'),
151
- 'writer index 0 stores admin address'
152
- );
153
-
154
- const licenseCountEntry = await base.view.get(EntryType.LICENSE_COUNT);
155
- t.ok(licenseCountEntry, 'license count entry exists');
156
- const licenseCount = lengthEntryUtils.decodeBE(licenseCountEntry.value);
157
- t.is(licenseCount, 1, 'license count increments to 1');
158
-
159
- const licenseIndexEntry = await base.view.get(`${EntryType.LICENSE_INDEX}1`);
160
- t.ok(licenseIndexEntry, 'license index entry exists');
161
- t.is(
162
- licenseIndexEntry.value.toString('ascii'),
163
- adminAddressBuffer.toString('ascii'),
164
- 'license index 1 stores admin address'
165
- );
166
-
167
- const initializationEntry = await base.view.get(EntryType.INITIALIZATION);
168
- t.ok(initializationEntry, 'initialization entry exists');
169
- t.ok(
170
- b4a.equals(initializationEntry.value, safeWriteUInt32BE(1, 0)),
171
- 'initialization flag set to 1'
172
- );
173
-
174
- const decodedOperation = safeDecodeApplyOperation(payload);
175
- t.ok(decodedOperation?.cao?.tx, 'operation decodes');
176
- const txKey = decodedOperation.cao.tx.toString('hex');
177
- const txEntry = await base.view.get(txKey);
178
- t.ok(txEntry, 'operation hash stored to prevent replays');
179
- }
180
-
181
- export async function assertAdminStatePersists(t, context, payload) {
182
- const adminNode = context.adminBootstrap;
183
- const reader = context.peers[1];
184
-
185
- await assertAdminState(t, adminNode.base, adminNode.wallet, adminNode.base.local.key, payload);
186
-
187
- await eventFlush();
188
- await context.sync();
189
-
190
- await assertAdminState(t, reader.base, adminNode.wallet, adminNode.base.local.key, payload);
191
- }
192
-
193
- export function bypassAddAdminReplayGuardsOnce(context) {
194
- const adminNode = context.adminBootstrap;
195
- if (!adminNode?.base) {
196
- throw new Error('AddAdmin replay guard bypass requires an admin bootstrap node.');
197
- }
198
-
199
- const writerRegistryKey = EntryType.WRITER_ADDRESS + adminNode.base.local.key.toString('hex');
200
- const keysToBypass = new Set([writerRegistryKey, EntryType.ADMIN]);
201
-
202
- return patchViewGetOnce(adminNode.base, keysToBypass);
203
- }
204
-
205
- export function bypassBalanceInitializationAdminConsistencyOnce(context) {
206
- const adminNode = context.adminBootstrap;
207
- if (!adminNode?.base) {
208
- throw new Error('Admin consistency bypass requires an admin bootstrap node.');
209
- }
210
-
211
- const keysToBypass = new Set([EntryType.ADMIN]);
212
-
213
- return patchViewGetOnce(adminNode.base, keysToBypass, {
214
- mutateAdminEntry: async entryPromise => {
215
- const entry = await entryPromise;
216
- if (!entry?.value) return entry;
217
- const mutated = b4a.from(entry.value);
218
- mutated[mutated.length - 1] ^= 0xff;
219
- return { ...entry, value: mutated };
220
- }
221
- });
222
- }
223
-
224
- function patchViewGetOnce(base, keysToBypass, { mutateAdminEntry } = {}) {
225
- const originalApply = base._handlers.apply;
226
- let shouldPatchNextApply = true;
227
-
228
- base._handlers.apply = async (nodes, view, baseCtx) => {
229
- if (!shouldPatchNextApply) {
230
- return originalApply(nodes, view, baseCtx);
231
- }
232
-
233
- shouldPatchNextApply = false;
234
- const previousBatch = view.batch;
235
- const boundBatch = previousBatch.bind(view);
236
-
237
- view.batch = function patchedBatch(...args) {
238
- const batch = boundBatch(...args);
239
- const originalGet = batch.get?.bind(batch);
240
- if (typeof originalGet === 'function') {
241
- batch.get = async key => {
242
- const identifier = resolveKeyIdentifier(key);
243
- if (keysToBypass.has(identifier)) {
244
- if (identifier === EntryType.ADMIN && typeof mutateAdminEntry === 'function') {
245
- return mutateAdminEntry(originalGet(key));
246
- }
247
- return null;
248
- }
249
- return originalGet(key);
250
- };
251
- }
252
- return batch;
253
- };
254
-
255
- try {
256
- return await originalApply(nodes, view, baseCtx);
257
- } finally {
258
- view.batch = previousBatch;
259
- base._handlers.apply = originalApply;
260
- }
261
- };
262
-
263
- return () => {
264
- base._handlers.apply = originalApply;
265
- };
266
- }
267
-
268
- function resolveKeyIdentifier(key) {
269
- if (typeof key === 'string') {
270
- return key;
271
- }
272
- if (b4a.isBuffer(key)) {
273
- return key.toString('utf8');
274
- }
275
- return `${key}`;
276
- }
@@ -1,30 +0,0 @@
1
- import { test } from 'brittle';
2
- import b4a from 'b4a';
3
- import { eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
4
- import {
5
- setupAddAdminScenario,
6
- buildAddAdminRequesterPayload,
7
- assertAddAdminRequesterFailureStateLocal
8
- } from './addAdminScenarioHelpers.js';
9
- import adminEntryUtils from '../../../../../src/core/state/utils/adminEntry.js';
10
-
11
- export default function addAdminEntryEncodingFailureScenario() {
12
- test('State.apply addAdmin aborts when admin entry encoding fails', async t => {
13
- const context = await setupAddAdminScenario(t);
14
- const adminNode = context.adminBootstrap;
15
- const payload = await buildAddAdminRequesterPayload(context);
16
-
17
- const originalEncode = adminEntryUtils.encode;
18
- adminEntryUtils.encode = () => b4a.alloc(0);
19
-
20
- t.teardown(() => {
21
- adminEntryUtils.encode = originalEncode;
22
- });
23
-
24
- await adminNode.base.append(payload);
25
- await adminNode.base.update();
26
- await eventFlush();
27
-
28
- await assertAddAdminRequesterFailureStateLocal(t, context);
29
- });
30
- }
@@ -1,78 +0,0 @@
1
- import { test } from 'brittle';
2
- import { eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
3
- import { EntryType } from '../../../../../src/utils/constants.js';
4
-
5
- import {
6
- setupAddAdminScenario,
7
- buildAddAdminRequesterPayload,
8
- assertAdminStatePersists
9
- } from './addAdminScenarioHelpers.js';
10
-
11
- /**
12
- * This test simulates the bootstrap resubmitting a valid ADD_ADMIN operation after the admin
13
- * was already created.
14
- *
15
- * In the real handler the `adminEntryExists` guard blocks that attempt, but earlier validation
16
- * (`writer key already exists`) fires first. To reach the admin-entry branch we temporarily patch
17
- * the Hyperbee view used by State.apply and return `null` only for the `EntryType.WRITER_ADDRESS + iw`
18
- * lookup. That allows the writer-key check to pass and execution continues until the admin-entry check.
19
- *
20
- * After the duplicate operation is rejected, `assertAdminStatePersists` confirms that the admin entry
21
- * and all related registries remain unchanged on both the bootstrap and the reader node.
22
- */
23
- export default function addAdminEntryExistsScenario() {
24
- test('State.apply addAdmin rejects attempts when admin already exists', async t => {
25
- const networkContext = await setupAddAdminScenario(t);
26
- const adminNode = networkContext.adminBootstrap;
27
-
28
- const initialPayload = await buildAddAdminRequesterPayload(networkContext);
29
- await adminNode.base.append(initialPayload);
30
- await adminNode.base.update();
31
- await eventFlush();
32
-
33
- const writerRegistryKey = EntryType.WRITER_ADDRESS + adminNode.base.local.key.toString('hex');
34
- const originalApplyHandler = adminNode.base._handlers.apply;
35
- let shouldPatchNextApply = true;
36
-
37
- adminNode.base._handlers.apply = async (nodes, view, baseCtx) => {
38
- if (!shouldPatchNextApply) {
39
- return originalApplyHandler(nodes, view, baseCtx);
40
- }
41
-
42
- shouldPatchNextApply = false;
43
- const previousBatch = view.batch;
44
- const boundBatch = previousBatch.bind(view);
45
-
46
- view.batch = function patchedBatch(...args) {
47
- const batch = boundBatch(...args);
48
- const originalGet = batch.get?.bind(batch);
49
- if (typeof originalGet === 'function') {
50
- batch.get = async key => {
51
- if (key === writerRegistryKey) {
52
- return null;
53
- }
54
- return originalGet(key);
55
- };
56
- }
57
- return batch;
58
- };
59
-
60
- try {
61
- return await originalApplyHandler(nodes, view, baseCtx);
62
- } finally {
63
- view.batch = previousBatch;
64
- }
65
- };
66
-
67
- t.teardown(() => {
68
- adminNode.base._handlers.apply = originalApplyHandler;
69
- });
70
-
71
- const duplicatePayload = await buildAddAdminRequesterPayload(networkContext);
72
- await adminNode.base.append(duplicatePayload);
73
- await adminNode.base.update();
74
- await eventFlush();
75
-
76
- await assertAdminStatePersists(t, networkContext, initialPayload);
77
- });
78
- }
@@ -1,30 +0,0 @@
1
- import { test } from 'brittle';
2
- import b4a from 'b4a';
3
- import { eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
4
- import {
5
- setupAddAdminScenario,
6
- buildAddAdminRequesterPayload,
7
- assertAddAdminRequesterFailureStateLocal
8
- } from './addAdminScenarioHelpers.js';
9
- import nodeEntryUtils from '../../../../../src/core/state/utils/nodeEntry.js';
10
-
11
- export default function addAdminNodeEntryInitializationFailureScenario() {
12
- test('State.apply addAdmin aborts when node entry initialization fails', async t => {
13
- const context = await setupAddAdminScenario(t);
14
- const adminNode = context.adminBootstrap;
15
- const payload = await buildAddAdminRequesterPayload(context);
16
-
17
- const originalInit = nodeEntryUtils.init;
18
- nodeEntryUtils.init = () => b4a.alloc(0);
19
-
20
- t.teardown(() => {
21
- nodeEntryUtils.init = originalInit;
22
- });
23
-
24
- await adminNode.base.append(payload);
25
- await adminNode.base.update();
26
- await eventFlush();
27
-
28
- await assertAddAdminRequesterFailureStateLocal(t, context);
29
- });
30
- }
@@ -1,68 +0,0 @@
1
- import { test } from 'brittle';
2
- import { eventFlush } from '../../../../helpers/autobaseTestHelpers.js';
3
-
4
- import {
5
- setupAddAdminScenario,
6
- buildAddAdminRequesterPayload,
7
- assertAddAdminRequesterFailureStateLocal
8
- } from './addAdminScenarioHelpers.js';
9
-
10
- /**
11
- * Verifies that ADD_ADMIN rejects payloads appended by any node other than the bootstrap writer.
12
- *
13
- * Only the bootstrap node has permission to run this operation. During the test we let the bootstrap
14
- * append a valid payload, but intercept the ensuing `State.apply` call and mutate `node.from.key`
15
- * so that the handler thinks the operation was produced by a reader node. That should trigger the
16
- * "Node is not a bootstrap node." guard, and the state must remain untouched.
17
- */
18
- export default function addAdminNonBootstrapNodeScenario() {
19
- test('State.apply addAdmin rejects non-bootstrap requesters', async t => {
20
- const networkContext = await setupAddAdminScenario(t);
21
- const adminNode = networkContext.adminBootstrap;
22
- const readerNode = networkContext.peers[1];
23
-
24
- const originalApply = adminNode.base._handlers.apply;
25
- let shouldMutateNextCall = true;
26
-
27
- adminNode.base._handlers.apply = async (nodes, view, baseCtx) => {
28
- if (!shouldMutateNextCall) {
29
- return originalApply(nodes, view, baseCtx);
30
- }
31
-
32
- shouldMutateNextCall = false;
33
- adminNode.base._handlers.apply = originalApply;
34
-
35
- const readerKey = readerNode.base.local.key;
36
- const mutatedNodes = nodes.map(node => {
37
- if (!node?.from) return node;
38
- return {
39
- ...node,
40
- from: new Proxy(node.from, {
41
- // We only need to fake node.from.key. A Proxy lets us override just that property
42
- // while Reflect delegates every other access to the original object, so the node
43
- // shape Autobase expects stays untouched.
44
- get(target, prop, receiver) {
45
- if (prop === 'key') {
46
- return readerKey;
47
- }
48
- return Reflect.get(target, prop, receiver);
49
- }
50
- })
51
- };
52
- });
53
-
54
- return originalApply(mutatedNodes, view, baseCtx);
55
- };
56
-
57
- t.teardown(() => {
58
- adminNode.base._handlers.apply = originalApply;
59
- });
60
-
61
- const payload = await buildAddAdminRequesterPayload(networkContext);
62
- await adminNode.base.append(payload);
63
- await adminNode.base.update();
64
- await eventFlush();
65
-
66
- await assertAddAdminRequesterFailureStateLocal(t, networkContext);
67
- });
68
- }
@@ -1,159 +0,0 @@
1
- import {
2
- setupAddAdminScenario,
3
- buildAddAdminRequesterPayload,
4
- assertAddAdminRequesterFailureState,
5
- assertAddAdminRequesterFailureStateLocal,
6
- mutateAddAdminPayloadForInvalidSchema,
7
- assertAdminStatePersists,
8
- bypassAddAdminReplayGuardsOnce
9
- } from './addAdminScenarioHelpers.js';
10
- import addAdminHappyPathScenario from './addAdminHappyPathScenario.js';
11
- import RequesterAddressValidationScenario from '../common/requesterAddressValidationScenario.js';
12
- import createRequesterPublicKeyValidationScenario from '../common/requesterPublicKeyValidationScenario.js';
13
- import InvalidHashValidationScenario from '../common/payload-structure/invalidHashValidationScenario.js';
14
- import InvalidSignatureValidationScenario, { SignatureMutationStrategy } from '../common/payload-structure/invalidSignatureValidationScenario.js';
15
- import InvalidMessageComponentValidationScenario, { MessageComponentStrategy } from '../common/invalidMessageComponentValidationScenario.js';
16
- import InvalidPayloadValidationScenario from '../common/payload-structure/invalidPayloadValidationScenario.js';
17
- import WriterKeyExistsValidationScenario from '../common/writerKeyExistsValidationScenario.js';
18
- import OperationAlreadyAppliedScenario from '../common/operationAlreadyAppliedScenario.js';
19
- import TransactionValidityMismatchScenario from '../common/transactionValidityMismatchScenario.js';
20
- import IndexerSequenceStateInvalidScenario from '../common/indexer/indexerSequenceStateInvalidScenario.js';
21
- import { applyStateMessageFactory } from '../../../../../src/messages/state/applyStateMessageFactory.js';
22
- import { safeEncodeApplyOperation } from '../../../../../src/utils/protobuf/operationHelpers.js';
23
- import addAdminEntryExistsScenario from './adminEntryExistsScenario.js';
24
- import addAdminNonBootstrapNodeScenario from './nonBootstrapNodeScenario.js';
25
- import addAdminNodeEntryInitializationFailureScenario from './nodeEntryInitializationFailureScenario.js';
26
- import addAdminEntryEncodingFailureScenario from './adminEntryEncodingFailureScenario.js';
27
- import { config } from '../../../../helpers/config.js';
28
-
29
- // happy path
30
- addAdminHappyPathScenario();
31
-
32
- addAdminEntryExistsScenario();
33
-
34
- addAdminNodeEntryInitializationFailureScenario();
35
- addAdminEntryEncodingFailureScenario();
36
-
37
- // common invalid scenarios
38
- new InvalidPayloadValidationScenario({
39
- title: 'State.apply addAdmin rejects payloads that fail schema validation',
40
- setupScenario: setupAddAdminScenario,
41
- buildValidPayload: buildAddAdminRequesterPayload,
42
- mutatePayload: mutateAddAdminPayloadForInvalidSchema,
43
- assertStateUnchanged: assertAddAdminRequesterFailureState,
44
- expectedLogs: ['Contract schema validation failed.']
45
- }).performScenario();
46
-
47
- new RequesterAddressValidationScenario({
48
- title: 'State.apply addAdmin requester address is invalid',
49
- setupScenario: setupAddAdminScenario,
50
- buildValidPayload: buildAddAdminRequesterPayload,
51
- assertStateUnchanged: assertAddAdminRequesterFailureState,
52
- expectedLogs: ['Requester address is invalid.']
53
- }).performScenario();
54
-
55
- createRequesterPublicKeyValidationScenario({
56
- title: 'State.apply addAdmin requester public key is invalid',
57
- setupScenario: setupAddAdminScenario,
58
- buildValidPayload: buildAddAdminRequesterPayload,
59
- assertStateUnchanged: assertAddAdminRequesterFailureState,
60
- expectedLogs: ['Error while decoding requester public key.']
61
- }).performScenario();
62
-
63
- addAdminNonBootstrapNodeScenario();
64
-
65
- new InvalidHashValidationScenario({
66
- title: 'State.apply addAdmin requester message hash mismatch',
67
- setupScenario: setupAddAdminScenario,
68
- buildValidPayload: buildAddAdminRequesterPayload,
69
- assertStateUnchanged: assertAddAdminRequesterFailureState,
70
- expectedLogs: ['Message hash does not match the tx_hash.']
71
- }).performScenario();
72
-
73
-
74
- new InvalidMessageComponentValidationScenario({
75
- title: 'State.apply addAdmin transaction validity mismatch',
76
- setupScenario: setupAddAdminScenario,
77
- buildValidPayload: buildAddAdminRequesterPayload,
78
- assertStateUnchanged: assertAddAdminRequesterFailureState,
79
- strategy: MessageComponentStrategy.TX_VALIDITY,
80
- expectedLogs: ['Message hash does not match the tx_hash.']
81
- }).performScenario();
82
-
83
- new InvalidMessageComponentValidationScenario({
84
- title: 'State.apply addAdmin requester nonce mismatch',
85
- setupScenario: setupAddAdminScenario,
86
- buildValidPayload: buildAddAdminRequesterPayload,
87
- assertStateUnchanged: assertAddAdminRequesterFailureState,
88
- strategy: MessageComponentStrategy.NONCE,
89
- expectedLogs: ['Message hash does not match the tx_hash.']
90
- }).performScenario();
91
-
92
- new InvalidSignatureValidationScenario({
93
- title: 'State.apply addAdmin requester signature is invalid (foreign signature)',
94
- setupScenario: setupAddAdminScenario,
95
- buildValidPayload: buildAddAdminRequesterPayload,
96
- assertStateUnchanged: assertAddAdminRequesterFailureState,
97
- expectedLogs: ['Failed to verify message signature.']
98
- }).performScenario();
99
-
100
- new InvalidSignatureValidationScenario({
101
- title: 'State.apply addAdmin requester signature is invalid (zero fill)',
102
- setupScenario: setupAddAdminScenario,
103
- buildValidPayload: buildAddAdminRequesterPayload,
104
- assertStateUnchanged: assertAddAdminRequesterFailureState,
105
- strategy: SignatureMutationStrategy.ZERO_FILL,
106
- expectedLogs: ['Failed to verify message signature.']
107
- }).performScenario();
108
-
109
- new InvalidSignatureValidationScenario({
110
- title: 'State.apply addAdmin requester signature is invalid (type mismatch)',
111
- setupScenario: setupAddAdminScenario,
112
- buildValidPayload: buildAddAdminRequesterPayload,
113
- assertStateUnchanged: assertAddAdminRequesterFailureState,
114
- strategy: SignatureMutationStrategy.TYPE_MISMATCH,
115
- expectedLogs: ['Failed to verify message signature.']
116
- }).performScenario();
117
-
118
- new IndexerSequenceStateInvalidScenario({
119
- title: 'State.apply addAdmin rejects payload when indexer sequence state is invalid',
120
- setupScenario: setupAddAdminScenario,
121
- buildValidPayload: buildAddAdminRequesterPayload,
122
- assertStateUnchanged: (t, context) => assertAddAdminRequesterFailureStateLocal(t, context),
123
- expectedLogs: ['Indexer sequence state is invalid.']
124
- }).performScenario();
125
-
126
- new TransactionValidityMismatchScenario({
127
- title: 'State.apply addAdmin rejects payload when cao.txv does not match indexer state',
128
- setupScenario: setupAddAdminScenario,
129
- buildValidPayload: buildAddAdminRequesterPayload,
130
- assertStateUnchanged: assertAddAdminRequesterFailureState,
131
- rebuildPayloadWithTxValidity: async ({ context, mutatedTxValidity }) => {
132
- const adminNode = context.adminBootstrap;
133
- const payload = await applyStateMessageFactory(adminNode.wallet, config)
134
- .buildCompleteAddAdminMessage(
135
- adminNode.wallet.address,
136
- adminNode.base.local.key,
137
- mutatedTxValidity
138
- );
139
- return safeEncodeApplyOperation(payload);
140
- },
141
- expectedLogs: ['Transaction was not executed.']
142
- }).performScenario();
143
-
144
- new WriterKeyExistsValidationScenario({
145
- title: 'State.apply addAdmin writer key already exists',
146
- setupScenario: setupAddAdminScenario,
147
- buildValidPayload: buildAddAdminRequesterPayload,
148
- assertStateUnchanged: assertAdminStatePersists,
149
- expectedLogs: ['Writer key already exists.']
150
- }).performScenario();
151
-
152
- new OperationAlreadyAppliedScenario({
153
- title: 'State.apply addAdmin rejects duplicate operations',
154
- setupScenario: setupAddAdminScenario,
155
- buildValidPayload: buildAddAdminRequesterPayload,
156
- assertStateUnchanged: assertAdminStatePersists,
157
- beforeInvalidApply: ({ context }) => bypassAddAdminReplayGuardsOnce(context),
158
- expectedLogs: ['Operation has already been applied.']
159
- }).performScenario();