#near #command-line #interact #human-friendly #helps #protocols #run

bin+lib near-cli-rs

human-friendly console utility that helps to interact with NEAR Protocol from command line

30 releases (6 breaking)

0.8.1 Feb 26, 2024
0.7.8 Feb 3, 2024
0.7.6 Dec 21, 2023
0.7.2 Nov 21, 2023
0.2.1 Dec 20, 2022

#893 in Magic Beans

Download history 3/week @ 2023-12-22 35/week @ 2024-01-12 193/week @ 2024-01-19 230/week @ 2024-01-26 179/week @ 2024-02-02 37/week @ 2024-02-09 342/week @ 2024-02-16 339/week @ 2024-02-23 104/week @ 2024-03-01 53/week @ 2024-03-08 88/week @ 2024-03-15 6/week @ 2024-03-22 84/week @ 2024-03-29 116/week @ 2024-04-05

302 downloads per month
Used in 3 crates

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

1MB
18K SLoC

NEAR CLI

near CLI is your human-friendly companion that helps to interact with NEAR Protocol from command line.

Just run near 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/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh
Install prebuilt binaries via powershell script (Windows)
irm https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.ps1 | iex
Run prebuilt binaries with npx (Node.js)
npx near-cli-rs
Install prebuilt binaries into your npm project (Node.js)
npm install near-cli-rs
Compile and install from the source code (Cargo)

Install it with cargo, just make sure you have Rust installed on your computer.

cargo install near-cli-rs

or, install the most recent version from git repository:

$ cargo install --git https://github.com/near/near-cli-rs
Install on CI (GitHub Actions)

It is often desirable to use near 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 mainnet
    env:
      NEAR_NETWORK_CONNECTION: mainnet
      NEAR_CONTRACT_ACCOUNT_ID: ${{ vars.NEAR_CONTRACT_ACCOUNT_ID }}
      NEAR_SIGNER_ACCOUNT_ID: ${{ vars.NEAR_SIGNER_ACCOUNT_ID }}
      NEAR_SIGNER_ACCOUNT_PUBLIC_KEY: ${{ vars.NEAR_SIGNER_ACCOUNT_PUBLIC_KEY }}
      NEAR_SIGNER_ACCOUNT_PRIVATE_KEY: ${{ secrets.NEAR_SIGNER_ACCOUNT_PRIVATE_KEY }}

    steps:
    - name: Checkout repository
      uses: actions/checkout@v2

    - name: Install near CLI
      run: |
        curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/near-cli-rs/releases/download/v0.7.4/near-cli-rs-installer.sh | sh

    - name: Call some function
      run: |
        near contract call-function as-transaction "$NEAR_CONTRACT_ACCOUNT_ID" 'function_name_here' json-args '{}' prepaid-gas '100 TeraGas' attached-deposit '0 NEAR' sign-as "$NEAR_SIGNER_ACCOUNT_ID" network-config "$NEAR_NETWORK_CONNECTION" sign-with-plaintext-private-key --signer-public-key "$NEAR_SIGNER_ACCOUNT_PUBLIC_KEY" --signer-private-key "$NEAR_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 near command:

$ near

? 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 NEAR, FT, NFT
  staking     - Manage staking: view, add and withdraw stake
  contract    - Manage smart-contracts: deploy code, call functions
  transaction - Operate transactions
  config      - Manage connections in a configuration file (config.toml)
  extension   - Manage near CLI and extensions
[↑↓ 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 in English

Больше информации на русском языке (in Russian)

Dependencies

~47–70MB
~1M SLoC