explorer

package
v0.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 29, 2018 License: Apache-2.0 Imports: 23 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	// ErrInternalServer indicates the internal server error
	ErrInternalServer = errors.New("internal server error")
	// ErrTransfer indicates the error of transfer
	ErrTransfer = errors.New("invalid transfer")
	// ErrVote indicates the error of vote
	ErrVote = errors.New("invalid vote")
	// ErrExecution indicates the error of execution
	ErrExecution = errors.New("invalid execution")
	// ErrReceipt indicates the error of receipt
	ErrReceipt = errors.New("invalid receipt")
)

Functions

func NewExplorerProxy

func NewExplorerProxy(url string) explorer.Explorer

NewExplorerProxy accepts an URL to the endpoint of the Explorer server and returns a proxy that implements the Explorer interface

Types

type MockExplorer

type MockExplorer struct {
}

MockExplorer return an explorer for test purpose

func (*MockExplorer) GetAddressBalance

func (exp *MockExplorer) GetAddressBalance(address string) (int64, error)

GetAddressBalance returns the balance of an address

func (*MockExplorer) GetAddressDetails

func (exp *MockExplorer) GetAddressDetails(address string) (explorer.AddressDetails, error)

GetAddressDetails returns the properties of an address

func (*MockExplorer) GetBlockByID

func (exp *MockExplorer) GetBlockByID(blkID string) (explorer.Block, error)

GetBlockByID returns block by block id

func (*MockExplorer) GetBlockchainHeight

func (exp *MockExplorer) GetBlockchainHeight() (int64, error)

GetBlockchainHeight returns the blockchain height

func (*MockExplorer) GetCandidateMetrics

func (exp *MockExplorer) GetCandidateMetrics() (explorer.CandidateMetrics, error)

GetCandidateMetrics returns the fake delegates metrics

func (*MockExplorer) GetCoinStatistic

func (exp *MockExplorer) GetCoinStatistic() (explorer.CoinStatistic, error)

GetCoinStatistic returns stats in blockchain

func (*MockExplorer) GetConsensusMetrics

func (exp *MockExplorer) GetConsensusMetrics() (explorer.ConsensusMetrics, error)

GetConsensusMetrics returns the fake consensus metrics

func (*MockExplorer) GetExecutionByID

func (exp *MockExplorer) GetExecutionByID(executionID string) (explorer.Execution, error)

GetExecutionByID returns execution by execution id

func (*MockExplorer) GetExecutionsByAddress

func (exp *MockExplorer) GetExecutionsByAddress(address string, offset int64, limit int64) ([]explorer.Execution, error)

GetExecutionsByAddress returns all executions associate with an address

func (*MockExplorer) GetExecutionsByBlockID

func (exp *MockExplorer) GetExecutionsByBlockID(blkID string, offset int64, limit int64) ([]explorer.Execution, error)

GetExecutionsByBlockID returns executions in a block

func (*MockExplorer) GetLastBlocksByRange

func (exp *MockExplorer) GetLastBlocksByRange(offset int64, limit int64) ([]explorer.Block, error)

GetLastBlocksByRange get block with height [offset-limit+1, offset]

func (*MockExplorer) GetLastExecutionsByRange

func (exp *MockExplorer) GetLastExecutionsByRange(startBlockHeight int64, offset int64, limit int64) ([]explorer.Execution, error)

GetLastExecutionsByRange return executions in [-(offset+limit-1), -offset] from block with height startBlockHeight

func (*MockExplorer) GetLastTransfersByRange

func (exp *MockExplorer) GetLastTransfersByRange(startBlockHeight int64, offset int64, limit int64, showCoinBase bool) ([]explorer.Transfer, error)

GetLastTransfersByRange return transfers in [-(offset+limit-1), -offset] from block with height startBlockHeight

func (*MockExplorer) GetLastVotesByRange

func (exp *MockExplorer) GetLastVotesByRange(startBlockHeight int64, offset int64, limit int64) ([]explorer.Vote, error)

GetLastVotesByRange return votes in [-(offset+limit-1), -offset] from block with height startBlockHeight

func (*MockExplorer) GetPeers

func (exp *MockExplorer) GetPeers() (explorer.GetPeersResponse, error)

GetPeers returns a empty GetPeersResponse.

func (*MockExplorer) GetReceiptByExecutionID

func (exp *MockExplorer) GetReceiptByExecutionID(id string) (explorer.Receipt, error)

GetReceiptByExecutionID gets receipt with corresponding execution id

func (*MockExplorer) GetTransferByID

func (exp *MockExplorer) GetTransferByID(transferID string) (explorer.Transfer, error)

GetTransferByID returns transfer by transfer id

func (*MockExplorer) GetTransfersByAddress

func (exp *MockExplorer) GetTransfersByAddress(address string, offset int64, limit int64) ([]explorer.Transfer, error)

GetTransfersByAddress returns all transfers associate with an address

func (*MockExplorer) GetTransfersByBlockID

func (exp *MockExplorer) GetTransfersByBlockID(blockID string, offset int64, limit int64) ([]explorer.Transfer, error)

GetTransfersByBlockID returns transfers in a block

func (*MockExplorer) GetUnconfirmedExecutionsByAddress

func (exp *MockExplorer) GetUnconfirmedExecutionsByAddress(address string, offset int64, limit int64) ([]explorer.Execution, error)

GetUnconfirmedExecutionsByAddress returns all unconfirmed executions in actpool associated with an address

func (*MockExplorer) GetUnconfirmedTransfersByAddress

func (exp *MockExplorer) GetUnconfirmedTransfersByAddress(address string, offset int64, limit int64) ([]explorer.Transfer, error)

GetUnconfirmedTransfersByAddress returns all unconfirmed transfers in actpool associated with an address

func (*MockExplorer) GetUnconfirmedVotesByAddress

func (exp *MockExplorer) GetUnconfirmedVotesByAddress(address string, offset int64, limit int64) ([]explorer.Vote, error)

GetUnconfirmedVotesByAddress returns all unconfirmed votes in actpool associated with an address

func (*MockExplorer) GetVoteByID

func (exp *MockExplorer) GetVoteByID(voteID string) (explorer.Vote, error)

GetVoteByID returns vote by vote id

func (*MockExplorer) GetVotesByAddress

func (exp *MockExplorer) GetVotesByAddress(address string, offset int64, limit int64) ([]explorer.Vote, error)

GetVotesByAddress returns all votes associate with an address

func (*MockExplorer) GetVotesByBlockID

func (exp *MockExplorer) GetVotesByBlockID(blkID string, offset int64, limit int64) ([]explorer.Vote, error)

GetVotesByBlockID returns votes in a block

func (*MockExplorer) ReadExecutionState

func (exp *MockExplorer) ReadExecutionState(contractAddress string, slot int64) (string, error)

ReadExecutionState sends a smart contract

func (*MockExplorer) SendSmartContract

func (exp *MockExplorer) SendSmartContract(request explorer.Execution) (explorer.SendSmartContractResponse, error)

SendSmartContract sends a smart contract

func (*MockExplorer) SendTransfer

SendTransfer sends a fake transfer

func (*MockExplorer) SendVote

SendVote sends a fake vote

type Server

type Server struct {
	// contains filtered or unexported fields
}

Server is the container of the explorer service

func NewServer

func NewServer(
	cfg config.Explorer,
	chain blockchain.Blockchain,
	consensus consensus.Consensus,
	dispatcher dispatcher.Dispatcher,
	actPool actpool.ActPool,
	p2p network.Overlay,
) *Server

NewServer instantiates an explorer server

func NewTestSever

func NewTestSever(cfg config.Explorer) *Server

NewTestSever instantiates an explorer server with mock handler

func (*Server) Port

func (s *Server) Port() int

Port returns the actually binding port

func (*Server) Start

func (s *Server) Start(_ context.Context) error

Start starts the explorer server

func (*Server) Stop

func (s *Server) Stop(ctx context.Context) error

Stop stops the explorer server

type Service

type Service struct {
	// contains filtered or unexported fields
}

Service provide api for user to query blockchain data

func (*Service) GetAddressBalance

func (exp *Service) GetAddressBalance(address string) (int64, error)

GetAddressBalance returns the balance of an address

func (*Service) GetAddressDetails

func (exp *Service) GetAddressDetails(address string) (explorer.AddressDetails, error)

GetAddressDetails returns the properties of an address

func (*Service) GetBlockByID

func (exp *Service) GetBlockByID(blkID string) (explorer.Block, error)

GetBlockByID returns block by block id

func (*Service) GetBlockchainHeight

func (exp *Service) GetBlockchainHeight() (int64, error)

GetBlockchainHeight returns the current blockchain tip height

func (*Service) GetCandidateMetrics

func (exp *Service) GetCandidateMetrics() (explorer.CandidateMetrics, error)

GetCandidateMetrics returns the latest delegates metrics

func (*Service) GetCoinStatistic

func (exp *Service) GetCoinStatistic() (explorer.CoinStatistic, error)

GetCoinStatistic returns stats in blockchain

func (*Service) GetConsensusMetrics

func (exp *Service) GetConsensusMetrics() (explorer.ConsensusMetrics, error)

GetConsensusMetrics returns the latest consensus metrics

func (*Service) GetExecutionByID

func (exp *Service) GetExecutionByID(executionID string) (explorer.Execution, error)

GetExecutionByID returns execution by execution id

func (*Service) GetExecutionsByAddress

func (exp *Service) GetExecutionsByAddress(address string, offset int64, limit int64) ([]explorer.Execution, error)

GetExecutionsByAddress returns all executions associated with an address

func (*Service) GetExecutionsByBlockID

func (exp *Service) GetExecutionsByBlockID(blkID string, offset int64, limit int64) ([]explorer.Execution, error)

GetExecutionsByBlockID returns executions in a block

func (*Service) GetLastBlocksByRange

func (exp *Service) GetLastBlocksByRange(offset int64, limit int64) ([]explorer.Block, error)

GetLastBlocksByRange get block with height [offset-limit+1, offset]

func (*Service) GetLastExecutionsByRange

func (exp *Service) GetLastExecutionsByRange(startBlockHeight int64, offset int64, limit int64) ([]explorer.Execution, error)

GetLastExecutionsByRange returns executions in [-(offset+limit-1), -offset] from block with height startBlockHeight

func (*Service) GetLastTransfersByRange

func (exp *Service) GetLastTransfersByRange(startBlockHeight int64, offset int64, limit int64, showCoinBase bool) ([]explorer.Transfer, error)

GetLastTransfersByRange returns transfers in [-(offset+limit-1), -offset] from block with height startBlockHeight

func (*Service) GetLastVotesByRange

func (exp *Service) GetLastVotesByRange(startBlockHeight int64, offset int64, limit int64) ([]explorer.Vote, error)

GetLastVotesByRange returns votes in [-(offset+limit-1), -offset] from block with height startBlockHeight

func (*Service) GetPeers

func (exp *Service) GetPeers() (explorer.GetPeersResponse, error)

GetPeers return a list of node peers and itself's network addsress info.

func (*Service) GetReceiptByExecutionID

func (exp *Service) GetReceiptByExecutionID(id string) (explorer.Receipt, error)

GetReceiptByExecutionID gets receipt with corresponding execution id

func (*Service) GetTransferByID

func (exp *Service) GetTransferByID(transferID string) (explorer.Transfer, error)

GetTransferByID returns transfer by transfer id

func (*Service) GetTransfersByAddress

func (exp *Service) GetTransfersByAddress(address string, offset int64, limit int64) ([]explorer.Transfer, error)

GetTransfersByAddress returns all transfers associated with an address

func (*Service) GetTransfersByBlockID

func (exp *Service) GetTransfersByBlockID(blkID string, offset int64, limit int64) ([]explorer.Transfer, error)

GetTransfersByBlockID returns transfers in a block

func (*Service) GetUnconfirmedExecutionsByAddress

func (exp *Service) GetUnconfirmedExecutionsByAddress(address string, offset int64, limit int64) ([]explorer.Execution, error)

GetUnconfirmedExecutionsByAddress returns all unconfirmed executions in actpool associated with an address

func (*Service) GetUnconfirmedTransfersByAddress

func (exp *Service) GetUnconfirmedTransfersByAddress(address string, offset int64, limit int64) ([]explorer.Transfer, error)

GetUnconfirmedTransfersByAddress returns all unconfirmed transfers in actpool associated with an address

func (*Service) GetUnconfirmedVotesByAddress

func (exp *Service) GetUnconfirmedVotesByAddress(address string, offset int64, limit int64) ([]explorer.Vote, error)

GetUnconfirmedVotesByAddress returns all unconfirmed votes in actpool associated with an address

func (*Service) GetVoteByID

func (exp *Service) GetVoteByID(voteID string) (explorer.Vote, error)

GetVoteByID returns vote by vote id

func (*Service) GetVotesByAddress

func (exp *Service) GetVotesByAddress(address string, offset int64, limit int64) ([]explorer.Vote, error)

GetVotesByAddress returns all votes associated with an address

func (*Service) GetVotesByBlockID

func (exp *Service) GetVotesByBlockID(blkID string, offset int64, limit int64) ([]explorer.Vote, error)

GetVotesByBlockID returns votes in a block

func (*Service) ReadExecutionState

func (exp *Service) ReadExecutionState(contractAddress string, slot int64) (string, error)

ReadExecutionState reads the state in a contract address specified by the slot

func (*Service) SendSmartContract

func (exp *Service) SendSmartContract(execution explorer.Execution) (explorer.SendSmartContractResponse, error)

SendSmartContract sends a smart contract

func (*Service) SendTransfer

SendTransfer sends a transfer

func (*Service) SendVote

func (exp *Service) SendVote(voteJSON explorer.SendVoteRequest) (explorer.SendVoteResponse, error)

SendVote sends a vote

Directories

Path Synopsis
idl
explorer
Code generated by idl2go from JSON generated by Barrister v0.1.6
Code generated by idl2go from JSON generated by Barrister v0.1.6

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL