{ "abi": [], "allSourcePaths": { "25": "/home/vscode/.brownie/packages/OpenZeppelin/openzeppelin-contracts@4.8.2/contracts/utils/Strings.sol", "26": "/home/vscode/.brownie/packages/OpenZeppelin/openzeppelin-contracts@4.8.2/contracts/utils/cryptography/ECDSA.sol", "27": "/home/vscode/.brownie/packages/OpenZeppelin/openzeppelin-contracts@4.8.2/contracts/utils/cryptography/EIP712.sol", "30": "/home/vscode/.brownie/packages/OpenZeppelin/openzeppelin-contracts@4.8.2/contracts/utils/math/Math.sol" }, "ast": { "absolutePath": "/home/vscode/.brownie/packages/OpenZeppelin/openzeppelin-contracts@4.8.2/contracts/utils/cryptography/EIP712.sol", "exportedSymbols": { "ECDSA": [ 14129 ], "EIP712": [ 14283 ], "Math": [ 13636 ], "Strings": [ 17301 ] }, "id": 14284, "license": "MIT", "nodeType": "SourceUnit", "nodes": [ { "id": 14131, "literals": [ "solidity", "^", "0.8", ".0" ], "nodeType": "PragmaDirective", "src": "113:23:27" }, { "absolutePath": "/home/vscode/.brownie/packages/OpenZeppelin/openzeppelin-contracts@4.8.2/contracts/utils/cryptography/ECDSA.sol", "file": "./ECDSA.sol", "id": 14132, "nameLocation": "-1:-1:-1", "nodeType": "ImportDirective", "scope": 14284, "sourceUnit": 14130, "src": "138:21:27", "symbolAliases": [], "unitAlias": "" }, { "abstract": true, "baseContracts": [], "canonicalName": "EIP712", "contractDependencies": [], "contractKind": "contract", "documentation": { "id": 14133, "nodeType": "StructuredDocumentation", "src": "161:1142:27", "text": " @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.\n The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,\n thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding\n they need in their contracts using a combination of `abi.encode` and `keccak256`.\n This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding\n scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA\n ({_hashTypedDataV4}).\n The implementation of the domain separator was designed to be as efficient as possible while still properly updating\n the chain id to protect against replay attacks on an eventual fork of the chain.\n NOTE: This contract implements the version of the encoding known as \"v4\", as implemented by the JSON RPC method\n https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].\n _Available since v3.4._" }, "fullyImplemented": true, "id": 14283, "linearizedBaseContracts": [ 14283 ], "name": "EIP712", "nameLocation": "1322:6:27", "nodeType": "ContractDefinition", "nodes": [ { "constant": false, "id": 14135, "mutability": "immutable", "name": "_CACHED_DOMAIN_SEPARATOR", "nameLocation": "1598:24:27", "nodeType": "VariableDeclaration", "scope": 14283, "src": "1572:50:27", "stateVariable": true, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14134, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "1572:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "private" }, { "constant": false, "id": 14137, "mutability": "immutable", "name": "_CACHED_CHAIN_ID", "nameLocation": "1654:16:27", "nodeType": "VariableDeclaration", "scope": 14283, "src": "1628:42:27", "stateVariable": true, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "typeName": { "id": 14136, "name": "uint256", "nodeType": "ElementaryTypeName", "src": "1628:7:27", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "visibility": "private" }, { "constant": false, "id": 14139, "mutability": "immutable", "name": "_CACHED_THIS", "nameLocation": "1702:12:27", "nodeType": "VariableDeclaration", "scope": 14283, "src": "1676:38:27", "stateVariable": true, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" }, "typeName": { "id": 14138, "name": "address", "nodeType": "ElementaryTypeName", "src": "1676:7:27", "stateMutability": "nonpayable", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "visibility": "private" }, { "constant": false, "id": 14141, "mutability": "immutable", "name": "_HASHED_NAME", "nameLocation": "1747:12:27", "nodeType": "VariableDeclaration", "scope": 14283, "src": "1721:38:27", "stateVariable": true, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14140, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "1721:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "private" }, { "constant": false, "id": 14143, "mutability": "immutable", "name": "_HASHED_VERSION", "nameLocation": "1791:15:27", "nodeType": "VariableDeclaration", "scope": 14283, "src": "1765:41:27", "stateVariable": true, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14142, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "1765:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "private" }, { "constant": false, "id": 14145, "mutability": "immutable", "name": "_TYPE_HASH", "nameLocation": "1838:10:27", "nodeType": "VariableDeclaration", "scope": 14283, "src": "1812:36:27", "stateVariable": true, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14144, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "1812:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "private" }, { "body": { "id": 14209, "nodeType": "Block", "src": "2519:547:27", "statements": [ { "assignments": [ 14154 ], "declarations": [ { "constant": false, "id": 14154, "mutability": "mutable", "name": "hashedName", "nameLocation": "2537:10:27", "nodeType": "VariableDeclaration", "scope": 14209, "src": "2529:18:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14153, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "2529:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "id": 14161, "initialValue": { "arguments": [ { "arguments": [ { "id": 14158, "name": "name", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14148, "src": "2566:4:27", "typeDescriptions": { "typeIdentifier": "t_string_memory_ptr", "typeString": "string memory" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_string_memory_ptr", "typeString": "string memory" } ], "id": 14157, "isConstant": false, "isLValue": false, "isPure": true, "lValueRequested": false, "nodeType": "ElementaryTypeNameExpression", "src": "2560:5:27", "typeDescriptions": { "typeIdentifier": "t_type$_t_bytes_storage_ptr_$", "typeString": "type(bytes storage pointer)" }, "typeName": { "id": 14156, "name": "bytes", "nodeType": "ElementaryTypeName", "src": "2560:5:27", "typeDescriptions": {} } }, "id": 14159, "isConstant": false, "isLValue": false, "isPure": false, "kind": "typeConversion", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "2560:11:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes_memory_ptr", "typeString": "bytes memory" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_bytes_memory_ptr", "typeString": "bytes memory" } ], "id": 14155, "name": "keccak256", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -8, "src": "2550:9:27", "typeDescriptions": { "typeIdentifier": "t_function_keccak256_pure$_t_bytes_memory_ptr_$returns$_t_bytes32_$", "typeString": "function (bytes memory) pure returns (bytes32)" } }, "id": 14160, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "2550:22:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "nodeType": "VariableDeclarationStatement", "src": "2529:43:27" }, { "assignments": [ 14163 ], "declarations": [ { "constant": false, "id": 14163, "mutability": "mutable", "name": "hashedVersion", "nameLocation": "2590:13:27", "nodeType": "VariableDeclaration", "scope": 14209, "src": "2582:21:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14162, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "2582:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "id": 14170, "initialValue": { "arguments": [ { "arguments": [ { "id": 14167, "name": "version", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14150, "src": "2622:7:27", "typeDescriptions": { "typeIdentifier": "t_string_memory_ptr", "typeString": "string memory" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_string_memory_ptr", "typeString": "string memory" } ], "id": 14166, "isConstant": false, "isLValue": false, "isPure": true, "lValueRequested": false, "nodeType": "ElementaryTypeNameExpression", "src": "2616:5:27", "typeDescriptions": { "typeIdentifier": "t_type$_t_bytes_storage_ptr_$", "typeString": "type(bytes storage pointer)" }, "typeName": { "id": 14165, "name": "bytes", "nodeType": "ElementaryTypeName", "src": "2616:5:27", "typeDescriptions": {} } }, "id": 14168, "isConstant": false, "isLValue": false, "isPure": false, "kind": "typeConversion", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "2616:14:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes_memory_ptr", "typeString": "bytes memory" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_bytes_memory_ptr", "typeString": "bytes memory" } ], "id": 14164, "name": "keccak256", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -8, "src": "2606:9:27", "typeDescriptions": { "typeIdentifier": "t_function_keccak256_pure$_t_bytes_memory_ptr_$returns$_t_bytes32_$", "typeString": "function (bytes memory) pure returns (bytes32)" } }, "id": 14169, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "2606:25:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "nodeType": "VariableDeclarationStatement", "src": "2582:49:27" }, { "assignments": [ 14172 ], "declarations": [ { "constant": false, "id": 14172, "mutability": "mutable", "name": "typeHash", "nameLocation": "2649:8:27", "nodeType": "VariableDeclaration", "scope": 14209, "src": "2641:16:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14171, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "2641:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "id": 14176, "initialValue": { "arguments": [ { "hexValue": "454950373132446f6d61696e28737472696e67206e616d652c737472696e672076657273696f6e2c75696e7432353620636861696e49642c6164647265737320766572696679696e67436f6e747261637429", "id": 14174, "isConstant": false, "isLValue": false, "isPure": true, "kind": "string", "lValueRequested": false, "nodeType": "Literal", "src": "2683:84:27", "typeDescriptions": { "typeIdentifier": "t_stringliteral_8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f", "typeString": "literal_string \"EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)\"" }, "value": "EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)" } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_stringliteral_8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f", "typeString": "literal_string \"EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)\"" } ], "id": 14173, "name": "keccak256", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -8, "src": "2660:9:27", "typeDescriptions": { "typeIdentifier": "t_function_keccak256_pure$_t_bytes_memory_ptr_$returns$_t_bytes32_$", "typeString": "function (bytes memory) pure returns (bytes32)" } }, "id": 14175, "isConstant": false, "isLValue": false, "isPure": true, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "2660:117:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "nodeType": "VariableDeclarationStatement", "src": "2641:136:27" }, { "expression": { "id": 14179, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftHandSide": { "id": 14177, "name": "_HASHED_NAME", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14141, "src": "2787:12:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "nodeType": "Assignment", "operator": "=", "rightHandSide": { "id": 14178, "name": "hashedName", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14154, "src": "2802:10:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "src": "2787:25:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "id": 14180, "nodeType": "ExpressionStatement", "src": "2787:25:27" }, { "expression": { "id": 14183, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftHandSide": { "id": 14181, "name": "_HASHED_VERSION", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14143, "src": "2822:15:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "nodeType": "Assignment", "operator": "=", "rightHandSide": { "id": 14182, "name": "hashedVersion", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14163, "src": "2840:13:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "src": "2822:31:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "id": 14184, "nodeType": "ExpressionStatement", "src": "2822:31:27" }, { "expression": { "id": 14188, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftHandSide": { "id": 14185, "name": "_CACHED_CHAIN_ID", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14137, "src": "2863:16:27", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "nodeType": "Assignment", "operator": "=", "rightHandSide": { "expression": { "id": 14186, "name": "block", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -4, "src": "2882:5:27", "typeDescriptions": { "typeIdentifier": "t_magic_block", "typeString": "block" } }, "id": 14187, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "memberLocation": "2888:7:27", "memberName": "chainid", "nodeType": "MemberAccess", "src": "2882:13:27", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "src": "2863:32:27", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "id": 14189, "nodeType": "ExpressionStatement", "src": "2863:32:27" }, { "expression": { "id": 14196, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftHandSide": { "id": 14190, "name": "_CACHED_DOMAIN_SEPARATOR", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14135, "src": "2905:24:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "nodeType": "Assignment", "operator": "=", "rightHandSide": { "arguments": [ { "id": 14192, "name": "typeHash", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14172, "src": "2954:8:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "id": 14193, "name": "hashedName", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14154, "src": "2964:10:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "id": 14194, "name": "hashedVersion", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14163, "src": "2976:13:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } ], "id": 14191, "name": "_buildDomainSeparator", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14266, "src": "2932:21:27", "typeDescriptions": { "typeIdentifier": "t_function_internal_view$_t_bytes32_$_t_bytes32_$_t_bytes32_$returns$_t_bytes32_$", "typeString": "function (bytes32,bytes32,bytes32) view returns (bytes32)" } }, "id": 14195, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "2932:58:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "src": "2905:85:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "id": 14197, "nodeType": "ExpressionStatement", "src": "2905:85:27" }, { "expression": { "id": 14203, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftHandSide": { "id": 14198, "name": "_CACHED_THIS", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14139, "src": "3000:12:27", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "nodeType": "Assignment", "operator": "=", "rightHandSide": { "arguments": [ { "id": 14201, "name": "this", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -28, "src": "3023:4:27", "typeDescriptions": { "typeIdentifier": "t_contract$_EIP712_$14283", "typeString": "contract EIP712" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_contract$_EIP712_$14283", "typeString": "contract EIP712" } ], "id": 14200, "isConstant": false, "isLValue": false, "isPure": true, "lValueRequested": false, "nodeType": "ElementaryTypeNameExpression", "src": "3015:7:27", "typeDescriptions": { "typeIdentifier": "t_type$_t_address_$", "typeString": "type(address)" }, "typeName": { "id": 14199, "name": "address", "nodeType": "ElementaryTypeName", "src": "3015:7:27", "typeDescriptions": {} } }, "id": 14202, "isConstant": false, "isLValue": false, "isPure": false, "kind": "typeConversion", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "3015:13:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "src": "3000:28:27", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "id": 14204, "nodeType": "ExpressionStatement", "src": "3000:28:27" }, { "expression": { "id": 14207, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftHandSide": { "id": 14205, "name": "_TYPE_HASH", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14145, "src": "3038:10:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "nodeType": "Assignment", "operator": "=", "rightHandSide": { "id": 14206, "name": "typeHash", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14172, "src": "3051:8:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "src": "3038:21:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "id": 14208, "nodeType": "ExpressionStatement", "src": "3038:21:27" } ] }, "documentation": { "id": 14146, "nodeType": "StructuredDocumentation", "src": "1900:559:27", "text": " @dev Initializes the domain separator and parameter caches.\n The meaning of `name` and `version` is specified in\n https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:\n - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.\n - `version`: the current major version of the signing domain.\n NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart\n contract upgrade]." }, "id": 14210, "implemented": true, "kind": "constructor", "modifiers": [], "name": "", "nameLocation": "-1:-1:-1", "nodeType": "FunctionDefinition", "parameters": { "id": 14151, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 14148, "mutability": "mutable", "name": "name", "nameLocation": "2490:4:27", "nodeType": "VariableDeclaration", "scope": 14210, "src": "2476:18:27", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_string_memory_ptr", "typeString": "string" }, "typeName": { "id": 14147, "name": "string", "nodeType": "ElementaryTypeName", "src": "2476:6:27", "typeDescriptions": { "typeIdentifier": "t_string_storage_ptr", "typeString": "string" } }, "visibility": "internal" }, { "constant": false, "id": 14150, "mutability": "mutable", "name": "version", "nameLocation": "2510:7:27", "nodeType": "VariableDeclaration", "scope": 14210, "src": "2496:21:27", "stateVariable": false, "storageLocation": "memory", "typeDescriptions": { "typeIdentifier": "t_string_memory_ptr", "typeString": "string" }, "typeName": { "id": 14149, "name": "string", "nodeType": "ElementaryTypeName", "src": "2496:6:27", "typeDescriptions": { "typeIdentifier": "t_string_storage_ptr", "typeString": "string" } }, "visibility": "internal" } ], "src": "2475:43:27" }, "returnParameters": { "id": 14152, "nodeType": "ParameterList", "parameters": [], "src": "2519:0:27" }, "scope": 14283, "src": "2464:602:27", "stateMutability": "nonpayable", "virtual": false, "visibility": "internal" }, { "body": { "id": 14238, "nodeType": "Block", "src": "3214:246:27", "statements": [ { "condition": { "commonType": { "typeIdentifier": "t_bool", "typeString": "bool" }, "id": 14226, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftExpression": { "commonType": { "typeIdentifier": "t_address", "typeString": "address" }, "id": 14221, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftExpression": { "arguments": [ { "id": 14218, "name": "this", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -28, "src": "3236:4:27", "typeDescriptions": { "typeIdentifier": "t_contract$_EIP712_$14283", "typeString": "contract EIP712" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_contract$_EIP712_$14283", "typeString": "contract EIP712" } ], "id": 14217, "isConstant": false, "isLValue": false, "isPure": true, "lValueRequested": false, "nodeType": "ElementaryTypeNameExpression", "src": "3228:7:27", "typeDescriptions": { "typeIdentifier": "t_type$_t_address_$", "typeString": "type(address)" }, "typeName": { "id": 14216, "name": "address", "nodeType": "ElementaryTypeName", "src": "3228:7:27", "typeDescriptions": {} } }, "id": 14219, "isConstant": false, "isLValue": false, "isPure": false, "kind": "typeConversion", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "3228:13:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "nodeType": "BinaryOperation", "operator": "==", "rightExpression": { "id": 14220, "name": "_CACHED_THIS", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14139, "src": "3245:12:27", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "src": "3228:29:27", "typeDescriptions": { "typeIdentifier": "t_bool", "typeString": "bool" } }, "nodeType": "BinaryOperation", "operator": "&&", "rightExpression": { "commonType": { "typeIdentifier": "t_uint256", "typeString": "uint256" }, "id": 14225, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "leftExpression": { "expression": { "id": 14222, "name": "block", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -4, "src": "3261:5:27", "typeDescriptions": { "typeIdentifier": "t_magic_block", "typeString": "block" } }, "id": 14223, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "memberLocation": "3267:7:27", "memberName": "chainid", "nodeType": "MemberAccess", "src": "3261:13:27", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "nodeType": "BinaryOperation", "operator": "==", "rightExpression": { "id": 14224, "name": "_CACHED_CHAIN_ID", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14137, "src": "3278:16:27", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, "src": "3261:33:27", "typeDescriptions": { "typeIdentifier": "t_bool", "typeString": "bool" } }, "src": "3228:66:27", "typeDescriptions": { "typeIdentifier": "t_bool", "typeString": "bool" } }, "falseBody": { "id": 14236, "nodeType": "Block", "src": "3358:96:27", "statements": [ { "expression": { "arguments": [ { "id": 14231, "name": "_TYPE_HASH", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14145, "src": "3401:10:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "id": 14232, "name": "_HASHED_NAME", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14141, "src": "3413:12:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "id": 14233, "name": "_HASHED_VERSION", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14143, "src": "3427:15:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } ], "id": 14230, "name": "_buildDomainSeparator", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14266, "src": "3379:21:27", "typeDescriptions": { "typeIdentifier": "t_function_internal_view$_t_bytes32_$_t_bytes32_$_t_bytes32_$returns$_t_bytes32_$", "typeString": "function (bytes32,bytes32,bytes32) view returns (bytes32)" } }, "id": 14234, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "3379:64:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "functionReturnParameters": 14215, "id": 14235, "nodeType": "Return", "src": "3372:71:27" } ] }, "id": 14237, "nodeType": "IfStatement", "src": "3224:230:27", "trueBody": { "id": 14229, "nodeType": "Block", "src": "3296:56:27", "statements": [ { "expression": { "id": 14227, "name": "_CACHED_DOMAIN_SEPARATOR", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14135, "src": "3317:24:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "functionReturnParameters": 14215, "id": 14228, "nodeType": "Return", "src": "3310:31:27" } ] } } ] }, "documentation": { "id": 14211, "nodeType": "StructuredDocumentation", "src": "3072:75:27", "text": " @dev Returns the domain separator for the current chain." }, "id": 14239, "implemented": true, "kind": "function", "modifiers": [], "name": "_domainSeparatorV4", "nameLocation": "3161:18:27", "nodeType": "FunctionDefinition", "parameters": { "id": 14212, "nodeType": "ParameterList", "parameters": [], "src": "3179:2:27" }, "returnParameters": { "id": 14215, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 14214, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 14239, "src": "3205:7:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14213, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "3205:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "src": "3204:9:27" }, "scope": 14283, "src": "3152:308:27", "stateMutability": "view", "virtual": false, "visibility": "internal" }, { "body": { "id": 14265, "nodeType": "Block", "src": "3615:108:27", "statements": [ { "expression": { "arguments": [ { "arguments": [ { "id": 14253, "name": "typeHash", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14241, "src": "3653:8:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "id": 14254, "name": "nameHash", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14243, "src": "3663:8:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "id": 14255, "name": "versionHash", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14245, "src": "3673:11:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "expression": { "id": 14256, "name": "block", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -4, "src": "3686:5:27", "typeDescriptions": { "typeIdentifier": "t_magic_block", "typeString": "block" } }, "id": 14257, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "memberLocation": "3692:7:27", "memberName": "chainid", "nodeType": "MemberAccess", "src": "3686:13:27", "typeDescriptions": { "typeIdentifier": "t_uint256", "typeString": "uint256" } }, { "arguments": [ { "id": 14260, "name": "this", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -28, "src": "3709:4:27", "typeDescriptions": { "typeIdentifier": "t_contract$_EIP712_$14283", "typeString": "contract EIP712" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_contract$_EIP712_$14283", "typeString": "contract EIP712" } ], "id": 14259, "isConstant": false, "isLValue": false, "isPure": true, "lValueRequested": false, "nodeType": "ElementaryTypeNameExpression", "src": "3701:7:27", "typeDescriptions": { "typeIdentifier": "t_type$_t_address_$", "typeString": "type(address)" }, "typeName": { "id": 14258, "name": "address", "nodeType": "ElementaryTypeName", "src": "3701:7:27", "typeDescriptions": {} } }, "id": 14261, "isConstant": false, "isLValue": false, "isPure": false, "kind": "typeConversion", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "3701:13:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_uint256", "typeString": "uint256" }, { "typeIdentifier": "t_address", "typeString": "address" } ], "expression": { "id": 14251, "name": "abi", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -1, "src": "3642:3:27", "typeDescriptions": { "typeIdentifier": "t_magic_abi", "typeString": "abi" } }, "id": 14252, "isConstant": false, "isLValue": false, "isPure": true, "lValueRequested": false, "memberLocation": "3646:6:27", "memberName": "encode", "nodeType": "MemberAccess", "src": "3642:10:27", "typeDescriptions": { "typeIdentifier": "t_function_abiencode_pure$__$returns$_t_bytes_memory_ptr_$", "typeString": "function () pure returns (bytes memory)" } }, "id": 14262, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "3642:73:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes_memory_ptr", "typeString": "bytes memory" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_bytes_memory_ptr", "typeString": "bytes memory" } ], "id": 14250, "name": "keccak256", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": -8, "src": "3632:9:27", "typeDescriptions": { "typeIdentifier": "t_function_keccak256_pure$_t_bytes_memory_ptr_$returns$_t_bytes32_$", "typeString": "function (bytes memory) pure returns (bytes32)" } }, "id": 14263, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "3632:84:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "functionReturnParameters": 14249, "id": 14264, "nodeType": "Return", "src": "3625:91:27" } ] }, "id": 14266, "implemented": true, "kind": "function", "modifiers": [], "name": "_buildDomainSeparator", "nameLocation": "3475:21:27", "nodeType": "FunctionDefinition", "parameters": { "id": 14246, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 14241, "mutability": "mutable", "name": "typeHash", "nameLocation": "3514:8:27", "nodeType": "VariableDeclaration", "scope": 14266, "src": "3506:16:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14240, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "3506:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" }, { "constant": false, "id": 14243, "mutability": "mutable", "name": "nameHash", "nameLocation": "3540:8:27", "nodeType": "VariableDeclaration", "scope": 14266, "src": "3532:16:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14242, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "3532:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" }, { "constant": false, "id": 14245, "mutability": "mutable", "name": "versionHash", "nameLocation": "3566:11:27", "nodeType": "VariableDeclaration", "scope": 14266, "src": "3558:19:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14244, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "3558:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "src": "3496:87:27" }, "returnParameters": { "id": 14249, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 14248, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 14266, "src": "3606:7:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14247, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "3606:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "src": "3605:9:27" }, "scope": 14283, "src": "3466:257:27", "stateMutability": "view", "virtual": false, "visibility": "private" }, { "body": { "id": 14281, "nodeType": "Block", "src": "4434:79:27", "statements": [ { "expression": { "arguments": [ { "arguments": [], "expression": { "argumentTypes": [], "id": 14276, "name": "_domainSeparatorV4", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14239, "src": "4473:18:27", "typeDescriptions": { "typeIdentifier": "t_function_internal_view$__$returns$_t_bytes32_$", "typeString": "function () view returns (bytes32)" } }, "id": 14277, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "4473:20:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, { "id": 14278, "name": "structHash", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14269, "src": "4495:10:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } ], "expression": { "id": 14274, "name": "ECDSA", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 14129, "src": "4451:5:27", "typeDescriptions": { "typeIdentifier": "t_type$_t_contract$_ECDSA_$14129_$", "typeString": "type(library ECDSA)" } }, "id": 14275, "isConstant": false, "isLValue": false, "isPure": false, "lValueRequested": false, "memberLocation": "4457:15:27", "memberName": "toTypedDataHash", "nodeType": "MemberAccess", "referencedDeclaration": 14128, "src": "4451:21:27", "typeDescriptions": { "typeIdentifier": "t_function_internal_pure$_t_bytes32_$_t_bytes32_$returns$_t_bytes32_$", "typeString": "function (bytes32,bytes32) pure returns (bytes32)" } }, "id": 14279, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "nameLocations": [], "names": [], "nodeType": "FunctionCall", "src": "4451:55:27", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "functionReturnParameters": 14273, "id": 14280, "nodeType": "Return", "src": "4444:62:27" } ] }, "documentation": { "id": 14267, "nodeType": "StructuredDocumentation", "src": "3729:614:27", "text": " @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this\n function returns the hash of the fully encoded EIP712 message for this domain.\n This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:\n ```solidity\n bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(\n keccak256(\"Mail(address to,string contents)\"),\n mailTo,\n keccak256(bytes(mailContents))\n )));\n address signer = ECDSA.recover(digest, signature);\n ```" }, "id": 14282, "implemented": true, "kind": "function", "modifiers": [], "name": "_hashTypedDataV4", "nameLocation": "4357:16:27", "nodeType": "FunctionDefinition", "parameters": { "id": 14270, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 14269, "mutability": "mutable", "name": "structHash", "nameLocation": "4382:10:27", "nodeType": "VariableDeclaration", "scope": 14282, "src": "4374:18:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14268, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "4374:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "src": "4373:20:27" }, "returnParameters": { "id": 14273, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 14272, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 14282, "src": "4425:7:27", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" }, "typeName": { "id": 14271, "name": "bytes32", "nodeType": "ElementaryTypeName", "src": "4425:7:27", "typeDescriptions": { "typeIdentifier": "t_bytes32", "typeString": "bytes32" } }, "visibility": "internal" } ], "src": "4424:9:27" }, "scope": 14283, "src": "4348:165:27", "stateMutability": "view", "virtual": true, "visibility": "internal" } ], "scope": 14284, "src": "1304:3211:27", "usedErrors": [] } ], "src": "113:4403:27" }, "bytecode": "", "bytecodeSha1": "da39a3ee5e6b4b0d3255bfef95601890afd80709", "compiler": { "evm_version": "istanbul", "optimizer": { "enabled": true, "runs": 200 }, "version": "0.8.19+commit.7dd6d404" }, "contractName": "EIP712", "coverageMap": { "branches": {}, "statements": {} }, "dependencies": [ "OpenZeppelin/openzeppelin-contracts@4.8.2/ECDSA", "OpenZeppelin/openzeppelin-contracts@4.8.2/Math", "OpenZeppelin/openzeppelin-contracts@4.8.2/Strings" ], "deployedBytecode": "", "deployedSourceMap": "", "language": "Solidity", "natspec": { "details": "https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data. The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible, thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding they need in their contracts using a combination of `abi.encode` and `keccak256`. This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA ({_hashTypedDataV4}). The implementation of the domain separator was designed to be as efficient as possible while still properly updating the chain id to protect against replay attacks on an eventual fork of the chain. NOTE: This contract implements the version of the encoding known as \"v4\", as implemented by the JSON RPC method https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask]. _Available since v3.4._", "kind": "dev", "methods": { "constructor": { "details": "Initializes the domain separator and parameter caches. The meaning of `name` and `version` is specified in https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]: - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol. - `version`: the current major version of the signing domain. NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart contract upgrade]." } }, "version": 1 }, "offset": [ 1304, 4515 ], "opcodes": "", "pcMap": {}, "sha1": "28c33553c2f5e6d1280d6042eba89f391523b8bc", "source": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.8.0) (utils/cryptography/EIP712.sol)\n\npragma solidity ^0.8.0;\n\nimport \"./ECDSA.sol\";\n\n/**\n * @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.\n *\n * The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,\n * thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding\n * they need in their contracts using a combination of `abi.encode` and `keccak256`.\n *\n * This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding\n * scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA\n * ({_hashTypedDataV4}).\n *\n * The implementation of the domain separator was designed to be as efficient as possible while still properly updating\n * the chain id to protect against replay attacks on an eventual fork of the chain.\n *\n * NOTE: This contract implements the version of the encoding known as \"v4\", as implemented by the JSON RPC method\n * https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].\n *\n * _Available since v3.4._\n */\nabstract contract EIP712 {\n /* solhint-disable var-name-mixedcase */\n // Cache the domain separator as an immutable value, but also store the chain id that it corresponds to, in order to\n // invalidate the cached domain separator if the chain id changes.\n bytes32 private immutable _CACHED_DOMAIN_SEPARATOR;\n uint256 private immutable _CACHED_CHAIN_ID;\n address private immutable _CACHED_THIS;\n\n bytes32 private immutable _HASHED_NAME;\n bytes32 private immutable _HASHED_VERSION;\n bytes32 private immutable _TYPE_HASH;\n\n /* solhint-enable var-name-mixedcase */\n\n /**\n * @dev Initializes the domain separator and parameter caches.\n *\n * The meaning of `name` and `version` is specified in\n * https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:\n *\n * - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.\n * - `version`: the current major version of the signing domain.\n *\n * NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart\n * contract upgrade].\n */\n constructor(string memory name, string memory version) {\n bytes32 hashedName = keccak256(bytes(name));\n bytes32 hashedVersion = keccak256(bytes(version));\n bytes32 typeHash = keccak256(\n \"EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)\"\n );\n _HASHED_NAME = hashedName;\n _HASHED_VERSION = hashedVersion;\n _CACHED_CHAIN_ID = block.chainid;\n _CACHED_DOMAIN_SEPARATOR = _buildDomainSeparator(typeHash, hashedName, hashedVersion);\n _CACHED_THIS = address(this);\n _TYPE_HASH = typeHash;\n }\n\n /**\n * @dev Returns the domain separator for the current chain.\n */\n function _domainSeparatorV4() internal view returns (bytes32) {\n if (address(this) == _CACHED_THIS && block.chainid == _CACHED_CHAIN_ID) {\n return _CACHED_DOMAIN_SEPARATOR;\n } else {\n return _buildDomainSeparator(_TYPE_HASH, _HASHED_NAME, _HASHED_VERSION);\n }\n }\n\n function _buildDomainSeparator(\n bytes32 typeHash,\n bytes32 nameHash,\n bytes32 versionHash\n ) private view returns (bytes32) {\n return keccak256(abi.encode(typeHash, nameHash, versionHash, block.chainid, address(this)));\n }\n\n /**\n * @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this\n * function returns the hash of the fully encoded EIP712 message for this domain.\n *\n * This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:\n *\n * ```solidity\n * bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(\n * keccak256(\"Mail(address to,string contents)\"),\n * mailTo,\n * keccak256(bytes(mailContents))\n * )));\n * address signer = ECDSA.recover(digest, signature);\n * ```\n */\n function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {\n return ECDSA.toTypedDataHash(_domainSeparatorV4(), structHash);\n }\n}\n", "sourceMap": "", "sourcePath": "/home/vscode/.brownie/packages/OpenZeppelin/openzeppelin-contracts@4.8.2/contracts/utils/cryptography/EIP712.sol", "type": "contract" }