#near #cargo #abi #build #contract #smart-contracts

bin+lib cargo-near

Cargo extension for building Rust smart contracts on NEAR

12 unstable releases (5 breaking)

new 0.6.2 Apr 14, 2024
0.6.1 Feb 23, 2024
0.5.2 Jan 27, 2024
0.5.0 Nov 24, 2023
0.1.0 Jun 1, 2022

#262 in Magic Beans

Download history 111/week @ 2023-12-23 142/week @ 2023-12-30 270/week @ 2024-01-06 265/week @ 2024-01-13 398/week @ 2024-01-20 391/week @ 2024-01-27 363/week @ 2024-02-03 329/week @ 2024-02-10 477/week @ 2024-02-17 489/week @ 2024-02-24 256/week @ 2024-03-02 371/week @ 2024-03-09 347/week @ 2024-03-16 383/week @ 2024-03-23 518/week @ 2024-03-30 512/week @ 2024-04-06

1,823 downloads per month
Used in 4 crates (via near-workspaces)

MIT/Apache and maybe GPL-3.0-or-later

63KB
1.5K SLoC

cargo-near

Cargo extension for building near-sdk-rs smart contracts and ABI schemas on NEAR

Github CI Build Crates.io version Download

Release notes

Release notes and unreleased changes can be found in the CHANGELOG

Installation

Install prebuilt binaries via shell script (Linux, macOS)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/cargo-near/releases/latest/download/cargo-near-installer.sh | sh
Install prebuilt binaries via powershell script (Windows)
irm https://github.com/near/cargo-near/releases/latest/download/cargo-near-installer.ps1 | iex
Install prebuilt binaries into your Node.js application
npm install cargo-near
Compile and install from source code (Cargo)
cargo install cargo-near

or, install the most recent version from git repository:

$ git clone https://github.com/near/cargo-near
$ cargo install --path cargo-near

Usage

See cargo near --help for a complete list of available commands or run cargo near to dive into interactive mode. Help is also available for each individual command with a --help flag, e.g. cargo near build --help.

cargo near

Starts interactive mode that will allow to explore all the available commands.

cargo near build

Builds a NEAR smart contract along with its ABI (while in the directory containing contract's Cargo.toml).

You can also make this command embed ABI into your WASM artifact by adding --embed-abi parameter. Once deployed, this will allow you to call a view function __contract_abi to retrieve a ZST-compressed ABI.

cargo near abi

Generates NEAR smart contract's ABI (while in the directory containing contract's Cargo.toml).

cargo near create-dev-account

Guides you through creation of a new NEAR account on testnet.

cargo near deploy

Builds the smart contract (equivalent to cargo near build) and guides you to deploy it to the blockchain.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as below, without any additional terms or conditions.

License

Licensed under either of

at your option.

Dependencies

~49–73MB
~1M SLoC