solidity-language-server 0.1.36

A fast Solidity language server powered by solc and Foundry
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

![Diagnostics image](./data/1-diagnostics.png)

# The Solidity Language Server

[![Crates.io](https://img.shields.io/crates/v/solidity-language-server)](https://crates.io/crates/solidity-language-server)
[![Tests](https://github.com/asyncswap/solidity-language-server/actions/workflows/test.yml/badge.svg)](https://github.com/asyncswap/solidity-language-server/actions/workflows/test.yml)
[![Release](https://github.com/asyncswap/solidity-language-server/actions/workflows/release.yml/badge.svg)](https://github.com/asyncswap/solidity-language-server/actions/workflows/release.yml)
[![GitHub Release](https://img.shields.io/github/v/release/asyncswap/solidity-language-server)](https://github.com/asyncswap/solidity-language-server/releases/latest)
[![Telegram](https://img.shields.io/badge/Telegram-Join%20Chat-blue?logo=telegram)](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
```

### Claude Code Skills

The [`asyncswap/skills`](https://github.com/asyncswap/skills) marketplace ships two plugins that drive this LSP from Claude Code:

```
/plugin marketplace add asyncswap/skills
/plugin install solidity-language-server@asyncswap
/plugin install lsp-bench@asyncswap
```

**`solidity-language-server`** — LSP-augmented analysis skills:

**`lsp-bench`** — write [lsp-bench](https://github.com/asyncswap/lsp-bench) YAML configs for performance benchmarks, response assertions, multi-file consistency checks, file-edit sequences, lifecycle tests, and side-by-side LSP version comparisons. Schema-style reference for every supported LSP method.

## 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
```