rpc

Documentation

Index

• type ArbitrumClient
  • func NewArbitrumClient(ethereumClient *EthereumClient, l1Client *Ethereum2Client) (*ArbitrumClient, error)
  • func (c *ArbitrumClient) IsFinalized(ctx context.Context, _ uint64, txReceipt *types.Receipt) (bool, error)
• type Client
  • func NewClient(url string) (Client, error)
  • func NewL2Client(config evmTypes.EVMConfig, l1Client Client) (Client, error)
• type Ethereum2Client
  • func NewEthereum2Client(ethereumClient *EthereumClient) (*Ethereum2Client, error)
  • func (c *Ethereum2Client) IsFinalized(ctx context.Context, _ uint64, txReceipt *types.Receipt) (bool, error)
• type EthereumClient
  • func NewEthereumClient(ethClient EthereumJSONRPCClient, rpc JSONRPCClient) (*EthereumClient, error)
  • func (c *EthereumClient) HeaderByNumber(ctx context.Context, number *big.Int) (*Header, error)
  • func (c *EthereumClient) IsFinalized(ctx context.Context, conf uint64, txReceipt *types.Receipt) (bool, error)
• type EthereumJSONRPCClient
• type Header
• type JSONRPCClient
• type MoonbeamClient
  • func NewMoonbeamClient(ethereumClient *EthereumClient) (*MoonbeamClient, error)
  • func (c *MoonbeamClient) IsFinalized(ctx context.Context, _ uint64, txReceipt *types.Receipt) (bool, error)

Types

type ArbitrumClient

type ArbitrumClient struct {
	*EthereumClient
	// contains filtered or unexported fields
}

ArbitrumClient is a JSON-RPC client of Arbitrum

func NewArbitrumClient

func NewArbitrumClient(ethereumClient *EthereumClient, l1Client *Ethereum2Client) (*ArbitrumClient, error)

NewArbitrumClient is the constructor

func (*ArbitrumClient) IsFinalized

func (c *ArbitrumClient) IsFinalized(ctx context.Context, _ uint64, txReceipt *types.Receipt) (bool, error)

IsFinalized determines whether or not the given transaction receipt is finalized on the chain

type Client

type Client interface {
	// TransactionReceipt returns the transaction receipt for the given transaction hash
	TransactionReceipt(ctx context.Context, txHash common.Hash) (*types.Receipt, error)
	// HeaderByNumber returns the block header for the given block number
	HeaderByNumber(ctx context.Context, number *big.Int) (*Header, error)
	// IsFinalized determines whether or not the given transaction receipt is finalized on the chain
	IsFinalized(ctx context.Context, conf uint64, txReceipt *types.Receipt) (bool, error)
	// Close closes the client connection
	Close()
}

Client provides calls to EVM JSON-RPC endpoints

func NewClient

func NewClient(url string) (Client, error)

NewClient returns an EVM JSON-RPC client

func NewL2Client

func NewL2Client(config evmTypes.EVMConfig, l1Client Client) (Client, error)

NewL2Client returns a L2 EVM JSON-RPC client

type Ethereum2Client

type Ethereum2Client struct {
	*EthereumClient
}

Ethereum2Client is a JSON-RPC client of Ethereum 2.0

func NewEthereum2Client

func NewEthereum2Client(ethereumClient *EthereumClient) (*Ethereum2Client, error)

NewEthereum2Client is the constructor

func (*Ethereum2Client) IsFinalized

func (c *Ethereum2Client) IsFinalized(ctx context.Context, _ uint64, txReceipt *types.Receipt) (bool, error)

IsFinalized determines whether or not the given transaction receipt is finalized on the chain

type EthereumClient

type EthereumClient struct {
	EthereumJSONRPCClient
	// contains filtered or unexported fields
}

EthereumClient is a JSON-RPC client of any Ethereum-compact chains

func NewEthereumClient

func NewEthereumClient(ethClient EthereumJSONRPCClient, rpc JSONRPCClient) (*EthereumClient, error)

NewEthereumClient is the constructor

func (*EthereumClient) HeaderByNumber

func (c *EthereumClient) HeaderByNumber(ctx context.Context, number *big.Int) (*Header, error)

HeaderByNumber returns the block header for the given block number

func (*EthereumClient) IsFinalized

func (c *EthereumClient) IsFinalized(ctx context.Context, conf uint64, txReceipt *types.Receipt) (bool, error)

IsFinalized determines whether or not the given transaction receipt is finalized on the chain

type EthereumJSONRPCClient

type EthereumJSONRPCClient interface {
	BlockNumber(ctx context.Context) (uint64, error)
	CallContract(ctx context.Context, msg ethereum.CallMsg, blockNumber *big.Int) ([]byte, error)
	TransactionReceipt(ctx context.Context, txHash common.Hash) (*types.Receipt, error)
	FilterLogs(ctx context.Context, q ethereum.FilterQuery) ([]types.Log, error)
	Close()
}

EthereumJSONRPCClient represents the functionality of github.com/ethereum/go-ethereum/ethclient.Client

type Header

type Header struct {
	ParentHash    common.Hash    `json:"parentHash"       gencodec:"required"`
	Number        *hexutil.Big   `json:"number"           gencodec:"required"`
	Time          hexutil.Uint64 `json:"timestamp"        gencodec:"required"`
	Hash          common.Hash    `json:"hash"`
	Transactions  []common.Hash  `json:"transactions"     gencodec:"required"`
	L1BlockNumber *hexutil.Big   `json:"l1BlockNumber"`
}

Header represents a block header in any EVM blockchain

type JSONRPCClient

type JSONRPCClient interface {
	CallContext(ctx context.Context, result interface{}, method string, args ...interface{}) error
}

JSONRPCClient represents the functionality of github.com/ethereum/go-ethereum/rpc.Client

type MoonbeamClient

type MoonbeamClient struct {
	*EthereumClient
}

MoonbeamClient is a JSON-RPC client of Moonbeam

func NewMoonbeamClient

func NewMoonbeamClient(ethereumClient *EthereumClient) (*MoonbeamClient, error)

NewMoonbeamClient is the constructor

func (*MoonbeamClient) IsFinalized

func (c *MoonbeamClient) IsFinalized(ctx context.Context, _ uint64, txReceipt *types.Receipt) (bool, error)

IsFinalized determines whether or not the given transaction receipt is finalized on the chain