https://github.com/diodechain/diode_server
Diode Server
https://github.com/diodechain/diode_server
Last synced: about 2 months ago
JSON representation
Diode Server
- Host: GitHub
- URL: https://github.com/diodechain/diode_server
- Owner: diodechain
- License: other
- Created: 2019-08-17T06:44:38.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-31T13:47:43.000Z (2 months ago)
- Last Synced: 2025-04-10T23:04:53.746Z (about 2 months ago)
- Language: Elixir
- Homepage: https://diode.io
- Size: 1.78 MB
- Stars: 43
- Watchers: 6
- Forks: 9
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> ### Secure. Super Light. Web3.
> An Ethereum Chain Fork for the Web3
[](https://travis-ci.com/diodechain/diode_server_ex)
# Diode Miner & Traffic Gateway
This server is the main Diode blockchain node. It implements both Diode PEER and EDGE protocols. After startup it will automatically connect to the network, and start mining and start acting as a traffic relay.
Traffic Gateways should always be setup on publicly reachable interfaces with a public IP. If the Node is not reachable from other nodes it might eventually blocked.
By default it will mine using 75% of one CPU. This number can be controlled or set to 'disabled' using the environment variable `WORKER_MODE`
Alternative it can be specified using an additional config file in config/diode.exs:
```Elixir
use Mix.Config
System.put_env("WORKER_MODE", "50")
# System.put_env("WORKER_MODE", "disabled")
```
# Default Ports
TCP port bindings can be controlled through environment variables. The default bindings are:
| Variable | Description | Default Port(s) |
| -------- | ----------- | ---- |
| `RPC_PORT` | Ethereum JSON API endpoint | 8545
| `RPCS_PORT` | SSL version of `RPC_PORT`* | 8443
| `EDGE2_PORT` | Client Communication Port | 41046,443,993,1723,10000
| `PEER_PORT` | Miner-To-Miner Communication Port | 51054
`RPCS_PORT` is only used & needed for access from Web2 services such as the blockchain explorer at https://diode.io/prenet/ - the port can be ignored in most deployments.
`EDGE2_PORT` and `PEER_PORT` support multiple port numbers given by a comma separated list.
# Defining the Wallet to be used
By default the miner will autogenerate a Wallet on startup. This wallet can be inspected on the remote shell:
```
> ./remsh
iex> Wallet.printable(Diode.miner())
```
And it's private key can be printed and saved for backup using:
```
> ./remsh
iex> Base16.encode(Wallet.privkey!(Diode.miner()))
```
To inject a stored Wallet into the server the enviornment variable `PRIVATE` can be setup, before starting the miner.
```
export PRIVATE=0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
supervise .
```
# Pre-Requisites
* Elixir 1.10.4
* make & autoconf & libtool-bin & gcc & g++ & boost
* daemontools
# Building
```bash
mix deps.get
mix compile
```
## erl_nif.h not found
In case you receive the `erl_nif.h` not found error add this:
```bash
export CFLAGS=-I`erl -eval 'io:format("~s", [lists:concat([code:root_dir(), "/erts-", erlang:system_info(version), "/include"])])' -s init stop -noshell`
```
## Building on macOS
On macOS after installing boost with brew you might need to add it to the environment variables, so the compiler can find it:
```bash
brew install boost
export CFLAGS=-I`brew --prefix boost`/include
export LDFLAGS=-L`brew --prefix boost`/lib
```
# Running tests
```bash
make test
```
# Using for smart contract development
The diode server can be used as RPC server for Smart Contract development. To start a local network similiar to _ganache_ there is a predefined shell script. Just run:
```
./dev
```
And a dedicated local rpc server start-up
# Running
The initial syncing of the network will take multiple hours. So it's advised to start directly with a superviser such as from the daemontools. To start with that
on macOS or linux run:
```
supervise .
```
# Diferences from main Ethereuem (geth)
- Block Header: We added the Miner Signature for BlockQuick
- No ommers
- EVM
- 100% Constantinople instruction set
- blockhash() limit has been extended from the 256 previous blocks to previous 131072 blocks instead
- Protocols
- Node-to-Node Protocol (PEER) has been *replaced* to implement Gateway functionality
- Node-to-Edge Protocol (EDGE) has been *added* for communication with IoT devices, desktop, mobile and other nano client applications.
- RPC
- Mostly compatible (please report issues when you find a difference to the official Ethereum RPC)
- Added Diode Commands
- dio_getObject (object_key)
Fetches one object such as device information from the Kademlia-Network
- dio_getNode (node_key)
Fetches information about the specified node when existing.
- dio_getPool
Returns the current transaction pool.
- dio_codeCount* (hash)
Returns the number of accounts that have a matching code hash. This is usefull to count the deployments of a certain contract.
- dio_codeGroups*
Returns code hashes and counts of all deployed contracts. (Likely to be removed)
- dio_supply
Returns the existing supply of DIO in the network.
- dio_network
Returns the network of connected Miners known to the current node.
- dio_accounts*
Returns a list of known accounts.
Those commands with a * will likely be removed or changed when the network has grown beyond certain bounds making these calls harder to scale.