https://github.com/asyncswap/solidity-language-server
A fast Solidity language server powered by solc and foundry.
https://github.com/asyncswap/solidity-language-server
ethereum evm language-server-protocol lsp solidity
Last synced: about 2 months ago
JSON representation
A fast Solidity language server powered by solc and foundry.
- Host: GitHub
- URL: https://github.com/asyncswap/solidity-language-server
- Owner: asyncswap
- License: mit
- Created: 2025-12-17T23:12:23.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-04-24T17:19:53.000Z (about 2 months ago)
- Last Synced: 2026-04-24T19:25:24.580Z (about 2 months ago)
- Topics: ethereum, evm, language-server-protocol, lsp, solidity
- Language: Rust
- Homepage: https://solidity-language-server-docs.pages.dev/
- Size: 3.42 MB
- Stars: 15
- Watchers: 2
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# The Solidity Language Server
[](https://crates.io/crates/solidity-language-server)
[](https://github.com/asyncswap/solidity-language-server/actions/workflows/test.yml)
[](https://github.com/asyncswap/solidity-language-server/actions/workflows/release.yml)
[](https://github.com/asyncswap/solidity-language-server/releases/latest)
[](https://t.me/+R1lW7xWJ55tlYzcx)
The fastest Solidity language server — optimized for low-latency go-to-definition/declaration, references, hover, completions, and file operations. See [benchmarks](https://github.com/mmsaki/lsp-bench).
## Install
```sh
curl -fsSL https://asyncswap.org/lsp/install.sh | sh
```
### Alternative: Install from Cargo
```sh
cargo install solidity-language-server
```
Or download directly from the [latest release](https://github.com/asyncswap/solidity-language-server/releases/latest) page.
| Platform | Download |
|----------|----------|
| macOS (Apple Silicon) | solidity-language-server-aarch64-apple-darwin.tar.gz |
| macOS (Intel) | solidity-language-server-x86_64-apple-darwin.tar.gz |
| Windows | solidity-language-server-x86_64-pc-windows-msvc.zip |
| Linux | solidity-language-server-x86_64-unknown-linux-gnu.tar.gz |
## Benchmarks
Benchmarked against `v4-core` — `test/PoolManager.t.sol` (`v0.1.30`, p95 latency).
| Method | [mmsaki v0.1.30](https://github.com/asyncswap/solidity-language-server/releases/tag/v0.1.30) |
|--------|--------|
| initialize | 22.4ms ⚡ |
| textDocument/diagnostic | 2.8ms ⚡ |
| textDocument/semanticTokens/full/delta | 11.1ms ⚡ |
| textDocument/definition | 8.3ms ⚡ |
| textDocument/declaration | 1.6ms ⚡ |
| textDocument/hover | 7.3ms ⚡ |
| textDocument/references | 5.3ms ⚡ |
| textDocument/completion | 59.9ms ⚡ |
| textDocument/signatureHelp | 6.2ms ⚡ |
| textDocument/rename | 15.1ms ⚡ |
| textDocument/prepareRename | 0.2ms ⚡ |
| textDocument/documentSymbol | 7.7ms ⚡ |
| textDocument/documentHighlight | 8.4ms ⚡ |
| textDocument/documentLink | 2.6ms ⚡ |
| textDocument/formatting | 43.4ms ⚡ |
| textDocument/foldingRange | 10.4ms ⚡ |
| textDocument/selectionRange | 6.6ms ⚡ |
| textDocument/inlayHint | 11.4ms ⚡ |
| textDocument/semanticTokens/full | 18.5ms ⚡ |
| textDocument/semanticTokens/range | 8.9ms ⚡ |
| workspace/symbol | 7.2ms ⚡ |
| workspace/willRenameFiles | 240.6ms ⚡ |
| workspace/willCreateFiles | 1.6ms ⚡ |
| workspace/willDeleteFiles | 230.5ms ⚡ |
| workspace/executeCommand | 5.3ms ⚡ |
| textDocument/codeAction | 28.7ms ⚡ |
- Full benchmark report: [PoolManager.t.sol results](benchmarks/poolmanager-t/README.md)
## Docs
- [Documentation Site](https://solidity-language-server-docs.pages.dev) — canonical docs (Quickstart, setup, references, benchmarks)
- [Quickstart](https://solidity-language-server-docs.pages.dev/docs/quickstart)
- [Reference Index](https://solidity-language-server-docs.pages.dev/reference)
- [Neovim Setup](https://solidity-language-server-docs.pages.dev/setup/neovim)
- [FEATURES.md](FEATURES.md) — full LSP feature set and roadmap
- [CONTRIBUTING.md](CONTRIBUTING.md) — development setup, project structure, and how to contribute
- [CHANGELOG.md](CHANGELOG.md) — release history
## Editor Setup
Use the docs for complete editor-specific setup and config examples:
- [Neovim](https://solidity-language-server-docs.pages.dev/setup/neovim)
- [Helix](https://solidity-language-server-docs.pages.dev/setup/helix)
- [Zed](https://solidity-language-server-docs.pages.dev/setup/zed)
- [VS Code / Cursor](https://solidity-language-server-docs.pages.dev/setup/vscode)
- [Vim](https://solidity-language-server-docs.pages.dev/setup/vim)
- [Emacs](https://solidity-language-server-docs.pages.dev/setup/emacs)
## AI Agents
- [OpenCode](https://solidity-language-server-docs.pages.dev/agents/opencode) — direct LSP integration
- [Claude Code](https://solidity-language-server-docs.pages.dev/agents/claude) — LSP via [plugin](https://github.com/asyncswap/skills)
- [Codex](https://solidity-language-server-docs.pages.dev/agents/codex) — `AGENTS.md` + shell commands
Minimal LSP command:
```sh
solidity-language-server --stdio
```
## Verify Release Binaries
Release binaries are GPG-signed. Download `checksums-sha256.txt`, `checksums-sha256.txt.asc`, and [`public-key.asc`](public-key.asc) from the [release](https://github.com/asyncswap/solidity-language-server/releases/latest):
```sh
gpg --import public-key.asc
gpg --verify checksums-sha256.txt.asc checksums-sha256.txt
sha256sum -c checksums-sha256.txt
```