Get started

To start build on Partisia Platform, there are some necessary tools to install, to enable contract compilation, spinning up your own local private deployment and using the different tools for sending transactions and viewing the state of the blockchain.

Prerequisites

To develop and compile contracts for the Partisia Platform, you need to install the following

Rust version 1.77.0
- Build target wasm32-unknown-unknown
Java 17
Git
Cargo Partisia Contract
Docker

Install Rust

To install Rust for your platform follow the instructions on https://rustup.rs/.

Instruct rust to use the latest stable version by running:

rustup install stable
rustup default stable

The wasm32-unknown-unknown target needs to be added manually, you add the target by running:

rustup target add wasm32-unknown-unknown

If you are using a Windows machine you must get Visual Studio with C++ build tools - In Visual Studio Installer choose Desktop development with C++.

We recommend you make sure these optionals are enabled:

MSVC x64/x86 build tools
Windows 11 SDK
C++ CMake tools for Windows
Testing tools core features
Build Tools
C++ AddressSanitizer

Git

To compile contracts you will also need to install the version control system, Git. Rust uses Git to fetch dependencies from remote repositories.

Docker

Docker is a runtime for running containers. On Linux Docker utilizes the kernel to isolate and sandbox processes in virtual filesystems and networks. On Windows it does the same thing but runs a Linux virtual machine.

Windows

Download and install from here.

You might have to enable some virtualization in BIOS. A message about this should be shown automatically if necessary.

Linux (and WSL)

Follow the guide for your distro on Docker for Linux.

Java

Install Java 17 by following the instructions here.

Installing the cargo `partisia-contract`/`pbc` command

The partisia-contract tool is a commandline tool that helps you compile a contract, view ABIs, chain state and the state of deployed smart contracts. To compile it and install it using cargo, run the following command:

cargo install cargo-partisia-contract

The cargo partisia-contract and cargo pbc are interchangeable commands, cargo pbc is just an alias. To verify the tool you can locally execute:

cargo partisia-contract --version

and

cargo pbc --version

This command prints the version of the tool. If you want to learn more about the partisia contract tool you can visit our tooling page.