cargo-near-new-project-name

cargo-near-new-project-description

Quickstart Guide

You can start coding on the NEAR Rust stack in less than a minute, thanks to NEAR Devcontainers. How?

1. Click Use this template > Create a new repository

2. In your newly created repo, click Code > Codespaces > Create codespace on main

Where to Get Started?

Start writing your contract logic in src/lib.rs and integration tests in tests/test_basics.rs.

How to Build Locally?

Install cargo-near and run:

cargo near build non-reproducible-wasm

How to Test Locally?

cargo test

How to Deploy?

Deployment is automated with GitHub Actions CI/CD pipeline. To deploy manually, install cargo-near and run:

cargo near deploy build-non-reproducible-wasm <account-id>

Updating rustup

Currently 1.86.0 is maximum version, supported by Nearcore for running compiled wasm contracts.

So, updating version to a newer toolchain is not recommended.

If, for whaterver reason, one needs to update rust in Codespaces environment,

it's possible to set password in codespaces container:

sudo passwd $(whoami)

then, update rustup folder permissions

sudo chown -R $(whoami):$(whoami) /usr/local/rustup

then maybe remove some cargo-clippy conflicting binary:

rm $CARGO_HOME/bin/cargo-clippy

and then run

rustup update

to completion.

Useful Links

• cargo-near - NEAR smart contract development toolkit for Rust
• near CLI - Iteract with NEAR blockchain from command line
• NEAR Rust SDK Documentation
• NEAR Documentation
• NEAR StackOverflow
• NEAR Discord
• NEAR Telegram Developers Community Group
• NEAR DevHub: Telegram, Twitter