dcipher

---

Overview

dcipher is a modular protocol for threshold cryptography.
It combines smart contracts and off-chain node operators to enable:

• Asynchronous Distributed Key Generation
• Threshold signing
• Identity-based encryption
• Chain abstraction

The repository is organized into:

• Binaries (bin/) – runnable agents, CLIs, and services.
• Crates (crates/) – Rust libraries used across the project.
• Modules (modules/) – Git submodule dependencies that pull in protocol-specific logic or external components.

---

Repository Structure

Binaries (bin/)

Binary	Purpose	Documentation
adkg-cli	CLI for running and testing Asynchronous Distributed Key Generation ceremonies	README
blocklock-agent	Agent for the Blocklock protocol (time-lock / conditional decryption)
dsigner	Threshold signing daemon, allowing operators to separate condition evaluation and signing for security	README
gen-keys	Utility for key generation (testing / setup)	README
monitoring	An agent that listens/polls dcipher-related information and ships it to prometheus	README
onlyswaps-smoketest	A continuous monitoring and testing tool for only swaps.	README
onlyswaps-solver	An agent for providing token liquidity on chains that support onlyswaps to make yield.	README
onlyswaps-state-api	API for caching and serving state related to ONLYSwaps
onlyswaps-verifier	A dcipher protocol implementation called ONLYSwaps for enabling cross-chain token swaps	README
randomness-agent	A dcipher protocol implementation for providing request-based verifiable randomness on-chain

---

Crates (crates/)

Crate	Purpose
adkg	Core Asynchronous Distributed Key Generation implementation
agent-utils	Utilities shared by dcipher agents
config	Shared configuration handling for agents that use networking, threshold signing, or load config files (TOML, env, etc.)
dcipher-agents	Common agent framework code
generated	Auto-generated Rust bindings from Solidity (kept in sync via generate-bindings.sh)
network	Networking primitives and libp2p integrations
onlyswaps-client	A client to interact with onlyswaps
omnievent	A library for streaming contract events sources into database sinks, and back into filterable streams for apps built on top of alloy
signer	Signing logic (BLS / threshold compatible)
superalloy	A crate providing multiplexing logic for combining alloy providers
utils	General helper utilities

---

Modules (modules/)

These are Git submodule dependencies, not local crates.
They typically include protocol-specific or external components maintained in separate repositories.
Update them with:

git submodule update --init --recursive

---

Getting Started

Prerequisites

• Rust 1.89.0+
• Node.js & npm
• make
• Foundry (if running the tests)

Quickstart

Build everything, including solidity and tests:

make all

Build the repo (but not the tests):

cargo build

Build a specific binary (e.g. adkg-cli):

cargo build --release -p adkg-cli

Build Docker images (requires binaries to be built first):

make build_binaries
make build_docker_randomness-agent
make build_docker_onlyswaps-verifier

Clean artifacts:

make clean
make clean_node_modules
make clean_forge

---

Bindings

If Solidity contracts change, regenerate Rust bindings:

./generate-bindings.sh

CI will fail if bindings are out of sync.

---

Testing

• Rust crates:

cargo test --workspace

---

Contributing

1. Fork & clone the repo
2. Create a feature branch
3. Run cargo test and forge test before pushing
4. Open a PR and ensure CI passes

---

License

Licensed under MIT.