Moduleweb3-ethereum-1.1.0.1Haskell2010

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.

Contents

The Account type
Default node account
Unlockable node account
Local key account
Transaction parameterization function and lenses

Synopsis

class Account
type DefaultAccount
type PersonalAccount
data Personal
type LocalKeyAccount
data LocalKey
value withParam
value to
value value
value gasLimit
value gasPrice
value block
value account
value timeout

Packageweb3-ethereum-1.1.0.1
Exports14
LanguageHaskell2010
LicenceApache-2.0
SourceAccount.hs

The `Account` type

classclass MonadTrans t => Account a (t :: (Type -> Type) -> Type -> Type) | t -> a where

Source#

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 :: JsonRpc m => a -> t m b -> m b
Run computation with given account credentials
send :: (JsonRpc m, Method args) => args -> t m (Either HexString TxReceipt)
Send transaction to contract, like a write command
call :: (JsonRpc m, Method args, AbiGet result) => args -> t m result
Call constant method of contract, like a read command

Instances3Account

Account LocalKey LocalKeyAccountDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.LocalKey
Account Personal PersonalAccountDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.Personal
Account () DefaultAccountDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.Default · orphan

Default node account

typetype DefaultAccount = AccountT ()

Unlockable node account

typetype PersonalAccount = AccountT Personal

datadata Personal

Source#

Unlockable node managed account params

Constructors

Personal
- personalAddress :: !Address
- personalPassphrase :: !Passphrase

Instances4Eq, Show, Default, Account

Eq PersonalDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.Personal
Show PersonalDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.Personal
Default PersonalDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.Personal
Account Personal PersonalAccountDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.Personal

Local key account

typetype LocalKeyAccount = AccountT LocalKey

datadata LocalKey

Source#

Local EOA params

Constructors

LocalKey
- localKeyPrivate :: !PrivateKey
- localKeyChainId :: !Integer

Instances4Eq, Show, Default, Account

Eq LocalKeyDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.LocalKey
Show LocalKeyDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.LocalKey
Default LocalKeyDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.LocalKey
Account LocalKey LocalKeyAccountDefined in web3-ethereum-1.1.0.1 · Network.Ethereum.Account.LocalKey

Transaction parameterization function and lenses

valuewithParam

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

Source#

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

valueto :: Functor f => (Address -> f Address) -> CallParam p -> f (CallParam p)

Source#

Transaction recipient lens

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

Source#

Transaction value lens

valuegasLimit

:: Functor f
=> Integer -> f Integer
-> CallParam p
-> f (CallParam p)

Source#

Transaction gas limit lens

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

Source#

Transaction gas price lens

valueblock

:: Functor f
=> DefaultBlock -> f DefaultBlock
-> CallParam p
-> f (CallParam p)

Source#

Call execution block lens

valueaccount :: Functor f => (p -> f p) -> CallParam p -> f (CallParam p)

Source#

EOA params lens

valuetimeout

:: Functor f
=> Maybe Int -> f (Maybe Int)
-> CallParam p
-> f (CallParam p)

Source#

Transaction timeout lens

The Account type

Methods

Default node account

Unlockable node account

Constructors

Local key account

Constructors

Transaction parameterization function and lenses

The `Account` type