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.

5 types
1 class
8 values

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

The `Account` type

1 declaration

classclass MonadTrans t => Account a (t :: (Type -> Type) -> Type -> Type) | 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 :: 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

1 declaration

typetype DefaultAccount = AccountT ()

Unlockable node account

2 declarations

typetype PersonalAccount = AccountT Personal

datadata Personal

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

2 declarations

typetype LocalKeyAccount = AccountT LocalKey

datadata LocalKey

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

8 declarations

valuewithParam

:: 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

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

Transaction recipient lens

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

Transaction value lens

valuegasLimit

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

Transaction gas limit lens

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

Transaction gas price lens

valueblock

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

Call execution block lens

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

EOA params lens

valuetimeout

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

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