{ "abi": [ { "stateMutability": "payable", "type": "fallback" }, { "stateMutability": "payable", "type": "receive" } ], "allSourcePaths": { "94": "node_modules/@openzeppelin/contracts/proxy/Proxy.sol" }, "ast": { "absolutePath": "node_modules/@openzeppelin/contracts/proxy/Proxy.sol", "exportedSymbols": { "Proxy": [ 19871 ] }, "id": 19872, "license": "MIT", "nodeType": "SourceUnit", "nodes": [ { "id": 19821, "literals": [ "solidity", "^", "0.8", ".0" ], "nodeType": "PragmaDirective", "src": "99:23:94" }, { "abstract": true, "baseContracts": [], "contractDependencies": [], "contractKind": "contract", "documentation": { "id": 19822, "nodeType": "StructuredDocumentation", "src": "124:598:94", "text": " @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\n instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\n be specified by overriding the virtual {_implementation} function.\n Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\n different contract through the {_delegate} function.\n The success and return data of the delegated call will be returned back to the caller of the proxy." }, "fullyImplemented": false, "id": 19871, "linearizedBaseContracts": [ 19871 ], "name": "Proxy", "nameLocation": "741:5:94", "nodeType": "ContractDefinition", "nodes": [ { "body": { "id": 19829, "nodeType": "Block", "src": "1008:835:94", "statements": [ { "AST": { "nodeType": "YulBlock", "src": "1027:810:94", "statements": [ { "expression": { "arguments": [ { "kind": "number", "nodeType": "YulLiteral", "src": "1280:1:94", "type": "", "value": "0" }, { "kind": "number", "nodeType": "YulLiteral", "src": "1283:1:94", "type": "", "value": "0" }, { "arguments": [], "functionName": { "name": "calldatasize", "nodeType": "YulIdentifier", "src": "1286:12:94" }, "nodeType": "YulFunctionCall", "src": "1286:14:94" } ], "functionName": { "name": "calldatacopy", "nodeType": "YulIdentifier", "src": "1267:12:94" }, "nodeType": "YulFunctionCall", "src": "1267:34:94" }, "nodeType": "YulExpressionStatement", "src": "1267:34:94" }, { "nodeType": "YulVariableDeclaration", "src": "1428:74:94", "value": { "arguments": [ { "arguments": [], "functionName": { "name": "gas", "nodeType": "YulIdentifier", "src": "1455:3:94" }, "nodeType": "YulFunctionCall", "src": "1455:5:94" }, { "name": "implementation", "nodeType": "YulIdentifier", "src": "1462:14:94" }, { "kind": "number", "nodeType": "YulLiteral", "src": "1478:1:94", "type": "", "value": "0" }, { "arguments": [], "functionName": { "name": "calldatasize", "nodeType": "YulIdentifier", "src": "1481:12:94" }, "nodeType": "YulFunctionCall", "src": "1481:14:94" }, { "kind": "number", "nodeType": "YulLiteral", "src": "1497:1:94", "type": "", "value": "0" }, { "kind": "number", "nodeType": "YulLiteral", "src": "1500:1:94", "type": "", "value": "0" } ], "functionName": { "name": "delegatecall", "nodeType": "YulIdentifier", "src": "1442:12:94" }, "nodeType": "YulFunctionCall", "src": "1442:60:94" }, "variables": [ { "name": "result", "nodeType": "YulTypedName", "src": "1432:6:94", "type": "" } ] }, { "expression": { "arguments": [ { "kind": "number", "nodeType": "YulLiteral", "src": "1570:1:94", "type": "", "value": "0" }, { "kind": "number", "nodeType": "YulLiteral", "src": "1573:1:94", "type": "", "value": "0" }, { "arguments": [], "functionName": { "name": "returndatasize", "nodeType": "YulIdentifier", "src": "1576:14:94" }, "nodeType": "YulFunctionCall", "src": "1576:16:94" } ], "functionName": { "name": "returndatacopy", "nodeType": "YulIdentifier", "src": "1555:14:94" }, "nodeType": "YulFunctionCall", "src": "1555:38:94" }, "nodeType": "YulExpressionStatement", "src": "1555:38:94" }, { "cases": [ { "body": { "nodeType": "YulBlock", "src": "1688:59:94", "statements": [ { "expression": { "arguments": [ { "kind": "number", "nodeType": "YulLiteral", "src": "1713:1:94", "type": "", "value": "0" }, { "arguments": [], "functionName": { "name": "returndatasize", "nodeType": "YulIdentifier", "src": "1716:14:94" }, "nodeType": "YulFunctionCall", "src": "1716:16:94" } ], "functionName": { "name": "revert", "nodeType": "YulIdentifier", "src": "1706:6:94" }, "nodeType": "YulFunctionCall", "src": "1706:27:94" }, "nodeType": "YulExpressionStatement", "src": "1706:27:94" } ] }, "nodeType": "YulCase", "src": "1681:66:94", "value": { "kind": "number", "nodeType": "YulLiteral", "src": "1686:1:94", "type": "", "value": "0" } }, { "body": { "nodeType": "YulBlock", "src": "1768:59:94", "statements": [ { "expression": { "arguments": [ { "kind": "number", "nodeType": "YulLiteral", "src": "1793:1:94", "type": "", "value": "0" }, { "arguments": [], "functionName": { "name": "returndatasize", "nodeType": "YulIdentifier", "src": "1796:14:94" }, "nodeType": "YulFunctionCall", "src": "1796:16:94" } ], "functionName": { "name": "return", "nodeType": "YulIdentifier", "src": "1786:6:94" }, "nodeType": "YulFunctionCall", "src": "1786:27:94" }, "nodeType": "YulExpressionStatement", "src": "1786:27:94" } ] }, "nodeType": "YulCase", "src": "1760:67:94", "value": "default" } ], "expression": { "name": "result", "nodeType": "YulIdentifier", "src": "1614:6:94" }, "nodeType": "YulSwitch", "src": "1607:220:94" } ] }, "evmVersion": "istanbul", "externalReferences": [ { "declaration": 19825, "isOffset": false, "isSlot": false, "src": "1462:14:94", "valueSize": 1 } ], "id": 19828, "nodeType": "InlineAssembly", "src": "1018:819:94" } ] }, "documentation": { "id": 19823, "nodeType": "StructuredDocumentation", "src": "753:190:94", "text": " @dev Delegates the current call to `implementation`.\n This function does not return to its internal call site, it will return directly to the external caller." }, "id": 19830, "implemented": true, "kind": "function", "modifiers": [], "name": "_delegate", "nameLocation": "957:9:94", "nodeType": "FunctionDefinition", "parameters": { "id": 19826, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 19825, "mutability": "mutable", "name": "implementation", "nameLocation": "975:14:94", "nodeType": "VariableDeclaration", "scope": 19830, "src": "967:22:94", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" }, "typeName": { "id": 19824, "name": "address", "nodeType": "ElementaryTypeName", "src": "967:7:94", "stateMutability": "nonpayable", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "visibility": "internal" } ], "src": "966:24:94" }, "returnParameters": { "id": 19827, "nodeType": "ParameterList", "parameters": [], "src": "1008:0:94" }, "scope": 19871, "src": "948:895:94", "stateMutability": "nonpayable", "virtual": true, "visibility": "internal" }, { "documentation": { "id": 19831, "nodeType": "StructuredDocumentation", "src": "1849:172:94", "text": " @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\n and {_fallback} should delegate." }, "id": 19836, "implemented": false, "kind": "function", "modifiers": [], "name": "_implementation", "nameLocation": "2035:15:94", "nodeType": "FunctionDefinition", "parameters": { "id": 19832, "nodeType": "ParameterList", "parameters": [], "src": "2050:2:94" }, "returnParameters": { "id": 19835, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 19834, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 19836, "src": "2084:7:94", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" }, "typeName": { "id": 19833, "name": "address", "nodeType": "ElementaryTypeName", "src": "2084:7:94", "stateMutability": "nonpayable", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "visibility": "internal" } ], "src": "2083:9:94" }, "scope": 19871, "src": "2026:67:94", "stateMutability": "view", "virtual": true, "visibility": "internal" }, { "body": { "id": 19848, "nodeType": "Block", "src": "2360:72:94", "statements": [ { "expression": { "arguments": [], "expression": { "argumentTypes": [], "id": 19840, "name": "_beforeFallback", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 19870, "src": "2370:15:94", "typeDescriptions": { "typeIdentifier": "t_function_internal_nonpayable$__$returns$__$", "typeString": "function ()" } }, "id": 19841, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "names": [], "nodeType": "FunctionCall", "src": "2370:17:94", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_tuple$__$", "typeString": "tuple()" } }, "id": 19842, "nodeType": "ExpressionStatement", "src": "2370:17:94" }, { "expression": { "arguments": [ { "arguments": [], "expression": { "argumentTypes": [], "id": 19844, "name": "_implementation", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 19836, "src": "2407:15:94", "typeDescriptions": { "typeIdentifier": "t_function_internal_view$__$returns$_t_address_$", "typeString": "function () view returns (address)" } }, "id": 19845, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "names": [], "nodeType": "FunctionCall", "src": "2407:17:94", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } } ], "expression": { "argumentTypes": [ { "typeIdentifier": "t_address", "typeString": "address" } ], "id": 19843, "name": "_delegate", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 19830, "src": "2397:9:94", "typeDescriptions": { "typeIdentifier": "t_function_internal_nonpayable$_t_address_$returns$__$", "typeString": "function (address)" } }, "id": 19846, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "names": [], "nodeType": "FunctionCall", "src": "2397:28:94", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_tuple$__$", "typeString": "tuple()" } }, "id": 19847, "nodeType": "ExpressionStatement", "src": "2397:28:94" } ] }, "documentation": { "id": 19837, "nodeType": "StructuredDocumentation", "src": "2099:218:94", "text": " @dev Delegates the current call to the address returned by `_implementation()`.\n This function does not return to its internall call site, it will return directly to the external caller." }, "id": 19849, "implemented": true, "kind": "function", "modifiers": [], "name": "_fallback", "nameLocation": "2331:9:94", "nodeType": "FunctionDefinition", "parameters": { "id": 19838, "nodeType": "ParameterList", "parameters": [], "src": "2340:2:94" }, "returnParameters": { "id": 19839, "nodeType": "ParameterList", "parameters": [], "src": "2360:0:94" }, "scope": 19871, "src": "2322:110:94", "stateMutability": "nonpayable", "virtual": true, "visibility": "internal" }, { "body": { "id": 19856, "nodeType": "Block", "src": "2665:28:94", "statements": [ { "expression": { "arguments": [], "expression": { "argumentTypes": [], "id": 19853, "name": "_fallback", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 19849, "src": "2675:9:94", "typeDescriptions": { "typeIdentifier": "t_function_internal_nonpayable$__$returns$__$", "typeString": "function ()" } }, "id": 19854, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "names": [], "nodeType": "FunctionCall", "src": "2675:11:94", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_tuple$__$", "typeString": "tuple()" } }, "id": 19855, "nodeType": "ExpressionStatement", "src": "2675:11:94" } ] }, "documentation": { "id": 19850, "nodeType": "StructuredDocumentation", "src": "2438:186:94", "text": " @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\n function in the contract matches the call data." }, "id": 19857, "implemented": true, "kind": "fallback", "modifiers": [], "name": "", "nameLocation": "-1:-1:-1", "nodeType": "FunctionDefinition", "parameters": { "id": 19851, "nodeType": "ParameterList", "parameters": [], "src": "2637:2:94" }, "returnParameters": { "id": 19852, "nodeType": "ParameterList", "parameters": [], "src": "2665:0:94" }, "scope": 19871, "src": "2629:64:94", "stateMutability": "payable", "virtual": true, "visibility": "external" }, { "body": { "id": 19864, "nodeType": "Block", "src": "2888:28:94", "statements": [ { "expression": { "arguments": [], "expression": { "argumentTypes": [], "id": 19861, "name": "_fallback", "nodeType": "Identifier", "overloadedDeclarations": [], "referencedDeclaration": 19849, "src": "2898:9:94", "typeDescriptions": { "typeIdentifier": "t_function_internal_nonpayable$__$returns$__$", "typeString": "function ()" } }, "id": 19862, "isConstant": false, "isLValue": false, "isPure": false, "kind": "functionCall", "lValueRequested": false, "names": [], "nodeType": "FunctionCall", "src": "2898:11:94", "tryCall": false, "typeDescriptions": { "typeIdentifier": "t_tuple$__$", "typeString": "tuple()" } }, "id": 19863, "nodeType": "ExpressionStatement", "src": "2898:11:94" } ] }, "documentation": { "id": 19858, "nodeType": "StructuredDocumentation", "src": "2699:149:94", "text": " @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\n is empty." }, "id": 19865, "implemented": true, "kind": "receive", "modifiers": [], "name": "", "nameLocation": "-1:-1:-1", "nodeType": "FunctionDefinition", "parameters": { "id": 19859, "nodeType": "ParameterList", "parameters": [], "src": "2860:2:94" }, "returnParameters": { "id": 19860, "nodeType": "ParameterList", "parameters": [], "src": "2888:0:94" }, "scope": 19871, "src": "2853:63:94", "stateMutability": "payable", "virtual": true, "visibility": "external" }, { "body": { "id": 19869, "nodeType": "Block", "src": "3241:2:94", "statements": [] }, "documentation": { "id": 19866, "nodeType": "StructuredDocumentation", "src": "2922:270:94", "text": " @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\n call, or as part of the Solidity `fallback` or `receive` functions.\n If overriden should call `super._beforeFallback()`." }, "id": 19870, "implemented": true, "kind": "function", "modifiers": [], "name": "_beforeFallback", "nameLocation": "3206:15:94", "nodeType": "FunctionDefinition", "parameters": { "id": 19867, "nodeType": "ParameterList", "parameters": [], "src": "3221:2:94" }, "returnParameters": { "id": 19868, "nodeType": "ParameterList", "parameters": [], "src": "3241:0:94" }, "scope": 19871, "src": "3197:46:94", "stateMutability": "nonpayable", "virtual": true, "visibility": "internal" } ], "scope": 19872, "src": "723:2522:94", "usedErrors": [] } ], "src": "99:3147:94" }, "bytecode": "", "bytecodeSha1": "da39a3ee5e6b4b0d3255bfef95601890afd80709", "compiler": { "evm_version": "istanbul", "optimizer": { "enabled": true, "runs": 200 }, "version": "0.8.6+commit.11564f7e" }, "contractName": "Proxy", "coverageMap": { "branches": {}, "statements": {} }, "dependencies": [], "deployedBytecode": "", "deployedSourceMap": "", "language": "Solidity", "natspec": { "details": "This abstract contract provides a fallback function that delegates all calls to another contract using the EVM instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to be specified by overriding the virtual {_implementation} function. Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a different contract through the {_delegate} function. The success and return data of the delegated call will be returned back to the caller of the proxy.", "kind": "dev", "methods": {}, "version": 1 }, "offset": [ 723, 3245 ], "opcodes": "", "pcMap": {}, "sha1": "a95cc69ada1de74090f3d206e8048c1e1dc7b39d", "source": "// SPDX-License-Identifier: MIT\n// OpenZeppelin Contracts (last updated v4.5.0) (proxy/Proxy.sol)\n\npragma solidity ^0.8.0;\n\n/**\n * @dev This abstract contract provides a fallback function that delegates all calls to another contract using the EVM\n * instruction `delegatecall`. We refer to the second contract as the _implementation_ behind the proxy, and it has to\n * be specified by overriding the virtual {_implementation} function.\n *\n * Additionally, delegation to the implementation can be triggered manually through the {_fallback} function, or to a\n * different contract through the {_delegate} function.\n *\n * The success and return data of the delegated call will be returned back to the caller of the proxy.\n */\nabstract contract Proxy {\n /**\n * @dev Delegates the current call to `implementation`.\n *\n * This function does not return to its internal call site, it will return directly to the external caller.\n */\n function _delegate(address implementation) internal virtual {\n assembly {\n // Copy msg.data. We take full control of memory in this inline assembly\n // block because it will not return to Solidity code. We overwrite the\n // Solidity scratch pad at memory position 0.\n calldatacopy(0, 0, calldatasize())\n\n // Call the implementation.\n // out and outsize are 0 because we don't know the size yet.\n let result := delegatecall(gas(), implementation, 0, calldatasize(), 0, 0)\n\n // Copy the returned data.\n returndatacopy(0, 0, returndatasize())\n\n switch result\n // delegatecall returns 0 on error.\n case 0 {\n revert(0, returndatasize())\n }\n default {\n return(0, returndatasize())\n }\n }\n }\n\n /**\n * @dev This is a virtual function that should be overriden so it returns the address to which the fallback function\n * and {_fallback} should delegate.\n */\n function _implementation() internal view virtual returns (address);\n\n /**\n * @dev Delegates the current call to the address returned by `_implementation()`.\n *\n * This function does not return to its internall call site, it will return directly to the external caller.\n */\n function _fallback() internal virtual {\n _beforeFallback();\n _delegate(_implementation());\n }\n\n /**\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if no other\n * function in the contract matches the call data.\n */\n fallback() external payable virtual {\n _fallback();\n }\n\n /**\n * @dev Fallback function that delegates calls to the address returned by `_implementation()`. Will run if call data\n * is empty.\n */\n receive() external payable virtual {\n _fallback();\n }\n\n /**\n * @dev Hook that is called before falling back to the implementation. Can happen as part of a manual `_fallback`\n * call, or as part of the Solidity `fallback` or `receive` functions.\n *\n * If overriden should call `super._beforeFallback()`.\n */\n function _beforeFallback() internal virtual {}\n}\n", "sourceMap": "", "sourcePath": "node_modules/@openzeppelin/contracts/proxy/Proxy.sol", "type": "contract" }