cargo-odra

A cargo utility that helps to create, manage and test your smart contracts written using Odra framework.

Table of Contents

• Usage
• Commands
• Links
• Contact

Prerequisites

• Rust toolchain installed (see rustup.rs)
• wasmstrip tool installed (see wabt)

Install

Use cargo to install cargo-odra:

bash $ cargo install cargo-odra --locked

Usage

To create a new project use init or new command:

bash $ cargo odra new --name myproject && cd myproject

A sample contract - Flipper - will be created for you, with some sample tests. To run them against MockVM, simply type:

bash $ cargo odra test

If you want to test your code using real backend VM type:

bash $ cargo odra test -b casper

Commands

• new - creates a new project in a new folder,
• init - creates a new project in an existing, empty folder,
• build - builds the contracts, generates wasm files,
• test - runs tests,
• generate - generates sample contract,
• clean - removes temporary files (builders and wasm files),
• update - runs cargo update on project and backends.

To see exact syntax of each command, type cargo odra command --help.

Workspaces

cargo-odra supports workspaces. To use it, simply move your Odra.toml file into root of your workspace. If you have multiple odra crates in your workspace, put all contracts in the same Odra.toml folder.

Links

• Odra
• Cargo Odra
• Odra Template
• Odra Casper
• Original Proposal for Odra Framework

Contact

Write contact@odra.dev