- Docs
- Developers
- IDE setup
Integrated development environment setup
This tutorial will guide you through the process of setting up an Integrated Development Environment (IDE) for developing CosmWasm smart contracts. Since CosmWasm contracts are currently built using Rust, this tutorial will focus on setting up your IDE for Rust development.
Prerequisites
Please refer to the Installation guide to install the Rust compiler before proceeding.
Install visual studio code
Visual Studio Code (VS Code) is a very popular, free, and open-source IDE. It has a rich source code editor, integrated git, and debugging with various extensions that add a lot of features and support for various languages including Rust, Go, C++, Java, Python, PHP, etc. The IDE is available for Windows, macOS, and Linux operating systems.
Please refer to the steps below for your respective operating system:
macOS
Linux
- Download Visual Studio Code for macOS.
- Open the browser's download list and locate the downloaded app or archive.
- If archive, extract the archive contents. Use double-click for some browsers or select the 'magnifying glass' icon with Safari.
- Drag Visual Studio Code.app to the Applications folder, making it available in the macOS Launchpad.
- Open VS Code from the Applications folder, by double-clicking the icon.
- Add VS Code to your Dock by right-clicking on the icon, located in the Dock, to bring up the context menu and choosing Options, Keep in Dock.
For additional setup information for macOs, see Visual Studio Code on macOS.
Configure vs code
To enable Rust support in VS Code, you need to install a few extensions, namely rust-analyzer and CodeLLDB, that provide syntax highlighting, code completion, debugging capabilities and other essential functionalities.
Rust-analyzer
The rust-analyzer extension is a language server for the Rust programming language, which provides features such as code completion, error checking, and documentation while writing Rust code in VS Code.
Follow these steps to install the extension:
- Go to the Extension panel
- In the Search field enter rust-analyzer
- Click the install button to the bottom right of rust-analyzer
For additional information as to the benefits and features of rust-analyzer, see the rust-analyzer User Manual.
CodeLLDB
The CodeLLDB extension is a native debugger used for debugging Rust and other compiled languages.
Follow these steps to install the extension:
- Go to the Extension panel
- In the Search field enter CodeLLDB
- Click the install button to the bottom right of CodeLLDB
For full details on how to use the CodeLLDB extension, please see the Manual.
Basic rust program
Let's test if you are able to write and execute Rust programs within VS Code. Create a new file main.rs and add the following to the file:
fn main() { println!("Hello, Archway!");}
Launch a terminal within VS Code by going to Terminal -> New Terminal and execute the following command to compile the program:
rustc main.rs
To execute the program, use the following command:
./main
The output of the program should be:
Hello, Archway!
Syntax highlighting should be in effect alongside code completion, error checking, among other features.
Cosmy wasmy
Cosmy Wasmy is a VS Code plugin that simplifies the process of developing and interacting with CosmWasm smart contracts. It comes pre-configured with the most popular testnets for CosmWasm chains, making chain interactions during testing a breeze. With Cosmy Wasmy, you can perform all interactions within VS Code without having to use the CLI.
For more information about installation, configuration, and the commands and features available, check out Cosmy Wasmy.
CosmWasm IDE
CosmWasm IDE is another tool that streamlines the development and deployment processes for CosmWasm smart contracts. It integrates with VSCode, Gitpod and Keplr to create a user-friendly yet powerful environment for building, deploying, and interacting with CosmWasm smart contracts. With Gitpod, CosmWasm developers can create smart contracts directly in their browsers. The tool is currently maintained by Oraichain and CosmWasm.
The CosmWasm IDE consists of three sub-repositories:
- CosmWasm Gitpod functions as a Gitpod builder that automatically creates a comprehensive development environment, including Rust installation, a browser-based VS Code, essential VS Code extensions, and full compatibility with the Keplr wallet. With this repository, CosmWasm developers can avoid spending hours on tool and library installations, while also feeling secure when deploying contracts using Keplr.
- The CosmWasm IDE extension is a VS Code extension that incorporates all the essential functionalities for building and deploying CosmWasm smart contracts with just a few simple button clicks within VSCode.
- The CosmWasm IDE extension webview is a React application that sits atop the CosmWasm IDE Extension. It handles connections with the Keplr wallet and displays inputs for deploying and interacting with smart contracts. Additionally, it enables the addition of custom networks.
You can find additional CosmWasm IDE documentation on the official Oraichain documentation site.