Documentation
¶
Index ¶
Constants ¶
const DefaultRestInterface = "localhost:8080"
DefaultRestInterface is the default interface the rest API will start on if not specified
const DefaultRestPortOff = "off"
DefaultRestPortOff is the default value that should be passed if it is desired
to start the node without a REST endpoint available
Variables ¶
var ErrHeartbeatsNotActive = errors.New("heartbeat system not active")
ErrHeartbeatsNotActive signals that the heartbeat system is not active
var ErrInvalidValue = errors.New("invalid value")
ErrInvalidValue signals that an invalid value has been provided
var ErrNilAccountState = errors.New("nil account state")
ErrNilAccountState signals that a nil account state has been provided
var ErrNilApiResolver = errors.New("nil api resolver")
ErrNilApiResolver signals that a nil api resolver instance has been provided
var ErrNilBlockHeader = errors.New("nil block header")
ErrNilBlockHeader signals that the current block header is nil
var ErrNilBlockchain = errors.New("nil blockchain")
ErrNilBlockchain signals that a nil blockchain has been provided
var ErrNilNode = errors.New("nil node")
ErrNilNode signals that a nil node instance has been provided
var ErrNilPeerState = errors.New("nil peer state")
ErrNilPeerState signals that a nil peer state has been provided
var ErrNilTransactionSimulatorProcessor = errors.New("nil transaction simulator processor")
ErrNilTransactionSimulatorProcessor signals that a nil transaction simulator processor has been provided
var ErrNoApiRoutesConfig = errors.New("no configuration found for API routes")
ErrNoApiRoutesConfig signals that no configuration was found for API routes
Functions ¶
func NewNodeFacade ¶ added in v1.0.102
func NewNodeFacade(arg ArgNodeFacade) (*nodeFacade, error)
NewNodeFacade creates a new Facade with a NodeWrapper
Types ¶
type ApiResolver ¶
type ApiResolver interface {
ExecuteSCQuery(query *process.SCQuery) (*vmcommon.VMOutput, error)
ComputeTransactionGasLimit(tx *transaction.Transaction) (*transaction.CostResponse, error)
StatusMetrics() external.StatusMetricsHandler
GetTotalStakedValue() (*api.StakeValues, error)
GetDirectStakedList() ([]*api.DirectStakedValue, error)
GetDelegatorsList() ([]*api.Delegator, error)
Close() error
IsInterfaceNil() bool
}
ApiResolver defines a structure capable of resolving REST API requests
type ArgNodeFacade ¶ added in v1.0.102
type ArgNodeFacade struct {
Node NodeHandler
ApiResolver ApiResolver
TxSimulatorProcessor TransactionSimulatorProcessor
RestAPIServerDebugMode bool
WsAntifloodConfig config.WebServerAntifloodConfig
FacadeConfig config.FacadeConfig
ApiRoutesConfig config.ApiRoutesConfig
AccountsState state.AccountsAdapter
PeerState state.AccountsAdapter
Blockchain chainData.ChainHandler
}
ArgNodeFacade represents the argument for the nodeFacade
type HardforkTrigger ¶ added in v1.0.102
type HardforkTrigger interface {
Trigger(epoch uint32, withEarlyEndOfEpoch bool) error
IsSelfTrigger() bool
IsInterfaceNil() bool
}
HardforkTrigger defines the structure used to trigger hardforks
type NodeHandler ¶ added in v1.0.102
type NodeHandler interface {
// GetBalance returns the balance for a specific address
GetBalance(address string) (*big.Int, error)
// GetUsername returns the username for a specific address
GetUsername(address string) (string, error)
// GetValueForKey returns the value of a key from a given account
GetValueForKey(address string, key string) (string, error)
// GetKeyValuePairs returns the key-value pairs under a given address
GetKeyValuePairs(address string) (map[string]string, error)
// GetAllIssuedESDTs returns all the issued esdt tokens from esdt system smart contract
GetAllIssuedESDTs(tokenType string) ([]string, error)
// GetESDTData returns the esdt data from a given account, given key and given nonce
GetESDTData(address, tokenID string, nonce uint64) (*esdt.ESDigitalToken, error)
// GetNFTTokenIDsRegisteredByAddress returns all the token identifiers for semi or non fungible tokens registered by the address
GetNFTTokenIDsRegisteredByAddress(address string) ([]string, error)
// GetESDTsWithRole returns the token identifiers where the specified address has the given role
GetESDTsWithRole(address string, role string) ([]string, error)
// GetAllESDTTokens returns the value of a key from a given account
GetAllESDTTokens(address string) (map[string]*esdt.ESDigitalToken, error)
// CreateTransaction will return a transaction from all needed fields
CreateTransaction(nonce uint64, value string, receiver string, receiverUsername []byte, sender string, senderUsername []byte, gasPrice uint64,
gasLimit uint64, data []byte, signatureHex string, chainID string, version uint32, options uint32) (*transaction.Transaction, []byte, error)
// ValidateTransaction will validate a transaction
ValidateTransaction(tx *transaction.Transaction) error
ValidateTransactionForSimulation(tx *transaction.Transaction, checkSignature bool) error
// SendBulkTransactions will send a bulk of transactions on the 'send transactions pipe' channel
SendBulkTransactions(txs []*transaction.Transaction) (uint64, error)
// GetTransaction will return a transaction based on the hash
GetTransaction(hash string, withResults bool) (*transaction.ApiTransactionResult, error)
// GetAccount returns an accountResponse containing information
// about the account correlated with provided address
GetAccount(address string) (api.AccountResponse, error)
// GetCode returns the code for the given code hash
GetCode(codeHash []byte) []byte
// GetHeartbeats returns the heartbeat status for each public key defined in genesis.json
GetHeartbeats() []data.PubKeyHeartbeat
// IsInterfaceNil returns true if there is no value under the interface
IsInterfaceNil() bool
// ValidatorStatisticsApi return the statistics for all the validators
ValidatorStatisticsApi() (map[string]*state.ValidatorApiResponse, error)
DirectTrigger(epoch uint32, withEarlyEndOfEpoch bool) error
IsSelfTrigger() bool
EncodeAddressPubkey(pk []byte) (string, error)
DecodeAddressPubkey(pk string) ([]byte, error)
GetQueryHandler(name string) (debug.QueryHandler, error)
GetPeerInfo(pid string) ([]core.QueryP2PPeerInfo, error)
GetBlockByHash(hash string, withTxs bool) (*api.Block, error)
GetBlockByNonce(nonce uint64, withTxs bool) (*api.Block, error)
}
NodeHandler contains all functions that a node should contain.
type TransactionSimulatorProcessor ¶ added in v1.1.1
type TransactionSimulatorProcessor interface {
ProcessTx(tx *transaction.Transaction) (*transaction.SimulationResults, error)
IsInterfaceNil() bool
}
TransactionSimulatorProcessor defines the actions which a transaction simulator processor has to implement