ssi-agent: Instructions file for GitHub Copilot

Copilot Cloud Agent Onboarding

Repository Overview

ssi-agent is a Self-Sovereign Identity (SSI) agent implementing OpenID4VCI (issuance) and OpenID4VP (verification) protocols. It's a Rust Tokio-based service that manages identity credentials, digital wallets, and credential verification flows.

• Language: Rust 1.94.0+ (enforced in Cargo.toml rust-version)
• Build System: Cargo workspace with 18 crates
• HTTP Framework: Axum 0.8 with Tokio async runtime
• Persistence: PostgreSQL with CQRS-ES event sourcing pattern
• Code Size: ~15K LOC across distributed domain-driven crates
• Architecture: Domain-driven design with bounded contexts (issuance, holder, verification, authorization, identity)

Build & Test Instructions

All commands run from repository root. Always use cargo commands; do not use shell scripts for building.

Bootstrap (one-time setup)

# Install Rust 1.94.0+ (use dtolnay/rust-toolchain@stable for CI version)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup component add rustfmt clippy

# Verify installation
cargo --version  # Should show 1.94.0+

Build

# Full workspace build (includes all 18 crates)
cargo build --workspace

# Build specific crate
cargo build -p agent_api_http

# Build with optimizations
cargo build --release

Expected time: ~45 seconds for clean full build (first time may be 2+ minutes with git dependency downloads).

Format Check

# Check code formatting (max width 120 chars per rustfmt.toml)
cargo fmt --all -- --check

# Auto-fix formatting
cargo fmt --all

Lint

# Run clippy with pedantic warnings as errors
cargo clippy --all-targets --all-features -- -D warnings

Test

# Run all tests (serial_test synchronizes certain tests to prevent race conditions)
cargo test --workspace

# Run tests for single crate
cargo test -p agent_issuance

# Run specific test with output
cargo test -p agent_issuance test_verify_credential_response -- --nocapture