The Oracle Server is a DLC Oracle with functionality for creating events and attesting to them.
You can interact with the oracle server with
The following a guide is for how to build the oracle server. If you are looking for the documentation on how to use the oracle server, checkout this page.
Step 1: Java and Scala
To get started you will need Java, Scala, and some other nice tools installed, luckily the Scala team has an easy setup process!
Simply follow the instructions in this short blog to get started.
Step 2: Bitcoin-S Repository
Now, it is time to clone the Bitcoin-S repository by running
git clone --recursive [email protected]:bitcoin-s/bitcoin-s.git
or alternatively, if you do not have ssh setup with github, you can run
git clone --recursive https://github.com/bitcoin-s/bitcoin-s.git
Next, you will want to execute the commands
cd bitcoin-s git submodule update
to download the secp256k1 submodule, this is so cryptographic functions like signing will be faster.
Step 3: Building the Oracle Server
In this example we are going to use
stage which will produce bash scripts we can easily execute. You can stage the server with the following command.
This will produce a script to execute bitcoin-s which you can start with
Alternatively you can run the server by just using:
Step 4: Configuration
If you would like to pass in a custom datadir for your server, you can do
./app/oracle-server/target/universal/stage/bin/bitcoin-s-oracle-server --datadir /path/to/datadir/
To use a config file that is not the
bitcoin-s.conf file in your datadir, you can do
./app/oracle-server/target/universal/stage/bin/bitcoin-s-oracle-server --conf /path/to/file.conf
You can also pass in a custom
rpcport to bind to
./app/oracle-server/target/universal/stage/bin/bitcoin-s-oracle-server --rpcport 12345
For more information on configuring the server please see our configuration document.
For more information on how to use our built in
cli to interact with the server please see the cli docs.