evm

README

Usage

The lachesis_addr option specifies the endpoint where the consensus node is listening
to the VM.

The proxy_addr option specifies the endpoint where the VM is listening for consensus events.

NAME:
   evm run -

USAGE:
   evm run [command options] [arguments...]

OPTIONS:
   --datadir value        Directory for the databases and keystore (default: "$HOME/.evm")
   --lachesis_addr value  IP:Port of consensus node (default: "127.0.0.1:1338")
   --proxy_addr value     IP:Port to bind Proxy server (default: "127.0.0.1:1339")
   --api_addr value       IP:Port to bind API server (default: ":8080")
   --log_level value      Debug, info, warn, error, fatal, panic (default: "debug")
   --pwd value            Password file to unlock accounts (default: "$HOME/.evm/pwd.txt")
   --db value             Database file (default: "$HOME/.evm/chaindata")
   --cache value          Megabytes of memory allocated to internal caching (min 16MB / database forced) (default: 128)

Configuration

The application writes data and reads configuration from the directory specified
by the --datadir flag. The directory structure MUST be as follows:

host:~/.evm$ tree
eth
├── genesis.json
└── keystore
    ├── [Ethereum Key File]
    ├── ...
    ├── ...
    ├── [Ethereum Key File]

The Ethereum genesis file defines Ethereum accounts . This file is useful to predefine a set of accounts that own all the initial Ether at the inception of the network.

Example Ethereum genesis.json defining two account:

{
   "alloc": {
        "6cC5F688a315f3dC28A7781717a9A798a59fDA7b": {
            "balance": "1000000000000000000"
        },
        "408d0D182a0397b334a4465Fbe37f3888eE579A7  ": {
            "balance": "1000000000000000000"
        }
   }
}

Get controlled accounts

example:

host:~$ curl http://[api_addr]/accounts -s | json_pp
{
   "accounts" : [
      {
         "address" : "0x6cC5F688a315f3dC28A7781717a9A798a59fDA7b",
         "balance" : 1000000000000000000,
         "nonce": 0
      }
   ]
}

Get any account

host:~$ curl http://[api_addr]/account/0x629007eb99ff5c3539ada8a5800847eacfc25727 -s | json_pp
{
    "address":"0x629007eb99ff5c3539ada8a5800847eacfc25727",
    "balance":1000000000000000000,
    "nonce":0
}

Send transactions from controlled accounts

example: Send Ether between accounts

host:~$ curl -X POST http://[api_addr]/tx -d '{"from":"0x629007eb99ff5c3539ada8a5800847eacfc25727","to":"0xe32e14de8b81d8d3aedacb1868619c74a68feab0","value":6666}' -s | json_pp
{
   "txHash" : "0xeeeed34877502baa305442e3a72df094cfbb0b928a7c53447745ff35d50020bf"
}

Get Transaction receipt

example:

host:~$ curl http://[api_addr]/tx/0xeeeed34877502baa305442e3a72df094cfbb0b928a7c53447745ff35d50020bf -s | json_pp
{
   "to" : "0xe32e14de8b81d8d3aedacb1868619c74a68feab0",
   "root" : "0xc8f90911c9280651a0cd84116826d31773e902e48cb9a15b7bb1e7a6abc850c5",
   "gasUsed" : "0x5208",
   "from" : "0x629007eb99ff5c3539ada8a5800847eacfc25727",
   "transactionHash" : "0xeeeed34877502baa305442e3a72df094cfbb0b928a7c53447745ff35d50020bf",
   "logs" : [],
   "cumulativeGasUsed" : "0x5208",
   "contractAddress" : null,
   "logsBloom" : "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
}

Send raw signed transactions

example:

host:~$ curl -X POST http://[api_addr]/rawtx -d '0xf8628080830f424094564686380e267d1572ee409368e1d42081562a8e8201f48026a022b4f68bfbd4f4c309524ebdbf4bac858e0ad65fd06108c934b45a6da88b92f7a046433c388997fd7b02eb7128f4d2401ef2d10d574c42edf15875a43ee51a1993' -s | json_pp
{
    "txHash":"0x5496489c606d74ad7435568393fa2c4619e64497267f80864109277631aa849d"
}