Network.Ethereum.Web3.Eth

Ethereum node JSON-RPC API methods with eth_ prefix.

Documentation

protocolVersion :: Provider a => Web3 a Text

Returns the current ethereum protocol version.

coinbase :: Provider a => Web3 a Address

Returns an object with data about the sync status or false. syncing :: Proviver a => Web3 a Text

Returns the client coinbase address.

mining :: Provider a => Web3 a Bool

Returns true if client is actively mining new blocks.

hashrate :: Provider a => Web3 a Text

Returns the number of hashes per second that the node is mining with.

getStorageAt :: Provider a => Address -> Text -> DefaultBlock -> Web3 a Text

Returns the value from a storage position at a given address.

getTransactionCount :: Provider a => Address -> DefaultBlock -> Web3 a Text

Returns the number of transactions sent from an address.

getBlockTransactionCountByHash :: Provider a => Text -> Web3 a Text

Returns the number of transactions in a block from a block matching the given block hash.

getBlockTransactionCountByNumber :: Provider a => Text -> Web3 a Text

Returns the number of transactions in a block matching the given block number.

getUncleCountByBlockHash :: Provider a => Text -> Web3 a Text

Returns the number of uncles in a block from a block matching the given block hash.

getUncleCountByBlockNumber :: Provider a => Text -> Web3 a Text

Returns the number of uncles in a block from a block matching the given block number.

getCode :: Provider a => Address -> DefaultBlock -> Web3 a Text

Returns code at a given address.

sign :: Provider a => Address -> Text -> Web3 a Text

Returns an Ethereum specific signature with: sign(keccak256("x19Ethereum Signed Message:n" + len(message) + message))).

sendTransaction :: Provider a => Call -> Web3 a Text

Creates new message call transaction or a contract creation, if the data field contains code.

sendRawTransaction :: Provider a => Text -> Web3 a Text

Creates new message call transaction or a contract creation for signed transactions.

getBalance :: Provider a => Address -> DefaultBlock -> Web3 a Text

Returns the balance of the account of given address.

newFilter :: Provider a => Filter -> Web3 a FilterId

Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call getFilterChanges.

getFilterChanges :: Provider a => FilterId -> Web3 a [Change]

Polling method for a filter, which returns an array of logs which occurred since last poll.

uninstallFilter :: Provider a => FilterId -> Web3 a Bool

Uninstalls a filter with given id. Should always be called when watch is no longer needed.

getLogs :: Provider a => Filter -> Web3 a [Change]

Returns an array of all logs matching a given filter object.

call :: Provider a => Call -> DefaultBlock -> Web3 a Text

Executes a new message call immediately without creating a transaction on the block chain.

estimateGas :: Provider a => Call -> Web3 a Text

Makes a call or transaction, which won't be added to the blockchain and returns the used gas, which can be used for estimating the used gas.

getBlockByHash :: Provider a => Text -> Web3 a Block

Returns information about a block by hash.

getBlockByNumber :: Provider a => Text -> Web3 a Block

Returns information about a block by block number.

getTransactionByHash :: Provider a => Text -> Web3 a (Maybe Transaction)

Returns the information about a transaction requested by transaction hash.

getTransactionByBlockHashAndIndex :: Provider a => Text -> Text -> Web3 a (Maybe Transaction)

Returns information about a transaction by block hash and transaction index position.

getTransactionByBlockNumberAndIndex :: Provider a => DefaultBlock -> Text -> Web3 a (Maybe Transaction)

Returns information about a transaction by block number and transaction index position.

accounts :: Provider a => Web3 a [Address]

Returns the receipt of a transaction by transaction hash. TODO must create new type, TxReceipt getTransactionReceipt :: Provider a => Text -> Web3 a TxReceipt getTransactionReceipt = remote "getTransactionReceipt"

Returns a list of addresses owned by client.

newBlockFilter :: Provider a => Web3 a Text

getBlockFilterChanges :: Provider a => Text -> Web3 a [Text]

Polling method for a block filter, which returns an array of block hashes occurred since last poll.

blockNumber :: Provider a => Web3 a Text

Returns the number of most recent block.

gasPrice :: Provider a => Web3 a Text

Returns the current price per gas in wei.

getUncleByBlockHashAndIndex :: Provider a => Text -> Text -> Web3 a Block

Returns information about a uncle of a block by hash and uncle index position.

getUncleByBlockNumberAndIndex :: Provider a => DefaultBlock -> Text -> Web3 a Block

Returns information about a uncle of a block by number and uncle index position.

newPendingTransactionFilter :: Provider a => Web3 a Text

Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call getFilterChanges. Returns a FilterId.

getFilterLogs :: Provider a => Text -> Web3 a [Change]

Returns an array of all logs matching filter with given id.

getWork :: Provider a => Web3 a [Text]

Returns the hash of the current block, the seedHash, and the boundary condition to be met ("target").

submitWork :: Provider a => Text -> Text -> Text -> Web3 a Bool

Used for submitting a proof-of-work solution. Parameters: 1. DATA, 8 Bytes - The nonce found (64 bits) 2. DATA, 32 Bytes - The header's pow-hash (256 bits) 3. DATA, 32 Bytes - The mix digest (256 bits)

submitHashrate :: Provider a => Text -> Text -> Web3 a Bool

Used for submitting mining hashrate. Parameters: 1. Hashrate, a hexadecimal string representation (32 bytes) of the hash rate 2. ID, String - A random hexadecimal(32 bytes) ID identifying the client