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  `