30
69
Fork
You've already forked darkfi
54
Anonymous. Uncensored. Sovereign. https://dark.fi
  • Rust 82.3%
  • Jupyter Notebook 6.6%
  • Python 6.4%
  • Sage 2.9%
  • Java 0.5%
  • Other 1.2%
Find a file
2026年07月12日 13:27:34 +02:00
.github/workflows CI: Remove book generation 2026年01月01日 19:48:04 +00:00
bench chore: Update copyright license year 2026年01月01日 11:40:45 +00:00
bin app: cargo update & make enable-plugins default for dev builds 2026年07月12日 13:27:34 +02:00
contrib event_graph: add a special tier and bootstrap genesis events 2026年07月08日 09:25:50 +00:00
doc doc: Add event graph security invariants 2026年07月08日 09:25:51 +00:00
example rpc/jsonrpc: Use i64 ids instead of u16 2026年06月10日 14:11:07 +03:00
fuzz chore: Update crate dependencies 2026年05月19日 12:38:38 +00:00
proof zkas: Support >1 nested calls 2026年01月07日 09:22:55 +00:00
script research/rln-fau: Basic code for RLN ident 2026年07月08日 09:25:51 +00:00
src event_graph: Optional RLN 2026年07月08日 09:25:51 +00:00
tests net: Support TLS dialer/listener without requiring client certificates 2026年06月10日 14:11:07 +03:00
.dockerignore Dockerfile.almalinux and fix builds, latest working b36861fa1d_2023年06月13日 ( #183 ) 2023年08月30日 05:57:33 +00:00
.gitignore explorer: Add WIP rewrite with Tapes db 2026年01月22日 14:35:17 +00:00
Cargo.lock bin/darkirc, bin/tau: use default ports, and remove bin/genev 2026年07月08日 09:25:50 +00:00
Cargo.toml bin/darkirc, bin/tau: use default ports, and remove bin/genev 2026年07月08日 09:25:50 +00:00
IDEOLOGY.md two more typo fixes ( #116 ) 2022年10月27日 19:28:25 +00:00
king.png removed /lisp and added king.png 2021年09月13日 09:13:39 +02:00
LICENSE.md Relicense code to AGPL-3. 2021年09月21日 16:15:20 +02:00
Makefile chore: Clippy lints 2026年04月07日 10:39:08 +00:00
README.md README: s/minuteman/mystic cyber guerilla/ 2026年07月06日 13:43:56 +02:00
rust-toolchain.toml rust: set stable toolchain and clippy chore 2025年11月24日 17:03:48 +02:00
rustfmt.toml wrap_comments to false in rustfmt.toml 2022年01月05日 22:14:44 +04:00

DarkFi - Anonymous, Uncensored, Sovereign

Build Status Web - dark.fi Manifesto - unsystem Book - mdbook

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 mystic cyber guerilla.