web3gbit-cli 1.0.0

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 (989) hide show
  1. package/--broadcast +0 -0
  2. package/--private-key +0 -0
  3. package/--rpc-url +0 -0
  4. package/.github/workflows/test.yml +38 -0
  5. package/.gitmodules +3 -0
  6. package/GbitToken_flat.sol +2 -0
  7. package/GbitToken_flat.solnpx +0 -0
  8. package/README.md +72 -0
  9. package/admin-cli.js +413 -0
  10. package/cache/solidity-files-cache.json +1 -0
  11. package/foundry.lock +8 -0
  12. package/foundry.toml +6 -0
  13. package/lib/forge-std/.gitattributes +1 -0
  14. package/lib/forge-std/.github/CODEOWNERS +1 -0
  15. package/lib/forge-std/.github/dependabot.yml +6 -0
  16. package/lib/forge-std/.github/workflows/ci.yml +125 -0
  17. package/lib/forge-std/.github/workflows/sync.yml +36 -0
  18. package/lib/forge-std/CONTRIBUTING.md +193 -0
  19. package/lib/forge-std/LICENSE-APACHE +203 -0
  20. package/lib/forge-std/LICENSE-MIT +25 -0
  21. package/lib/forge-std/README.md +268 -0
  22. package/lib/forge-std/RELEASE_CHECKLIST.md +12 -0
  23. package/lib/forge-std/foundry.toml +18 -0
  24. package/lib/forge-std/package.json +16 -0
  25. package/lib/forge-std/scripts/vm.py +636 -0
  26. package/lib/forge-std/src/Base.sol +48 -0
  27. package/lib/forge-std/src/Config.sol +60 -0
  28. package/lib/forge-std/src/LibVariable.sol +477 -0
  29. package/lib/forge-std/src/Script.sol +28 -0
  30. package/lib/forge-std/src/StdAssertions.sol +779 -0
  31. package/lib/forge-std/src/StdChains.sol +295 -0
  32. package/lib/forge-std/src/StdCheats.sol +825 -0
  33. package/lib/forge-std/src/StdConfig.sol +632 -0
  34. package/lib/forge-std/src/StdConstants.sol +30 -0
  35. package/lib/forge-std/src/StdError.sol +15 -0
  36. package/lib/forge-std/src/StdInvariant.sol +120 -0
  37. package/lib/forge-std/src/StdJson.sol +275 -0
  38. package/lib/forge-std/src/StdMath.sol +47 -0
  39. package/lib/forge-std/src/StdStorage.sol +475 -0
  40. package/lib/forge-std/src/StdStyle.sol +333 -0
  41. package/lib/forge-std/src/StdToml.sol +275 -0
  42. package/lib/forge-std/src/StdUtils.sol +200 -0
  43. package/lib/forge-std/src/Test.sol +32 -0
  44. package/lib/forge-std/src/Vm.sol +2500 -0
  45. package/lib/forge-std/src/console.sol +1551 -0
  46. package/lib/forge-std/src/console2.sol +4 -0
  47. package/lib/forge-std/src/interfaces/IERC1155.sol +105 -0
  48. package/lib/forge-std/src/interfaces/IERC165.sol +12 -0
  49. package/lib/forge-std/src/interfaces/IERC20.sol +43 -0
  50. package/lib/forge-std/src/interfaces/IERC4626.sol +190 -0
  51. package/lib/forge-std/src/interfaces/IERC6909.sol +72 -0
  52. package/lib/forge-std/src/interfaces/IERC721.sol +164 -0
  53. package/lib/forge-std/src/interfaces/IERC7540.sol +144 -0
  54. package/lib/forge-std/src/interfaces/IERC7575.sol +241 -0
  55. package/lib/forge-std/src/interfaces/IMulticall3.sol +68 -0
  56. package/lib/forge-std/src/safeconsole.sol +13248 -0
  57. package/lib/forge-std/test/CommonBase.t.sol +44 -0
  58. package/lib/forge-std/test/Config.t.sol +381 -0
  59. package/lib/forge-std/test/LibVariable.t.sol +452 -0
  60. package/lib/forge-std/test/StdAssertions.t.sol +141 -0
  61. package/lib/forge-std/test/StdChains.t.sol +227 -0
  62. package/lib/forge-std/test/StdCheats.t.sol +638 -0
  63. package/lib/forge-std/test/StdConstants.t.sol +38 -0
  64. package/lib/forge-std/test/StdError.t.sol +119 -0
  65. package/lib/forge-std/test/StdJson.t.sol +49 -0
  66. package/lib/forge-std/test/StdMath.t.sol +202 -0
  67. package/lib/forge-std/test/StdStorage.t.sol +485 -0
  68. package/lib/forge-std/test/StdStyle.t.sol +110 -0
  69. package/lib/forge-std/test/StdToml.t.sol +49 -0
  70. package/lib/forge-std/test/StdUtils.t.sol +342 -0
  71. package/lib/forge-std/test/Vm.t.sol +18 -0
  72. package/lib/forge-std/test/compilation/CompilationScript.sol +8 -0
  73. package/lib/forge-std/test/compilation/CompilationScriptBase.sol +8 -0
  74. package/lib/forge-std/test/compilation/CompilationTest.sol +8 -0
  75. package/lib/forge-std/test/compilation/CompilationTestBase.sol +8 -0
  76. package/lib/forge-std/test/fixtures/broadcast.log.json +187 -0
  77. package/lib/forge-std/test/fixtures/config.toml +81 -0
  78. package/lib/forge-std/test/fixtures/test.json +8 -0
  79. package/lib/forge-std/test/fixtures/test.toml +6 -0
  80. package/lib/openzeppelin-contracts/.changeset/blue-mirrors-agree.md +5 -0
  81. package/lib/openzeppelin-contracts/.changeset/bright-webs-create.md +5 -0
  82. package/lib/openzeppelin-contracts/.changeset/clean-worlds-end.md +5 -0
  83. package/lib/openzeppelin-contracts/.changeset/config.json +12 -0
  84. package/lib/openzeppelin-contracts/.changeset/curly-pandas-flow.md +5 -0
  85. package/lib/openzeppelin-contracts/.changeset/flat-ideas-count.md +5 -0
  86. package/lib/openzeppelin-contracts/.changeset/fluffy-facts-brake.md +5 -0
  87. package/lib/openzeppelin-contracts/.changeset/forty-ads-design.md +5 -0
  88. package/lib/openzeppelin-contracts/.changeset/full-emus-hear.md +5 -0
  89. package/lib/openzeppelin-contracts/.changeset/fuzzy-lizards-do.md +5 -0
  90. package/lib/openzeppelin-contracts/.changeset/grumpy-cats-brake.md +5 -0
  91. package/lib/openzeppelin-contracts/.changeset/khaki-crews-join.md +5 -0
  92. package/lib/openzeppelin-contracts/.changeset/new-socks-deny.md +5 -0
  93. package/lib/openzeppelin-contracts/.changeset/shaky-phones-mix.md +5 -0
  94. package/lib/openzeppelin-contracts/.changeset/social-tools-sniff.md +5 -0
  95. package/lib/openzeppelin-contracts/.changeset/spotty-plums-brush.md +5 -0
  96. package/lib/openzeppelin-contracts/.changeset/stale-lizards-cheat.md +5 -0
  97. package/lib/openzeppelin-contracts/.changeset/swift-planets-juggle.md +5 -0
  98. package/lib/openzeppelin-contracts/.changeset/tame-monkeys-make.md +5 -0
  99. package/lib/openzeppelin-contracts/.changeset/tender-pans-yawn.md +5 -0
  100. package/lib/openzeppelin-contracts/.changeset/thick-banks-relate.md +5 -0
  101. package/lib/openzeppelin-contracts/.changeset/vast-worlds-pull.md +5 -0
  102. package/lib/openzeppelin-contracts/.changeset/whole-turkeys-swim.md +5 -0
  103. package/lib/openzeppelin-contracts/.changeset/yellow-clowns-mate.md +5 -0
  104. package/lib/openzeppelin-contracts/.changeset/young-corners-help.md +5 -0
  105. package/lib/openzeppelin-contracts/.codecov.yml +16 -0
  106. package/lib/openzeppelin-contracts/.editorconfig +21 -0
  107. package/lib/openzeppelin-contracts/.gitattributes +3 -0
  108. package/lib/openzeppelin-contracts/.github/CODEOWNERS +10 -0
  109. package/lib/openzeppelin-contracts/.github/ISSUE_TEMPLATE/bug_report.md +21 -0
  110. package/lib/openzeppelin-contracts/.github/ISSUE_TEMPLATE/config.yml +4 -0
  111. package/lib/openzeppelin-contracts/.github/ISSUE_TEMPLATE/feature_request.md +14 -0
  112. package/lib/openzeppelin-contracts/.github/PULL_REQUEST_TEMPLATE.md +20 -0
  113. package/lib/openzeppelin-contracts/.github/actions/gas-compare/action.yml +51 -0
  114. package/lib/openzeppelin-contracts/.github/actions/setup/action.yml +108 -0
  115. package/lib/openzeppelin-contracts/.github/actions/storage-layout/action.yml +57 -0
  116. package/lib/openzeppelin-contracts/.github/workflows/actionlint.yml +18 -0
  117. package/lib/openzeppelin-contracts/.github/workflows/changeset.yml +28 -0
  118. package/lib/openzeppelin-contracts/.github/workflows/checks.yml +132 -0
  119. package/lib/openzeppelin-contracts/.github/workflows/docs.yml +19 -0
  120. package/lib/openzeppelin-contracts/.github/workflows/formal-verification.yml +63 -0
  121. package/lib/openzeppelin-contracts/.github/workflows/release-cycle.yml +212 -0
  122. package/lib/openzeppelin-contracts/.github/workflows/release-upgradeable.yml +95 -0
  123. package/lib/openzeppelin-contracts/.github/workflows/upgradeable.yml +35 -0
  124. package/lib/openzeppelin-contracts/.gitmodules +10 -0
  125. package/lib/openzeppelin-contracts/.husky/pre-commit +2 -0
  126. package/lib/openzeppelin-contracts/.mocharc.js +4 -0
  127. package/lib/openzeppelin-contracts/.prettierrc +15 -0
  128. package/lib/openzeppelin-contracts/.solcover.js +21 -0
  129. package/lib/openzeppelin-contracts/CHANGELOG.md +1364 -0
  130. package/lib/openzeppelin-contracts/CODE_OF_CONDUCT.md +73 -0
  131. package/lib/openzeppelin-contracts/CONTRIBUTING.md +36 -0
  132. package/lib/openzeppelin-contracts/FUNDING.json +10 -0
  133. package/lib/openzeppelin-contracts/GUIDELINES.md +170 -0
  134. package/lib/openzeppelin-contracts/LICENSE +22 -0
  135. package/lib/openzeppelin-contracts/README.md +122 -0
  136. package/lib/openzeppelin-contracts/RELEASING.md +45 -0
  137. package/lib/openzeppelin-contracts/SECURITY.md +43 -0
  138. package/lib/openzeppelin-contracts/audits/2017-03.md +292 -0
  139. package/lib/openzeppelin-contracts/audits/2018-10.pdf +0 -0
  140. package/lib/openzeppelin-contracts/audits/2022-10-Checkpoints.pdf +0 -0
  141. package/lib/openzeppelin-contracts/audits/2022-10-ERC4626.pdf +0 -0
  142. package/lib/openzeppelin-contracts/audits/2023-05-v4.9.pdf +0 -0
  143. package/lib/openzeppelin-contracts/audits/2023-10-v5.0.pdf +0 -0
  144. package/lib/openzeppelin-contracts/audits/2024-10-v5.1.pdf +0 -0
  145. package/lib/openzeppelin-contracts/audits/2024-12-v5.2.pdf +0 -0
  146. package/lib/openzeppelin-contracts/audits/2025-04-v5.3.pdf +0 -0
  147. package/lib/openzeppelin-contracts/audits/2025-07-v5.4.pdf +0 -0
  148. package/lib/openzeppelin-contracts/audits/2025-10-v5.5.pdf +0 -0
  149. package/lib/openzeppelin-contracts/audits/README.md +22 -0
  150. package/lib/openzeppelin-contracts/contracts/access/AccessControl.sol +207 -0
  151. package/lib/openzeppelin-contracts/contracts/access/IAccessControl.sol +98 -0
  152. package/lib/openzeppelin-contracts/contracts/access/Ownable.sol +100 -0
  153. package/lib/openzeppelin-contracts/contracts/access/Ownable2Step.sol +67 -0
  154. package/lib/openzeppelin-contracts/contracts/access/README.adoc +45 -0
  155. package/lib/openzeppelin-contracts/contracts/access/extensions/AccessControlDefaultAdminRules.sol +372 -0
  156. package/lib/openzeppelin-contracts/contracts/access/extensions/AccessControlEnumerable.sol +81 -0
  157. package/lib/openzeppelin-contracts/contracts/access/extensions/IAccessControlDefaultAdminRules.sol +192 -0
  158. package/lib/openzeppelin-contracts/contracts/access/extensions/IAccessControlEnumerable.sol +31 -0
  159. package/lib/openzeppelin-contracts/contracts/access/manager/AccessManaged.sol +112 -0
  160. package/lib/openzeppelin-contracts/contracts/access/manager/AccessManager.sol +741 -0
  161. package/lib/openzeppelin-contracts/contracts/access/manager/AuthorityUtils.sol +36 -0
  162. package/lib/openzeppelin-contracts/contracts/access/manager/IAccessManaged.sol +32 -0
  163. package/lib/openzeppelin-contracts/contracts/access/manager/IAccessManager.sol +403 -0
  164. package/lib/openzeppelin-contracts/contracts/access/manager/IAuthority.sol +14 -0
  165. package/lib/openzeppelin-contracts/contracts/account/Account.sol +151 -0
  166. package/lib/openzeppelin-contracts/contracts/account/README.adoc +30 -0
  167. package/lib/openzeppelin-contracts/contracts/account/extensions/draft-AccountERC7579.sol +420 -0
  168. package/lib/openzeppelin-contracts/contracts/account/extensions/draft-AccountERC7579Hooked.sol +107 -0
  169. package/lib/openzeppelin-contracts/contracts/account/extensions/draft-ERC7821.sol +70 -0
  170. package/lib/openzeppelin-contracts/contracts/account/utils/EIP7702Utils.sol +21 -0
  171. package/lib/openzeppelin-contracts/contracts/account/utils/draft-ERC4337Utils.sol +279 -0
  172. package/lib/openzeppelin-contracts/contracts/account/utils/draft-ERC7579Utils.sol +280 -0
  173. package/lib/openzeppelin-contracts/contracts/crosschain/CrosschainLinked.sol +108 -0
  174. package/lib/openzeppelin-contracts/contracts/crosschain/ERC7786Recipient.sol +70 -0
  175. package/lib/openzeppelin-contracts/contracts/crosschain/README.adoc +29 -0
  176. package/lib/openzeppelin-contracts/contracts/crosschain/bridges/BridgeERC20.sol +36 -0
  177. package/lib/openzeppelin-contracts/contracts/crosschain/bridges/BridgeERC20Core.sol +79 -0
  178. package/lib/openzeppelin-contracts/contracts/crosschain/bridges/BridgeERC7802.sol +33 -0
  179. package/lib/openzeppelin-contracts/contracts/finance/README.adoc +14 -0
  180. package/lib/openzeppelin-contracts/contracts/finance/VestingWallet.sol +160 -0
  181. package/lib/openzeppelin-contracts/contracts/finance/VestingWalletCliff.sol +54 -0
  182. package/lib/openzeppelin-contracts/contracts/governance/Governor.sol +819 -0
  183. package/lib/openzeppelin-contracts/contracts/governance/IGovernor.sol +454 -0
  184. package/lib/openzeppelin-contracts/contracts/governance/README.adoc +197 -0
  185. package/lib/openzeppelin-contracts/contracts/governance/TimelockController.sol +470 -0
  186. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorCountingFractional.sol +190 -0
  187. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorCountingOverridable.sol +222 -0
  188. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorCountingSimple.sol +96 -0
  189. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorNoncesKeyed.sol +91 -0
  190. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorPreventLateQuorum.sol +92 -0
  191. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorProposalGuardian.sol +59 -0
  192. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorSequentialProposalId.sol +75 -0
  193. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorSettings.sol +106 -0
  194. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorStorage.sol +134 -0
  195. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorSuperQuorum.sol +59 -0
  196. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorTimelockAccess.sol +346 -0
  197. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorTimelockCompound.sol +165 -0
  198. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorTimelockControl.sol +167 -0
  199. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorVotes.sol +63 -0
  200. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorVotesQuorumFraction.sol +113 -0
  201. package/lib/openzeppelin-contracts/contracts/governance/extensions/GovernorVotesSuperQuorumFraction.sol +135 -0
  202. package/lib/openzeppelin-contracts/contracts/governance/utils/IVotes.sol +60 -0
  203. package/lib/openzeppelin-contracts/contracts/governance/utils/Votes.sol +253 -0
  204. package/lib/openzeppelin-contracts/contracts/governance/utils/VotesExtended.sol +85 -0
  205. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1155.sol +6 -0
  206. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1155MetadataURI.sol +6 -0
  207. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1155Receiver.sol +6 -0
  208. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1271.sol +17 -0
  209. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1363.sol +86 -0
  210. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1363Receiver.sol +32 -0
  211. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1363Spender.sol +26 -0
  212. package/lib/openzeppelin-contracts/contracts/interfaces/IERC165.sol +6 -0
  213. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1820Implementer.sol +20 -0
  214. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1820Registry.sol +112 -0
  215. package/lib/openzeppelin-contracts/contracts/interfaces/IERC1967.sol +24 -0
  216. package/lib/openzeppelin-contracts/contracts/interfaces/IERC20.sol +6 -0
  217. package/lib/openzeppelin-contracts/contracts/interfaces/IERC20Metadata.sol +6 -0
  218. package/lib/openzeppelin-contracts/contracts/interfaces/IERC2309.sol +19 -0
  219. package/lib/openzeppelin-contracts/contracts/interfaces/IERC2612.sol +8 -0
  220. package/lib/openzeppelin-contracts/contracts/interfaces/IERC2981.sol +26 -0
  221. package/lib/openzeppelin-contracts/contracts/interfaces/IERC3156.sol +7 -0
  222. package/lib/openzeppelin-contracts/contracts/interfaces/IERC3156FlashBorrower.sol +27 -0
  223. package/lib/openzeppelin-contracts/contracts/interfaces/IERC3156FlashLender.sol +41 -0
  224. package/lib/openzeppelin-contracts/contracts/interfaces/IERC4626.sol +230 -0
  225. package/lib/openzeppelin-contracts/contracts/interfaces/IERC4906.sol +20 -0
  226. package/lib/openzeppelin-contracts/contracts/interfaces/IERC5267.sol +28 -0
  227. package/lib/openzeppelin-contracts/contracts/interfaces/IERC5313.sol +16 -0
  228. package/lib/openzeppelin-contracts/contracts/interfaces/IERC5805.sol +9 -0
  229. package/lib/openzeppelin-contracts/contracts/interfaces/IERC6372.sol +17 -0
  230. package/lib/openzeppelin-contracts/contracts/interfaces/IERC6909.sol +125 -0
  231. package/lib/openzeppelin-contracts/contracts/interfaces/IERC721.sol +6 -0
  232. package/lib/openzeppelin-contracts/contracts/interfaces/IERC721Enumerable.sol +6 -0
  233. package/lib/openzeppelin-contracts/contracts/interfaces/IERC721Metadata.sol +6 -0
  234. package/lib/openzeppelin-contracts/contracts/interfaces/IERC721Receiver.sol +6 -0
  235. package/lib/openzeppelin-contracts/contracts/interfaces/IERC7751.sol +12 -0
  236. package/lib/openzeppelin-contracts/contracts/interfaces/IERC777.sol +200 -0
  237. package/lib/openzeppelin-contracts/contracts/interfaces/IERC777Recipient.sol +35 -0
  238. package/lib/openzeppelin-contracts/contracts/interfaces/IERC777Sender.sol +35 -0
  239. package/lib/openzeppelin-contracts/contracts/interfaces/IERC7913.sol +18 -0
  240. package/lib/openzeppelin-contracts/contracts/interfaces/README.adoc +138 -0
  241. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC1822.sol +20 -0
  242. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC4337.sol +255 -0
  243. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC6093.sol +162 -0
  244. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC7579.sol +227 -0
  245. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC7674.sol +17 -0
  246. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC7786.sol +64 -0
  247. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC7802.sol +32 -0
  248. package/lib/openzeppelin-contracts/contracts/interfaces/draft-IERC7821.sol +44 -0
  249. package/lib/openzeppelin-contracts/contracts/metatx/ERC2771Context.sol +90 -0
  250. package/lib/openzeppelin-contracts/contracts/metatx/ERC2771Forwarder.sol +372 -0
  251. package/lib/openzeppelin-contracts/contracts/metatx/README.adoc +17 -0
  252. package/lib/openzeppelin-contracts/contracts/mocks/AccessManagedTarget.sol +34 -0
  253. package/lib/openzeppelin-contracts/contracts/mocks/AccessManagerMock.sol +20 -0
  254. package/lib/openzeppelin-contracts/contracts/mocks/ArraysMock.sol +171 -0
  255. package/lib/openzeppelin-contracts/contracts/mocks/AuthorityMock.sol +69 -0
  256. package/lib/openzeppelin-contracts/contracts/mocks/Base64Dirty.sol +19 -0
  257. package/lib/openzeppelin-contracts/contracts/mocks/BatchCaller.sol +20 -0
  258. package/lib/openzeppelin-contracts/contracts/mocks/CallReceiverMock.sol +106 -0
  259. package/lib/openzeppelin-contracts/contracts/mocks/ConstructorMock.sol +34 -0
  260. package/lib/openzeppelin-contracts/contracts/mocks/ContextMock.sol +35 -0
  261. package/lib/openzeppelin-contracts/contracts/mocks/DummyImplementation.sol +61 -0
  262. package/lib/openzeppelin-contracts/contracts/mocks/EIP712Verifier.sol +16 -0
  263. package/lib/openzeppelin-contracts/contracts/mocks/ERC1271WalletMock.sol +24 -0
  264. package/lib/openzeppelin-contracts/contracts/mocks/ERC165Mock.sol +100 -0
  265. package/lib/openzeppelin-contracts/contracts/mocks/ERC2771ContextMock.sol +28 -0
  266. package/lib/openzeppelin-contracts/contracts/mocks/ERC3156FlashBorrowerMock.sol +53 -0
  267. package/lib/openzeppelin-contracts/contracts/mocks/EtherReceiverMock.sol +17 -0
  268. package/lib/openzeppelin-contracts/contracts/mocks/InitializableMock.sol +130 -0
  269. package/lib/openzeppelin-contracts/contracts/mocks/MerkleProofCustomHashMock.sol +62 -0
  270. package/lib/openzeppelin-contracts/contracts/mocks/MerkleTreeMock.sol +52 -0
  271. package/lib/openzeppelin-contracts/contracts/mocks/MulticallHelper.sol +23 -0
  272. package/lib/openzeppelin-contracts/contracts/mocks/MultipleInheritanceInitializableMocks.sol +131 -0
  273. package/lib/openzeppelin-contracts/contracts/mocks/PausableMock.sol +31 -0
  274. package/lib/openzeppelin-contracts/contracts/mocks/ReentrancyAttack.sol +17 -0
  275. package/lib/openzeppelin-contracts/contracts/mocks/ReentrancyMock.sol +59 -0
  276. package/lib/openzeppelin-contracts/contracts/mocks/ReentrancyTransientMock.sol +59 -0
  277. package/lib/openzeppelin-contracts/contracts/mocks/RegressionImplementation.sol +61 -0
  278. package/lib/openzeppelin-contracts/contracts/mocks/SingleInheritanceInitializableMocks.sol +49 -0
  279. package/lib/openzeppelin-contracts/contracts/mocks/Stateless.sol +62 -0
  280. package/lib/openzeppelin-contracts/contracts/mocks/StorageSlotMock.sol +87 -0
  281. package/lib/openzeppelin-contracts/contracts/mocks/TimelockReentrant.sol +26 -0
  282. package/lib/openzeppelin-contracts/contracts/mocks/TransientSlotMock.sol +61 -0
  283. package/lib/openzeppelin-contracts/contracts/mocks/UpgradeableBeaconMock.sol +27 -0
  284. package/lib/openzeppelin-contracts/contracts/mocks/VotesExtendedMock.sol +42 -0
  285. package/lib/openzeppelin-contracts/contracts/mocks/VotesMock.sol +42 -0
  286. package/lib/openzeppelin-contracts/contracts/mocks/account/AccountMock.sol +181 -0
  287. package/lib/openzeppelin-contracts/contracts/mocks/account/modules/ERC7579Mock.sol +128 -0
  288. package/lib/openzeppelin-contracts/contracts/mocks/account/utils/ERC7579UtilsMock.sol +23 -0
  289. package/lib/openzeppelin-contracts/contracts/mocks/compound/CompTimelock.sol +174 -0
  290. package/lib/openzeppelin-contracts/contracts/mocks/crosschain/ERC7786GatewayMock.sol +56 -0
  291. package/lib/openzeppelin-contracts/contracts/mocks/crosschain/ERC7786RecipientMock.sol +31 -0
  292. package/lib/openzeppelin-contracts/contracts/mocks/docs/AccessManagerEnumerable.sol +161 -0
  293. package/lib/openzeppelin-contracts/contracts/mocks/docs/ERC20WithAutoMinerReward.sol +22 -0
  294. package/lib/openzeppelin-contracts/contracts/mocks/docs/ERC4626Fees.sol +109 -0
  295. package/lib/openzeppelin-contracts/contracts/mocks/docs/MyNFT.sol +9 -0
  296. package/lib/openzeppelin-contracts/contracts/mocks/docs/access-control/AccessControlERC20MintBase.sol +25 -0
  297. package/lib/openzeppelin-contracts/contracts/mocks/docs/access-control/AccessControlERC20MintMissing.sol +24 -0
  298. package/lib/openzeppelin-contracts/contracts/mocks/docs/access-control/AccessControlERC20MintOnlyRole.sol +23 -0
  299. package/lib/openzeppelin-contracts/contracts/mocks/docs/access-control/AccessControlModified.sol +14 -0
  300. package/lib/openzeppelin-contracts/contracts/mocks/docs/access-control/AccessManagedERC20MintBase.sol +16 -0
  301. package/lib/openzeppelin-contracts/contracts/mocks/docs/access-control/MyContractOwnable.sol +17 -0
  302. package/lib/openzeppelin-contracts/contracts/mocks/docs/account/MyAccountEIP7702.sol +20 -0
  303. package/lib/openzeppelin-contracts/contracts/mocks/docs/account/MyFactoryAccount.sol +37 -0
  304. package/lib/openzeppelin-contracts/contracts/mocks/docs/governance/MyGovernor.sol +80 -0
  305. package/lib/openzeppelin-contracts/contracts/mocks/docs/governance/MyToken.sol +21 -0
  306. package/lib/openzeppelin-contracts/contracts/mocks/docs/governance/MyTokenTimestampBased.sol +32 -0
  307. package/lib/openzeppelin-contracts/contracts/mocks/docs/governance/MyTokenWrapped.sol +28 -0
  308. package/lib/openzeppelin-contracts/contracts/mocks/docs/token/ERC1155/GameItems.sol +21 -0
  309. package/lib/openzeppelin-contracts/contracts/mocks/docs/token/ERC1155/MyERC115HolderContract.sol +7 -0
  310. package/lib/openzeppelin-contracts/contracts/mocks/docs/token/ERC20/GLDToken.sol +11 -0
  311. package/lib/openzeppelin-contracts/contracts/mocks/docs/token/ERC6909/ERC6909GameItems.sol +26 -0
  312. package/lib/openzeppelin-contracts/contracts/mocks/docs/token/ERC721/GameItem.sol +19 -0
  313. package/lib/openzeppelin-contracts/contracts/mocks/docs/utilities/Base64NFT.sol +27 -0
  314. package/lib/openzeppelin-contracts/contracts/mocks/docs/utilities/Multicall.sol +15 -0
  315. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorCountingOverridableMock.sol +18 -0
  316. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorFractionalMock.sol +14 -0
  317. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorMock.sol +14 -0
  318. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorNoncesKeyedMock.sol +44 -0
  319. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorPreventLateQuorumMock.sol +40 -0
  320. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorProposalGuardianMock.sol +27 -0
  321. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorSequentialProposalIdMock.sol +39 -0
  322. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorStorageMock.sol +79 -0
  323. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorSuperQuorumMock.sol +95 -0
  324. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorTimelockAccessMock.sol +70 -0
  325. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorTimelockCompoundMock.sol +69 -0
  326. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorTimelockControlMock.sol +69 -0
  327. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorVoteMock.sol +20 -0
  328. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorVotesSuperQuorumFractionMock.sol +37 -0
  329. package/lib/openzeppelin-contracts/contracts/mocks/governance/GovernorWithParamsMock.sol +51 -0
  330. package/lib/openzeppelin-contracts/contracts/mocks/proxy/BadBeacon.sol +11 -0
  331. package/lib/openzeppelin-contracts/contracts/mocks/proxy/ClashingImplementation.sol +19 -0
  332. package/lib/openzeppelin-contracts/contracts/mocks/proxy/ERC1967ProxyUnsafe.sol +13 -0
  333. package/lib/openzeppelin-contracts/contracts/mocks/proxy/UUPSUpgradeableMock.sol +35 -0
  334. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC1155ReceiverMock.sol +74 -0
  335. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC1363ForceApproveMock.sol +13 -0
  336. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC1363NoReturnMock.sol +33 -0
  337. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC1363ReceiverMock.sol +52 -0
  338. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC1363ReturnFalseMock.sol +34 -0
  339. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC1363SpenderMock.sol +47 -0
  340. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20ApprovalMock.sol +10 -0
  341. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20BridgeableMock.sol +30 -0
  342. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20DecimalsMock.sol +17 -0
  343. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20ExcessDecimalsMock.sol +9 -0
  344. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20FlashMintMock.sol +26 -0
  345. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20ForceApproveMock.sol +13 -0
  346. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20GetterHelper.sol +38 -0
  347. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20Mock.sol +16 -0
  348. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20MulticallMock.sol +8 -0
  349. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20NoReturnMock.sol +30 -0
  350. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20Reentrant.sol +39 -0
  351. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20ReturnFalseMock.sol +19 -0
  352. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20VotesAdditionalCheckpointsMock.sol +31 -0
  353. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20VotesLegacyMock.sol +253 -0
  354. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC20VotesTimestampMock.sol +29 -0
  355. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC4626LimitsMock.sol +23 -0
  356. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC4626Mock.sol +17 -0
  357. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC4626OffsetMock.sol +17 -0
  358. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC4646FeesMock.sol +40 -0
  359. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC721ConsecutiveEnumerableMock.sol +42 -0
  360. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC721ConsecutiveMock.sol +61 -0
  361. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC721ReceiverMock.sol +47 -0
  362. package/lib/openzeppelin-contracts/contracts/mocks/token/ERC721URIStorageMock.sol +17 -0
  363. package/lib/openzeppelin-contracts/contracts/mocks/utils/cryptography/ERC7739Mock.sol +12 -0
  364. package/lib/openzeppelin-contracts/contracts/package.json +32 -0
  365. package/lib/openzeppelin-contracts/contracts/proxy/Clones.sol +294 -0
  366. package/lib/openzeppelin-contracts/contracts/proxy/ERC1967/ERC1967Proxy.sol +62 -0
  367. package/lib/openzeppelin-contracts/contracts/proxy/ERC1967/ERC1967Utils.sol +177 -0
  368. package/lib/openzeppelin-contracts/contracts/proxy/Proxy.sol +69 -0
  369. package/lib/openzeppelin-contracts/contracts/proxy/README.adoc +87 -0
  370. package/lib/openzeppelin-contracts/contracts/proxy/beacon/BeaconProxy.sol +57 -0
  371. package/lib/openzeppelin-contracts/contracts/proxy/beacon/IBeacon.sol +16 -0
  372. package/lib/openzeppelin-contracts/contracts/proxy/beacon/UpgradeableBeacon.sol +70 -0
  373. package/lib/openzeppelin-contracts/contracts/proxy/transparent/ProxyAdmin.sol +45 -0
  374. package/lib/openzeppelin-contracts/contracts/proxy/transparent/TransparentUpgradeableProxy.sol +118 -0
  375. package/lib/openzeppelin-contracts/contracts/proxy/utils/Initializable.sol +238 -0
  376. package/lib/openzeppelin-contracts/contracts/proxy/utils/UUPSUpgradeable.sol +148 -0
  377. package/lib/openzeppelin-contracts/contracts/token/ERC1155/ERC1155.sol +416 -0
  378. package/lib/openzeppelin-contracts/contracts/token/ERC1155/IERC1155.sol +123 -0
  379. package/lib/openzeppelin-contracts/contracts/token/ERC1155/IERC1155Receiver.sol +59 -0
  380. package/lib/openzeppelin-contracts/contracts/token/ERC1155/README.adoc +43 -0
  381. package/lib/openzeppelin-contracts/contracts/token/ERC1155/extensions/ERC1155Burnable.sol +28 -0
  382. package/lib/openzeppelin-contracts/contracts/token/ERC1155/extensions/ERC1155Pausable.sol +38 -0
  383. package/lib/openzeppelin-contracts/contracts/token/ERC1155/extensions/ERC1155Supply.sol +88 -0
  384. package/lib/openzeppelin-contracts/contracts/token/ERC1155/extensions/ERC1155URIStorage.sol +58 -0
  385. package/lib/openzeppelin-contracts/contracts/token/ERC1155/extensions/IERC1155MetadataURI.sol +20 -0
  386. package/lib/openzeppelin-contracts/contracts/token/ERC1155/utils/ERC1155Holder.sol +42 -0
  387. package/lib/openzeppelin-contracts/contracts/token/ERC1155/utils/ERC1155Utils.sol +88 -0
  388. package/lib/openzeppelin-contracts/contracts/token/ERC20/ERC20.sol +305 -0
  389. package/lib/openzeppelin-contracts/contracts/token/ERC20/IERC20.sol +79 -0
  390. package/lib/openzeppelin-contracts/contracts/token/ERC20/README.adoc +81 -0
  391. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC1363.sol +135 -0
  392. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20Burnable.sol +39 -0
  393. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20Capped.sol +54 -0
  394. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20Crosschain.sol +38 -0
  395. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20FlashMint.sol +130 -0
  396. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20Pausable.sol +33 -0
  397. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20Permit.sol +77 -0
  398. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20Votes.sol +83 -0
  399. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC20Wrapper.sol +89 -0
  400. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/ERC4626.sol +315 -0
  401. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/IERC20Metadata.sol +26 -0
  402. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/IERC20Permit.sol +90 -0
  403. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/draft-ERC20Bridgeable.sol +51 -0
  404. package/lib/openzeppelin-contracts/contracts/token/ERC20/extensions/draft-ERC20TemporaryApproval.sol +119 -0
  405. package/lib/openzeppelin-contracts/contracts/token/ERC20/utils/ERC1363Utils.sol +95 -0
  406. package/lib/openzeppelin-contracts/contracts/token/ERC20/utils/SafeERC20.sol +280 -0
  407. package/lib/openzeppelin-contracts/contracts/token/ERC6909/ERC6909.sol +224 -0
  408. package/lib/openzeppelin-contracts/contracts/token/ERC6909/README.adoc +27 -0
  409. package/lib/openzeppelin-contracts/contracts/token/ERC6909/extensions/ERC6909ContentURI.sol +59 -0
  410. package/lib/openzeppelin-contracts/contracts/token/ERC6909/extensions/ERC6909Metadata.sol +83 -0
  411. package/lib/openzeppelin-contracts/contracts/token/ERC6909/extensions/ERC6909TokenSupply.sol +41 -0
  412. package/lib/openzeppelin-contracts/contracts/token/ERC721/ERC721.sol +433 -0
  413. package/lib/openzeppelin-contracts/contracts/token/ERC721/IERC721.sol +135 -0
  414. package/lib/openzeppelin-contracts/contracts/token/ERC721/IERC721Receiver.sol +28 -0
  415. package/lib/openzeppelin-contracts/contracts/token/ERC721/README.adoc +69 -0
  416. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Burnable.sol +26 -0
  417. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Consecutive.sol +176 -0
  418. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Enumerable.sol +165 -0
  419. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Pausable.sol +37 -0
  420. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Royalty.sol +26 -0
  421. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721URIStorage.sol +62 -0
  422. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Votes.sol +47 -0
  423. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Wrapper.sol +102 -0
  424. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/IERC721Enumerable.sol +29 -0
  425. package/lib/openzeppelin-contracts/contracts/token/ERC721/extensions/IERC721Metadata.sol +27 -0
  426. package/lib/openzeppelin-contracts/contracts/token/ERC721/utils/ERC721Holder.sol +26 -0
  427. package/lib/openzeppelin-contracts/contracts/token/ERC721/utils/ERC721Utils.sol +50 -0
  428. package/lib/openzeppelin-contracts/contracts/token/common/ERC2981.sol +139 -0
  429. package/lib/openzeppelin-contracts/contracts/token/common/README.adoc +10 -0
  430. package/lib/openzeppelin-contracts/contracts/utils/Address.sol +167 -0
  431. package/lib/openzeppelin-contracts/contracts/utils/Arrays.sol +888 -0
  432. package/lib/openzeppelin-contracts/contracts/utils/Base58.sol +240 -0
  433. package/lib/openzeppelin-contracts/contracts/utils/Base64.sol +234 -0
  434. package/lib/openzeppelin-contracts/contracts/utils/Blockhash.sol +54 -0
  435. package/lib/openzeppelin-contracts/contracts/utils/Bytes.sol +332 -0
  436. package/lib/openzeppelin-contracts/contracts/utils/CAIP10.sol +54 -0
  437. package/lib/openzeppelin-contracts/contracts/utils/CAIP2.sol +51 -0
  438. package/lib/openzeppelin-contracts/contracts/utils/Calldata.sol +25 -0
  439. package/lib/openzeppelin-contracts/contracts/utils/Comparators.sol +19 -0
  440. package/lib/openzeppelin-contracts/contracts/utils/Context.sol +28 -0
  441. package/lib/openzeppelin-contracts/contracts/utils/Create2.sol +91 -0
  442. package/lib/openzeppelin-contracts/contracts/utils/Errors.sol +34 -0
  443. package/lib/openzeppelin-contracts/contracts/utils/LowLevelCall.sol +127 -0
  444. package/lib/openzeppelin-contracts/contracts/utils/Memory.sol +146 -0
  445. package/lib/openzeppelin-contracts/contracts/utils/Multicall.sol +37 -0
  446. package/lib/openzeppelin-contracts/contracts/utils/Nonces.sol +46 -0
  447. package/lib/openzeppelin-contracts/contracts/utils/NoncesKeyed.sol +74 -0
  448. package/lib/openzeppelin-contracts/contracts/utils/Packing.sol +1656 -0
  449. package/lib/openzeppelin-contracts/contracts/utils/Panic.sol +57 -0
  450. package/lib/openzeppelin-contracts/contracts/utils/Pausable.sol +112 -0
  451. package/lib/openzeppelin-contracts/contracts/utils/README.adoc +160 -0
  452. package/lib/openzeppelin-contracts/contracts/utils/RLP.sol +476 -0
  453. package/lib/openzeppelin-contracts/contracts/utils/ReentrancyGuard.sol +119 -0
  454. package/lib/openzeppelin-contracts/contracts/utils/ReentrancyGuardTransient.sol +84 -0
  455. package/lib/openzeppelin-contracts/contracts/utils/RelayedCall.sol +133 -0
  456. package/lib/openzeppelin-contracts/contracts/utils/ShortStrings.sol +122 -0
  457. package/lib/openzeppelin-contracts/contracts/utils/SlotDerivation.sol +155 -0
  458. package/lib/openzeppelin-contracts/contracts/utils/StorageSlot.sol +143 -0
  459. package/lib/openzeppelin-contracts/contracts/utils/Strings.sol +508 -0
  460. package/lib/openzeppelin-contracts/contracts/utils/TransientSlot.sol +183 -0
  461. package/lib/openzeppelin-contracts/contracts/utils/cryptography/ECDSA.sol +284 -0
  462. package/lib/openzeppelin-contracts/contracts/utils/cryptography/EIP712.sol +160 -0
  463. package/lib/openzeppelin-contracts/contracts/utils/cryptography/Hashes.sol +31 -0
  464. package/lib/openzeppelin-contracts/contracts/utils/cryptography/MerkleProof.sol +510 -0
  465. package/lib/openzeppelin-contracts/contracts/utils/cryptography/MessageHashUtils.sol +228 -0
  466. package/lib/openzeppelin-contracts/contracts/utils/cryptography/P256.sol +408 -0
  467. package/lib/openzeppelin-contracts/contracts/utils/cryptography/README.adoc +76 -0
  468. package/lib/openzeppelin-contracts/contracts/utils/cryptography/RSA.sol +154 -0
  469. package/lib/openzeppelin-contracts/contracts/utils/cryptography/SignatureChecker.sol +191 -0
  470. package/lib/openzeppelin-contracts/contracts/utils/cryptography/TrieProof.sol +230 -0
  471. package/lib/openzeppelin-contracts/contracts/utils/cryptography/WebAuthn.sol +261 -0
  472. package/lib/openzeppelin-contracts/contracts/utils/cryptography/draft-ERC7739Utils.sol +207 -0
  473. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/AbstractSigner.sol +23 -0
  474. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/MultiSignerERC7913.sol +259 -0
  475. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/MultiSignerERC7913Weighted.sol +208 -0
  476. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/SignerECDSA.sol +56 -0
  477. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/SignerEIP7702.sol +25 -0
  478. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/SignerERC7913.sol +63 -0
  479. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/SignerP256.sol +64 -0
  480. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/SignerRSA.sol +65 -0
  481. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/SignerWebAuthn.sol +51 -0
  482. package/lib/openzeppelin-contracts/contracts/utils/cryptography/signers/draft-ERC7739.sol +98 -0
  483. package/lib/openzeppelin-contracts/contracts/utils/cryptography/verifiers/ERC7913P256Verifier.sol +29 -0
  484. package/lib/openzeppelin-contracts/contracts/utils/cryptography/verifiers/ERC7913RSAVerifier.sol +23 -0
  485. package/lib/openzeppelin-contracts/contracts/utils/cryptography/verifiers/ERC7913WebAuthnVerifier.sol +35 -0
  486. package/lib/openzeppelin-contracts/contracts/utils/draft-InteroperableAddress.sol +235 -0
  487. package/lib/openzeppelin-contracts/contracts/utils/introspection/ERC165.sol +25 -0
  488. package/lib/openzeppelin-contracts/contracts/utils/introspection/ERC165Checker.sol +142 -0
  489. package/lib/openzeppelin-contracts/contracts/utils/introspection/IERC165.sol +25 -0
  490. package/lib/openzeppelin-contracts/contracts/utils/math/Math.sol +763 -0
  491. package/lib/openzeppelin-contracts/contracts/utils/math/SafeCast.sol +1162 -0
  492. package/lib/openzeppelin-contracts/contracts/utils/math/SignedMath.sol +68 -0
  493. package/lib/openzeppelin-contracts/contracts/utils/structs/Accumulators.sol +130 -0
  494. package/lib/openzeppelin-contracts/contracts/utils/structs/BitMaps.sol +60 -0
  495. package/lib/openzeppelin-contracts/contracts/utils/structs/Checkpoints.sol +833 -0
  496. package/lib/openzeppelin-contracts/contracts/utils/structs/CircularBuffer.sol +152 -0
  497. package/lib/openzeppelin-contracts/contracts/utils/structs/DoubleEndedQueue.sol +237 -0
  498. package/lib/openzeppelin-contracts/contracts/utils/structs/EnumerableMap.sol +1443 -0
  499. package/lib/openzeppelin-contracts/contracts/utils/structs/EnumerableSet.sol +895 -0
  500. package/lib/openzeppelin-contracts/contracts/utils/structs/Heap.sol +259 -0
  501. package/lib/openzeppelin-contracts/contracts/utils/structs/MerkleTree.sol +267 -0
  502. package/lib/openzeppelin-contracts/contracts/utils/types/Time.sol +133 -0
  503. package/lib/openzeppelin-contracts/contracts/vendor/compound/ICompoundTimelock.sol +86 -0
  504. package/lib/openzeppelin-contracts/contracts/vendor/compound/LICENSE +11 -0
  505. package/lib/openzeppelin-contracts/docs/README.md +16 -0
  506. package/lib/openzeppelin-contracts/docs/antora.yml +7 -0
  507. package/lib/openzeppelin-contracts/docs/config.js +21 -0
  508. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/access-control-multiple.svg +97 -0
  509. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/access-manager-functions.svg +47 -0
  510. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/access-manager.svg +99 -0
  511. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-attack-3a.png +0 -0
  512. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-attack-3b.png +0 -0
  513. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-attack-6.png +0 -0
  514. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-attack.png +0 -0
  515. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-deposit.png +0 -0
  516. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-mint.png +0 -0
  517. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-rate-linear.png +0 -0
  518. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-rate-loglog.png +0 -0
  519. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/erc4626-rate-loglogext.png +0 -0
  520. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/tally-exec.png +0 -0
  521. package/lib/openzeppelin-contracts/docs/modules/ROOT/images/tally-vote.png +0 -0
  522. package/lib/openzeppelin-contracts/docs/modules/ROOT/nav.adoc +29 -0
  523. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/access-control.adoc +339 -0
  524. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/account-abstraction.adoc +100 -0
  525. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/accounts.adoc +354 -0
  526. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/backwards-compatibility.adoc +50 -0
  527. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/eoa-delegation.adoc +143 -0
  528. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/erc1155.adoc +118 -0
  529. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/erc20-supply.adoc +71 -0
  530. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/erc20.adoc +67 -0
  531. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/erc4626.adoc +214 -0
  532. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/erc6909.adoc +47 -0
  533. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/erc721.adoc +58 -0
  534. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/extending-contracts.adoc +51 -0
  535. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/faq.adoc +13 -0
  536. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/governance.adoc +242 -0
  537. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/index.adoc +100 -0
  538. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/multisig.adoc +308 -0
  539. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/tokens.adoc +31 -0
  540. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/upgradeable.adoc +77 -0
  541. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/utilities.adoc +634 -0
  542. package/lib/openzeppelin-contracts/docs/modules/ROOT/pages/wizard.adoc +15 -0
  543. package/lib/openzeppelin-contracts/docs/templates/contract.hbs +141 -0
  544. package/lib/openzeppelin-contracts/docs/templates/helpers.js +46 -0
  545. package/lib/openzeppelin-contracts/docs/templates/page.hbs +4 -0
  546. package/lib/openzeppelin-contracts/docs/templates/properties.js +88 -0
  547. package/lib/openzeppelin-contracts/eslint.config.mjs +29 -0
  548. package/lib/openzeppelin-contracts/foundry.toml +20 -0
  549. package/lib/openzeppelin-contracts/fv/Makefile +54 -0
  550. package/lib/openzeppelin-contracts/fv/README.md +60 -0
  551. package/lib/openzeppelin-contracts/fv/diff/access_manager_AccessManager.sol.patch +97 -0
  552. package/lib/openzeppelin-contracts/fv/diff/account_extensions_draft-AccountERC7579.sol.patch +25 -0
  553. package/lib/openzeppelin-contracts/fv/diff/token_ERC721_ERC721.sol.patch +11 -0
  554. package/lib/openzeppelin-contracts/fv/harnesses/AccessControlDefaultAdminRulesHarness.sol +46 -0
  555. package/lib/openzeppelin-contracts/fv/harnesses/AccessControlHarness.sol +6 -0
  556. package/lib/openzeppelin-contracts/fv/harnesses/AccessManagedHarness.sol +36 -0
  557. package/lib/openzeppelin-contracts/fv/harnesses/AccessManagerHarness.sol +116 -0
  558. package/lib/openzeppelin-contracts/fv/harnesses/AccountHarness.sol +60 -0
  559. package/lib/openzeppelin-contracts/fv/harnesses/DoubleEndedQueueHarness.sol +58 -0
  560. package/lib/openzeppelin-contracts/fv/harnesses/ERC20FlashMintHarness.sol +36 -0
  561. package/lib/openzeppelin-contracts/fv/harnesses/ERC20PermitHarness.sol +16 -0
  562. package/lib/openzeppelin-contracts/fv/harnesses/ERC20WrapperHarness.sol +22 -0
  563. package/lib/openzeppelin-contracts/fv/harnesses/ERC3156FlashBorrowerHarness.sol +13 -0
  564. package/lib/openzeppelin-contracts/fv/harnesses/ERC721Harness.sol +37 -0
  565. package/lib/openzeppelin-contracts/fv/harnesses/ERC721ReceiverHarness.sol +11 -0
  566. package/lib/openzeppelin-contracts/fv/harnesses/EnumerableMapHarness.sol +55 -0
  567. package/lib/openzeppelin-contracts/fv/harnesses/EnumerableSetHarness.sol +35 -0
  568. package/lib/openzeppelin-contracts/fv/harnesses/InitializableHarness.sol +23 -0
  569. package/lib/openzeppelin-contracts/fv/harnesses/NoncesHarness.sol +14 -0
  570. package/lib/openzeppelin-contracts/fv/harnesses/Ownable2StepHarness.sol +10 -0
  571. package/lib/openzeppelin-contracts/fv/harnesses/OwnableHarness.sol +10 -0
  572. package/lib/openzeppelin-contracts/fv/harnesses/PausableHarness.sol +18 -0
  573. package/lib/openzeppelin-contracts/fv/harnesses/TimelockControllerHarness.sol +13 -0
  574. package/lib/openzeppelin-contracts/fv/reports/2021-10.pdf +0 -0
  575. package/lib/openzeppelin-contracts/fv/reports/2022-03.pdf +0 -0
  576. package/lib/openzeppelin-contracts/fv/reports/2022-05.pdf +0 -0
  577. package/lib/openzeppelin-contracts/fv/run.js +68 -0
  578. package/lib/openzeppelin-contracts/fv/specs/AccessControl.conf +8 -0
  579. package/lib/openzeppelin-contracts/fv/specs/AccessControl.spec +119 -0
  580. package/lib/openzeppelin-contracts/fv/specs/AccessControlDefaultAdminRules.conf +8 -0
  581. package/lib/openzeppelin-contracts/fv/specs/AccessControlDefaultAdminRules.spec +467 -0
  582. package/lib/openzeppelin-contracts/fv/specs/AccessManaged.conf +14 -0
  583. package/lib/openzeppelin-contracts/fv/specs/AccessManaged.spec +49 -0
  584. package/lib/openzeppelin-contracts/fv/specs/AccessManager.conf +10 -0
  585. package/lib/openzeppelin-contracts/fv/specs/AccessManager.spec +837 -0
  586. package/lib/openzeppelin-contracts/fv/specs/Account.conf +9 -0
  587. package/lib/openzeppelin-contracts/fv/specs/Account.spec +490 -0
  588. package/lib/openzeppelin-contracts/fv/specs/DoubleEndedQueue.conf +8 -0
  589. package/lib/openzeppelin-contracts/fv/specs/DoubleEndedQueue.spec +300 -0
  590. package/lib/openzeppelin-contracts/fv/specs/ERC20.conf +9 -0
  591. package/lib/openzeppelin-contracts/fv/specs/ERC20.spec +352 -0
  592. package/lib/openzeppelin-contracts/fv/specs/ERC20FlashMint.conf +10 -0
  593. package/lib/openzeppelin-contracts/fv/specs/ERC20FlashMint.spec +55 -0
  594. package/lib/openzeppelin-contracts/fv/specs/ERC20Wrapper.conf +13 -0
  595. package/lib/openzeppelin-contracts/fv/specs/ERC20Wrapper.spec +226 -0
  596. package/lib/openzeppelin-contracts/fv/specs/ERC721.conf +10 -0
  597. package/lib/openzeppelin-contracts/fv/specs/ERC721.spec +695 -0
  598. package/lib/openzeppelin-contracts/fv/specs/EnumerableMap.conf +8 -0
  599. package/lib/openzeppelin-contracts/fv/specs/EnumerableMap.spec +364 -0
  600. package/lib/openzeppelin-contracts/fv/specs/EnumerableSet.conf +8 -0
  601. package/lib/openzeppelin-contracts/fv/specs/EnumerableSet.spec +272 -0
  602. package/lib/openzeppelin-contracts/fv/specs/Initializable.conf +8 -0
  603. package/lib/openzeppelin-contracts/fv/specs/Initializable.spec +176 -0
  604. package/lib/openzeppelin-contracts/fv/specs/Nonces.conf +8 -0
  605. package/lib/openzeppelin-contracts/fv/specs/Nonces.spec +92 -0
  606. package/lib/openzeppelin-contracts/fv/specs/Ownable.conf +8 -0
  607. package/lib/openzeppelin-contracts/fv/specs/Ownable.spec +77 -0
  608. package/lib/openzeppelin-contracts/fv/specs/Ownable2Step.conf +8 -0
  609. package/lib/openzeppelin-contracts/fv/specs/Ownable2Step.spec +108 -0
  610. package/lib/openzeppelin-contracts/fv/specs/Pausable.conf +8 -0
  611. package/lib/openzeppelin-contracts/fv/specs/Pausable.spec +96 -0
  612. package/lib/openzeppelin-contracts/fv/specs/TimelockController.conf +10 -0
  613. package/lib/openzeppelin-contracts/fv/specs/TimelockController.spec +299 -0
  614. package/lib/openzeppelin-contracts/fv/specs/helpers/helpers.spec +13 -0
  615. package/lib/openzeppelin-contracts/fv/specs/methods/IAccessControl.spec +8 -0
  616. package/lib/openzeppelin-contracts/fv/specs/methods/IAccessControlDefaultAdminRules.spec +36 -0
  617. package/lib/openzeppelin-contracts/fv/specs/methods/IAccessManaged.spec +5 -0
  618. package/lib/openzeppelin-contracts/fv/specs/methods/IAccessManager.spec +33 -0
  619. package/lib/openzeppelin-contracts/fv/specs/methods/IAccount.spec +34 -0
  620. package/lib/openzeppelin-contracts/fv/specs/methods/IERC20.spec +11 -0
  621. package/lib/openzeppelin-contracts/fv/specs/methods/IERC2612.spec +5 -0
  622. package/lib/openzeppelin-contracts/fv/specs/methods/IERC3156FlashBorrower.spec +3 -0
  623. package/lib/openzeppelin-contracts/fv/specs/methods/IERC3156FlashLender.spec +5 -0
  624. package/lib/openzeppelin-contracts/fv/specs/methods/IERC5313.spec +3 -0
  625. package/lib/openzeppelin-contracts/fv/specs/methods/IERC721.spec +17 -0
  626. package/lib/openzeppelin-contracts/fv/specs/methods/IERC721Receiver.spec +3 -0
  627. package/lib/openzeppelin-contracts/fv/specs/methods/IOwnable.spec +5 -0
  628. package/lib/openzeppelin-contracts/fv/specs/methods/IOwnable2Step.spec +7 -0
  629. package/lib/openzeppelin-contracts/fv-requirements.txt +4 -0
  630. package/lib/openzeppelin-contracts/hardhat/async-test-sanity.js +10 -0
  631. package/lib/openzeppelin-contracts/hardhat/env-artifacts.js +29 -0
  632. package/lib/openzeppelin-contracts/hardhat/ignore-unreachable-warnings.js +45 -0
  633. package/lib/openzeppelin-contracts/hardhat/remappings.js +18 -0
  634. package/lib/openzeppelin-contracts/hardhat/skip-foundry-tests.js +6 -0
  635. package/lib/openzeppelin-contracts/hardhat/task-test-get-files.js +25 -0
  636. package/lib/openzeppelin-contracts/hardhat.config.js +124 -0
  637. package/lib/openzeppelin-contracts/logo.svg +15 -0
  638. package/lib/openzeppelin-contracts/netlify.toml +3 -0
  639. package/lib/openzeppelin-contracts/package-lock.json +11140 -0
  640. package/lib/openzeppelin-contracts/package.json +108 -0
  641. package/lib/openzeppelin-contracts/remappings.txt +1 -0
  642. package/lib/openzeppelin-contracts/renovate.json +4 -0
  643. package/lib/openzeppelin-contracts/scripts/checks/compare-layout.js +28 -0
  644. package/lib/openzeppelin-contracts/scripts/checks/compareGasReports.js +249 -0
  645. package/lib/openzeppelin-contracts/scripts/checks/coverage.sh +24 -0
  646. package/lib/openzeppelin-contracts/scripts/checks/extract-layout.js +39 -0
  647. package/lib/openzeppelin-contracts/scripts/checks/generation.sh +6 -0
  648. package/lib/openzeppelin-contracts/scripts/checks/inheritance-ordering.js +55 -0
  649. package/lib/openzeppelin-contracts/scripts/checks/pragma-validity.js +45 -0
  650. package/lib/openzeppelin-contracts/scripts/fetch-common-contracts.js +50 -0
  651. package/lib/openzeppelin-contracts/scripts/gen-nav.js +81 -0
  652. package/lib/openzeppelin-contracts/scripts/generate/format-lines.js +16 -0
  653. package/lib/openzeppelin-contracts/scripts/generate/helpers/sanitize.js +5 -0
  654. package/lib/openzeppelin-contracts/scripts/generate/run.js +61 -0
  655. package/lib/openzeppelin-contracts/scripts/generate/templates/Arrays.js +505 -0
  656. package/lib/openzeppelin-contracts/scripts/generate/templates/Arrays.opts.js +9 -0
  657. package/lib/openzeppelin-contracts/scripts/generate/templates/Checkpoints.js +242 -0
  658. package/lib/openzeppelin-contracts/scripts/generate/templates/Checkpoints.opts.js +18 -0
  659. package/lib/openzeppelin-contracts/scripts/generate/templates/Checkpoints.t.js +141 -0
  660. package/lib/openzeppelin-contracts/scripts/generate/templates/Enumerable.opts.js +56 -0
  661. package/lib/openzeppelin-contracts/scripts/generate/templates/EnumerableMap.js +464 -0
  662. package/lib/openzeppelin-contracts/scripts/generate/templates/EnumerableSet.js +470 -0
  663. package/lib/openzeppelin-contracts/scripts/generate/templates/MerkleProof.js +186 -0
  664. package/lib/openzeppelin-contracts/scripts/generate/templates/MerkleProof.opts.js +11 -0
  665. package/lib/openzeppelin-contracts/scripts/generate/templates/Packing.js +92 -0
  666. package/lib/openzeppelin-contracts/scripts/generate/templates/Packing.opts.js +3 -0
  667. package/lib/openzeppelin-contracts/scripts/generate/templates/Packing.t.js +48 -0
  668. package/lib/openzeppelin-contracts/scripts/generate/templates/SafeCast.js +136 -0
  669. package/lib/openzeppelin-contracts/scripts/generate/templates/Slot.opts.js +15 -0
  670. package/lib/openzeppelin-contracts/scripts/generate/templates/SlotDerivation.js +119 -0
  671. package/lib/openzeppelin-contracts/scripts/generate/templates/SlotDerivation.t.js +127 -0
  672. package/lib/openzeppelin-contracts/scripts/generate/templates/StorageSlot.js +77 -0
  673. package/lib/openzeppelin-contracts/scripts/generate/templates/StorageSlotMock.js +57 -0
  674. package/lib/openzeppelin-contracts/scripts/generate/templates/TransientSlot.js +80 -0
  675. package/lib/openzeppelin-contracts/scripts/generate/templates/TransientSlotMock.js +35 -0
  676. package/lib/openzeppelin-contracts/scripts/generate/templates/conversion.js +34 -0
  677. package/lib/openzeppelin-contracts/scripts/get-contracts-metadata.js +55 -0
  678. package/lib/openzeppelin-contracts/scripts/git-user-config.sh +6 -0
  679. package/lib/openzeppelin-contracts/scripts/helpers.js +7 -0
  680. package/lib/openzeppelin-contracts/scripts/minimize-pragma.js +140 -0
  681. package/lib/openzeppelin-contracts/scripts/prepack.sh +23 -0
  682. package/lib/openzeppelin-contracts/scripts/prepare-docs.sh +26 -0
  683. package/lib/openzeppelin-contracts/scripts/release/format-changelog.js +33 -0
  684. package/lib/openzeppelin-contracts/scripts/release/synchronize-versions.js +15 -0
  685. package/lib/openzeppelin-contracts/scripts/release/update-comment.js +34 -0
  686. package/lib/openzeppelin-contracts/scripts/release/version.sh +11 -0
  687. package/lib/openzeppelin-contracts/scripts/release/workflow/check-upgradeable.sh +27 -0
  688. package/lib/openzeppelin-contracts/scripts/release/workflow/exit-prerelease.sh +8 -0
  689. package/lib/openzeppelin-contracts/scripts/release/workflow/github-release.js +48 -0
  690. package/lib/openzeppelin-contracts/scripts/release/workflow/integrity-check.sh +20 -0
  691. package/lib/openzeppelin-contracts/scripts/release/workflow/pack.sh +26 -0
  692. package/lib/openzeppelin-contracts/scripts/release/workflow/publish.sh +26 -0
  693. package/lib/openzeppelin-contracts/scripts/release/workflow/rerun.js +7 -0
  694. package/lib/openzeppelin-contracts/scripts/release/workflow/set-changesets-pr-title.js +17 -0
  695. package/lib/openzeppelin-contracts/scripts/release/workflow/start.sh +35 -0
  696. package/lib/openzeppelin-contracts/scripts/release/workflow/state.js +112 -0
  697. package/lib/openzeppelin-contracts/scripts/remove-ignored-artifacts.js +45 -0
  698. package/lib/openzeppelin-contracts/scripts/set-max-old-space-size.sh +10 -0
  699. package/lib/openzeppelin-contracts/scripts/solc-versions.js +15 -0
  700. package/lib/openzeppelin-contracts/scripts/solhint-custom/index.js +118 -0
  701. package/lib/openzeppelin-contracts/scripts/solhint-custom/package.json +8 -0
  702. package/lib/openzeppelin-contracts/scripts/update-docs-branch.js +65 -0
  703. package/lib/openzeppelin-contracts/scripts/upgradeable/README.md +21 -0
  704. package/lib/openzeppelin-contracts/scripts/upgradeable/alias/Initializable.sol +5 -0
  705. package/lib/openzeppelin-contracts/scripts/upgradeable/alias/UUPSUpgradeable.sol +5 -0
  706. package/lib/openzeppelin-contracts/scripts/upgradeable/patch-apply.sh +19 -0
  707. package/lib/openzeppelin-contracts/scripts/upgradeable/patch-save.sh +18 -0
  708. package/lib/openzeppelin-contracts/scripts/upgradeable/transpile-onto.sh +54 -0
  709. package/lib/openzeppelin-contracts/scripts/upgradeable/transpile.sh +50 -0
  710. package/lib/openzeppelin-contracts/scripts/upgradeable/upgradeable.patch +390 -0
  711. package/lib/openzeppelin-contracts/slither.config.json +4 -0
  712. package/lib/openzeppelin-contracts/solhint.config.js +29 -0
  713. package/lib/openzeppelin-contracts/test/TESTING.md +3 -0
  714. package/lib/openzeppelin-contracts/test/access/AccessControl.behavior.js +874 -0
  715. package/lib/openzeppelin-contracts/test/access/AccessControl.test.js +19 -0
  716. package/lib/openzeppelin-contracts/test/access/Ownable.test.js +79 -0
  717. package/lib/openzeppelin-contracts/test/access/Ownable2Step.test.js +102 -0
  718. package/lib/openzeppelin-contracts/test/access/extensions/AccessControlDefaultAdminRules.test.js +32 -0
  719. package/lib/openzeppelin-contracts/test/access/extensions/AccessControlEnumerable.test.js +24 -0
  720. package/lib/openzeppelin-contracts/test/access/manager/AccessManaged.test.js +146 -0
  721. package/lib/openzeppelin-contracts/test/access/manager/AccessManager.behavior.js +257 -0
  722. package/lib/openzeppelin-contracts/test/access/manager/AccessManager.predicate.js +456 -0
  723. package/lib/openzeppelin-contracts/test/access/manager/AccessManager.test.js +2489 -0
  724. package/lib/openzeppelin-contracts/test/access/manager/AuthorityUtils.test.js +112 -0
  725. package/lib/openzeppelin-contracts/test/account/Account.behavior.js +144 -0
  726. package/lib/openzeppelin-contracts/test/account/Account.test.js +48 -0
  727. package/lib/openzeppelin-contracts/test/account/AccountECDSA.test.js +52 -0
  728. package/lib/openzeppelin-contracts/test/account/AccountEIP7702.t.sol +116 -0
  729. package/lib/openzeppelin-contracts/test/account/AccountEIP7702.test.js +52 -0
  730. package/lib/openzeppelin-contracts/test/account/AccountERC7913.test.js +138 -0
  731. package/lib/openzeppelin-contracts/test/account/AccountMultiSigner.test.js +326 -0
  732. package/lib/openzeppelin-contracts/test/account/AccountMultiSignerWeighted.test.js +312 -0
  733. package/lib/openzeppelin-contracts/test/account/AccountP256.test.js +58 -0
  734. package/lib/openzeppelin-contracts/test/account/AccountRSA.test.js +58 -0
  735. package/lib/openzeppelin-contracts/test/account/AccountWebAuthn.test.js +88 -0
  736. package/lib/openzeppelin-contracts/test/account/examples/AccountEIP7702WithModulesMock.test.js +99 -0
  737. package/lib/openzeppelin-contracts/test/account/extensions/AccountERC7579.behavior.js +621 -0
  738. package/lib/openzeppelin-contracts/test/account/extensions/AccountERC7579.test.js +60 -0
  739. package/lib/openzeppelin-contracts/test/account/extensions/AccountERC7579Hooked.test.js +60 -0
  740. package/lib/openzeppelin-contracts/test/account/extensions/ERC7821.behavior.js +145 -0
  741. package/lib/openzeppelin-contracts/test/account/utils/EIP7702Utils.test.js +53 -0
  742. package/lib/openzeppelin-contracts/test/account/utils/draft-ERC4337Utils.test.js +594 -0
  743. package/lib/openzeppelin-contracts/test/account/utils/draft-ERC7579Utils.t.sol +434 -0
  744. package/lib/openzeppelin-contracts/test/account/utils/draft-ERC7579Utils.test.js +399 -0
  745. package/lib/openzeppelin-contracts/test/crosschain/BridgeERC20.behavior.js +163 -0
  746. package/lib/openzeppelin-contracts/test/crosschain/BridgeERC20.test.js +46 -0
  747. package/lib/openzeppelin-contracts/test/crosschain/ERC7786Recipient.test.js +73 -0
  748. package/lib/openzeppelin-contracts/test/finance/VestingWallet.behavior.js +87 -0
  749. package/lib/openzeppelin-contracts/test/finance/VestingWallet.test.js +65 -0
  750. package/lib/openzeppelin-contracts/test/finance/VestingWalletCliff.test.js +70 -0
  751. package/lib/openzeppelin-contracts/test/governance/Governor.t.sol +59 -0
  752. package/lib/openzeppelin-contracts/test/governance/Governor.test.js +980 -0
  753. package/lib/openzeppelin-contracts/test/governance/TimelockController.test.js +1279 -0
  754. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorCountingFractional.test.js +248 -0
  755. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorCountingOverridable.test.js +346 -0
  756. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorERC721.test.js +131 -0
  757. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorNoncesKeyed.test.js +243 -0
  758. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorPreventLateQuorum.test.js +185 -0
  759. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorProposalGuardian.test.js +132 -0
  760. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorSequentialProposalId.test.js +202 -0
  761. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorStorage.test.js +175 -0
  762. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorSuperQuorum.test.js +168 -0
  763. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorSuperQuorumGreaterThanQuorum.t.sol +83 -0
  764. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorTimelockAccess.test.js +864 -0
  765. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorTimelockCompound.test.js +448 -0
  766. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorTimelockControl.test.js +504 -0
  767. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorVotesQuorumFraction.test.js +165 -0
  768. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorVotesSuperQuorumFraction.test.js +160 -0
  769. package/lib/openzeppelin-contracts/test/governance/extensions/GovernorWithParams.test.js +245 -0
  770. package/lib/openzeppelin-contracts/test/governance/utils/ERC6372.behavior.js +28 -0
  771. package/lib/openzeppelin-contracts/test/governance/utils/Votes.behavior.js +325 -0
  772. package/lib/openzeppelin-contracts/test/governance/utils/Votes.test.js +102 -0
  773. package/lib/openzeppelin-contracts/test/governance/utils/VotesExtended.test.js +152 -0
  774. package/lib/openzeppelin-contracts/test/helpers/access-manager.js +85 -0
  775. package/lib/openzeppelin-contracts/test/helpers/account.js +16 -0
  776. package/lib/openzeppelin-contracts/test/helpers/chains.js +56 -0
  777. package/lib/openzeppelin-contracts/test/helpers/constants.js +7 -0
  778. package/lib/openzeppelin-contracts/test/helpers/deploy.js +14 -0
  779. package/lib/openzeppelin-contracts/test/helpers/eip712-types.js +61 -0
  780. package/lib/openzeppelin-contracts/test/helpers/eip712.js +45 -0
  781. package/lib/openzeppelin-contracts/test/helpers/enums.js +15 -0
  782. package/lib/openzeppelin-contracts/test/helpers/erc4337.js +244 -0
  783. package/lib/openzeppelin-contracts/test/helpers/erc7579.js +58 -0
  784. package/lib/openzeppelin-contracts/test/helpers/erc7739.js +118 -0
  785. package/lib/openzeppelin-contracts/test/helpers/governance.js +218 -0
  786. package/lib/openzeppelin-contracts/test/helpers/iterate.js +41 -0
  787. package/lib/openzeppelin-contracts/test/helpers/math.js +33 -0
  788. package/lib/openzeppelin-contracts/test/helpers/methods.js +14 -0
  789. package/lib/openzeppelin-contracts/test/helpers/precompiles.js +12 -0
  790. package/lib/openzeppelin-contracts/test/helpers/random.js +26 -0
  791. package/lib/openzeppelin-contracts/test/helpers/signers.js +222 -0
  792. package/lib/openzeppelin-contracts/test/helpers/storage.js +48 -0
  793. package/lib/openzeppelin-contracts/test/helpers/strings.js +5 -0
  794. package/lib/openzeppelin-contracts/test/helpers/time.js +33 -0
  795. package/lib/openzeppelin-contracts/test/helpers/trie.js +79 -0
  796. package/lib/openzeppelin-contracts/test/helpers/txpool.js +28 -0
  797. package/lib/openzeppelin-contracts/test/metatx/ERC2771Context.test.js +109 -0
  798. package/lib/openzeppelin-contracts/test/metatx/ERC2771Forwarder.t.sol +279 -0
  799. package/lib/openzeppelin-contracts/test/metatx/ERC2771Forwarder.test.js +384 -0
  800. package/lib/openzeppelin-contracts/test/proxy/Clones.behaviour.js +160 -0
  801. package/lib/openzeppelin-contracts/test/proxy/Clones.t.sol +91 -0
  802. package/lib/openzeppelin-contracts/test/proxy/Clones.test.js +177 -0
  803. package/lib/openzeppelin-contracts/test/proxy/ERC1967/ERC1967Proxy.test.js +36 -0
  804. package/lib/openzeppelin-contracts/test/proxy/ERC1967/ERC1967Utils.test.js +162 -0
  805. package/lib/openzeppelin-contracts/test/proxy/Proxy.behaviour.js +198 -0
  806. package/lib/openzeppelin-contracts/test/proxy/beacon/BeaconProxy.test.js +141 -0
  807. package/lib/openzeppelin-contracts/test/proxy/beacon/UpgradeableBeacon.test.js +55 -0
  808. package/lib/openzeppelin-contracts/test/proxy/transparent/ProxyAdmin.test.js +82 -0
  809. package/lib/openzeppelin-contracts/test/proxy/transparent/TransparentUpgradeableProxy.behaviour.js +367 -0
  810. package/lib/openzeppelin-contracts/test/proxy/transparent/TransparentUpgradeableProxy.test.js +28 -0
  811. package/lib/openzeppelin-contracts/test/proxy/utils/Initializable.test.js +216 -0
  812. package/lib/openzeppelin-contracts/test/proxy/utils/UUPSUpgradeable.test.js +120 -0
  813. package/lib/openzeppelin-contracts/test/sanity.test.js +27 -0
  814. package/lib/openzeppelin-contracts/test/token/ERC1155/ERC1155.behavior.js +865 -0
  815. package/lib/openzeppelin-contracts/test/token/ERC1155/ERC1155.test.js +258 -0
  816. package/lib/openzeppelin-contracts/test/token/ERC1155/extensions/ERC1155Burnable.test.js +66 -0
  817. package/lib/openzeppelin-contracts/test/token/ERC1155/extensions/ERC1155Pausable.test.js +105 -0
  818. package/lib/openzeppelin-contracts/test/token/ERC1155/extensions/ERC1155Supply.test.js +119 -0
  819. package/lib/openzeppelin-contracts/test/token/ERC1155/extensions/ERC1155URIStorage.test.js +70 -0
  820. package/lib/openzeppelin-contracts/test/token/ERC1155/utils/ERC1155Holder.test.js +56 -0
  821. package/lib/openzeppelin-contracts/test/token/ERC1155/utils/ERC1155Utils.test.js +299 -0
  822. package/lib/openzeppelin-contracts/test/token/ERC20/ERC20.behavior.js +269 -0
  823. package/lib/openzeppelin-contracts/test/token/ERC20/ERC20.test.js +199 -0
  824. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC1363.test.js +370 -0
  825. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20Burnable.test.js +105 -0
  826. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20Capped.test.js +55 -0
  827. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20Crosschain.test.js +83 -0
  828. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20FlashMint.test.js +164 -0
  829. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20Pausable.test.js +129 -0
  830. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20Permit.test.js +109 -0
  831. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20Votes.test.js +546 -0
  832. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC20Wrapper.test.js +203 -0
  833. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC4626.t.sol +41 -0
  834. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/ERC4626.test.js +888 -0
  835. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/draft-ERC20Bridgeable.test.js +89 -0
  836. package/lib/openzeppelin-contracts/test/token/ERC20/extensions/draft-ERC20TemporaryApproval.test.js +142 -0
  837. package/lib/openzeppelin-contracts/test/token/ERC20/utils/SafeERC20.test.js +463 -0
  838. package/lib/openzeppelin-contracts/test/token/ERC6909/ERC6909.behavior.js +216 -0
  839. package/lib/openzeppelin-contracts/test/token/ERC6909/ERC6909.test.js +104 -0
  840. package/lib/openzeppelin-contracts/test/token/ERC6909/extensions/ERC6909ContentURI.test.js +52 -0
  841. package/lib/openzeppelin-contracts/test/token/ERC6909/extensions/ERC6909Metadata.test.js +62 -0
  842. package/lib/openzeppelin-contracts/test/token/ERC6909/extensions/ERC6909TokenSupply.test.js +56 -0
  843. package/lib/openzeppelin-contracts/test/token/ERC721/ERC721.behavior.js +954 -0
  844. package/lib/openzeppelin-contracts/test/token/ERC721/ERC721.test.js +23 -0
  845. package/lib/openzeppelin-contracts/test/token/ERC721/ERC721Enumerable.test.js +28 -0
  846. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721Burnable.test.js +77 -0
  847. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721Consecutive.t.sol +187 -0
  848. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721Consecutive.test.js +228 -0
  849. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721Pausable.test.js +81 -0
  850. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721Royalty.test.js +57 -0
  851. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721URIStorage.test.js +134 -0
  852. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721Votes.test.js +194 -0
  853. package/lib/openzeppelin-contracts/test/token/ERC721/extensions/ERC721Wrapper.test.js +201 -0
  854. package/lib/openzeppelin-contracts/test/token/ERC721/utils/ERC721Holder.test.js +20 -0
  855. package/lib/openzeppelin-contracts/test/token/ERC721/utils/ERC721Utils.test.js +94 -0
  856. package/lib/openzeppelin-contracts/test/token/common/ERC2981.behavior.js +152 -0
  857. package/lib/openzeppelin-contracts/test/utils/Address.test.js +332 -0
  858. package/lib/openzeppelin-contracts/test/utils/Arrays.t.sol +416 -0
  859. package/lib/openzeppelin-contracts/test/utils/Arrays.test.js +284 -0
  860. package/lib/openzeppelin-contracts/test/utils/Base58.t.sol +24 -0
  861. package/lib/openzeppelin-contracts/test/utils/Base58.test.js +65 -0
  862. package/lib/openzeppelin-contracts/test/utils/Base64.t.sol +36 -0
  863. package/lib/openzeppelin-contracts/test/utils/Base64.test.js +79 -0
  864. package/lib/openzeppelin-contracts/test/utils/Blockhash.t.sol +101 -0
  865. package/lib/openzeppelin-contracts/test/utils/Blockhash.test.js +59 -0
  866. package/lib/openzeppelin-contracts/test/utils/Bytes.t.sol +322 -0
  867. package/lib/openzeppelin-contracts/test/utils/Bytes.test.js +371 -0
  868. package/lib/openzeppelin-contracts/test/utils/CAIP.test.js +56 -0
  869. package/lib/openzeppelin-contracts/test/utils/Calldata.test.js +22 -0
  870. package/lib/openzeppelin-contracts/test/utils/Context.behavior.js +48 -0
  871. package/lib/openzeppelin-contracts/test/utils/Context.test.js +18 -0
  872. package/lib/openzeppelin-contracts/test/utils/Create2.t.sol +17 -0
  873. package/lib/openzeppelin-contracts/test/utils/Create2.test.js +190 -0
  874. package/lib/openzeppelin-contracts/test/utils/LowLevelCall.test.js +257 -0
  875. package/lib/openzeppelin-contracts/test/utils/Memory.t.sol +63 -0
  876. package/lib/openzeppelin-contracts/test/utils/Memory.test.js +106 -0
  877. package/lib/openzeppelin-contracts/test/utils/Multicall.test.js +72 -0
  878. package/lib/openzeppelin-contracts/test/utils/Nonces.behavior.js +189 -0
  879. package/lib/openzeppelin-contracts/test/utils/Nonces.test.js +16 -0
  880. package/lib/openzeppelin-contracts/test/utils/NoncesKeyed.t.sol +51 -0
  881. package/lib/openzeppelin-contracts/test/utils/NoncesKeyed.test.js +17 -0
  882. package/lib/openzeppelin-contracts/test/utils/Packing.t.sol +993 -0
  883. package/lib/openzeppelin-contracts/test/utils/Packing.test.js +70 -0
  884. package/lib/openzeppelin-contracts/test/utils/Panic.test.js +37 -0
  885. package/lib/openzeppelin-contracts/test/utils/Pausable.test.js +90 -0
  886. package/lib/openzeppelin-contracts/test/utils/RLP.t.sol +144 -0
  887. package/lib/openzeppelin-contracts/test/utils/RLP.test.js +224 -0
  888. package/lib/openzeppelin-contracts/test/utils/ReentrancyGuard.test.js +58 -0
  889. package/lib/openzeppelin-contracts/test/utils/RelayedCall.test.js +217 -0
  890. package/lib/openzeppelin-contracts/test/utils/ShortStrings.t.sol +109 -0
  891. package/lib/openzeppelin-contracts/test/utils/ShortStrings.test.js +64 -0
  892. package/lib/openzeppelin-contracts/test/utils/SlotDerivation.t.sol +248 -0
  893. package/lib/openzeppelin-contracts/test/utils/SlotDerivation.test.js +58 -0
  894. package/lib/openzeppelin-contracts/test/utils/StorageSlot.test.js +73 -0
  895. package/lib/openzeppelin-contracts/test/utils/Strings.t.sol +50 -0
  896. package/lib/openzeppelin-contracts/test/utils/Strings.test.js +360 -0
  897. package/lib/openzeppelin-contracts/test/utils/TransientSlot.test.js +59 -0
  898. package/lib/openzeppelin-contracts/test/utils/cryptography/ECDSA.test.js +322 -0
  899. package/lib/openzeppelin-contracts/test/utils/cryptography/EIP712.test.js +105 -0
  900. package/lib/openzeppelin-contracts/test/utils/cryptography/ERC1271.behavior.js +111 -0
  901. package/lib/openzeppelin-contracts/test/utils/cryptography/ERC7739.test.js +42 -0
  902. package/lib/openzeppelin-contracts/test/utils/cryptography/ERC7739Utils.test.js +203 -0
  903. package/lib/openzeppelin-contracts/test/utils/cryptography/MerkleProof.test.js +216 -0
  904. package/lib/openzeppelin-contracts/test/utils/cryptography/MessageHashUtils.t.sol +33 -0
  905. package/lib/openzeppelin-contracts/test/utils/cryptography/MessageHashUtils.test.js +149 -0
  906. package/lib/openzeppelin-contracts/test/utils/cryptography/P256.t.sol +45 -0
  907. package/lib/openzeppelin-contracts/test/utils/cryptography/P256.test.js +182 -0
  908. package/lib/openzeppelin-contracts/test/utils/cryptography/RSA.helper.js +17 -0
  909. package/lib/openzeppelin-contracts/test/utils/cryptography/RSA.test.js +102 -0
  910. package/lib/openzeppelin-contracts/test/utils/cryptography/SigVer15_186-3.rsp +3850 -0
  911. package/lib/openzeppelin-contracts/test/utils/cryptography/SignatureChecker.test.js +427 -0
  912. package/lib/openzeppelin-contracts/test/utils/cryptography/TrieProof.test.js +659 -0
  913. package/lib/openzeppelin-contracts/test/utils/cryptography/WebAuthn.t.sol +298 -0
  914. package/lib/openzeppelin-contracts/test/utils/cryptography/ecdsa_secp256r1_sha256_p1363_test.json +3719 -0
  915. package/lib/openzeppelin-contracts/test/utils/draft-InteroperableAddress.t.sol +99 -0
  916. package/lib/openzeppelin-contracts/test/utils/draft-InteroperableAddress.test.js +170 -0
  917. package/lib/openzeppelin-contracts/test/utils/introspection/ERC165.test.js +18 -0
  918. package/lib/openzeppelin-contracts/test/utils/introspection/ERC165Checker.test.js +272 -0
  919. package/lib/openzeppelin-contracts/test/utils/introspection/SupportsInterface.behavior.js +169 -0
  920. package/lib/openzeppelin-contracts/test/utils/math/Math.t.sol +370 -0
  921. package/lib/openzeppelin-contracts/test/utils/math/Math.test.js +746 -0
  922. package/lib/openzeppelin-contracts/test/utils/math/SafeCast.test.js +159 -0
  923. package/lib/openzeppelin-contracts/test/utils/math/SignedMath.t.sol +81 -0
  924. package/lib/openzeppelin-contracts/test/utils/math/SignedMath.test.js +53 -0
  925. package/lib/openzeppelin-contracts/test/utils/structs/Accumulators.t.sol +35 -0
  926. package/lib/openzeppelin-contracts/test/utils/structs/BitMap.test.js +149 -0
  927. package/lib/openzeppelin-contracts/test/utils/structs/Checkpoints.t.sol +440 -0
  928. package/lib/openzeppelin-contracts/test/utils/structs/Checkpoints.test.js +147 -0
  929. package/lib/openzeppelin-contracts/test/utils/structs/CircularBuffer.test.js +83 -0
  930. package/lib/openzeppelin-contracts/test/utils/structs/DoubleEndedQueue.test.js +144 -0
  931. package/lib/openzeppelin-contracts/test/utils/structs/EnumerableMap.behavior.js +214 -0
  932. package/lib/openzeppelin-contracts/test/utils/structs/EnumerableMap.test.js +83 -0
  933. package/lib/openzeppelin-contracts/test/utils/structs/EnumerableSet.behavior.js +175 -0
  934. package/lib/openzeppelin-contracts/test/utils/structs/EnumerableSet.test.js +66 -0
  935. package/lib/openzeppelin-contracts/test/utils/structs/Heap.t.sol +74 -0
  936. package/lib/openzeppelin-contracts/test/utils/structs/Heap.test.js +113 -0
  937. package/lib/openzeppelin-contracts/test/utils/structs/MerkleTree.test.js +180 -0
  938. package/lib/openzeppelin-contracts/test/utils/types/Time.test.js +135 -0
  939. package/lucro.txt +1 -0
  940. package/out/Base.sol/CommonBase.json +1 -0
  941. package/out/Base.sol/ScriptBase.json +1 -0
  942. package/out/Base.sol/TestBase.json +1 -0
  943. package/out/Context.sol/Context.json +1 -0
  944. package/out/Counter.s.sol/CounterScript.json +1 -0
  945. package/out/Counter.sol/Counter.json +1 -0
  946. package/out/Counter.t.sol/CounterTest.json +1 -0
  947. package/out/ERC20.sol/ERC20.json +1 -0
  948. package/out/GbitToken.sol/GbitToken.json +1 -0
  949. package/out/Guestbook.sol/Guestbook.json +1 -0
  950. package/out/IERC20.sol/IERC20.json +1 -0
  951. package/out/IERC20Metadata.sol/IERC20Metadata.json +1 -0
  952. package/out/IMulticall3.sol/IMulticall3.json +1 -0
  953. package/out/Script.sol/Script.json +1 -0
  954. package/out/StdAssertions.sol/StdAssertions.json +1 -0
  955. package/out/StdChains.sol/StdChains.json +1 -0
  956. package/out/StdCheats.sol/StdCheats.json +1 -0
  957. package/out/StdCheats.sol/StdCheatsSafe.json +1 -0
  958. package/out/StdConstants.sol/StdConstants.json +1 -0
  959. package/out/StdError.sol/stdError.json +1 -0
  960. package/out/StdInvariant.sol/StdInvariant.json +1 -0
  961. package/out/StdJson.sol/stdJson.json +1 -0
  962. package/out/StdMath.sol/stdMath.json +1 -0
  963. package/out/StdStorage.sol/stdStorage.json +1 -0
  964. package/out/StdStorage.sol/stdStorageSafe.json +1 -0
  965. package/out/StdStyle.sol/StdStyle.json +1 -0
  966. package/out/StdToml.sol/stdToml.json +1 -0
  967. package/out/StdUtils.sol/StdUtils.json +1 -0
  968. package/out/Test.sol/Test.json +1 -0
  969. package/out/Vm.sol/Vm.json +1 -0
  970. package/out/Vm.sol/VmSafe.json +1 -0
  971. package/out/Web3HubCore.sol/Web3HubCore.json +1 -0
  972. package/out/build-info/8a1d781106536b7b.json +1 -0
  973. package/out/build-info/aac4797350a36a99.json +1 -0
  974. package/out/build-info/c34d5a7881e6beba.json +1 -0
  975. package/out/build-info/ce38d811b8078146.json +1 -0
  976. package/out/build-info/db34a3531e47e196.json +1 -0
  977. package/out/console.sol/console.json +1 -0
  978. package/out/draft-IERC6093.sol/IERC1155Errors.json +1 -0
  979. package/out/draft-IERC6093.sol/IERC20Errors.json +1 -0
  980. package/out/draft-IERC6093.sol/IERC721Errors.json +1 -0
  981. package/out/safeconsole.sol/safeconsole.json +1 -0
  982. package/package.json +25 -0
  983. package/remappings.txt +1 -0
  984. package/script/Counter.s.sol +19 -0
  985. package/src/Counter.sol +14 -0
  986. package/src/GbitToken.sol +72 -0
  987. package/src/Guestbook.sol +28 -0
  988. package/src/Web3HubCore.sol +42 -0
  989. package/test/Counter.t.sol +24 -0
@@ -0,0 +1,470 @@
1
+ const format = require('../format-lines');
2
+ const { fromBytes32, toBytes32 } = require('./conversion');
3
+ const { SET_TYPES } = require('./Enumerable.opts');
4
+
5
+ const header = `\
6
+ pragma solidity ^0.8.24;
7
+
8
+ import {Arrays} from "../Arrays.sol";
9
+ import {Math} from "../math/Math.sol";
10
+
11
+ /**
12
+ * @dev Library for managing
13
+ * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
14
+ * types.
15
+ *
16
+ * Sets have the following properties:
17
+ *
18
+ * - Elements are added, removed, and checked for existence in constant time
19
+ * (O(1)).
20
+ * - Elements are enumerated in O(n). No guarantees are made on the ordering.
21
+ * - Set can be cleared (all elements removed) in O(n).
22
+ *
23
+ * \`\`\`solidity
24
+ * contract Example {
25
+ * // Add the library methods
26
+ * using EnumerableSet for EnumerableSet.AddressSet;
27
+ *
28
+ * // Declare a set state variable
29
+ * EnumerableSet.AddressSet private mySet;
30
+ * }
31
+ * \`\`\`
32
+ *
33
+ * The following types are supported:
34
+ *
35
+ * - \`bytes32\` (\`Bytes32Set\`) since v3.3.0
36
+ * - \`address\` (\`AddressSet\`) since v3.3.0
37
+ * - \`uint256\` (\`UintSet\`) since v3.3.0
38
+ * - \`string\` (\`StringSet\`) since v5.4.0
39
+ * - \`bytes\` (\`BytesSet\`) since v5.4.0
40
+ * - \`bytes4\` (\`Bytes4Set\`) since v5.6.0
41
+ *
42
+ * [WARNING]
43
+ * ====
44
+ * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
45
+ * unusable.
46
+ * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
47
+ *
48
+ * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
49
+ * array of EnumerableSet.
50
+ * ====
51
+ */
52
+ `;
53
+
54
+ // NOTE: this should be deprecated in favor of a more native construction in v6.0
55
+ const defaultSet = `\
56
+ // To implement this library for multiple types with as little code
57
+ // repetition as possible, we write it in terms of a generic Set type with
58
+ // bytes32 values.
59
+ // The Set implementation uses private functions, and user-facing
60
+ // implementations (such as AddressSet) are just wrappers around the
61
+ // underlying Set.
62
+ // This means that we can only create new EnumerableSets for types that fit
63
+ // in bytes32.
64
+
65
+ struct Set {
66
+ // Storage of set values
67
+ bytes32[] _values;
68
+ // Position is the index of the value in the \`values\` array plus 1.
69
+ // Position 0 is used to mean a value is not in the set.
70
+ mapping(bytes32 value => uint256) _positions;
71
+ }
72
+
73
+ /**
74
+ * @dev Add a value to a set. O(1).
75
+ *
76
+ * Returns true if the value was added to the set, that is if it was not
77
+ * already present.
78
+ */
79
+ function _add(Set storage set, bytes32 value) private returns (bool) {
80
+ if (!_contains(set, value)) {
81
+ set._values.push(value);
82
+ // The value is stored at length-1, but we add 1 to all indexes
83
+ // and use 0 as a sentinel value
84
+ set._positions[value] = set._values.length;
85
+ return true;
86
+ } else {
87
+ return false;
88
+ }
89
+ }
90
+
91
+ /**
92
+ * @dev Removes a value from a set. O(1).
93
+ *
94
+ * Returns true if the value was removed from the set, that is if it was
95
+ * present.
96
+ */
97
+ function _remove(Set storage set, bytes32 value) private returns (bool) {
98
+ // We cache the value's position to prevent multiple reads from the same storage slot
99
+ uint256 position = set._positions[value];
100
+
101
+ if (position != 0) {
102
+ // Equivalent to contains(set, value)
103
+ // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
104
+ // the array, and then remove the last element (sometimes called as 'swap and pop').
105
+ // This modifies the order of the array, as noted in {at}.
106
+
107
+ uint256 valueIndex = position - 1;
108
+ uint256 lastIndex = set._values.length - 1;
109
+
110
+ if (valueIndex != lastIndex) {
111
+ bytes32 lastValue = set._values[lastIndex];
112
+
113
+ // Move the lastValue to the index where the value to delete is
114
+ set._values[valueIndex] = lastValue;
115
+ // Update the tracked position of the lastValue (that was just moved)
116
+ set._positions[lastValue] = position;
117
+ }
118
+
119
+ // Delete the slot where the moved value was stored
120
+ set._values.pop();
121
+
122
+ // Delete the tracked position for the deleted slot
123
+ delete set._positions[value];
124
+
125
+ return true;
126
+ } else {
127
+ return false;
128
+ }
129
+ }
130
+
131
+ /**
132
+ * @dev Removes all the values from a set. O(n).
133
+ *
134
+ * WARNING: This function has an unbounded cost that scales with set size. Developers should keep in mind that
135
+ * using it may render the function uncallable if the set grows to the point where clearing it consumes too much
136
+ * gas to fit in a block.
137
+ */
138
+ function _clear(Set storage set) private {
139
+ uint256 len = _length(set);
140
+ for (uint256 i = 0; i < len; ++i) {
141
+ delete set._positions[set._values[i]];
142
+ }
143
+ Arrays.unsafeSetLength(set._values, 0);
144
+ }
145
+
146
+ /**
147
+ * @dev Returns true if the value is in the set. O(1).
148
+ */
149
+ function _contains(Set storage set, bytes32 value) private view returns (bool) {
150
+ return set._positions[value] != 0;
151
+ }
152
+
153
+ /**
154
+ * @dev Returns the number of values on the set. O(1).
155
+ */
156
+ function _length(Set storage set) private view returns (uint256) {
157
+ return set._values.length;
158
+ }
159
+
160
+ /**
161
+ * @dev Returns the value stored at position \`index\` in the set. O(1).
162
+ *
163
+ * Note that there are no guarantees on the ordering of values inside the
164
+ * array, and it may change when more values are added or removed.
165
+ *
166
+ * Requirements:
167
+ *
168
+ * - \`index\` must be strictly less than {length}.
169
+ */
170
+ function _at(Set storage set, uint256 index) private view returns (bytes32) {
171
+ return set._values[index];
172
+ }
173
+
174
+ /**
175
+ * @dev Return the entire set in an array
176
+ *
177
+ * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
178
+ * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
179
+ * this function has an unbounded cost, and using it as part of a state-changing function may render the function
180
+ * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
181
+ */
182
+ function _values(Set storage set) private view returns (bytes32[] memory) {
183
+ return set._values;
184
+ }
185
+
186
+ /**
187
+ * @dev Return a slice of the set in an array
188
+ *
189
+ * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
190
+ * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
191
+ * this function has an unbounded cost, and using it as part of a state-changing function may render the function
192
+ * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
193
+ */
194
+ function _values(Set storage set, uint256 start, uint256 end) private view returns (bytes32[] memory) {
195
+ unchecked {
196
+ end = Math.min(end, _length(set));
197
+ start = Math.min(start, end);
198
+
199
+ uint256 len = end - start;
200
+ bytes32[] memory result = new bytes32[](len);
201
+ for (uint256 i = 0; i < len; ++i) {
202
+ result[i] = Arrays.unsafeAccess(set._values, start + i).value;
203
+ }
204
+ return result;
205
+ }
206
+ }
207
+ `;
208
+
209
+ // NOTE: this should be deprecated in favor of a more native construction in v6.0
210
+ const customSet = ({ name, value: { type } }) => `\
211
+ // ${name}
212
+
213
+ struct ${name} {
214
+ Set _inner;
215
+ }
216
+
217
+ /**
218
+ * @dev Add a value to a set. O(1).
219
+ *
220
+ * Returns true if the value was added to the set, that is if it was not
221
+ * already present.
222
+ */
223
+ function add(${name} storage set, ${type} value) internal returns (bool) {
224
+ return _add(set._inner, ${toBytes32(type, 'value')});
225
+ }
226
+
227
+ /**
228
+ * @dev Removes a value from a set. O(1).
229
+ *
230
+ * Returns true if the value was removed from the set, that is if it was
231
+ * present.
232
+ */
233
+ function remove(${name} storage set, ${type} value) internal returns (bool) {
234
+ return _remove(set._inner, ${toBytes32(type, 'value')});
235
+ }
236
+
237
+ /**
238
+ * @dev Removes all the values from a set. O(n).
239
+ *
240
+ * WARNING: Developers should keep in mind that this function has an unbounded cost and using it may render the
241
+ * function uncallable if the set grows to the point where clearing it consumes too much gas to fit in a block.
242
+ */
243
+ function clear(${name} storage set) internal {
244
+ _clear(set._inner);
245
+ }
246
+
247
+ /**
248
+ * @dev Returns true if the value is in the set. O(1).
249
+ */
250
+ function contains(${name} storage set, ${type} value) internal view returns (bool) {
251
+ return _contains(set._inner, ${toBytes32(type, 'value')});
252
+ }
253
+
254
+ /**
255
+ * @dev Returns the number of values in the set. O(1).
256
+ */
257
+ function length(${name} storage set) internal view returns (uint256) {
258
+ return _length(set._inner);
259
+ }
260
+
261
+ /**
262
+ * @dev Returns the value stored at position \`index\` in the set. O(1).
263
+ *
264
+ * Note that there are no guarantees on the ordering of values inside the
265
+ * array, and it may change when more values are added or removed.
266
+ *
267
+ * Requirements:
268
+ *
269
+ * - \`index\` must be strictly less than {length}.
270
+ */
271
+ function at(${name} storage set, uint256 index) internal view returns (${type}) {
272
+ return ${fromBytes32(type, '_at(set._inner, index)')};
273
+ }
274
+
275
+ /**
276
+ * @dev Return the entire set in an array
277
+ *
278
+ * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
279
+ * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
280
+ * this function has an unbounded cost, and using it as part of a state-changing function may render the function
281
+ * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
282
+ */
283
+ function values(${name} storage set) internal view returns (${type}[] memory) {
284
+ bytes32[] memory store = _values(set._inner);
285
+ ${type}[] memory result;
286
+
287
+ assembly ("memory-safe") {
288
+ result := store
289
+ }
290
+
291
+ return result;
292
+ }
293
+
294
+ /**
295
+ * @dev Return a slice of the set in an array
296
+ *
297
+ * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
298
+ * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
299
+ * this function has an unbounded cost, and using it as part of a state-changing function may render the function
300
+ * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
301
+ */
302
+ function values(${name} storage set, uint256 start, uint256 end) internal view returns (${type}[] memory) {
303
+ bytes32[] memory store = _values(set._inner, start, end);
304
+ ${type}[] memory result;
305
+
306
+ assembly ("memory-safe") {
307
+ result := store
308
+ }
309
+
310
+ return result;
311
+ }
312
+ `;
313
+
314
+ const memorySet = ({ name, value }) => `\
315
+ struct ${name} {
316
+ // Storage of set values
317
+ ${value.type}[] _values;
318
+ // Position is the index of the value in the \`values\` array plus 1.
319
+ // Position 0 is used to mean a value is not in the set.
320
+ mapping(${value.type} value => uint256) _positions;
321
+ }
322
+
323
+ /**
324
+ * @dev Add a value to a set. O(1).
325
+ *
326
+ * Returns true if the value was added to the set, that is if it was not
327
+ * already present.
328
+ */
329
+ function add(${name} storage set, ${value.type} memory value) internal returns (bool) {
330
+ if (!contains(set, value)) {
331
+ set._values.push(value);
332
+ // The value is stored at length-1, but we add 1 to all indexes
333
+ // and use 0 as a sentinel value
334
+ set._positions[value] = set._values.length;
335
+ return true;
336
+ } else {
337
+ return false;
338
+ }
339
+ }
340
+
341
+ /**
342
+ * @dev Removes a value from a set. O(1).
343
+ *
344
+ * Returns true if the value was removed from the set, that is if it was
345
+ * present.
346
+ */
347
+ function remove(${name} storage set, ${value.type} memory value) internal returns (bool) {
348
+ // We cache the value's position to prevent multiple reads from the same storage slot
349
+ uint256 position = set._positions[value];
350
+
351
+ if (position != 0) {
352
+ // Equivalent to contains(set, value)
353
+ // To delete an element from the _values array in O(1), we swap the element to delete with the last one in
354
+ // the array, and then remove the last element (sometimes called as 'swap and pop').
355
+ // This modifies the order of the array, as noted in {at}.
356
+
357
+ uint256 valueIndex = position - 1;
358
+ uint256 lastIndex = set._values.length - 1;
359
+
360
+ if (valueIndex != lastIndex) {
361
+ ${value.type} memory lastValue = set._values[lastIndex];
362
+
363
+ // Move the lastValue to the index where the value to delete is
364
+ set._values[valueIndex] = lastValue;
365
+ // Update the tracked position of the lastValue (that was just moved)
366
+ set._positions[lastValue] = position;
367
+ }
368
+
369
+ // Delete the slot where the moved value was stored
370
+ set._values.pop();
371
+
372
+ // Delete the tracked position for the deleted slot
373
+ delete set._positions[value];
374
+
375
+ return true;
376
+ } else {
377
+ return false;
378
+ }
379
+ }
380
+
381
+ /**
382
+ * @dev Removes all the values from a set. O(n).
383
+ *
384
+ * WARNING: Developers should keep in mind that this function has an unbounded cost and using it may render the
385
+ * function uncallable if the set grows to the point where clearing it consumes too much gas to fit in a block.
386
+ */
387
+ function clear(${name} storage set) internal {
388
+ uint256 len = length(set);
389
+ for (uint256 i = 0; i < len; ++i) {
390
+ delete set._positions[set._values[i]];
391
+ }
392
+ Arrays.unsafeSetLength(set._values, 0);
393
+ }
394
+
395
+ /**
396
+ * @dev Returns true if the value is in the set. O(1).
397
+ */
398
+ function contains(${name} storage set, ${value.type} memory value) internal view returns (bool) {
399
+ return set._positions[value] != 0;
400
+ }
401
+
402
+ /**
403
+ * @dev Returns the number of values on the set. O(1).
404
+ */
405
+ function length(${name} storage set) internal view returns (uint256) {
406
+ return set._values.length;
407
+ }
408
+
409
+ /**
410
+ * @dev Returns the value stored at position \`index\` in the set. O(1).
411
+ *
412
+ * Note that there are no guarantees on the ordering of values inside the
413
+ * array, and it may change when more values are added or removed.
414
+ *
415
+ * Requirements:
416
+ *
417
+ * - \`index\` must be strictly less than {length}.
418
+ */
419
+ function at(${name} storage set, uint256 index) internal view returns (${value.type} memory) {
420
+ return set._values[index];
421
+ }
422
+
423
+ /**
424
+ * @dev Return the entire set in an array
425
+ *
426
+ * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
427
+ * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
428
+ * this function has an unbounded cost, and using it as part of a state-changing function may render the function
429
+ * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
430
+ */
431
+ function values(${name} storage set) internal view returns (${value.type}[] memory) {
432
+ return set._values;
433
+ }
434
+
435
+ /**
436
+ * @dev Return a slice of the set in an array
437
+ *
438
+ * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
439
+ * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
440
+ * this function has an unbounded cost, and using it as part of a state-changing function may render the function
441
+ * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
442
+ */
443
+ function values(${name} storage set, uint256 start, uint256 end) internal view returns (${value.type}[] memory) {
444
+ unchecked {
445
+ end = Math.min(end, length(set));
446
+ start = Math.min(start, end);
447
+
448
+ uint256 len = end - start;
449
+ ${value.type}[] memory result = new ${value.type}[](len);
450
+ for (uint256 i = 0; i < len; ++i) {
451
+ result[i] = Arrays.unsafeAccess(set._values, start + i).value;
452
+ }
453
+ return result;
454
+ }
455
+ }
456
+ `;
457
+
458
+ // GENERATE
459
+ module.exports = format(
460
+ header.trimEnd(),
461
+ 'library EnumerableSet {',
462
+ format(
463
+ [].concat(
464
+ defaultSet,
465
+ SET_TYPES.filter(({ value }) => !value.memory).map(customSet),
466
+ SET_TYPES.filter(({ value }) => value.memory).map(memorySet),
467
+ ),
468
+ ).trimEnd(),
469
+ '}',
470
+ );
@@ -0,0 +1,186 @@
1
+ const format = require('../format-lines');
2
+ const { OPTS } = require('./MerkleProof.opts');
3
+
4
+ const DEFAULT_HASH = 'Hashes.commutativeKeccak256';
5
+
6
+ const formatArgsSingleLine = (...args) => args.filter(Boolean).join(', ');
7
+ const formatArgsMultiline = (...args) => '\n' + format(args.filter(Boolean).join(',\0').split('\0'));
8
+
9
+ // TEMPLATE
10
+ const header = `\
11
+ pragma solidity ^0.8.20;
12
+
13
+ import {Hashes} from "./Hashes.sol";
14
+
15
+ /**
16
+ * @dev These functions deal with verification of Merkle Tree proofs.
17
+ *
18
+ * The tree and the proofs can be generated using our
19
+ * https://github.com/OpenZeppelin/merkle-tree[JavaScript library].
20
+ * You will find a quickstart guide in the readme.
21
+ *
22
+ * WARNING: You should avoid using leaf values that are 64 bytes long prior to
23
+ * hashing, or use a hash function other than keccak256 for hashing leaves.
24
+ * This is because the concatenation of a sorted pair of internal nodes in
25
+ * the Merkle tree could be reinterpreted as a leaf value.
26
+ * OpenZeppelin's JavaScript library generates Merkle trees that are safe
27
+ * against this attack out of the box.
28
+ *
29
+ * IMPORTANT: Consider memory side-effects when using custom hashing functions
30
+ * that access memory in an unsafe way.
31
+ *
32
+ * NOTE: This library supports proof verification for merkle trees built using
33
+ * custom _commutative_ hashing functions (i.e. \`H(a, b) == H(b, a)\`). Proving
34
+ * leaf inclusion in trees built using non-commutative hashing functions requires
35
+ * additional logic that is not supported by this library.
36
+ */
37
+ `;
38
+
39
+ const errors = `\
40
+ /**
41
+ * @dev The multiproof provided is not valid.
42
+ */
43
+ error MerkleProofInvalidMultiproof();
44
+ `;
45
+
46
+ const templateProof = ({ suffix, location, visibility, hash }) => `\
47
+ /**
48
+ * @dev Returns true if a \`leaf\` can be proved to be a part of a Merkle tree
49
+ * defined by \`root\`. For this, a \`proof\` must be provided, containing
50
+ * sibling hashes on the branch from the leaf to the root of the tree. Each
51
+ * pair of leaves and each pair of pre-images are assumed to be sorted.
52
+ *
53
+ * This version handles proofs in ${location} with ${hash ? 'a custom' : 'the default'} hashing function.
54
+ */
55
+ function verify${suffix}(${(hash ? formatArgsMultiline : formatArgsSingleLine)(
56
+ `bytes32[] ${location} proof`,
57
+ 'bytes32 root',
58
+ 'bytes32 leaf',
59
+ hash && `function(bytes32, bytes32) view returns (bytes32) ${hash}`,
60
+ )}) internal ${visibility} returns (bool) {
61
+ return processProof${suffix}(proof, leaf${hash ? `, ${hash}` : ''}) == root;
62
+ }
63
+
64
+ /**
65
+ * @dev Returns the rebuilt hash obtained by traversing a Merkle tree up
66
+ * from \`leaf\` using \`proof\`. A \`proof\` is valid if and only if the rebuilt
67
+ * hash matches the root of the tree. When processing the proof, the pairs
68
+ * of leaves & pre-images are assumed to be sorted.
69
+ *
70
+ * This version handles proofs in ${location} with ${hash ? 'a custom' : 'the default'} hashing function.
71
+ */
72
+ function processProof${suffix}(${(hash ? formatArgsMultiline : formatArgsSingleLine)(
73
+ `bytes32[] ${location} proof`,
74
+ 'bytes32 leaf',
75
+ hash && `function(bytes32, bytes32) view returns (bytes32) ${hash}`,
76
+ )}) internal ${visibility} returns (bytes32) {
77
+ bytes32 computedHash = leaf;
78
+ for (uint256 i = 0; i < proof.length; i++) {
79
+ computedHash = ${hash ?? DEFAULT_HASH}(computedHash, proof[i]);
80
+ }
81
+ return computedHash;
82
+ }
83
+ `;
84
+
85
+ const templateMultiProof = ({ suffix, location, visibility, hash }) => `\
86
+ /**
87
+ * @dev Returns true if the \`leaves\` can be simultaneously proven to be a part of a Merkle tree defined by
88
+ * \`root\`, according to \`proof\` and \`proofFlags\` as described in {processMultiProof}.
89
+ *
90
+ * This version handles multiproofs in ${location} with ${hash ? 'a custom' : 'the default'} hashing function.
91
+ *
92
+ * CAUTION: Not all Merkle trees admit multiproofs. See {processMultiProof} for details.
93
+ *
94
+ * NOTE: Consider the case where \`root == proof[0] && leaves.length == 0\` as it will return \`true\`.
95
+ * The \`leaves\` must be validated independently. See {processMultiProof${suffix}}.
96
+ */
97
+ function multiProofVerify${suffix}(${formatArgsMultiline(
98
+ `bytes32[] ${location} proof`,
99
+ `bool[] ${location} proofFlags`,
100
+ 'bytes32 root',
101
+ `bytes32[] memory leaves`,
102
+ hash && `function(bytes32, bytes32) view returns (bytes32) ${hash}`,
103
+ )}) internal ${visibility} returns (bool) {
104
+ return processMultiProof${suffix}(proof, proofFlags, leaves${hash ? `, ${hash}` : ''}) == root;
105
+ }
106
+
107
+ /**
108
+ * @dev Returns the root of a tree reconstructed from \`leaves\` and sibling nodes in \`proof\`. The reconstruction
109
+ * proceeds by incrementally reconstructing all inner nodes by combining a leaf/inner node with either another
110
+ * leaf/inner node or a proof sibling node, depending on whether each \`proofFlags\` item is true or false
111
+ * respectively.
112
+ *
113
+ * This version handles multiproofs in ${location} with ${hash ? 'a custom' : 'the default'} hashing function.
114
+ *
115
+ * CAUTION: Not all Merkle trees admit multiproofs. To use multiproofs, it is sufficient to ensure that: 1) the tree
116
+ * is complete (but not necessarily perfect), 2) the leaves to be proven are in the opposite order they are in the
117
+ * tree (i.e., as seen from right to left starting at the deepest layer and continuing at the next layer).
118
+ *
119
+ * NOTE: The _empty set_ (i.e. the case where \`proof.length == 1 && leaves.length == 0\`) is considered a no-op,
120
+ * and therefore a valid multiproof (i.e. it returns \`proof[0]\`). Consider disallowing this case if you're not
121
+ * validating the leaves elsewhere.
122
+ */
123
+ function processMultiProof${suffix}(${formatArgsMultiline(
124
+ `bytes32[] ${location} proof`,
125
+ `bool[] ${location} proofFlags`,
126
+ `bytes32[] memory leaves`,
127
+ hash && `function(bytes32, bytes32) view returns (bytes32) ${hash}`,
128
+ )}) internal ${visibility} returns (bytes32 merkleRoot) {
129
+ // This function rebuilds the root hash by traversing the tree up from the leaves. The root is rebuilt by
130
+ // consuming and producing values on a queue. The queue starts with the \`leaves\` array, then goes onto the
131
+ // \`hashes\` array. At the end of the process, the last hash in the \`hashes\` array should contain the root of
132
+ // the Merkle tree.
133
+ uint256 leavesLen = leaves.length;
134
+ uint256 proofFlagsLen = proofFlags.length;
135
+
136
+ // Check proof validity.
137
+ if (leavesLen + proof.length != proofFlagsLen + 1) {
138
+ revert MerkleProofInvalidMultiproof();
139
+ }
140
+
141
+ if (proofFlagsLen > 0) {
142
+ // The xxxPos values are "pointers" to the next value to consume in each array. All accesses are done using
143
+ // \`xxx[xxxPos++]\`, which return the current value and increment the pointer, thus mimicking a queue's "pop".
144
+ bytes32[] memory hashes = new bytes32[](proofFlagsLen);
145
+ uint256 leafPos = 0;
146
+ uint256 hashPos = 0;
147
+ uint256 proofPos = 0;
148
+ // At each step, we compute the next hash using two values:
149
+ // - a value from the "main queue". If not all leaves have been consumed, we get the next leaf, otherwise we
150
+ // get the next hash.
151
+ // - depending on the flag, either another value from the "main queue" (merging branches) or an element from the
152
+ // \`proof\` array.
153
+ for (uint256 i = 0; i < proofFlagsLen; i++) {
154
+ bytes32 a = leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++];
155
+ bytes32 b = proofFlags[i]
156
+ ? (leafPos < leavesLen ? leaves[leafPos++] : hashes[hashPos++])
157
+ : proof[proofPos++];
158
+ hashes[i] = ${hash ?? DEFAULT_HASH}(a, b);
159
+ }
160
+ if (proofPos != proof.length) {
161
+ revert MerkleProofInvalidMultiproof();
162
+ }
163
+ unchecked {
164
+ return hashes[proofFlagsLen - 1];
165
+ }
166
+ } else if (leavesLen > 0) {
167
+ return leaves[0];
168
+ } else {
169
+ return proof[0];
170
+ }
171
+ }
172
+ `;
173
+
174
+ // GENERATE
175
+ module.exports = format(
176
+ header.trimEnd(),
177
+ 'library MerkleProof {',
178
+ format(
179
+ [].concat(
180
+ errors,
181
+ OPTS.flatMap(opts => templateProof(opts)),
182
+ OPTS.flatMap(opts => templateMultiProof(opts)),
183
+ ),
184
+ ).trimEnd(),
185
+ '}',
186
+ );
@@ -0,0 +1,11 @@
1
+ const { product } = require('../../helpers');
2
+
3
+ const OPTS = product(
4
+ [
5
+ { suffix: '', location: 'memory' },
6
+ { suffix: 'Calldata', location: 'calldata' },
7
+ ],
8
+ [{ visibility: 'pure' }, { visibility: 'view', hash: 'hasher' }],
9
+ ).map(objs => Object.assign({}, ...objs));
10
+
11
+ module.exports = { OPTS };