gitee.com/liu-zhao234568/cntest@v1.0.0/graphql/schema.go (about) 1 // Copyright 2019 The go-ethereum Authors 2 // This file is part of the go-ethereum library. 3 // 4 // The go-ethereum library is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU Lesser General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // The go-ethereum library is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU Lesser General Public License for more details. 13 // 14 // You should have received a copy of the GNU Lesser General Public License 15 // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>. 16 17 package graphql 18 19 const schema string = ` 20 # Bytes32 is a 32 byte binary string, represented as 0x-prefixed hexadecimal. 21 scalar Bytes32 22 # Address is a 20 byte Ethereum address, represented as 0x-prefixed hexadecimal. 23 scalar Address 24 # Bytes is an arbitrary length binary string, represented as 0x-prefixed hexadecimal. 25 # An empty byte string is represented as '0x'. Byte strings must have an even number of hexadecimal nybbles. 26 scalar Bytes 27 # BigInt is a large integer. Input is accepted as either a JSON number or as a string. 28 # Strings may be either decimal or 0x-prefixed hexadecimal. Output values are all 29 # 0x-prefixed hexadecimal. 30 scalar BigInt 31 # Long is a 64 bit unsigned integer. 32 scalar Long 33 34 schema { 35 query: Query 36 mutation: Mutation 37 } 38 39 # Account is an Ethereum account at a particular block. 40 type Account { 41 # Address is the address owning the account. 42 address: Address! 43 # Balance is the balance of the account, in wei. 44 balance: BigInt! 45 # TransactionCount is the number of transactions sent from this account, 46 # or in the case of a contract, the number of contracts created. Otherwise 47 # known as the nonce. 48 transactionCount: Long! 49 # Code contains the smart contract code for this account, if the account 50 # is a (non-self-destructed) contract. 51 code: Bytes! 52 # Storage provides access to the storage of a contract account, indexed 53 # by its 32 byte slot identifier. 54 storage(slot: Bytes32!): Bytes32! 55 } 56 57 # Log is an Ethereum event log. 58 type Log { 59 # Index is the index of this log in the block. 60 index: Int! 61 # Account is the account which generated this log - this will always 62 # be a contract account. 63 account(block: Long): Account! 64 # Topics is a list of 0-4 indexed topics for the log. 65 topics: [Bytes32!]! 66 # Data is unindexed data for this log. 67 data: Bytes! 68 # Transaction is the transaction that generated this log entry. 69 transaction: Transaction! 70 } 71 72 #EIP-2718 73 type AccessTuple{ 74 address: Address! 75 storageKeys : [Bytes32!] 76 } 77 78 # Transaction is an Ethereum transaction. 79 type Transaction { 80 # Hash is the hash of this transaction. 81 hash: Bytes32! 82 # Nonce is the nonce of the account this transaction was generated with. 83 nonce: Long! 84 # Index is the index of this transaction in the parent block. This will 85 # be null if the transaction has not yet been mined. 86 index: Int 87 # From is the account that sent this transaction - this will always be 88 # an externally owned account. 89 from(block: Long): Account! 90 # To is the account the transaction was sent to. This is null for 91 # contract-creating transactions. 92 to(block: Long): Account 93 # Value is the value, in wei, sent along with this transaction. 94 value: BigInt! 95 # GasPrice is the price offered to miners for gas, in wei per unit. 96 gasPrice: BigInt! 97 # MaxFeePerGas is the maximum fee per gas offered to include a transaction, in wei. 98 maxFeePerGas: BigInt 99 # MaxPriorityFeePerGas is the maximum miner tip per gas offered to include a transaction, in wei. 100 maxPriorityFeePerGas: BigInt 101 # Gas is the maximum amount of gas this transaction can consume. 102 gas: Long! 103 # InputData is the data supplied to the target of the transaction. 104 inputData: Bytes! 105 # Block is the block this transaction was mined in. This will be null if 106 # the transaction has not yet been mined. 107 block: Block 108 109 # Status is the return status of the transaction. This will be 1 if the 110 # transaction succeeded, or 0 if it failed (due to a revert, or due to 111 # running out of gas). If the transaction has not yet been mined, this 112 # field will be null. 113 status: Long 114 # GasUsed is the amount of gas that was used processing this transaction. 115 # If the transaction has not yet been mined, this field will be null. 116 gasUsed: Long 117 # CumulativeGasUsed is the total gas used in the block up to and including 118 # this transaction. If the transaction has not yet been mined, this field 119 # will be null. 120 cumulativeGasUsed: Long 121 # EffectiveGasPrice is actual value per gas deducted from the sender's 122 # account. Before EIP-1559, this is equal to the transaction's gas price. 123 # After EIP-1559, it is baseFeePerGas + min(maxFeePerGas - baseFeePerGas, 124 # maxPriorityFeePerGas). Legacy transactions and EIP-2930 transactions are 125 # coerced into the EIP-1559 format by setting both maxFeePerGas and 126 # maxPriorityFeePerGas as the transaction's gas price. 127 effectiveGasPrice: BigInt 128 # CreatedContract is the account that was created by a contract creation 129 # transaction. If the transaction was not a contract creation transaction, 130 # or it has not yet been mined, this field will be null. 131 createdContract(block: Long): Account 132 # Logs is a list of log entries emitted by this transaction. If the 133 # transaction has not yet been mined, this field will be null. 134 logs: [Log!] 135 r: BigInt! 136 s: BigInt! 137 v: BigInt! 138 #Envelope transaction support 139 type: Int 140 accessList: [AccessTuple!] 141 } 142 143 # BlockFilterCriteria encapsulates log filter criteria for a filter applied 144 # to a single block. 145 input BlockFilterCriteria { 146 # Addresses is list of addresses that are of interest. If this list is 147 # empty, results will not be filtered by address. 148 addresses: [Address!] 149 # Topics list restricts matches to particular event topics. Each event has a list 150 # of topics. Topics matches a prefix of that list. An empty element array matches any 151 # topic. Non-empty elements represent an alternative that matches any of the 152 # contained topics. 153 # 154 # Examples: 155 # - [] or nil matches any topic list 156 # - [[A]] matches topic A in first position 157 # - [[], [B]] matches any topic in first position, B in second position 158 # - [[A], [B]] matches topic A in first position, B in second position 159 # - [[A, B]], [C, D]] matches topic (A OR B) in first position, (C OR D) in second position 160 topics: [[Bytes32!]!] 161 } 162 163 # Block is an Ethereum block. 164 type Block { 165 # Number is the number of this block, starting at 0 for the genesis block. 166 number: Long! 167 # Hash is the block hash of this block. 168 hash: Bytes32! 169 # Parent is the parent block of this block. 170 parent: Block 171 # Nonce is the block nonce, an 8 byte sequence determined by the miner. 172 nonce: Bytes! 173 # TransactionsRoot is the keccak256 hash of the root of the trie of transactions in this block. 174 transactionsRoot: Bytes32! 175 # TransactionCount is the number of transactions in this block. if 176 # transactions are not available for this block, this field will be null. 177 transactionCount: Int 178 # StateRoot is the keccak256 hash of the state trie after this block was processed. 179 stateRoot: Bytes32! 180 # ReceiptsRoot is the keccak256 hash of the trie of transaction receipts in this block. 181 receiptsRoot: Bytes32! 182 # Miner is the account that mined this block. 183 miner(block: Long): Account! 184 # ExtraData is an arbitrary data field supplied by the miner. 185 extraData: Bytes! 186 # GasLimit is the maximum amount of gas that was available to transactions in this block. 187 gasLimit: Long! 188 # GasUsed is the amount of gas that was used executing transactions in this block. 189 gasUsed: Long! 190 # BaseFeePerGas is the fee perunit of gas burned by the protocol in this block. 191 baseFeePerGas: BigInt 192 # Timestamp is the unix timestamp at which this block was mined. 193 timestamp: Long! 194 # LogsBloom is a bloom filter that can be used to check if a block may 195 # contain log entries matching a filter. 196 logsBloom: Bytes! 197 # MixHash is the hash that was used as an input to the PoW process. 198 mixHash: Bytes32! 199 # Difficulty is a measure of the difficulty of mining this block. 200 difficulty: BigInt! 201 # TotalDifficulty is the sum of all difficulty values up to and including 202 # this block. 203 totalDifficulty: BigInt! 204 # OmmerCount is the number of ommers (AKA uncles) associated with this 205 # block. If ommers are unavailable, this field will be null. 206 ommerCount: Int 207 # Ommers is a list of ommer (AKA uncle) blocks associated with this block. 208 # If ommers are unavailable, this field will be null. Depending on your 209 # node, the transactions, transactionAt, transactionCount, ommers, 210 # ommerCount and ommerAt fields may not be available on any ommer blocks. 211 ommers: [Block] 212 # OmmerAt returns the ommer (AKA uncle) at the specified index. If ommers 213 # are unavailable, or the index is out of bounds, this field will be null. 214 ommerAt(index: Int!): Block 215 # OmmerHash is the keccak256 hash of all the ommers (AKA uncles) 216 # associated with this block. 217 ommerHash: Bytes32! 218 # Transactions is a list of transactions associated with this block. If 219 # transactions are unavailable for this block, this field will be null. 220 transactions: [Transaction!] 221 # TransactionAt returns the transaction at the specified index. If 222 # transactions are unavailable for this block, or if the index is out of 223 # bounds, this field will be null. 224 transactionAt(index: Int!): Transaction 225 # Logs returns a filtered set of logs from this block. 226 logs(filter: BlockFilterCriteria!): [Log!]! 227 # Account fetches an Ethereum account at the current block's state. 228 account(address: Address!): Account! 229 # Call executes a local call operation at the current block's state. 230 call(data: CallData!): CallResult 231 # EstimateGas estimates the amount of gas that will be required for 232 # successful execution of a transaction at the current block's state. 233 estimateGas(data: CallData!): Long! 234 } 235 236 # CallData represents the data associated with a local contract call. 237 # All fields are optional. 238 input CallData { 239 # From is the address making the call. 240 from: Address 241 # To is the address the call is sent to. 242 to: Address 243 # Gas is the amount of gas sent with the call. 244 gas: Long 245 # GasPrice is the price, in wei, offered for each unit of gas. 246 gasPrice: BigInt 247 # MaxFeePerGas is the maximum fee per gas offered, in wei. 248 maxFeePerGas: BigInt 249 # MaxPriorityFeePerGas is the maximum miner tip per gas offered, in wei. 250 maxPriorityFeePerGas: BigInt 251 # Value is the value, in wei, sent along with the call. 252 value: BigInt 253 # Data is the data sent to the callee. 254 data: Bytes 255 } 256 257 # CallResult is the result of a local call operation. 258 type CallResult { 259 # Data is the return data of the called contract. 260 data: Bytes! 261 # GasUsed is the amount of gas used by the call, after any refunds. 262 gasUsed: Long! 263 # Status is the result of the call - 1 for success or 0 for failure. 264 status: Long! 265 } 266 267 # FilterCriteria encapsulates log filter criteria for searching log entries. 268 input FilterCriteria { 269 # FromBlock is the block at which to start searching, inclusive. Defaults 270 # to the latest block if not supplied. 271 fromBlock: Long 272 # ToBlock is the block at which to stop searching, inclusive. Defaults 273 # to the latest block if not supplied. 274 toBlock: Long 275 # Addresses is a list of addresses that are of interest. If this list is 276 # empty, results will not be filtered by address. 277 addresses: [Address!] 278 # Topics list restricts matches to particular event topics. Each event has a list 279 # of topics. Topics matches a prefix of that list. An empty element array matches any 280 # topic. Non-empty elements represent an alternative that matches any of the 281 # contained topics. 282 # 283 # Examples: 284 # - [] or nil matches any topic list 285 # - [[A]] matches topic A in first position 286 # - [[], [B]] matches any topic in first position, B in second position 287 # - [[A], [B]] matches topic A in first position, B in second position 288 # - [[A, B]], [C, D]] matches topic (A OR B) in first position, (C OR D) in second position 289 topics: [[Bytes32!]!] 290 } 291 292 # SyncState contains the current synchronisation state of the client. 293 type SyncState{ 294 # StartingBlock is the block number at which synchronisation started. 295 startingBlock: Long! 296 # CurrentBlock is the point at which synchronisation has presently reached. 297 currentBlock: Long! 298 # HighestBlock is the latest known block number. 299 highestBlock: Long! 300 # PulledStates is the number of state entries fetched so far, or null 301 # if this is not known or not relevant. 302 pulledStates: Long 303 # KnownStates is the number of states the node knows of so far, or null 304 # if this is not known or not relevant. 305 knownStates: Long 306 } 307 308 # Pending represents the current pending state. 309 type Pending { 310 # TransactionCount is the number of transactions in the pending state. 311 transactionCount: Int! 312 # Transactions is a list of transactions in the current pending state. 313 transactions: [Transaction!] 314 # Account fetches an Ethereum account for the pending state. 315 account(address: Address!): Account! 316 # Call executes a local call operation for the pending state. 317 call(data: CallData!): CallResult 318 # EstimateGas estimates the amount of gas that will be required for 319 # successful execution of a transaction for the pending state. 320 estimateGas(data: CallData!): Long! 321 } 322 323 type Query { 324 # Block fetches an Ethereum block by number or by hash. If neither is 325 # supplied, the most recent known block is returned. 326 block(number: Long, hash: Bytes32): Block 327 # Blocks returns all the blocks between two numbers, inclusive. If 328 # to is not supplied, it defaults to the most recent known block. 329 blocks(from: Long, to: Long): [Block!]! 330 # Pending returns the current pending state. 331 pending: Pending! 332 # Transaction returns a transaction specified by its hash. 333 transaction(hash: Bytes32!): Transaction 334 # Logs returns log entries matching the provided filter. 335 logs(filter: FilterCriteria!): [Log!]! 336 # GasPrice returns the node's estimate of a gas price sufficient to 337 # ensure a transaction is mined in a timely fashion. 338 gasPrice: BigInt! 339 # MaxPriorityFeePerGas returns the node's estimate of a gas tip sufficient 340 # to ensure a transaction is mined in a timely fashion. 341 maxPriorityFeePerGas: BigInt! 342 # Syncing returns information on the current synchronisation state. 343 syncing: SyncState 344 # ChainID returns the current chain ID for transaction replay protection. 345 chainID: BigInt! 346 } 347 348 type Mutation { 349 # SendRawTransaction sends an RLP-encoded transaction to the network. 350 sendRawTransaction(data: Bytes!): Bytes32! 351 } 352 `