github.com/Openstars/go-ethereum@v1.9.7/graphql/graphql.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 provides a GraphQL interface to Ethereum node data. 18 package graphql 19 20 import ( 21 "context" 22 "errors" 23 "time" 24 25 "github.com/ethereum/go-ethereum" 26 "github.com/ethereum/go-ethereum/common" 27 "github.com/ethereum/go-ethereum/common/hexutil" 28 "github.com/ethereum/go-ethereum/core/rawdb" 29 "github.com/ethereum/go-ethereum/core/state" 30 "github.com/ethereum/go-ethereum/core/types" 31 "github.com/ethereum/go-ethereum/core/vm" 32 "github.com/ethereum/go-ethereum/eth/filters" 33 "github.com/ethereum/go-ethereum/internal/ethapi" 34 "github.com/ethereum/go-ethereum/rlp" 35 "github.com/ethereum/go-ethereum/rpc" 36 ) 37 38 var ( 39 errBlockInvariant = errors.New("block objects must be instantiated with at least one of num or hash") 40 ) 41 42 // Account represents an Ethereum account at a particular block. 43 type Account struct { 44 backend ethapi.Backend 45 address common.Address 46 blockNrOrHash rpc.BlockNumberOrHash 47 } 48 49 // getState fetches the StateDB object for an account. 50 func (a *Account) getState(ctx context.Context) (*state.StateDB, error) { 51 state, _, err := a.backend.StateAndHeaderByNumberOrHash(ctx, a.blockNrOrHash) 52 return state, err 53 } 54 55 func (a *Account) Address(ctx context.Context) (common.Address, error) { 56 return a.address, nil 57 } 58 59 func (a *Account) Balance(ctx context.Context) (hexutil.Big, error) { 60 state, err := a.getState(ctx) 61 if err != nil { 62 return hexutil.Big{}, err 63 } 64 return hexutil.Big(*state.GetBalance(a.address)), nil 65 } 66 67 func (a *Account) TransactionCount(ctx context.Context) (hexutil.Uint64, error) { 68 state, err := a.getState(ctx) 69 if err != nil { 70 return 0, err 71 } 72 return hexutil.Uint64(state.GetNonce(a.address)), nil 73 } 74 75 func (a *Account) Code(ctx context.Context) (hexutil.Bytes, error) { 76 state, err := a.getState(ctx) 77 if err != nil { 78 return hexutil.Bytes{}, err 79 } 80 return hexutil.Bytes(state.GetCode(a.address)), nil 81 } 82 83 func (a *Account) Storage(ctx context.Context, args struct{ Slot common.Hash }) (common.Hash, error) { 84 state, err := a.getState(ctx) 85 if err != nil { 86 return common.Hash{}, err 87 } 88 return state.GetState(a.address, args.Slot), nil 89 } 90 91 // Log represents an individual log message. All arguments are mandatory. 92 type Log struct { 93 backend ethapi.Backend 94 transaction *Transaction 95 log *types.Log 96 } 97 98 func (l *Log) Transaction(ctx context.Context) *Transaction { 99 return l.transaction 100 } 101 102 func (l *Log) Account(ctx context.Context, args BlockNumberArgs) *Account { 103 return &Account{ 104 backend: l.backend, 105 address: l.log.Address, 106 blockNrOrHash: args.NumberOrLatest(), 107 } 108 } 109 110 func (l *Log) Index(ctx context.Context) int32 { 111 return int32(l.log.Index) 112 } 113 114 func (l *Log) Topics(ctx context.Context) []common.Hash { 115 return l.log.Topics 116 } 117 118 func (l *Log) Data(ctx context.Context) hexutil.Bytes { 119 return hexutil.Bytes(l.log.Data) 120 } 121 122 // Transaction represents an Ethereum transaction. 123 // backend and hash are mandatory; all others will be fetched when required. 124 type Transaction struct { 125 backend ethapi.Backend 126 hash common.Hash 127 tx *types.Transaction 128 block *Block 129 index uint64 130 } 131 132 // resolve returns the internal transaction object, fetching it if needed. 133 func (t *Transaction) resolve(ctx context.Context) (*types.Transaction, error) { 134 if t.tx == nil { 135 tx, blockHash, _, index := rawdb.ReadTransaction(t.backend.ChainDb(), t.hash) 136 if tx != nil { 137 t.tx = tx 138 blockNrOrHash := rpc.BlockNumberOrHashWithHash(blockHash, false) 139 t.block = &Block{ 140 backend: t.backend, 141 numberOrHash: &blockNrOrHash, 142 } 143 t.index = index 144 } else { 145 t.tx = t.backend.GetPoolTransaction(t.hash) 146 } 147 } 148 return t.tx, nil 149 } 150 151 func (t *Transaction) Hash(ctx context.Context) common.Hash { 152 return t.hash 153 } 154 155 func (t *Transaction) InputData(ctx context.Context) (hexutil.Bytes, error) { 156 tx, err := t.resolve(ctx) 157 if err != nil || tx == nil { 158 return hexutil.Bytes{}, err 159 } 160 return hexutil.Bytes(tx.Data()), nil 161 } 162 163 func (t *Transaction) Gas(ctx context.Context) (hexutil.Uint64, error) { 164 tx, err := t.resolve(ctx) 165 if err != nil || tx == nil { 166 return 0, err 167 } 168 return hexutil.Uint64(tx.Gas()), nil 169 } 170 171 func (t *Transaction) GasPrice(ctx context.Context) (hexutil.Big, error) { 172 tx, err := t.resolve(ctx) 173 if err != nil || tx == nil { 174 return hexutil.Big{}, err 175 } 176 return hexutil.Big(*tx.GasPrice()), nil 177 } 178 179 func (t *Transaction) Value(ctx context.Context) (hexutil.Big, error) { 180 tx, err := t.resolve(ctx) 181 if err != nil || tx == nil { 182 return hexutil.Big{}, err 183 } 184 return hexutil.Big(*tx.Value()), nil 185 } 186 187 func (t *Transaction) Nonce(ctx context.Context) (hexutil.Uint64, error) { 188 tx, err := t.resolve(ctx) 189 if err != nil || tx == nil { 190 return 0, err 191 } 192 return hexutil.Uint64(tx.Nonce()), nil 193 } 194 195 func (t *Transaction) To(ctx context.Context, args BlockNumberArgs) (*Account, error) { 196 tx, err := t.resolve(ctx) 197 if err != nil || tx == nil { 198 return nil, err 199 } 200 to := tx.To() 201 if to == nil { 202 return nil, nil 203 } 204 return &Account{ 205 backend: t.backend, 206 address: *to, 207 blockNrOrHash: args.NumberOrLatest(), 208 }, nil 209 } 210 211 func (t *Transaction) From(ctx context.Context, args BlockNumberArgs) (*Account, error) { 212 tx, err := t.resolve(ctx) 213 if err != nil || tx == nil { 214 return nil, err 215 } 216 var signer types.Signer = types.HomesteadSigner{} 217 if tx.Protected() { 218 signer = types.NewEIP155Signer(tx.ChainId()) 219 } 220 from, _ := types.Sender(signer, tx) 221 222 return &Account{ 223 backend: t.backend, 224 address: from, 225 blockNrOrHash: args.NumberOrLatest(), 226 }, nil 227 } 228 229 func (t *Transaction) Block(ctx context.Context) (*Block, error) { 230 if _, err := t.resolve(ctx); err != nil { 231 return nil, err 232 } 233 return t.block, nil 234 } 235 236 func (t *Transaction) Index(ctx context.Context) (*int32, error) { 237 if _, err := t.resolve(ctx); err != nil { 238 return nil, err 239 } 240 if t.block == nil { 241 return nil, nil 242 } 243 index := int32(t.index) 244 return &index, nil 245 } 246 247 // getReceipt returns the receipt associated with this transaction, if any. 248 func (t *Transaction) getReceipt(ctx context.Context) (*types.Receipt, error) { 249 if _, err := t.resolve(ctx); err != nil { 250 return nil, err 251 } 252 if t.block == nil { 253 return nil, nil 254 } 255 receipts, err := t.block.resolveReceipts(ctx) 256 if err != nil { 257 return nil, err 258 } 259 return receipts[t.index], nil 260 } 261 262 func (t *Transaction) Status(ctx context.Context) (*hexutil.Uint64, error) { 263 receipt, err := t.getReceipt(ctx) 264 if err != nil || receipt == nil { 265 return nil, err 266 } 267 ret := hexutil.Uint64(receipt.Status) 268 return &ret, nil 269 } 270 271 func (t *Transaction) GasUsed(ctx context.Context) (*hexutil.Uint64, error) { 272 receipt, err := t.getReceipt(ctx) 273 if err != nil || receipt == nil { 274 return nil, err 275 } 276 ret := hexutil.Uint64(receipt.GasUsed) 277 return &ret, nil 278 } 279 280 func (t *Transaction) CumulativeGasUsed(ctx context.Context) (*hexutil.Uint64, error) { 281 receipt, err := t.getReceipt(ctx) 282 if err != nil || receipt == nil { 283 return nil, err 284 } 285 ret := hexutil.Uint64(receipt.CumulativeGasUsed) 286 return &ret, nil 287 } 288 289 func (t *Transaction) CreatedContract(ctx context.Context, args BlockNumberArgs) (*Account, error) { 290 receipt, err := t.getReceipt(ctx) 291 if err != nil || receipt == nil || receipt.ContractAddress == (common.Address{}) { 292 return nil, err 293 } 294 return &Account{ 295 backend: t.backend, 296 address: receipt.ContractAddress, 297 blockNrOrHash: args.NumberOrLatest(), 298 }, nil 299 } 300 301 func (t *Transaction) Logs(ctx context.Context) (*[]*Log, error) { 302 receipt, err := t.getReceipt(ctx) 303 if err != nil || receipt == nil { 304 return nil, err 305 } 306 ret := make([]*Log, 0, len(receipt.Logs)) 307 for _, log := range receipt.Logs { 308 ret = append(ret, &Log{ 309 backend: t.backend, 310 transaction: t, 311 log: log, 312 }) 313 } 314 return &ret, nil 315 } 316 317 type BlockType int 318 319 // Block represents an Ethereum block. 320 // backend, and numberOrHash are mandatory. All other fields are lazily fetched 321 // when required. 322 type Block struct { 323 backend ethapi.Backend 324 numberOrHash *rpc.BlockNumberOrHash 325 hash common.Hash 326 header *types.Header 327 block *types.Block 328 receipts []*types.Receipt 329 } 330 331 // resolve returns the internal Block object representing this block, fetching 332 // it if necessary. 333 func (b *Block) resolve(ctx context.Context) (*types.Block, error) { 334 if b.block != nil { 335 return b.block, nil 336 } 337 if b.numberOrHash == nil { 338 latest := rpc.BlockNumberOrHashWithNumber(rpc.LatestBlockNumber) 339 b.numberOrHash = &latest 340 } 341 var err error 342 b.block, err = b.backend.BlockByNumberOrHash(ctx, *b.numberOrHash) 343 if b.block != nil && b.header == nil { 344 b.header = b.block.Header() 345 if hash, ok := b.numberOrHash.Hash(); ok { 346 b.hash = hash 347 } 348 } 349 return b.block, err 350 } 351 352 // resolveHeader returns the internal Header object for this block, fetching it 353 // if necessary. Call this function instead of `resolve` unless you need the 354 // additional data (transactions and uncles). 355 func (b *Block) resolveHeader(ctx context.Context) (*types.Header, error) { 356 if b.numberOrHash == nil && b.hash == (common.Hash{}) { 357 return nil, errBlockInvariant 358 } 359 var err error 360 if b.header == nil { 361 if b.hash != (common.Hash{}) { 362 b.header, err = b.backend.HeaderByHash(ctx, b.hash) 363 } else { 364 b.header, err = b.backend.HeaderByNumberOrHash(ctx, *b.numberOrHash) 365 } 366 } 367 return b.header, err 368 } 369 370 // resolveReceipts returns the list of receipts for this block, fetching them 371 // if necessary. 372 func (b *Block) resolveReceipts(ctx context.Context) ([]*types.Receipt, error) { 373 if b.receipts == nil { 374 hash := b.hash 375 if hash == (common.Hash{}) { 376 header, err := b.resolveHeader(ctx) 377 if err != nil { 378 return nil, err 379 } 380 hash = header.Hash() 381 } 382 receipts, err := b.backend.GetReceipts(ctx, hash) 383 if err != nil { 384 return nil, err 385 } 386 b.receipts = []*types.Receipt(receipts) 387 } 388 return b.receipts, nil 389 } 390 391 func (b *Block) Number(ctx context.Context) (hexutil.Uint64, error) { 392 header, err := b.resolveHeader(ctx) 393 if err != nil { 394 return 0, err 395 } 396 397 return hexutil.Uint64(header.Number.Uint64()), nil 398 } 399 400 func (b *Block) Hash(ctx context.Context) (common.Hash, error) { 401 if b.hash == (common.Hash{}) { 402 header, err := b.resolveHeader(ctx) 403 if err != nil { 404 return common.Hash{}, err 405 } 406 b.hash = header.Hash() 407 } 408 return b.hash, nil 409 } 410 411 func (b *Block) GasLimit(ctx context.Context) (hexutil.Uint64, error) { 412 header, err := b.resolveHeader(ctx) 413 if err != nil { 414 return 0, err 415 } 416 return hexutil.Uint64(header.GasLimit), nil 417 } 418 419 func (b *Block) GasUsed(ctx context.Context) (hexutil.Uint64, error) { 420 header, err := b.resolveHeader(ctx) 421 if err != nil { 422 return 0, err 423 } 424 return hexutil.Uint64(header.GasUsed), nil 425 } 426 427 func (b *Block) Parent(ctx context.Context) (*Block, error) { 428 // If the block header hasn't been fetched, and we'll need it, fetch it. 429 if b.numberOrHash == nil && b.header == nil { 430 if _, err := b.resolveHeader(ctx); err != nil { 431 return nil, err 432 } 433 } 434 if b.header != nil && b.header.Number.Uint64() > 0 { 435 num := rpc.BlockNumberOrHashWithNumber(rpc.BlockNumber(b.header.Number.Uint64() - 1)) 436 return &Block{ 437 backend: b.backend, 438 numberOrHash: &num, 439 hash: b.header.ParentHash, 440 }, nil 441 } 442 return nil, nil 443 } 444 445 func (b *Block) Difficulty(ctx context.Context) (hexutil.Big, error) { 446 header, err := b.resolveHeader(ctx) 447 if err != nil { 448 return hexutil.Big{}, err 449 } 450 return hexutil.Big(*header.Difficulty), nil 451 } 452 453 func (b *Block) Timestamp(ctx context.Context) (hexutil.Uint64, error) { 454 header, err := b.resolveHeader(ctx) 455 if err != nil { 456 return 0, err 457 } 458 return hexutil.Uint64(header.Time), nil 459 } 460 461 func (b *Block) Nonce(ctx context.Context) (hexutil.Bytes, error) { 462 header, err := b.resolveHeader(ctx) 463 if err != nil { 464 return hexutil.Bytes{}, err 465 } 466 return hexutil.Bytes(header.Nonce[:]), nil 467 } 468 469 func (b *Block) MixHash(ctx context.Context) (common.Hash, error) { 470 header, err := b.resolveHeader(ctx) 471 if err != nil { 472 return common.Hash{}, err 473 } 474 return header.MixDigest, nil 475 } 476 477 func (b *Block) TransactionsRoot(ctx context.Context) (common.Hash, error) { 478 header, err := b.resolveHeader(ctx) 479 if err != nil { 480 return common.Hash{}, err 481 } 482 return header.TxHash, nil 483 } 484 485 func (b *Block) StateRoot(ctx context.Context) (common.Hash, error) { 486 header, err := b.resolveHeader(ctx) 487 if err != nil { 488 return common.Hash{}, err 489 } 490 return header.Root, nil 491 } 492 493 func (b *Block) ReceiptsRoot(ctx context.Context) (common.Hash, error) { 494 header, err := b.resolveHeader(ctx) 495 if err != nil { 496 return common.Hash{}, err 497 } 498 return header.ReceiptHash, nil 499 } 500 501 func (b *Block) OmmerHash(ctx context.Context) (common.Hash, error) { 502 header, err := b.resolveHeader(ctx) 503 if err != nil { 504 return common.Hash{}, err 505 } 506 return header.UncleHash, nil 507 } 508 509 func (b *Block) OmmerCount(ctx context.Context) (*int32, error) { 510 block, err := b.resolve(ctx) 511 if err != nil || block == nil { 512 return nil, err 513 } 514 count := int32(len(block.Uncles())) 515 return &count, err 516 } 517 518 func (b *Block) Ommers(ctx context.Context) (*[]*Block, error) { 519 block, err := b.resolve(ctx) 520 if err != nil || block == nil { 521 return nil, err 522 } 523 ret := make([]*Block, 0, len(block.Uncles())) 524 for _, uncle := range block.Uncles() { 525 blockNumberOrHash := rpc.BlockNumberOrHashWithHash(uncle.Hash(), false) 526 ret = append(ret, &Block{ 527 backend: b.backend, 528 numberOrHash: &blockNumberOrHash, 529 header: uncle, 530 }) 531 } 532 return &ret, nil 533 } 534 535 func (b *Block) ExtraData(ctx context.Context) (hexutil.Bytes, error) { 536 header, err := b.resolveHeader(ctx) 537 if err != nil { 538 return hexutil.Bytes{}, err 539 } 540 return hexutil.Bytes(header.Extra), nil 541 } 542 543 func (b *Block) LogsBloom(ctx context.Context) (hexutil.Bytes, error) { 544 header, err := b.resolveHeader(ctx) 545 if err != nil { 546 return hexutil.Bytes{}, err 547 } 548 return hexutil.Bytes(header.Bloom.Bytes()), nil 549 } 550 551 func (b *Block) TotalDifficulty(ctx context.Context) (hexutil.Big, error) { 552 h := b.hash 553 if h == (common.Hash{}) { 554 header, err := b.resolveHeader(ctx) 555 if err != nil { 556 return hexutil.Big{}, err 557 } 558 h = header.Hash() 559 } 560 return hexutil.Big(*b.backend.GetTd(h)), nil 561 } 562 563 // BlockNumberArgs encapsulates arguments to accessors that specify a block number. 564 type BlockNumberArgs struct { 565 // TODO: Ideally we could use input unions to allow the query to specify the 566 // block parameter by hash, block number, or tag but input unions aren't part of the 567 // standard GraphQL schema SDL yet, see: https://github.com/graphql/graphql-spec/issues/488 568 Block *hexutil.Uint64 569 } 570 571 // NumberOr returns the provided block number argument, or the "current" block number or hash if none 572 // was provided. 573 func (a BlockNumberArgs) NumberOr(current rpc.BlockNumberOrHash) rpc.BlockNumberOrHash { 574 if a.Block != nil { 575 blockNr := rpc.BlockNumber(*a.Block) 576 return rpc.BlockNumberOrHashWithNumber(blockNr) 577 } 578 return current 579 } 580 581 // NumberOrLatest returns the provided block number argument, or the "latest" block number if none 582 // was provided. 583 func (a BlockNumberArgs) NumberOrLatest() rpc.BlockNumberOrHash { 584 return a.NumberOr(rpc.BlockNumberOrHashWithNumber(rpc.LatestBlockNumber)) 585 } 586 587 func (b *Block) Miner(ctx context.Context, args BlockNumberArgs) (*Account, error) { 588 header, err := b.resolveHeader(ctx) 589 if err != nil { 590 return nil, err 591 } 592 return &Account{ 593 backend: b.backend, 594 address: header.Coinbase, 595 blockNrOrHash: args.NumberOrLatest(), 596 }, nil 597 } 598 599 func (b *Block) TransactionCount(ctx context.Context) (*int32, error) { 600 block, err := b.resolve(ctx) 601 if err != nil || block == nil { 602 return nil, err 603 } 604 count := int32(len(block.Transactions())) 605 return &count, err 606 } 607 608 func (b *Block) Transactions(ctx context.Context) (*[]*Transaction, error) { 609 block, err := b.resolve(ctx) 610 if err != nil || block == nil { 611 return nil, err 612 } 613 ret := make([]*Transaction, 0, len(block.Transactions())) 614 for i, tx := range block.Transactions() { 615 ret = append(ret, &Transaction{ 616 backend: b.backend, 617 hash: tx.Hash(), 618 tx: tx, 619 block: b, 620 index: uint64(i), 621 }) 622 } 623 return &ret, nil 624 } 625 626 func (b *Block) TransactionAt(ctx context.Context, args struct{ Index int32 }) (*Transaction, error) { 627 block, err := b.resolve(ctx) 628 if err != nil || block == nil { 629 return nil, err 630 } 631 txs := block.Transactions() 632 if args.Index < 0 || int(args.Index) >= len(txs) { 633 return nil, nil 634 } 635 tx := txs[args.Index] 636 return &Transaction{ 637 backend: b.backend, 638 hash: tx.Hash(), 639 tx: tx, 640 block: b, 641 index: uint64(args.Index), 642 }, nil 643 } 644 645 func (b *Block) OmmerAt(ctx context.Context, args struct{ Index int32 }) (*Block, error) { 646 block, err := b.resolve(ctx) 647 if err != nil || block == nil { 648 return nil, err 649 } 650 uncles := block.Uncles() 651 if args.Index < 0 || int(args.Index) >= len(uncles) { 652 return nil, nil 653 } 654 uncle := uncles[args.Index] 655 blockNumberOrHash := rpc.BlockNumberOrHashWithHash(uncle.Hash(), false) 656 return &Block{ 657 backend: b.backend, 658 numberOrHash: &blockNumberOrHash, 659 header: uncle, 660 }, nil 661 } 662 663 // BlockFilterCriteria encapsulates criteria passed to a `logs` accessor inside 664 // a block. 665 type BlockFilterCriteria struct { 666 Addresses *[]common.Address // restricts matches to events created by specific contracts 667 668 // The Topic list restricts matches to particular event topics. Each event has a list 669 // of topics. Topics matches a prefix of that list. An empty element slice matches any 670 // topic. Non-empty elements represent an alternative that matches any of the 671 // contained topics. 672 // 673 // Examples: 674 // {} or nil matches any topic list 675 // {{A}} matches topic A in first position 676 // {{}, {B}} matches any topic in first position, B in second position 677 // {{A}, {B}} matches topic A in first position, B in second position 678 // {{A, B}}, {C, D}} matches topic (A OR B) in first position, (C OR D) in second position 679 Topics *[][]common.Hash 680 } 681 682 // runFilter accepts a filter and executes it, returning all its results as 683 // `Log` objects. 684 func runFilter(ctx context.Context, be ethapi.Backend, filter *filters.Filter) ([]*Log, error) { 685 logs, err := filter.Logs(ctx) 686 if err != nil || logs == nil { 687 return nil, err 688 } 689 ret := make([]*Log, 0, len(logs)) 690 for _, log := range logs { 691 ret = append(ret, &Log{ 692 backend: be, 693 transaction: &Transaction{backend: be, hash: log.TxHash}, 694 log: log, 695 }) 696 } 697 return ret, nil 698 } 699 700 func (b *Block) Logs(ctx context.Context, args struct{ Filter BlockFilterCriteria }) ([]*Log, error) { 701 var addresses []common.Address 702 if args.Filter.Addresses != nil { 703 addresses = *args.Filter.Addresses 704 } 705 var topics [][]common.Hash 706 if args.Filter.Topics != nil { 707 topics = *args.Filter.Topics 708 } 709 hash := b.hash 710 if hash == (common.Hash{}) { 711 header, err := b.resolveHeader(ctx) 712 if err != nil { 713 return nil, err 714 } 715 hash = header.Hash() 716 } 717 // Construct the range filter 718 filter := filters.NewBlockFilter(b.backend, hash, addresses, topics) 719 720 // Run the filter and return all the logs 721 return runFilter(ctx, b.backend, filter) 722 } 723 724 func (b *Block) Account(ctx context.Context, args struct { 725 Address common.Address 726 }) (*Account, error) { 727 if b.numberOrHash == nil { 728 _, err := b.resolveHeader(ctx) 729 if err != nil { 730 return nil, err 731 } 732 } 733 return &Account{ 734 backend: b.backend, 735 address: args.Address, 736 blockNrOrHash: *b.numberOrHash, 737 }, nil 738 } 739 740 // CallData encapsulates arguments to `call` or `estimateGas`. 741 // All arguments are optional. 742 type CallData struct { 743 From *common.Address // The Ethereum address the call is from. 744 To *common.Address // The Ethereum address the call is to. 745 Gas *hexutil.Uint64 // The amount of gas provided for the call. 746 GasPrice *hexutil.Big // The price of each unit of gas, in wei. 747 Value *hexutil.Big // The value sent along with the call. 748 Data *hexutil.Bytes // Any data sent with the call. 749 } 750 751 // CallResult encapsulates the result of an invocation of the `call` accessor. 752 type CallResult struct { 753 data hexutil.Bytes // The return data from the call 754 gasUsed hexutil.Uint64 // The amount of gas used 755 status hexutil.Uint64 // The return status of the call - 0 for failure or 1 for success. 756 } 757 758 func (c *CallResult) Data() hexutil.Bytes { 759 return c.data 760 } 761 762 func (c *CallResult) GasUsed() hexutil.Uint64 { 763 return c.gasUsed 764 } 765 766 func (c *CallResult) Status() hexutil.Uint64 { 767 return c.status 768 } 769 770 func (b *Block) Call(ctx context.Context, args struct { 771 Data ethapi.CallArgs 772 }) (*CallResult, error) { 773 if b.numberOrHash == nil { 774 _, err := b.resolve(ctx) 775 if err != nil { 776 return nil, err 777 } 778 } 779 result, gas, failed, err := ethapi.DoCall(ctx, b.backend, args.Data, *b.numberOrHash, nil, vm.Config{}, 5*time.Second, b.backend.RPCGasCap()) 780 status := hexutil.Uint64(1) 781 if failed { 782 status = 0 783 } 784 return &CallResult{ 785 data: hexutil.Bytes(result), 786 gasUsed: hexutil.Uint64(gas), 787 status: status, 788 }, err 789 } 790 791 func (b *Block) EstimateGas(ctx context.Context, args struct { 792 Data ethapi.CallArgs 793 }) (hexutil.Uint64, error) { 794 if b.numberOrHash == nil { 795 _, err := b.resolveHeader(ctx) 796 if err != nil { 797 return hexutil.Uint64(0), err 798 } 799 } 800 gas, err := ethapi.DoEstimateGas(ctx, b.backend, args.Data, *b.numberOrHash, b.backend.RPCGasCap()) 801 return gas, err 802 } 803 804 type Pending struct { 805 backend ethapi.Backend 806 } 807 808 func (p *Pending) TransactionCount(ctx context.Context) (int32, error) { 809 txs, err := p.backend.GetPoolTransactions() 810 return int32(len(txs)), err 811 } 812 813 func (p *Pending) Transactions(ctx context.Context) (*[]*Transaction, error) { 814 txs, err := p.backend.GetPoolTransactions() 815 if err != nil { 816 return nil, err 817 } 818 ret := make([]*Transaction, 0, len(txs)) 819 for i, tx := range txs { 820 ret = append(ret, &Transaction{ 821 backend: p.backend, 822 hash: tx.Hash(), 823 tx: tx, 824 index: uint64(i), 825 }) 826 } 827 return &ret, nil 828 } 829 830 func (p *Pending) Account(ctx context.Context, args struct { 831 Address common.Address 832 }) *Account { 833 pendingBlockNr := rpc.BlockNumberOrHashWithNumber(rpc.PendingBlockNumber) 834 return &Account{ 835 backend: p.backend, 836 address: args.Address, 837 blockNrOrHash: pendingBlockNr, 838 } 839 } 840 841 func (p *Pending) Call(ctx context.Context, args struct { 842 Data ethapi.CallArgs 843 }) (*CallResult, error) { 844 pendingBlockNr := rpc.BlockNumberOrHashWithNumber(rpc.PendingBlockNumber) 845 result, gas, failed, err := ethapi.DoCall(ctx, p.backend, args.Data, pendingBlockNr, nil, vm.Config{}, 5*time.Second, p.backend.RPCGasCap()) 846 status := hexutil.Uint64(1) 847 if failed { 848 status = 0 849 } 850 return &CallResult{ 851 data: hexutil.Bytes(result), 852 gasUsed: hexutil.Uint64(gas), 853 status: status, 854 }, err 855 } 856 857 func (p *Pending) EstimateGas(ctx context.Context, args struct { 858 Data ethapi.CallArgs 859 }) (hexutil.Uint64, error) { 860 pendingBlockNr := rpc.BlockNumberOrHashWithNumber(rpc.PendingBlockNumber) 861 return ethapi.DoEstimateGas(ctx, p.backend, args.Data, pendingBlockNr, p.backend.RPCGasCap()) 862 } 863 864 // Resolver is the top-level object in the GraphQL hierarchy. 865 type Resolver struct { 866 backend ethapi.Backend 867 } 868 869 func (r *Resolver) Block(ctx context.Context, args struct { 870 Number *hexutil.Uint64 871 Hash *common.Hash 872 }) (*Block, error) { 873 var block *Block 874 if args.Number != nil { 875 number := rpc.BlockNumber(uint64(*args.Number)) 876 numberOrHash := rpc.BlockNumberOrHashWithNumber(number) 877 block = &Block{ 878 backend: r.backend, 879 numberOrHash: &numberOrHash, 880 } 881 } else if args.Hash != nil { 882 numberOrHash := rpc.BlockNumberOrHashWithHash(*args.Hash, false) 883 block = &Block{ 884 backend: r.backend, 885 numberOrHash: &numberOrHash, 886 } 887 } else { 888 numberOrHash := rpc.BlockNumberOrHashWithNumber(rpc.LatestBlockNumber) 889 block = &Block{ 890 backend: r.backend, 891 numberOrHash: &numberOrHash, 892 } 893 } 894 // Resolve the header, return nil if it doesn't exist. 895 // Note we don't resolve block directly here since it will require an 896 // additional network request for light client. 897 h, err := block.resolveHeader(ctx) 898 if err != nil { 899 return nil, err 900 } else if h == nil { 901 return nil, nil 902 } 903 return block, nil 904 } 905 906 func (r *Resolver) Blocks(ctx context.Context, args struct { 907 From hexutil.Uint64 908 To *hexutil.Uint64 909 }) ([]*Block, error) { 910 from := rpc.BlockNumber(args.From) 911 912 var to rpc.BlockNumber 913 if args.To != nil { 914 to = rpc.BlockNumber(*args.To) 915 } else { 916 to = rpc.BlockNumber(r.backend.CurrentBlock().Number().Int64()) 917 } 918 if to < from { 919 return []*Block{}, nil 920 } 921 ret := make([]*Block, 0, to-from+1) 922 for i := from; i <= to; i++ { 923 numberOrHash := rpc.BlockNumberOrHashWithNumber(i) 924 ret = append(ret, &Block{ 925 backend: r.backend, 926 numberOrHash: &numberOrHash, 927 }) 928 } 929 return ret, nil 930 } 931 932 func (r *Resolver) Pending(ctx context.Context) *Pending { 933 return &Pending{r.backend} 934 } 935 936 func (r *Resolver) Transaction(ctx context.Context, args struct{ Hash common.Hash }) (*Transaction, error) { 937 tx := &Transaction{ 938 backend: r.backend, 939 hash: args.Hash, 940 } 941 // Resolve the transaction; if it doesn't exist, return nil. 942 t, err := tx.resolve(ctx) 943 if err != nil { 944 return nil, err 945 } else if t == nil { 946 return nil, nil 947 } 948 return tx, nil 949 } 950 951 func (r *Resolver) SendRawTransaction(ctx context.Context, args struct{ Data hexutil.Bytes }) (common.Hash, error) { 952 tx := new(types.Transaction) 953 if err := rlp.DecodeBytes(args.Data, tx); err != nil { 954 return common.Hash{}, err 955 } 956 hash, err := ethapi.SubmitTransaction(ctx, r.backend, tx) 957 return hash, err 958 } 959 960 // FilterCriteria encapsulates the arguments to `logs` on the root resolver object. 961 type FilterCriteria struct { 962 FromBlock *hexutil.Uint64 // beginning of the queried range, nil means genesis block 963 ToBlock *hexutil.Uint64 // end of the range, nil means latest block 964 Addresses *[]common.Address // restricts matches to events created by specific contracts 965 966 // The Topic list restricts matches to particular event topics. Each event has a list 967 // of topics. Topics matches a prefix of that list. An empty element slice matches any 968 // topic. Non-empty elements represent an alternative that matches any of the 969 // contained topics. 970 // 971 // Examples: 972 // {} or nil matches any topic list 973 // {{A}} matches topic A in first position 974 // {{}, {B}} matches any topic in first position, B in second position 975 // {{A}, {B}} matches topic A in first position, B in second position 976 // {{A, B}}, {C, D}} matches topic (A OR B) in first position, (C OR D) in second position 977 Topics *[][]common.Hash 978 } 979 980 func (r *Resolver) Logs(ctx context.Context, args struct{ Filter FilterCriteria }) ([]*Log, error) { 981 // Convert the RPC block numbers into internal representations 982 begin := rpc.LatestBlockNumber.Int64() 983 if args.Filter.FromBlock != nil { 984 begin = int64(*args.Filter.FromBlock) 985 } 986 end := rpc.LatestBlockNumber.Int64() 987 if args.Filter.ToBlock != nil { 988 end = int64(*args.Filter.ToBlock) 989 } 990 var addresses []common.Address 991 if args.Filter.Addresses != nil { 992 addresses = *args.Filter.Addresses 993 } 994 var topics [][]common.Hash 995 if args.Filter.Topics != nil { 996 topics = *args.Filter.Topics 997 } 998 // Construct the range filter 999 filter := filters.NewRangeFilter(filters.Backend(r.backend), begin, end, addresses, topics) 1000 return runFilter(ctx, r.backend, filter) 1001 } 1002 1003 func (r *Resolver) GasPrice(ctx context.Context) (hexutil.Big, error) { 1004 price, err := r.backend.SuggestPrice(ctx) 1005 return hexutil.Big(*price), err 1006 } 1007 1008 func (r *Resolver) ProtocolVersion(ctx context.Context) (int32, error) { 1009 return int32(r.backend.ProtocolVersion()), nil 1010 } 1011 1012 // SyncState represents the synchronisation status returned from the `syncing` accessor. 1013 type SyncState struct { 1014 progress ethereum.SyncProgress 1015 } 1016 1017 func (s *SyncState) StartingBlock() hexutil.Uint64 { 1018 return hexutil.Uint64(s.progress.StartingBlock) 1019 } 1020 1021 func (s *SyncState) CurrentBlock() hexutil.Uint64 { 1022 return hexutil.Uint64(s.progress.CurrentBlock) 1023 } 1024 1025 func (s *SyncState) HighestBlock() hexutil.Uint64 { 1026 return hexutil.Uint64(s.progress.HighestBlock) 1027 } 1028 1029 func (s *SyncState) PulledStates() *hexutil.Uint64 { 1030 ret := hexutil.Uint64(s.progress.PulledStates) 1031 return &ret 1032 } 1033 1034 func (s *SyncState) KnownStates() *hexutil.Uint64 { 1035 ret := hexutil.Uint64(s.progress.KnownStates) 1036 return &ret 1037 } 1038 1039 // Syncing returns false in case the node is currently not syncing with the network. It can be up to date or has not 1040 // yet received the latest block headers from its pears. In case it is synchronizing: 1041 // - startingBlock: block number this node started to synchronise from 1042 // - currentBlock: block number this node is currently importing 1043 // - highestBlock: block number of the highest block header this node has received from peers 1044 // - pulledStates: number of state entries processed until now 1045 // - knownStates: number of known state entries that still need to be pulled 1046 func (r *Resolver) Syncing() (*SyncState, error) { 1047 progress := r.backend.Downloader().Progress() 1048 1049 // Return not syncing if the synchronisation already completed 1050 if progress.CurrentBlock >= progress.HighestBlock { 1051 return nil, nil 1052 } 1053 // Otherwise gather the block sync stats 1054 return &SyncState{progress}, nil 1055 }