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.

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 :: forall (m :: Type -> Type) args. (JsonRpc m, Method args) => args -> DefaultAccount m TxReceipt

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

Account Personal PersonalAccount

Defined in Network.Ethereum.Account.Personal

Methods

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

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

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

Account LocalKey LocalKeyAccount

Defined in Network.Ethereum.Account.LocalKey

Methods

withAccount :: JsonRpc m => LocalKey -> LocalKeyAccount m b -> m b

send :: forall (m :: Type -> Type) args. (JsonRpc m, Method args) => args -> LocalKeyAccount m TxReceipt

call :: forall (m :: Type -> Type) args result. (JsonRpc m, Method args, AbiGet result) => args -> LocalKeyAccount 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 :: forall (m :: Type -> Type) args. (JsonRpc m, Method args) => args -> PersonalAccount m TxReceipt

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

Local key account

type LocalKeyAccount = AccountT LocalKey

data LocalKey

Local EOA params

Constructors

LocalKey

Fields

• localKeyPrivate :: !PrivateKey
• localKeyChainId :: !Integer

Instances

Eq LocalKey

Defined in Network.Ethereum.Account.LocalKey

Methods

(==) :: LocalKey -> LocalKey -> Bool

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

Show LocalKey

Defined in Network.Ethereum.Account.LocalKey

Methods

showsPrec :: Int -> LocalKey -> ShowS

show :: LocalKey -> String

showList :: [LocalKey] -> ShowS

Default LocalKey

Defined in Network.Ethereum.Account.LocalKey

Methods

def :: LocalKey

Account LocalKey LocalKeyAccount

Defined in Network.Ethereum.Account.LocalKey

Methods

withAccount :: JsonRpc m => LocalKey -> LocalKeyAccount m b -> m b

send :: forall (m :: Type -> Type) args. (JsonRpc m, Method args) => args -> LocalKeyAccount m TxReceipt

call :: forall (m :: Type -> Type) args result. (JsonRpc m, Method args, AbiGet result) => args -> LocalKeyAccount m result

Transaction parameterization 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) Integer

Transaction gas limit lens

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

Transaction gas price lens

block :: Lens' (CallParam p) DefaultBlock

Call execution block lens

account :: Lens' (CallParam p) p

EOA params lens