github.com/edxfund/validator@v1.8.16-0.20181020093046-c1def72855da/internal/ethapi/api.go (about) 1 // Copyright 2015 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 ethapi 18 19 import ( 20 "bytes" 21 "context" 22 "errors" 23 "fmt" 24 "math/big" 25 "strings" 26 "time" 27 28 "github.com/davecgh/go-spew/spew" 29 "github.com/EDXFund/Validator/accounts" 30 "github.com/EDXFund/Validator/accounts/keystore" 31 "github.com/EDXFund/Validator/common" 32 "github.com/EDXFund/Validator/common/hexutil" 33 "github.com/EDXFund/Validator/common/math" 34 "github.com/EDXFund/Validator/consensus/ethash" 35 "github.com/EDXFund/Validator/core" 36 "github.com/EDXFund/Validator/core/rawdb" 37 "github.com/EDXFund/Validator/core/types" 38 "github.com/EDXFund/Validator/core/vm" 39 "github.com/EDXFund/Validator/crypto" 40 "github.com/EDXFund/Validator/log" 41 "github.com/EDXFund/Validator/p2p" 42 "github.com/EDXFund/Validator/params" 43 "github.com/EDXFund/Validator/rlp" 44 "github.com/EDXFund/Validator/rpc" 45 "github.com/syndtr/goleveldb/leveldb" 46 "github.com/syndtr/goleveldb/leveldb/util" 47 ) 48 49 const ( 50 defaultGasPrice = params.GWei 51 ) 52 53 // PublicEthereumAPI provides an API to access Ethereum related information. 54 // It offers only methods that operate on public data that is freely available to anyone. 55 type PublicEthereumAPI struct { 56 b Backend 57 } 58 59 // NewPublicEthereumAPI creates a new Ethereum protocol API. 60 func NewPublicEthereumAPI(b Backend) *PublicEthereumAPI { 61 return &PublicEthereumAPI{b} 62 } 63 64 // GasPrice returns a suggestion for a gas price. 65 func (s *PublicEthereumAPI) GasPrice(ctx context.Context) (*hexutil.Big, error) { 66 price, err := s.b.SuggestPrice(ctx) 67 return (*hexutil.Big)(price), err 68 } 69 70 // ProtocolVersion returns the current Ethereum protocol version this node supports 71 func (s *PublicEthereumAPI) ProtocolVersion() hexutil.Uint { 72 return hexutil.Uint(s.b.ProtocolVersion()) 73 } 74 75 // Syncing returns false in case the node is currently not syncing with the network. It can be up to date or has not 76 // yet received the latest block headers from its pears. In case it is synchronizing: 77 // - startingBlock: block number this node started to synchronise from 78 // - currentBlock: block number this node is currently importing 79 // - highestBlock: block number of the highest block header this node has received from peers 80 // - pulledStates: number of state entries processed until now 81 // - knownStates: number of known state entries that still need to be pulled 82 func (s *PublicEthereumAPI) Syncing() (interface{}, error) { 83 progress := s.b.Downloader().Progress() 84 85 // Return not syncing if the synchronisation already completed 86 if progress.CurrentBlock >= progress.HighestBlock { 87 return false, nil 88 } 89 // Otherwise gather the block sync stats 90 return map[string]interface{}{ 91 "startingBlock": hexutil.Uint64(progress.StartingBlock), 92 "currentBlock": hexutil.Uint64(progress.CurrentBlock), 93 "highestBlock": hexutil.Uint64(progress.HighestBlock), 94 "pulledStates": hexutil.Uint64(progress.PulledStates), 95 "knownStates": hexutil.Uint64(progress.KnownStates), 96 }, nil 97 } 98 99 // PublicTxPoolAPI offers and API for the transaction pool. It only operates on data that is non confidential. 100 type PublicTxPoolAPI struct { 101 b Backend 102 } 103 104 // NewPublicTxPoolAPI creates a new tx pool service that gives information about the transaction pool. 105 func NewPublicTxPoolAPI(b Backend) *PublicTxPoolAPI { 106 return &PublicTxPoolAPI{b} 107 } 108 109 // Content returns the transactions contained within the transaction pool. 110 func (s *PublicTxPoolAPI) Content() map[string]map[string]map[string]*RPCTransaction { 111 content := map[string]map[string]map[string]*RPCTransaction{ 112 "pending": make(map[string]map[string]*RPCTransaction), 113 "queued": make(map[string]map[string]*RPCTransaction), 114 } 115 pending, queue := s.b.TxPoolContent() 116 117 // Flatten the pending transactions 118 for account, txs := range pending { 119 dump := make(map[string]*RPCTransaction) 120 for _, tx := range txs { 121 dump[fmt.Sprintf("%d", tx.Nonce())] = newRPCPendingTransaction(tx) 122 } 123 content["pending"][account.Hex()] = dump 124 } 125 // Flatten the queued transactions 126 for account, txs := range queue { 127 dump := make(map[string]*RPCTransaction) 128 for _, tx := range txs { 129 dump[fmt.Sprintf("%d", tx.Nonce())] = newRPCPendingTransaction(tx) 130 } 131 content["queued"][account.Hex()] = dump 132 } 133 return content 134 } 135 136 // Status returns the number of pending and queued transaction in the pool. 137 func (s *PublicTxPoolAPI) Status() map[string]hexutil.Uint { 138 pending, queue := s.b.Stats() 139 return map[string]hexutil.Uint{ 140 "pending": hexutil.Uint(pending), 141 "queued": hexutil.Uint(queue), 142 } 143 } 144 145 // Inspect retrieves the content of the transaction pool and flattens it into an 146 // easily inspectable list. 147 func (s *PublicTxPoolAPI) Inspect() map[string]map[string]map[string]string { 148 content := map[string]map[string]map[string]string{ 149 "pending": make(map[string]map[string]string), 150 "queued": make(map[string]map[string]string), 151 } 152 pending, queue := s.b.TxPoolContent() 153 154 // Define a formatter to flatten a transaction into a string 155 var format = func(tx *types.Transaction) string { 156 if to := tx.To(); to != nil { 157 return fmt.Sprintf("%s: %v wei + %v gas × %v wei", tx.To().Hex(), tx.Value(), tx.Gas(), tx.GasPrice()) 158 } 159 return fmt.Sprintf("contract creation: %v wei + %v gas × %v wei", tx.Value(), tx.Gas(), tx.GasPrice()) 160 } 161 // Flatten the pending transactions 162 for account, txs := range pending { 163 dump := make(map[string]string) 164 for _, tx := range txs { 165 dump[fmt.Sprintf("%d", tx.Nonce())] = format(tx) 166 } 167 content["pending"][account.Hex()] = dump 168 } 169 // Flatten the queued transactions 170 for account, txs := range queue { 171 dump := make(map[string]string) 172 for _, tx := range txs { 173 dump[fmt.Sprintf("%d", tx.Nonce())] = format(tx) 174 } 175 content["queued"][account.Hex()] = dump 176 } 177 return content 178 } 179 180 // PublicAccountAPI provides an API to access accounts managed by this node. 181 // It offers only methods that can retrieve accounts. 182 type PublicAccountAPI struct { 183 am *accounts.Manager 184 } 185 186 // NewPublicAccountAPI creates a new PublicAccountAPI. 187 func NewPublicAccountAPI(am *accounts.Manager) *PublicAccountAPI { 188 return &PublicAccountAPI{am: am} 189 } 190 191 // Accounts returns the collection of accounts this node manages 192 func (s *PublicAccountAPI) Accounts() []common.Address { 193 addresses := make([]common.Address, 0) // return [] instead of nil if empty 194 for _, wallet := range s.am.Wallets() { 195 for _, account := range wallet.Accounts() { 196 addresses = append(addresses, account.Address) 197 } 198 } 199 return addresses 200 } 201 202 // PrivateAccountAPI provides an API to access accounts managed by this node. 203 // It offers methods to create, (un)lock en list accounts. Some methods accept 204 // passwords and are therefore considered private by default. 205 type PrivateAccountAPI struct { 206 am *accounts.Manager 207 nonceLock *AddrLocker 208 b Backend 209 } 210 211 // NewPrivateAccountAPI create a new PrivateAccountAPI. 212 func NewPrivateAccountAPI(b Backend, nonceLock *AddrLocker) *PrivateAccountAPI { 213 return &PrivateAccountAPI{ 214 am: b.AccountManager(), 215 nonceLock: nonceLock, 216 b: b, 217 } 218 } 219 220 // ListAccounts will return a list of addresses for accounts this node manages. 221 func (s *PrivateAccountAPI) ListAccounts() []common.Address { 222 addresses := make([]common.Address, 0) // return [] instead of nil if empty 223 for _, wallet := range s.am.Wallets() { 224 for _, account := range wallet.Accounts() { 225 addresses = append(addresses, account.Address) 226 } 227 } 228 return addresses 229 } 230 231 // rawWallet is a JSON representation of an accounts.Wallet interface, with its 232 // data contents extracted into plain fields. 233 type rawWallet struct { 234 URL string `json:"url"` 235 Status string `json:"status"` 236 Failure string `json:"failure,omitempty"` 237 Accounts []accounts.Account `json:"accounts,omitempty"` 238 } 239 240 // ListWallets will return a list of wallets this node manages. 241 func (s *PrivateAccountAPI) ListWallets() []rawWallet { 242 wallets := make([]rawWallet, 0) // return [] instead of nil if empty 243 for _, wallet := range s.am.Wallets() { 244 status, failure := wallet.Status() 245 246 raw := rawWallet{ 247 URL: wallet.URL().String(), 248 Status: status, 249 Accounts: wallet.Accounts(), 250 } 251 if failure != nil { 252 raw.Failure = failure.Error() 253 } 254 wallets = append(wallets, raw) 255 } 256 return wallets 257 } 258 259 // OpenWallet initiates a hardware wallet opening procedure, establishing a USB 260 // connection and attempting to authenticate via the provided passphrase. Note, 261 // the method may return an extra challenge requiring a second open (e.g. the 262 // Trezor PIN matrix challenge). 263 func (s *PrivateAccountAPI) OpenWallet(url string, passphrase *string) error { 264 wallet, err := s.am.Wallet(url) 265 if err != nil { 266 return err 267 } 268 pass := "" 269 if passphrase != nil { 270 pass = *passphrase 271 } 272 return wallet.Open(pass) 273 } 274 275 // DeriveAccount requests a HD wallet to derive a new account, optionally pinning 276 // it for later reuse. 277 func (s *PrivateAccountAPI) DeriveAccount(url string, path string, pin *bool) (accounts.Account, error) { 278 wallet, err := s.am.Wallet(url) 279 if err != nil { 280 return accounts.Account{}, err 281 } 282 derivPath, err := accounts.ParseDerivationPath(path) 283 if err != nil { 284 return accounts.Account{}, err 285 } 286 if pin == nil { 287 pin = new(bool) 288 } 289 return wallet.Derive(derivPath, *pin) 290 } 291 292 // NewAccount will create a new account and returns the address for the new account. 293 func (s *PrivateAccountAPI) NewAccount(password string) (common.Address, error) { 294 acc, err := fetchKeystore(s.am).NewAccount(password) 295 if err == nil { 296 return acc.Address, nil 297 } 298 return common.Address{}, err 299 } 300 301 // fetchKeystore retrives the encrypted keystore from the account manager. 302 func fetchKeystore(am *accounts.Manager) *keystore.KeyStore { 303 return am.Backends(keystore.KeyStoreType)[0].(*keystore.KeyStore) 304 } 305 306 // ImportRawKey stores the given hex encoded ECDSA key into the key directory, 307 // encrypting it with the passphrase. 308 func (s *PrivateAccountAPI) ImportRawKey(privkey string, password string) (common.Address, error) { 309 key, err := crypto.HexToECDSA(privkey) 310 if err != nil { 311 return common.Address{}, err 312 } 313 acc, err := fetchKeystore(s.am).ImportECDSA(key, password) 314 return acc.Address, err 315 } 316 317 // UnlockAccount will unlock the account associated with the given address with 318 // the given password for duration seconds. If duration is nil it will use a 319 // default of 300 seconds. It returns an indication if the account was unlocked. 320 func (s *PrivateAccountAPI) UnlockAccount(addr common.Address, password string, duration *uint64) (bool, error) { 321 const max = uint64(time.Duration(math.MaxInt64) / time.Second) 322 var d time.Duration 323 if duration == nil { 324 d = 300 * time.Second 325 } else if *duration > max { 326 return false, errors.New("unlock duration too large") 327 } else { 328 d = time.Duration(*duration) * time.Second 329 } 330 err := fetchKeystore(s.am).TimedUnlock(accounts.Account{Address: addr}, password, d) 331 return err == nil, err 332 } 333 334 // LockAccount will lock the account associated with the given address when it's unlocked. 335 func (s *PrivateAccountAPI) LockAccount(addr common.Address) bool { 336 return fetchKeystore(s.am).Lock(addr) == nil 337 } 338 339 // signTransactions sets defaults and signs the given transaction 340 // NOTE: the caller needs to ensure that the nonceLock is held, if applicable, 341 // and release it after the transaction has been submitted to the tx pool 342 func (s *PrivateAccountAPI) signTransaction(ctx context.Context, args SendTxArgs, passwd string) (*types.Transaction, error) { 343 // Look up the wallet containing the requested signer 344 account := accounts.Account{Address: args.From} 345 wallet, err := s.am.Find(account) 346 if err != nil { 347 return nil, err 348 } 349 // Set some sanity defaults and terminate on failure 350 if err := args.setDefaults(ctx, s.b); err != nil { 351 return nil, err 352 } 353 // Assemble the transaction and sign with the wallet 354 tx := args.toTransaction() 355 356 var chainID *big.Int 357 if config := s.b.ChainConfig(); config.IsEIP155(s.b.CurrentBlock().Number()) { 358 chainID = config.ChainID 359 } 360 return wallet.SignTxWithPassphrase(account, passwd, tx, chainID) 361 } 362 363 // SendTransaction will create a transaction from the given arguments and 364 // tries to sign it with the key associated with args.To. If the given passwd isn't 365 // able to decrypt the key it fails. 366 func (s *PrivateAccountAPI) SendTransaction(ctx context.Context, args SendTxArgs, passwd string) (common.Hash, error) { 367 if args.Nonce == nil { 368 // Hold the addresse's mutex around signing to prevent concurrent assignment of 369 // the same nonce to multiple accounts. 370 s.nonceLock.LockAddr(args.From) 371 defer s.nonceLock.UnlockAddr(args.From) 372 } 373 signed, err := s.signTransaction(ctx, args, passwd) 374 if err != nil { 375 return common.Hash{}, err 376 } 377 return submitTransaction(ctx, s.b, signed) 378 } 379 380 // SignTransaction will create a transaction from the given arguments and 381 // tries to sign it with the key associated with args.To. If the given passwd isn't 382 // able to decrypt the key it fails. The transaction is returned in RLP-form, not broadcast 383 // to other nodes 384 func (s *PrivateAccountAPI) SignTransaction(ctx context.Context, args SendTxArgs, passwd string) (*SignTransactionResult, error) { 385 // No need to obtain the noncelock mutex, since we won't be sending this 386 // tx into the transaction pool, but right back to the user 387 if args.Gas == nil { 388 return nil, fmt.Errorf("gas not specified") 389 } 390 if args.GasPrice == nil { 391 return nil, fmt.Errorf("gasPrice not specified") 392 } 393 if args.Nonce == nil { 394 return nil, fmt.Errorf("nonce not specified") 395 } 396 signed, err := s.signTransaction(ctx, args, passwd) 397 if err != nil { 398 return nil, err 399 } 400 data, err := rlp.EncodeToBytes(signed) 401 if err != nil { 402 return nil, err 403 } 404 return &SignTransactionResult{data, signed}, nil 405 } 406 407 // signHash is a helper function that calculates a hash for the given message that can be 408 // safely used to calculate a signature from. 409 // 410 // The hash is calulcated as 411 // keccak256("\x19Ethereum Signed Message:\n"${message length}${message}). 412 // 413 // This gives context to the signed message and prevents signing of transactions. 414 func signHash(data []byte) []byte { 415 msg := fmt.Sprintf("\x19Ethereum Signed Message:\n%d%s", len(data), data) 416 return crypto.Keccak256([]byte(msg)) 417 } 418 419 // Sign calculates an Ethereum ECDSA signature for: 420 // keccack256("\x19Ethereum Signed Message:\n" + len(message) + message)) 421 // 422 // Note, the produced signature conforms to the secp256k1 curve R, S and V values, 423 // where the V value will be 27 or 28 for legacy reasons. 424 // 425 // The key used to calculate the signature is decrypted with the given password. 426 // 427 // https://github.com/EDXFund/Validator/wiki/Management-APIs#personal_sign 428 func (s *PrivateAccountAPI) Sign(ctx context.Context, data hexutil.Bytes, addr common.Address, passwd string) (hexutil.Bytes, error) { 429 // Look up the wallet containing the requested signer 430 account := accounts.Account{Address: addr} 431 432 wallet, err := s.b.AccountManager().Find(account) 433 if err != nil { 434 return nil, err 435 } 436 // Assemble sign the data with the wallet 437 signature, err := wallet.SignHashWithPassphrase(account, passwd, signHash(data)) 438 if err != nil { 439 return nil, err 440 } 441 signature[64] += 27 // Transform V from 0/1 to 27/28 according to the yellow paper 442 return signature, nil 443 } 444 445 // EcRecover returns the address for the account that was used to create the signature. 446 // Note, this function is compatible with eth_sign and personal_sign. As such it recovers 447 // the address of: 448 // hash = keccak256("\x19Ethereum Signed Message:\n"${message length}${message}) 449 // addr = ecrecover(hash, signature) 450 // 451 // Note, the signature must conform to the secp256k1 curve R, S and V values, where 452 // the V value must be be 27 or 28 for legacy reasons. 453 // 454 // https://github.com/EDXFund/Validator/wiki/Management-APIs#personal_ecRecover 455 func (s *PrivateAccountAPI) EcRecover(ctx context.Context, data, sig hexutil.Bytes) (common.Address, error) { 456 if len(sig) != 65 { 457 return common.Address{}, fmt.Errorf("signature must be 65 bytes long") 458 } 459 if sig[64] != 27 && sig[64] != 28 { 460 return common.Address{}, fmt.Errorf("invalid Ethereum signature (V is not 27 or 28)") 461 } 462 sig[64] -= 27 // Transform yellow paper V from 27/28 to 0/1 463 464 rpk, err := crypto.SigToPub(signHash(data), sig) 465 if err != nil { 466 return common.Address{}, err 467 } 468 return crypto.PubkeyToAddress(*rpk), nil 469 } 470 471 // SignAndSendTransaction was renamed to SendTransaction. This method is deprecated 472 // and will be removed in the future. It primary goal is to give clients time to update. 473 func (s *PrivateAccountAPI) SignAndSendTransaction(ctx context.Context, args SendTxArgs, passwd string) (common.Hash, error) { 474 return s.SendTransaction(ctx, args, passwd) 475 } 476 477 // PublicBlockChainAPI provides an API to access the Ethereum blockchain. 478 // It offers only methods that operate on public data that is freely available to anyone. 479 type PublicBlockChainAPI struct { 480 b Backend 481 } 482 483 // NewPublicBlockChainAPI creates a new Ethereum blockchain API. 484 func NewPublicBlockChainAPI(b Backend) *PublicBlockChainAPI { 485 return &PublicBlockChainAPI{b} 486 } 487 488 // BlockNumber returns the block number of the chain head. 489 func (s *PublicBlockChainAPI) BlockNumber() hexutil.Uint64 { 490 header, _ := s.b.HeaderByNumber(context.Background(), rpc.LatestBlockNumber) // latest header should always be available 491 return hexutil.Uint64(header.Number.Uint64()) 492 } 493 494 // GetBalance returns the amount of wei for the given address in the state of the 495 // given block number. The rpc.LatestBlockNumber and rpc.PendingBlockNumber meta 496 // block numbers are also allowed. 497 func (s *PublicBlockChainAPI) GetBalance(ctx context.Context, address common.Address, blockNr rpc.BlockNumber) (*hexutil.Big, error) { 498 state, _, err := s.b.StateAndHeaderByNumber(ctx, blockNr) 499 if state == nil || err != nil { 500 return nil, err 501 } 502 return (*hexutil.Big)(state.GetBalance(address)), state.Error() 503 } 504 505 // GetBlockByNumber returns the requested block. When blockNr is -1 the chain head is returned. When fullTx is true all 506 // transactions in the block are returned in full detail, otherwise only the transaction hash is returned. 507 func (s *PublicBlockChainAPI) GetBlockByNumber(ctx context.Context, blockNr rpc.BlockNumber, fullTx bool) (map[string]interface{}, error) { 508 block, err := s.b.BlockByNumber(ctx, blockNr) 509 if block != nil { 510 response, err := s.rpcOutputBlock(block, true, fullTx) 511 if err == nil && blockNr == rpc.PendingBlockNumber { 512 // Pending blocks need to nil out a few fields 513 for _, field := range []string{"hash", "nonce", "miner"} { 514 response[field] = nil 515 } 516 } 517 return response, err 518 } 519 return nil, err 520 } 521 522 // GetBlockByHash returns the requested block. When fullTx is true all transactions in the block are returned in full 523 // detail, otherwise only the transaction hash is returned. 524 func (s *PublicBlockChainAPI) GetBlockByHash(ctx context.Context, blockHash common.Hash, fullTx bool) (map[string]interface{}, error) { 525 block, err := s.b.GetBlock(ctx, blockHash) 526 if block != nil { 527 return s.rpcOutputBlock(block, true, fullTx) 528 } 529 return nil, err 530 } 531 532 // GetUncleByBlockNumberAndIndex returns the uncle block for the given block hash and index. When fullTx is true 533 // all transactions in the block are returned in full detail, otherwise only the transaction hash is returned. 534 /*func (s *PublicBlockChainAPI) GetUncleByBlockNumberAndIndex(ctx context.Context, blockNr rpc.BlockNumber, index hexutil.Uint) (map[string]interface{}, error) { 535 block, err := s.b.BlockByNumber(ctx, blockNr) 536 if block != nil { 537 uncles := block.Uncles() 538 if index >= hexutil.Uint(len(uncles)) { 539 log.Debug("Requested uncle not found", "number", blockNr, "hash", block.Hash(), "index", index) 540 return nil, nil 541 } 542 block = types.NewBlockWithHeader(uncles[index]) 543 return s.rpcOutputBlock(block, false, false) 544 } 545 return nil, err 546 } 547 548 // GetUncleByBlockHashAndIndex returns the uncle block for the given block hash and index. When fullTx is true 549 // all transactions in the block are returned in full detail, otherwise only the transaction hash is returned. 550 func (s *PublicBlockChainAPI) GetUncleByBlockHashAndIndex(ctx context.Context, blockHash common.Hash, index hexutil.Uint) (map[string]interface{}, error) { 551 block, err := s.b.GetBlock(ctx, blockHash) 552 if block != nil { 553 uncles := block.Uncles() 554 if index >= hexutil.Uint(len(uncles)) { 555 log.Debug("Requested uncle not found", "number", block.Number(), "hash", blockHash, "index", index) 556 return nil, nil 557 } 558 block = types.NewBlockWithHeader(uncles[index]) 559 return s.rpcOutputBlock(block, false, false) 560 } 561 return nil, err 562 } 563 564 // GetUncleCountByBlockNumber returns number of uncles in the block for the given block number 565 func (s *PublicBlockChainAPI) GetUncleCountByBlockNumber(ctx context.Context, blockNr rpc.BlockNumber) *hexutil.Uint { 566 if block, _ := s.b.BlockByNumber(ctx, blockNr); block != nil { 567 n := hexutil.Uint(len(block.Uncles())) 568 return &n 569 } 570 return nil 571 } 572 573 // GetUncleCountByBlockHash returns number of uncles in the block for the given block hash 574 func (s *PublicBlockChainAPI) GetUncleCountByBlockHash(ctx context.Context, blockHash common.Hash) *hexutil.Uint { 575 if block, _ := s.b.GetBlock(ctx, blockHash); block != nil { 576 n := hexutil.Uint(len(block.Uncles())) 577 return &n 578 } 579 return nil 580 } 581 */ 582 583 // GetCode returns the code stored at the given address in the state for the given block number. 584 func (s *PublicBlockChainAPI) GetCode(ctx context.Context, address common.Address, blockNr rpc.BlockNumber) (hexutil.Bytes, error) { 585 state, _, err := s.b.StateAndHeaderByNumber(ctx, blockNr) 586 if state == nil || err != nil { 587 return nil, err 588 } 589 code := state.GetCode(address) 590 return code, state.Error() 591 } 592 593 // GetStorageAt returns the storage from the state at the given address, key and 594 // block number. The rpc.LatestBlockNumber and rpc.PendingBlockNumber meta block 595 // numbers are also allowed. 596 func (s *PublicBlockChainAPI) GetStorageAt(ctx context.Context, address common.Address, key string, blockNr rpc.BlockNumber) (hexutil.Bytes, error) { 597 state, _, err := s.b.StateAndHeaderByNumber(ctx, blockNr) 598 if state == nil || err != nil { 599 return nil, err 600 } 601 res := state.GetState(address, common.HexToHash(key)) 602 return res[:], state.Error() 603 } 604 605 // CallArgs represents the arguments for a call. 606 type CallArgs struct { 607 From common.Address `json:"from"` 608 To *common.Address `json:"to"` 609 Gas hexutil.Uint64 `json:"gas"` 610 GasPrice hexutil.Big `json:"gasPrice"` 611 Value hexutil.Big `json:"value"` 612 Data hexutil.Bytes `json:"data"` 613 } 614 615 func (s *PublicBlockChainAPI) doCall(ctx context.Context, args CallArgs, blockNr rpc.BlockNumber, vmCfg vm.Config, timeout time.Duration) ([]byte, uint64, bool, error) { 616 defer func(start time.Time) { log.Debug("Executing EVM call finished", "runtime", time.Since(start)) }(time.Now()) 617 618 state, header, err := s.b.StateAndHeaderByNumber(ctx, blockNr) 619 if state == nil || err != nil { 620 return nil, 0, false, err 621 } 622 // Set sender address or use a default if none specified 623 addr := args.From 624 if addr == (common.Address{}) { 625 if wallets := s.b.AccountManager().Wallets(); len(wallets) > 0 { 626 if accounts := wallets[0].Accounts(); len(accounts) > 0 { 627 addr = accounts[0].Address 628 } 629 } 630 } 631 // Set default gas & gas price if none were set 632 gas, gasPrice := uint64(args.Gas), args.GasPrice.ToInt() 633 if gas == 0 { 634 gas = math.MaxUint64 / 2 635 } 636 if gasPrice.Sign() == 0 { 637 gasPrice = new(big.Int).SetUint64(defaultGasPrice) 638 } 639 640 // Create new call message 641 msg := types.NewMessage(addr, args.To, 0, args.Value.ToInt(), gas, gasPrice, args.Data, false) 642 643 // Setup context so it may be cancelled the call has completed 644 // or, in case of unmetered gas, setup a context with a timeout. 645 var cancel context.CancelFunc 646 if timeout > 0 { 647 ctx, cancel = context.WithTimeout(ctx, timeout) 648 } else { 649 ctx, cancel = context.WithCancel(ctx) 650 } 651 // Make sure the context is cancelled when the call has completed 652 // this makes sure resources are cleaned up. 653 defer cancel() 654 655 // Get a new instance of the EVM. 656 evm, vmError, err := s.b.GetEVM(ctx, msg, state, header, vmCfg) 657 if err != nil { 658 return nil, 0, false, err 659 } 660 // Wait for the context to be done and cancel the evm. Even if the 661 // EVM has finished, cancelling may be done (repeatedly) 662 go func() { 663 <-ctx.Done() 664 evm.Cancel() 665 }() 666 667 // Setup the gas pool (also for unmetered requests) 668 // and apply the message. 669 gp := new(core.GasPool).AddGas(math.MaxUint64) 670 res, gas, failed, err := core.ApplyMessage(evm, msg, gp) 671 if err := vmError(); err != nil { 672 return nil, 0, false, err 673 } 674 return res, gas, failed, err 675 } 676 677 // Call executes the given transaction on the state for the given block number. 678 // It doesn't make and changes in the state/blockchain and is useful to execute and retrieve values. 679 func (s *PublicBlockChainAPI) Call(ctx context.Context, args CallArgs, blockNr rpc.BlockNumber) (hexutil.Bytes, error) { 680 result, _, _, err := s.doCall(ctx, args, blockNr, vm.Config{}, 5*time.Second) 681 return (hexutil.Bytes)(result), err 682 } 683 684 // EstimateGas returns an estimate of the amount of gas needed to execute the 685 // given transaction against the current pending block. 686 func (s *PublicBlockChainAPI) EstimateGas(ctx context.Context, args CallArgs) (hexutil.Uint64, error) { 687 // Binary search the gas requirement, as it may be higher than the amount used 688 var ( 689 lo uint64 = params.TxGas - 1 690 hi uint64 691 cap uint64 692 ) 693 if uint64(args.Gas) >= params.TxGas { 694 hi = uint64(args.Gas) 695 } else { 696 // Retrieve the current pending block to act as the gas ceiling 697 block, err := s.b.BlockByNumber(ctx, rpc.PendingBlockNumber) 698 if err != nil { 699 return 0, err 700 } 701 hi = block.GasLimit() 702 } 703 cap = hi 704 705 // Create a helper to check if a gas allowance results in an executable transaction 706 executable := func(gas uint64) bool { 707 args.Gas = hexutil.Uint64(gas) 708 709 _, _, failed, err := s.doCall(ctx, args, rpc.PendingBlockNumber, vm.Config{}, 0) 710 if err != nil || failed { 711 return false 712 } 713 return true 714 } 715 // Execute the binary search and hone in on an executable gas limit 716 for lo+1 < hi { 717 mid := (hi + lo) / 2 718 if !executable(mid) { 719 lo = mid 720 } else { 721 hi = mid 722 } 723 } 724 // Reject the transaction as invalid if it still fails at the highest allowance 725 if hi == cap { 726 if !executable(hi) { 727 return 0, fmt.Errorf("gas required exceeds allowance or always failing transaction") 728 } 729 } 730 return hexutil.Uint64(hi), nil 731 } 732 733 // ExecutionResult groups all structured logs emitted by the EVM 734 // while replaying a transaction in debug mode as well as transaction 735 // execution status, the amount of gas used and the return value 736 type ExecutionResult struct { 737 Gas uint64 `json:"gas"` 738 Failed bool `json:"failed"` 739 ReturnValue string `json:"returnValue"` 740 StructLogs []StructLogRes `json:"structLogs"` 741 } 742 743 // StructLogRes stores a structured log emitted by the EVM while replaying a 744 // transaction in debug mode 745 type StructLogRes struct { 746 Pc uint64 `json:"pc"` 747 Op string `json:"op"` 748 Gas uint64 `json:"gas"` 749 GasCost uint64 `json:"gasCost"` 750 Depth int `json:"depth"` 751 Error error `json:"error,omitempty"` 752 Stack *[]string `json:"stack,omitempty"` 753 Memory *[]string `json:"memory,omitempty"` 754 Storage *map[string]string `json:"storage,omitempty"` 755 } 756 757 // formatLogs formats EVM returned structured logs for json output 758 func FormatLogs(logs []vm.StructLog) []StructLogRes { 759 formatted := make([]StructLogRes, len(logs)) 760 for index, trace := range logs { 761 formatted[index] = StructLogRes{ 762 Pc: trace.Pc, 763 Op: trace.Op.String(), 764 Gas: trace.Gas, 765 GasCost: trace.GasCost, 766 Depth: trace.Depth, 767 Error: trace.Err, 768 } 769 if trace.Stack != nil { 770 stack := make([]string, len(trace.Stack)) 771 for i, stackValue := range trace.Stack { 772 stack[i] = fmt.Sprintf("%x", math.PaddedBigBytes(stackValue, 32)) 773 } 774 formatted[index].Stack = &stack 775 } 776 if trace.Memory != nil { 777 memory := make([]string, 0, (len(trace.Memory)+31)/32) 778 for i := 0; i+32 <= len(trace.Memory); i += 32 { 779 memory = append(memory, fmt.Sprintf("%x", trace.Memory[i:i+32])) 780 } 781 formatted[index].Memory = &memory 782 } 783 if trace.Storage != nil { 784 storage := make(map[string]string) 785 for i, storageValue := range trace.Storage { 786 storage[fmt.Sprintf("%x", i)] = fmt.Sprintf("%x", storageValue) 787 } 788 formatted[index].Storage = &storage 789 } 790 } 791 return formatted 792 } 793 794 // RPCMarshalBlock converts the given block to the RPC output which depends on fullTx. If inclTx is true transactions are 795 // returned. When fullTx is true the returned block contains full transaction details, otherwise it will only contain 796 // transaction hashes. 797 func RPCMarshalBlock(b *types.Block, inclTx bool, fullTx bool) (map[string]interface{}, error) { 798 head := b.Header() // copies the header once 799 fields := map[string]interface{}{ 800 "number": (*hexutil.Big)(head.Number), 801 "hash": b.Hash(), 802 "parentHash": head.ParentHash, 803 "nonce": head.Nonce, 804 "mixHash": head.MixDigest, 805 // "sha3Uncles": head.UncleHash, 806 "logsBloom": head.Bloom, 807 "stateRoot": head.Root, 808 "miner": head.Coinbase, 809 "difficulty": (*hexutil.Big)(head.Difficulty), 810 "extraData": hexutil.Bytes(head.Extra), 811 "size": hexutil.Uint64(b.Size()), 812 "gasLimit": hexutil.Uint64(head.GasLimit), 813 "gasUsed": hexutil.Uint64(head.GasUsed), 814 "timestamp": (*hexutil.Big)(head.Time), 815 "transactionsRoot": head.TxHash, 816 "receiptsRoot": head.ReceiptHash, 817 } 818 819 if inclTx { 820 formatTx := func(tx *types.Transaction) (interface{}, error) { 821 return tx.Hash(), nil 822 } 823 if fullTx { 824 formatTx = func(tx *types.Transaction) (interface{}, error) { 825 return newRPCTransactionFromBlockHash(b, tx.Hash()), nil 826 } 827 } 828 txs := b.Transactions() 829 transactions := make([]interface{}, len(txs)) 830 var err error 831 for i, tx := range txs { 832 if transactions[i], err = formatTx(tx); err != nil { 833 return nil, err 834 } 835 } 836 fields["transactions"] = transactions 837 } 838 839 /*uncles := b.Uncles() 840 uncleHashes := make([]common.Hash, len(uncles)) 841 for i, uncle := range uncles { 842 uncleHashes[i] = uncle.Hash() 843 } 844 fields["uncles"] = uncleHashes 845 */ 846 return fields, nil 847 } 848 849 // rpcOutputBlock uses the generalized output filler, then adds the total difficulty field, which requires 850 // a `PublicBlockchainAPI`. 851 func (s *PublicBlockChainAPI) rpcOutputBlock(b *types.Block, inclTx bool, fullTx bool) (map[string]interface{}, error) { 852 fields, err := RPCMarshalBlock(b, inclTx, fullTx) 853 if err != nil { 854 return nil, err 855 } 856 fields["totalDifficulty"] = (*hexutil.Big)(s.b.GetTd(b.Hash())) 857 return fields, err 858 } 859 860 // RPCTransaction represents a transaction that will serialize to the RPC representation of a transaction 861 type RPCTransaction struct { 862 BlockHash common.Hash `json:"blockHash"` 863 BlockNumber *hexutil.Big `json:"blockNumber"` 864 From common.Address `json:"from"` 865 Gas hexutil.Uint64 `json:"gas"` 866 GasPrice *hexutil.Big `json:"gasPrice"` 867 Hash common.Hash `json:"hash"` 868 Input hexutil.Bytes `json:"input"` 869 Nonce hexutil.Uint64 `json:"nonce"` 870 To *common.Address `json:"to"` 871 TransactionIndex hexutil.Uint `json:"transactionIndex"` 872 Value *hexutil.Big `json:"value"` 873 V *hexutil.Big `json:"v"` 874 R *hexutil.Big `json:"r"` 875 S *hexutil.Big `json:"s"` 876 } 877 878 // newRPCTransaction returns a transaction that will serialize to the RPC 879 // representation, with the given location metadata set (if available). 880 func newRPCTransaction(tx *types.Transaction, blockHash common.Hash, blockNumber uint64, index uint64) *RPCTransaction { 881 var signer types.Signer = types.FrontierSigner{} 882 if tx.Protected() { 883 signer = types.NewEIP155Signer(tx.ChainId()) 884 } 885 from, _ := types.Sender(signer, tx) 886 v, r, s := tx.RawSignatureValues() 887 888 result := &RPCTransaction{ 889 From: from, 890 Gas: hexutil.Uint64(tx.Gas()), 891 GasPrice: (*hexutil.Big)(tx.GasPrice()), 892 Hash: tx.Hash(), 893 Input: hexutil.Bytes(tx.Data()), 894 Nonce: hexutil.Uint64(tx.Nonce()), 895 To: tx.To(), 896 Value: (*hexutil.Big)(tx.Value()), 897 V: (*hexutil.Big)(v), 898 R: (*hexutil.Big)(r), 899 S: (*hexutil.Big)(s), 900 } 901 if blockHash != (common.Hash{}) { 902 result.BlockHash = blockHash 903 result.BlockNumber = (*hexutil.Big)(new(big.Int).SetUint64(blockNumber)) 904 result.TransactionIndex = hexutil.Uint(index) 905 } 906 return result 907 } 908 909 // newRPCPendingTransaction returns a pending transaction that will serialize to the RPC representation 910 func newRPCPendingTransaction(tx *types.Transaction) *RPCTransaction { 911 return newRPCTransaction(tx, common.Hash{}, 0, 0) 912 } 913 914 // newRPCTransactionFromBlockIndex returns a transaction that will serialize to the RPC representation. 915 func newRPCTransactionFromBlockIndex(b *types.Block, index uint64) *RPCTransaction { 916 txs := b.Transactions() 917 if index >= uint64(len(txs)) { 918 return nil 919 } 920 return newRPCTransaction(txs[index], b.Hash(), b.NumberU64(), index) 921 } 922 923 // newRPCRawTransactionFromBlockIndex returns the bytes of a transaction given a block and a transaction index. 924 func newRPCRawTransactionFromBlockIndex(b *types.Block, index uint64) hexutil.Bytes { 925 txs := b.Transactions() 926 if index >= uint64(len(txs)) { 927 return nil 928 } 929 blob, _ := rlp.EncodeToBytes(txs[index]) 930 return blob 931 } 932 933 // newRPCTransactionFromBlockHash returns a transaction that will serialize to the RPC representation. 934 func newRPCTransactionFromBlockHash(b *types.Block, hash common.Hash) *RPCTransaction { 935 for idx, tx := range b.Transactions() { 936 if tx.Hash() == hash { 937 return newRPCTransactionFromBlockIndex(b, uint64(idx)) 938 } 939 } 940 return nil 941 } 942 943 // PublicTransactionPoolAPI exposes methods for the RPC interface 944 type PublicTransactionPoolAPI struct { 945 b Backend 946 nonceLock *AddrLocker 947 } 948 949 // NewPublicTransactionPoolAPI creates a new RPC service with methods specific for the transaction pool. 950 func NewPublicTransactionPoolAPI(b Backend, nonceLock *AddrLocker) *PublicTransactionPoolAPI { 951 return &PublicTransactionPoolAPI{b, nonceLock} 952 } 953 954 // GetBlockTransactionCountByNumber returns the number of transactions in the block with the given block number. 955 func (s *PublicTransactionPoolAPI) GetBlockTransactionCountByNumber(ctx context.Context, blockNr rpc.BlockNumber) *hexutil.Uint { 956 if block, _ := s.b.BlockByNumber(ctx, blockNr); block != nil { 957 n := hexutil.Uint(len(block.Transactions())) 958 return &n 959 } 960 return nil 961 } 962 963 // GetBlockTransactionCountByHash returns the number of transactions in the block with the given hash. 964 func (s *PublicTransactionPoolAPI) GetBlockTransactionCountByHash(ctx context.Context, blockHash common.Hash) *hexutil.Uint { 965 if block, _ := s.b.GetBlock(ctx, blockHash); block != nil { 966 n := hexutil.Uint(len(block.Transactions())) 967 return &n 968 } 969 return nil 970 } 971 972 // GetTransactionByBlockNumberAndIndex returns the transaction for the given block number and index. 973 func (s *PublicTransactionPoolAPI) GetTransactionByBlockNumberAndIndex(ctx context.Context, blockNr rpc.BlockNumber, index hexutil.Uint) *RPCTransaction { 974 if block, _ := s.b.BlockByNumber(ctx, blockNr); block != nil { 975 return newRPCTransactionFromBlockIndex(block, uint64(index)) 976 } 977 return nil 978 } 979 980 // GetTransactionByBlockHashAndIndex returns the transaction for the given block hash and index. 981 func (s *PublicTransactionPoolAPI) GetTransactionByBlockHashAndIndex(ctx context.Context, blockHash common.Hash, index hexutil.Uint) *RPCTransaction { 982 if block, _ := s.b.GetBlock(ctx, blockHash); block != nil { 983 return newRPCTransactionFromBlockIndex(block, uint64(index)) 984 } 985 return nil 986 } 987 988 // GetRawTransactionByBlockNumberAndIndex returns the bytes of the transaction for the given block number and index. 989 func (s *PublicTransactionPoolAPI) GetRawTransactionByBlockNumberAndIndex(ctx context.Context, blockNr rpc.BlockNumber, index hexutil.Uint) hexutil.Bytes { 990 if block, _ := s.b.BlockByNumber(ctx, blockNr); block != nil { 991 return newRPCRawTransactionFromBlockIndex(block, uint64(index)) 992 } 993 return nil 994 } 995 996 // GetRawTransactionByBlockHashAndIndex returns the bytes of the transaction for the given block hash and index. 997 func (s *PublicTransactionPoolAPI) GetRawTransactionByBlockHashAndIndex(ctx context.Context, blockHash common.Hash, index hexutil.Uint) hexutil.Bytes { 998 if block, _ := s.b.GetBlock(ctx, blockHash); block != nil { 999 return newRPCRawTransactionFromBlockIndex(block, uint64(index)) 1000 } 1001 return nil 1002 } 1003 1004 // GetTransactionCount returns the number of transactions the given address has sent for the given block number 1005 func (s *PublicTransactionPoolAPI) GetTransactionCount(ctx context.Context, address common.Address, blockNr rpc.BlockNumber) (*hexutil.Uint64, error) { 1006 state, _, err := s.b.StateAndHeaderByNumber(ctx, blockNr) 1007 if state == nil || err != nil { 1008 return nil, err 1009 } 1010 nonce := state.GetNonce(address) 1011 return (*hexutil.Uint64)(&nonce), state.Error() 1012 } 1013 1014 // GetTransactionByHash returns the transaction for the given hash 1015 func (s *PublicTransactionPoolAPI) GetTransactionByHash(ctx context.Context, hash common.Hash) *RPCTransaction { 1016 // Try to return an already finalized transaction 1017 if tx,blockHash, _, blockNumber, index := rawdb.ReadTransaction(s.b.ChainDb(), hash); tx != nil { 1018 return newRPCTransaction(tx,blockHash, blockNumber, index) 1019 } 1020 // No finalized transaction, try to retrieve it from the pool 1021 if tx := s.b.GetPoolTransaction(hash); tx != nil { 1022 return newRPCPendingTransaction(tx) 1023 } 1024 // Transaction unknown, return as such 1025 return nil 1026 } 1027 1028 // GetRawTransactionByHash returns the bytes of the transaction for the given hash. 1029 func (s *PublicTransactionPoolAPI) GetRawTransactionByHash(ctx context.Context, hash common.Hash) (hexutil.Bytes, error) { 1030 var tx *types.Transaction 1031 1032 // Retrieve a finalized transaction, or a pooled otherwise 1033 if tx, _, _, _ , _ = rawdb.ReadTransaction(s.b.ChainDb(), hash); tx == nil { 1034 if tx = s.b.GetPoolTransaction(hash); tx == nil { 1035 // Transaction not found anywhere, abort 1036 return nil, nil 1037 } 1038 } 1039 // Serialize to RLP and return 1040 return rlp.EncodeToBytes(tx) 1041 } 1042 1043 // GetTransactionReceipt returns the transaction receipt for the given transaction hash. 1044 func (s *PublicTransactionPoolAPI) GetTransactionReceipt(ctx context.Context, hash common.Hash) (map[string]interface{}, error) { 1045 tx, blockHash, shardId,blockNumber, index := rawdb.ReadTransaction(s.b.ChainDb(), hash) 1046 if tx == nil { 1047 return nil, nil 1048 } 1049 receipts, err := s.b.GetReceipts(ctx, blockHash) 1050 if err != nil { 1051 return nil, err 1052 } 1053 if len(receipts) <= int(index) { 1054 return nil, nil 1055 } 1056 receipt := receipts[index] 1057 1058 var signer types.Signer = types.FrontierSigner{} 1059 if tx.Protected() { 1060 signer = types.NewEIP155Signer(tx.ChainId()) 1061 } 1062 from, _ := types.Sender(signer, tx) 1063 1064 fields := map[string]interface{}{ 1065 "shardId": shardId, 1066 "blockHash": blockHash, 1067 "blockNumber": hexutil.Uint64(blockNumber), 1068 "transactionHash": hash, 1069 "transactionIndex": hexutil.Uint64(index), 1070 "from": from, 1071 "to": tx.To(), 1072 "gasUsed": hexutil.Uint64(receipt.GasUsed), 1073 "cumulativeGasUsed": hexutil.Uint64(receipt.CumulativeGasUsed), 1074 "contractAddress": nil, 1075 //"logs": receipt.Logs, 1076 //"logsBloom": receipt.Bloom, 1077 } 1078 1079 // Assign receipt status or post state. 1080 if len(receipt.PostState) > 0 { 1081 fields["root"] = hexutil.Bytes(receipt.PostState) 1082 } else { 1083 fields["status"] = hexutil.Uint(receipt.Status) 1084 } 1085 //if receipt.Logs == nil { 1086 // fields["logs"] = [][]*types.Log{} 1087 //} 1088 // If the ContractAddress is 20 0x0 bytes, assume it is not a contract creation 1089 //if receipt.ContractAddress != (common.Address{}) { 1090 // fields["contractAddress"] = receipt.ContractAddress 1091 //} 1092 return fields, nil 1093 } 1094 1095 // sign is a helper function that signs a transaction with the private key of the given address. 1096 func (s *PublicTransactionPoolAPI) sign(addr common.Address, tx *types.Transaction) (*types.Transaction, error) { 1097 // Look up the wallet containing the requested signer 1098 account := accounts.Account{Address: addr} 1099 1100 wallet, err := s.b.AccountManager().Find(account) 1101 if err != nil { 1102 return nil, err 1103 } 1104 // Request the wallet to sign the transaction 1105 var chainID *big.Int 1106 if config := s.b.ChainConfig(); config.IsEIP155(s.b.CurrentBlock().Number()) { 1107 chainID = config.ChainID 1108 } 1109 return wallet.SignTx(account, tx, chainID) 1110 } 1111 1112 // SendTxArgs represents the arguments to sumbit a new transaction into the transaction pool. 1113 type SendTxArgs struct { 1114 From common.Address `json:"from"` 1115 To *common.Address `json:"to"` 1116 Gas *hexutil.Uint64 `json:"gas"` 1117 GasPrice *hexutil.Big `json:"gasPrice"` 1118 TokenId *hexutil.Uint64 `json:"tokenId"` 1119 Value *hexutil.Big `json:"value"` 1120 Nonce *hexutil.Uint64 `json:"nonce"` 1121 // We accept "data" and "input" for backwards-compatibility reasons. "input" is the 1122 // newer name and should be preferred by clients. 1123 Data *hexutil.Bytes `json:"data"` 1124 Input *hexutil.Bytes `json:"input"` 1125 } 1126 1127 // setDefaults is a helper function that fills in default values for unspecified tx fields. 1128 func (args *SendTxArgs) setDefaults(ctx context.Context, b Backend) error { 1129 if args.Gas == nil { 1130 args.Gas = new(hexutil.Uint64) 1131 *(*uint64)(args.Gas) = 90000 1132 } 1133 if args.GasPrice == nil { 1134 price, err := b.SuggestPrice(ctx) 1135 if err != nil { 1136 return err 1137 } 1138 args.GasPrice = (*hexutil.Big)(price) 1139 } 1140 if args.Value == nil { 1141 args.Value = new(hexutil.Big) 1142 } 1143 if args.Nonce == nil { 1144 nonce, err := b.GetPoolNonce(ctx, args.From) 1145 if err != nil { 1146 return err 1147 } 1148 args.Nonce = (*hexutil.Uint64)(&nonce) 1149 } 1150 if args.Data != nil && args.Input != nil && !bytes.Equal(*args.Data, *args.Input) { 1151 return errors.New(`Both "data" and "input" are set and not equal. Please use "input" to pass transaction call data.`) 1152 } 1153 if args.To == nil { 1154 // Contract creation 1155 var input []byte 1156 if args.Data != nil { 1157 input = *args.Data 1158 } else if args.Input != nil { 1159 input = *args.Input 1160 } 1161 if len(input) == 0 { 1162 return errors.New(`contract creation without any data provided`) 1163 } 1164 } 1165 return nil 1166 } 1167 1168 func (args *SendTxArgs) toTransaction() *types.Transaction { 1169 var input []byte 1170 if args.Data != nil { 1171 input = *args.Data 1172 } else if args.Input != nil { 1173 input = *args.Input 1174 } 1175 1176 //// MUST TODO change to call sc 1177 /* 1178 if args.To == nil { 1179 return types.NewContractCreation(uint64(*args.Nonce), (*big.Int)(args.Value), uint64(*args.Gas), (*big.Int)(args.GasPrice), input) 1180 } 1181 */ 1182 return types.NewTransaction(uint64(*args.Nonce), uint64(*args.TokenId), *args.To, (*big.Int)(args.Value), uint64(*args.Gas), (*big.Int)(args.GasPrice), input) 1183 } 1184 1185 // submitTransaction is a helper function that submits tx to txPool and logs a message. 1186 func submitTransaction(ctx context.Context, b Backend, tx *types.Transaction) (common.Hash, error) { 1187 if err := b.SendTx(ctx, tx); err != nil { 1188 return common.Hash{}, err 1189 } 1190 if tx.To() == nil { 1191 signer := types.MakeSigner(b.ChainConfig(), b.CurrentBlock().Number()) 1192 from, err := types.Sender(signer, tx) 1193 if err != nil { 1194 return common.Hash{}, err 1195 } 1196 addr := crypto.CreateAddress(from, tx.Nonce()) 1197 log.Info("Submitted contract creation", "fullhash", tx.Hash().Hex(), "contract", addr.Hex()) 1198 } else { 1199 log.Info("Submitted transaction", "fullhash", tx.Hash().Hex(), "recipient", tx.To()) 1200 } 1201 return tx.Hash(), nil 1202 } 1203 1204 // SendTransaction creates a transaction for the given argument, sign it and submit it to the 1205 // transaction pool. 1206 func (s *PublicTransactionPoolAPI) SendTransaction(ctx context.Context, args SendTxArgs) (common.Hash, error) { 1207 1208 // Look up the wallet containing the requested signer 1209 account := accounts.Account{Address: args.From} 1210 1211 wallet, err := s.b.AccountManager().Find(account) 1212 if err != nil { 1213 return common.Hash{}, err 1214 } 1215 1216 if args.Nonce == nil { 1217 // Hold the addresse's mutex around signing to prevent concurrent assignment of 1218 // the same nonce to multiple accounts. 1219 s.nonceLock.LockAddr(args.From) 1220 defer s.nonceLock.UnlockAddr(args.From) 1221 } 1222 1223 // Set some sanity defaults and terminate on failure 1224 if err := args.setDefaults(ctx, s.b); err != nil { 1225 return common.Hash{}, err 1226 } 1227 // Assemble the transaction and sign with the wallet 1228 tx := args.toTransaction() 1229 1230 var chainID *big.Int 1231 if config := s.b.ChainConfig(); config.IsEIP155(s.b.CurrentBlock().Number()) { 1232 chainID = config.ChainID 1233 } 1234 signed, err := wallet.SignTx(account, tx, chainID) 1235 if err != nil { 1236 return common.Hash{}, err 1237 } 1238 return submitTransaction(ctx, s.b, signed) 1239 } 1240 1241 // SendRawTransaction will add the signed transaction to the transaction pool. 1242 // The sender is responsible for signing the transaction and using the correct nonce. 1243 func (s *PublicTransactionPoolAPI) SendRawTransaction(ctx context.Context, encodedTx hexutil.Bytes) (common.Hash, error) { 1244 tx := new(types.Transaction) 1245 if err := rlp.DecodeBytes(encodedTx, tx); err != nil { 1246 return common.Hash{}, err 1247 } 1248 return submitTransaction(ctx, s.b, tx) 1249 } 1250 1251 // Sign calculates an ECDSA signature for: 1252 // keccack256("\x19Ethereum Signed Message:\n" + len(message) + message). 1253 // 1254 // Note, the produced signature conforms to the secp256k1 curve R, S and V values, 1255 // where the V value will be 27 or 28 for legacy reasons. 1256 // 1257 // The account associated with addr must be unlocked. 1258 // 1259 // https://github.com/ethereum/wiki/wiki/JSON-RPC#eth_sign 1260 func (s *PublicTransactionPoolAPI) Sign(addr common.Address, data hexutil.Bytes) (hexutil.Bytes, error) { 1261 // Look up the wallet containing the requested signer 1262 account := accounts.Account{Address: addr} 1263 1264 wallet, err := s.b.AccountManager().Find(account) 1265 if err != nil { 1266 return nil, err 1267 } 1268 // Sign the requested hash with the wallet 1269 signature, err := wallet.SignHash(account, signHash(data)) 1270 if err == nil { 1271 signature[64] += 27 // Transform V from 0/1 to 27/28 according to the yellow paper 1272 } 1273 return signature, err 1274 } 1275 1276 // SignTransactionResult represents a RLP encoded signed transaction. 1277 type SignTransactionResult struct { 1278 Raw hexutil.Bytes `json:"raw"` 1279 Tx *types.Transaction `json:"tx"` 1280 } 1281 1282 // SignTransaction will sign the given transaction with the from account. 1283 // The node needs to have the private key of the account corresponding with 1284 // the given from address and it needs to be unlocked. 1285 func (s *PublicTransactionPoolAPI) SignTransaction(ctx context.Context, args SendTxArgs) (*SignTransactionResult, error) { 1286 if args.Gas == nil { 1287 return nil, fmt.Errorf("gas not specified") 1288 } 1289 if args.GasPrice == nil { 1290 return nil, fmt.Errorf("gasPrice not specified") 1291 } 1292 if args.Nonce == nil { 1293 return nil, fmt.Errorf("nonce not specified") 1294 } 1295 if err := args.setDefaults(ctx, s.b); err != nil { 1296 return nil, err 1297 } 1298 tx, err := s.sign(args.From, args.toTransaction()) 1299 if err != nil { 1300 return nil, err 1301 } 1302 data, err := rlp.EncodeToBytes(tx) 1303 if err != nil { 1304 return nil, err 1305 } 1306 return &SignTransactionResult{data, tx}, nil 1307 } 1308 1309 // PendingTransactions returns the transactions that are in the transaction pool 1310 // and have a from address that is one of the accounts this node manages. 1311 func (s *PublicTransactionPoolAPI) PendingTransactions() ([]*RPCTransaction, error) { 1312 pending, err := s.b.GetPoolTransactions() 1313 if err != nil { 1314 return nil, err 1315 } 1316 accounts := make(map[common.Address]struct{}) 1317 for _, wallet := range s.b.AccountManager().Wallets() { 1318 for _, account := range wallet.Accounts() { 1319 accounts[account.Address] = struct{}{} 1320 } 1321 } 1322 transactions := make([]*RPCTransaction, 0, len(pending)) 1323 for _, tx := range pending { 1324 var signer types.Signer = types.HomesteadSigner{} 1325 if tx.Protected() { 1326 signer = types.NewEIP155Signer(tx.ChainId()) 1327 } 1328 from, _ := types.Sender(signer, tx) 1329 if _, exists := accounts[from]; exists { 1330 transactions = append(transactions, newRPCPendingTransaction(tx)) 1331 } 1332 } 1333 return transactions, nil 1334 } 1335 1336 // Resend accepts an existing transaction and a new gas price and limit. It will remove 1337 // the given transaction from the pool and reinsert it with the new gas price and limit. 1338 func (s *PublicTransactionPoolAPI) Resend(ctx context.Context, sendArgs SendTxArgs, gasPrice *hexutil.Big, gasLimit *hexutil.Uint64) (common.Hash, error) { 1339 if sendArgs.Nonce == nil { 1340 return common.Hash{}, fmt.Errorf("missing transaction nonce in transaction spec") 1341 } 1342 if err := sendArgs.setDefaults(ctx, s.b); err != nil { 1343 return common.Hash{}, err 1344 } 1345 matchTx := sendArgs.toTransaction() 1346 pending, err := s.b.GetPoolTransactions() 1347 if err != nil { 1348 return common.Hash{}, err 1349 } 1350 1351 for _, p := range pending { 1352 var signer types.Signer = types.HomesteadSigner{} 1353 if p.Protected() { 1354 signer = types.NewEIP155Signer(p.ChainId()) 1355 } 1356 wantSigHash := signer.Hash(matchTx) 1357 1358 if pFrom, err := types.Sender(signer, p); err == nil && pFrom == sendArgs.From && signer.Hash(p) == wantSigHash { 1359 // Match. Re-sign and send the transaction. 1360 if gasPrice != nil && (*big.Int)(gasPrice).Sign() != 0 { 1361 sendArgs.GasPrice = gasPrice 1362 } 1363 if gasLimit != nil && *gasLimit != 0 { 1364 sendArgs.Gas = gasLimit 1365 } 1366 signedTx, err := s.sign(sendArgs.From, sendArgs.toTransaction()) 1367 if err != nil { 1368 return common.Hash{}, err 1369 } 1370 if err = s.b.SendTx(ctx, signedTx); err != nil { 1371 return common.Hash{}, err 1372 } 1373 return signedTx.Hash(), nil 1374 } 1375 } 1376 1377 return common.Hash{}, fmt.Errorf("Transaction %#x not found", matchTx.Hash()) 1378 } 1379 1380 // PublicDebugAPI is the collection of Ethereum APIs exposed over the public 1381 // debugging endpoint. 1382 type PublicDebugAPI struct { 1383 b Backend 1384 } 1385 1386 // NewPublicDebugAPI creates a new API definition for the public debug methods 1387 // of the Ethereum service. 1388 func NewPublicDebugAPI(b Backend) *PublicDebugAPI { 1389 return &PublicDebugAPI{b: b} 1390 } 1391 1392 // GetBlockRlp retrieves the RLP encoded for of a single block. 1393 func (api *PublicDebugAPI) GetBlockRlp(ctx context.Context, number uint64) (string, error) { 1394 block, _ := api.b.BlockByNumber(ctx, rpc.BlockNumber(number)) 1395 if block == nil { 1396 return "", fmt.Errorf("block #%d not found", number) 1397 } 1398 encoded, err := rlp.EncodeToBytes(block) 1399 if err != nil { 1400 return "", err 1401 } 1402 return fmt.Sprintf("%x", encoded), nil 1403 } 1404 1405 // PrintBlock retrieves a block and returns its pretty printed form. 1406 func (api *PublicDebugAPI) PrintBlock(ctx context.Context, number uint64) (string, error) { 1407 block, _ := api.b.BlockByNumber(ctx, rpc.BlockNumber(number)) 1408 if block == nil { 1409 return "", fmt.Errorf("block #%d not found", number) 1410 } 1411 return spew.Sdump(block), nil 1412 } 1413 1414 // SeedHash retrieves the seed hash of a block. 1415 func (api *PublicDebugAPI) SeedHash(ctx context.Context, number uint64) (string, error) { 1416 block, _ := api.b.BlockByNumber(ctx, rpc.BlockNumber(number)) 1417 if block == nil { 1418 return "", fmt.Errorf("block #%d not found", number) 1419 } 1420 return fmt.Sprintf("0x%x", ethash.SeedHash(number)), nil 1421 } 1422 1423 // PrivateDebugAPI is the collection of Ethereum APIs exposed over the private 1424 // debugging endpoint. 1425 type PrivateDebugAPI struct { 1426 b Backend 1427 } 1428 1429 // NewPrivateDebugAPI creates a new API definition for the private debug methods 1430 // of the Ethereum service. 1431 func NewPrivateDebugAPI(b Backend) *PrivateDebugAPI { 1432 return &PrivateDebugAPI{b: b} 1433 } 1434 1435 // ChaindbProperty returns leveldb properties of the chain database. 1436 func (api *PrivateDebugAPI) ChaindbProperty(property string) (string, error) { 1437 ldb, ok := api.b.ChainDb().(interface { 1438 LDB() *leveldb.DB 1439 }) 1440 if !ok { 1441 return "", fmt.Errorf("chaindbProperty does not work for memory databases") 1442 } 1443 if property == "" { 1444 property = "leveldb.stats" 1445 } else if !strings.HasPrefix(property, "leveldb.") { 1446 property = "leveldb." + property 1447 } 1448 return ldb.LDB().GetProperty(property) 1449 } 1450 1451 func (api *PrivateDebugAPI) ChaindbCompact() error { 1452 ldb, ok := api.b.ChainDb().(interface { 1453 LDB() *leveldb.DB 1454 }) 1455 if !ok { 1456 return fmt.Errorf("chaindbCompact does not work for memory databases") 1457 } 1458 for b := byte(0); b < 255; b++ { 1459 log.Info("Compacting chain database", "range", fmt.Sprintf("0x%0.2X-0x%0.2X", b, b+1)) 1460 err := ldb.LDB().CompactRange(util.Range{Start: []byte{b}, Limit: []byte{b + 1}}) 1461 if err != nil { 1462 log.Error("Database compaction failed", "err", err) 1463 return err 1464 } 1465 } 1466 return nil 1467 } 1468 1469 // SetHead rewinds the head of the blockchain to a previous block. 1470 func (api *PrivateDebugAPI) SetHead(number hexutil.Uint64) { 1471 api.b.SetHead(uint64(number)) 1472 } 1473 1474 // PublicNetAPI offers network related RPC methods 1475 type PublicNetAPI struct { 1476 net *p2p.Server 1477 networkVersion uint64 1478 } 1479 1480 // NewPublicNetAPI creates a new net API instance. 1481 func NewPublicNetAPI(net *p2p.Server, networkVersion uint64) *PublicNetAPI { 1482 return &PublicNetAPI{net, networkVersion} 1483 } 1484 1485 // Listening returns an indication if the node is listening for network connections. 1486 func (s *PublicNetAPI) Listening() bool { 1487 return true // always listening 1488 } 1489 1490 // PeerCount returns the number of connected peers 1491 func (s *PublicNetAPI) PeerCount() hexutil.Uint { 1492 return hexutil.Uint(s.net.PeerCount()) 1493 } 1494 1495 // Version returns the current ethereum protocol version. 1496 func (s *PublicNetAPI) Version() string { 1497 return fmt.Sprintf("%d", s.networkVersion) 1498 }