CryptoDeps: Dependency Crypto Analyzer

Why CryptoDeps?

Your code might be quantum-safe, but what about your dependencies? The average software project has 300-1000+ transitive dependencies. Each one potentially uses cryptographic algorithms that quantum computers will break. Traditional security scanners miss this — they focus on known CVEs, not cryptographic readiness.

Key Features

Installation

Pre-built Binaries (Recommended)

Download from GitHub Releases:

# macOS (Apple Silicon)
curl -LO https://github.com/csnp/qramm-cryptodeps/releases/latest/download/cryptodeps-darwin-arm64
chmod +x cryptodeps-darwin-arm64
sudo mv cryptodeps-darwin-arm64 /usr/local/bin/cryptodeps

# macOS (Intel)
curl -LO https://github.com/csnp/qramm-cryptodeps/releases/latest/download/cryptodeps-darwin-amd64
chmod +x cryptodeps-darwin-amd64
sudo mv cryptodeps-darwin-amd64 /usr/local/bin/cryptodeps

# Linux (x86_64)
curl -LO https://github.com/csnp/qramm-cryptodeps/releases/latest/download/cryptodeps-linux-amd64
chmod +x cryptodeps-linux-amd64
sudo mv cryptodeps-linux-amd64 /usr/local/bin/cryptodeps

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/csnp/qramm-cryptodeps/releases/latest/download/cryptodeps-windows-amd64.exe" -OutFile "cryptodeps.exe"

Build from Source

Requires Go 1.21+:

git clone https://github.com/csnp/qramm-cryptodeps.git
cd qramm-cryptodeps
go build -o cryptodeps ./cmd/cryptodeps

Go Install

go install github.com/csnp/qramm-cryptodeps/cmd/cryptodeps@latest

Quick Start

# Analyze current directory
cryptodeps analyze .

# Analyze a specific project
cryptodeps analyze /path/to/project

# Analyze a GitHub repository directly
cryptodeps analyze hashicorp/vault
cryptodeps analyze https://github.com/golang-jwt/jwt

# Generate CBOM for compliance
cryptodeps analyze . --format cbom > crypto-bom.json

# CI/CD: Fail on quantum-vulnerable crypto
cryptodeps analyze . --fail-on vulnerable

Workspace & Monorepo Support

CryptoDeps automatically discovers all manifest files in workspace and monorepo setups. It handles npm/yarn workspaces, pnpm workspaces, and Go workspaces out of the box.

Supported Workspace Types

Multi-Project Output

When scanning a monorepo, CryptoDeps groups findings by project:

Scanning /Users/project/monorepo...
Found 3 projects:
  - ./package.json (npm)
  - ./apps/backend/go.mod (go)
  - ./sdk/typescript/package.json (npm)

=== ./apps/backend (Go) ===
[*] Scanning go.mod... found 36 dependencies
  🔴 Ed25519        VULNERABLE    1-2yr         low
     └─ golang.org/x/crypto@v0.31.0

=== ./sdk/typescript (npm) ===
[*] Scanning package.json... found 12 dependencies
  🟢 No vulnerable crypto detected

══════════════════════════════════════════════════════════════════════════════
TOTAL: 3 projects | 51 deps | 3 with crypto | 1 vulnerable

Reachability Analysis

CryptoDeps goes beyond simple dependency scanning by analyzing your code's call graph to determine which cryptographic algorithms are actually used.

How It Works

1. Parses your source code — Builds an AST of your Go files
2. Identifies entry points — main(), init(), exported functions
3. Traces call paths — Follows function calls to crypto imports
4. Classifies reachability — Marks each crypto usage as CONFIRMED, REACHABLE, or AVAILABLE

Reachability Levels

Sample Output with Reachability

[*] Scanning go.mod... found 36 dependencies

[!] CONFIRMED - Actually used by your code (requires action):
──────────────────────────────────────────────────────────────────────────────
  🔴 Ed25519        VULNERABLE    1-2yr         low
     └─ golang.org/x/crypto@v0.31.0
        > Called from: application.AgentService.CreateAgent
        > Called from: crypto.ED25519Service.Sign

  🟡 HS256          PARTIAL       -             low
     └─ github.com/golang-jwt/jwt/v5@v5.3.0
        > Called from: auth.JWTService.GenerateAccessToken

  🟢 bcrypt         SAFE          -             -
     └─ golang.org/x/crypto@v0.31.0
        > Called from: auth.HashPassword

══════════════════════════════════════════════════════════════════════════════
SUMMARY: 36 deps | 2 with crypto | 8 vulnerable | 2 partial
REACHABILITY: 3 confirmed | 0 reachable | 11 available-only

Output Formats

Table (Default)

Human-readable terminal output with colors and formatting:

cryptodeps analyze .

JSON

Machine-readable output for automation:

cryptodeps analyze . --format json
cryptodeps analyze . --format json | jq '.dependencies[] | select(.analysis.crypto != null)'

CycloneDX CBOM

Cryptographic Bill of Materials for compliance (OMB M-23-02, CNSA 2.0):

cryptodeps analyze . --format cbom > crypto-bom.json

SARIF

GitHub Security tab integration:

cryptodeps analyze . --format sarif > results.sarif

Markdown

Documentation and reports:

cryptodeps analyze . --format markdown > crypto-report.md

Quantum Risk Classification

CNSA 2.0 Compliance Timeline

Remediation Guidance

CryptoDeps provides intelligent, context-aware remediation recommendations:

For JWT Algorithms

For Signatures

Recommended PQC Libraries

CI/CD Integration

GitHub Actions

name: Quantum Security Scan

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

permissions:
  security-events: write
  contents: read

jobs:
  cryptodeps:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Go
        uses: actions/setup-go@v5
        with:
          go-version: '1.22'

      - name: Install CryptoDeps
        run: go install github.com/csnp/qramm-cryptodeps/cmd/cryptodeps@latest

      - name: Run Crypto Analysis
        run: cryptodeps analyze . --format sarif > cryptodeps.sarif
        continue-on-error: true

      - name: Upload SARIF
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: cryptodeps.sarif

      - name: Fail on Vulnerable Crypto
        run: cryptodeps analyze . --fail-on vulnerable

Exit Codes

Command Reference

USAGE:
  cryptodeps <command> [flags]

COMMANDS:
  analyze     Analyze project dependencies for cryptographic usage
  update      Download latest crypto knowledge database
  status      Show database statistics and cache info
  version     Print version information

ANALYZE FLAGS:
  -f, --format string       Output format: table, json, cbom, sarif, markdown (default "table")
      --fail-on string      Fail threshold: vulnerable, partial, any, none (default "vulnerable")
      --reachability        Analyze call graph for actual crypto usage (default true, Go only)
      --no-workspaces       Disable workspace discovery, scan only the specified manifest
      --deep                Force AST analysis for packages not in database
      --offline             Use only local database, skip auto-updates
      --risk string         Filter by risk: vulnerable, partial, all
      --min-severity string Minimum severity to report

EXAMPLES:
  cryptodeps analyze .                        # Analyze current directory (all workspaces)
  cryptodeps analyze . --no-workspaces        # Single manifest only
  cryptodeps analyze ./go.mod                 # Specific manifest
  cryptodeps analyze hashicorp/vault          # GitHub repository
  cryptodeps analyze . --format cbom          # Generate CBOM
  cryptodeps analyze . --fail-on vulnerable   # CI/CD gate
  cryptodeps analyze . --reachability=false   # Skip call graph analysis
  cryptodeps update                           # Update crypto database

Related Resources

• CryptoScan Guide - Discover crypto in your source code
• Cryptographic Inventory Guide - Best practices for maintaining crypto inventories
• Quantum Risk Management - Framework for assessing quantum threats
• Harvest Now, Decrypt Later - Understanding the HNDL threat
• Algorithm Selection Guide - Choosing the right algorithms by use case