near CLI
--------
_near CLI_ – это утилита командной строки для работы с блокчейном NEAR Protocol.

## README.md

- en [English](README.en.md)

## Оглавление

- [Применение](#применение)
- [Установка](#установка)
- [Инструкция](#инструкция)
- [Конфигурационный файл](#конфигурационный-файл)
- [Сборка](#сборка)

## Применение

Вцелом новичку трудно сразу разобраться как устроены команды.  
Например, для осуществления перевода токенов необходимо набрать в терминале такую команду:

```txt
near tokens \
    'volodymyr.testnet' \
    send-near \
    'fro_volod.testnet' \
    '1 NEAR' \
    network testnet \
    sign-with-keychain \
    send
```

Это полная команда. Результат ее работы будет такой:

```txt
Successful transaction
<volodymyr.testnet> has transferred 1 NEAR to <fro_volod.testnet> successfully.
Transaction ID: G4t6Sgz2FjnNpruYjPP1ZJAKfRmBffVaqmj8Nup2TaAg
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/G4t6Sgz2FjnNpruYjPP1ZJAKfRmBffVaqmj8Nup2TaAg
```

Набирая эту или другую команду вручную, Вы можете допустить ошибку, либо забыть последовательность набора команды.  
Не проблема, `--help` подскажет как правильно выстроить команду.  
Однако, используя _near CLI_, Вы __в любом месте набора команды__ можете нажать Enter и интерактивный режим программы продолжит работу по составлению команды с того места, где Вы закончили вводить необходимые параметры.

<details><summary><i>Демонстрация работы утилиты с частично набранной командой</i></summary>
<a href="https://asciinema.org/a/AfxLN1QtJi1z1qXuowTj2nDw2?autoplay=1&t=1&speed=2">
    <img src="https://asciinema.org/a/AfxLN1QtJi1z1qXuowTj2nDw2.png" width="836"/>
</a>
</details>

## Установка

На данном этапе разработки утилиты установка программы не требуется.  
Достаточно [загрузить](https://github.com/near/near-cli-rs/releases/) архивный файл, подходящий к Вашей операциой системе, установленной на компьютере, и разархивировать его.  
В полученном каталоге находится исполняемый файл _near CLI_, к которому прилагается [подробная инструкция для пользователя](GUIDE.ru.md).  
Если необходимо скомпилировать CLI из исходного кода, перейдите к разделу [Сборка](#сборка).

## Инструкция

Подробная инструкция доступна в файле [GUIDE.ru.md](GUIDE.ru.md).

## Конфигурационный файл

Каталог с ключами доступа и доступные сети подключения определены в конфигурационном файле (`near-cli/config.toml`), который находится в зависимости от операциооной системы в следующих местах:

- macOS: `$HOME/Library/Application Support` (например, `/Users/Alice/Library/Application Support`)
- Linux: `$XDG_CONFIG_HOME` или `$HOME/.config` (например, `/home/alice/.config`)
- Windows: `{FOLDERID*RoamingAppData}` (например, `C:\Users\Alice\AppData\Roaming`)

Подробнее о работе с конфигурационным файлом можно ознакомиться [здесь](GUIDE.ru.md#config---manage-connections-in-a-configuration-file).

## Сборка

_near CLI_ написан на Rust. Поэтому необходимо
[установить Rust](https://www.rust-lang.org/) для компиляции программы.
_near CLI_ компилируется на версии Rust 1.64.0 (stable) или новее.

Сборка _near CLI_:

```txt
$ git clone https://github.com/near/near-cli-rs.git
$ cd near-cli-rs
$ cargo build --release
$ ./target/release/near --version
near 0.2.4
```