Skip to content

Latest commit

 

History

History
88 lines (65 loc) · 4.65 KB

README.ru.md

File metadata and controls

88 lines (65 loc) · 4.65 KB

near CLI

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

README.md

Оглавление

Применение

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

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

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

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 и интерактивный режим программы продолжит работу по составлению команды с того места, где Вы закончили вводить необходимые параметры.

Демонстрация работы утилиты с частично набранной командой

Установка

На данном этапе разработки утилиты установка программы не требуется.
Достаточно загрузить архивный файл, подходящий к Вашей операциой системе, установленной на компьютере, и разархивировать его.
В полученном каталоге находится исполняемый файл near CLI, к которому прилагается подробная инструкция для пользователя.
Если необходимо скомпилировать CLI из исходного кода, перейдите к разделу Сборка.

Инструкция

Подробная инструкция доступна в файле 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)

Подробнее о работе с конфигурационным файлом можно ознакомиться здесь.

Сборка

near CLI написан на Rust. Поэтому необходимо установить Rust для компиляции программы. near CLI компилируется на версии Rust 1.64.0 (stable) или новее.

Сборка near CLI:

$ 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