Ethereum Alarm Clock
Homepage: Ethereum Alarm Clock
Looking to download the DApp?: Latest Releases
What is the EAC (Ethereum Alarm Clock)
The Ethereum Alarm Clock is a smart contract protocol for scheduling Ethereum transactions to be executed in the future. It allows any address to set the parameters of a transaction and allow executors (known as TimeNodes) to call these transactions during the desired window. The EAC is agnostic to callers so can be used by both human users and other smart contracts. Since all of the scheduling logic is contained in smart contracts, transactions can be scheduled from solidity, and developers can rely on it as a core piece of their smart contract of decentralized application.
Additionally the EAC faciliates the execution of this pool of scheduled transactions through the TimeNode. The EAC TimeNode continuously runs and watches for transactions which are scheduled to be executed soon then claims and later executes them. For the EAC to be successful it depends on users to run TimeNodes. There are a few ways incentives for running these TimeNodes are baked in to the protocol itself via the claiming mechanism and the bounty payout.
See here for more information about how to run a TimeNode.
Documentation can be found on Read the Docs.
We are in progress of migrating the documentation to the Wiki.
Deployed version is
You can find the address for each network in the networks folder.
Using the CLI
Please see the
cli repository for the commandline client.
Running the tests
Please ensure you are using node version at least 8.0.0 and have truffle and ganache-cli installed.
nvm use lts/carbon npm i npm i -g firstname.lastname@example.org npm i -g ganache-cli
Start ganache-cli in a terminal screen by running
In another terminal screen run
npm test at the root of the directory. This will run the npm test script that
splits up the tests into different runtimes. The tests are split because the EAC is a moderately sized project and
running all the tests with one command has a tendency to break down the ganache tester chain.
Each time you run the tests it is advised to rebuild your build/ folder, as this may lead to bugs if not done. You
can do this by running the command
rm -rf build/.