{ "contractName": "IERC2771Recipient", "abi": [ { "inputs": [ { "internalType": "address", "name": "forwarder", "type": "address" } ], "name": "isTrustedForwarder", "outputs": [ { "internalType": "bool", "name": "", "type": "bool" } ], "stateMutability": "view", "type": "function" } ], "metadata": "{\"compiler\":{\"version\":\"0.8.7+commit.e28d00a7\"},\"language\":\"Solidity\",\"output\":{\"abi\":[{\"inputs\":[{\"internalType\":\"address\",\"name\":\"forwarder\",\"type\":\"address\"}],\"name\":\"isTrustedForwarder\",\"outputs\":[{\"internalType\":\"bool\",\"name\":\"\",\"type\":\"bool\"}],\"stateMutability\":\"view\",\"type\":\"function\"}],\"devdoc\":{\"kind\":\"dev\",\"methods\":{\"isTrustedForwarder(address)\":{\"params\":{\"forwarder\":\"The address of the Forwarder contract that is being used.\"},\"returns\":{\"_0\":\"isTrustedForwarder `true` if the Forwarder is trusted to forward relayed transactions by this Recipient.\"}}},\"title\":\"The ERC-2771 Recipient Base Abstract Class - Declarations\",\"version\":1},\"userdoc\":{\"kind\":\"user\",\"methods\":{\"isTrustedForwarder(address)\":{\"notice\":\":warning: **Warning** :warning: The Forwarder can have a full control over your Recipient. Only trust verified Forwarder.\"}},\"notice\":\"A contract must implement this interface in order to support relayed transaction.It is recommended that your contract inherits from the ERC2771Recipient contract.\",\"version\":1}},\"settings\":{\"compilationTarget\":{\"@opengsn/contracts/src/interfaces/IERC2771Recipient.sol\":\"IERC2771Recipient\"},\"evmVersion\":\"london\",\"libraries\":{},\"metadata\":{\"bytecodeHash\":\"ipfs\"},\"optimizer\":{\"enabled\":true,\"runs\":200},\"remappings\":[]},\"sources\":{\"@opengsn/contracts/src/interfaces/IERC2771Recipient.sol\":{\"keccak256\":\"0xc762358681e3494519a5fff2f7e3f0f74f9c9f395f23b00cdfb45e0fb9ef8170\",\"license\":\"MIT\",\"urls\":[\"bzz-raw://68680e24b98e554eb64e724a6ddab30827d5091ae36812e2a4e1b1914481ca4c\",\"dweb:/ipfs/QmR9TVoucNzaeiAgSu1miqoQ4SZAcMCB2yRd32YuEXVWLB\"]}},\"version\":1}", "bytecode": "0x", "deployedBytecode": "0x", "immutableReferences": {}, "sourceMap": "", "deployedSourceMap": "", "source": "// SPDX-License-Identifier: MIT\npragma solidity >=0.6.0;\n\n/**\n * @title The ERC-2771 Recipient Base Abstract Class - Declarations\n *\n * @notice A contract must implement this interface in order to support relayed transaction.\n *\n * @notice It is recommended that your contract inherits from the ERC2771Recipient contract.\n */\nabstract contract IERC2771Recipient {\n\n /**\n * :warning: **Warning** :warning: The Forwarder can have a full control over your Recipient. Only trust verified Forwarder.\n * @param forwarder The address of the Forwarder contract that is being used.\n * @return isTrustedForwarder `true` if the Forwarder is trusted to forward relayed transactions by this Recipient.\n */\n function isTrustedForwarder(address forwarder) public virtual view returns(bool);\n\n /**\n * @notice Use this method the contract anywhere instead of msg.sender to support relayed transactions.\n * @return sender The real sender of this call.\n * For a call that came through the Forwarder the real sender is extracted from the last 20 bytes of the `msg.data`.\n * Otherwise simply returns `msg.sender`.\n */\n function _msgSender() internal virtual view returns (address);\n\n /**\n * @notice Use this method in the contract instead of `msg.data` when difference matters (hashing, signature, etc.)\n * @return data The real `msg.data` of this call.\n * For a call that came through the Forwarder, the real sender address was appended as the last 20 bytes\n * of the `msg.data` - so this method will strip those 20 bytes off.\n * Otherwise (if the call was made directly and not through the forwarder) simply returns `msg.data`.\n */\n function _msgData() internal virtual view returns (bytes calldata);\n}\n", "sourcePath": "@opengsn/contracts/src/interfaces/IERC2771Recipient.sol", "ast": { "absolutePath": "@opengsn/contracts/src/interfaces/IERC2771Recipient.sol", "exportedSymbols": { "IERC2771Recipient": [ 10069 ] }, "id": 10070, "license": "MIT", "nodeType": "SourceUnit", "nodes": [ { "id": 10047, "literals": [ "solidity", ">=", "0.6", ".0" ], "nodeType": "PragmaDirective", "src": "32:24:46" }, { "abstract": true, "baseContracts": [], "contractDependencies": [], "contractKind": "contract", "documentation": { "id": 10048, "nodeType": "StructuredDocumentation", "src": "58:267:46", "text": " @title The ERC-2771 Recipient Base Abstract Class - Declarations\n @notice A contract must implement this interface in order to support relayed transaction.\n @notice It is recommended that your contract inherits from the ERC2771Recipient contract." }, "fullyImplemented": false, "id": 10069, "linearizedBaseContracts": [ 10069 ], "name": "IERC2771Recipient", "nameLocation": "344:17:46", "nodeType": "ContractDefinition", "nodes": [ { "documentation": { "id": 10049, "nodeType": "StructuredDocumentation", "src": "369:342:46", "text": " :warning: **Warning** :warning: The Forwarder can have a full control over your Recipient. Only trust verified Forwarder.\n @param forwarder The address of the Forwarder contract that is being used.\n @return isTrustedForwarder `true` if the Forwarder is trusted to forward relayed transactions by this Recipient." }, "functionSelector": "572b6c05", "id": 10056, "implemented": false, "kind": "function", "modifiers": [], "name": "isTrustedForwarder", "nameLocation": "725:18:46", "nodeType": "FunctionDefinition", "parameters": { "id": 10052, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10051, "mutability": "mutable", "name": "forwarder", "nameLocation": "752:9:46", "nodeType": "VariableDeclaration", "scope": 10056, "src": "744:17:46", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" }, "typeName": { "id": 10050, "name": "address", "nodeType": "ElementaryTypeName", "src": "744:7:46", "stateMutability": "nonpayable", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "visibility": "internal" } ], "src": "743:19:46" }, "returnParameters": { "id": 10055, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10054, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 10056, "src": "791:4:46", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bool", "typeString": "bool" }, "typeName": { "id": 10053, "name": "bool", "nodeType": "ElementaryTypeName", "src": "791:4:46", "typeDescriptions": { "typeIdentifier": "t_bool", "typeString": "bool" } }, "visibility": "internal" } ], "src": "790:6:46" }, "scope": 10069, "src": "716:81:46", "stateMutability": "view", "virtual": true, "visibility": "public" }, { "documentation": { "id": 10057, "nodeType": "StructuredDocumentation", "src": "803:338:46", "text": " @notice Use this method the contract anywhere instead of msg.sender to support relayed transactions.\n @return sender The real sender of this call.\n For a call that came through the Forwarder the real sender is extracted from the last 20 bytes of the `msg.data`.\n Otherwise simply returns `msg.sender`." }, "id": 10062, "implemented": false, "kind": "function", "modifiers": [], "name": "_msgSender", "nameLocation": "1155:10:46", "nodeType": "FunctionDefinition", "parameters": { "id": 10058, "nodeType": "ParameterList", "parameters": [], "src": "1165:2:46" }, "returnParameters": { "id": 10061, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10060, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 10062, "src": "1199:7:46", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" }, "typeName": { "id": 10059, "name": "address", "nodeType": "ElementaryTypeName", "src": "1199:7:46", "stateMutability": "nonpayable", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "visibility": "internal" } ], "src": "1198:9:46" }, "scope": 10069, "src": "1146:62:46", "stateMutability": "view", "virtual": true, "visibility": "internal" }, { "documentation": { "id": 10063, "nodeType": "StructuredDocumentation", "src": "1214:473:46", "text": " @notice Use this method in the contract instead of `msg.data` when difference matters (hashing, signature, etc.)\n @return data The real `msg.data` of this call.\n For a call that came through the Forwarder, the real sender address was appended as the last 20 bytes\n of the `msg.data` - so this method will strip those 20 bytes off.\n Otherwise (if the call was made directly and not through the forwarder) simply returns `msg.data`." }, "id": 10068, "implemented": false, "kind": "function", "modifiers": [], "name": "_msgData", "nameLocation": "1701:8:46", "nodeType": "FunctionDefinition", "parameters": { "id": 10064, "nodeType": "ParameterList", "parameters": [], "src": "1709:2:46" }, "returnParameters": { "id": 10067, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10066, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 10068, "src": "1743:14:46", "stateVariable": false, "storageLocation": "calldata", "typeDescriptions": { "typeIdentifier": "t_bytes_calldata_ptr", "typeString": "bytes" }, "typeName": { "id": 10065, "name": "bytes", "nodeType": "ElementaryTypeName", "src": "1743:5:46", "typeDescriptions": { "typeIdentifier": "t_bytes_storage_ptr", "typeString": "bytes" } }, "visibility": "internal" } ], "src": "1742:16:46" }, "scope": 10069, "src": "1692:67:46", "stateMutability": "view", "virtual": true, "visibility": "internal" } ], "scope": 10070, "src": "326:1435:46", "usedErrors": [] } ], "src": "32:1730:46" }, "legacyAST": { "absolutePath": "@opengsn/contracts/src/interfaces/IERC2771Recipient.sol", "exportedSymbols": { "IERC2771Recipient": [ 10069 ] }, "id": 10070, "license": "MIT", "nodeType": "SourceUnit", "nodes": [ { "id": 10047, "literals": [ "solidity", ">=", "0.6", ".0" ], "nodeType": "PragmaDirective", "src": "32:24:46" }, { "abstract": true, "baseContracts": [], "contractDependencies": [], "contractKind": "contract", "documentation": { "id": 10048, "nodeType": "StructuredDocumentation", "src": "58:267:46", "text": " @title The ERC-2771 Recipient Base Abstract Class - Declarations\n @notice A contract must implement this interface in order to support relayed transaction.\n @notice It is recommended that your contract inherits from the ERC2771Recipient contract." }, "fullyImplemented": false, "id": 10069, "linearizedBaseContracts": [ 10069 ], "name": "IERC2771Recipient", "nameLocation": "344:17:46", "nodeType": "ContractDefinition", "nodes": [ { "documentation": { "id": 10049, "nodeType": "StructuredDocumentation", "src": "369:342:46", "text": " :warning: **Warning** :warning: The Forwarder can have a full control over your Recipient. Only trust verified Forwarder.\n @param forwarder The address of the Forwarder contract that is being used.\n @return isTrustedForwarder `true` if the Forwarder is trusted to forward relayed transactions by this Recipient." }, "functionSelector": "572b6c05", "id": 10056, "implemented": false, "kind": "function", "modifiers": [], "name": "isTrustedForwarder", "nameLocation": "725:18:46", "nodeType": "FunctionDefinition", "parameters": { "id": 10052, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10051, "mutability": "mutable", "name": "forwarder", "nameLocation": "752:9:46", "nodeType": "VariableDeclaration", "scope": 10056, "src": "744:17:46", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" }, "typeName": { "id": 10050, "name": "address", "nodeType": "ElementaryTypeName", "src": "744:7:46", "stateMutability": "nonpayable", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "visibility": "internal" } ], "src": "743:19:46" }, "returnParameters": { "id": 10055, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10054, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 10056, "src": "791:4:46", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_bool", "typeString": "bool" }, "typeName": { "id": 10053, "name": "bool", "nodeType": "ElementaryTypeName", "src": "791:4:46", "typeDescriptions": { "typeIdentifier": "t_bool", "typeString": "bool" } }, "visibility": "internal" } ], "src": "790:6:46" }, "scope": 10069, "src": "716:81:46", "stateMutability": "view", "virtual": true, "visibility": "public" }, { "documentation": { "id": 10057, "nodeType": "StructuredDocumentation", "src": "803:338:46", "text": " @notice Use this method the contract anywhere instead of msg.sender to support relayed transactions.\n @return sender The real sender of this call.\n For a call that came through the Forwarder the real sender is extracted from the last 20 bytes of the `msg.data`.\n Otherwise simply returns `msg.sender`." }, "id": 10062, "implemented": false, "kind": "function", "modifiers": [], "name": "_msgSender", "nameLocation": "1155:10:46", "nodeType": "FunctionDefinition", "parameters": { "id": 10058, "nodeType": "ParameterList", "parameters": [], "src": "1165:2:46" }, "returnParameters": { "id": 10061, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10060, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 10062, "src": "1199:7:46", "stateVariable": false, "storageLocation": "default", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" }, "typeName": { "id": 10059, "name": "address", "nodeType": "ElementaryTypeName", "src": "1199:7:46", "stateMutability": "nonpayable", "typeDescriptions": { "typeIdentifier": "t_address", "typeString": "address" } }, "visibility": "internal" } ], "src": "1198:9:46" }, "scope": 10069, "src": "1146:62:46", "stateMutability": "view", "virtual": true, "visibility": "internal" }, { "documentation": { "id": 10063, "nodeType": "StructuredDocumentation", "src": "1214:473:46", "text": " @notice Use this method in the contract instead of `msg.data` when difference matters (hashing, signature, etc.)\n @return data The real `msg.data` of this call.\n For a call that came through the Forwarder, the real sender address was appended as the last 20 bytes\n of the `msg.data` - so this method will strip those 20 bytes off.\n Otherwise (if the call was made directly and not through the forwarder) simply returns `msg.data`." }, "id": 10068, "implemented": false, "kind": "function", "modifiers": [], "name": "_msgData", "nameLocation": "1701:8:46", "nodeType": "FunctionDefinition", "parameters": { "id": 10064, "nodeType": "ParameterList", "parameters": [], "src": "1709:2:46" }, "returnParameters": { "id": 10067, "nodeType": "ParameterList", "parameters": [ { "constant": false, "id": 10066, "mutability": "mutable", "name": "", "nameLocation": "-1:-1:-1", "nodeType": "VariableDeclaration", "scope": 10068, "src": "1743:14:46", "stateVariable": false, "storageLocation": "calldata", "typeDescriptions": { "typeIdentifier": "t_bytes_calldata_ptr", "typeString": "bytes" }, "typeName": { "id": 10065, "name": "bytes", "nodeType": "ElementaryTypeName", "src": "1743:5:46", "typeDescriptions": { "typeIdentifier": "t_bytes_storage_ptr", "typeString": "bytes" } }, "visibility": "internal" } ], "src": "1742:16:46" }, "scope": 10069, "src": "1692:67:46", "stateMutability": "view", "virtual": true, "visibility": "internal" } ], "scope": 10070, "src": "326:1435:46", "usedErrors": [] } ], "src": "32:1730:46" }, "compiler": { "name": "solc", "version": "0.8.7+commit.e28d00a7.Emscripten.clang" }, "networks": {}, "schemaVersion": "3.1.0", "updatedAt": "2023-03-16T16:54:15.202Z", "devdoc": { "kind": "dev", "methods": { "isTrustedForwarder(address)": { "params": { "forwarder": "The address of the Forwarder contract that is being used." }, "returns": { "_0": "isTrustedForwarder `true` if the Forwarder is trusted to forward relayed transactions by this Recipient." } } }, "title": "The ERC-2771 Recipient Base Abstract Class - Declarations", "version": 1 }, "userdoc": { "kind": "user", "methods": { "isTrustedForwarder(address)": { "notice": ":warning: **Warning** :warning: The Forwarder can have a full control over your Recipient. Only trust verified Forwarder." } }, "notice": "A contract must implement this interface in order to support relayed transaction.It is recommended that your contract inherits from the ERC2771Recipient contract.", "version": 1 } }