RADIX WikiRADIX Wiki

Overview

Scrypto is Radix's smart-contract language, built on Rust. You need three things: the Rust toolchain, the WebAssembly compilation target, and the Radix CLI tools.

Fastest Path: VS Code Dev Container

If you would rather not install a Rust toolchain at all, the official Scrypto Starter repository ships a pre-configured VS Code Dev Container with everything below already in place. This is the fastest way to a working environment; the manual steps that follow give you the same result with full control over versions.

  1. Download and install VS Code.
  2. Install the Dev Containers extension from the Extensions sidebar, then follow its prompts to install Docker Desktop.
  3. Clone the starter repository:
    git clone https://github.com/radixdlt/scrypto-starter.git
  4. Open the folder in VS Code (File > Open Folder). When prompted, choose Reopen in Container – or run Dev Containers: Reopen in Container from the Command Palette (View > Command Palette).
  5. Once the container finishes building, confirm the Radix Engine Simulator is ready:
    resim --help

If that works, you can skip straight to Your First Blueprint.

Quick Install (Automated)

The Scrypto repository ships official install scripts for macOS, Debian/Ubuntu, and Windows that install a known-good, pinned toolchain in one step – WASM target included. As of Scrypto 1.3.1 they pin Rust 1.92.0, radix-clis 1.3.0, and LLVM 21. This is the fastest path if you want a working setup without choosing versions yourself; the manual steps below produce the same result with full control.

1. Install Rust

Install Rust via rustup. Scrypto 1.3.1 supports Rust 1.81.0 and newer (tested up to 1.92.0).

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"

2. Add the WASM Target

Scrypto compiles blueprints to WebAssembly for deterministic execution on the Radix Engine.

rustup target add wasm32-unknown-unknown

3. Install Radix CLI Tools

The radix-clis crate provides scrypto (compiler), resim (local simulator), and rtmc (manifest compiler).

cargo install --force radix-clis

Build time

First install compiles from source and may take several minutes. Subsequent installs are faster.

4. Verify

rustc --version
scrypto --version
resim --version

All three commands should print version numbers without errors.

IDE Setup

For the best experience, install VS Code with the rust-analyzer extension. This gives you inline type hints, autocompletion, and error checking for Scrypto code.

Troubleshooting

Missing WASM target

If you see wasm32-unknown-unknown target not found, re-run:

rustup target add wasm32-unknown-unknown

Outdated toolchain

If builds fail on a fresh install, update Rust:

rustup update

Next Steps