api

Documentation

Index

• type APIClient
  • func (c APIClient) AdminAPI() admin.Client
  • func (c APIClient) CChainAPI() evm.Client
  • func (c APIClient) CChainEthAPI() EthClient
  • func (c APIClient) CChainIndexAPI() indexer.Client
  • func (c APIClient) HealthAPI() health.Client
  • func (c APIClient) InfoAPI() info.Client
  • func (c APIClient) KeystoreAPI() keystore.Client
  • func (c APIClient) PChainAPI() platformvm.Client
  • func (c APIClient) PChainIndexAPI() indexer.Client
  • func (c APIClient) XChainAPI() avm.Client
  • func (c APIClient) XChainWalletAPI() avm.WalletClient
• type Client
  • func NewAPIClient(ipAddr string, port uint16) Client
• type EthClient
  • func NewEthClient(ipAddr string, port uint) EthClient
  • func NewEthClientWithChainID(ipAddr string, port uint, chainID string) EthClient
• type NewAPIClientF

Types

type APIClient

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

APIClient gives access to most metalgo apis (or suitable wrappers)

func (APIClient) AdminAPI

func (c APIClient) AdminAPI() admin.Client

func (APIClient) CChainAPI

func (c APIClient) CChainAPI() evm.Client

func (APIClient) CChainEthAPI

func (c APIClient) CChainEthAPI() EthClient

func (APIClient) CChainIndexAPI

func (c APIClient) CChainIndexAPI() indexer.Client

func (APIClient) HealthAPI

func (c APIClient) HealthAPI() health.Client

func (APIClient) InfoAPI

func (c APIClient) InfoAPI() info.Client

func (APIClient) KeystoreAPI

func (c APIClient) KeystoreAPI() keystore.Client

func (APIClient) PChainAPI

func (c APIClient) PChainAPI() platformvm.Client

func (APIClient) PChainIndexAPI

func (c APIClient) PChainIndexAPI() indexer.Client

func (APIClient) XChainAPI

func (c APIClient) XChainAPI() avm.Client

func (APIClient) XChainWalletAPI

func (c APIClient) XChainWalletAPI() avm.WalletClient

type Client

type Client interface {
	PChainAPI() platformvm.Client
	XChainAPI() avm.Client
	XChainWalletAPI() avm.WalletClient
	CChainAPI() evm.Client
	CChainEthAPI() EthClient // ethclient websocket wrapper that adds mutexed calls, and lazy conn init (on first call)
	InfoAPI() info.Client
	HealthAPI() health.Client
	KeystoreAPI() keystore.Client
	AdminAPI() admin.Client
	PChainIndexAPI() indexer.Client
	CChainIndexAPI() indexer.Client
}

Issues API calls to a node TODO: byzantine api. check if appropriate. improve implementation.

func NewAPIClient

func NewAPIClient(ipAddr string, port uint16) Client

NewAPIClient initialize most of metalgo apis

type EthClient

type EthClient interface {
	Close()
	SendTransaction(context.Context, *types.Transaction) error
	TransactionReceipt(context.Context, common.Hash) (*types.Receipt, error)
	BalanceAt(context.Context, common.Address, *big.Int) (*big.Int, error)
	BlockByNumber(context.Context, *big.Int) (*types.Block, error)
	BlockByHash(context.Context, common.Hash) (*types.Block, error)
	BlockNumber(context.Context) (uint64, error)
	CallContract(context.Context, interfaces.CallMsg, *big.Int) ([]byte, error)
	NonceAt(context.Context, common.Address, *big.Int) (uint64, error)
	AssetBalanceAt(context.Context, common.Address, ids.ID, *big.Int) (*big.Int, error)
	SuggestGasPrice(context.Context) (*big.Int, error)
	AcceptedCodeAt(context.Context, common.Address) ([]byte, error)
	AcceptedNonceAt(context.Context, common.Address) (uint64, error)
	CodeAt(context.Context, common.Address, *big.Int) ([]byte, error)
	EstimateGas(context.Context, interfaces.CallMsg) (uint64, error)
	AcceptedCallContract(context.Context, interfaces.CallMsg) ([]byte, error)
	HeaderByNumber(context.Context, *big.Int) (*types.Header, error)
	SuggestGasTipCap(context.Context) (*big.Int, error)
	FilterLogs(context.Context, interfaces.FilterQuery) ([]types.Log, error)
	SubscribeFilterLogs(context.Context, interfaces.FilterQuery, chan<- types.Log) (interfaces.Subscription, error)
}

func NewEthClient

func NewEthClient(ipAddr string, port uint) EthClient

NewEthClient mainly takes ip/port info for usage in future calls Connection can't be initialized in constructor because node is not ready when the constructor is called It follows convention of most metalgo api constructors that can be called without having a ready node

func NewEthClientWithChainID

func NewEthClientWithChainID(ipAddr string, port uint, chainID string) EthClient

NewEthClientWithChainID creates an EthClient initialized to connect to ipAddr/port and communicate with the given chainID.

type NewAPIClientF

type NewAPIClientF func(ipAddr string, port uint16) Client

Returns a new API client for a node at [ipAddr]:[port].