base on Blazingly fast, modular and contributor friendly Solidity compiler, written in Rust # solar [](https://crates.io/crates/solar-compiler) [](https://crates.io/crates/solar-compiler) [](/LICENSE-MIT) [](/LICENSE-APACHE) [](https://github.com/paradigmxyz/solar/actions) [][tg-url] Blazingly fast, modular and contributor friendly Solidity compiler, written in Rust. <p align="center"> <picture align="center"> <img alt="Solar cover" src="/assets/cover.png"> </picture> </p> ## Features and Goals > [!CAUTION] > Solar is under active development and is not yet feature complete. > Use it to speed up your development workflows and tooling. > Please do not use it in production environments. - ⚡ Instant compiles and low memory usage - 🔍 Expressive and useful diagnostics - 🧩 Modular, library-based architecture - 💻 Simple and hackable code base - 🔄 Compatibility with the latest Solidity language breaking version (0.8.*) <p align="center"> <picture align="center"> <img alt="Terminal screenshot showing Solar is 40x faster than solc at generating ABI using hyperfine" src="/assets/benchmark.png"> </picture> </p> ## Getting started Solar is available through a command-line interface, or as a Rust library. ### Library usage You can add Solar to your Rust project by adding the following to your `Cargo.toml`: ```toml [dependencies] solar = { version = "0.1.0", package = "solar-compiler" } ``` Or through the CLI: ```bash cargo add solar-compiler --rename solar ``` You can see examples of how to use Solar as a library in the [examples](/examples) directory. ### Binary usage Pre-built binaries are available for macOS, Linux and Windows on the [releases page](https://github.com/paradigmxyz/solar/releases) and can be installed with the following commands: - On macOS and Linux: ```bash curl -LsSf https://paradigm.xyz/solar/install.sh | sh ``` - On Windows: ```powershell powershell -c "irm https://paradigm.xyz/solar/install.ps1 | iex" ``` - For a specific version: ```bash curl -LsSf https://paradigm.xyz/solar/v0.1.0/install.sh | sh powershell -c "irm https://paradigm.xyz/solar/v0.1.0/install.ps1 | iex" ``` You can also build Solar from source: - From crates.io: ```bash cargo install solar-compiler --locked ``` - From GitHub: ```bash cargo install --git https://github.com/paradigmxyz/solar --locked ``` - From a Git checkout: ```bash git clone https://github.com/paradigmxyz/solar cd solar cargo install --locked --path crates/solar ``` Once installed, check out the available options: ```bash solar -h ``` Here's a few examples: ```bash # Compile a single file and emit ABI to stdout. solar Counter.sol --emit abi # Compile a contract through standard input (`-` file). echo "contract C {}" | solar - solar - <<EOF contract HelloWorld { function helloWorld() external pure returns (string memory) { return "Hello, World!"; } } EOF # Compile a file with a Foundry project's remappings. solar $(forge re) src/Contract.sol ``` ## Roadmap You can find a more detailed list in the [pinned GitHub issue](https://github.com/paradigmxyz/solar/issues/1). - [ ] Front-end - [x] Lexing - [x] Parsing - [ ] Semantic analysis - [x] Symbol resolution - [ ] Type checker - [ ] Static analysis - [ ] Middle-end - [ ] Back-end ## Semver Compatibility Solar's versioning tracks compatibility for the binaries, not the API. If using this as a library, be sure to pin the version with a `=` version requirement operator. ## Supported Rust Versions (MSRV) Solar always aims to stay up-to-date with the latest stable Rust release. The Minimum Supported Rust Version (MSRV) may be updated at any time, so we can take advantage of new features and improvements in Rust. ## Contributing Contributions are welcome and highly appreciated. To get started, check out the [**contributing guidelines**](/CONTRIBUTING.md). ## Support Having trouble? Check out the existing issues on [**GitHub**](https://github.com/paradigmxyz/solar/issues), or feel free to [**open a new one**](https://github.com/paradigmxyz/solar/issues/new). You can also ask for help on [Telegram][tg-url]. [tg-url]: https://t.me/paradigm_solar #### License ^{Licensed under either of <a href="LICENSE-APACHE">Apache License, Version 2.0</a> or <a href="LICENSE-MIT">MIT license</a> at your option.} <br> _{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in these crates by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.} ", Assign "at most 3 tags" to the expected json: {"id":"12180","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"