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.

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

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