darkfi

DarkFi - Anonymous, Uncensored, Sovereign

We aim to proliferate anonymous digital markets by means of strong cryptography and peer-to-peer networks. We are establishing an online zone of freedom that is resistant to the surveillance state.

Unfortunately, the law hasn’t kept pace with technology, and this disconnect has created a significant public safety problem. We call it "Going Dark".

James Comey, FBI director

So let there be dark.

About DarkFi

DarkFi is a new Layer 1 blockchain, designed with anonymity at the forefront. It offers flexible private primitives that can be wielded to create any kind of application. DarkFi aims to make anonymous engineering highly accessible to developers.

DarkFi uses advances in zero-knowledge cryptography and includes a contracting language and developer toolkits to create uncensorable code.

In the open air of a fully dark, anonymous system, cryptocurrency has the potential to birth new technological concepts centered around sovereignty. This can be a creative, regenerative space - the dawn of a Dark Renaissance.

Connect to DarkFi Alpha Testnet

DarkFi Alpha Testnet is a PoW blockchain that provides fully anonymous transactions, zero-knowledge contracts, anonymous atomic swaps, a self-governing anonymous DAO, and more.

• darkfid is the DarkFi fullnode. It validates blockchain transactions and stays connected to the p2p network.
• drk is a CLI wallet. It provides an interface to smart contracts such as Money and DAO, manages our keys and coins, and scans the blockchain to update our balances.
• xmrig is the mining daemon used in DarkFi. Connects to darkfid over its Stratum RPC, and requests new block headers to mine.

To connect to the alpha testnet, follow the tutorial.

Connect to DarkFi IRC

Follow the installation instructions for the P2P IRC daemon.

Build

First you need to clone DarkFi repo and enter its root folder, if you haven't already done it:

% git clone https://codeberg.org/darkrenaissance/darkfi
% cd darkfi

This project requires the Rust compiler to be installed. Please visit Rustup for instructions.

You have to install a native toolchain, which is set up during Rust installation, and wasm32 target. To install wasm32 target, execute:

% rustup target add wasm32-unknown-unknown

Minimum Rust version supported is 1.87.0.

The following dependencies are also required:

Dependency	Debian-based
git	git
cmake	cmake
make	make
gcc	gcc
g++	g++
pkg-config	pkg-config
alsa-lib	libasound2-dev
clang	libclang-dev
fontconfig	libfontconfig1-dev
lzma	liblzma-dev
openssl	libssl-dev
sqlcipher	libsqlcipher-dev
sqlite3	libsqlite3-dev

Users of Debian-based systems (e.g. Ubuntu) can simply run the following to install the required dependencies:

# apt-get update
# apt-get install -y git cmake make gcc g++ pkg-config libasound2-dev libclang-dev libfontconfig1-dev liblzma-dev libssl-dev libsqlcipher-dev libsqlite3-dev

Alternatively, users can try using the automated script under contrib folder by executing:

% sh contrib/dependency_setup.sh

The script will try to recognize which system you are running, and install dependencies accordingly. In case it does not find your package manager, please consider adding support for it into the script and sending a patch.

Lastly, we can build the necessary binaries using the provided Makefile, to build the project.

Note:

If you want to build specific binaries, like darkfid or darkirc, skip this step and refer to their build instructions to use the correct release tag/branch and their specific target.

The following command will build everything using master branch.

% make

Development

If you want to hack on the source code, make sure to read some introductory advice in the DarkFi book.

Installation (Optional)

This will install the binaries on your system (/usr/local by default). The configuration files for the binaries are bundled with the binaries and contain sane defaults. You'll have to run each daemon once in order for them to spawn a config file, which you can then review.

# make install

Examples and usage

See the DarkFi book

Go Dark

Let's liberate people from the claws of big tech and create the democratic paradigm of technology.

Self-defense is integral to any organism's survival and growth.

Power to the minuteman.