Skip to content
External agents for the Syscoin <=> Ethereum bridge
Branch: master
Clone or download
Pull request Compare This branch is 416 commits ahead of dogethereum:master.
Type Name Latest commit message Commit time
Failed to load latest commit information.
data server enabled config Nov 14, 2019
src server enabled config Nov 14, 2019
.gitignore Improve .gitignore Oct 2, 2019
LICENSE add rpc proxy for core May 9, 2019
pom.xml update libdohj to 0.15.26 Nov 14, 2019

Sysethereum Agents

A set of agents:

  • Syscoin superblock submitter ( Sends syscoin superblocks.
  • Superblock challenger ( Challenges invalid superblocks sent by rogue submitters.
  • Superblock defender ( Replies to challenges made by rogue challengers.

If you are new to the Syscoin <-> Ethereum bridge, please check the docs repository first.



  • JDK 11 or superior
  • Ganache
  • Truffle

Run Ganache (For testing only)

ganache -l GAS_LIMIT -p 8545
  1. Replace GAS_LIMIT with the value used in the configuration file
  2. Deploy contracts to Ganache
  3. Run scripts/

Run Syscoin daemon

  1. Start the syscoin node in mode:
    syscoind -datadir=DATADIR
  2. Mine 1 syscoin block to "wake up" the syscoin node in regtest mode
  3. Verify it is working
    syscoin-cli -datadir=DATADIR getblockchaininfo

How to setup project in IntelliJ IDEA

  • Clone this repository
  • Open IntelliJ IDEA
  • Import project as Maven
  • Modify configuration file data/sysethereum-agents.conf (see section below)
  • Create Run configuration
    • In Run/Edit Configurations... add a new "Application" configuration
    • Set parameters like this
      • Name: Main local
      • Main class: org.sysethereum.agents.Main
      • VM options: -Dsysethereum.agents.conf.file=path_to_configuration_file
    • Note: Use double backslash as separator on Windows


Sample configuration file is located in data/sysethereum-agents.conf. We recommend to make a copy of the file and use that copy when running agents.

The following properties need to be properly set:

  • Edit to point to your syscoin data directory path
  • Edit these entries related to your accounts and credentials for sending/defending superblocks:
    • general.purpose.and.send.superblocks.address
    • general.purpose.and.send.superblocks.unlockpw
  • Edit these entries related to your accounts and credentials for challenging invalid superblocks:
    • syscoin.superblock.challenger.address
    • syscoin.superblock.challenger.unlockpw

Note: Windows paths have to be enclosed by quote signs ("value") and with double backslash \\ as separator - e.g. = "D:\\sysethereum-agents\\storage\\data"

Email alert

Agent application is able to send a notification email when your superblock is challenged or when any superblock is challenged. The feature is disabled by default. However, you can enable it in data/sysethereum-agents.conf in agent.mailer section.

Warning: Predefined Google settings in the configuration file may not work out of box if you do not have allowed less secure apps access (please refer to and Ideally, you may use some other SMTP server where you whitelist Sysethereum Agents application to make sure any email notification is always delivered.

Run the agents via IDEA

  • Delete agent data directory ( config variable) before each restart just to make sure you are on the safe side
  • In IntelliJ IDEA go to Run/Run...
  • Select "Main local" run configuration

Run the agents in terminal

mvn compile && mvn exec:java -Dsysethereum.agents.conf.file=data/sysethereum-agents.conf


MIT License
Copyright (c) 2019 Jagdeep Sidhu
Copyright (c) 2018 Coinfabrik & Oscar Guindzberg

You can’t perform that action at this time.