github.com/aerth/aquachain@v1.4.1/internal/aquaapi/backend.go (about)

     1  // Copyright 2015 The aquachain Authors
     2  // This file is part of the aquachain library.
     3  //
     4  // The aquachain 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 aquachain 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 aquachain library. If not, see <http://www.gnu.org/licenses/>.
    16  
    17  // Package aquaapi implements the general AquaChain API functions.
    18  package aquaapi
    19  
    20  import (
    21  	"context"
    22  	"math/big"
    23  
    24  	"github.com/aquanetwork/aquachain/accounts"
    25  	"github.com/aquanetwork/aquachain/aqua/downloader"
    26  	"github.com/aquanetwork/aquachain/aquadb"
    27  	"github.com/aquanetwork/aquachain/common"
    28  	"github.com/aquanetwork/aquachain/core"
    29  	"github.com/aquanetwork/aquachain/core/state"
    30  	"github.com/aquanetwork/aquachain/core/types"
    31  	"github.com/aquanetwork/aquachain/core/vm"
    32  	"github.com/aquanetwork/aquachain/event"
    33  	"github.com/aquanetwork/aquachain/params"
    34  	"github.com/aquanetwork/aquachain/rpc"
    35  )
    36  
    37  // Backend interface provides the common API services (that are provided by
    38  // both full and light clients) with access to necessary functions.
    39  type Backend interface {
    40  	// General AquaChain API
    41  	Downloader() *downloader.Downloader
    42  	ProtocolVersion() int
    43  	SuggestPrice(ctx context.Context) (*big.Int, error)
    44  	ChainDb() aquadb.Database
    45  	EventMux() *event.TypeMux
    46  	AccountManager() *accounts.Manager
    47  
    48  	// BlockChain API
    49  	SetHead(number uint64)
    50  	HeaderByNumber(ctx context.Context, blockNr rpc.BlockNumber) (*types.Header, error)
    51  	BlockByNumber(ctx context.Context, blockNr rpc.BlockNumber) (*types.Block, error)
    52  	StateAndHeaderByNumber(ctx context.Context, blockNr rpc.BlockNumber) (*state.StateDB, *types.Header, error)
    53  	GetBlock(ctx context.Context, blockHash common.Hash) (*types.Block, error)
    54  	GetReceipts(ctx context.Context, blockHash common.Hash) (types.Receipts, error)
    55  	GetTd(blockHash common.Hash) *big.Int
    56  	GetEVM(ctx context.Context, msg core.Message, state *state.StateDB, header *types.Header, vmCfg vm.Config) (*vm.EVM, func() error, error)
    57  	SubscribeChainEvent(ch chan<- core.ChainEvent) event.Subscription
    58  	SubscribeChainHeadEvent(ch chan<- core.ChainHeadEvent) event.Subscription
    59  	SubscribeChainSideEvent(ch chan<- core.ChainSideEvent) event.Subscription
    60  
    61  	// TxPool API
    62  	SendTx(ctx context.Context, signedTx *types.Transaction) error
    63  	GetPoolTransactions() (types.Transactions, error)
    64  	GetPoolTransaction(txHash common.Hash) *types.Transaction
    65  	GetPoolNonce(ctx context.Context, addr common.Address) (uint64, error)
    66  	Stats() (pending int, queued int)
    67  	TxPoolContent() (map[common.Address]types.Transactions, map[common.Address]types.Transactions)
    68  	SubscribeTxPreEvent(chan<- core.TxPreEvent) event.Subscription
    69  
    70  	ChainConfig() *params.ChainConfig
    71  	CurrentBlock() *types.Block
    72  }
    73  
    74  func GetAPIs(apiBackend Backend) []rpc.API {
    75  	nonceLock := new(AddrLocker)
    76  	return []rpc.API{
    77  		{
    78  			Namespace: "aqua",
    79  			Version:   "1.0",
    80  			Service:   NewPublicAquaChainAPI(apiBackend),
    81  			Public:    true,
    82  		}, {
    83  			Namespace: "aqua",
    84  			Version:   "1.0",
    85  			Service:   NewPublicBlockChainAPI(apiBackend),
    86  			Public:    true,
    87  		}, {
    88  			Namespace: "aqua",
    89  			Version:   "1.0",
    90  			Service:   NewPublicTransactionPoolAPI(apiBackend, nonceLock),
    91  			Public:    true,
    92  		}, {
    93  			Namespace: "txpool",
    94  			Version:   "1.0",
    95  			Service:   NewPublicTxPoolAPI(apiBackend),
    96  			Public:    true,
    97  		}, {
    98  			Namespace: "debug",
    99  			Version:   "1.0",
   100  			Service:   NewPublicDebugAPI(apiBackend),
   101  			Public:    true,
   102  		}, {
   103  			Namespace: "debug",
   104  			Version:   "1.0",
   105  			Service:   NewPrivateDebugAPI(apiBackend),
   106  		}, {
   107  			Namespace: "aqua",
   108  			Version:   "1.0",
   109  			Service:   NewPublicAccountAPI(apiBackend.AccountManager()),
   110  			Public:    true,
   111  		}, {
   112  			Namespace: "personal",
   113  			Version:   "1.0",
   114  			Service:   NewPrivateAccountAPI(apiBackend, nonceLock),
   115  			Public:    false,
   116  		}, { // eth alias
   117  			Namespace: "eth",
   118  			Version:   "1.0",
   119  			Service:   NewPublicAquaChainAPI(apiBackend),
   120  			Public:    true,
   121  		}, {
   122  			Namespace: "eth",
   123  			Version:   "1.0",
   124  			Service:   NewPublicBlockChainAPI(apiBackend),
   125  			Public:    true,
   126  		}, {
   127  			Namespace: "eth",
   128  			Version:   "1.0",
   129  			Service:   NewPublicTransactionPoolAPI(apiBackend, nonceLock),
   130  			Public:    true,
   131  		}, {
   132  			Namespace: "eth",
   133  			Version:   "1.0",
   134  			Service:   NewPublicAccountAPI(apiBackend.AccountManager()),
   135  			Public:    true,
   136  		},
   137  	}
   138  }