openapi: 3.1.0 info: title: Basescan API version: 1.0.0 description: Basescan is the leading blockchain explorer, search, API and analytics platform for Base (L2), an Ethereum Layer 2 network. Powered by the Etherscan team and compatible with the unified Etherscan API V2 platform using chain ID 8453 for Base network access. license: name: UNLICENSED url: https://docs.basescan.org/ servers: - url: https://api.basescan.org/api description: Base Mainnet Endpoint - url: https://api-sepolia.basescan.org/api description: Base Sepolia Testnet Endpoint security: - apiKeyAuth: [] tags: - name: Accounts - name: Contracts - name: Transactions - name: Blocks - name: Logs - name: Geth/Parity Proxy - name: Tokens - name: Gas Tracker - name: Stats - name: API PRO Endpoints externalDocs: url: https://docs.basescan.org/ paths: /?module=account&action=balance: get: operationId: get-ether-balance-for-a-single-address externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-ether-balance-for-a-single-address summary: Get Ether Balance for a Single Address description: Returns the Ether balance of a given address. tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' - in: query name: tag schema: $ref: '#/components/schemas/BlockTag' required: true example: latest responses: '200': description: 'Operation result. 📖 Tip: The result is returned in wei.Convert Ethereum units using our Unit Converter.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.balance' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '40891626854930000000000' /?module=account&action=balancemulti: get: operationId: get-ether-balance-for-multiple-addresses-in-a-single-call externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-ether-balance-for-multiple-addresses-in-a-single-call summary: Get Ether Balance for Multiple Addresses in a Single Call description: Returns the balance of the accounts from a list of addresses. tags: - Accounts parameters: - in: query name: address schema: type: array items: $ref: '#/components/schemas/AddressHash' maxItems: 20 style: form explode: false example: 0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a,0x63a9975ba31b0b9626b34300f7f627147df1f526,0x198ef1ec325a96cc354c7266a038be8b5c558f67 - in: query name: tag schema: $ref: '#/components/schemas/BlockTag' required: true example: latest responses: '200': description: 'Operation result. 📖 Tip: The result is returned in wei.Convert Ethereum units using our Unit Converter.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.balancemulti' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - account: '0xddbd2b932c763ba5b1b7ae3b362eac3e8d40121a' balance: '40891626854930000000000' - account: '0x63a9975ba31b0b9626b34300f7f627147df1f526' balance: '332567136222827062478' - account: '0x198ef1ec325a96cc354c7266a038be8b5c558f67' balance: '0' /?module=account&action=txlist: get: operationId: get-a-list-of-normal-transactions-by-address externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-normal-transactions-by-address summary: Get a list of 'Normal' Transactions By Address description: 'Returns the list of transactions performed by an address, with optional pagination. ​​ ​ 📝 Note : This API endpoint returns a maximum of 10000 records only.' tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xc5102fE9359FD9a28f877a67E36B0F050d81a3CC' - in: query name: startblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '0' - in: query name: endblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '99999999' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '10' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '14923678' timeStamp: '1654646411' hash: '0xc52783ad354aecc04c670047754f062e3d6d04e8f5b24774472651f9c3882c60' nonce: '1' blockHash: '0x7e1638fd2c6bdd05ffd83c1cf06c63e2f67d0f802084bef076d06bdcf86d1bb0' transactionIndex: '61' from: '0x9aa99c23f67c81701c772b106b4f83f6e858dd2e' to: '' value: '0' gas: '6000000' gasPrice: '83924748773' isError: '0' txreceipt_status: '1' input: '0x6101606040527f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9610140908152503480156200003a57600080fd5b5060405162005ddb38038062005ddb833981810160405281019062000060919062000d70565b6040518060400160405280600381526020017f486f700000000000000000000000000000000000000000000000000000000000815250806040518060400160405280600181526020017f31000000000000000000000000000000000000000000000000000000000000008152506040518060400160405280600381526020017f486f7000000000000000000000000000000000000000000000000000000000008152506040518060400160405280600381526020017f484f50000000000000000000000000000000000000000000000000000000000081525081600390805190602001906200015192919062000ca9565b5080600490805190602001906200016a92919062000ca9565b50505060008280519060200120905060008280519060200120905060007f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f90508260e081815250508161010081815250504660a08181525050620001d68184846200027760201b60201c565b608081815250503073ffffffffffffffffffffffffffffffffffffffff1660c08173ffffffffffffffffffffffffffffffffffffffff1660601b815250508061012081815250505050505050506200024362000237620002b360201b60201c565b620002bb60201b60201c565b6200025533846200038160201b60201c565b6200026730836200038160201b60201c565b80600b81905550505050620012b3565b600083838346306040516020016200029495949392919062000e9b565b6040516020818303038152906040528051906020012090509392505050565b600033905090565b6000600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081600960006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b6200039882826200039c60201b620017a81760201c565b5050565b620003b382826200045a60201b620018351760201c565b620003c3620005d360201b60201c565b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16620003f1620005f760201b60201c565b111562000435576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016200042c9062000ef8565b60405180910390fd5b6200045460086200060160201b6200199517836200061960201b60201c565b50505050565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415620004cd576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401620004c49062000f5e565b60405180910390fd5b620004e160008383620008ca60201b60201c565b8060026000828254620004f5919062000fdb565b92505081905550806000808473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008282546200054c919062000fdb565b925050819055508173ffffffffffffffffffffffffffffffffffffffff16600073ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef83604051620005b3919062000f80565b60405180910390a3620005cf60008383620008cf60201b60201c565b5050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff905090565b6000600254905090565b6000818362000611919062000fdb565b905092915050565b600080600085805490509050600081146200068e57856001826200063e919062001038565b815481106200065257620006516200114f565b5b9060005260206000200160000160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1662000691565b60005b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff169250620006bd83858760201c565b91506000811180156200071657504386600183620006dc919062001038565b81548110620006f057620006ef6200114f565b5b9060005260206000200160000160009054906101000a900463ffffffff1663ffffffff16145b15620007b7576200073282620008ec60201b620019ab1760201c565b8660018362000742919062001038565b815481106200075657620007556200114f565b5b9060005260206000200160000160046101000a8154817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff02191690837bffffffffffffffffffffffffffffffffffffffffffffffffffffffff160217905550620008c1565b856040518060400160405280620007d9436200095a60201b62001a161760201c565b63ffffffff168152602001620007fa85620008ec60201b620019ab1760201c565b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff168152509080600181540180825580915050600190039060005260206000200160009091909190915060008201518160000160006101000a81548163ffffffff021916908363ffffffff16021790555060208201518160000160046101000a8154817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff02191690837bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16021790555050505b50935093915050565b505050565b620008e7838383620009b060201b62001a691760201c565b505050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff801682111562000952576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401620009499062000f1a565b60405180910390fd5b819050919050565b600063ffffffff8016821115620009a8576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016200099f9062000f3c565b60405180910390fd5b819050919050565b620009c883838362000a0060201b62001a941760201c565b620009fb620009dd8462000a0560201b60201c565b620009ee8462000a0560201b60201c565b8362000a6e60201b60201c565b505050565b505050565b6000600660008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b8173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415801562000aab5750600081115b1562000c8c57600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161462000b9e5760008062000b45600760008773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002062000c9160201b62001a9917856200061960201b60201c565b915091508473ffffffffffffffffffffffffffffffffffffffff167fdec2bacdd2f05b59de34da9b523dff8be42e5e38e818c82fdb0bae774387a724838360405162000b9392919062000f9d565b60405180910390a250505b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161462000c8b5760008062000c32600760008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206200060160201b6200199517856200061960201b60201c565b915091508373ffffffffffffffffffffffffffffffffffffffff167fdec2bacdd2f05b59de34da9b523dff8be42e5e38e818c82fdb0bae774387a724838360405162000c8092919062000f9d565b60405180910390a250505b5b505050565b6000818362000ca1919062001038565b905092915050565b82805462000cb790620010bb565b90600052602060002090601f01602090048101928262000cdb576000855562000d27565b82601f1062000cf657805160ff191683800117855562000d27565b8280016001018555821562000d27579182015b8281111562000d2657825182559160200191906001019062000d09565b5b50905062000d36919062000d3a565b5090565b5b8082111562000d5557600081600090555060010162000d3b565b5090565b60008151905062000d6a8162001299565b92915050565b60008060006060848603121562000d8c5762000d8b6200117e565b5b600062000d9c8682870162000d59565b935050602062000daf8682870162000d59565b925050604062000dc28682870162000d59565b9150509250925092565b62000dd78162001073565b82525050565b62000de88162001087565b82525050565b600062000dfd60308362000fca565b915062000e0a8262001183565b604082019050919050565b600062000e2460278362000fca565b915062000e3182620011d2565b604082019050919050565b600062000e4b60268362000fca565b915062000e588262001221565b604082019050919050565b600062000e72601f8362000fca565b915062000e7f8262001270565b602082019050919050565b62000e9581620010b1565b82525050565b600060a08201905062000eb2600083018862000ddd565b62000ec1602083018762000ddd565b62000ed0604083018662000ddd565b62000edf606083018562000e8a565b62000eee608083018462000dcc565b9695505050505050565b6000602082019050818103600083015262000f138162000dee565b9050919050565b6000602082019050818103600083015262000f358162000e15565b9050919050565b6000602082019050818103600083015262000f578162000e3c565b9050919050565b6000602082019050818103600083015262000f798162000e63565b9050919050565b600060208201905062000f97600083018462000e8a565b92915050565b600060408201905062000fb4600083018562000e8a565b62000fc3602083018462000e8a565b9392505050565b600082825260208201905092915050565b600062000fe882620010b1565b915062000ff583620010b1565b9250827fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff038211156200102d576200102c620010f1565b5b828201905092915050565b60006200104582620010b1565b91506200105283620010b1565b925082821015620010685762001067620010f1565b5b828203905092915050565b6000620010808262001091565b9050919050565b6000819050919050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b6000819050919050565b60006002820490506001821680620010d457607f821691505b60208210811415620010eb57620010ea62001120565b5b50919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600080fd5b7f4552433230566f7465733a20746f74616c20737570706c79207269736b73206f60008201527f766572666c6f77696e6720766f74657300000000000000000000000000000000602082015250565b7f53616665436173743a2076616c756520646f65736e27742066697420696e203260008201527f3234206269747300000000000000000000000000000000000000000000000000602082015250565b7f53616665436173743a2076616c756520646f65736e27742066697420696e203360008201527f3220626974730000000000000000000000000000000000000000000000000000602082015250565b7f45524332303a206d696e7420746f20746865207a65726f206164647265737300600082015250565b620012a481620010b1565b8114620012b057600080fd5b50565b60805160a05160c05160601c60e051610100516101205161014051614aca62001311600039600061141e0152600061203d0152600061207f0152600061205e01526000611f9301526000611fe9015260006120120152614aca6000f3fe608060405234801561001057600080fd5b50600436106101fb5760003560e01c806370a082311161011a5780639ab24eb0116100ad578063c3cda5201161007c578063c3cda52014610612578063d505accf1461062e578063dd62ed3e1461064a578063f1127ed81461067a578063f2fde38b146106aa576101fb565b80639ab24eb0146105525780639e34070f14610582578063a457c2d7146105b2578063a9059cbb146105e2576101fb565b80637ecebe00116100e95780637ecebe00146104b65780638da5cb5b146104e65780638e539e8c1461050457806395d89b4114610534576101fb565b806370a0823114610444578063715018a614610474578063761229031461047e5780637cb647591461049a576101fb565b80633950935111610192578063587cde1e11610161578063587cde1e146103aa5780635c19a95c146103da57806366deac47146103f65780636fcfff4514610414576101fb565b806339509351146103125780633a46b1a81461034257806340c10f191461037257806342966c681461038e576101fb565b806323b872dd116101ce57806323b872dd146102885780632eb4a7ab146102b8578063313ce567146102d65780633644e515146102f4576101fb565b806301681a621461020057806306fdde031461021c578063095ea7b31461023a57806318160ddd1461026a575b600080fd5b61021a600480360381019061021591906130df565b6106c6565b005b61022461079c565b6040516102319190613b56565b60405180910390f35b610254600480360381019061024f9190613241565b61082e565b60405161026191906139e2565b60405180910390f35b610272610851565b60405161027f9190613f13565b60405180910390f35b6102a2600480360381019061029d919061314c565b61085b565b6040516102af91906139e2565b60405180910390f35b6102c061088a565b6040516102cd91906139fd565b60405180910390f35b6102de610890565b6040516102eb9190613f72565b60405180910390f35b6102fc610899565b60405161030991906139fd565b60405180910390f35b61032c60048036038101906103279190613241565b6108a8565b60405161033991906139e2565b60405180910390f35b61035c60048036038101906103579190613241565b610952565b6040516103699190613f13565b60405180910390f35b61038c60048036038101906103879190613241565b6109e6565b005b6103a860048036038101906103a3919061337b565b610a70565b005b6103c460048036038101906103bf91906130df565b610b00565b6040516103d191906139c7565b60405180910390f35b6103f460048036038101906103ef91906130df565b610b69565b005b6103fe610b7d565b60405161040b9190613f13565b60405180910390f35b61042e600480360381019061042991906130df565b610b83565b60405161043b9190613f57565b60405180910390f35b61045e600480360381019061045991906130df565b610bd7565b60405161046b9190613f13565b60405180910390f35b61047c610c1f565b005b610498600480360381019061049391906133a8565b610ca7565b005b6104b460048036038101906104af919061334e565b610e32565b005b6104d060048036038101906104cb91906130df565b610f36565b6040516104dd9190613f13565b60405180910390f35b6104ee610f86565b6040516104fb91906139c7565b60405180910390f35b61051e6004803603810190610519919061337b565b610fb0565b60405161052b9190613f13565b60405180910390f35b61053c611006565b6040516105499190613b56565b60405180910390f35b61056c600480360381019061056791906130df565b611098565b6040516105799190613f13565b60405180910390f35b61059c6004803603810190610597919061337b565b6111a9565b6040516105a991906139e2565b60405180910390f35b6105cc60048036038101906105c79190613241565b6111c6565b6040516105d991906139e2565b60405180910390f35b6105fc60048036038101906105f79190613241565b6112b0565b60405161060991906139e2565b60405180910390f35b61062c60048036038101906106279190613281565b6112d3565b005b6106486004803603810190610643919061319f565b6113d7565b005b610664600480360381019061065f919061310c565b611519565b6040516106719190613f13565b60405180910390f35b610694600480360381019061068f919061330e565b6115a0565b6040516106a19190613ef8565b60405180910390f35b6106c460048036038101906106bf91906130df565b6116b0565b005b6106ce611aaf565b73ffffffffffffffffffffffffffffffffffffffff166106ec610f86565b73ffffffffffffffffffffffffffffffffffffffff1614610742576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161073990613dd8565b60405180910390fd5b600b544211610786576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161077d90613d58565b60405180910390fd5b610799308261079430610bd7565b611ab7565b50565b6060600380546107ab90614193565b80601f01602080910402602001604051908101604052809291908181526020018280546107d790614193565b80156108245780601f106107f957610100808354040283529160200191610824565b820191906000526020600020905b81548152906001019060200180831161080757829003601f168201915b5050505050905090565b600080610839611aaf565b9050610846818585611d38565b600191505092915050565b6000600254905090565b600080610866611aaf565b9050610873858285611f03565b61087e858585611ab7565b60019150509392505050565b600a5481565b60006012905090565b60006108a3611f8f565b905090565b6000806108b3611aaf565b9050610947818585600160008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008973ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020546109429190613fb4565b611d38565b600191505092915050565b6000438210610996576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161098d90613bb8565b60405180910390fd5b6109de600760008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020836120a9565b905092915050565b6109ee611aaf565b73ffffffffffffffffffffffffffffffffffffffff16610a0c610f86565b73ffffffffffffffffffffffffffffffffffffffff1614610a62576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a5990613dd8565b60405180910390fd5b610a6c82826121b5565b5050565b610a78611aaf565b73ffffffffffffffffffffffffffffffffffffffff16610a96610f86565b73ffffffffffffffffffffffffffffffffffffffff1614610aec576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610ae390613dd8565b60405180910390fd5b610afd610af7610f86565b826121c3565b50565b6000600660008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060009054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b610b7a610b74611aaf565b826121d1565b50565b600b5481565b6000610bd0600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002080549050611a16565b9050919050565b60008060008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020549050919050565b610c27611aaf565b73ffffffffffffffffffffffffffffffffffffffff16610c45610f86565b73ffffffffffffffffffffffffffffffffffffffff1614610c9b576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c9290613dd8565b60405180910390fd5b610ca560006122eb565b565b60003385604051602001610cbc929190613938565b604051602081830303815290604052805190602001209050600080610d25858580806020026020016040519081016040528093929190818152602001838360200280828437600081840152601f19601f82011690508083019250505050505050600a54856123b1565b9150915081610d69576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610d6090613bd8565b60405180910390fd5b610d72816111a9565b15610db2576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610da990613df8565b60405180910390fd5b610dc681600c61248d90919063ffffffff16565b3373ffffffffffffffffffffffffffffffffffffffff167f47cee97cb7acd717b3c0aa1435d004cd5b3c8c57d70dbceb4e4458bbd60e39d488604051610e0c9190613f13565b60405180910390a2610e1e33876121d1565b610e29303389611ab7565b50505050505050565b610e3a611aaf565b73ffffffffffffffffffffffffffffffffffffffff16610e58610f86565b73ffffffffffffffffffffffffffffffffffffffff1614610eae576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610ea590613dd8565b60405180910390fd5b6000801b600a5414610ef5576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610eec90613c38565b60405180910390fd5b80600a819055507f1b930366dfeaa7eb3b325021e4ae81e36527063452ee55b86c95f85b36f4c31c81604051610f2b91906139fd565b60405180910390a150565b6000610f7f600560008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206124cb565b9050919050565b6000600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b6000438210610ff4576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610feb90613bb8565b60405180910390fd5b610fff6008836120a9565b9050919050565b60606004805461101590614193565b80601f016020809104026020016040519081016040528092919081815260200182805461104190614193565b801561108e5780601f106110635761010080835404028352916020019161108e565b820191906000526020600020905b81548152906001019060200180831161107157829003601f168201915b5050505050905090565b600080600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000208054905090506000811461118057600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206001826111349190614095565b8154811061114557611144614302565b5b9060005260206000200160000160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16611183565b60005b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16915050919050565b60006111bf82600c6124d990919063ffffffff16565b9050919050565b6000806111d1611aaf565b90506000600160008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054905083811015611297576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161128e90613eb8565b60405180910390fd5b6112a48286868403611d38565b60019250505092915050565b6000806112bb611aaf565b90506112c8818585611ab7565b600191505092915050565b83421115611316576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161130d90613bf8565b60405180910390fd5b60006113786113707fe48329057bfd03d55e49b547132e39cffd9c1820ad7b9d4c5307691425d15adf8989896040516020016113559493929190613a79565b60405160208183030381529060405280519060200120612515565b85858561252f565b90506113838161255a565b86146113c4576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016113bb90613c78565b60405180910390fd5b6113ce81886121d1565b50505050505050565b8342111561141a576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161141190613cf8565b60405180910390fd5b60007f00000000000000000000000000000000000000000000000000000000000000008888886114498c61255a565b8960405160200161145f96959493929190613a18565b604051602081830303815290604052805190602001209050600061148282612515565b905060006114928287878761252f565b90508973ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611502576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016114f990613d98565b60405180910390fd5b61150d8a8a8a611d38565b50505050505050505050565b6000600160008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054905092915050565b6115a8612fe2565b600760008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000208263ffffffff16815481106115ff576115fe614302565b5b906000526020600020016040518060400160405290816000820160009054906101000a900463ffffffff1663ffffffff1663ffffffff1681526020016000820160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff167bffffffffffffffffffffffffffffffffffffffffffffffffffffffff167bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1681525050905092915050565b6116b8611aaf565b73ffffffffffffffffffffffffffffffffffffffff166116d6610f86565b73ffffffffffffffffffffffffffffffffffffffff161461172c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161172390613dd8565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16141561179c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161179390613c98565b60405180910390fd5b6117a5816122eb565b50565b6117b28282611835565b6117ba6125b8565b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff166117e0610851565b1115611821576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161181890613db8565b60405180910390fd5b61182f6008611995836125dc565b50505050565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614156118a5576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161189c90613ed8565b60405180910390fd5b6118b160008383612854565b80600260008282546118c39190613fb4565b92505081905550806000808473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008282546119189190613fb4565b925050819055508173ffffffffffffffffffffffffffffffffffffffff16600073ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8360405161197d9190613f13565b60405180910390a361199160008383612859565b5050565b600081836119a39190613fb4565b905092915050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff8016821115611a0e576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611a0590613e18565b60405180910390fd5b819050919050565b600063ffffffff8016821115611a61576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611a5890613e78565b60405180910390fd5b819050919050565b611a74838383611a94565b611a8f611a8084610b00565b611a8984610b00565b83612869565b505050565b505050565b60008183611aa79190614095565b905092915050565b600033905090565b600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415611b27576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611b1e90613e58565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415611b97576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611b8e90613b98565b60405180910390fd5b611ba2838383612854565b60008060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054905081811015611c28576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611c1f90613d18565b60405180910390fd5b8181036000808673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002081905550816000808573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254611cbb9190613fb4565b925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef84604051611d1f9190613f13565b60405180910390a3611d32848484612859565b50505050565b600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415611da8576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611d9f90613e98565b60405180910390fd5b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415611e18576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611e0f90613cb8565b60405180910390fd5b80600160008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92583604051611ef69190613f13565b60405180910390a3505050565b6000611f0f8484611519565b90507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8114611f895781811015611f7b576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401611f7290613cd8565b60405180910390fd5b611f888484848403611d38565b5b50505050565b60007f000000000000000000000000000000000000000000000000000000000000000073ffffffffffffffffffffffffffffffffffffffff163073ffffffffffffffffffffffffffffffffffffffff1614801561200b57507f000000000000000000000000000000000000000000000000000000000000000046145b15612038577f000000000000000000000000000000000000000000000000000000000000000090506120a6565b6120a37f00000000000000000000000000000000000000000000000000000000000000007f00000000000000000000000000000000000000000000000000000000000000007f0000000000000000000000000000000000000000000000000000000000000000612a62565b90505b90565b6000808380549050905060005b818110156121285760006120ca8284612a9c565b9050848682815481106120e0576120df614302565b5b9060005260206000200160000160009054906101000a900463ffffffff1663ffffffff16111561211257809250612122565b60018161211f9190613fb4565b91505b506120b6565b6000821461218a578460018361213e9190614095565b8154811061214f5761214e614302565b5b9060005260206000200160000160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1661218d565b60005b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff169250505092915050565b6121bf82826117a8565b5050565b6121cd8282612ac2565b5050565b60006121dc83610b00565b905060006121e984610bd7565b905082600660008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508273ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff167f3134e8a2e6d97e929a7e54011ea5485d7d196dd5f0ba4d4ef95803e8e3fc257f60405160405180910390a46122e5828483612869565b50505050565b6000600960009054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905081600960006101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b60008060008390506000805b875181101561247a576002826123d3919061403b565b915060008882815181106123ea576123e9614302565b5b6020026020010151905080841161242b57838160405160200161240e929190613964565b604051602081830303815290604052805190602001209350612466565b808460405160200161243e929190613964565b6040516020818303038152906040528051906020012093506001836124639190613fb4565b92505b508080612472906141c5565b9150506123bd565b5085821481935093505050935093915050565b6000600882901c9050600060ff83166001901b9050808460000160008481526020019081526020016000206000828254179250508190555050505050565b600081600001549050919050565b600080600883901c9050600060ff84166001901b9050600081866000016000858152602001908152602001600020541614159250505092915050565b6000612528612522611f8f565b83612ae0565b9050919050565b600080600061254087878787612b13565b9150915061254d81612c20565b8192505050949350505050565b600080600560008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002090506125a7816124cb565b91506125b281612df5565b50919050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff905090565b6000806000858054905090506000811461264a57856001826125fe9190614095565b8154811061260f5761260e614302565b5b9060005260206000200160000160049054906101000a90047bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1661264d565b60005b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16925061267b83858763ffffffff16565b91506000811180156126ce575043866001836126979190614095565b815481106126a8576126a7614302565b5b9060005260206000200160000160009054906101000a900463ffffffff1663ffffffff16145b1561275b576126dc826119ab565b866001836126ea9190614095565b815481106126fb576126fa614302565b5b9060005260206000200160000160046101000a8154817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff02191690837bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16021790555061284b565b85604051806040016040528061277043611a16565b63ffffffff168152602001612784856119ab565b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff168152509080600181540180825580915050600190039060005260206000200160009091909190915060008201518160000160006101000a81548163ffffffff021916908363ffffffff16021790555060208201518160000160046101000a8154817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff02191690837bffffffffffffffffffffffffffffffffffffffffffffffffffffffff16021790555050505b50935093915050565b505050565b612864838383611a69565b505050565b8173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16141580156128a55750600081115b15612a5d57600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16146129835760008061292c600760008773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020611a99856125dc565b915091508473ffffffffffffffffffffffffffffffffffffffff167fdec2bacdd2f05b59de34da9b523dff8be42e5e38e818c82fdb0bae774387a7248383604051612978929190613f2e565b60405180910390a250505b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614612a5c57600080612a05600760008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020611995856125dc565b915091508373ffffffffffffffffffffffffffffffffffffffff167fdec2bacdd2f05b59de34da9b523dff8be42e5e38e818c82fdb0bae774387a7248383604051612a51929190613f2e565b60405180910390a250505b5b505050565b60008383834630604051602001612a7d959493929190613abe565b6040516020818303038152906040528051906020012090509392505050565b60006002828418612aad919061400a565b828416612aba9190613fb4565b905092915050565b612acc8282612e0b565b612ada6008611a99836125dc565b50505050565b60008282604051602001612af5929190613990565b60405160208183030381529060405280519060200120905092915050565b6000807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08360001c1115612b4e576000600391509150612c17565b601b8560ff1614158015612b665750601c8560ff1614155b15612b78576000600491509150612c17565b600060018787878760405160008152602001604052604051612b9d9493929190613b11565b6020604051602081039080840390855afa158015612bbf573d6000803e3d6000fd5b505050602060405103519050600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161415612c0e57600060019250925050612c17565b80600092509250505b94509492505050565b60006004811115612c3457612c336142a4565b5b816004811115612c4757612c466142a4565b5b1415612c5257612df2565b60016004811115612c6657612c656142a4565b5b816004811115612c7957612c786142a4565b5b1415612cba576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612cb190613b78565b60405180910390fd5b60026004811115612cce57612ccd6142a4565b5b816004811115612ce157612ce06142a4565b5b1415612d22576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612d1990613c58565b60405180910390fd5b60036004811115612d3657612d356142a4565b5b816004811115612d4957612d486142a4565b5b1415612d8a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612d8190613d38565b60405180910390fd5b600480811115612d9d57612d9c6142a4565b5b816004811115612db057612daf6142a4565b5b1415612df1576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612de890613d78565b60405180910390fd5b5b50565b6001816000016000828254019250508190555050565b600073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff161415612e7b576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612e7290613e38565b60405180910390fd5b612e8782600083612854565b60008060008473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054905081811015612f0d576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401612f0490613c18565b60405180910390fd5b8181036000808573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508160026000828254612f649190614095565b92505081905550600073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef84604051612fc99190613f13565b60405180910390a3612fdd83600084612859565b505050565b6040518060400160405280600063ffffffff16815260200160007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1681525090565b60008135905061302f81614a21565b92915050565b60008083601f84011261304b5761304a614336565b5b8235905067ffffffffffffffff81111561306857613067614331565b5b6020830191508360208202830111156130845761308361433b565b5b9250929050565b60008135905061309a81614a38565b92915050565b6000813590506130af81614a4f565b92915050565b6000813590506130c481614a66565b92915050565b6000813590506130d981614a7d565b92915050565b6000602082840312156130f5576130f4614345565b5b600061310384828501613020565b91505092915050565b6000806040838503121561312357613122614345565b5b600061313185828601613020565b925050602061314285828601613020565b9150509250929050565b60008060006060848603121561316557613164614345565b5b600061317386828701613020565b935050602061318486828701613020565b9250506040613195868287016130a0565b9150509250925092565b600080600080600080600060e0888a0312156131be576131bd614345565b5b60006131cc8a828b01613020565b97505060206131dd8a828b01613020565b96505060406131ee8a828b016130a0565b95505060606131ff8a828b016130a0565b94505060806132108a828b016130ca565b93505060a06132218a828b0161308b565b92505060c06132328a828b0161308b565b91505092959891949750929550565b6000806040838503121561325857613257614345565b5b600061326685828601613020565b9250506020613277858286016130a0565b9150509250929050565b60008060008060008060c0878903121561329e5761329d614345565b5b60006132ac89828a01613020565b96505060206132bd89828a016130a0565b95505060406132ce89828a016130a0565b94505060606132df89828a016130ca565b93505060806132f089828a0161308b565b92505060a061330189828a0161308b565b9150509295509295509295565b6000806040838503121561332557613324614345565b5b600061333385828601613020565b9250506020613344858286016130b5565b9150509250929050565b60006020828403121561336457613363614345565b5b60006133728482850161308b565b91505092915050565b60006020828403121561339157613390614345565b5b600061339f848285016130a0565b91505092915050565b600080600080606085870312156133c2576133c1614345565b5b60006133d0878288016130a0565b94505060206133e187828801613020565b935050604085013567ffffffffffffffff81111561340257613401614340565b5b61340e87828801613035565b925092505092959194509250565b613425816140c9565b82525050565b61343c613437826140c9565b61420e565b82525050565b61344b816140db565b82525050565b61345a816140e7565b82525050565b61347161346c826140e7565b614220565b82525050565b600061348282613f8d565b61348c8185613f98565b935061349c818560208601614160565b6134a58161434a565b840191505092915050565b60006134bd601883613f98565b91506134c882614368565b602082019050919050565b60006134e0602383613f98565b91506134eb82614391565b604082019050919050565b6000613503601f83613f98565b915061350e826143e0565b602082019050919050565b6000613526601a83613f98565b915061353182614409565b602082019050919050565b6000613549601d83613f98565b915061355482614432565b602082019050919050565b600061356c602283613f98565b91506135778261445b565b604082019050919050565b600061358f601c83613f98565b915061359a826144aa565b602082019050919050565b60006135b2601f83613f98565b91506135bd826144d3565b602082019050919050565b60006135d5601983613f98565b91506135e0826144fc565b602082019050919050565b60006135f8602683613f98565b915061360382614525565b604082019050919050565b600061361b602283613f98565b915061362682614574565b604082019050919050565b600061363e600283613fa9565b9150613649826145c3565b600282019050919050565b6000613661601d83613f98565b915061366c826145ec565b602082019050919050565b6000613684601d83613f98565b915061368f82614615565b602082019050919050565b60006136a7602683613f98565b91506136b28261463e565b604082019050919050565b60006136ca602283613f98565b91506136d58261468d565b604082019050919050565b60006136ed601f83613f98565b91506136f8826146dc565b602082019050919050565b6000613710602283613f98565b915061371b82614705565b604082019050919050565b6000613733601e83613f98565b915061373e82614754565b602082019050919050565b6000613756603083613f98565b91506137618261477d565b604082019050919050565b6000613779602083613f98565b9150613784826147cc565b602082019050919050565b600061379c601c83613f98565b91506137a7826147f5565b602082019050919050565b60006137bf602783613f98565b91506137ca8261481e565b604082019050919050565b60006137e2602183613f98565b91506137ed8261486d565b604082019050919050565b6000613805602583613f98565b9150613810826148bc565b604082019050919050565b6000613828602683613f98565b91506138338261490b565b604082019050919050565b600061384b602483613f98565b91506138568261495a565b604082019050919050565b600061386e602583613f98565b9150613879826149a9565b604082019050919050565b6000613891601f83613f98565b915061389c826149f8565b602082019050919050565b6040820160008201516138bd600085018261390b565b5060208201516138d060208501826138d6565b50505050565b6138df81614111565b82525050565b6138ee81614139565b82525050565b61390561390082614139565b61423c565b82525050565b61391481614143565b82525050565b61392381614143565b82525050565b61393281614153565b82525050565b6000613944828561342b565b60148201915061395482846138f4565b6020820191508190509392505050565b60006139708285613460565b6020820191506139808284613460565b6020820191508190509392505050565b600061399b82613631565b91506139a78285613460565b6020820191506139b78284613460565b6020820191508190509392505050565b60006020820190506139dc600083018461341c565b92915050565b60006020820190506139f76000830184613442565b92915050565b6000602082019050613a126000830184613451565b92915050565b600060c082019050613a2d6000830189613451565b613a3a602083018861341c565b613a47604083018761341c565b613a5460608301866138e5565b613a6160808301856138e5565b613a6e60a08301846138e5565b979650505050505050565b6000608082019050613a8e6000830187613451565b613a9b602083018661341c565b613aa860408301856138e5565b613ab560608301846138e5565b95945050505050565b600060a082019050613ad36000830188613451565b613ae06020830187613451565b613aed6040830186613451565b613afa60608301856138e5565b613b07608083018461341c565b9695505050505050565b6000608082019050613b266000830187613451565b613b336020830186613929565b613b406040830185613451565b613b4d6060830184613451565b95945050505050565b60006020820190508181036000830152613b708184613477565b905092915050565b60006020820190508181036000830152613b91816134b0565b9050919050565b60006020820190508181036000830152613bb1816134d3565b9050919050565b60006020820190508181036000830152613bd1816134f6565b9050919050565b60006020820190508181036000830152613bf181613519565b9050919050565b60006020820190508181036000830152613c118161353c565b9050919050565b60006020820190508181036000830152613c318161355f565b9050919050565b60006020820190508181036000830152613c5181613582565b9050919050565b60006020820190508181036000830152613c71816135a5565b9050919050565b60006020820190508181036000830152613c91816135c8565b9050919050565b60006020820190508181036000830152613cb1816135eb565b9050919050565b60006020820190508181036000830152613cd18161360e565b9050919050565b60006020820190508181036000830152613cf181613654565b9050919050565b60006020820190508181036000830152613d1181613677565b9050919050565b60006020820190508181036000830152613d318161369a565b9050919050565b60006020820190508181036000830152613d51816136bd565b9050919050565b60006020820190508181036000830152613d71816136e0565b9050919050565b60006020820190508181036000830152613d9181613703565b9050919050565b60006020820190508181036000830152613db181613726565b9050919050565b60006020820190508181036000830152613dd181613749565b9050919050565b60006020820190508181036000830152613df18161376c565b9050919050565b60006020820190508181036000830152613e118161378f565b9050919050565b60006020820190508181036000830152613e31816137b2565b9050919050565b60006020820190508181036000830152613e51816137d5565b9050919050565b60006020820190508181036000830152613e71816137f8565b9050919050565b60006020820190508181036000830152613e918161381b565b9050919050565b60006020820190508181036000830152613eb18161383e565b9050919050565b60006020820190508181036000830152613ed181613861565b9050919050565b60006020820190508181036000830152613ef181613884565b9050919050565b6000604082019050613f0d60008301846138a7565b92915050565b6000602082019050613f2860008301846138e5565b92915050565b6000604082019050613f4360008301856138e5565b613f5060208301846138e5565b9392505050565b6000602082019050613f6c600083018461391a565b92915050565b6000602082019050613f876000830184613929565b92915050565b600081519050919050565b600082825260208201905092915050565b600081905092915050565b6000613fbf82614139565b9150613fca83614139565b9250827fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff03821115613fff57613ffe614246565b5b828201905092915050565b600061401582614139565b915061402083614139565b9250826140305761402f614275565b5b828204905092915050565b600061404682614139565b915061405183614139565b9250817fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff048311821515161561408a57614089614246565b5b828202905092915050565b60006140a082614139565b91506140ab83614139565b9250828210156140be576140bd614246565b5b828203905092915050565b60006140d4826140f1565b9050919050565b60008115159050919050565b6000819050919050565b600073ffffffffffffffffffffffffffffffffffffffff82169050919050565b60007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff82169050919050565b6000819050919050565b600063ffffffff82169050919050565b600060ff82169050919050565b60005b8381101561417e578082015181840152602081019050614163565b8381111561418d576000848401525b50505050565b600060028204905060018216806141ab57607f821691505b602082108114156141bf576141be6142d3565b5b50919050565b60006141d082614139565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82141561420357614202614246565b5b600182019050919050565b60006142198261422a565b9050919050565b6000819050919050565b60006142358261435b565b9050919050565b6000819050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602160045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052603260045260246000fd5b600080fd5b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b60008160601b9050919050565b7f45434453413a20696e76616c6964207369676e61747572650000000000000000600082015250565b7f45524332303a207472616e7366657220746f20746865207a65726f206164647260008201527f6573730000000000000000000000000000000000000000000000000000000000602082015250565b7f4552433230566f7465733a20626c6f636b206e6f7420796574206d696e656400600082015250565b7f484f503a2056616c69642070726f6f662072657175697265642e000000000000600082015250565b7f4552433230566f7465733a207369676e61747572652065787069726564000000600082015250565b7f45524332303a206275726e20616d6f756e7420657863656564732062616c616e60008201527f6365000000000000000000000000000000000000000000000000000000000000602082015250565b7f484f503a204d65726b6c6520726f6f7420616c72656164792073657400000000600082015250565b7f45434453413a20696e76616c6964207369676e6174757265206c656e67746800600082015250565b7f4552433230566f7465733a20696e76616c6964206e6f6e636500000000000000600082015250565b7f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160008201527f6464726573730000000000000000000000000000000000000000000000000000602082015250565b7f45524332303a20617070726f766520746f20746865207a65726f20616464726560008201527f7373000000000000000000000000000000000000000000000000000000000000602082015250565b7f1901000000000000000000000000000000000000000000000000000000000000600082015250565b7f45524332303a20696e73756666696369656e7420616c6c6f77616e6365000000600082015250565b7f45524332305065726d69743a206578706972656420646561646c696e65000000600082015250565b7f45524332303a207472616e7366657220616d6f756e742065786365656473206260008201527f616c616e63650000000000000000000000000000000000000000000000000000602082015250565b7f45434453413a20696e76616c6964207369676e6174757265202773272076616c60008201527f7565000000000000000000000000000000000000000000000000000000000000602082015250565b7f484f503a20436c61696d20706572696f64206e6f742079657420656e64656400600082015250565b7f45434453413a20696e76616c6964207369676e6174757265202776272076616c60008201527f7565000000000000000000000000000000000000000000000000000000000000602082015250565b7f45524332305065726d69743a20696e76616c6964207369676e61747572650000600082015250565b7f4552433230566f7465733a20746f74616c20737570706c79207269736b73206f60008201527f766572666c6f77696e6720766f74657300000000000000000000000000000000602082015250565b7f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572600082015250565b7f484f503a20546f6b656e7320616c726561647920636c61696d65642e00000000600082015250565b7f53616665436173743a2076616c756520646f65736e27742066697420696e203260008201527f3234206269747300000000000000000000000000000000000000000000000000602082015250565b7f45524332303a206275726e2066726f6d20746865207a65726f2061646472657360008201527f7300000000000000000000000000000000000000000000000000000000000000602082015250565b7f45524332303a207472616e736665722066726f6d20746865207a65726f20616460008201527f6472657373000000000000000000000000000000000000000000000000000000602082015250565b7f53616665436173743a2076616c756520646f65736e27742066697420696e203360008201527f3220626974730000000000000000000000000000000000000000000000000000602082015250565b7f45524332303a20617070726f76652066726f6d20746865207a65726f2061646460008201527f7265737300000000000000000000000000000000000000000000000000000000602082015250565b7f45524332303a2064656372656173656420616c6c6f77616e63652062656c6f7760008201527f207a65726f000000000000000000000000000000000000000000000000000000602082015250565b7f45524332303a206d696e7420746f20746865207a65726f206164647265737300600082015250565b614a2a816140c9565b8114614a3557600080fd5b50565b614a41816140e7565b8114614a4c57600080fd5b50565b614a5881614139565b8114614a6357600080fd5b50565b614a6f81614143565b8114614a7a57600080fd5b50565b614a8681614153565b8114614a9157600080fd5b5056fea2646970667358221220f6ac0f9b7be284957c471924efd5c5c2c2364146e9216e4365ec0870f955dce864736f6c634300080700330000000000000000000000000000000000000000030dd5e3217b0bbfacdaca690000000000000000000000000000000000000000002d58597e55747d3b253597000000000000000000000000000000000000000000000000000000006392c0d0' contractAddress: '0xc5102fe9359fd9a28f877a67e36b0f050d81a3cc' cumulativeGasUsed: '10450178' gasUsed: '4457269' confirmations: '122485' methodId: '0x61016060' functionName: '' - blockNumber: '14923692' timeStamp: '1654646570' hash: '0xaa45b4858ba44230a5fce5a29570a5dec2bf1f0ba95bacdec4fe8f2c4fa99338' nonce: '7' blockHash: '0x8df71a12a8c06b36c06c26bf6248857dd2a2b75b6edbb4e33e9477078897b282' transactionIndex: '27' from: '0x9aa99c23f67c81701c772b106b4f83f6e858dd2e' to: '0xc5102fe9359fd9a28f877a67e36b0f050d81a3cc' value: '0' gas: '6000000' gasPrice: '125521409858' isError: '0' txreceipt_status: '1' input: '0xa9059cbb000000000000000000000000313143c4088a47c469d06fe3fa5fd4196be6a4d600000000000000000000000000000000000000000003b8e97d229a2d54800000' contractAddress: '' cumulativeGasUsed: '1977481' gasUsed: '57168' confirmations: '122471' methodId: '0xa9059cbb' functionName: transfer(address _to, uint256 _value) /?module=account&action=txlistinternal: get: operationId: get-a-list-of-internal-transactions-by-address externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-internal-transactions-by-address summary: Get a list of 'Internal' Transactions by Address description: 'Returns the list of internal transactions performed by an address, with optional pagination. 📝 Note : This API endpoint returns a maximum of 10000 records only.' tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3' - in: query name: startblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '0' - in: query name: endblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '2702578' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '10' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '2535368' timeStamp: '1477837690' hash: '0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6' from: '0x20d42f2e99a421147acf198d775395cac2e8b03d' to: '' value: '0' contractAddress: '0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3' input: '' type: create gas: '254791' gasUsed: '46750' traceId: '0' isError: '0' errCode: '' - blockNumber: '2535479' timeStamp: '1477839134' hash: '0x1a50f1dc0bc912745f7d09b988669f71d199719e2fb7592c2074ede9578032d0' from: '0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3' to: '0x20d42f2e99a421147acf198d775395cac2e8b03d' value: '100000000000000000' contractAddress: '' input: '' type: call gas: '235231' gasUsed: '0' traceId: '0' isError: '0' errCode: '' /?module=account&action=txlistinternal&get-internal-transactions-by-transaction-hash: get: operationId: get-internal-transactions-by-transaction-hash externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-internal-transactions-by-transaction-hash summary: Get 'Internal Transactions' by Transaction Hash description: 'Returns the list of internal transactions performed within a transaction. 📝 Note : This API endpoint returns a maximum of 10000 records only.' tags: - Accounts parameters: - in: query name: txhash schema: $ref: '#/components/schemas/TxHash' required: true example: '0x40eb908387324f2b575b4879cd9d7188f69c8fc9d87c901b9e2daaea4b442170' responses: '200': description: Operation result. The isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '1743059' timeStamp: '1466489498' from: '0x2cac6e4b11d6b58f6d3c1c9d5fe8faa89f60e5a2' to: '0x66a1c3eaf0f1ffc28d209c0763ed0ca614f3b002' value: '7106740000000000' contractAddress: '' input: '' type: call gas: '2300' gasUsed: '0' isError: '0' errCode: '' /?module=account&action=txlistinternal&get-internal-transactions-by-block-range: get: operationId: get-internal-transactions-by-block-range externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-internal-transactions-by-block-range summary: Get "Internal Transactions" by Block Range description: 'Returns the list of internal transactions performed within a block range, with optional pagination. ​​ 📝 Note : This API endpoint returns a maximum of 10000 records only.' tags: - Accounts parameters: - in: query name: startblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '13481773' - in: query name: endblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '13491773' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '10' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. The isError field returns 0 for successful transactions and 1 for rejected/cancelled transactions. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '50107' timeStamp: '1438984016' hash: '0x3f97c969ddf71f515ce5373b1f8e76e9fd7016611d8ce455881009414301789e' from: '0x109c4f2ccc82c4d77bde15f306707320294aea3f' to: '0x881b0a4e9c55d08e31d8d3c022144d75a454211c' value: '1000000000000000000' contractAddress: '' input: '' type: call gas: '2300' gasUsed: '0' traceId: '0' isError: '1' errCode: '' - blockNumber: '50111' timeStamp: '1438984075' hash: '0x893c428fed019404f704cf4d9be977ed9ca01050ed93dccdd6c169422155586f' from: '0x109c4f2ccc82c4d77bde15f306707320294aea3f' to: '0x881b0a4e9c55d08e31d8d3c022144d75a454211c' value: '1000000000000000000' contractAddress: '' input: '' type: call gas: '2300' gasUsed: '0' traceId: '0' isError: '0' errCode: '' /?module=account&action=tokentx: get: operationId: get-a-list-of-erc20-token-transfer-events-by-address externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-erc20-token-transfer-events-by-address summary: Get a list of 'ERC20 - Token Transfer Events' by Address description: Returns the list of ERC-20 tokens transferred by an address, with optional filtering by token contract. tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x4e83362442b8d1bec281594cea3050c8eb01311c' - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '100' - in: query name: startblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '0' - in: query name: endblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '27025780' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '4730207' timeStamp: '1513240363' hash: '0xe8c208398bd5ae8e4c237658580db56a2a94dfa0ca382c99b776fa6e7d31d5b4' nonce: '406' blockHash: '0x022c5e6a3d2487a8ccf8946a2ffb74938bf8e5c8a3f6d91b41c56378a96b5c37' from: '0x642ae78fafbb8032da552d619ad43f1d81e4dd7c' contractAddress: '0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2' to: '0x4e83362442b8d1bec281594cea3050c8eb01311c' value: '5901522149285533025181' tokenName: Maker tokenSymbol: MKR tokenDecimal: '18' transactionIndex: '81' gas: '940000' gasPrice: '32010000000' gasUsed: '77759' cumulativeGasUsed: '2523379' input: deprecated confirmations: '7968350' - blockNumber: '4764973' timeStamp: '1513764636' hash: '0x9c82e89b7f6a4405d11c361adb6d808d27bcd9db3b04b3fb3bc05d182bbc5d6f' nonce: '428' blockHash: '0x87a4d04a6d8fce7a149e9dc528b88dc0c781a87456910c42984bdc15930a2cac' from: '0x4e83362442b8d1bec281594cea3050c8eb01311c' contractAddress: '0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2' to: '0x69076e44a9c70a67d5b79d95795aba299083c275' value: '132520488141080' tokenName: Maker tokenSymbol: MKR tokenDecimal: '18' transactionIndex: '167' gas: '940000' gasPrice: '35828000000' gasUsed: '127593' cumulativeGasUsed: '6315818' input: deprecated confirmations: '7933584' /?module=account&action=tokennfttx: get: operationId: get-a-list-of-erc721-token-transfer-events-by-address externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-erc721-token-transfer-events-by-address summary: Get a list of 'ERC721 - Token Transfer Events' by Address description: Returns the list of ERC-721 ( NFT ) tokens transferred by an address, with optional filtering by token contract. tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x6975be450864c02b4613023c2152ee0743572325' - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x06012c8cf97bead5deae237070f9587f8e7a266d' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '100' - in: query name: startblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '0' - in: query name: endblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '27025780' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '4708120' timeStamp: '1512907118' hash: '0x031e6968a8de362e4328d60dcc7f72f0d6fc84284c452f63176632177146de66' nonce: '0' blockHash: '0x4be19c278bfaead5cb0bc9476fa632e2447f6e6259e0303af210302d22779a24' from: '0xb1690c08e213a35ed9bab7b318de14420fb57d8c' contractAddress: '0x06012c8cf97bead5deae237070f9587f8e7a266d' to: '0x6975be450864c02b4613023c2152ee0743572325' tokenID: '202106' tokenName: CryptoKitties tokenSymbol: CK tokenDecimal: '0' transactionIndex: '81' gas: '158820' gasPrice: '40000000000' gasUsed: '60508' cumulativeGasUsed: '4880352' input: deprecated confirmations: '7990490' - blockNumber: '4708161' timeStamp: '1512907756' hash: '0x9626e7064b68b5463cf677e10815a0b394645a0bfa245f26a2de6074324e83ff' nonce: '1' blockHash: '0xe1c6cbc39a723496f4cbc3e70241012854f2e88b4d2d5f339d8f0a4a1cc406d8' from: '0xb1690c08e213a35ed9bab7b318de14420fb57d8c' contractAddress: '0x06012c8cf97bead5deae237070f9587f8e7a266d' to: '0x6975be450864c02b4613023c2152ee0743572325' tokenID: '147739' tokenName: CryptoKitties tokenSymbol: CK tokenDecimal: '0' transactionIndex: '41' gas: '135963' gasPrice: '40000000000' gasUsed: '45508' cumulativeGasUsed: '3359342' input: deprecated confirmations: '7990449' /?module=account&action=token1155tx: get: operationId: get-a-list-of-erc1155-token-transfer-events-by-address externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-a-list-of-erc1155-token-transfer-events-by-address summary: Get a list of 'ERC1155 - Token Transfer Events' by Address description: Returns the list of ERC-1155 ( Multi Token Standard ) tokens transferred by an address, with optional filtering by token contract. tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x83f564d180b58ad9a02a449105568189ee7de8cb' - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x76be3b62873462d2142405439777e971754e8e77' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '100' - in: query name: startblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '0' - in: query name: endblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '99999999' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '13472395' timeStamp: '1634973285' hash: '0x643b15f3ffaad5d38e33e5872b4ebaa7a643eda8b50ffd5331f682934ee65d4d' nonce: '41' blockHash: '0xa5da536dfbe8125eb146114e2ee0d0bdef2b20483aacbf30fed6b60f092059e6' transactionIndex: '100' gas: '140000' gasPrice: '52898577246' gasUsed: '105030' cumulativeGasUsed: '11739203' input: deprecated contractAddress: '0x76be3b62873462d2142405439777e971754e8e77' from: '0x1e63326a84d2fa207bdfa856da9278a93deba418' to: '0x83f564d180b58ad9a02a449105568189ee7de8cb' tokenID: '10371' tokenValue: '1' tokenName: parallel tokenSymbol: LL confirmations: '1447769' - blockNumber: '14049909' timeStamp: '1642781541' hash: '0x58353aab15a4b5a77333b87619edaa749c7f3cf8bb2263a1c0865d73bf1264bd' nonce: '4' blockHash: '0x1e88a63a4cb4086a747644b8ab7ff3434540930f3029eacb8add08b15974fdc9' transactionIndex: '114' gas: '253032' gasPrice: '225052869211' gasUsed: '184899' cumulativeGasUsed: '6855790' input: deprecated contractAddress: '0x76be3b62873462d2142405439777e971754e8e77' from: '0x83f564d180b58ad9a02a449105568189ee7de8cb' to: '0x80833dc92d326a81d0cb74982a8e6f1a3887f837' tokenID: '10371' tokenValue: '1' tokenName: parallel tokenSymbol: LL confirmations: '870255' - blockNumber: '14067255' timeStamp: '1643012777' hash: '0x3222b5f71e577c2551e17701eaf39b308b976bbe6bf6ce3f8c20549527b9d6ae' nonce: '7' blockHash: '0x236cfed8b42fa6cb8956f6e7b889797047d9af0883066b1f3be8284beda16e17' transactionIndex: '172' gas: '56873' gasPrice: '69434775835' gasUsed: '52073' cumulativeGasUsed: '17181952' input: deprecated contractAddress: '0x76be3b62873462d2142405439777e971754e8e77' from: '0x9d48305f859a0006b57da25c80af62ecb8e5c6a2' to: '0x83f564d180b58ad9a02a449105568189ee7de8cb' tokenID: '10372' tokenValue: '1' tokenName: parallel tokenSymbol: LL confirmations: '852909' /?module=account&action=getminedblocks: get: operationId: get-list-of-blocks-validated-by-address externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-list-of-blocks-validated-by-address summary: Get list of Blocks Validated by Address description: Returns the list of blocks validated by an address. tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x9dd134d14d1e65f84b706d6f205cd5b1cd03a46b' - in: query name: blocktype schema: $ref: '#/components/schemas/BlockType' required: true example: blocks - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '10' responses: '200': description: 'Operation result. ⏳ Note : The timeStamp is represented in Unix timestamp. ****' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '3462296' timeStamp: '1491118514' blockReward: '5194770940000000000' - blockNumber: '2691400' timeStamp: '1480072029' blockReward: '5086562212310617100' - blockNumber: '2687700' timeStamp: '1480018852' blockReward: '5003251945421042780' /?module=account&action=txsBeaconWithdrawal: get: operationId: get-beacon-chain-withdrawals-by-address-and-block-range externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-beacon-chain-withdrawals-by-address-and-block-range summary: Get Beacon Chain Withdrawals by Address and Block Range description: Returns the beacon chain withdrawals made to an address. tags: - Accounts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xB9D7934878B5FB9610B3fE8A5e441e8fad7E293f' - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '100' - in: query name: startblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '0' - in: query name: endblock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '99999999' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - withdrawalIndex: '13' validatorIndex: '117823' address: '0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f' amount: '3402931175' blockNumber: '17034877' timestamp: '1681338599' - withdrawalIndex: '14' validatorIndex: '119023' address: '0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f' amount: '3244098967' blockNumber: '17034877' timestamp: '1681338599' /?module=account&action=balancehistory: get: operationId: get-historical-ether-balance-for-a-single-address-by-blockno externalDocs: url: https://docs.etherscan.io/api-endpoints/accounts#get-historical-ether-balance-for-a-single-address-by-blockno summary: Get Historical Ether Balance for a Single Address By BlockNo description: 'Returns the balance of an address at a certain block height. 📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier. PRO endpoint.' tags: - Accounts - API PRO Endpoints parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae' - in: query name: blockno schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '8000000' responses: '200': description: 'Operation result. 📖 Tip: The result field is denoted in wei.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.balancehistory' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '610538078574759898951277' /?module=contract&action=getabi: get: operationId: get-contract-abi-for-verified-contract-source-codes externalDocs: url: https://docs.etherscan.io/api-endpoints/contracts#get-contract-abi-for-verified-contract-source-codes summary: Get Contract ABI for Verified Contract Source Codes description: Returns the Contract Application Binary Interface ( ABI ) of a verified smart contract. Find verified contracts ✅on our Verified Contracts Source Code page. tags: - Contracts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.contract.getabi' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '[{"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"proposals","outputs":[{"name":"recipient","type":"address"},{"name":"amount","type":"uint256"},{"name":"description","type":"string"},{"name":"votingDeadline","type":"uint256"},{"name":"open","type":"bool"},{"name":"proposalPassed","type":"bool"},{"name":"proposalHash","type":"bytes32"},{"name":"proposalDeposit","type":"uint256"},{"name":"newCurator","type":"bool"},{"name":"yea","type":"uint256"},{"name":"nay","type":"uint256"},{"name":"creator","type":"address"}],"type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_amount","type":"uint256"}],"name":"approve","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"minTokensToCreate","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"rewardAccount","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[],"name":"daoCreator","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[],"name":"totalSupply","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"divisor","outputs":[{"name":"divisor","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"extraBalance","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_transactionData","type":"bytes"}],"name":"executeProposal","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferFrom","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"unblockMe","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"totalRewardToken","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"actualBalance","outputs":[{"name":"_actualBalance","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"closingTime","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"allowedRecipients","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferWithoutReward","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"refund","outputs":[],"type":"function"},{"constant":false,"inputs":[{"name":"_recipient","type":"address"},{"name":"_amount","type":"uint256"},{"name":"_description","type":"string"},{"name":"_transactionData","type":"bytes"},{"name":"_debatingPeriod","type":"uint256"},{"name":"_newCurator","type":"bool"}],"name":"newProposal","outputs":[{"name":"_proposalID","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"DAOpaidOut","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"minQuorumDivisor","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_newContract","type":"address"}],"name":"newContract","outputs":[],"type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"}],"name":"balanceOf","outputs":[{"name":"balance","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_recipient","type":"address"},{"name":"_allowed","type":"bool"}],"name":"changeAllowedRecipients","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"halveMinQuorum","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"paidOut","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_newCurator","type":"address"}],"name":"splitDAO","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"DAOrewardAccount","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[],"name":"proposalDeposit","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"numberOfProposals","outputs":[{"name":"_numberOfProposals","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"lastTimeMinQuorumMet","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_toMembers","type":"bool"}],"name":"retrieveDAOReward","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"receiveEther","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transfer","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"isFueled","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_tokenHolder","type":"address"}],"name":"createTokenProxy","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"_proposalID","type":"uint256"}],"name":"getNewDAOAddress","outputs":[{"name":"_newDAO","type":"address"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_supportsProposal","type":"bool"}],"name":"vote","outputs":[{"name":"_voteID","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[],"name":"getMyReward","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"rewardToken","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferFromWithoutReward","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"},{"name":"_spender","type":"address"}],"name":"allowance","outputs":[{"name":"remaining","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalDeposit","type":"uint256"}],"name":"changeProposalDeposit","outputs":[],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"blocked","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"curator","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_recipient","type":"address"},{"name":"_amount","type":"uint256"},{"name":"_transactionData","type":"bytes"}],"name":"checkProposalCode","outputs":[{"name":"_codeChecksOut","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"privateCreation","outputs":[{"name":"","type":"address"}],"type":"function"},{"inputs":[{"name":"_curator","type":"address"},{"name":"_daoCreator","type":"address"},{"name":"_proposalDeposit","type":"uint256"},{"name":"_minTokensToCreate","type":"uint256"},{"name":"_closingTime","type":"uint256"},{"name":"_privateCreation","type":"address"}],"type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_from","type":"address"},{"indexed":true,"name":"_to","type":"address"},{"indexed":false,"name":"_amount","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_owner","type":"address"},{"indexed":true,"name":"_spender","type":"address"},{"indexed":false,"name":"_amount","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"value","type":"uint256"}],"name":"FuelingToDate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"amount","type":"uint256"}],"name":"CreatedToken","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Refund","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"proposalID","type":"uint256"},{"indexed":false,"name":"recipient","type":"address"},{"indexed":false,"name":"amount","type":"uint256"},{"indexed":false,"name":"newCurator","type":"bool"},{"indexed":false,"name":"description","type":"string"}],"name":"ProposalAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"proposalID","type":"uint256"},{"indexed":false,"name":"position","type":"bool"},{"indexed":true,"name":"voter","type":"address"}],"name":"Voted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"proposalID","type":"uint256"},{"indexed":false,"name":"result","type":"bool"},{"indexed":false,"name":"quorum","type":"uint256"}],"name":"ProposalTallied","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_newCurator","type":"address"}],"name":"NewCurator","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_recipient","type":"address"},{"indexed":false,"name":"_allowed","type":"bool"}],"name":"AllowedRecipientChanged","type":"event"}]' /?module=contract&action=getsourcecode: get: operationId: get-contract-source-code-for-verified-contract-source-codes externalDocs: url: https://docs.etherscan.io/api-endpoints/contracts#get-contract-source-code-for-verified-contract-source-codes summary: Get Contract Source Code for Verified Contract Source Codes description: 'Returns the Solidity source code of a verified smart contract. 📩 Tip : You can also download a CSV list of verified contracts addresses of which the code publishers have provided a corresponding Open Source license for redistribution.' tags: - Contracts parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xBB9bc244D798123fDe783fCc1C72d3Bb8C189413' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - SourceCode: | /* - Bytecode Verification performed was compared on second iteration - This file is part of the DAO. The DAO is free software: you can redistribute it and/or modify it under the terms of the GNU lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. The DAO is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU lesser General Public License for more details. You should have received a copy of the GNU lesser General Public License along with the DAO. If not, see . */ /* Basic, standardized Token contract with no "premine". Defines the functions to check token balances, send tokens, send tokens on behalf of a 3rd party and the corresponding approval process. Tokens need to be created by a derived contract (e.g. TokenCreation.sol). Thank you ConsenSys, this contract originated from: https://github.com/ConsenSys/Tokens/blob/master/Token_Contracts/contracts/Standard_Token.sol Which is itself based on the Ethereum standardized contract APIs: https://github.com/ethereum/wiki/wiki/Standardized_Contract_APIs */ /// @title Standard Token Contract. contract TokenInterface { mapping (address => uint256) balances; mapping (address => mapping (address => uint256)) allowed; /// Total amount of tokens uint256 public totalSupply; /// @param _owner The address from which the balance will be retrieved /// @return The balance function balanceOf(address _owner) constant returns (uint256 balance); /// @notice Send `_amount` tokens to `_to` from `msg.sender` /// @param _to The address of the recipient /// @param _amount The amount of tokens to be transferred /// @return Whether the transfer was successful or not function transfer(address _to, uint256 _amount) returns (bool success); /// @notice Send `_amount` tokens to `_to` from `_from` on the condition it /// is approved by `_from` /// @param _from The address of the origin of the transfer /// @param _to The address of the recipient /// @param _amount The amount of tokens to be transferred /// @return Whether the transfer was successful or not function transferFrom(address _from, address _to, uint256 _amount) returns (bool success); /// @notice `msg.sender` approves `_spender` to spend `_amount` tokens on /// its behalf /// @param _spender The address of the account able to transfer the tokens /// @param _amount The amount of tokens to be approved for transfer /// @return Whether the approval was successful or not function approve(address _spender, uint256 _amount) returns (bool success); /// @param _owner The address of the account owning tokens /// @param _spender The address of the account able to transfer the tokens /// @return Amount of remaining tokens of _owner that _spender is allowed /// to spend function allowance( address _owner, address _spender ) constant returns (uint256 remaining); event Transfer(address indexed _from, address indexed _to, uint256 _amount); event Approval( address indexed _owner, address indexed _spender, uint256 _amount ); } contract Token is TokenInterface { // Protects users by preventing the execution of method calls that // inadvertently also transferred ether modifier noEther() {if (msg.value > 0) throw; _} function balanceOf(address _owner) constant returns (uint256 balance) { return balances[_owner]; } function transfer(address _to, uint256 _amount) noEther returns (bool success) { if (balances[msg.sender] >= _amount && _amount > 0) { balances[msg.sender] -= _amount; balances[_to] += _amount; Transfer(msg.sender, _to, _amount); return true; } else { return false; } } function transferFrom( address _from, address _to, uint256 _amount ) noEther returns (bool success) { if (balances[_from] >= _amount && allowed[_from][msg.sender] >= _amount && _amount > 0) { balances[_to] += _amount; balances[_from] -= _amount; allowed[_from][msg.sender] -= _amount; Transfer(_from, _to, _amount); return true; } else { return false; } } function approve(address _spender, uint256 _amount) returns (bool success) { allowed[msg.sender][_spender] = _amount; Approval(msg.sender, _spender, _amount); return true; } function allowance(address _owner, address _spender) constant returns (uint256 remaining) { return allowed[_owner][_spender]; } } /* This file is part of the DAO. The DAO is free software: you can redistribute it and/or modify it under the terms of the GNU lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. The DAO is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU lesser General Public License for more details. You should have received a copy of the GNU lesser General Public License along with the DAO. If not, see . */ /* Basic account, used by the DAO contract to separately manage both the rewards and the extraBalance accounts. */ contract ManagedAccountInterface { // The only address with permission to withdraw from this account address public owner; // If true, only the owner of the account can receive ether from it bool public payOwnerOnly; // The sum of ether (in wei) which has been sent to this contract uint public accumulatedInput; /// @notice Sends `_amount` of wei to _recipient /// @param _amount The amount of wei to send to `_recipient` /// @param _recipient The address to receive `_amount` of wei /// @return True if the send completed function payOut(address _recipient, uint _amount) returns (bool); event PayOut(address indexed _recipient, uint _amount); } contract ManagedAccount is ManagedAccountInterface{ // The constructor sets the owner of the account function ManagedAccount(address _owner, bool _payOwnerOnly) { owner = _owner; payOwnerOnly = _payOwnerOnly; } // When the contract receives a transaction without data this is called. // It counts the amount of ether it receives and stores it in // accumulatedInput. function() { accumulatedInput += msg.value; } function payOut(address _recipient, uint _amount) returns (bool) { if (msg.sender != owner || msg.value > 0 || (payOwnerOnly && _recipient != owner)) throw; if (_recipient.call.value(_amount)()) { PayOut(_recipient, _amount); return true; } else { return false; } } } /* This file is part of the DAO. The DAO is free software: you can redistribute it and/or modify it under the terms of the GNU lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. The DAO is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU lesser General Public License for more details. You should have received a copy of the GNU lesser General Public License along with the DAO. If not, see . */ /* * Token Creation contract, used by the DAO to create its tokens and initialize * its ether. Feel free to modify the divisor method to implement different * Token Creation parameters */ contract TokenCreationInterface { // End of token creation, in Unix time uint public closingTime; // Minimum fueling goal of the token creation, denominated in tokens to // be created uint public minTokensToCreate; // True if the DAO reached its minimum fueling goal, false otherwise bool public isFueled; // For DAO splits - if privateCreation is 0, then it is a public token // creation, otherwise only the address stored in privateCreation is // allowed to create tokens address public privateCreation; // hold extra ether which has been sent after the DAO token // creation rate has increased ManagedAccount public extraBalance; // tracks the amount of wei given from each contributor (used for refund) mapping (address => uint256) weiGiven; /// @dev Constructor setting the minimum fueling goal and the /// end of the Token Creation /// @param _minTokensToCreate Minimum fueling goal in number of /// Tokens to be created /// @param _closingTime Date (in Unix time) of the end of the Token Creation /// @param _privateCreation Zero means that the creation is public. A /// non-zero address represents the only address that can create Tokens /// (the address can also create Tokens on behalf of other accounts) // This is the constructor: it can not be overloaded so it is commented out // function TokenCreation( // uint _minTokensTocreate, // uint _closingTime, // address _privateCreation // ); /// @notice Create Token with `_tokenHolder` as the initial owner of the Token /// @param _tokenHolder The address of the Tokens's recipient /// @return Whether the token creation was successful function createTokenProxy(address _tokenHolder) returns (bool success); /// @notice Refund `msg.sender` in the case the Token Creation did /// not reach its minimum fueling goal function refund(); /// @return The divisor used to calculate the token creation rate during /// the creation phase function divisor() constant returns (uint divisor); event FuelingToDate(uint value); event CreatedToken(address indexed to, uint amount); event Refund(address indexed to, uint value); } contract TokenCreation is TokenCreationInterface, Token { function TokenCreation( uint _minTokensToCreate, uint _closingTime, address _privateCreation) { closingTime = _closingTime; minTokensToCreate = _minTokensToCreate; privateCreation = _privateCreation; extraBalance = new ManagedAccount(address(this), true); } function createTokenProxy(address _tokenHolder) returns (bool success) { if (now < closingTime && msg.value > 0 && (privateCreation == 0 || privateCreation == msg.sender)) { uint token = (msg.value * 20) / divisor(); extraBalance.call.value(msg.value - token)(); balances[_tokenHolder] += token; totalSupply += token; weiGiven[_tokenHolder] += msg.value; CreatedToken(_tokenHolder, token); if (totalSupply >= minTokensToCreate && !isFueled) { isFueled = true; FuelingToDate(totalSupply); } return true; } throw; } function refund() noEther { if (now > closingTime && !isFueled) { // Get extraBalance - will only succeed when called for the first time if (extraBalance.balance >= extraBalance.accumulatedInput()) extraBalance.payOut(address(this), extraBalance.accumulatedInput()); // Execute refund if (msg.sender.call.value(weiGiven[msg.sender])()) { Refund(msg.sender, weiGiven[msg.sender]); totalSupply -= balances[msg.sender]; balances[msg.sender] = 0; weiGiven[msg.sender] = 0; } } } function divisor() constant returns (uint divisor) { // The number of (base unit) tokens per wei is calculated // as `msg.value` * 20 / `divisor` // The fueling period starts with a 1:1 ratio if (closingTime - 2 weeks > now) { return 20; // Followed by 10 days with a daily creation rate increase of 5% } else if (closingTime - 4 days > now) { return (20 + (now - (closingTime - 2 weeks)) / (1 days)); // The last 4 days there is a constant creation rate ratio of 1:1.5 } else { return 30; } } } /* This file is part of the DAO. The DAO is free software: you can redistribute it and/or modify it under the terms of the GNU lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. The DAO is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU lesser General Public License for more details. You should have received a copy of the GNU lesser General Public License along with the DAO. If not, see . */ /* Standard smart contract for a Decentralized Autonomous Organization (DAO) to automate organizational governance and decision-making. */ contract DAOInterface { // The amount of days for which people who try to participate in the // creation by calling the fallback function will still get their ether back uint constant creationGracePeriod = 40 days; // The minimum debate period that a generic proposal can have uint constant minProposalDebatePeriod = 2 weeks; // The minimum debate period that a split proposal can have uint constant minSplitDebatePeriod = 1 weeks; // Period of days inside which it's possible to execute a DAO split uint constant splitExecutionPeriod = 27 days; // Period of time after which the minimum Quorum is halved uint constant quorumHalvingPeriod = 25 weeks; // Period after which a proposal is closed // (used in the case `executeProposal` fails because it throws) uint constant executeProposalPeriod = 10 days; // Denotes the maximum proposal deposit that can be given. It is given as // a fraction of total Ether spent plus balance of the DAO uint constant maxDepositDivisor = 100; // Proposals to spend the DAO's ether or to choose a new Curator Proposal[] public proposals; // The quorum needed for each proposal is partially calculated by // totalSupply / minQuorumDivisor uint public minQuorumDivisor; // The unix time of the last time quorum was reached on a proposal uint public lastTimeMinQuorumMet; // Address of the curator address public curator; // The whitelist: List of addresses the DAO is allowed to send ether to mapping (address => bool) public allowedRecipients; // Tracks the addresses that own Reward Tokens. Those addresses can only be // DAOs that have split from the original DAO. Conceptually, Reward Tokens // represent the proportion of the rewards that the DAO has the right to // receive. These Reward Tokens are generated when the DAO spends ether. mapping (address => uint) public rewardToken; // Total supply of rewardToken uint public totalRewardToken; // The account used to manage the rewards which are to be distributed to the // DAO Token Holders of this DAO ManagedAccount public rewardAccount; // The account used to manage the rewards which are to be distributed to // any DAO that holds Reward Tokens ManagedAccount public DAOrewardAccount; // Amount of rewards (in wei) already paid out to a certain DAO mapping (address => uint) public DAOpaidOut; // Amount of rewards (in wei) already paid out to a certain address mapping (address => uint) public paidOut; // Map of addresses blocked during a vote (not allowed to transfer DAO // tokens). The address points to the proposal ID. mapping (address => uint) public blocked; // The minimum deposit (in wei) required to submit any proposal that is not // requesting a new Curator (no deposit is required for splits) uint public proposalDeposit; // the accumulated sum of all current proposal deposits uint sumOfProposalDeposits; // Contract that is able to create a new DAO (with the same code as // this one), used for splits DAO_Creator public daoCreator; // A proposal with `newCurator == false` represents a transaction // to be issued by this DAO // A proposal with `newCurator == true` represents a DAO split struct Proposal { // The address where the `amount` will go to if the proposal is accepted // or if `newCurator` is true, the proposed Curator of // the new DAO). address recipient; // The amount to transfer to `recipient` if the proposal is accepted. uint amount; // A plain text description of the proposal string description; // A unix timestamp, denoting the end of the voting period uint votingDeadline; // True if the proposal's votes have yet to be counted, otherwise False bool open; // True if quorum has been reached, the votes have been counted, and // the majority said yes bool proposalPassed; // A hash to check validity of a proposal bytes32 proposalHash; // Deposit in wei the creator added when submitting their proposal. It // is taken from the msg.value of a newProposal call. uint proposalDeposit; // True if this proposal is to assign a new Curator bool newCurator; // Data needed for splitting the DAO SplitData[] splitData; // Number of Tokens in favor of the proposal uint yea; // Number of Tokens opposed to the proposal uint nay; // Simple mapping to check if a shareholder has voted for it mapping (address => bool) votedYes; // Simple mapping to check if a shareholder has voted against it mapping (address => bool) votedNo; // Address of the shareholder who created the proposal address creator; } // Used only in the case of a newCurator proposal. struct SplitData { // The balance of the current DAO minus the deposit at the time of split uint splitBalance; // The total amount of DAO Tokens in existence at the time of split. uint totalSupply; // Amount of Reward Tokens owned by the DAO at the time of split. uint rewardToken; // The new DAO contract created at the time of split. DAO newDAO; } // Used to restrict access to certain functions to only DAO Token Holders modifier onlyTokenholders {} /// @dev Constructor setting the Curator and the address /// for the contract able to create another DAO as well as the parameters /// for the DAO Token Creation /// @param _curator The Curator /// @param _daoCreator The contract able to (re)create this DAO /// @param _proposalDeposit The deposit to be paid for a regular proposal /// @param _minTokensToCreate Minimum required wei-equivalent tokens /// to be created for a successful DAO Token Creation /// @param _closingTime Date (in Unix time) of the end of the DAO Token Creation /// @param _privateCreation If zero the DAO Token Creation is open to public, a /// non-zero address means that the DAO Token Creation is only for the address // This is the constructor: it can not be overloaded so it is commented out // function DAO( // address _curator, // DAO_Creator _daoCreator, // uint _proposalDeposit, // uint _minTokensToCreate, // uint _closingTime, // address _privateCreation // ); /// @notice Create Token with `msg.sender` as the beneficiary /// @return Whether the token creation was successful function () returns (bool success); /// @dev This function is used to send ether back /// to the DAO, it can also be used to receive payments that should not be /// counted as rewards (donations, grants, etc.) /// @return Whether the DAO received the ether successfully function receiveEther() returns(bool); /// @notice `msg.sender` creates a proposal to send `_amount` Wei to /// `_recipient` with the transaction data `_transactionData`. If /// `_newCurator` is true, then this is a proposal that splits the /// DAO and sets `_recipient` as the new DAO's Curator. /// @param _recipient Address of the recipient of the proposed transaction /// @param _amount Amount of wei to be sent with the proposed transaction /// @param _description String describing the proposal /// @param _transactionData Data of the proposed transaction /// @param _debatingPeriod Time used for debating a proposal, at least 2 /// weeks for a regular proposal, 10 days for new Curator proposal /// @param _newCurator Bool defining whether this proposal is about /// a new Curator or not /// @return The proposal ID. Needed for voting on the proposal function newProposal( address _recipient, uint _amount, string _description, bytes _transactionData, uint _debatingPeriod, bool _newCurator ) onlyTokenholders returns (uint _proposalID); /// @notice Check that the proposal with the ID `_proposalID` matches the /// transaction which sends `_amount` with data `_transactionData` /// to `_recipient` /// @param _proposalID The proposal ID /// @param _recipient The recipient of the proposed transaction /// @param _amount The amount of wei to be sent in the proposed transaction /// @param _transactionData The data of the proposed transaction /// @return Whether the proposal ID matches the transaction data or not function checkProposalCode( uint _proposalID, address _recipient, uint _amount, bytes _transactionData ) constant returns (bool _codeChecksOut); /// @notice Vote on proposal `_proposalID` with `_supportsProposal` /// @param _proposalID The proposal ID /// @param _supportsProposal Yes/No - support of the proposal /// @return The vote ID. function vote( uint _proposalID, bool _supportsProposal ) onlyTokenholders returns (uint _voteID); /// @notice Checks whether proposal `_proposalID` with transaction data /// `_transactionData` has been voted for or rejected, and executes the /// transaction in the case it has been voted for. /// @param _proposalID The proposal ID /// @param _transactionData The data of the proposed transaction /// @return Whether the proposed transaction has been executed or not function executeProposal( uint _proposalID, bytes _transactionData ) returns (bool _success); /// @notice ATTENTION! I confirm to move my remaining ether to a new DAO /// with `_newCurator` as the new Curator, as has been /// proposed in proposal `_proposalID`. This will burn my tokens. This can /// not be undone and will split the DAO into two DAO's, with two /// different underlying tokens. /// @param _proposalID The proposal ID /// @param _newCurator The new Curator of the new DAO /// @dev This function, when called for the first time for this proposal, /// will create a new DAO and send the sender's portion of the remaining /// ether and Reward Tokens to the new DAO. It will also burn the DAO Tokens /// of the sender. function splitDAO( uint _proposalID, address _newCurator ) returns (bool _success); /// @dev can only be called by the DAO itself through a proposal /// updates the contract of the DAO by sending all ether and rewardTokens /// to the new DAO. The new DAO needs to be approved by the Curator /// @param _newContract the address of the new contract function newContract(address _newContract); /// @notice Add a new possible recipient `_recipient` to the whitelist so /// that the DAO can send transactions to them (using proposals) /// @param _recipient New recipient address /// @dev Can only be called by the current Curator /// @return Whether successful or not function changeAllowedRecipients(address _recipient, bool _allowed) external returns (bool _success); /// @notice Change the minimum deposit required to submit a proposal /// @param _proposalDeposit The new proposal deposit /// @dev Can only be called by this DAO (through proposals with the /// recipient being this DAO itself) function changeProposalDeposit(uint _proposalDeposit) external; /// @notice Move rewards from the DAORewards managed account /// @param _toMembers If true rewards are moved to the actual reward account /// for the DAO. If not then it's moved to the DAO itself /// @return Whether the call was successful function retrieveDAOReward(bool _toMembers) external returns (bool _success); /// @notice Get my portion of the reward that was sent to `rewardAccount` /// @return Whether the call was successful function getMyReward() returns(bool _success); /// @notice Withdraw `_account`'s portion of the reward from `rewardAccount` /// to `_account`'s balance /// @return Whether the call was successful function withdrawRewardFor(address _account) internal returns (bool _success); /// @notice Send `_amount` tokens to `_to` from `msg.sender`. Prior to this /// getMyReward() is called. /// @param _to The address of the recipient /// @param _amount The amount of tokens to be transfered /// @return Whether the transfer was successful or not function transferWithoutReward(address _to, uint256 _amount) returns (bool success); /// @notice Send `_amount` tokens to `_to` from `_from` on the condition it /// is approved by `_from`. Prior to this getMyReward() is called. /// @param _from The address of the sender /// @param _to The address of the recipient /// @param _amount The amount of tokens to be transfered /// @return Whether the transfer was successful or not function transferFromWithoutReward( address _from, address _to, uint256 _amount ) returns (bool success); /// @notice Doubles the 'minQuorumDivisor' in the case quorum has not been /// achieved in 52 weeks /// @return Whether the change was successful or not function halveMinQuorum() returns (bool _success); /// @return total number of proposals ever created function numberOfProposals() constant returns (uint _numberOfProposals); /// @param _proposalID Id of the new curator proposal /// @return Address of the new DAO function getNewDAOAddress(uint _proposalID) constant returns (address _newDAO); /// @param _account The address of the account which is checked. /// @return Whether the account is blocked (not allowed to transfer tokens) or not. function isBlocked(address _account) internal returns (bool); /// @notice If the caller is blocked by a proposal whose voting deadline /// has exprired then unblock him. /// @return Whether the account is blocked (not allowed to transfer tokens) or not. function unblockMe() returns (bool); event ProposalAdded( uint indexed proposalID, address recipient, uint amount, bool newCurator, string description ); event Voted(uint indexed proposalID, bool position, address indexed voter); event ProposalTallied(uint indexed proposalID, bool result, uint quorum); event NewCurator(address indexed _newCurator); event AllowedRecipientChanged(address indexed _recipient, bool _allowed); } // The DAO contract itself contract DAO is DAOInterface, Token, TokenCreation { // Modifier that allows only shareholders to vote and create new proposals modifier onlyTokenholders { if (balanceOf(msg.sender) == 0) throw; _ } function DAO( address _curator, DAO_Creator _daoCreator, uint _proposalDeposit, uint _minTokensToCreate, uint _closingTime, address _privateCreation ) TokenCreation(_minTokensToCreate, _closingTime, _privateCreation) { curator = _curator; daoCreator = _daoCreator; proposalDeposit = _proposalDeposit; rewardAccount = new ManagedAccount(address(this), false); DAOrewardAccount = new ManagedAccount(address(this), false); if (address(rewardAccount) == 0) throw; if (address(DAOrewardAccount) == 0) throw; lastTimeMinQuorumMet = now; minQuorumDivisor = 5; // sets the minimal quorum to 20% proposals.length = 1; // avoids a proposal with ID 0 because it is used allowedRecipients[address(this)] = true; allowedRecipients[curator] = true; } function () returns (bool success) { if (now < closingTime + creationGracePeriod && msg.sender != address(extraBalance)) return createTokenProxy(msg.sender); else return receiveEther(); } function receiveEther() returns (bool) { return true; } function newProposal( address _recipient, uint _amount, string _description, bytes _transactionData, uint _debatingPeriod, bool _newCurator ) onlyTokenholders returns (uint _proposalID) { // Sanity check if (_newCurator && ( _amount != 0 || _transactionData.length != 0 || _recipient == curator || msg.value > 0 || _debatingPeriod < minSplitDebatePeriod)) { throw; } else if ( !_newCurator && (!isRecipientAllowed(_recipient) || (_debatingPeriod < minProposalDebatePeriod)) ) { throw; } if (_debatingPeriod > 8 weeks) throw; if (!isFueled || now < closingTime || (msg.value < proposalDeposit && !_newCurator)) { throw; } if (now + _debatingPeriod < now) // prevents overflow throw; // to prevent a 51% attacker to convert the ether into deposit if (msg.sender == address(this)) throw; _proposalID = proposals.length++; Proposal p = proposals[_proposalID]; p.recipient = _recipient; p.amount = _amount; p.description = _description; p.proposalHash = sha3(_recipient, _amount, _transactionData); p.votingDeadline = now + _debatingPeriod; p.open = true; //p.proposalPassed = False; // that's default p.newCurator = _newCurator; if (_newCurator) p.splitData.length++; p.creator = msg.sender; p.proposalDeposit = msg.value; sumOfProposalDeposits += msg.value; ProposalAdded( _proposalID, _recipient, _amount, _newCurator, _description ); } function checkProposalCode( uint _proposalID, address _recipient, uint _amount, bytes _transactionData ) noEther constant returns (bool _codeChecksOut) { Proposal p = proposals[_proposalID]; return p.proposalHash == sha3(_recipient, _amount, _transactionData); } function vote( uint _proposalID, bool _supportsProposal ) onlyTokenholders noEther returns (uint _voteID) { Proposal p = proposals[_proposalID]; if (p.votedYes[msg.sender] || p.votedNo[msg.sender] || now >= p.votingDeadline) { throw; } if (_supportsProposal) { p.yea += balances[msg.sender]; p.votedYes[msg.sender] = true; } else { p.nay += balances[msg.sender]; p.votedNo[msg.sender] = true; } if (blocked[msg.sender] == 0) { blocked[msg.sender] = _proposalID; } else if (p.votingDeadline > proposals[blocked[msg.sender]].votingDeadline) { // this proposal's voting deadline is further into the future than // the proposal that blocks the sender so make it the blocker blocked[msg.sender] = _proposalID; } Voted(_proposalID, _supportsProposal, msg.sender); } function executeProposal( uint _proposalID, bytes _transactionData ) noEther returns (bool _success) { Proposal p = proposals[_proposalID]; uint waitPeriod = p.newCurator ? splitExecutionPeriod : executeProposalPeriod; // If we are over deadline and waiting period, assert proposal is closed if (p.open && now > p.votingDeadline + waitPeriod) { closeProposal(_proposalID); return; } // Check if the proposal can be executed if (now < p.votingDeadline // has the voting deadline arrived? // Have the votes been counted? || !p.open // Does the transaction code match the proposal? || p.proposalHash != sha3(p.recipient, p.amount, _transactionData)) { throw; } // If the curator removed the recipient from the whitelist, close the proposal // in order to free the deposit and allow unblocking of voters if (!isRecipientAllowed(p.recipient)) { closeProposal(_proposalID); p.creator.send(p.proposalDeposit); return; } bool proposalCheck = true; if (p.amount > actualBalance()) proposalCheck = false; uint quorum = p.yea + p.nay; // require 53% for calling newContract() if (_transactionData.length >= 4 && _transactionData[0] == 0x68 && _transactionData[1] == 0x37 && _transactionData[2] == 0xff && _transactionData[3] == 0x1e && quorum < minQuorum(actualBalance() + rewardToken[address(this)])) { proposalCheck = false; } if (quorum >= minQuorum(p.amount)) { if (!p.creator.send(p.proposalDeposit)) throw; lastTimeMinQuorumMet = now; // set the minQuorum to 20% again, in the case it has been reached if (quorum > totalSupply / 5) minQuorumDivisor = 5; } // Execute result if (quorum >= minQuorum(p.amount) && p.yea > p.nay && proposalCheck) { if (!p.recipient.call.value(p.amount)(_transactionData)) throw; p.proposalPassed = true; _success = true; // only create reward tokens when ether is not sent to the DAO itself and // related addresses. Proxy addresses should be forbidden by the curator. if (p.recipient != address(this) && p.recipient != address(rewardAccount) && p.recipient != address(DAOrewardAccount) && p.recipient != address(extraBalance) && p.recipient != address(curator)) { rewardToken[address(this)] += p.amount; totalRewardToken += p.amount; } } closeProposal(_proposalID); // Initiate event ProposalTallied(_proposalID, _success, quorum); } function closeProposal(uint _proposalID) internal { Proposal p = proposals[_proposalID]; if (p.open) sumOfProposalDeposits -= p.proposalDeposit; p.open = false; } function splitDAO( uint _proposalID, address _newCurator ) noEther onlyTokenholders returns (bool _success) { Proposal p = proposals[_proposalID]; // Sanity check if (now < p.votingDeadline // has the voting deadline arrived? //The request for a split expires XX days after the voting deadline || now > p.votingDeadline + splitExecutionPeriod // Does the new Curator address match? || p.recipient != _newCurator // Is it a new curator proposal? || !p.newCurator // Have you voted for this split? || !p.votedYes[msg.sender] // Did you already vote on another proposal? || (blocked[msg.sender] != _proposalID && blocked[msg.sender] != 0) ) { throw; } // If the new DAO doesn't exist yet, create the new DAO and store the // current split data if (address(p.splitData[0].newDAO) == 0) { p.splitData[0].newDAO = createNewDAO(_newCurator); // Call depth limit reached, etc. if (address(p.splitData[0].newDAO) == 0) throw; // should never happen if (this.balance < sumOfProposalDeposits) throw; p.splitData[0].splitBalance = actualBalance(); p.splitData[0].rewardToken = rewardToken[address(this)]; p.splitData[0].totalSupply = totalSupply; p.proposalPassed = true; } // Move ether and assign new Tokens uint fundsToBeMoved = (balances[msg.sender] * p.splitData[0].splitBalance) / p.splitData[0].totalSupply; if (p.splitData[0].newDAO.createTokenProxy.value(fundsToBeMoved)(msg.sender) == false) throw; // Assign reward rights to new DAO uint rewardTokenToBeMoved = (balances[msg.sender] * p.splitData[0].rewardToken) / p.splitData[0].totalSupply; uint paidOutToBeMoved = DAOpaidOut[address(this)] * rewardTokenToBeMoved / rewardToken[address(this)]; rewardToken[address(p.splitData[0].newDAO)] += rewardTokenToBeMoved; if (rewardToken[address(this)] < rewardTokenToBeMoved) throw; rewardToken[address(this)] -= rewardTokenToBeMoved; DAOpaidOut[address(p.splitData[0].newDAO)] += paidOutToBeMoved; if (DAOpaidOut[address(this)] < paidOutToBeMoved) throw; DAOpaidOut[address(this)] -= paidOutToBeMoved; // Burn DAO Tokens Transfer(msg.sender, 0, balances[msg.sender]); withdrawRewardFor(msg.sender); // be nice, and get his rewards totalSupply -= balances[msg.sender]; balances[msg.sender] = 0; paidOut[msg.sender] = 0; return true; } function newContract(address _newContract){ if (msg.sender != address(this) || !allowedRecipients[_newContract]) return; // move all ether if (!_newContract.call.value(address(this).balance)()) { throw; } //move all reward tokens rewardToken[_newContract] += rewardToken[address(this)]; rewardToken[address(this)] = 0; DAOpaidOut[_newContract] += DAOpaidOut[address(this)]; DAOpaidOut[address(this)] = 0; } function retrieveDAOReward(bool _toMembers) external noEther returns (bool _success) { DAO dao = DAO(msg.sender); if ((rewardToken[msg.sender] * DAOrewardAccount.accumulatedInput()) / totalRewardToken < DAOpaidOut[msg.sender]) throw; uint reward = (rewardToken[msg.sender] * DAOrewardAccount.accumulatedInput()) / totalRewardToken - DAOpaidOut[msg.sender]; if(_toMembers) { if (!DAOrewardAccount.payOut(dao.rewardAccount(), reward)) throw; } else { if (!DAOrewardAccount.payOut(dao, reward)) throw; } DAOpaidOut[msg.sender] += reward; return true; } function getMyReward() noEther returns (bool _success) { return withdrawRewardFor(msg.sender); } function withdrawRewardFor(address _account) noEther internal returns (bool _success) { if ((balanceOf(_account) * rewardAccount.accumulatedInput()) / totalSupply < paidOut[_account]) throw; uint reward = (balanceOf(_account) * rewardAccount.accumulatedInput()) / totalSupply - paidOut[_account]; if (!rewardAccount.payOut(_account, reward)) throw; paidOut[_account] += reward; return true; } function transfer(address _to, uint256 _value) returns (bool success) { if (isFueled && now > closingTime && !isBlocked(msg.sender) && transferPaidOut(msg.sender, _to, _value) && super.transfer(_to, _value)) { return true; } else { throw; } } function transferWithoutReward(address _to, uint256 _value) returns (bool success) { if (!getMyReward()) throw; return transfer(_to, _value); } function transferFrom(address _from, address _to, uint256 _value) returns (bool success) { if (isFueled && now > closingTime && !isBlocked(_from) && transferPaidOut(_from, _to, _value) && super.transferFrom(_from, _to, _value)) { return true; } else { throw; } } function transferFromWithoutReward( address _from, address _to, uint256 _value ) returns (bool success) { if (!withdrawRewardFor(_from)) throw; return transferFrom(_from, _to, _value); } function transferPaidOut( address _from, address _to, uint256 _value ) internal returns (bool success) { uint transferPaidOut = paidOut[_from] * _value / balanceOf(_from); if (transferPaidOut > paidOut[_from]) throw; paidOut[_from] -= transferPaidOut; paidOut[_to] += transferPaidOut; return true; } function changeProposalDeposit(uint _proposalDeposit) noEther external { if (msg.sender != address(this) || _proposalDeposit > (actualBalance() + rewardToken[address(this)]) / maxDepositDivisor) { throw; } proposalDeposit = _proposalDeposit; } function changeAllowedRecipients(address _recipient, bool _allowed) noEther external returns (bool _success) { if (msg.sender != curator) throw; allowedRecipients[_recipient] = _allowed; AllowedRecipientChanged(_recipient, _allowed); return true; } function isRecipientAllowed(address _recipient) internal returns (bool _isAllowed) { if (allowedRecipients[_recipient] || (_recipient == address(extraBalance) // only allowed when at least the amount held in the // extraBalance account has been spent from the DAO && totalRewardToken > extraBalance.accumulatedInput())) return true; else return false; } function actualBalance() constant returns (uint _actualBalance) { return this.balance - sumOfProposalDeposits; } function minQuorum(uint _value) internal constant returns (uint _minQuorum) { // minimum of 20% and maximum of 53.33% return totalSupply / minQuorumDivisor + (_value * totalSupply) / (3 * (actualBalance() + rewardToken[address(this)])); } function halveMinQuorum() returns (bool _success) { // this can only be called after `quorumHalvingPeriod` has passed or at anytime // by the curator with a delay of at least `minProposalDebatePeriod` between the calls if ((lastTimeMinQuorumMet < (now - quorumHalvingPeriod) || msg.sender == curator) && lastTimeMinQuorumMet < (now - minProposalDebatePeriod)) { lastTimeMinQuorumMet = now; minQuorumDivisor *= 2; return true; } else { return false; } } function createNewDAO(address _newCurator) internal returns (DAO _newDAO) { NewCurator(_newCurator); return daoCreator.createDAO(_newCurator, 0, 0, now + splitExecutionPeriod); } function numberOfProposals() constant returns (uint _numberOfProposals) { // Don't count index 0. It's used by isBlocked() and exists from start return proposals.length - 1; } function getNewDAOAddress(uint _proposalID) constant returns (address _newDAO) { return proposals[_proposalID].splitData[0].newDAO; } function isBlocked(address _account) internal returns (bool) { if (blocked[_account] == 0) return false; Proposal p = proposals[blocked[_account]]; if (now > p.votingDeadline) { blocked[_account] = 0; return false; } else { return true; } } function unblockMe() returns (bool) { return isBlocked(msg.sender); } } contract DAO_Creator { function createDAO( address _curator, uint _proposalDeposit, uint _minTokensToCreate, uint _closingTime ) returns (DAO _newDAO) { return new DAO( _curator, DAO_Creator(this), _proposalDeposit, _minTokensToCreate, _closingTime, msg.sender ); } } ABI: '[{"constant":true,"inputs":[{"name":"","type":"uint256"}],"name":"proposals","outputs":[{"name":"recipient","type":"address"},{"name":"amount","type":"uint256"},{"name":"description","type":"string"},{"name":"votingDeadline","type":"uint256"},{"name":"open","type":"bool"},{"name":"proposalPassed","type":"bool"},{"name":"proposalHash","type":"bytes32"},{"name":"proposalDeposit","type":"uint256"},{"name":"newCurator","type":"bool"},{"name":"yea","type":"uint256"},{"name":"nay","type":"uint256"},{"name":"creator","type":"address"}],"type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_amount","type":"uint256"}],"name":"approve","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"minTokensToCreate","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"rewardAccount","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[],"name":"daoCreator","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[],"name":"totalSupply","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"divisor","outputs":[{"name":"divisor","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"extraBalance","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_transactionData","type":"bytes"}],"name":"executeProposal","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferFrom","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"unblockMe","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"totalRewardToken","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"actualBalance","outputs":[{"name":"_actualBalance","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"closingTime","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"allowedRecipients","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferWithoutReward","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"refund","outputs":[],"type":"function"},{"constant":false,"inputs":[{"name":"_recipient","type":"address"},{"name":"_amount","type":"uint256"},{"name":"_description","type":"string"},{"name":"_transactionData","type":"bytes"},{"name":"_debatingPeriod","type":"uint256"},{"name":"_newCurator","type":"bool"}],"name":"newProposal","outputs":[{"name":"_proposalID","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"DAOpaidOut","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"minQuorumDivisor","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_newContract","type":"address"}],"name":"newContract","outputs":[],"type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"}],"name":"balanceOf","outputs":[{"name":"balance","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_recipient","type":"address"},{"name":"_allowed","type":"bool"}],"name":"changeAllowedRecipients","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"halveMinQuorum","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"paidOut","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_newCurator","type":"address"}],"name":"splitDAO","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"DAOrewardAccount","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[],"name":"proposalDeposit","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"numberOfProposals","outputs":[{"name":"_numberOfProposals","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"lastTimeMinQuorumMet","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_toMembers","type":"bool"}],"name":"retrieveDAOReward","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":false,"inputs":[],"name":"receiveEther","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transfer","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"isFueled","outputs":[{"name":"","type":"bool"}],"type":"function"},{"constant":false,"inputs":[{"name":"_tokenHolder","type":"address"}],"name":"createTokenProxy","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"_proposalID","type":"uint256"}],"name":"getNewDAOAddress","outputs":[{"name":"_newDAO","type":"address"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_supportsProposal","type":"bool"}],"name":"vote","outputs":[{"name":"_voteID","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[],"name":"getMyReward","outputs":[{"name":"_success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"rewardToken","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferFromWithoutReward","outputs":[{"name":"success","type":"bool"}],"type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"},{"name":"_spender","type":"address"}],"name":"allowance","outputs":[{"name":"remaining","type":"uint256"}],"type":"function"},{"constant":false,"inputs":[{"name":"_proposalDeposit","type":"uint256"}],"name":"changeProposalDeposit","outputs":[],"type":"function"},{"constant":true,"inputs":[{"name":"","type":"address"}],"name":"blocked","outputs":[{"name":"","type":"uint256"}],"type":"function"},{"constant":true,"inputs":[],"name":"curator","outputs":[{"name":"","type":"address"}],"type":"function"},{"constant":true,"inputs":[{"name":"_proposalID","type":"uint256"},{"name":"_recipient","type":"address"},{"name":"_amount","type":"uint256"},{"name":"_transactionData","type":"bytes"}],"name":"checkProposalCode","outputs":[{"name":"_codeChecksOut","type":"bool"}],"type":"function"},{"constant":true,"inputs":[],"name":"privateCreation","outputs":[{"name":"","type":"address"}],"type":"function"},{"inputs":[{"name":"_curator","type":"address"},{"name":"_daoCreator","type":"address"},{"name":"_proposalDeposit","type":"uint256"},{"name":"_minTokensToCreate","type":"uint256"},{"name":"_closingTime","type":"uint256"},{"name":"_privateCreation","type":"address"}],"type":"constructor"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_from","type":"address"},{"indexed":true,"name":"_to","type":"address"},{"indexed":false,"name":"_amount","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_owner","type":"address"},{"indexed":true,"name":"_spender","type":"address"},{"indexed":false,"name":"_amount","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"name":"value","type":"uint256"}],"name":"FuelingToDate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"amount","type":"uint256"}],"name":"CreatedToken","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Refund","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"proposalID","type":"uint256"},{"indexed":false,"name":"recipient","type":"address"},{"indexed":false,"name":"amount","type":"uint256"},{"indexed":false,"name":"newCurator","type":"bool"},{"indexed":false,"name":"description","type":"string"}],"name":"ProposalAdded","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"proposalID","type":"uint256"},{"indexed":false,"name":"position","type":"bool"},{"indexed":true,"name":"voter","type":"address"}],"name":"Voted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"proposalID","type":"uint256"},{"indexed":false,"name":"result","type":"bool"},{"indexed":false,"name":"quorum","type":"uint256"}],"name":"ProposalTallied","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_newCurator","type":"address"}],"name":"NewCurator","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_recipient","type":"address"},{"indexed":false,"name":"_allowed","type":"bool"}],"name":"AllowedRecipientChanged","type":"event"}]' ContractName: DAO CompilerVersion: v0.3.1-2016-04-12-3ad5e82 OptimizationUsed: '1' Runs: '200' ConstructorArguments: 000000000000000000000000da4a4626d3e16e094de3225a751aab7128e965260000000000000000000000004a574510c7014e4ae985403536074abe582adfc80000000000000000000000000000000000000000000000001bc16d674ec80000000000000000000000000000000000000000000000000a968163f0a57b4000000000000000000000000000000000000000000000000000000000000057495e100000000000000000000000000000000000000000000000000000000000000000 EVMVersion: Default Library: '' LicenseType: '' Proxy: '0' Implementation: '' SwarmSource: '' /?module=contract&action=getcontractcreation: get: operationId: get-contract-creator-and-creation-tx-hash externalDocs: url: https://docs.etherscan.io/api-endpoints/contracts#get-contract-creator-and-creation-tx-hash summary: Get Contract Creator and Creation Tx Hash description: Returns a contract's deployer address and transaction hash it was created, up to 5 at a time. tags: - Contracts parameters: - in: query name: contractaddresses schema: type: array items: $ref: '#/components/schemas/AddressHash' maxItems: 5 style: form explode: false example: 0xB83c27805aAcA5C7082eB45C868d955Cf04C337F,0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45,0xe4462eb568E2DFbb5b0cA2D3DbB1A35C9Aa98aad,0xdAC17F958D2ee523a2206206994597C13D831ec7,0xf5b969064b91869fBF676ecAbcCd1c5563F591d0 responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.contract.getcontractcreation' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - contractAddress: '0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45' contractCreator: '0x6c9fc64a53c1b71fb3f9af64d1ae3a4931a5f4e9' txHash: '0x7299cca7203f60a831756e043f4c2ccb0ee6cb7cf8aed8420f0ae99a16883a2b' - contractAddress: '0xb83c27805aaca5c7082eb45c868d955cf04c337f' contractCreator: '0x390dcfddebeff949b9862ec91d7be337b8995553' txHash: '0x0dbad4991b6727df606650635c9e632dad8a92c6363c91652307680efd336c6e' - contractAddress: '0xdac17f958d2ee523a2206206994597c13d831ec7' contractCreator: '0x36928500bc1dcd7af6a2b4008875cc336b927d57' txHash: '0x2f1c5c2b44f771e942a8506148e256f94f1a464babc938ae0690c6e34cd79190' - contractAddress: '0xe4462eb568e2dfbb5b0ca2d3dbb1a35c9aa98aad' contractCreator: '0xa6d3a33a1c66083859765b9d6e407d095a908193' txHash: '0x785bcd378c8168b63c9fdef64219f8ff69eec1f785f081a74513f21b18072f93' - contractAddress: '0xf5b969064b91869fbf676ecabccd1c5563f591d0' contractCreator: '0x435a5760aa360cae8c246039abab7754e80a1af1' txHash: '0x779cceffd0a5b4df6718674f7d88dda3edde9ff0a6fec271eb584f65a56997c6' /?module=contract&action=verifysourcecode: post: operationId: verify-source-code externalDocs: url: https://docs.etherscan.io/api-endpoints/contracts#verify-source-code summary: Verify Source Code description: 'Submits a contract source code to an Etherscan-like explorer for verification. 🌐 Tutorial : A full walk through of submitting multichain contract verification.📝 Note : This endpoint is limited to 100 verifications/day, regardless of API PRO tier.' tags: - Contracts parameters: [] responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.contract.verifysourcecode' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: a7lpxkm9kpcpicx7daftmjifrfhiuhf5vqqnawhkfhzfrcpnxj requestBody: content: multipart/form-data: schema: $ref: '#/components/schemas/Post.contract.verifysourcecode' /?module=contract&action=checkverifystatus: get: operationId: check-source-code-verification-status externalDocs: url: https://docs.etherscan.io/api-endpoints/contracts#check-source-code-verification-status summary: Check Source Code Verification Status description: Returns the success or error status of a contract verification request. tags: - Contracts parameters: - in: query name: guid schema: $ref: '#/components/schemas/GUID' required: true example: x3ryqcqr1zdknhfhkimqmizlcqpxncqc6nrvp3pgrcpfsqedqi responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.contract.checkverifystatus' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: Pass - Verified /?module=transaction&action=getstatus: get: operationId: check-contract-execution-status externalDocs: url: https://docs.etherscan.io/api-endpoints/stats#check-contract-execution-status summary: Check Contract Execution Status description: Returns the status code of a contract execution. tags: - Transactions parameters: - in: query name: txhash schema: $ref: '#/components/schemas/TxHash' required: true example: '0x15f8e5ea1079d9a0bb04a4c58ae5fe7654b5b2b4463375ff7ffb490aa0032f3a' responses: '200': description: 'Operation result. 📖 Tip: The isError field returns 0 for successful transactions and 1 for failed transactions.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.transaction.getstatus' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: isError: '1' errDescription: Bad jump destination /?module=transaction&action=gettxreceiptstatus: get: operationId: check-transaction-receipt-status externalDocs: url: https://docs.etherscan.io/api-endpoints/stats#check-transaction-receipt-status summary: Check Transaction Receipt Status description: 'Returns the status code of a transaction execution. 📝 Note: Only applicable for post Byzantium Fork transactions.' tags: - Transactions parameters: - in: query name: txhash schema: $ref: '#/components/schemas/TxHash' required: true example: '0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76' responses: '200': description: 'Operation result. 📖 Tip: The status field returns 0 for failed transactions and 1 for successful transactions.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.transaction.gettxreceiptstatus' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: status: '1' /?module=block&action=getblockreward: get: operationId: get-block-and-uncle-rewards-by-blockno externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-block-and-uncle-rewards-by-blockno summary: Get Block And Uncle Rewards by BlockNo description: Returns the block reward and 'Uncle' block rewards. tags: - Blocks parameters: - in: query name: blockno schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '2165403' responses: '200': description: 'Operation result. ​​ ⏳ Tip : The timestamp field is denoted in Unix timestamp.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.block.getblockreward' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: blockNumber: '2165403' timeStamp: '1472533979' blockMiner: '0x13a06d3dfe21e0db5c016c03ea7d2509f7f8d1e3' blockReward: '5314181600000000000' uncles: - miner: '0xbcdfc35b86bedf72f0cda046a3c16829a2ef41d1' unclePosition: '0' blockreward: '3750000000000000000' - miner: '0x0d0c9855c722ff0c78f21e43aa275a5b8ea60dce' unclePosition: '1' blockreward: '3750000000000000000' uncleInclusionReward: '312500000000000000' /?module=block&action=getblockcountdown: get: operationId: get-estimated-block-countdown-time-by-blockno externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-estimated-block-countdown-time-by-blockno summary: Get Estimated Block Countdown Time by BlockNo description: Returns the estimated time remaining, in seconds, until a certain block is mined. tags: - Blocks parameters: - in: query name: blockno schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '16701588' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.block.getblockcountdown' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: CurrentBlock: '12715477' CountdownBlock: '16701588' RemainingBlock: '3986111' EstimateTimeInSec: '52616680.2' /?module=block&action=getblocknobytime: get: operationId: get-block-number-by-timestamp externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-block-number-by-timestamp summary: Get Block Number by Timestamp description: Returns the block number that was mined at a certain timestamp. tags: - Blocks parameters: - in: query name: timestamp schema: $ref: '#/components/schemas/UnixTimestamp' required: true example: '1578638524' - in: query name: closest schema: $ref: '#/components/schemas/BlockClosest' required: true example: before responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.block.getblocknobytime' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '12712551' /?module=stats&action=dailyavgblocksize: get: operationId: get-daily-average-block-size externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-daily-average-block-size summary: Get Daily Average Block Size description: Returns the daily average block size within a date range. PRO endpoint. tags: - Blocks - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyavgblocksize' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' blockSize_bytes: 20373 - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' blockSize_bytes: 25117 /?module=stats&action=dailyblkcount: get: operationId: get-daily-block-count-and-rewards externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-daily-block-count-and-rewards summary: Get Daily Block Count and Rewards description: Returns the number of blocks mined daily and the amount of block rewards. PRO endpoint. tags: - Blocks - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyblkcount' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' blockCount: 4848 blockRewards_Eth: '14929.464690870590355682' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' blockCount: 4366 blockRewards_Eth: '12808.485512162356907132' /?module=stats&action=dailyblockrewards: get: operationId: get-daily-block-rewards externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-daily-block-rewards summary: Get Daily Block Rewards description: Returns the amount of block rewards distributed to miners daily. PRO endpoint. tags: - Blocks - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyblockrewards' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' blockRewards_Eth: '15300.65625' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' blockRewards_Eth: '12954.84375' /?module=stats&action=dailyavgblocktime: get: operationId: get-daily-average-time-for-a-block-to-be-included-in-the-ethereum-blockchain externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-daily-average-time-for-a-block-to-be-included-in-the-ethereum-blockchain summary: Get Daily Average Time for A Block to be Included in the Ethereum Blockchain description: Returns the daily average of time needed for a block to be successfully mined. PRO endpoint. tags: - Blocks - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyavgblocktime' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' blockTime_sec: '17.67' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' blockTime_sec: '19.61' /?module=stats&action=dailyuncleblkcount: get: operationId: get-daily-uncle-block-count-and-rewards externalDocs: url: https://docs.etherscan.io/api-endpoints/blocks#get-daily-uncle-block-count-and-rewards summary: Get Daily Uncle Block Count and Rewards description: Returns the number of 'Uncle' blocks mined daily and the amount of 'Uncle' block rewards. PRO endpoint. tags: - Blocks - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyuncleblkcount' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' uncleBlockCount: 287 uncleBlockRewards_Eth: '729.75' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' uncleBlockCount: 288 uncleBlockRewards_Eth: '691.5' /?module=logs&action=getLogs: get: operationId: get-event-logs-by-address externalDocs: url: https://docs.etherscan.io/api-endpoints/logs#get-event-logs-by-address summary: Get Event Logs by Address description: Returns the event logs from an address, with optional filtering by block range. tags: - Logs parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8' - in: query name: fromBlock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '12878196' - in: query name: toBlock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '12878196' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1Max1000' required: false example: '1000' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8' topics: - '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' - '0x0000000000000000000000000000000000000000000000000000000000000000' - '0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d' - '0x00000000000000000000000000000000000000000000000000000000000000b5' data: 0x blockNumber: '0xc48174' timeStamp: '0x60f9ce56' gasPrice: '0x2e90edd000' gasUsed: '0x247205' logIndex: 0x transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9' transactionIndex: 0x - address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8' topics: - '0x645f26e653c951cec836533f8fe0616d301c20a17153debc17d7c3dbe4f32b28' - '0x00000000000000000000000000000000000000000000000000000000000000b5' data: 0x blockNumber: '0xc48174' timeStamp: '0x60f9ce56' gasPrice: '0x2e90edd000' gasUsed: '0x247205' logIndex: '0x1' transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9' transactionIndex: 0x /?module=logs&action=getLogs&get-event-logs-by-topics: get: operationId: get-event-logs-by-topics externalDocs: url: https://docs.etherscan.io/api-endpoints/logs#get-event-logs-by-topics summary: Get Event Logs by Topics description: Returns the events log in a block range, filtered by topics. tags: - Logs parameters: - in: query name: fromBlock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '12878196' - in: query name: toBlock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '12879196' - in: query name: topic schema: $ref: '#/components/schemas/Topic' required: true example: '' - in: query name: topicOperator schema: $ref: '#/components/schemas/TopicOperator' required: false example: '' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1Max1000' required: false example: '1000' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8' topics: - '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' - '0x0000000000000000000000000000000000000000000000000000000000000000' - '0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d' - '0x00000000000000000000000000000000000000000000000000000000000000b5' data: 0x blockNumber: '0xc48174' timeStamp: '0x60f9ce56' gasPrice: '0x2e90edd000' gasUsed: '0x247205' logIndex: 0x transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9' transactionIndex: 0x - address: '0xbd3531da5cf5857e7cfaa92426877b022e612cf8' topics: - '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' - '0x0000000000000000000000000000000000000000000000000000000000000000' - '0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d' - '0x00000000000000000000000000000000000000000000000000000000000000b6' data: 0x blockNumber: '0xc48174' timeStamp: '0x60f9ce56' gasPrice: '0x2e90edd000' gasUsed: '0x247205' logIndex: '0x2' transactionHash: '0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9' transactionIndex: 0x /?module=logs&action=getLogs&get-event-logs-by-address-filtered-by-topics: get: operationId: get-event-logs-by-address-filtered-by-topics externalDocs: url: https://docs.etherscan.io/api-endpoints/logs#get-event-logs-by-address-filtered-by-topics summary: Get Event Logs by Address filtered by Topics description: Returns the event logs from an address, filtered by topics and block range. tags: - Logs parameters: - in: query name: fromBlock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '15073139' - in: query name: toBlock schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '15074139' - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x59728544b08ab483533076417fbbb2fd0b17ce3a' - in: query name: topic schema: $ref: '#/components/schemas/Topic' required: true example: '' - in: query name: topicOperator schema: $ref: '#/components/schemas/TopicOperator' required: false example: '' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1Max1000' required: false example: '1000' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/ResultArrayOfObjects' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - address: '0x59728544b08ab483533076417fbbb2fd0b17ce3a' topics: - '0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d' - '0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b' - '0x000000000000000000000000000000000000000000000000000000000000236d' - '0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca' data: '0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000f207539952d0000' blockNumber: '0xe60262' timeStamp: '0x62c26caf' gasPrice: '0x5e2d742c9' gasUsed: '0xfb7f8' logIndex: '0x4b' transactionHash: '0x26fe1a0a403fd44ef11ee72f3b4ceff590b6ea533684cb279cb4242be463304c' transactionIndex: '0x39' - address: '0x59728544b08ab483533076417fbbb2fd0b17ce3a' topics: - '0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d' - '0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b' - '0x0000000000000000000000000000000000000000000000000000000000002261' - '0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca' data: '0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000de0b6b3a7640000' blockNumber: '0xe6035b' timeStamp: '0x62c27ab1' gasPrice: '0x27e523173' gasUsed: '0x3b86e' logIndex: '0x1d7' transactionHash: '0x3a299413cf2c91e376e542efcf3fc308c562da79af6e992401217cc6208c7f74' transactionIndex: '0x92' /?module=proxy&action=eth_blockNumber: get: operationId: eth_blocknumber externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_blocknumber summary: eth_blockNumber description: Returns the number of most recent block tags: - Geth/Parity Proxy parameters: [] responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_blockNumber' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 83 result: '0xc36b29' /?module=proxy&action=eth_getBlockByNumber: get: operationId: eth_getblockbynumber externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_getblockbynumber summary: eth_getBlockByNumber description: Returns information about a block by block number. tags: - Geth/Parity Proxy parameters: - in: query name: tag schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x10d4f' - in: query name: boolean schema: $ref: '#/components/schemas/Boolean' required: true example: 'true' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getBlockByNumber' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: baseFeePerGas: '0x5cfe76044' difficulty: '0x1b4ac252b8a531' extraData: '0xd883010a06846765746888676f312e31362e36856c696e7578' gasLimit: '0x1caa87b' gasUsed: '0x5f036a' hash: '0x396288e0ad6690159d56b5502a172d54baea649698b4d7af2393cf5d98bf1bb3' logsBloom: '0x5020418e211832c600000411c00098852850124700800500580d406984009104010420410c00420080414b044000012202448082084560844400d00002202b1209122000812091288804302910a246e25380282000e00002c00050009038cc205a018180028225218760100040820ac12302840050180448420420b000080000410448288400e0a2c2402050004024a240200415016c105844214060005009820302001420402003200452808508401014690208808409000033264a1b0d200c1200020280000cc0220090a8000801c00b0100a1040a8110420111870000250a22dc210a1a2002409c54140800c9804304b408053112804062088bd700900120' miner: '0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c' mixHash: '0xc547c797fb85c788ecfd4f5d24651bddf15805acbaad2c74b96b0b2a2317e66c' nonce: '0x04a99df972bd8412' number: '0xc63251' parentHash: '0xbb2d43395f93dab5c424421be22d874f8c677e3f466dc993c218fa2cd90ef120' receiptsRoot: '0x3de3b59d208e0fd441b6a2b3b1c814a2929f5a2d3016716465d320b4d48cc1e5' sha3Uncles: '0xee2e81479a983dd3d583ab89ec7098f809f74485e3849afb58c2ea8e64dd0930' size: '0x6cb6' stateRoot: '0x60fdb78b92f0e621049e0aed52957971e226a11337f633856d8b953a56399510' timestamp: '0x6110bab2' totalDifficulty: '0x612789b0aba90e580f8' transactions: - '0x40330c87750aa1ba1908a787b9a42d0828e53d73100ef61ae8a4d925329587b5' - '0x6fa2208790f1154b81fc805dd7565679d8a8cc26112812ba1767e1af44c35dd4' - '0xe31d8a1f28d4ba5a794e877d65f83032e3393809686f53fa805383ab5c2d3a3c' - '0xa6a83df3ca7b01c5138ec05be48ff52c7293ba60c839daa55613f6f1c41fdace' - '0x4e46edeb68a62dde4ed081fae5efffc1fb5f84957b5b3b558cdf2aa5c2621e17' - '0x356ee444241ae2bb4ce9f77cdbf98cda9ffd6da244217f55465716300c425e82' - '0x1a4ec2019a3f8b1934069fceff431e1370dcc13f7b2561fe0550cc50ab5f4bbc' - '0xad7994bc966aed17be5d0b6252babef3f56e0b3f35833e9ac414b45ed80dac93' transactionsRoot: '0xaceb14fcf363e67d6cdcec0d7808091b764b4428f5fd7e25fb18d222898ef779' uncles: - '0x9e8622c7bf742bdeaf96c700c07151c1203edaf17a38ea8315b658c2e6d873cd' /?module=proxy&action=eth_getUncleByBlockNumberAndIndex: get: operationId: eth_getunclebyblocknumberandindex externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_getunclebyblocknumberandindex summary: eth_getUncleByBlockNumberAndIndex description: Returns information about a uncle by block number. tags: - Geth/Parity Proxy parameters: - in: query name: tag schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0xC63276' - in: query name: index schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x0' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getUncleByBlockNumberAndIndex' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: baseFeePerGas: '0x65a42b13c' difficulty: '0x1b1457a8247bbb' extraData: '0x486976656f6e2063612d68656176792059476f6e' gasLimit: '0x1ca359a' gasUsed: '0xb48fe1' hash: '0x1da88e3581315d009f1cb600bf06f509cd27a68cb3d6437bda8698d04089f14a' logsBloom: '0xf1a360ca505cdda510d810c1c81a03b51a8a508ed601811084833072945290235c8721e012182e40d57df552cf00f1f01bc498018da19e008681832b43762a30c26e11709948a9b96883a42ad02568e3fcc3000004ee12813e4296498261619992c40e22e60bd95107c5bd8462fcca570a0095d52a4c24720b00f13a2c3d62aca81e852017470c109643b15041fd69742406083d67654fc841a18b405ab380e06a8c14c0138b6602ea8f48b2cd90ac88c3478212011136802900264718a085047810221225080dfb2c214010091a6f233883bb0084fa1c197330a10bb0006686e678b80e50e4328000041c218d1458880181281765d28d51066058f3f80a7822' miner: '0x1ad91ee08f21be3de0ba2ba6918e714da6b45836' mixHash: '0xa8e1dbbf073614c7ed05f44b9e92fbdb3e1d52575ed8167fa57f934210bbb0a2' nonce: '0x28cc3e5b7bee9866' number: '0xc63274' parentHash: '0x496dae3e722efdd9ee1eb69499bdc7ed0dca54e13cd1157a42811c442f01941f' receiptsRoot: '0x9c9a7a99b4af7607691a7f2a50d474290385c0a6f39c391131ea0c67307213f4' sha3Uncles: '0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347' size: '0x224' stateRoot: '0xde9a11f0ee321390c1a7843cab7b9ffd3779d438bc8f77de4361dfe2807d7dee' timestamp: '0x6110bd1a' transactionsRoot: '0xa04a79e531db3ec373cb63e9ebfbc9c95525de6347958918a273675d4f221575' uncles: [] /?module=proxy&action=eth_getBlockTransactionCountByNumber: get: operationId: eth_getblocktransactioncountbynumber externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_getblocktransactioncountbynumber summary: eth_getBlockTransactionCountByNumber description: Returns the number of transactions in a block. tags: - Geth/Parity Proxy parameters: - in: query name: tag schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x10FB78' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getBlockTransactionCountByNumber' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: '0x3' /?module=proxy&action=eth_getTransactionByHash: get: operationId: eth_gettransactionbyhash externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_gettransactionbyhash summary: eth_getTransactionByHash description: Returns the information about a transaction requested by transaction hash. tags: - Geth/Parity Proxy parameters: - in: query name: txhash schema: $ref: '#/components/schemas/TxHash' required: true example: '0xbc78ab8a9e9a0bca7d0321a27b2c03addeae08ba81ea98b03cd3dd237eabed44' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getTransactionByHash' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: blockHash: '0xf850331061196b8f2b67e1f43aaa9e69504c059d3d3fb9547b04f9ed4d141ab7' blockNumber: '0xcf2420' from: '0x00192fb10df37c9fb26829eb2cc623cd1bf599e8' gas: '0x5208' gasPrice: '0x19f017ef49' maxFeePerGas: '0x1f6ea08600' maxPriorityFeePerGas: '0x3b9aca00' hash: '0xbc78ab8a9e9a0bca7d0321a27b2c03addeae08ba81ea98b03cd3dd237eabed44' input: 0x nonce: '0x33b79d' to: '0xc67f4e626ee4d3f272c2fb31bad60761ab55ed9f' transactionIndex: '0x5b' value: '0x19755d4ce12c00' type: '0x2' accessList: [] chainId: '0x1' v: '0x0' r: '0xa681faea68ff81d191169010888bbbe90ec3eb903e31b0572cd34f13dae281b9' s: '0x3f59b0fa5ce6cf38aff2cfeb68e7a503ceda2a72b4442c7e2844d63544383e3' /?module=proxy&action=eth_getTransactionByBlockNumberAndIndex: get: operationId: eth_gettransactionbyblocknumberandindex externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_gettransactionbyblocknumberandindex summary: eth_getTransactionByBlockNumberAndIndex description: Returns information about a transaction by block number and transaction index position. tags: - Geth/Parity Proxy parameters: - in: query name: tag schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0xC6331D' - in: query name: index schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x11A' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getTransactionByBlockNumberAndIndex' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' result: accessList: [] blockHash: '0xdce94191f861842c2786e3594da0c0109707fd78409cab5f38e10eb87d0f301c' blockNumber: '0xa36e44' chainId: '0x3' condition: null creates: null from: '0xb910ae1db14a9fbc64ce175bdca6d3a743f690ab' gas: '0x186a0' gasPrice: '0x3b9aca09' hash: '0xf96ff62ba5aaf46cd824b6766f7fa6f6b9595b1dd4ef1d31bcf1f765047c2835' input: '0xd0e30db0' maxFeePerGas: '0x3b9aca12' maxPriorityFeePerGas: '0x3b9aca00' nonce: '0xc6' publicKey: '0x6dbf7068e19de8457c426a758a92ea54827ebd5b8467c3a1a5c4ac19bc7570457738fe496a40ea4e1f59d39d89636a430afdec0bf2a8060c6bf7d612bfe90ad3' r: '0xdecdc48821a06bf116e82b355d520dc5a44d6df98234e5344c16565b0b3dfdba' raw: '0x02f8750381c6843b9aca00843b9aca12830186a094c778417e063141139fce010982780140aa0cd5ab8502540be40084d0e30db0c001a0decdc48821a06bf116e82b355d520dc5a44d6df98234e5344c16565b0b3dfdbaa06b85bb6fd8153e86b50f0011787585e8c709a2a25e7ee3c2579572f07acfd42e' s: '0x6b85bb6fd8153e86b50f0011787585e8c709a2a25e7ee3c2579572f07acfd42e' to: '0xc778417e063141139fce010982780140aa0cd5ab' transactionIndex: '0xd' type: '0x2' v: '0x1' value: '0x2540be400' id: 1 /?module=proxy&action=eth_getTransactionCount: get: operationId: eth_gettransactioncount externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_gettransactioncount summary: eth_getTransactionCount description: Returns the number of transactions performed by an address. tags: - Geth/Parity Proxy parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x4bd5900Cb274ef15b153066D736bf3e83A9ba44e' - in: query name: tag schema: $ref: '#/components/schemas/BlockTag' required: true example: latest responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getTransactionCount' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: '0x44' /?module=proxy&action=eth_sendRawTransaction: get: operationId: eth_sendrawtransaction externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_sendrawtransaction summary: eth_sendRawTransaction description: Submits a pre-signed transaction for broadcast to the Ethereum network. tags: - Geth/Parity Proxy parameters: - in: query name: hex schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0xf904808000831cfde080' responses: '200': description: 'Operation result. ⛏️ Note: The result represents the transaction hash of the submitted raw transaction.Use eth_getTransactionReceipt to retrieve full details.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_sendRawTransaction' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: id: 1 jsonrpc: '2.0' result: '0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331a' /?module=proxy&action=eth_getTransactionReceipt: get: operationId: eth_gettransactionreceipt externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_gettransactionreceipt summary: eth_getTransactionReceipt description: Returns the receipt of a transaction by transaction hash. tags: - Geth/Parity Proxy parameters: - in: query name: txhash schema: $ref: '#/components/schemas/TxHash' required: true example: '0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getTransactionReceipt' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: blockHash: '0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799' blockNumber: '0xcf2427' contractAddress: null cumulativeGasUsed: '0xeb67d5' effectiveGasPrice: '0x1a96b24c26' from: '0x292f04a44506c2fd49bac032e1ca148c35a478c8' gasUsed: '0xb41d' logs: - address: '0xdac17f958d2ee523a2206206994597c13d831ec7' topics: - '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef' - '0x000000000000000000000000292f04a44506c2fd49bac032e1ca148c35a478c8' - '0x000000000000000000000000ab6960a6511ff18ed8b8c012cb91c7f637947fc0' data: '0x00000000000000000000000000000000000000000000000000000000013f81a6' blockNumber: '0xcf2427' transactionHash: '0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb' transactionIndex: '0x122' blockHash: '0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799' logIndex: '0xdb' removed: false logsBloom: '0x00000000000000000000000000000000000000000000000000000000000004000000000004000000000000000000010000000000000000000000000000000000000000000000000000000008000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000010000000001100000000000000000000000000000000000000000000000000000200100000000000000000000000000080000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000' status: '0x1' to: '0xdac17f958d2ee523a2206206994597c13d831ec7' transactionHash: '0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb' transactionIndex: '0x122' type: '0x2' /?module=proxy&action=eth_call: get: operationId: eth_call externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_call summary: eth_call description: Executes a new message call immediately without creating a transaction on the block chain. tags: - Geth/Parity Proxy parameters: - in: query name: to schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xAEEF46DB4855E25702F8237E8f403FddcaF931C0' - in: query name: data schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x70a08231000000000000000000000000e16359506c028e51f16be38986ec5746251e9724' - in: query name: tag schema: $ref: '#/components/schemas/BlockTag' required: true example: latest responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_call' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: '0x00000000000000000000000000000000000000000000000000601d8888141c00' /?module=proxy&action=eth_getCode: get: operationId: eth_getcode externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_getcode summary: eth_getCode description: Returns code at a given address. tags: - Geth/Parity Proxy parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xf75e354c5edc8efed9b59ee9f67a80845ade7d0c' - in: query name: tag schema: $ref: '#/components/schemas/BlockTag' required: true example: latest responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getCode' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: '0x3660008037602060003660003473273930d21e01ee25e4c219b63259d214872220a261235a5a03f21560015760206000f3' /?module=proxy&action=eth_getStorageAt: get: operationId: eth_getstorageat externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_getstorageat summary: eth_getStorageAt description: Returns the value from a storage position at a given address. This endpoint is still experimental and may have potential issues tags: - Geth/Parity Proxy parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x6e03d9cce9d60f3e9f2597e13cd4c54c55330cfd' - in: query name: position schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x0' - in: query name: tag schema: $ref: '#/components/schemas/BlockTag' required: true example: latest responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_getStorageAt' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: '0x0000000000000000000000003d0768da09ce77d25e2d998e6a7b6ed4b9116c2d' /?module=proxy&action=eth_gasPrice: get: operationId: eth_gasprice externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_gasprice summary: eth_gasPrice description: Returns the current price per gas in wei. tags: - Geth/Parity Proxy parameters: [] responses: '200': description: 'Operation result. 📖 Tip: The result is returned in wei.Easily convert Ethereum units using our unit converter.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_gasPrice' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 73 result: '0x430e23400' /?module=proxy&action=eth_estimateGas: get: operationId: eth_estimategas externalDocs: url: https://docs.etherscan.io/api-endpoints/geth-parity-proxy#eth_estimategas summary: eth_estimateGas description: Makes a call or transaction, which won't be added to the blockchain and returns the used gas. tags: - Geth/Parity Proxy parameters: - in: query name: data schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x4e71d92d' - in: query name: to schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xf0160428a8552ac9bb7e050d90eeade4ddd52843' - in: query name: value schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0xff22' - in: query name: gas schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x5f5e0ff' - in: query name: gasPrice schema: $ref: '#/components/schemas/Hex0xPrefixed' required: true example: '0x51da038cc' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ProxyResponseOK' - $ref: '#/components/schemas/Result.proxy.eth_estimateGas' - $ref: '#/components/schemas/ProxyResponseNOTOK' example: jsonrpc: '2.0' id: 1 result: '0x6556' /?module=stats&action=tokensupply: get: operationId: get-erc20-token-totalsupply-by-contractaddress externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-erc20-token-totalsupply-by-contractaddress summary: Get ERC20-Token TotalSupply by ContractAddress description: Returns the current amount of an ERC-20 token in circulation. tags: - Tokens parameters: - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x57d90b64a1a57749b0f932f1a3395792e12e7055' responses: '200': description: 'Operation result. 📈 Tip : The result is returned in the token''s smallest decimal representation.Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.tokensupply' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '21265524714464' /?module=account&action=tokenbalance: get: operationId: get-erc20-token-account-balance-for-tokencontractaddress externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-erc20-token-account-balance-for-tokencontractaddress summary: Get ERC20-Token Account Balance for TokenContractAddress description: Returns the current balance of an ERC-20 token of an address. tags: - Tokens parameters: - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x57d90b64a1a57749b0f932f1a3395792e12e7055' - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xe04f27eb70e025b78871a2ad7eabe85e61212761' responses: '200': description: 'Operation result. 📈 Tip : The result is returned in the token''s smallest decimal representation.Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.tokenbalance' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '135499' /?module=stats&action=tokensupplyhistory: get: operationId: get-historical-erc20-token-totalsupply-by-contractaddress-and-blockno externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-historical-erc20-token-totalsupply-by-contractaddress-and-blockno summary: Get Historical ERC20-Token TotalSupply by ContractAddress & BlockNo description: 'Returns the amount of an ERC-20 token in circulation at a certain block height. 📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier. PRO endpoint.' tags: - Tokens - API PRO Endpoints parameters: - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x57d90b64a1a57749b0f932f1a3395792e12e7055' - in: query name: blockno schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '8000000' responses: '200': description: 'Operation result. 📈 Tip : The result is returned in the token''s smallest decimal representation.Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.tokensupplyhistory' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '21265524714464' /?module=account&action=tokenbalancehistory: get: operationId: get-historical-erc20-token-account-balance-for-tokencontractaddress-by-blockno externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-historical-erc20-token-account-balance-for-tokencontractaddress-by-blockno summary: Get Historical ERC20-Token Account Balance for TokenContractAddress by BlockNo description: 'Returns the balance of an ERC-20 token of an address at a certain block height. 📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier. PRO endpoint.' tags: - Tokens - API PRO Endpoints parameters: - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x57d90b64a1a57749b0f932f1a3395792e12e7055' - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xe04f27eb70e025b78871a2ad7eabe85e61212761' - in: query name: blockno schema: $ref: '#/components/schemas/IntegerMin0' required: true example: '8000000' responses: '200': description: 'Operation result. 📈 Tip : The result is returned in the token''s smallest decimal representation.Eg. a token with a balance of 215.241526476136819398 and 18 decimal places will be returned as 215241526476136819398' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.tokenbalancehistory' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '135499' /?module=token&action=tokenholderlist: get: operationId: get-token-holder-list-by-contract-address externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-token-holder-list-by-contract-address summary: Get Token Holder List by Contract Address description: Return the current ERC20 token holders and number of tokens held. tags: - Tokens parameters: - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '10' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.token.tokenholderlist' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - TokenHolderAddress: '0x0000000000000000000000000000000000000000' TokenHolderQuantity: '34956' - TokenHolderAddress: '0x000000000000084e91743124a982076c59f10084' TokenHolderQuantity: '1' - TokenHolderAddress: '0x0000000000000d9054f605ca65a2647c2b521422' TokenHolderQuantity: '10000000' - TokenHolderAddress: '0x0000000000002d534ff79e9c69e7fcc742f0be83' TokenHolderQuantity: '5' - TokenHolderAddress: '0x0000000000003f5e74c1ba8a66b48e6f3d71ae82' TokenHolderQuantity: '1' /?module=token&action=tokeninfo: get: operationId: get-token-info-by-contractaddress externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-token-info-by-contractaddress summary: Get Token Info by ContractAddress description: 'Returns project information and social media links of an ERC20/ERC721/ERC1155 token. 📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier. PRO endpoint.' tags: - Tokens - API PRO Endpoints parameters: - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x0e3a2a1f2146d86a604adc220b4967a898d7fe07' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.token.tokeninfo' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - contractAddress: '0x0e3a2a1f2146d86a604adc220b4967a898d7fe07' tokenName: Gods Unchained Cards symbol: CARD divisor: '0' tokenType: ERC721 totalSupply: '6962498' blueCheckmark: 'true' description: A TCG on the Ethereum blockchain that uses NFT's to bring real ownership to in-game assets. website: https://godsunchained.com/ email: '' blog: https://medium.com/@fuelgames reddit: https://www.reddit.com/r/GodsUnchained/ slack: '' facebook: https://www.facebook.com/godsunchained/ twitter: https://twitter.com/godsunchained bitcointalk: '' github: '' telegram: '' wechat: '' linkedin: '' discord: https://discordapp.com/invite/DKGr2pW whitepaper: '' tokenPriceUSD: '0.000000000000000000' /?module=account&action=addresstokenbalance: get: operationId: get-address-erc20-token-holding externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-address-erc20-token-holding summary: Get Address ERC20 Token Holding description: 'Returns the ERC-20 tokens and amount held by an address. Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.' tags: - Tokens parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x983e3660c0bE01991785F80f266A84B911ab59b0' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '100' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.addresstokenbalance' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - TokenAddress: '0xffffffff2ba8f66d4e51811c5190992176930278' TokenName: Furucombo TokenSymbol: COMBO TokenQuantity: '1861606940000000000' TokenDivisor: '18' - TokenAddress: '0x53a1e9912323b8016424d6287286e3b6de263f76' TokenName: PUTIN Token TokenSymbol: PTT TokenQuantity: '3500000000000000000000' TokenDivisor: '18' - TokenAddress: '0xb753428af26e81097e7fd17f40c88aaa3e04902c' TokenName: Spice TokenSymbol: SFI TokenQuantity: '7' TokenDivisor: '18' - TokenAddress: '0x1b40183efb4dd766f11bda7a7c3ad8982e998421' TokenName: VesperToken TokenSymbol: VSP TokenQuantity: '962' TokenDivisor: '18' - TokenAddress: '0x37e83a94c6b1bdb816b59ac71dd02cf154d8111f' TokenName: PhotoChromic TokenSymbol: PHCR TokenQuantity: '4608452961264910063288' TokenDivisor: '18' /?module=account&action=addresstokennftbalance: get: operationId: get-address-erc721-token-holding externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-address-erc721-token-holding summary: Get Address ERC721 Token Holding description: 'Returns the ERC-721 tokens and amount held by an address. Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.' tags: - Tokens parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x6b52e83941eb10f9c613c395a834457559a80114' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '100' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.addresstokennftbalance' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - TokenAddress: '0x49cf6f5d44e70224e2e23fdcdd2c053f30ada28b' TokenName: CloneX TokenSymbol: CloneX TokenQuantity: '52' - TokenAddress: '0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d' TokenName: BoredApeYachtClub TokenSymbol: BAYC TokenQuantity: '1' - TokenAddress: '0x60e4d786628fea6478f785a6d7e704777c86a7c6' TokenName: MutantApeYachtClub TokenSymbol: MAYC TokenQuantity: '1' - TokenAddress: '0xed5af388653567af2f388e6224dc7c4b3241c544' TokenName: Azuki TokenSymbol: AZUKI TokenQuantity: '1' - TokenAddress: '0x7bd29408f11d2bfc23c34f18275bbf23bb716bc7' TokenName: Meebits TokenSymbol: ⚇ TokenQuantity: '1' /?module=account&action=addresstokennftinventory: get: operationId: get-address-erc721-token-inventory-by-contract-address externalDocs: url: https://docs.etherscan.io/api-endpoints/tokens#get-address-erc721-token-inventory-by-contract-address summary: Get Address ERC721 Token Inventory By Contract Address description: 'Returns the ERC-721 token inventory of an address, filtered by contract address. 📝 Note : This endpoint is throttled to 2 calls/second regardless of API Pro tier.' tags: - Tokens parameters: - in: query name: address schema: $ref: '#/components/schemas/AddressHash' required: true example: '0x123432244443b54409430979df8333f9308a6040' - in: query name: contractaddress schema: $ref: '#/components/schemas/AddressHash' required: true example: '0xed5af388653567af2f388e6224dc7c4b3241c544' - in: query name: page schema: $ref: '#/components/schemas/IntegerMin1' required: false example: '1' - in: query name: offset schema: $ref: '#/components/schemas/IntegerMin1Max1000' required: false example: '100' responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.account.addresstokennftinventory' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - TokenAddress: '0xed5af388653567af2f388e6224dc7c4b3241c544' TokenId: '5401' - TokenAddress: '0xed5af388653567af2f388e6224dc7c4b3241c544' TokenId: '7411' - TokenAddress: '0xed5af388653567af2f388e6224dc7c4b3241c544' TokenId: '453' - TokenAddress: '0xed5af388653567af2f388e6224dc7c4b3241c544' TokenId: '8080' - TokenAddress: '0xed5af388653567af2f388e6224dc7c4b3241c544' TokenId: '4255' /?module=gastracker&action=gasestimate: get: operationId: get-estimation-of-confirmation-time externalDocs: url: https://docs.etherscan.io/api-endpoints/gas-tracker#get-estimation-of-confirmation-time summary: Get Estimation of Confirmation Time description: Returns the estimated time, in seconds, for a transaction to be confirmed on the blockchain. tags: - Gas Tracker parameters: - in: query name: gasprice schema: $ref: '#/components/schemas/IntegerMin1' required: true example: '2000000000' responses: '200': description: 'Operation result. 📝 Note: The result is returned in seconds.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.gastracker.gasestimate' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '9227' /?module=gastracker&action=gasoracle: get: operationId: get-gas-oracle externalDocs: url: https://docs.etherscan.io/api-endpoints/gas-tracker#get-gas-oracle summary: Get Gas Oracle description: Returns the current Safe, Proposed and Fast gas prices. Post EIP-1559 🔥 changes :Safe/Proposed/Fast gas price recommendations are now modeled as Priority Fees.New field suggestBaseFee , the baseFee of the next pending blockNew field gasUsedRatio, to estimate how busy the network isLearn more about the gas changes in EIP-1559. tags: - Gas Tracker parameters: [] responses: '200': description: 'Operation result. ⛽ Note: The gas prices are returned in Gwei.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.gastracker.gasoracle' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: LastBlock: '13053741' SafeGasPrice: '20' ProposeGasPrice: '22' FastGasPrice: '24' suggestBaseFee: '19.230609716' gasUsedRatio: 0.370119078777807,0.8954731,0.550911766666667,0.212457033333333,0.552463633333333 /?module=stats&action=dailyavggaslimit: get: operationId: get-daily-average-gas-limit externalDocs: url: https://docs.etherscan.io/api-endpoints/gas-tracker#get-daily-average-gas-limit summary: Get Daily Average Gas Limit description: Returns the historical daily average gas limit of the Ethereum network. PRO endpoint. tags: - Gas Tracker - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyavggaslimit' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' gasLimit: '8001360' - UTCDate: '2019-02-27' unixTimeStamp: '1551225600' gasLimit: '8001071' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' gasLimit: '8001137' /?module=stats&action=dailygasused: get: operationId: get-ethereum-daily-total-gas-used externalDocs: url: https://docs.etherscan.io/api-endpoints/gas-tracker#get-ethereum-daily-total-gas-used summary: Get Ethereum Daily Total Gas Used description: Returns the total amount of gas used daily for transctions on the Ethereum network. PRO endpoint. tags: - Gas Tracker - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailygasused' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' gasUsed: '32761450415' - UTCDate: '2019-02-27' unixTimeStamp: '1551225600' gasUsed: '32657440136' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' gasUsed: '33081119561' /?module=stats&action=dailyavggasprice: get: operationId: get-daily-average-gas-price externalDocs: url: https://docs.etherscan.io/api-endpoints/gas-tracker#get-daily-average-gas-price summary: Get Daily Average Gas Price description: Returns the daily average gas price used on the Ethereum network. PRO endpoint. tags: - Gas Tracker - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyavggasprice' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' maxGasPrice_Wei: '60814303896257' minGasPrice_Wei: '432495' avgGasPrice_Wei: '13234562600' - UTCDate: '2019-02-27' unixTimeStamp: '1551225600' maxGasPrice_Wei: '42000000000000' minGasPrice_Wei: '1000000' avgGasPrice_Wei: '16334617513' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' maxGasPrice_Wei: '237222222222257' minGasPrice_Wei: '100000000' avgGasPrice_Wei: '18834674068' /?module=stats&action=ethsupply: get: operationId: get-total-supply-of-ether externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-total-supply-of-ether summary: Get Total Supply of Ether description: Returns the current amount of Ether in circulation excluding ETH2 Staking rewards and EIP1559 burnt fees. tags: - Stats parameters: [] responses: '200': description: 'Operation result. 📖 Tip : Easily convert Ethereum units using our unit converter.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.ethsupply' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: '116487067186500000000000000' /?module=stats&action=ethsupply2: get: operationId: get-total-supply-of-ether-2 externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-total-supply-of-ether-2 summary: Get Total Supply of Ether 2 description: Returns the current amount of Ether in circulation, ETH2 Staking rewards, EIP1559 burnt fees, and total withdrawn ETH from the beacon chain. tags: - Stats parameters: [] responses: '200': description: 'Operation result. 📝 Note: The EthSupply is calculated before adding ETH minted as Eth2Staking rewards and subtracting BurntFees from EIP-1559. For more information, check out our Ether Total Supply Dashboard.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.ethsupply2' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: EthSupply: '122373866217800000000000000' Eth2Staking: '1157529105115885000000000' BurntFees: '3102505506455601519229842' WithdrawnTotal: '1170200333006131000000000' /?module=stats&action=ethprice: get: operationId: get-ether-last-price externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-ether-last-price summary: Get Ether Last Price description: Returns the latest price of 1 ETH. tags: - Stats parameters: [] responses: '200': description: 'Operation result. ⏳ Tip : The timestamps are represented in Unix timestamp.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.ethprice' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: ethbtc: '0.06116' ethbtc_timestamp: '1624961308' ethusd: '2149.18' ethusd_timestamp: '1624961308' /?module=stats&action=chainsize: get: operationId: get-ethereum-nodes-size externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-ethereum-nodes-size summary: Get Ethereum Nodes Size description: Returns the size of the Ethereum blockchain, in bytes, over a date range. tags: - Stats parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: clienttype schema: $ref: '#/components/schemas/ClientType' required: true example: geth - in: query name: syncmode schema: $ref: '#/components/schemas/SyncMode' required: true example: default - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: 'Operation result. ⛓️ Tip : The chainSize is represented in bytes.' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.chainsize' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - blockNumber: '7156164' chainTimeStamp: '2019-02-01' chainSize: '184726421279' clientType: Geth syncMode: Default - blockNumber: '7276521' chainTimeStamp: '2019-02-28' chainSize: '197073145113' clientType: Geth syncMode: Default /?module=stats&action=nodecount: get: operationId: get-total-nodes-count externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-total-nodes-count summary: Get Total Nodes Count description: Returns the total number of discoverable Ethereum nodes. tags: - Stats parameters: [] responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.nodecount' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: UTCDate: '2021-06-29' TotalNodeCount: '6413' /?module=stats&action=dailytxnfee: get: operationId: get-daily-network-transaction-fee externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-daily-network-transaction-fee summary: Get Daily Network Transaction Fee description: Returns the amount of transaction fees paid to miners per day. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: [] responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailytxnfee' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' transactionFee_Eth: '358.558440870590355682' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' transactionFee_Eth: '545.141762162356907132' /?module=stats&action=dailynewaddress: get: operationId: get-daily-new-address-count externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-daily-new-address-count summary: Get Daily New Address Count description: Returns the number of new Ethereum addresses created per day. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailynewaddress' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' newAddressCount: 54081 - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' newAddressCount: 53117 /?module=stats&action=dailynetutilization: get: operationId: get-daily-network-utilization externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-daily-network-utilization summary: Get Daily Network Utilization description: Returns the daily average gas used over gas limit, in percentage. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailynetutilization' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' networkUtilization: '0.8464' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' networkUtilization: '0.9472' /?module=stats&action=dailyavghashrate: get: operationId: get-daily-average-network-hash-rate externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-daily-average-network-hash-rate summary: Get Daily Average Network Hash Rate description: Returns the historical measure of processing power of the Ethereum network. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: 'Operation result. 🔥 Tip : The networkHashRate is represented in GigaHashes ( GH/s ).' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyavghashrate' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' networkHashRate: '143116.0140' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' networkHashRate: '157689.3983' /?module=stats&action=dailytx: get: operationId: get-daily-transaction-count externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-daily-transaction-count summary: Get Daily Transaction Count description: Returns the number of transactions performed on the Ethereum blockchain per day. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: Operation result. content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailytx' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' transactionCount: 498856 - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' transactionCount: 541458 /?module=stats&action=dailyavgnetdifficulty: get: operationId: get-daily-average-network-difficulty externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-daily-average-network-difficulty summary: Get Daily Average Network Difficulty description: Returns the historical mining difficulty of the Ethereum network. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: 'Operation result. ​​ 🔥 Tip : The networkDifficulty is represented in TeraHashes ( TH/s ).' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.dailyavgnetdifficulty' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' networkDifficulty: 2,408.028 - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' networkDifficulty: 2,927.453 /?module=stats&action=ethdailymarketcap: get: operationId: get-ether-historical-daily-market-cap externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-ether-historical-daily-market-cap summary: Get Ether Historical Daily Market Cap description: Returns the historical Ether daily market capitalization. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: 'Operation result. ​​ 💰 Tip : The marketCap is represented in million US Dollars ( USD ).' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.ethdailymarketcap' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' supply: '104672819.281250' marketCap: '11203.1318476721875' price: '107.03' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' supply: '105048576.406250' marketCap: '14317.0704784078125' price: '136.29' /?module=stats&action=ethdailyprice: get: operationId: get-ether-historical-price externalDocs: url: https://docs.etherscan.io/api-endpoints/stats-1#get-ether-historical-price summary: Get Ether Historical Price description: Returns the historical price of 1 ETH. PRO endpoint. tags: - Stats - API PRO Endpoints parameters: - in: query name: startdate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-01' - in: query name: enddate schema: $ref: '#/components/schemas/DateYYYYMMDD' required: true example: '2019-02-28' - in: query name: sort schema: $ref: '#/components/schemas/PageSort' required: false example: asc responses: '200': description: 'Operation result. ​​ 💰 Tip : The value is represented in US Dollars ( USD ).' content: application/json: schema: oneOf: - allOf: - $ref: '#/components/schemas/ResponseOK' - $ref: '#/components/schemas/Result.stats.ethdailyprice' - $ref: '#/components/schemas/ResponseNOTOK' example: status: '1' message: OK result: - UTCDate: '2019-02-01' unixTimeStamp: '1548979200' value: '107.03' - UTCDate: '2019-02-28' unixTimeStamp: '1551312000' value: '136.29' components: schemas: ArrayOfObjects: type: array items: type: object additionalProperties: true ResultArrayOfObjects: type: object properties: result: $ref: '#/components/schemas/ArrayOfObjects' AddressHash: type: string pattern: 0x[A-Fa-f0-9]{40} example: '0x01234567890abcdef01234567890abcdef012345' Boolean: type: boolean BlockTag: type: string enum: - earliest - latest - pending BlockType: type: string enum: - blocks - uncles BlockClosest: type: string enum: - before - after Hex0xPrefixed: type: string pattern: ^0x[0-9a-fA-F]+$ description: A hexadecimal number starting with '0x'. IntegerMin0: type: integer minimum: 0 IntegerMin0String: type: string pattern: '[0-9]+' description: An integer greater than 0 represented as a string. FloatString: type: string pattern: ^\d+(\.\d+)?$ description: A float represented as a string. FloatWithCommasString: type: string pattern: ^\d{1,3}(,?\d{3})*(\.\d+)?$ description: A float represented as a string, with optional comma delimiters FloatCsvString: type: string description: A comma-separated list of float values, represented as a string. pattern: ^(\d+(\.\d+)?)(,\d+(\.\d+)?)*$ IntegerMin1: type: integer minimum: 1 IntegerMin1Max1000: type: integer format: int32 minimum: 1 maximum: 1000 PageSort: type: string enum: - asc - desc TxHash: type: string pattern: 0x[A-Fa-f0-9]{64} example: '0x01234567890abcdef01234567890abcdef01234567890abcdef01234567890ab' CodeFormat: type: string description: single file -- use `solidity-single-file`; JSON file ( recommended ) -- use `solidity-standard-json-input` enum: - solidity-single-file - solidity-standard-json-input GUID: type: string pattern: '[a-z0-9]{50}' example: x3ryqcqr1zdknhfhkimqmiabcdfxncqc6nrvp3pgrcpfsqedqi UnixTimestamp: type: integer format: int64 description: A Unix timestamp representing the number of seconds since January 1, 1970 example: 1623338323 minimum: 0 UnixTimestampString: type: string description: A Unix timestamp representing the number of seconds since January 1, 1970, expressed as a string. pattern: ^[0-9]+$ example: '1623338323' DateYYYYMMDD: type: string format: date description: A date in the YYYY-MM-DD format example: '2019-02-01' Topic: type: string enum: - topic0 - topic1 - topic2 - topic3 TopicOperator: type: string enum: - and - or ClientType: type: string enum: - geth - Geth - parity - Parity SyncMode: type: string enum: - default - Default - archive - Archive ChainId: type: integer summary: the chain to submit verification, such as 1 for mainnet enum: - 1 - 5 - 11155111 - 17000 - 56 - 97 - 204 - 5611 - 250 - 4002 - 10 - 420 - 11155420 - 137 - 42161 - 421614 - 1284 - 1287 - 1285 - 199 - 1028 - 42220 - 44787 - 100 - 42170 - 8453 - 84532 - 1101 - 59144 - 59140 - 534352 - 534351 - 1111 - 1112 - 255 - 2358 - 252 - 2522 - 43114 - 43113 - 81457 - 23888 description: | | Explorer | Chain ID | |-----------------------------|----------| | Etherscan | 1 | | Goerli Etherscan | 5 | | Sepolia Etherscan | 11155111 | | Holesky Etherscan | 17000 | | BscScan | 56 | | Testnet BscScan | 97 | | opBNB BscScan | 204 | | Testnet opBNB BscScan | 5611 | | FTMScan | 250 | | Testnet FTMScan | 4002 | | Optimistic Etherscan | 10 | | Goerli Optimistic Etherscan | 420 | | Sepolia Optimistic Etherscan| 11155420 | | PolygonScan | 137 | | Arbiscan | 42161 | | Sepolia Arbiscan | 421614 | | Moonbeam Moonscan | 1284 | | Moonbase Moonscan | 1287 | | Moonriver Moonscan | 1285 | | BTTCScan | 199 | | Donau BTTCScan | 1028 | | CeloScan | 42220 | | Alfajores CeloScan | 44787 | | GnosisScan | 100 | | Nova Arbiscan | 42170 | | BaseScan | 8453 | | Sepolia BaseScan | 84532 | | zkEVM PolygonScan | 1101 | | LineaScan | 59144 | | Testnet LineaScan | 59140 | | ScrollScan | 534352 | | Testnet ScrollScan | 534351 | | WemixScan | 1111 | | Testnet WemixScan | 1112 | | KromaScan | 255 | | Testnet KromaScan | 2358 | | Fraxscan | 252 | | Testnet Fraxscan | 2522 | | SnowScan | 43114 | | Fuji SnowScan | 43113 | | BlastScan | 81457 | | Testnet BlastScan | 23888 | ProxyResponseErrorCode: type: integer description: | | Code | Message | Description | |---------|------------------------------------|-------------------------------------------------------------------------------------------------------| | -32700 | Parse error | Invalid JSON | | -32600 | Invalid request | This can happen when your request is malformed. Additionally, some of the providers use this code to signal that a particular method is not available or requires switching to a paid tier. | | -32601 | Method not found | This usually happens when the method is not available with a given provider. If you need to use a specific method that's not supported by the provider, try changing the provider or consider switching to a more expensive tier. | | -32602 | Invalid params | This happens when the request parameters are invalid. To fix, double check the parameters that you pass with the request and make sure they comply with the spec. | | -32603 | Internal error | This might happen when the node reverts during the request execution. This can also happen if the request is malformed or invalid. | | -32000 | Invalid input | Missing or invalid parameters | | -32001 | Resource not found | This usually happens when calling a method that's not supported. Try using a different method or switch providers. | | -32002 | Resource unavailable | Requested resource not available | | -32003 | Transaction rejected | Transaction creation failed | | -32004 | Method not supported | Method is not implemented | | -32005 | Limit exceeded | Request exceeds defined limit | | -32006 | JSON-RPC version not supported | Version of JSON-RPC protocol is not supported | enum: - -32700 - -32600 - -32601 - -32602 - -32603 - -32000 - -32001 - -32002 - -32003 - -32004 - -32005 - -32006 ProxyResponseOK: type: object properties: jsonrpc: type: string const: '2.0' id: $ref: '#/components/schemas/IntegerMin1' result: description: call result required: - jsonrpc - id - result ProxyResponseNOTOK: type: object properties: jsonrpc: type: string const: '2.0' id: $ref: '#/components/schemas/IntegerMin1' error: type: object properties: code: $ref: '#/components/schemas/ProxyResponseErrorCode' message: type: string required: - code - message required: - jsonrpc - id - error ResponseOK: type: object properties: status: type: string enum: - '1' message: type: string enum: - OK result: description: call result required: - status - message - result ResponseNOTOK: type: object properties: status: type: string enum: - '0' message: type: string pattern: ^NOTOK(-.*)?$ examples: - NOTOK - NOTOK-Missing/Invalid API Key, rate limit of 1/5sec applied result: type: string required: - status - message - result Post.contract.verifysourcecode: type: object properties: chainId: $ref: '#/components/schemas/ChainId' codeformat: $ref: '#/components/schemas/CodeFormat' sourceCode: type: string description: the Solidity source code constructorArguements: type: string description: optional, include if your contract uses constructor arguments contractaddress: $ref: '#/components/schemas/AddressHash' contractname: type: string description: the name of your contract, such as contracts/Verified.sol:Verified compilerversion: type: string description: compiler version used, such as v0.8.24+commit.e11b9ed9 required: - chainId - codeformat - sourceCode - contractaddress - contractname - compilerversion Result.account.balance: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.account.balancemulti: type: object properties: result: type: array items: type: object properties: account: $ref: '#/components/schemas/AddressHash' balance: $ref: '#/components/schemas/IntegerMin0String' Result.account.txlist: $ref: '#/components/schemas/ResultArrayOfObjects' Result.account.txlistinternal: $ref: '#/components/schemas/ResultArrayOfObjects' Result.account.tokentx: $ref: '#/components/schemas/ResultArrayOfObjects' Result.account.tokennfttx: $ref: '#/components/schemas/ResultArrayOfObjects' Result.account.token1155tx: $ref: '#/components/schemas/ResultArrayOfObjects' Result.account.getminedblocks: $ref: '#/components/schemas/ResultArrayOfObjects' Result.account.txsBeaconWithdrawal: $ref: '#/components/schemas/ResultArrayOfObjects' Result.account.balancehistory: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.contract.getabi: type: object properties: result: type: string Result.contract.getsourcecode: $ref: '#/components/schemas/ResultArrayOfObjects' Result.contract.getcontractcreation: type: object properties: result: type: array items: type: object properties: contractAddress: $ref: '#/components/schemas/AddressHash' contractCreator: $ref: '#/components/schemas/AddressHash' txHash: $ref: '#/components/schemas/TxHash' Result.contract.verifysourcecode: type: object properties: result: $ref: '#/components/schemas/GUID' Result.contract.checkverifystatus: type: object properties: result: type: string const: Pass - Verified Result.transaction.getstatus: type: object additionalProperties: true Result.transaction.gettxreceiptstatus: type: object additionalProperties: true Result.block.getblockreward: type: object additionalProperties: true Result.block.getblockcountdown: type: object properties: result: type: object properties: CurrentBlock: $ref: '#/components/schemas/IntegerMin0String' CountdownBlock: $ref: '#/components/schemas/IntegerMin0String' RemainingBlock: $ref: '#/components/schemas/IntegerMin0String' EstimateTimeInSec: $ref: '#/components/schemas/FloatString' Result.block.getblocknobytime: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.stats.dailyavgblocksize: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' blockSize_bytes: $ref: '#/components/schemas/IntegerMin0' Result.stats.dailyblkcount: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' blockCount: $ref: '#/components/schemas/IntegerMin0' blockRewards_Eth: $ref: '#/components/schemas/FloatString' Result.stats.dailyblockrewards: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' blockRewards_Eth: $ref: '#/components/schemas/FloatString' Result.stats.dailyavgblocktime: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' blockTime_sec: $ref: '#/components/schemas/FloatString' Result.stats.dailyuncleblkcount: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' uncleBlockCount: $ref: '#/components/schemas/IntegerMin0' uncleBlockRewards_Eth: $ref: '#/components/schemas/FloatString' Result.logs.getLogs: $ref: '#/components/schemas/ResultArrayOfObjects' Result.stats.tokensupply: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.account.tokenbalance: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.stats.tokensupplyhistory: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.account.tokenbalancehistory: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.token.tokenholderlist: type: object properties: result: type: array items: type: object properties: TokenHolderAddress: $ref: '#/components/schemas/AddressHash' TokenHolderQuantity: $ref: '#/components/schemas/IntegerMin0String' Result.token.tokeninfo: type: object properties: result: type: array items: type: object additionalProperties: true maxItems: 1 Result.account.addresstokenbalance: type: object properties: result: type: array items: type: object properties: TokenAddress: $ref: '#/components/schemas/AddressHash' TokenName: type: string TokenSymbol: type: string TokenQuantity: $ref: '#/components/schemas/IntegerMin0String' TokenDivisor: $ref: '#/components/schemas/IntegerMin0String' Result.account.addresstokennftbalance: type: object properties: result: type: array items: type: object properties: TokenAddress: $ref: '#/components/schemas/AddressHash' TokenName: type: string TokenSymbol: type: string TokenQuantity: $ref: '#/components/schemas/IntegerMin0String' Result.account.addresstokennftinventory: type: object properties: result: type: array items: type: object properties: TokenAddress: $ref: '#/components/schemas/AddressHash' TokenId: $ref: '#/components/schemas/IntegerMin0String' Result.gastracker.gasestimate: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.gastracker.gasoracle: type: object properties: result: type: object properties: LastBlock: $ref: '#/components/schemas/IntegerMin0String' SafeGasPrice: $ref: '#/components/schemas/IntegerMin0String' ProposeGasPrice: $ref: '#/components/schemas/IntegerMin0String' FastGasPrice: $ref: '#/components/schemas/IntegerMin0String' suggestBaseFee: $ref: '#/components/schemas/FloatString' gasUsedRatio: $ref: '#/components/schemas/FloatCsvString' Result.stats.dailyavggaslimit: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' gasLimit: $ref: '#/components/schemas/IntegerMin0String' Result.stats.dailygasused: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' gasUsed: $ref: '#/components/schemas/IntegerMin0String' Result.stats.dailyavggasprice: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' maxGasPrice_Wei: $ref: '#/components/schemas/IntegerMin0String' minGasPrice_Wei: $ref: '#/components/schemas/IntegerMin0String' avgGasPrice_Wei: $ref: '#/components/schemas/IntegerMin0String' Result.stats.ethsupply: type: object properties: result: $ref: '#/components/schemas/IntegerMin0String' Result.stats.ethsupply2: type: object properties: result: type: object properties: EthSupply: $ref: '#/components/schemas/IntegerMin0String' Eth2Staking: $ref: '#/components/schemas/IntegerMin0String' BurntFees: $ref: '#/components/schemas/IntegerMin0String' WithdrawnTotal: $ref: '#/components/schemas/IntegerMin0String' Result.stats.ethprice: type: object properties: result: type: object properties: ethbtc: $ref: '#/components/schemas/FloatString' ethbtc_timestamp: $ref: '#/components/schemas/UnixTimestampString' ethusd: $ref: '#/components/schemas/FloatString' ethusd_timestamp: $ref: '#/components/schemas/UnixTimestampString' Result.stats.chainsize: type: object properties: result: type: array items: type: object properties: blockNumber: $ref: '#/components/schemas/IntegerMin0String' chainTimeStamp: $ref: '#/components/schemas/DateYYYYMMDD' chainSize: $ref: '#/components/schemas/IntegerMin0String' clientType: $ref: '#/components/schemas/ClientType' syncMode: $ref: '#/components/schemas/SyncMode' Result.stats.nodecount: type: object properties: result: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' TotalNodeCount: $ref: '#/components/schemas/IntegerMin0String' Result.stats.dailytxnfee: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' transactionFee_Eth: $ref: '#/components/schemas/FloatString' Result.stats.dailynewaddress: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' newAddressCount: $ref: '#/components/schemas/IntegerMin0' Result.stats.dailynetutilization: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' networkUtilization: $ref: '#/components/schemas/FloatString' Result.stats.dailyavghashrate: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' networkHashRate: $ref: '#/components/schemas/FloatString' Result.stats.dailytx: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' transactionCount: $ref: '#/components/schemas/IntegerMin0' Result.stats.dailyavgnetdifficulty: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' networkDifficulty: $ref: '#/components/schemas/FloatWithCommasString' Result.stats.ethdailymarketcap: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' supply: $ref: '#/components/schemas/FloatString' marketCap: $ref: '#/components/schemas/FloatString' price: $ref: '#/components/schemas/FloatString' Result.stats.ethdailyprice: type: object properties: result: type: array items: type: object properties: UTCDate: $ref: '#/components/schemas/DateYYYYMMDD' unixTimeStamp: $ref: '#/components/schemas/UnixTimestampString' value: $ref: '#/components/schemas/FloatString' Result.proxy.eth_blockNumber: type: object properties: result: $ref: '#/components/schemas/Hex0xPrefixed' Result.proxy.eth_getBlockByNumber: type: object additionalProperties: true Result.proxy.eth_getUncleByBlockNumberAndIndex: type: object additionalProperties: true Result.proxy.eth_getBlockTransactionCountByNumber: type: object properties: result: $ref: '#/components/schemas/Hex0xPrefixed' Result.proxy.eth_getTransactionByHash: type: object additionalProperties: true Result.proxy.eth_getTransactionByBlockNumberAndIndex: type: object additionalProperties: true Result.proxy.eth_getTransactionCount: type: object properties: result: $ref: '#/components/schemas/Hex0xPrefixed' Result.proxy.eth_sendRawTransaction: type: object properties: result: $ref: '#/components/schemas/TxHash' Result.proxy.eth_getTransactionReceipt: type: object additionalProperties: true Result.proxy.eth_call: type: object properties: result: $ref: '#/components/schemas/TxHash' Result.proxy.eth_getCode: type: object properties: result: $ref: '#/components/schemas/Hex0xPrefixed' Result.proxy.eth_getStorageAt: type: object properties: result: $ref: '#/components/schemas/Hex0xPrefixed' Result.proxy.eth_gasPrice: type: object properties: result: $ref: '#/components/schemas/Hex0xPrefixed' Result.proxy.eth_estimateGas: type: object properties: result: $ref: '#/components/schemas/Hex0xPrefixed' securitySchemes: apiKeyAuth: type: apiKey in: query name: apikey