Elld stands for Ellcrys Daemon.
It is the official client software used to connect and interact with the Ellcrys networks. It is actively developed and maintained by the Ellcrys team.
With Elld, users will be able to start a private network, join an existing network, mine blocks, construct transactions and read the state of the network.
There are pre-built binaries of the client for Linux, MacOS and Windows platforms. They can be found on the release page of every new version of software. See our release page for the latest builds.
If you are interested in building from source, please follow these steps:
Fetch the source:
go get -u -d github.com/ellcrys/elldcd $GOPATH/src/github.com/ellcrys/elld
Build the source
To start Elld, use the following command
elld start -a "0.0.0.0:9000"
The command above will start a node using defaults settings. The node will listen for connections from other peers on the address specified with
When the node starts, an ephemeral key is used to derive the node's identity when interacting with other nodes on the network. Ephemeral keys are temporary; They are disposed of when the node stops running.
Elld will not allow CPU mining operation when the node is using an ephemeral key as the operator will lose any mining reward to the temporary address since they will have no access and control over it.
To remove the restrictions that are in place when Elld starts with an ephemeral account, we need to run Elld with a locally stored account. A local account includes an encrypted key that is stored on the node's disk. To create a key, run the command below:
elld account create# Output# New account created, encrypted and stored# Address: eFjwxLSvseLSafgqMk4UGsnBNUfUy6N2hh
The above command will prompt you to enter a passphrase which is used to encrypt the created key. You can use
--pwd flag to provide the passphrase and skip the interactive session.
After creating an account, you can launch Elld using the new account like this:
elld start -a "0.0.0.0:9000" --account "eFjwxLSvseLSafgqMk4UGsnBNUfUy6N2hh"
Or you can specify the index of the account:
elld start -a "0.0.0.0:9000" --account 0
The index of an account is displayed when you list all accounts. See account management to learn about listing and managing accounts.
When you start the client, you should be automatically joined with several hardcoded seed peers embedded into the client. However, you can specify your own peers using the
elld start \-a "0.0.0.0:9000" \-j "ellcrys://[email protected]0:9000"
You can use multiple
--addnode flags to provide as many addresses as you wish.
Elld client provides JSON-RPC 2.0 APIs that allows external applications to access various services and information. These APIs allow you to write custom scripts or build custom applications that interact with the client and the network. By default, the RPC service is not enabled. To turn it on, use the
--rpc flag when starting the client.
elld start --rpc
Once started, the server will be reachable on
127.0.0.1:8999 by default. Use
--rpc-address to change the listening address.
elld start --rpc --rpc-address "127.0.0.1:9500"
To attach to a locally running client running on the default address
127.0.0.1:8999, use the
If the client is running on a different address, use
--rpc-address flag to point to the client.
elld attach --rpc-address="127.0.0.1:8999"
Accounts are local wallets that store your private keys on your computer. An account is encrypted with a passphrase provided by its creator.
To create an account using Elld, use the
elld account create
The above command will start an interactive session that will ask you to enter a passphrase to be used to encrypt the account on disk. The final output will be similar to this:
Your new account needs to be locked with a password. Please enter a password.Passphrase:Repeat Passphrase:New account created, encrypted and storedAddress: eGAqjozAPCwktR2iWQsZ83QjBqzf3dG4iL
You can share the address with anyone to receive ELL.
We provide helper commands designed to make it easy to run and manage a client in docker.
go get -u -d https://github.com/ellcrys/elldcd $GOPATH/src/github.com/ellcrys/elld
We have included several make targets for starting, stopping, attaching to and destroying a client in docker.
Use the below command to build a container that includes the latest version of Elld.
make build# make rebuild // Re-build the container.
The command above will create a container named
Start the container
env ELLD_RPC_ENABLED=true make start
This will start the container using default configurations. You can configure startup parameters by setting some environment variables. The container's volume which contains the data created and accessed by the client is located on the host machine at
make exec c="echo hello!"
-h flag to learn more about the commands and available flags.