Skip to content

Latest commit

 

History

History
82 lines (63 loc) · 2.24 KB

README.md

File metadata and controls

82 lines (63 loc) · 2.24 KB

Solana Project Version Detector

A command-line tool that analyzes Solana/Anchor projects to detect or infer required versions of Rust, Solana, and Anchor.

Features

  • Detects versions from multiple configuration files:
    • rust-toolchain for Rust version
    • Anchor.toml for Solana and Anchor versions
    • Cargo.toml for Solana and Anchor dependencies
  • Prints commands to make local environment compatible (solana-install, avm, rustup)
  • Recursively searches subdirectories if versions aren't found in the root
  • Intelligently infers missing versions based on compatibility rules
  • Skips irrelevant directories (node_modules, target, etc.)
  • Handles various version specification formats
  • Falls back to compatibility-based version inference when needed

Usage

Run the tool by providing a path to your Solana/Anchor project:

cargo run -- /path/to/your/project

Example output:

Detected/Inferred Versions:
Rust: nightly-2023-10-29 (from /path/to/project/rust-toolchain)
Solana: 1.18.10
Anchor: 0.29.0

To work with this project, configure your environment as follows:
rustup default nightly-2023-10-29
solana-install init 1.18.10
avm use 0.29.0

How It Works

  1. Top-level Check: First checks the root directory for version information in configuration files.

  2. Recursive Search: If versions are missing, recursively searches subdirectories while skipping common irrelevant directories like node_modules and target.

  3. Version Detection:

    • Reads rust-toolchain for Rust version (supports both plain text and TOML formats)
    • Parses Anchor.toml for Solana and Anchor versions
    • Checks Cargo.toml for dependency versions

  4. Version Inference: If versions are still missing after searching, uses compatibility rules to infer appropriate versions based on known working combinations.

Supported Version Formats

rust-toolchain

1.69.0

or

[toolchain]
channel = "1.69.0"

Anchor.toml

[toolchain]
anchor_version = "0.29.0"
solana_version = "1.18.10"

Cargo.toml

[dependencies]
solana-program = "1.17.0"
anchor-lang = { version = "0.29.0" }

TODO

  • Split into multiple files (different ones for different kinds of parsing)
  • Add clippy lints
  • Reduce dependencies