State For The Stateless Implementation

Requirements

• This project relies on Intel SGX and bitcoin-cli. It been tested on Ubuntu 14.04.1 with SGX 1.8 and Bitcoin Core Daemon version v0.13.1.0-g03422e5.

• Please note that this project assumes the SGX SDK is installed with the prefix /opt/intel/sgxsdk-1.8/.

Build and Run

Default is to build and run on a local testnet with default wallet. Make sure the local wallet has been initialized with getwalletinfo before running.

  $ cd src
  $ make
  $ bitcoind -regtest -daemon
  $ bitcoin-cli getwalletinfo
  $ bitcoin-cli -regtest generate 101
  $ ./app-generic <transaction hash> [Optional: Tip Amound]

Custom JS scripts

Scripts are assumed to be stored in script.js and be in the following format

function nextStep(prevState, stepInput, randomCoins) {
  // Do your functionality here
  return StateToBeEncrypted + '@' + StepOutput + '@' + PublicOutput;
}

The '@' symbols are used as delineators to seperate the three function outputs. The random coins input is a hex string of length 32. If you need more randomness than this, it can be used to seed a PRNG.

Note that SGX doesn't have direct access to trusted time and calling for javascript randomness is not hooked into the sgx_read_rand functionality, so calling these functions from javascript will cause failures.

Related Links

• Please see the paper and the related paper for more information about the cryptographic protocol and related proofs.
• Please see Obscuro Project for how bitcoin has been integrated into SGX
• Please see Luckychain Project for an integration of duktape into SGX

WARNING

WARNING THIS IS DEVELOPMENT SOFTWARE. WE DON'T CERTIFY IT FOR PRODUCTION USE. WE ARE RELEASING THIS DEV VERSION FOR THE COMMUNITY TO EXAMINE, TEST AND (PROBABLY) BREAK. IF YOU SEE SOMETHING, SAY SOMETHING! SEE HOW TO CONTRIBUTE FOR A LIST OF WAYS YOU CAN HELP US.

WARNING WARNING NO, SERIOUSLY. THE ABOVE WARNING IS NOT JUST BOILERPLATE. THIS REALLY IS DEVELOPMENT CODE AND WE'RE STILL ACTIVELY LOOKING FOR THE THINGS WE'VE INEVITABLY DONE WRONG. PLEASE DON'T BE SURPRISED IF YOU FIND OUT WE MISSED SOMETHING FUNDAMENTAL. WE WILL BE TESTING AND IMPROVING IT OVER THE COMING WEEKS.

WARNING WARNING WARNING WE'RE NOT JOKING. DON'T MAKE US TAKE AWAY THE MAKEFILE

WARNING WARNING WARNING WARNING YES THIS IS THE SAME WARNING AS libzerocoin. PLEASE PAY MORE ATTENTION TO THIS WARNING THAN PEOPLE DID TO IT WHEN IT WAS PART OF libzerocoin

Contact

SERIOUSLY, THIS IS RESEARCH CODE AND SHOULD NOT BE DEPLOYED! For questions, please contact gkaptchuk (at) jhu (dot) edu.