The language server will start working immediately after installing the application VSCode.
But it can be installed for any IDE that supports Language Server Protocol (LSP) technology.
Most likely, your favorite IDE has already enlisted the support of this protocol. You can read about how to install LSP extensions for a specific IDE in its documentation.
You can share the guide with the community by sending it to us. Below, in the description, we will publish such instructions.
TON Solidity is the language used in Free TON to create smart contracts, this extension provides:
- Syntax highlighting
- Snippets
- Compilation of the current contract (Press F1 Solidity : Compile Current Solidity Contract), or F5
- Compilation of all the contracts (Press F1 Solidity : Compile all Solidity Contracts), or Ctrl+F5 / Cmd+F5
- Code completion for all contracts / libraries in the current file and all referenced imports
- Support for different solidity versions (Remote and local)
- Support for unique file extension * .ton, * .tsol
If your editor does not have this plugin installed, then the Solidity code will look something like this:
Once installed, the TON Solidity syntax will be detected automatically.
Files with * .ton, * .tsol resolution are supported
By default, it is recommended to write the name of the Ton currency with a capital letter. But you can change this in the server settings.
Language Servers can be implemented in any language and run in their own process to avoid performance cost, as they communicate with the code editor through the Language Server Protocol. Furthermore, any LSP-compliant language toolings can integrate with multiple LSP-compliant code editors, and any LSP-compliant code editors can easily pick up multiple LSP-compliant language toolings. LSP is a win for both language tooling providers and code editor vendors!
If you constantly need to change the server settings or you intend to contribute to development, then install a full-fledged server from the repository.
If you would like to customize the language server to suit your needs, download the server source code.
This server works with files _.ton and _.sol, _.tsol.
It has the following language features:
- Completions
- Diagnostics regenerated on each file change or configuration change
It also includes an End-to-End test.
.
├── client // Language Client
│ ├── src
│ │ ├── test // End to End tests for Language Client / Server
│ │ └── extension.ts // Language Client entry point
├── package.json // The extension manifest.
├── sctripts
│ └── e2e.sh // Launcher scripts
├── server // Language Server
│ └── src
│ └── server.ts // Language Server entry point
├── snippets
│ └── ton-solidity.json // Setting the snippets
├── syntaxes
│ └── ton-solidity.json // Setting the syntax
- Run
npm installin this folder. This installs all necessary npm modules in both the client and server folder - Open VS Code on this folder.
- Press Ctrl+Shift+B to compile the client and server.
- Switch to the Debug viewlet.
- Select
Launch Clientfrom the drop down.
- Run the launch config.
- If you want to debug the server as well use the launch configuration
Attach to Server - In the [Extension Development Host] instance of VSCode, open a document in 'plain text' language mode.
- Type
jortto seeJavascriptandTypeScriptcompletion. - Enter text content such as
AAA aaa BBB. The extension will emit diagnostics for all words in all-uppercase.
- Type
Learn more about LSP on the Microsoft website.
Free TON extends the standard Solidity functionality - the description of the TON compiler.
Do you also love VIM? See how to connect TON Solidity syntax highlighting to it: VIM-LSP
Provide integration support for adding Atom Language Server Protocol Client
Solidity code examples from the team Tonlabs. If you need to test how the code works, use the examples repository.
MIT License. See the license for more details.