arkhai-io/alkahest

Alkahest is a library and ecosystem of contracts for conditional peer-to-peer escrow. It contains three main types of contracts:

• Escrow contracts conditionally guarantee an on-chain action (usually a token transfer)
• Arbiter contracts represent the conditions on which escrows are released, and can be composed via AllArbiter and AnyArbiter
• Obligation contracts produce EAS attestations that represent the fulfillments to escrows, and which are checked by arbiter contracts. Escrow contracts are also obligation contracts.

Learn more at Alkahest Docs.

Security

Alkahest has been audited by Zellic. The full audit report is available in docs/audits/reports/zellic-2026-06-30.pdf.

Repository Structure

This is a monorepo containing the Alkahest smart contracts and SDKs for multiple languages:

alkahest/
├── contracts/          # Solidity smart contracts and Foundry tooling
│   ├── src/           # Contract source code
│   ├── test/          # Contract tests
│   ├── script/        # Deployment scripts
│   └── lib/           # Dependencies (forge-std, EAS, OpenZeppelin)
├── sdks/              # Language-specific SDKs
│   ├── py/           # Python SDK
│   ├── rs/           # Rust SDK
│   └── ts/           # TypeScript SDK
└── docs/              # Documentation

Quick Start

Smart Contracts

The contracts are built with Foundry.

cd contracts
forge build
forge test

See contracts/README.md for more details.

SDKs

Each SDK has its own setup and usage instructions:

• Python: See sdks/py/README.md
• Rust: See sdks/rs/README.md
• TypeScript: See sdks/ts/README.md

Documentation

Comprehensive guides and tutorials are available in the docs/ directory:

• Escrow Flow (pt 1 - Token Trading) - Trade tokens for tokens using escrow and payment obligations
• Escrow Flow (pt 2 - Job Trading) - Escrow with off-chain validation via TrustedOracleArbiter