Skip to content

odradev/cargo-odra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

15f7805 · Jul 30, 2024

History

85 Commits
Jul 30, 2024
May 22, 2023
Jul 29, 2024
Feb 6, 2024
Jul 30, 2024
Jul 30, 2024
Jul 30, 2024
Aug 9, 2022
May 16, 2024
Jul 30, 2024
May 14, 2024
Nov 22, 2022

Repository files navigation

cargo-odra

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

Table of Contents

Prerequisites

  • Rust toolchain installed (see rustup.rs)
  • wasm-strip tool installed (see wabt)
  • wasm-opt tool installed (see binaryen)

Install

Use cargo to install cargo-odra:

$ cargo install cargo-odra --locked

Usage

To create a new project use init or new command:

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

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

$ cargo odra test

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

$ 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,
  • list-templates - lists available templates,
  • clean - removes temporary files (builders and wasm files),
  • completions - generates autocomplete script for given shell

To see exact syntax of each command, type cargo odra command_name --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.

You can use a template to create a project with workspace:

$ cargo odra new --name myproject --template workspace && cd myproject

Links

Contact

Write [email protected]