client

type BalancesProvider interface {
	// Balance obtains the balance for the given address at the given block ID.
	Balance(ctx context.Context, address types.Address, blockID string) (*big.Int, error)
}

type BaseFeeProvider interface {
	// BaseFee provides the base fee of the chain at the given block ID.
	BaseFee(ctx context.Context, blockID string) (*big.Int, error)
}

type BlockReplaysProvider interface {
	// ReplayBlockTransactions obtains traces for all transactions in a block.
	ReplayBlockTransactions(ctx context.Context, blockID string) ([]*api.TransactionResult, error)
}

type BlocksProvider interface {
	// Block returns the block with the given ID.
	Block(ctx context.Context, blockID string) (*spec.Block, error)
}

type CallOpts struct {
	From     *types.Address
	To       *types.Address
	Gas      *big.Int
	GasPrice *big.Int
	Value    *big.Int
	Data     []byte
	Block    string
}

type CallProvider interface {
	// Call makes a call to the execution client.
	Call(ctx context.Context, opts *CallOpts) ([]byte, error)
}

type ChainHeightProvider interface {
	// ChainHeight returns the height of the chain as understood by the node.
	ChainHeight(ctx context.Context) (uint32, error)
}

type ChainIDProvider interface {
	// ChainID returns the chain ID.
	ChainID(ctx context.Context) (uint64, error)
}

type EventsProvider interface {
	// Events returns the events matching the filter.
	Events(ctx context.Context, filter *api.EventsFilter) ([]*spec.BerlinTransactionEvent, error)
}

type GasEstimationProvide interface {
	// EstimateGas estimates the gas required for a transaction.
	EstimateGas(ctx context.Context, tx *spec.TransactionSubmission) (*big.Int, error)
}

type IssuanceProvider interface {
	// Issuance returns the issuance of a block.
	Issuance(ctx context.Context, blockID string) (*api.Issuance, error)
}

type NetworkIDProvider interface {
	// NetworkID returns the network ID.
	NetworkID(ctx context.Context) (uint64, error)
}

type NewPendingTransactionsProvider interface {
	// NewPendingTransactions subscribes to new pending transactions.
	NewPendingTransactions(ctx context.Context, ch chan *spec.Transaction) (*util.Subscription, error)
}

type Service interface {
	// Name returns the name of the client implementation.
	Name() string

	// Address returns the address of the client.
	Address() string
}

type SyncingProvider interface {
	// Syncing obtains information about the sync state of the node.
	Syncing(ctx context.Context) (*api.SyncState, error)
}

type TransactionReceiptsProvider interface {
	// TransactionReceipt returns the transaction receipt for the given transaction hash.
	TransactionReceipt(ctx context.Context, hash types.Hash) (*spec.TransactionReceipt, error)
}

type TransactionsProvider interface {
	// Transaction returns the transaction for the given transaction hash.
	Transaction(ctx context.Context, hash types.Hash) (*spec.Transaction, error)

	// TransactionInBlock returns the transaction for the given transaction in a block at the given index.
	TransactionInBlock(ctx context.Context, blockHash types.Hash, index uint32) (*spec.Transaction, error)
}