cargo-unc

Cargo extension for building unc-sdk-rs smart contracts and ABI schemas on UNC

Github CI Build Crates.io version Download

## Release notes **Release notes and unreleased changes can be found in the [CHANGELOG](CHANGELOG.md)** ## Installation
Install prebuilt binaries via shell script (Linux, macOS) ```sh curl --proto '=https' --tlsv1.2 -LsSf https://github.com/utnet-org/cargo-unc/releases/latest/download/cargo-unc-installer.sh | sh ```
Install prebuilt binaries via powershell script (Windows) ```sh irm https://github.com/utnet-org/cargo-unc/releases/latest/download/cargo-unc-installer.ps1 | iex ```
Install prebuilt binaries into your Node.js application ```sh npm install cargo-unc ```
Compile and install from source code (Cargo) ```sh cargo install cargo-unc ``` or, install the most recent version from git repository: ```sh $ git clone https://github.com/utnet-org/cargo-unc $ cargo install --path cargo-unc ```
## Usage See `cargo unc --help` for a complete list of available commands or run `cargo unc` to dive into interactive mode. Help is also available for each individual command with a `--help` flag, e.g. `cargo unc build --help`. ```console cargo unc ``` Starts interactive mode that will allow to explore all the available commands. ```console cargo unc build ``` Builds a UNC smart contract along with its [ABI](https://github.com/utnet-org/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](https://facebook.github.io/zstd/)-compressed ABI. ```console cargo unc abi ``` Generates UNC smart contract's [ABI](https://github.com/utnet-org/abi) (while in the directory containing contract's Cargo.toml). ```console cargo unc create-dev-account ``` Guides you through creation of a new UNC account on [testnet](https://explorer.testnet.unc.org). ```console cargo unc deploy ``` Builds the smart contract (equivalent to `cargo unc 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 * Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or ) * MIT license ([LICENSE-MIT](LICENSE-MIT) or ) at your option.