arr00-testing-oz-contracts 0.0.0 → 5.8.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 (507) hide show
  1. package/README.md +121 -0
  2. package/access/AccessControl.sol +206 -0
  3. package/access/IAccessControl.sol +98 -0
  4. package/access/Ownable.sol +100 -0
  5. package/access/Ownable2Step.sol +67 -0
  6. package/access/extensions/AccessControlDefaultAdminRules.sol +372 -0
  7. package/access/extensions/AccessControlEnumerable.sol +81 -0
  8. package/access/extensions/IAccessControlDefaultAdminRules.sol +192 -0
  9. package/access/extensions/IAccessControlEnumerable.sol +31 -0
  10. package/access/manager/AccessManaged.sol +118 -0
  11. package/access/manager/AccessManager.sol +781 -0
  12. package/access/manager/AuthorityUtils.sol +36 -0
  13. package/access/manager/IAccessManaged.sol +32 -0
  14. package/access/manager/IAccessManager.sol +410 -0
  15. package/access/manager/IAuthority.sol +14 -0
  16. package/account/Account.sol +151 -0
  17. package/account/extensions/draft-AccountERC7579.sol +430 -0
  18. package/account/extensions/draft-AccountERC7579Hooked.sol +113 -0
  19. package/account/extensions/draft-ERC7821.sol +70 -0
  20. package/account/paymaster/Paymaster.sol +170 -0
  21. package/account/paymaster/extensions/PaymasterERC20.sol +394 -0
  22. package/account/paymaster/extensions/PaymasterERC20Guarantor.sol +190 -0
  23. package/account/paymaster/extensions/PaymasterERC721Owner.sol +54 -0
  24. package/account/paymaster/extensions/PaymasterSigner.sol +125 -0
  25. package/account/utils/EIP7702Utils.sol +25 -0
  26. package/account/utils/ERC4337Utils.sol +317 -0
  27. package/account/utils/draft-ERC7579Utils.sol +314 -0
  28. package/build/contracts/AbstractSigner.json +13 -0
  29. package/build/contracts/AccessControl.json +239 -0
  30. package/build/contracts/AccessControlDefaultAdminRules.json +467 -0
  31. package/build/contracts/AccessControlEnumerable.json +301 -0
  32. package/build/contracts/AccessManaged.json +104 -0
  33. package/build/contracts/AccessManager.json +1189 -0
  34. package/build/contracts/Account.json +150 -0
  35. package/build/contracts/AccountERC7579.json +515 -0
  36. package/build/contracts/AccountERC7579Hooked.json +539 -0
  37. package/build/contracts/Accumulators.json +13 -0
  38. package/build/contracts/Address.json +25 -0
  39. package/build/contracts/Arrays.json +13 -0
  40. package/build/contracts/AuthorityUtils.json +13 -0
  41. package/build/contracts/Base58.json +25 -0
  42. package/build/contracts/Base64.json +25 -0
  43. package/build/contracts/BeaconProxy.json +97 -0
  44. package/build/contracts/BitMaps.json +13 -0
  45. package/build/contracts/BlockHeader.json +25 -0
  46. package/build/contracts/Blockhash.json +13 -0
  47. package/build/contracts/BridgeERC1155.json +508 -0
  48. package/build/contracts/BridgeERC20.json +260 -0
  49. package/build/contracts/BridgeERC721.json +270 -0
  50. package/build/contracts/BridgeERC7802.json +249 -0
  51. package/build/contracts/BridgeFungible.json +236 -0
  52. package/build/contracts/BridgeMultiToken.json +236 -0
  53. package/build/contracts/BridgeNonFungible.json +212 -0
  54. package/build/contracts/Bytes.json +13 -0
  55. package/build/contracts/CAIP10.json +13 -0
  56. package/build/contracts/CAIP2.json +13 -0
  57. package/build/contracts/Calldata.json +13 -0
  58. package/build/contracts/Checkpoints.json +19 -0
  59. package/build/contracts/CircularBuffer.json +19 -0
  60. package/build/contracts/Clones.json +19 -0
  61. package/build/contracts/Comparators.json +13 -0
  62. package/build/contracts/Context.json +13 -0
  63. package/build/contracts/Create2.json +19 -0
  64. package/build/contracts/Create3.json +19 -0
  65. package/build/contracts/CrosschainLinked.json +145 -0
  66. package/build/contracts/CrosschainRemoteExecutor.json +199 -0
  67. package/build/contracts/DoubleEndedQueue.json +13 -0
  68. package/build/contracts/ECDSA.json +41 -0
  69. package/build/contracts/EIP712.json +79 -0
  70. package/build/contracts/EIP7702Utils.json +13 -0
  71. package/build/contracts/ERC1155.json +428 -0
  72. package/build/contracts/ERC1155Burnable.json +474 -0
  73. package/build/contracts/ERC1155Crosschain.json +796 -0
  74. package/build/contracts/ERC1155Holder.json +111 -0
  75. package/build/contracts/ERC1155Pausable.json +477 -0
  76. package/build/contracts/ERC1155Supply.json +479 -0
  77. package/build/contracts/ERC1155URIStorage.json +428 -0
  78. package/build/contracts/ERC1155Utils.json +13 -0
  79. package/build/contracts/ERC1363.json +585 -0
  80. package/build/contracts/ERC1363Utils.json +36 -0
  81. package/build/contracts/ERC165.json +33 -0
  82. package/build/contracts/ERC165Checker.json +13 -0
  83. package/build/contracts/ERC1967Clones.json +13 -0
  84. package/build/contracts/ERC1967Proxy.json +84 -0
  85. package/build/contracts/ERC1967Utils.json +52 -0
  86. package/build/contracts/ERC20.json +322 -0
  87. package/build/contracts/ERC20Bridgeable.json +427 -0
  88. package/build/contracts/ERC20Burnable.json +353 -0
  89. package/build/contracts/ERC20Capped.json +362 -0
  90. package/build/contracts/ERC20Crosschain.json +573 -0
  91. package/build/contracts/ERC20FlashMint.json +432 -0
  92. package/build/contracts/ERC20Pausable.json +371 -0
  93. package/build/contracts/ERC20Permit.json +532 -0
  94. package/build/contracts/ERC20TemporaryApproval.json +346 -0
  95. package/build/contracts/ERC20TransferAuthorization.json +836 -0
  96. package/build/contracts/ERC20Votes.json +781 -0
  97. package/build/contracts/ERC20Wrapper.json +405 -0
  98. package/build/contracts/ERC2771Context.json +46 -0
  99. package/build/contracts/ERC2771Forwarder.json +439 -0
  100. package/build/contracts/ERC2981.json +126 -0
  101. package/build/contracts/ERC3009.json +668 -0
  102. package/build/contracts/ERC4337Utils.json +13 -0
  103. package/build/contracts/ERC4626.json +807 -0
  104. package/build/contracts/ERC6372Utils.json +19 -0
  105. package/build/contracts/ERC6909.json +415 -0
  106. package/build/contracts/ERC6909ContentURI.json +472 -0
  107. package/build/contracts/ERC6909Metadata.json +529 -0
  108. package/build/contracts/ERC6909TokenSupply.json +434 -0
  109. package/build/contracts/ERC721.json +447 -0
  110. package/build/contracts/ERC721Burnable.json +460 -0
  111. package/build/contracts/ERC721Consecutive.json +509 -0
  112. package/build/contracts/ERC721Crosschain.json +674 -0
  113. package/build/contracts/ERC721Enumerable.json +524 -0
  114. package/build/contracts/ERC721Holder.json +48 -0
  115. package/build/contracts/ERC721Pausable.json +496 -0
  116. package/build/contracts/ERC721Royalty.json +540 -0
  117. package/build/contracts/ERC721URIStorage.json +479 -0
  118. package/build/contracts/ERC721Utils.json +13 -0
  119. package/build/contracts/ERC721Votes.json +835 -0
  120. package/build/contracts/ERC721Wrapper.json +553 -0
  121. package/build/contracts/ERC7579Utils.json +119 -0
  122. package/build/contracts/ERC7739.json +103 -0
  123. package/build/contracts/ERC7739Utils.json +13 -0
  124. package/build/contracts/ERC7786Recipient.json +59 -0
  125. package/build/contracts/ERC7821.json +112 -0
  126. package/build/contracts/ERC7913P256Verifier.json +43 -0
  127. package/build/contracts/ERC7913RSAVerifier.json +43 -0
  128. package/build/contracts/ERC7913WebAuthnVerifier.json +43 -0
  129. package/build/contracts/EnumerableMap.json +36 -0
  130. package/build/contracts/EnumerableSet.json +13 -0
  131. package/build/contracts/Errors.json +51 -0
  132. package/build/contracts/Governor.json +1381 -0
  133. package/build/contracts/GovernorCountingFractional.json +1455 -0
  134. package/build/contracts/GovernorCountingOverridable.json +1612 -0
  135. package/build/contracts/GovernorCountingSimple.json +1410 -0
  136. package/build/contracts/GovernorCrosschain.json +1409 -0
  137. package/build/contracts/GovernorNoncesKeyed.json +1405 -0
  138. package/build/contracts/GovernorPreventLateQuorum.json +1461 -0
  139. package/build/contracts/GovernorProposalGuardian.json +1426 -0
  140. package/build/contracts/GovernorSequentialProposalId.json +1399 -0
  141. package/build/contracts/GovernorSettings.json +1477 -0
  142. package/build/contracts/GovernorStorage.json +1506 -0
  143. package/build/contracts/GovernorSuperQuorum.json +1429 -0
  144. package/build/contracts/GovernorTimelockAccess.json +1582 -0
  145. package/build/contracts/GovernorTimelockCompound.json +1449 -0
  146. package/build/contracts/GovernorTimelockControl.json +1426 -0
  147. package/build/contracts/GovernorVotes.json +1399 -0
  148. package/build/contracts/GovernorVotesQuorumFraction.json +1497 -0
  149. package/build/contracts/GovernorVotesSuperQuorumFraction.json +1657 -0
  150. package/build/contracts/Hashes.json +13 -0
  151. package/build/contracts/Heap.json +13 -0
  152. package/build/contracts/IAccessControl.json +207 -0
  153. package/build/contracts/IAccessControlDefaultAdminRules.json +406 -0
  154. package/build/contracts/IAccessControlEnumerable.json +250 -0
  155. package/build/contracts/IAccessManaged.json +104 -0
  156. package/build/contracts/IAccessManager.json +1085 -0
  157. package/build/contracts/IAccount.json +90 -0
  158. package/build/contracts/IAccountExecute.json +79 -0
  159. package/build/contracts/IAggregator.json +211 -0
  160. package/build/contracts/IAuthority.json +43 -0
  161. package/build/contracts/IBeacon.json +27 -0
  162. package/build/contracts/ICompoundTimelock.json +427 -0
  163. package/build/contracts/IERC1155.json +307 -0
  164. package/build/contracts/IERC1155Errors.json +116 -0
  165. package/build/contracts/IERC1155MetadataURI.json +326 -0
  166. package/build/contracts/IERC1155Receiver.json +111 -0
  167. package/build/contracts/IERC1271.json +38 -0
  168. package/build/contracts/IERC1363.json +385 -0
  169. package/build/contracts/IERC1363Receiver.json +48 -0
  170. package/build/contracts/IERC1363Spender.json +43 -0
  171. package/build/contracts/IERC165.json +33 -0
  172. package/build/contracts/IERC1820Implementer.json +38 -0
  173. package/build/contracts/IERC1820Registry.json +227 -0
  174. package/build/contracts/IERC1822Proxiable.json +27 -0
  175. package/build/contracts/IERC1967.json +59 -0
  176. package/build/contracts/IERC20.json +197 -0
  177. package/build/contracts/IERC20Errors.json +100 -0
  178. package/build/contracts/IERC20Metadata.json +236 -0
  179. package/build/contracts/IERC20Permit.json +89 -0
  180. package/build/contracts/IERC2309.json +45 -0
  181. package/build/contracts/IERC2612.json +89 -0
  182. package/build/contracts/IERC2981.json +62 -0
  183. package/build/contracts/IERC3009.json +163 -0
  184. package/build/contracts/IERC3009Cancel.json +66 -0
  185. package/build/contracts/IERC3156FlashBorrower.json +53 -0
  186. package/build/contracts/IERC3156FlashLender.json +91 -0
  187. package/build/contracts/IERC4626.json +626 -0
  188. package/build/contracts/IERC4906.json +331 -0
  189. package/build/contracts/IERC5267.json +63 -0
  190. package/build/contracts/IERC5313.json +27 -0
  191. package/build/contracts/IERC5805.json +233 -0
  192. package/build/contracts/IERC6372.json +40 -0
  193. package/build/contracts/IERC6909.json +319 -0
  194. package/build/contracts/IERC6909ContentURI.json +351 -0
  195. package/build/contracts/IERC6909Metadata.json +376 -0
  196. package/build/contracts/IERC6909TokenSupply.json +338 -0
  197. package/build/contracts/IERC721.json +299 -0
  198. package/build/contracts/IERC721Enumerable.json +355 -0
  199. package/build/contracts/IERC721Errors.json +117 -0
  200. package/build/contracts/IERC721Metadata.json +344 -0
  201. package/build/contracts/IERC721Receiver.json +48 -0
  202. package/build/contracts/IERC7579AccountConfig.json +65 -0
  203. package/build/contracts/IERC7579Execution.json +56 -0
  204. package/build/contracts/IERC7579Hook.json +101 -0
  205. package/build/contracts/IERC7579Module.json +59 -0
  206. package/build/contracts/IERC7579ModuleConfig.json +127 -0
  207. package/build/contracts/IERC7579Validator.json +159 -0
  208. package/build/contracts/IERC7674.json +221 -0
  209. package/build/contracts/IERC7751.json +40 -0
  210. package/build/contracts/IERC777.json +405 -0
  211. package/build/contracts/IERC777Recipient.json +52 -0
  212. package/build/contracts/IERC777Sender.json +52 -0
  213. package/build/contracts/IERC7786GatewaySource.json +116 -0
  214. package/build/contracts/IERC7786Recipient.json +43 -0
  215. package/build/contracts/IERC7802.json +119 -0
  216. package/build/contracts/IERC7821.json +51 -0
  217. package/build/contracts/IERC7913SignatureVerifier.json +43 -0
  218. package/build/contracts/IEntryPoint.json +305 -0
  219. package/build/contracts/IEntryPointExtra.json +80 -0
  220. package/build/contracts/IEntryPointNonces.json +38 -0
  221. package/build/contracts/IEntryPointStake.json +97 -0
  222. package/build/contracts/IGovernor.json +1095 -0
  223. package/build/contracts/IPaymaster.json +123 -0
  224. package/build/contracts/ITransparentUpgradeableProxy.json +77 -0
  225. package/build/contracts/IVotes.json +207 -0
  226. package/build/contracts/Initializable.json +37 -0
  227. package/build/contracts/InteroperableAddress.json +30 -0
  228. package/build/contracts/LowLevelCall.json +13 -0
  229. package/build/contracts/Math.json +13 -0
  230. package/build/contracts/Memory.json +13 -0
  231. package/build/contracts/MerkleProof.json +19 -0
  232. package/build/contracts/MerkleTree.json +35 -0
  233. package/build/contracts/MessageHashUtils.json +19 -0
  234. package/build/contracts/MultiSignerERC7913.json +176 -0
  235. package/build/contracts/MultiSignerERC7913Weighted.json +264 -0
  236. package/build/contracts/Multicall.json +49 -0
  237. package/build/contracts/Nonces.json +49 -0
  238. package/build/contracts/NoncesKeyed.json +73 -0
  239. package/build/contracts/Ownable.json +88 -0
  240. package/build/contracts/Ownable2Step.json +127 -0
  241. package/build/contracts/P256.json +13 -0
  242. package/build/contracts/Packing.json +19 -0
  243. package/build/contracts/Panic.json +13 -0
  244. package/build/contracts/Pausable.json +63 -0
  245. package/build/contracts/Paymaster.json +147 -0
  246. package/build/contracts/PaymasterERC20.json +209 -0
  247. package/build/contracts/PaymasterERC20Guarantor.json +234 -0
  248. package/build/contracts/PaymasterERC721Owner.json +160 -0
  249. package/build/contracts/PaymasterSigner.json +212 -0
  250. package/build/contracts/Proxy.json +18 -0
  251. package/build/contracts/ProxyAdmin.json +135 -0
  252. package/build/contracts/RLP.json +19 -0
  253. package/build/contracts/RSA.json +13 -0
  254. package/build/contracts/RateLimiter.json +19 -0
  255. package/build/contracts/ReentrancyGuard.json +19 -0
  256. package/build/contracts/ReentrancyGuardTransient.json +19 -0
  257. package/build/contracts/RelayedCall.json +13 -0
  258. package/build/contracts/SafeCast.json +68 -0
  259. package/build/contracts/SafeERC20.json +46 -0
  260. package/build/contracts/ShortStrings.json +30 -0
  261. package/build/contracts/SignatureChecker.json +13 -0
  262. package/build/contracts/SignedMath.json +13 -0
  263. package/build/contracts/SignerECDSA.json +27 -0
  264. package/build/contracts/SignerEIP7702.json +13 -0
  265. package/build/contracts/SignerERC7913.json +27 -0
  266. package/build/contracts/SignerP256.json +48 -0
  267. package/build/contracts/SignerRSA.json +32 -0
  268. package/build/contracts/SignerWebAuthn.json +48 -0
  269. package/build/contracts/SimulateCall.json +13 -0
  270. package/build/contracts/SlotDerivation.json +13 -0
  271. package/build/contracts/StorageSlot.json +13 -0
  272. package/build/contracts/Strings.json +40 -0
  273. package/build/contracts/Time.json +13 -0
  274. package/build/contracts/TimelockController.json +1010 -0
  275. package/build/contracts/TransientSlot.json +13 -0
  276. package/build/contracts/TransparentUpgradeableProxy.json +131 -0
  277. package/build/contracts/TrieProof.json +25 -0
  278. package/build/contracts/UUPSUpgradeable.json +119 -0
  279. package/build/contracts/UpgradeableBeacon.json +154 -0
  280. package/build/contracts/VestingWallet.json +364 -0
  281. package/build/contracts/VestingWalletCliff.json +367 -0
  282. package/build/contracts/Votes.json +402 -0
  283. package/build/contracts/VotesExtended.json +450 -0
  284. package/build/contracts/WebAuthn.json +13 -0
  285. package/crosschain/CrosschainLinked.sol +114 -0
  286. package/crosschain/CrosschainRemoteExecutor.sol +99 -0
  287. package/crosschain/ERC7786Recipient.sol +66 -0
  288. package/crosschain/bridges/BridgeERC1155.sol +131 -0
  289. package/crosschain/bridges/BridgeERC20.sol +42 -0
  290. package/crosschain/bridges/BridgeERC721.sol +62 -0
  291. package/crosschain/bridges/BridgeERC7802.sol +34 -0
  292. package/crosschain/bridges/abstract/BridgeFungible.sol +86 -0
  293. package/crosschain/bridges/abstract/BridgeMultiToken.sol +99 -0
  294. package/crosschain/bridges/abstract/BridgeNonFungible.sol +79 -0
  295. package/finance/VestingWallet.sol +160 -0
  296. package/finance/VestingWalletCliff.sol +55 -0
  297. package/governance/Governor.sol +825 -0
  298. package/governance/IGovernor.sol +454 -0
  299. package/governance/TimelockController.sol +470 -0
  300. package/governance/extensions/GovernorCountingFractional.sol +190 -0
  301. package/governance/extensions/GovernorCountingOverridable.sol +226 -0
  302. package/governance/extensions/GovernorCountingSimple.sol +96 -0
  303. package/governance/extensions/GovernorCrosschain.sol +31 -0
  304. package/governance/extensions/GovernorNoncesKeyed.sol +91 -0
  305. package/governance/extensions/GovernorPreventLateQuorum.sol +119 -0
  306. package/governance/extensions/GovernorProposalGuardian.sol +59 -0
  307. package/governance/extensions/GovernorSequentialProposalId.sol +75 -0
  308. package/governance/extensions/GovernorSettings.sol +106 -0
  309. package/governance/extensions/GovernorStorage.sol +134 -0
  310. package/governance/extensions/GovernorSuperQuorum.sol +59 -0
  311. package/governance/extensions/GovernorTimelockAccess.sol +346 -0
  312. package/governance/extensions/GovernorTimelockCompound.sol +162 -0
  313. package/governance/extensions/GovernorTimelockControl.sol +167 -0
  314. package/governance/extensions/GovernorVotes.sol +64 -0
  315. package/governance/extensions/GovernorVotesQuorumFraction.sol +113 -0
  316. package/governance/extensions/GovernorVotesSuperQuorumFraction.sol +135 -0
  317. package/governance/utils/IVotes.sol +60 -0
  318. package/governance/utils/Votes.sol +245 -0
  319. package/governance/utils/VotesExtended.sol +85 -0
  320. package/interfaces/IERC1155.sol +6 -0
  321. package/interfaces/IERC1155MetadataURI.sol +6 -0
  322. package/interfaces/IERC1155Receiver.sol +6 -0
  323. package/interfaces/IERC1271.sol +17 -0
  324. package/interfaces/IERC1363.sol +86 -0
  325. package/interfaces/IERC1363Receiver.sol +32 -0
  326. package/interfaces/IERC1363Spender.sol +26 -0
  327. package/interfaces/IERC165.sol +6 -0
  328. package/interfaces/IERC1820Implementer.sol +20 -0
  329. package/interfaces/IERC1820Registry.sol +112 -0
  330. package/interfaces/IERC1967.sol +24 -0
  331. package/interfaces/IERC20.sol +6 -0
  332. package/interfaces/IERC20Metadata.sol +6 -0
  333. package/interfaces/IERC2309.sol +19 -0
  334. package/interfaces/IERC2612.sol +8 -0
  335. package/interfaces/IERC2981.sol +26 -0
  336. package/interfaces/IERC3156.sol +7 -0
  337. package/interfaces/IERC3156FlashBorrower.sol +27 -0
  338. package/interfaces/IERC3156FlashLender.sol +41 -0
  339. package/interfaces/IERC4337.sol +255 -0
  340. package/interfaces/IERC4626.sol +230 -0
  341. package/interfaces/IERC4906.sol +20 -0
  342. package/interfaces/IERC5267.sol +28 -0
  343. package/interfaces/IERC5313.sol +16 -0
  344. package/interfaces/IERC5805.sol +9 -0
  345. package/interfaces/IERC6093.sol +162 -0
  346. package/interfaces/IERC6372.sol +19 -0
  347. package/interfaces/IERC6909.sol +131 -0
  348. package/interfaces/IERC721.sol +6 -0
  349. package/interfaces/IERC721Enumerable.sol +6 -0
  350. package/interfaces/IERC721Metadata.sol +6 -0
  351. package/interfaces/IERC721Receiver.sol +6 -0
  352. package/interfaces/IERC7751.sol +12 -0
  353. package/interfaces/IERC777.sol +200 -0
  354. package/interfaces/IERC777Recipient.sol +35 -0
  355. package/interfaces/IERC777Sender.sol +35 -0
  356. package/interfaces/IERC7786.sol +64 -0
  357. package/interfaces/IERC7913.sol +18 -0
  358. package/interfaces/draft-IERC1822.sol +20 -0
  359. package/interfaces/draft-IERC3009.sol +87 -0
  360. package/interfaces/draft-IERC7579.sol +227 -0
  361. package/interfaces/draft-IERC7674.sol +17 -0
  362. package/interfaces/draft-IERC7802.sol +32 -0
  363. package/interfaces/draft-IERC7821.sol +44 -0
  364. package/metatx/ERC2771Context.sol +90 -0
  365. package/metatx/ERC2771Forwarder.sol +376 -0
  366. package/package.json +29 -1
  367. package/proxy/Clones.sol +294 -0
  368. package/proxy/ERC1967/ERC1967Clones.sol +219 -0
  369. package/proxy/ERC1967/ERC1967Proxy.sol +62 -0
  370. package/proxy/ERC1967/ERC1967Utils.sol +177 -0
  371. package/proxy/Proxy.sol +69 -0
  372. package/proxy/beacon/BeaconProxy.sol +57 -0
  373. package/proxy/beacon/IBeacon.sol +16 -0
  374. package/proxy/beacon/UpgradeableBeacon.sol +70 -0
  375. package/proxy/transparent/ProxyAdmin.sol +45 -0
  376. package/proxy/transparent/TransparentUpgradeableProxy.sol +118 -0
  377. package/proxy/utils/Initializable.sol +238 -0
  378. package/proxy/utils/UUPSUpgradeable.sol +148 -0
  379. package/token/ERC1155/ERC1155.sol +417 -0
  380. package/token/ERC1155/IERC1155.sol +123 -0
  381. package/token/ERC1155/IERC1155Receiver.sol +59 -0
  382. package/token/ERC1155/extensions/ERC1155Burnable.sol +22 -0
  383. package/token/ERC1155/extensions/ERC1155Crosschain.sol +87 -0
  384. package/token/ERC1155/extensions/ERC1155Pausable.sol +38 -0
  385. package/token/ERC1155/extensions/ERC1155Supply.sol +88 -0
  386. package/token/ERC1155/extensions/ERC1155URIStorage.sol +58 -0
  387. package/token/ERC1155/extensions/IERC1155MetadataURI.sol +20 -0
  388. package/token/ERC1155/utils/ERC1155Holder.sol +42 -0
  389. package/token/ERC1155/utils/ERC1155Utils.sol +88 -0
  390. package/token/ERC20/ERC20.sol +305 -0
  391. package/token/ERC20/IERC20.sol +79 -0
  392. package/token/ERC20/extensions/ERC1363.sol +135 -0
  393. package/token/ERC20/extensions/ERC20Burnable.sol +38 -0
  394. package/token/ERC20/extensions/ERC20Capped.sol +54 -0
  395. package/token/ERC20/extensions/ERC20Crosschain.sol +39 -0
  396. package/token/ERC20/extensions/ERC20FlashMint.sol +130 -0
  397. package/token/ERC20/extensions/ERC20Pausable.sol +33 -0
  398. package/token/ERC20/extensions/ERC20Permit.sol +77 -0
  399. package/token/ERC20/extensions/ERC20TransferAuthorization.sol +91 -0
  400. package/token/ERC20/extensions/ERC20Votes.sol +83 -0
  401. package/token/ERC20/extensions/ERC20Wrapper.sol +93 -0
  402. package/token/ERC20/extensions/ERC4626.sol +304 -0
  403. package/token/ERC20/extensions/IERC20Metadata.sol +26 -0
  404. package/token/ERC20/extensions/IERC20Permit.sol +90 -0
  405. package/token/ERC20/extensions/draft-ERC20Bridgeable.sol +51 -0
  406. package/token/ERC20/extensions/draft-ERC20TemporaryApproval.sol +119 -0
  407. package/token/ERC20/extensions/draft-ERC3009.sol +152 -0
  408. package/token/ERC20/utils/ERC1363Utils.sol +95 -0
  409. package/token/ERC20/utils/SafeERC20.sol +292 -0
  410. package/token/ERC6909/ERC6909.sol +224 -0
  411. package/token/ERC6909/extensions/ERC6909ContentURI.sol +59 -0
  412. package/token/ERC6909/extensions/ERC6909Metadata.sol +83 -0
  413. package/token/ERC6909/extensions/ERC6909TokenSupply.sol +41 -0
  414. package/token/ERC721/ERC721.sol +433 -0
  415. package/token/ERC721/IERC721.sol +135 -0
  416. package/token/ERC721/IERC721Receiver.sol +28 -0
  417. package/token/ERC721/extensions/ERC721Burnable.sol +26 -0
  418. package/token/ERC721/extensions/ERC721Consecutive.sol +176 -0
  419. package/token/ERC721/extensions/ERC721Crosschain.sol +38 -0
  420. package/token/ERC721/extensions/ERC721Enumerable.sol +165 -0
  421. package/token/ERC721/extensions/ERC721Pausable.sol +37 -0
  422. package/token/ERC721/extensions/ERC721Royalty.sol +26 -0
  423. package/token/ERC721/extensions/ERC721URIStorage.sol +62 -0
  424. package/token/ERC721/extensions/ERC721Votes.sol +47 -0
  425. package/token/ERC721/extensions/ERC721Wrapper.sol +102 -0
  426. package/token/ERC721/extensions/IERC721Enumerable.sol +29 -0
  427. package/token/ERC721/extensions/IERC721Metadata.sol +27 -0
  428. package/token/ERC721/utils/ERC721Holder.sol +26 -0
  429. package/token/ERC721/utils/ERC721Utils.sol +50 -0
  430. package/token/common/ERC2981.sol +140 -0
  431. package/utils/Address.sol +167 -0
  432. package/utils/Arrays.sol +905 -0
  433. package/utils/Base58.sol +240 -0
  434. package/utils/Base64.sol +234 -0
  435. package/utils/BlockHeader.sol +312 -0
  436. package/utils/Blockhash.sol +54 -0
  437. package/utils/Bytes.sol +329 -0
  438. package/utils/CAIP10.sol +54 -0
  439. package/utils/CAIP2.sol +51 -0
  440. package/utils/Calldata.sol +25 -0
  441. package/utils/Comparators.sol +19 -0
  442. package/utils/Context.sol +28 -0
  443. package/utils/Create2.sol +91 -0
  444. package/utils/Create3.sol +133 -0
  445. package/utils/ERC6372Utils.sol +53 -0
  446. package/utils/Errors.sol +34 -0
  447. package/utils/LowLevelCall.sol +127 -0
  448. package/utils/Memory.sol +151 -0
  449. package/utils/Multicall.sol +37 -0
  450. package/utils/Nonces.sol +47 -0
  451. package/utils/NoncesKeyed.sol +75 -0
  452. package/utils/Packing.sol +1656 -0
  453. package/utils/Panic.sol +57 -0
  454. package/utils/Pausable.sol +112 -0
  455. package/utils/RLP.sol +487 -0
  456. package/utils/RateLimiter.sol +310 -0
  457. package/utils/ReentrancyGuard.sol +119 -0
  458. package/utils/ReentrancyGuardTransient.sol +84 -0
  459. package/utils/RelayedCall.sol +145 -0
  460. package/utils/ShortStrings.sol +122 -0
  461. package/utils/SimulateCall.sol +114 -0
  462. package/utils/SlotDerivation.sol +155 -0
  463. package/utils/StorageSlot.sol +143 -0
  464. package/utils/Strings.sol +532 -0
  465. package/utils/TransientSlot.sol +183 -0
  466. package/utils/cryptography/ECDSA.sol +284 -0
  467. package/utils/cryptography/EIP712.sol +168 -0
  468. package/utils/cryptography/Hashes.sol +31 -0
  469. package/utils/cryptography/MerkleProof.sol +510 -0
  470. package/utils/cryptography/MessageHashUtils.sol +228 -0
  471. package/utils/cryptography/P256.sol +409 -0
  472. package/utils/cryptography/RSA.sol +159 -0
  473. package/utils/cryptography/SignatureChecker.sol +199 -0
  474. package/utils/cryptography/TrieProof.sol +256 -0
  475. package/utils/cryptography/WebAuthn.sol +269 -0
  476. package/utils/cryptography/draft-ERC7739Utils.sol +215 -0
  477. package/utils/cryptography/signers/AbstractSigner.sol +23 -0
  478. package/utils/cryptography/signers/MultiSignerERC7913.sol +336 -0
  479. package/utils/cryptography/signers/MultiSignerERC7913Weighted.sol +208 -0
  480. package/utils/cryptography/signers/SignerECDSA.sol +56 -0
  481. package/utils/cryptography/signers/SignerEIP7702.sol +25 -0
  482. package/utils/cryptography/signers/SignerERC7913.sol +63 -0
  483. package/utils/cryptography/signers/SignerP256.sol +64 -0
  484. package/utils/cryptography/signers/SignerRSA.sol +65 -0
  485. package/utils/cryptography/signers/SignerWebAuthn.sol +45 -0
  486. package/utils/cryptography/signers/draft-ERC7739.sol +99 -0
  487. package/utils/cryptography/verifiers/ERC7913P256Verifier.sol +29 -0
  488. package/utils/cryptography/verifiers/ERC7913RSAVerifier.sol +23 -0
  489. package/utils/cryptography/verifiers/ERC7913WebAuthnVerifier.sol +45 -0
  490. package/utils/draft-InteroperableAddress.sol +245 -0
  491. package/utils/introspection/ERC165.sol +25 -0
  492. package/utils/introspection/ERC165Checker.sol +142 -0
  493. package/utils/introspection/IERC165.sol +25 -0
  494. package/utils/math/Math.sol +763 -0
  495. package/utils/math/SafeCast.sol +1162 -0
  496. package/utils/math/SignedMath.sol +68 -0
  497. package/utils/structs/Accumulators.sol +135 -0
  498. package/utils/structs/BitMaps.sol +61 -0
  499. package/utils/structs/Checkpoints.sol +881 -0
  500. package/utils/structs/CircularBuffer.sol +152 -0
  501. package/utils/structs/DoubleEndedQueue.sol +280 -0
  502. package/utils/structs/EnumerableMap.sol +1870 -0
  503. package/utils/structs/EnumerableSet.sol +1177 -0
  504. package/utils/structs/Heap.sol +259 -0
  505. package/utils/structs/MerkleTree.sol +267 -0
  506. package/utils/types/Time.sol +133 -0
  507. package/vendor/compound/ICompoundTimelock.sol +86 -0
@@ -0,0 +1,226 @@
1
+ // SPDX-License-Identifier: MIT
2
+ // OpenZeppelin Contracts (last updated v5.8.0) (governance/extensions/GovernorCountingOverridable.sol)
3
+
4
+ pragma solidity ^0.8.24;
5
+
6
+ import {SignatureChecker} from "../../utils/cryptography/SignatureChecker.sol";
7
+ import {SafeCast} from "../../utils/math/SafeCast.sol";
8
+ import {IGovernor, Governor} from "../Governor.sol";
9
+ import {VotesExtended} from "../utils/VotesExtended.sol";
10
+ import {GovernorVotes} from "./GovernorVotes.sol";
11
+
12
+ /**
13
+ * @dev Extension of {Governor} which enables delegators to override the vote of their delegates. This module requires a
14
+ * token that inherits {VotesExtended}.
15
+ *
16
+ * NOTE: Override votes can only be cast while the proposal is active. Mechanisms that shorten the voting duration,
17
+ * such as the early closure implemented in {GovernorSuperQuorum}, may therefore prevent token holders from overriding
18
+ * the votes cast with their tokens by their delegates.
19
+ */
20
+ abstract contract GovernorCountingOverridable is GovernorVotes {
21
+ bytes32 public constant OVERRIDE_BALLOT_TYPEHASH =
22
+ keccak256("OverrideBallot(uint256 proposalId,uint8 support,address voter,uint256 nonce,string reason)");
23
+
24
+ /**
25
+ * @dev Supported vote types. Matches Governor Bravo ordering.
26
+ */
27
+ enum VoteType {
28
+ Against,
29
+ For,
30
+ Abstain
31
+ }
32
+
33
+ struct VoteReceipt {
34
+ uint8 casted; // 0 if vote was not casted. Otherwise: support + 1
35
+ bool hasOverridden;
36
+ uint208 overriddenWeight;
37
+ }
38
+
39
+ struct ProposalVote {
40
+ uint256[3] votes;
41
+ mapping(address voter => VoteReceipt) voteReceipt;
42
+ }
43
+
44
+ /// @dev The votes casted by `delegate` were reduced by `weight` after an override vote was casted by the original token holder
45
+ event VoteReduced(address indexed delegate, uint256 proposalId, uint8 support, uint256 weight);
46
+
47
+ /// @dev A delegated vote on `proposalId` was overridden by `weight`
48
+ event OverrideVoteCast(address indexed voter, uint256 proposalId, uint8 support, uint256 weight, string reason);
49
+
50
+ error GovernorAlreadyOverriddenVote(address account);
51
+
52
+ mapping(uint256 proposalId => ProposalVote) private _proposalVotes;
53
+
54
+ /// @inheritdoc IGovernor
55
+ // solhint-disable-next-line func-name-mixedcase
56
+ function COUNTING_MODE() public pure virtual override returns (string memory) {
57
+ return "support=bravo,override&quorum=for,abstain&overridable=true";
58
+ }
59
+
60
+ /**
61
+ * @dev See {IGovernor-hasVoted}.
62
+ *
63
+ * NOTE: Calling {castVote} (or similar) casts a vote using the voting power that is delegated to the voter.
64
+ * Conversely, calling {castOverrideVote} (or similar) uses the voting power of the account itself, from its asset
65
+ * balances. Casting an "override vote" does not count as voting and won't be reflected by this getter. Consider
66
+ * using {hasVotedOverride} to check if an account has casted an "override vote" for a given proposal id.
67
+ */
68
+ function hasVoted(uint256 proposalId, address account) public view virtual override returns (bool) {
69
+ return _proposalVotes[proposalId].voteReceipt[account].casted != 0;
70
+ }
71
+
72
+ /**
73
+ * @dev Check if an `account` has overridden their delegate for a proposal.
74
+ */
75
+ function hasVotedOverride(uint256 proposalId, address account) public view virtual returns (bool) {
76
+ return _proposalVotes[proposalId].voteReceipt[account].hasOverridden;
77
+ }
78
+
79
+ /**
80
+ * @dev Accessor to the internal vote counts.
81
+ */
82
+ function proposalVotes(
83
+ uint256 proposalId
84
+ ) public view virtual returns (uint256 againstVotes, uint256 forVotes, uint256 abstainVotes) {
85
+ uint256[3] storage votes = _proposalVotes[proposalId].votes;
86
+ return (votes[uint8(VoteType.Against)], votes[uint8(VoteType.For)], votes[uint8(VoteType.Abstain)]);
87
+ }
88
+
89
+ /// @inheritdoc Governor
90
+ function _quorumReached(uint256 proposalId) internal view virtual override returns (bool) {
91
+ uint256[3] storage votes = _proposalVotes[proposalId].votes;
92
+ return quorum(proposalSnapshot(proposalId)) <= votes[uint8(VoteType.For)] + votes[uint8(VoteType.Abstain)];
93
+ }
94
+
95
+ /**
96
+ * @dev See {Governor-_voteSucceeded}. In this module, the forVotes must be strictly over the againstVotes.
97
+ */
98
+ function _voteSucceeded(uint256 proposalId) internal view virtual override returns (bool) {
99
+ uint256[3] storage votes = _proposalVotes[proposalId].votes;
100
+ return votes[uint8(VoteType.For)] > votes[uint8(VoteType.Against)];
101
+ }
102
+
103
+ /**
104
+ * @dev See {Governor-_countVote}. In this module, the support follows the `VoteType` enum (from Governor Bravo).
105
+ *
106
+ * NOTE: called by {Governor-_castVote} which emits the {IGovernor-VoteCast} (or {IGovernor-VoteCastWithParams})
107
+ * event.
108
+ */
109
+ function _countVote(
110
+ uint256 proposalId,
111
+ address account,
112
+ uint8 support,
113
+ uint256 totalWeight,
114
+ bytes memory /*params*/
115
+ ) internal virtual override returns (uint256) {
116
+ ProposalVote storage proposalVote = _proposalVotes[proposalId];
117
+
118
+ if (support > uint8(VoteType.Abstain)) {
119
+ revert GovernorInvalidVoteType();
120
+ }
121
+
122
+ if (proposalVote.voteReceipt[account].casted != 0) {
123
+ revert GovernorAlreadyCastVote(account);
124
+ }
125
+
126
+ totalWeight -= proposalVote.voteReceipt[account].overriddenWeight;
127
+ proposalVote.votes[support] += totalWeight;
128
+ proposalVote.voteReceipt[account].casted = support + 1;
129
+
130
+ return totalWeight;
131
+ }
132
+
133
+ /**
134
+ * @dev Variant of {Governor-_countVote} that deals with vote overrides.
135
+ *
136
+ * NOTE: See {hasVoted} for more details about the difference between {castVote} and {castOverrideVote}.
137
+ */
138
+ function _countOverride(uint256 proposalId, address account, uint8 support) internal virtual returns (uint256) {
139
+ ProposalVote storage proposalVote = _proposalVotes[proposalId];
140
+
141
+ if (support > uint8(VoteType.Abstain)) {
142
+ revert GovernorInvalidVoteType();
143
+ }
144
+
145
+ if (proposalVote.voteReceipt[account].hasOverridden) {
146
+ revert GovernorAlreadyOverriddenVote(account);
147
+ }
148
+
149
+ uint256 snapshot = proposalSnapshot(proposalId);
150
+ uint256 overriddenWeight = VotesExtended(address(token())).getPastBalanceOf(account, snapshot);
151
+ address delegate = VotesExtended(address(token())).getPastDelegate(account, snapshot);
152
+ uint8 delegateCasted = proposalVote.voteReceipt[delegate].casted;
153
+
154
+ proposalVote.voteReceipt[account].hasOverridden = true;
155
+ proposalVote.votes[support] += overriddenWeight;
156
+ if (delegateCasted == 0) {
157
+ proposalVote.voteReceipt[delegate].overriddenWeight += SafeCast.toUint208(overriddenWeight);
158
+ } else {
159
+ uint8 delegateSupport = delegateCasted - 1;
160
+ proposalVote.votes[delegateSupport] -= overriddenWeight;
161
+ emit VoteReduced(delegate, proposalId, delegateSupport, overriddenWeight);
162
+ }
163
+
164
+ return overriddenWeight;
165
+ }
166
+
167
+ /// @dev Variant of {Governor-_castVote} that deals with vote overrides. Returns the overridden weight.
168
+ function _castOverride(
169
+ uint256 proposalId,
170
+ address account,
171
+ uint8 support,
172
+ string calldata reason
173
+ ) internal virtual returns (uint256) {
174
+ _validateStateBitmap(proposalId, _encodeStateBitmap(ProposalState.Active));
175
+
176
+ uint256 overriddenWeight = _countOverride(proposalId, account, support);
177
+
178
+ emit OverrideVoteCast(account, proposalId, support, overriddenWeight, reason);
179
+
180
+ _tallyUpdated(proposalId);
181
+
182
+ return overriddenWeight;
183
+ }
184
+
185
+ /// @dev Public function for casting an override vote. Returns the overridden weight.
186
+ function castOverrideVote(
187
+ uint256 proposalId,
188
+ uint8 support,
189
+ string calldata reason
190
+ ) public virtual returns (uint256) {
191
+ address voter = _msgSender();
192
+ return _castOverride(proposalId, voter, support, reason);
193
+ }
194
+
195
+ /// @dev Public function for casting an override vote using a voter's signature. Returns the overridden weight.
196
+ function castOverrideVoteBySig(
197
+ uint256 proposalId,
198
+ uint8 support,
199
+ address voter,
200
+ string calldata reason,
201
+ bytes calldata signature
202
+ ) public virtual returns (uint256) {
203
+ bool valid = SignatureChecker.isValidSignatureNow(
204
+ voter,
205
+ _hashTypedDataV4(
206
+ keccak256(
207
+ abi.encode(
208
+ OVERRIDE_BALLOT_TYPEHASH,
209
+ proposalId,
210
+ support,
211
+ voter,
212
+ _useNonce(voter),
213
+ keccak256(bytes(reason))
214
+ )
215
+ )
216
+ ),
217
+ signature
218
+ );
219
+
220
+ if (!valid) {
221
+ revert GovernorInvalidSignature(voter);
222
+ }
223
+
224
+ return _castOverride(proposalId, voter, support, reason);
225
+ }
226
+ }
@@ -0,0 +1,96 @@
1
+ // SPDX-License-Identifier: MIT
2
+ // OpenZeppelin Contracts (last updated v5.4.0) (governance/extensions/GovernorCountingSimple.sol)
3
+
4
+ pragma solidity ^0.8.24;
5
+
6
+ import {IGovernor, Governor} from "../Governor.sol";
7
+
8
+ /**
9
+ * @dev Extension of {Governor} for simple, 3 options, vote counting.
10
+ */
11
+ abstract contract GovernorCountingSimple is Governor {
12
+ /**
13
+ * @dev Supported vote types. Matches Governor Bravo ordering.
14
+ */
15
+ enum VoteType {
16
+ Against,
17
+ For,
18
+ Abstain
19
+ }
20
+
21
+ struct ProposalVote {
22
+ uint256 againstVotes;
23
+ uint256 forVotes;
24
+ uint256 abstainVotes;
25
+ mapping(address voter => bool) hasVoted;
26
+ }
27
+
28
+ mapping(uint256 proposalId => ProposalVote) private _proposalVotes;
29
+
30
+ /// @inheritdoc IGovernor
31
+ // solhint-disable-next-line func-name-mixedcase
32
+ function COUNTING_MODE() public pure virtual override returns (string memory) {
33
+ return "support=bravo&quorum=for,abstain";
34
+ }
35
+
36
+ /// @inheritdoc IGovernor
37
+ function hasVoted(uint256 proposalId, address account) public view virtual override returns (bool) {
38
+ return _proposalVotes[proposalId].hasVoted[account];
39
+ }
40
+
41
+ /**
42
+ * @dev Accessor to the internal vote counts.
43
+ */
44
+ function proposalVotes(
45
+ uint256 proposalId
46
+ ) public view virtual returns (uint256 againstVotes, uint256 forVotes, uint256 abstainVotes) {
47
+ ProposalVote storage proposalVote = _proposalVotes[proposalId];
48
+ return (proposalVote.againstVotes, proposalVote.forVotes, proposalVote.abstainVotes);
49
+ }
50
+
51
+ /// @inheritdoc Governor
52
+ function _quorumReached(uint256 proposalId) internal view virtual override returns (bool) {
53
+ ProposalVote storage proposalVote = _proposalVotes[proposalId];
54
+
55
+ return quorum(proposalSnapshot(proposalId)) <= proposalVote.forVotes + proposalVote.abstainVotes;
56
+ }
57
+
58
+ /**
59
+ * @dev See {Governor-_voteSucceeded}. In this module, the forVotes must be strictly over the againstVotes.
60
+ */
61
+ function _voteSucceeded(uint256 proposalId) internal view virtual override returns (bool) {
62
+ ProposalVote storage proposalVote = _proposalVotes[proposalId];
63
+
64
+ return proposalVote.forVotes > proposalVote.againstVotes;
65
+ }
66
+
67
+ /**
68
+ * @dev See {Governor-_countVote}. In this module, the support follows the `VoteType` enum (from Governor Bravo).
69
+ */
70
+ function _countVote(
71
+ uint256 proposalId,
72
+ address account,
73
+ uint8 support,
74
+ uint256 totalWeight,
75
+ bytes memory // params
76
+ ) internal virtual override returns (uint256) {
77
+ ProposalVote storage proposalVote = _proposalVotes[proposalId];
78
+
79
+ if (proposalVote.hasVoted[account]) {
80
+ revert GovernorAlreadyCastVote(account);
81
+ }
82
+ proposalVote.hasVoted[account] = true;
83
+
84
+ if (support == uint8(VoteType.Against)) {
85
+ proposalVote.againstVotes += totalWeight;
86
+ } else if (support == uint8(VoteType.For)) {
87
+ proposalVote.forVotes += totalWeight;
88
+ } else if (support == uint8(VoteType.Abstain)) {
89
+ proposalVote.abstainVotes += totalWeight;
90
+ } else {
91
+ revert GovernorInvalidVoteType();
92
+ }
93
+
94
+ return totalWeight;
95
+ }
96
+ }
@@ -0,0 +1,31 @@
1
+ // SPDX-License-Identifier: MIT
2
+ // OpenZeppelin Contracts (last updated v5.8.0) (governance/extensions/GovernorCrosschain.sol)
3
+
4
+ pragma solidity ^0.8.26;
5
+
6
+ import {Mode} from "../../account/utils/draft-ERC7579Utils.sol";
7
+ import {IERC7786GatewaySource} from "../../interfaces/IERC7786.sol";
8
+ import {Governor} from "../Governor.sol";
9
+
10
+ /// @dev Extension of {Governor} for cross-chain governance through ERC-7786 gateways and {CrosschainRemoteExecutor}.
11
+ abstract contract GovernorCrosschain is Governor {
12
+ /// @dev Send crosschain instruction to an arbitrary remote executor via an arbitrary ERC-7786 gateway.
13
+ function relayCrosschain(
14
+ address gateway,
15
+ bytes memory executor,
16
+ Mode mode,
17
+ bytes memory executionCalldata
18
+ ) public virtual onlyGovernance {
19
+ _crosschainExecute(gateway, executor, mode, executionCalldata);
20
+ }
21
+
22
+ /// @dev Send crosschain instruction to an arbitrary remote executor via an arbitrary ERC-7786 gateway.
23
+ function _crosschainExecute(
24
+ address gateway,
25
+ bytes memory executor,
26
+ Mode mode,
27
+ bytes memory executionCalldata
28
+ ) internal virtual {
29
+ IERC7786GatewaySource(gateway).sendMessage(executor, abi.encodePacked(mode, executionCalldata), new bytes[](0));
30
+ }
31
+ }
@@ -0,0 +1,91 @@
1
+ // SPDX-License-Identifier: MIT
2
+ // OpenZeppelin Contracts (last updated v5.8.0) (governance/extensions/GovernorNoncesKeyed.sol)
3
+
4
+ pragma solidity ^0.8.24;
5
+
6
+ import {SignatureChecker} from "../../utils/cryptography/SignatureChecker.sol";
7
+ import {Nonces} from "../../utils/Nonces.sol";
8
+ import {NoncesKeyed} from "../../utils/NoncesKeyed.sol";
9
+ import {Governor} from "../Governor.sol";
10
+
11
+ /**
12
+ * @dev An extension of {Governor} that extends existing nonce management to use {NoncesKeyed}, where the key is the low-order 192 bits of the `proposalId`.
13
+ * This is useful for voting by signature while maintaining separate sequences of nonces for each proposal.
14
+ *
15
+ * NOTE: Traditional (un-keyed) nonces are still supported and can continue to be used as if this extension was not present.
16
+ */
17
+ abstract contract GovernorNoncesKeyed is Governor, NoncesKeyed {
18
+ function _useCheckedNonce(address owner, uint256 nonce) internal virtual override(Nonces, NoncesKeyed) {
19
+ super._useCheckedNonce(owner, nonce);
20
+ }
21
+
22
+ /**
23
+ * @dev Check the signature against keyed nonce and falls back to the traditional nonce.
24
+ *
25
+ * NOTE: This function won't call `super._validateVoteSig` if the keyed nonce is valid.
26
+ * Side effects may be skipped depending on the linearization of the function.
27
+ */
28
+ function _validateVoteSig(
29
+ uint256 proposalId,
30
+ uint8 support,
31
+ address voter,
32
+ bytes memory signature
33
+ ) internal virtual override returns (bool) {
34
+ if (
35
+ SignatureChecker.isValidSignatureNow(
36
+ voter,
37
+ _hashTypedDataV4(
38
+ keccak256(
39
+ abi.encode(BALLOT_TYPEHASH, proposalId, support, voter, nonces(voter, uint192(proposalId)))
40
+ )
41
+ ),
42
+ signature
43
+ )
44
+ ) {
45
+ _useNonce(voter, uint192(proposalId));
46
+ return true;
47
+ } else {
48
+ return super._validateVoteSig(proposalId, support, voter, signature);
49
+ }
50
+ }
51
+
52
+ /**
53
+ * @dev Check the signature against keyed nonce and falls back to the traditional nonce.
54
+ *
55
+ * NOTE: This function won't call `super._validateExtendedVoteSig` if the keyed nonce is valid.
56
+ * Side effects may be skipped depending on the linearization of the function.
57
+ */
58
+ function _validateExtendedVoteSig(
59
+ uint256 proposalId,
60
+ uint8 support,
61
+ address voter,
62
+ string memory reason,
63
+ bytes memory params,
64
+ bytes memory signature
65
+ ) internal virtual override returns (bool) {
66
+ if (
67
+ SignatureChecker.isValidSignatureNow(
68
+ voter,
69
+ _hashTypedDataV4(
70
+ keccak256(
71
+ abi.encode(
72
+ EXTENDED_BALLOT_TYPEHASH,
73
+ proposalId,
74
+ support,
75
+ voter,
76
+ nonces(voter, uint192(proposalId)),
77
+ keccak256(bytes(reason)),
78
+ keccak256(params)
79
+ )
80
+ )
81
+ ),
82
+ signature
83
+ )
84
+ ) {
85
+ _useNonce(voter, uint192(proposalId));
86
+ return true;
87
+ } else {
88
+ return super._validateExtendedVoteSig(proposalId, support, voter, reason, params, signature);
89
+ }
90
+ }
91
+ }
@@ -0,0 +1,119 @@
1
+ // SPDX-License-Identifier: MIT
2
+ // OpenZeppelin Contracts (last updated v5.8.0) (governance/extensions/GovernorPreventLateQuorum.sol)
3
+
4
+ pragma solidity ^0.8.24;
5
+
6
+ import {Math} from "../../utils/math/Math.sol";
7
+ import {Governor} from "../Governor.sol";
8
+
9
+ /**
10
+ * @dev A module that ensures there is a minimum voting period after quorum is reached. This prevents a large voter from
11
+ * swaying a vote and triggering quorum at the last minute, by ensuring there is always time for other voters to react
12
+ * and try to oppose the decision.
13
+ *
14
+ * If a vote causes quorum to be reached, the proposal's voting period may be extended so that it does not end before at
15
+ * least a specified time has passed (the "vote extension" parameter). This parameter can be set through a governance
16
+ * proposal.
17
+ *
18
+ * NOTE: This module only reacts to the first time a proposal reaches quorum. If quorum can later be lost, for example
19
+ * when combined with {GovernorCountingOverridable}, reaching quorum again will not trigger another vote extension.
20
+ */
21
+ abstract contract GovernorPreventLateQuorum is Governor {
22
+ uint48 private _voteExtension;
23
+
24
+ mapping(uint256 proposalId => uint48) private _extendedDeadlines;
25
+
26
+ /// @dev Emitted when a proposal deadline is pushed back due to reaching quorum late in its voting period.
27
+ event ProposalExtended(uint256 indexed proposalId, uint64 extendedDeadline);
28
+
29
+ /// @dev Emitted when the {lateQuorumVoteExtension} parameter is changed.
30
+ event LateQuorumVoteExtensionSet(uint64 oldVoteExtension, uint64 newVoteExtension);
31
+
32
+ /// @dev Thrown when the {lateQuorumVoteExtension} parameter is set to a value larger than {_maxLateQuorumVoteExtension}.
33
+ error GovernorPreventLateQuorumVoteExtensionTooLarge(uint256 newVoteExtension, uint256 maxVoteExtension);
34
+
35
+ /**
36
+ * @dev Initializes the vote extension parameter: the time in either number of blocks or seconds (depending on the
37
+ * governor clock mode) that is required to pass since the moment a proposal reaches quorum until its voting period
38
+ * ends. If necessary the voting period will be extended beyond the one set during proposal creation.
39
+ */
40
+ constructor(uint48 initialVoteExtension) {
41
+ _setLateQuorumVoteExtension(initialVoteExtension);
42
+ }
43
+
44
+ /**
45
+ * @dev Returns the proposal deadline, which may have been extended beyond that set at proposal creation, if the
46
+ * proposal reached quorum late in the voting period. See {Governor-proposalDeadline}.
47
+ */
48
+ function proposalDeadline(uint256 proposalId) public view virtual override returns (uint256) {
49
+ return Math.max(super.proposalDeadline(proposalId), _extendedDeadlines[proposalId]);
50
+ }
51
+
52
+ /**
53
+ * @dev Vote tally updated and detects if it caused quorum to be reached, potentially extending the voting period.
54
+ *
55
+ * The extended deadline is computed as `clock() + lateQuorumVoteExtension()`. Since {lateQuorumVoteExtension}
56
+ * is bounded by {_maxLateQuorumVoteExtension} when set, this addition cannot overflow in practice and brick
57
+ * governance mid-vote.
58
+ *
59
+ * May emit a {ProposalExtended} event.
60
+ */
61
+ function _tallyUpdated(uint256 proposalId) internal virtual override {
62
+ super._tallyUpdated(proposalId);
63
+ if (_extendedDeadlines[proposalId] == 0 && _quorumReached(proposalId)) {
64
+ uint48 extendedDeadline = clock() + lateQuorumVoteExtension();
65
+
66
+ if (extendedDeadline > proposalDeadline(proposalId)) {
67
+ emit ProposalExtended(proposalId, extendedDeadline);
68
+ }
69
+
70
+ _extendedDeadlines[proposalId] = extendedDeadline;
71
+ }
72
+ }
73
+
74
+ /**
75
+ * @dev Returns the current value of the vote extension parameter: the number of blocks that are required to pass
76
+ * from the time a proposal reaches quorum until its voting period ends.
77
+ */
78
+ function lateQuorumVoteExtension() public view virtual returns (uint48) {
79
+ return _voteExtension;
80
+ }
81
+
82
+ /**
83
+ * @dev Upper bound applied to {lateQuorumVoteExtension} when it is set. Defaults to the voting period,
84
+ * resulting in a total maximum voting period of twice the governor's documented voting period.
85
+ * Can be overridden to provide a different upper bound.
86
+ *
87
+ * NOTE: {_tallyUpdated} adds `lateQuorumVoteExtension()` to `clock()` using `uint48` arithmetic, which is
88
+ * safe under the default bound. Overriding this to a value close to (or greater than) `type(uint48).max`
89
+ * can make that addition overflow and revert the quorum-reaching vote, bricking governance.
90
+ */
91
+ function _maxLateQuorumVoteExtension() internal view virtual returns (uint256) {
92
+ return votingPeriod();
93
+ }
94
+
95
+ /**
96
+ * @dev Changes the {lateQuorumVoteExtension}. This operation can only be performed by the governance executor,
97
+ * generally through a governance proposal.
98
+ *
99
+ * Emits a {LateQuorumVoteExtensionSet} event.
100
+ */
101
+ function setLateQuorumVoteExtension(uint48 newVoteExtension) public virtual onlyGovernance {
102
+ _setLateQuorumVoteExtension(newVoteExtension);
103
+ }
104
+
105
+ /**
106
+ * @dev Changes the {lateQuorumVoteExtension}. This is an internal function that can be exposed in a public function
107
+ * like {setLateQuorumVoteExtension} if another access control mechanism is needed.
108
+ *
109
+ * Emits a {LateQuorumVoteExtensionSet} event.
110
+ */
111
+ function _setLateQuorumVoteExtension(uint48 newVoteExtension) internal virtual {
112
+ uint256 maxVoteExtension = _maxLateQuorumVoteExtension();
113
+ if (newVoteExtension > maxVoteExtension) {
114
+ revert GovernorPreventLateQuorumVoteExtensionTooLarge(newVoteExtension, maxVoteExtension);
115
+ }
116
+ emit LateQuorumVoteExtensionSet(_voteExtension, newVoteExtension);
117
+ _voteExtension = newVoteExtension;
118
+ }
119
+ }
@@ -0,0 +1,59 @@
1
+ // SPDX-License-Identifier: MIT
2
+ // OpenZeppelin Contracts (last updated v5.5.0) (governance/extensions/GovernorProposalGuardian.sol)
3
+
4
+ pragma solidity ^0.8.24;
5
+
6
+ import {Governor} from "../Governor.sol";
7
+
8
+ /**
9
+ * @dev Extension of {Governor} which adds a proposal guardian that can cancel proposals at any stage in the proposal's lifecycle.
10
+ *
11
+ * NOTE: if the proposal guardian is not configured, then proposers take this role for their proposals.
12
+ */
13
+ abstract contract GovernorProposalGuardian is Governor {
14
+ address private _proposalGuardian;
15
+
16
+ event ProposalGuardianSet(address oldProposalGuardian, address newProposalGuardian);
17
+
18
+ /**
19
+ * @dev Getter that returns the address of the proposal guardian.
20
+ */
21
+ function proposalGuardian() public view virtual returns (address) {
22
+ return _proposalGuardian;
23
+ }
24
+
25
+ /**
26
+ * @dev Update the proposal guardian's address. This operation can only be performed through a governance proposal.
27
+ *
28
+ * Emits a {ProposalGuardianSet} event.
29
+ */
30
+ function setProposalGuardian(address newProposalGuardian) public virtual onlyGovernance {
31
+ _setProposalGuardian(newProposalGuardian);
32
+ }
33
+
34
+ /**
35
+ * @dev Internal setter for the proposal guardian.
36
+ *
37
+ * Emits a {ProposalGuardianSet} event.
38
+ */
39
+ function _setProposalGuardian(address newProposalGuardian) internal virtual {
40
+ emit ProposalGuardianSet(_proposalGuardian, newProposalGuardian);
41
+ _proposalGuardian = newProposalGuardian;
42
+ }
43
+
44
+ /**
45
+ * @dev Override {Governor-_validateCancel} to implement the extended cancellation logic.
46
+ *
47
+ * * The {proposalGuardian} can cancel any proposal at any point.
48
+ * * If no proposal guardian is set, the {IGovernor-proposalProposer} can cancel their proposals at any point.
49
+ * * In any case, permissions defined in {Governor-_validateCancel} (or another override) remains valid.
50
+ */
51
+ function _validateCancel(uint256 proposalId, address caller) internal view virtual override returns (bool) {
52
+ address guardian = proposalGuardian();
53
+
54
+ return
55
+ guardian == caller ||
56
+ (guardian == address(0) && caller == proposalProposer(proposalId)) ||
57
+ super._validateCancel(proposalId, caller);
58
+ }
59
+ }