Network.Ethereum.Account

In Etereun there are two types of accounts: * Externally owned account (EOAs): an account controlled by a private key, and if you own the private key associated with the EOA you have the ability to send ether and messages from it. * Contract: an account that has its own code, and is controlled by code.

This module exports different kinds of EOAs: default, node managed and local. Node managed accounts use Personal JSON-RPC API for signing transactions. Local account sign transaction locally and use sendRawTransaction method to export transaction to Ethereum network.

The Account type

class MonadTrans t => Account a t | t -> a where

Account is needed for sending transactions to blockchain

Typically account is provided by node. In this case node manage accounts: encrypt and decrypt private keys, manipulate files etc. In other case web3 can derive account from private key and send to node already signed transactions.

Minimal complete definition

withAccount, send, call

Methods

withAccount

Arguments

:: JsonRpc m

=> a

Account params (like a password or private key)

-> t m b

Computation that use account for sending transactions

-> m b

Json-rpc monad

Run computation with given account credentials

send

Arguments

:: (JsonRpc m, Method args)

=> args

Contract method arguments

-> t m TxReceipt

Receipt of sended transaction

Send transaction to contract, like a write command

call

Arguments

:: (JsonRpc m, Method args, AbiGet result)

=> args

Contact method arguments

-> t m result

Decoded result of method call

Call constant method of contract, like a read command

Instances

Account () DefaultAccount

Defined in Network.Ethereum.Account.Default

Methods

withAccount :: JsonRpc m => () -> DefaultAccount m b -> m b

send :: (JsonRpc m, Method args) => args -> DefaultAccount m TxReceipt

call :: (JsonRpc m, Method args, AbiGet result) => args -> DefaultAccount m result

Account PrivateKey PrivateKeyAccount

Defined in Network.Ethereum.Account.PrivateKey

Methods

withAccount :: JsonRpc m => PrivateKey -> PrivateKeyAccount m b -> m b

send :: (JsonRpc m, Method args) => args -> PrivateKeyAccount m TxReceipt

call :: (JsonRpc m, Method args, AbiGet result) => args -> PrivateKeyAccount m result

Account Personal PersonalAccount

Defined in Network.Ethereum.Account.Personal

Methods

withAccount :: JsonRpc m => Personal -> PersonalAccount m b -> m b

send :: (JsonRpc m, Method args) => args -> PersonalAccount m TxReceipt

call :: (JsonRpc m, Method args, AbiGet result) => args -> PersonalAccount m result

Default node account

type DefaultAccount = AccountT ()

Unlockable node account

type PersonalAccount = AccountT Personal

data Personal

Unlockable node managed account params

Constructors

Personal

Fields

• personalAddress :: !Address
• personalPassphrase :: !Passphrase

Instances

Eq Personal

Defined in Network.Ethereum.Account.Personal

Methods

(==) :: Personal -> Personal -> Bool

(/=) :: Personal -> Personal -> Bool

Show Personal

Defined in Network.Ethereum.Account.Personal

Methods

showsPrec :: Int -> Personal -> ShowS

show :: Personal -> String

showList :: [Personal] -> ShowS

Default Personal

Defined in Network.Ethereum.Account.Personal

Methods

def :: Personal

Account Personal PersonalAccount

Defined in Network.Ethereum.Account.Personal

Methods

withAccount :: JsonRpc m => Personal -> PersonalAccount m b -> m b

send :: (JsonRpc m, Method args) => args -> PersonalAccount m TxReceipt

call :: (JsonRpc m, Method args, AbiGet result) => args -> PersonalAccount m result

Local key account

type PrivateKeyAccount = AccountT PrivateKey

data PrivateKey

Local EOA params

Constructors

PrivateKey

Fields

• privateKey :: !SecKey
• privateKeyChain :: !Integer

Instances

Eq PrivateKey

Defined in Network.Ethereum.Account.PrivateKey

Methods

(==) :: PrivateKey -> PrivateKey -> Bool

(/=) :: PrivateKey -> PrivateKey -> Bool

Show PrivateKey

Defined in Network.Ethereum.Account.PrivateKey

Methods

showsPrec :: Int -> PrivateKey -> ShowS

show :: PrivateKey -> String

showList :: [PrivateKey] -> ShowS

Default PrivateKey

Defined in Network.Ethereum.Account.PrivateKey

Methods

def :: PrivateKey

Account PrivateKey PrivateKeyAccount

Defined in Network.Ethereum.Account.PrivateKey

Methods

withAccount :: JsonRpc m => PrivateKey -> PrivateKeyAccount m b -> m b

send :: (JsonRpc m, Method args) => args -> PrivateKeyAccount m TxReceipt

call :: (JsonRpc m, Method args, AbiGet result) => args -> PrivateKeyAccount m result

Transaction paramitrization function and lenses

withParam :: Account p (AccountT p) => (CallParam p -> CallParam p) -> AccountT p m a -> AccountT p m a

withParam is very similar to withStateT function, it's used to set parameters of transaction locally and revert params after out of scope.

 withAccount () $
   withParam (to .~ tokenAddress) $
     transfer alice 42
 

to :: Lens' (CallParam p) Address

Transaction recipient lens

value :: Unit value => Lens' (CallParam p) value

Transaction value lens

gasLimit :: Lens' (CallParam p) (Maybe Integer)

Transaction gas limit lens

gasPrice :: Unit gasprice => Lens' (CallParam p) (Maybe gasprice)

Transaction gas price lens

block :: Lens' (CallParam p) DefaultBlock

Call execution block lens

account :: Lens' (CallParam p) p

EOA params lens