Add ERC-20 option for embedding ERC-7786 based crosschain bridge

.changeset/ninety-ears-slide.md

@@ -0,0 +1,5 @@
+---
+'@openzeppelin/wizard-common': patch
+---
+
+Solidity `erc20`, `stablecoin`, `realWorldAsset`: Support 'erc7786native' option for `crossChainBridging`.

.changeset/sad-cases-yawn.md

@@ -0,0 +1,7 @@
+---
+'@openzeppelin/wizard': patch
+'@openzeppelin/contracts-mcp': patch
+---
+
+Solidity `erc20`, `stablecoin`, `realWorldAsset`: Support 'erc7786native' option for `crossChainBridging`.
+- **Breaking changes**: Solidity `erc20`, `stablecoin`, `realWorldAsset`: 'custom' option for `crossChainBridging` now requires access control, and adds a function to allow updating the token bridge address after deployment. Constructor/initializer parameter order changed due to access control requirement.

packages/common/src/ai/descriptions/solidity.ts

@@ -31,7 +31,9 @@ export const solidityERC20Descriptions = {
   flashmint:
     "Whether to include built-in flash loans to allow lending tokens without requiring collateral as long as they're returned in the same transaction.",
   crossChainBridging:
-    'Whether to allow authorized bridge contracts to mint and burn tokens for cross-chain transfers. Options are to use custom bridges on any chain, or the SuperchainERC20 standard with the predeployed SuperchainTokenBridge. The SuperchainERC20 feature is only available on chains in the Superchain, and requires deploying your contract to the same address on every chain in the Superchain.',
+    'Whether to allow authorized bridge contracts to mint and burn tokens for cross-chain transfers. Options are to use custom bridges on any chain, to embed an ERC-7786 based bridge directly in the token contract, or to use the SuperchainERC20 standard with the predeployed SuperchainTokenBridge. The SuperchainERC20 feature is only available on chains in the Superchain, and requires deploying your contract to the same address on every chain in the Superchain.',
+  crossChainLinkAllowOverride:
+    'Whether to allow replacing a crosschain link that has already been registered. Only used if crossChainBridging is set to "erc7786native".',
   premintChainId: 'The chain ID of the network on which to premint tokens.',
   callback:
     'Whether to include support for code execution after transfers and approvals on recipient contracts in a single transaction.',

packages/core/solidity/hardhat.config.js

@@ -66,6 +66,7 @@ module.exports = {
         enabled: true,
         runs: 200,
       },
+      viaIR: true,
     },
   },
 };

packages/core/solidity/package.json

@@ -28,7 +28,7 @@
   },
   "devDependencies": {
     "@openzeppelin/community-contracts": "git+https://github.com/OpenZeppelin/openzeppelin-community-contracts.git#b0ddd27",
-    "@openzeppelin/contracts": "^5.5.0",
+    "@openzeppelin/contracts": "git+https://github.com/OpenZeppelin/openzeppelin-contracts.git#master",
     "@openzeppelin/contracts-upgradeable": "^5.5.0",
     "@types/node": "^20.0.0",
     "@types/semver": "^7.5.7",
@@ -41,4 +41,4 @@
     "ts-node": "^10.4.0",
     "typescript": "^5.0.0"
   }
-}
+}

packages/core/solidity/remappings.txt

@@ -1,2 +1,3 @@
 @openzeppelin/community-contracts/=node_modules/@openzeppelin/community-contracts/contracts/
 @openzeppelin/contracts-upgradeable/=node_modules/@openzeppelin/contracts-upgradeable/
+@openzeppelin/contracts/=node_modules/@openzeppelin/contracts/contracts/

packages/core/solidity/src/environments/hardhat/package.json

@@ -10,7 +10,7 @@
   "license": "ISC",
   "devDependencies": {
     "@nomicfoundation/hardhat-toolbox": "^6.1.0",
-    "@openzeppelin/contracts": "^5.5.0",
+    "@openzeppelin/contracts": "git+https://github.com/OpenZeppelin/openzeppelin-contracts.git#master",
     "hardhat": "^2.22.0"
   }
 }

packages/core/solidity/src/environments/hardhat/upgradeable/package.json

@@ -10,7 +10,7 @@
   "license": "ISC",
   "devDependencies": {
     "@nomicfoundation/hardhat-toolbox": "^6.1.0",
-    "@openzeppelin/contracts": "^5.5.0",
+    "@openzeppelin/contracts": "git+https://github.com/OpenZeppelin/openzeppelin-contracts.git#master",
     "@openzeppelin/contracts-upgradeable": "^5.5.0",
     "@openzeppelin/hardhat-upgrades": "^3.0.0",
     "hardhat": "^2.22.0"

packages/core/solidity/src/erc20.test.ts

@@ -168,6 +168,42 @@ testERC20('erc20 crossChainBridging custom managed', {
   access: 'managed',
 });
 
+testERC20('erc20 crossChainBridging erc7786native', {
+  crossChainBridging: 'erc7786native',
+});
+
+testERC20('erc20 crossChainBridging erc7786native allowOverride', {
+  crossChainBridging: 'erc7786native',
+  crossChainLinkAllowOverride: true,
+});
+
+testERC20('erc20 crossChainBridging erc7786native ownable', {
+  crossChainBridging: 'erc7786native',
+  access: 'ownable',
+});
+
+testERC20('erc20 crossChainBridging erc7786native ownable mintable burnable', {
+  crossChainBridging: 'erc7786native',
+  access: 'ownable',
+  mintable: true,
+  burnable: true,
+});
+
+testERC20('erc20 crossChainBridging erc7786native roles', {
+  crossChainBridging: 'erc7786native',
+  access: 'roles',
+});
+
+testERC20('erc20 crossChainBridging erc7786native managed', {
+  crossChainBridging: 'erc7786native',
+  access: 'managed',
+});
+
+testERC20('erc20 crossChainBridging erc7786native upgradeable', {
+  crossChainBridging: 'erc7786native',
+  upgradeable: 'transparent',
+});
+
 testERC20('erc20 crossChainBridging superchain', {
   crossChainBridging: 'superchain',
 });