gitee.com/liu-zhao234568/cntest@v1.0.0/ethclient/gethclient/gethclient.go (about) 1 // Copyright 2021 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 gethclient provides an RPC client for geth-specific APIs. 18 package gethclient 19 20 import ( 21 "context" 22 "math/big" 23 "runtime" 24 "runtime/debug" 25 26 "gitee.com/liu-zhao234568/cntest/common" 27 "gitee.com/liu-zhao234568/cntest/common/hexutil" 28 "gitee.com/liu-zhao234568/cntest/core/types" 29 "gitee.com/liu-zhao234568/cntest/p2p" 30 "gitee.com/liu-zhao234568/cntest/rpc" 31 ) 32 33 // Client is a wrapper around rpc.Client that implements geth-specific functionality. 34 // 35 // If you want to use the standardized Ethereum RPC functionality, use ethclient.Client instead. 36 type Client struct { 37 c *rpc.Client 38 } 39 40 // New creates a client that uses the given RPC client. 41 func New(c *rpc.Client) *Client { 42 return &Client{c} 43 } 44 45 // CreateAccessList tries to create an access list for a specific transaction based on the 46 // current pending state of the blockchain. 47 func (ec *Client) CreateAccessList(ctx context.Context, msg ethereum.CallMsg) (*types.AccessList, uint64, string, error) { 48 type accessListResult struct { 49 Accesslist *types.AccessList `json:"accessList"` 50 Error string `json:"error,omitempty"` 51 GasUsed hexutil.Uint64 `json:"gasUsed"` 52 } 53 var result accessListResult 54 if err := ec.c.CallContext(ctx, &result, "eth_createAccessList", toCallArg(msg)); err != nil { 55 return nil, 0, "", err 56 } 57 return result.Accesslist, uint64(result.GasUsed), result.Error, nil 58 } 59 60 // AccountResult is the result of a GetProof operation. 61 type AccountResult struct { 62 Address common.Address `json:"address"` 63 AccountProof []string `json:"accountProof"` 64 Balance *big.Int `json:"balance"` 65 CodeHash common.Hash `json:"codeHash"` 66 Nonce uint64 `json:"nonce"` 67 StorageHash common.Hash `json:"storageHash"` 68 StorageProof []StorageResult `json:"storageProof"` 69 } 70 71 // StorageResult provides a proof for a key-value pair. 72 type StorageResult struct { 73 Key string `json:"key"` 74 Value *big.Int `json:"value"` 75 Proof []string `json:"proof"` 76 } 77 78 // GetProof returns the account and storage values of the specified account including the Merkle-proof. 79 // The block number can be nil, in which case the value is taken from the latest known block. 80 func (ec *Client) GetProof(ctx context.Context, account common.Address, keys []string, blockNumber *big.Int) (*AccountResult, error) { 81 82 type storageResult struct { 83 Key string `json:"key"` 84 Value *hexutil.Big `json:"value"` 85 Proof []string `json:"proof"` 86 } 87 88 type accountResult struct { 89 Address common.Address `json:"address"` 90 AccountProof []string `json:"accountProof"` 91 Balance *hexutil.Big `json:"balance"` 92 CodeHash common.Hash `json:"codeHash"` 93 Nonce hexutil.Uint64 `json:"nonce"` 94 StorageHash common.Hash `json:"storageHash"` 95 StorageProof []storageResult `json:"storageProof"` 96 } 97 98 var res accountResult 99 err := ec.c.CallContext(ctx, &res, "eth_getProof", account, keys, toBlockNumArg(blockNumber)) 100 // Turn hexutils back to normal datatypes 101 storageResults := make([]StorageResult, 0, len(res.StorageProof)) 102 for _, st := range res.StorageProof { 103 storageResults = append(storageResults, StorageResult{ 104 Key: st.Key, 105 Value: st.Value.ToInt(), 106 Proof: st.Proof, 107 }) 108 } 109 result := AccountResult{ 110 Address: res.Address, 111 AccountProof: res.AccountProof, 112 Balance: res.Balance.ToInt(), 113 Nonce: uint64(res.Nonce), 114 CodeHash: res.CodeHash, 115 StorageHash: res.StorageHash, 116 } 117 return &result, err 118 } 119 120 // OverrideAccount specifies the state of an account to be overridden. 121 type OverrideAccount struct { 122 Nonce uint64 `json:"nonce"` 123 Code []byte `json:"code"` 124 Balance *big.Int `json:"balance"` 125 State map[common.Hash]common.Hash `json:"state"` 126 StateDiff map[common.Hash]common.Hash `json:"stateDiff"` 127 } 128 129 // CallContract executes a message call transaction, which is directly executed in the VM 130 // of the node, but never mined into the blockchain. 131 // 132 // blockNumber selects the block height at which the call runs. It can be nil, in which 133 // case the code is taken from the latest known block. Note that state from very old 134 // blocks might not be available. 135 // 136 // overrides specifies a map of contract states that should be overwritten before executing 137 // the message call. 138 // Please use ethclient.CallContract instead if you don't need the override functionality. 139 func (ec *Client) CallContract(ctx context.Context, msg ethereum.CallMsg, blockNumber *big.Int, overrides *map[common.Address]OverrideAccount) ([]byte, error) { 140 var hex hexutil.Bytes 141 err := ec.c.CallContext( 142 ctx, &hex, "eth_call", toCallArg(msg), 143 toBlockNumArg(blockNumber), toOverrideMap(overrides), 144 ) 145 return hex, err 146 } 147 148 // GCStats retrieves the current garbage collection stats from a geth node. 149 func (ec *Client) GCStats(ctx context.Context) (*debug.GCStats, error) { 150 var result debug.GCStats 151 err := ec.c.CallContext(ctx, &result, "debug_gcStats") 152 return &result, err 153 } 154 155 // MemStats retrieves the current memory stats from a geth node. 156 func (ec *Client) MemStats(ctx context.Context) (*runtime.MemStats, error) { 157 var result runtime.MemStats 158 err := ec.c.CallContext(ctx, &result, "debug_memStats") 159 return &result, err 160 } 161 162 // SetHead sets the current head of the local chain by block number. 163 // Note, this is a destructive action and may severely damage your chain. 164 // Use with extreme caution. 165 func (ec *Client) SetHead(ctx context.Context, number *big.Int) error { 166 return ec.c.CallContext(ctx, nil, "debug_setHead", toBlockNumArg(number)) 167 } 168 169 // GetNodeInfo retrieves the node info of a geth node. 170 func (ec *Client) GetNodeInfo(ctx context.Context) (*p2p.NodeInfo, error) { 171 var result p2p.NodeInfo 172 err := ec.c.CallContext(ctx, &result, "admin_nodeInfo") 173 return &result, err 174 } 175 176 // SubscribePendingTransactions subscribes to new pending transactions. 177 func (ec *Client) SubscribePendingTransactions(ctx context.Context, ch chan<- common.Hash) (*rpc.ClientSubscription, error) { 178 return ec.c.EthSubscribe(ctx, ch, "newPendingTransactions") 179 } 180 181 func toBlockNumArg(number *big.Int) string { 182 if number == nil { 183 return "latest" 184 } 185 pending := big.NewInt(-1) 186 if number.Cmp(pending) == 0 { 187 return "pending" 188 } 189 return hexutil.EncodeBig(number) 190 } 191 192 func toCallArg(msg ethereum.CallMsg) interface{} { 193 arg := map[string]interface{}{ 194 "from": msg.From, 195 "to": msg.To, 196 } 197 if len(msg.Data) > 0 { 198 arg["data"] = hexutil.Bytes(msg.Data) 199 } 200 if msg.Value != nil { 201 arg["value"] = (*hexutil.Big)(msg.Value) 202 } 203 if msg.Gas != 0 { 204 arg["gas"] = hexutil.Uint64(msg.Gas) 205 } 206 if msg.GasPrice != nil { 207 arg["gasPrice"] = (*hexutil.Big)(msg.GasPrice) 208 } 209 return arg 210 } 211 212 func toOverrideMap(overrides *map[common.Address]OverrideAccount) interface{} { 213 if overrides == nil { 214 return nil 215 } 216 type overrideAccount struct { 217 Nonce hexutil.Uint64 `json:"nonce"` 218 Code hexutil.Bytes `json:"code"` 219 Balance *hexutil.Big `json:"balance"` 220 State map[common.Hash]common.Hash `json:"state"` 221 StateDiff map[common.Hash]common.Hash `json:"stateDiff"` 222 } 223 result := make(map[common.Address]overrideAccount) 224 for addr, override := range *overrides { 225 result[addr] = overrideAccount{ 226 Nonce: hexutil.Uint64(override.Nonce), 227 Code: override.Code, 228 Balance: (*hexutil.Big)(override.Balance), 229 State: override.State, 230 StateDiff: override.StateDiff, 231 } 232 } 233 return &result 234 }