9 unstable releases (3 breaking)
0.15.0 | Jun 18, 2024 |
---|---|
0.14.2 | Jun 18, 2024 |
0.13.2 | Jun 4, 2024 |
0.13.1 | May 31, 2024 |
0.12.5 | May 28, 2024 |
#92 in #abi
37 downloads per month
1MB
20K
SLoC
Utility CLI
Utility CLI is your human-friendly companion that helps to interact with Utility from command line.
Just run unc
and let it guide you through!
Install
Visit Releases page to see the latest updates.
Install prebuilt binaries via shell script (macOS, Linux, WSL)
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/utnet-org/utility-cli-rs/releases/latest/download/unc-installer.sh | sh
Run prebuilt binaries with npx (Node.js)
npx unc
Install prebuilt binaries into your npm project (Node.js)
npm install unc
Compile and install from the source code (Cargo)
Install it with cargo
, just make sure you have Rust installed on your computer.
cargo install unc
or, install the most recent version from git repository:
cargo install --git https://github.com/utnet-org/utility-cli-rs
Install on CI (GitHub Actions)
It is often desirable to use unc
cli from CI to automate some actions, so here is an example of how you can make a function call during CI:
name: Release
on:
push:
branches: [main]
jobs:
deploy-widgets:
runs-on: ubuntu-latest
name: Make a function call on testnet
env:
UNC_NETWORK_CONNECTION: testnet
UNC_CONTRACT_ACCOUNT_ID: ${{ vars.UNC_CONTRACT_ACCOUNT_ID }}
UNC_SIGNER_ACCOUNT_ID: ${{ vars.UNC_SIGNER_ACCOUNT_ID }}
UNC_SIGNER_ACCOUNT_PUBLIC_KEY: ${{ vars.UNC_SIGNER_ACCOUNT_PUBLIC_KEY }}
UNC_SIGNER_ACCOUNT_PRIVATE_KEY: ${{ secrets.UNC_SIGNER_ACCOUNT_PRIVATE_KEY }}
steps:
- name: Checkout repository
uses: actions/checkout@v3
- name: Install unc cli
run: |
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/utnet-org/utility-cli-rs/releases/download/v0.8.2/unc-installer.sh | sh
- name: Call some function
run: |
unc contract call-function as-transaction "$UNC_CONTRACT_ACCOUNT_ID" 'function_name_here' json-args '{}' prepaid-gas '100 TeraGas' attached-deposit '0 unc' sign-as "$UNC_SIGNER_ACCOUNT_ID" network-config "$UNC_NETWORK_CONNECTION" sign-with-plaintext-private-key --signer-public-key "$UNC_SIGNER_ACCOUNT_PUBLIC_KEY" --signer-private-key "$UNC_SIGNER_ACCOUNT_PRIVATE_KEY" send
You will need to configure GitHub Actions Secrets and Variables and once it is ready, this CI will only take a couple of seconds to complete!
See how it is used by DevHub.
Run
Once installed, you just run it with unc
command:
$ unc
? What are you up to? (select one of the options with the up-down arrows on your keyboard and press Enter)
account - Manage accounts
tokens - Manage token assets such as UNC, FT, NFT
pledging - Manage pledging: view, add and withdraw pledge
> contract - Manage smart-contracts: deploy code, call functions
transaction - Operate transactions
config - Manage connections in a configuration file (config.toml)
v dev-tool - Developer tools to build and deploy smart contracts
[↑↓ to move, enter to select, type to filter]
The CLI interactively guides you through some pretty complex topics, helping you make informed decisions along the way.
Read more
Dependencies
~57–78MB
~1.5M SLoC