hornet

README

HORNET - The IOTA community node

HORNET is a lightweight alternative to IOTA's fullnode software “IRI”. The main advantage is that it compiles to native code and does not need a Java Virtual Machine, which considerably decreases the amount of needed resources while significantly increasing the performance. This way, HORNET is easier to install and runs on low-end devices.

---

Notes

• Currently HORNET is only released for testing purposes. Don't use it for wallet transfers (except testing with small amounts).
• Please open a new issue if you detect an error or crash (or submit a PR if you have already fixed it).
• The issue section is not a support section, if you have questions about HORNET please post them in the #hornet channel (official iota discord server).

---

Contributing

• See CONTRIBUTING

Run HORNET

• Download the latest release for your system (e.g. HORNET-x.x.x_Linux_ARM.tar.gz for the Raspberry Pi 3B)
• Extract the files in a folder of your choice
• Add neighbors to the neighbors.json file
• Download the latest HORNET snapshot from dbfiles.iota.org
• Run HORNET: ./hornet -c config

---

Available plugins

TangleMonitor

• Download the latest TangleMonitor source code

git clone https://github.com/unioproject/tanglemonitor.git

• Modify the config.json to fit your needs
  • "tanglemonitorpath" has to point to the frontend folder of the TangleMonitor source code
  • Add "Monitor" to "enableplugins"
  • Change "host" to "0.0.0.0" if you want to access TangleMonitor from anywhere
  • Only change the "port" and the "apiPort" if you redirect them back to the default ports, because they are hardcoded in the frontend

  "monitor": {
    "tanglemonitorpath": "tanglemonitor/frontend",
    "domain": "",
    "host": "127.0.0.1",
    "port": 4434,
    "apiPort": 4433
  },
  "node": {
    "disableplugins": [],
    "enableplugins": ["Monitor"],
    "loglevel": 127
  },

IOTA Tangle Visualiser

• Download the latest IOTA Tangle Visualiser and socket.io source code

git clone https://github.com/glumb/IOTAtangle.git
git clone https://github.com/socketio/socket.io-client.git

• Modify the config.json to fit your needs
  • "webrootPath" has to point to the frontend folder of the IOTA Tangle Visualiser source code
  • Add "Graph" to "enableplugins"
  • Change "host" to "0.0.0.0" if you want to access IOTA Tangle Visualiser from anywhere

  "graph": {
    "webrootPath": "IOTAtangle/webroot",
    "socketiopath": "socket.io-client/dist/socket.io.js",
    "domain": "",
    "host": "127.0.0.1",
    "port": 8083,
    "networkName": "meets HORNET"
  },
  "node": {
    "disableplugins": [],
    "enableplugins": ["Graph"],
    "loglevel": 127
  },

MQTT Broker

• Modify the mqtt_config.json to fit your needs
  • Change "host" to "0.0.0.0" if you want to access MQTT from anywhere
  • Change "port" to "" and "tlsPort" to a port number if you want to use TLS (you also need certificate files)

{
  ...
  "port": "1883",
  "host": "127.0.0.1",
  ...
  "tlsPort": "",
  "tlsHost": "",
  "tlsInfo": {
    "verify": false,
    "caFile": "tls/ca/cacert.pem",
    "certFile": "tls/server/cert.pem",
    "keyFile": "tls/server/key.pem"
  },
  "plugins": {}
}

• Modify the config.json
  • Add "MQTT" to "enableplugins"

  "node": {
    "disableplugins": [],
    "enableplugins": ["MQTT"],
    "loglevel": 127
  },

Spammer

• Modify the config.json to fit your needs
  • Change "address", "message" and "tag"
  • "tpsratelimit" defines how many transactions (TX) the spammer should try to send (e.g. 0.1 stands for 0.1 TX per second --> 1 TX every 10 seconds. NOTE: the maximum "tpsratelimit" is limited by your used hardware.
  • Add "Spammer" to "enableplugins"

  "spammer": {
    "address": "HORNET99INTEGRATED99SPAMMER999999999999999999999999999999999999999999999999999999",
    "depth": 3,
    "message": "Spamming with HORNET tipselect",
    "tag": "HORNET99INTEGRATED99SPAMMER",
    "tpsratelimit": 0.1,
    "workers": 1
  },
  "node": {
    "disableplugins": [],
    "enableplugins": ["Spammer"],
    "loglevel": 127
  },

---

Docker

Pull HORNET from Docker Hub

Build a Docker image

• See Docker