Declarative smart contracts

A compiler that translates Declarative smart contracts into Solidity programs.

Install dependencies

Build tool: SBT

Compile single smart contract

sbt "run compile benchmarks/[contract_name].dl"

The complete list of benchmark smart contracts are in here.

Other options:

--fuse                   consolidate updates into one function
--materialize <filename> materialize the set of relations specified in file
--out <directory>        output directory

The view materialization file is organized as a csv file, where the names of the materialized relations are separated by comma. See an example. Other examples are located in view-materialization.

Run

1. Generate Solidity programs: sbt "run test"
2. Generate Solidity programs with instrumentations for run-time verification: sbt "run test-instrument"

The generated programs are located at solidity/dsc and solidity/dsc-instrument.

Run in Docker

Alternatively, one could run it in docker.

First install Docker from here.

1. Pull the docker image: docker pull hxchen/fse22-artifact
2. Generate Solidity programs: docker run hxchen/fse22-artifact sh -c "sbt 'run test'; cat solidity/dsc/*.sol"
3. Generate Solidity programs with instrumentations for run-time verification: docker run hxchen/fse22-artifact sh -c "sbt 'run test-instrument'; cat solidity/dsc-instrument/*.sol"

Example contracts

Examples of declarative smart contrats are located in benchmarks.

Verification

Setup Z3

1. Download z3 source.
2. Build z3 and generate Java binding:

   cd z3
   python scripts/mk_make.py --java
   cd build
   make
   

3. Copy files from z3 to dsc project directory:
   • copy com.microsoft.z3.jar to sub-directory called unmanaged.
   • copy libz3.dylib and libz3java.dylib to the project directory.
4. Add the following line to build.sbt:

   Compile / unmanagedJars += {
     baseDirectory.value / "unmanaged" / "com.microsoft.z3.jar"
   }
   

5. In sbt configuration, set working directory as the project directory, so that Java runtime can locate the two dylib file.