Skip to content

Latest commit

 

History

History
2168 lines (1781 loc) · 104 KB

GUIDE.ru.md

File metadata and controls

2168 lines (1781 loc) · 104 KB
Raw

Инструкция

Это руководство предназначено для того, чтобы дать подробное описание утилиты near CLI и обзор её возможностей. Предполагается, что утилита near CLI установлена и пользователи знакомы с использованием инструментов командной строки. Также предполагается Unix-подобная система, хотя большинство команд, вероятно, легко переводимы в любую среду оболочки командной строки.

Спомощью near CLI можно создать, подписать и отправить транзакцию в режиме online, который включен по умолчанию. В режиме offline можно создать и подписать транзакцию. Транзакция, кодированная в base64 может быть подписана или отправлена позже (даже с другого компьютера). Для входа в режим offline необходимо в команде установить флаг --offline:

near --offline tokens \
    fro_volod.testnet \
    send-near volodymyr.testnet 0.1NEAR \
    network-config testnet \
    sign-later

Прежде, чем перейти к описанию конкретных команд, необходимо рассмотреть два общих для этих команд пункта:

  1. Подпись транзакции

    near CLI предполагает несколько способов подписи созданной транзакции. Рассмотрим подробнее каждый.

    • sign-with-keychain - Sign the transaction with a key saved in the secure keychain

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

    • sign-with-legacy-keychain - Sign the transaction with a key saved in legacy keychain (compatible with the old near CLI)

      near CLI самостоятельно найдет ключи доступа и подпишет созданную транзакцию. Каталог с ключами доступа определен в конфигурационном файле. Ключи доступа должны находиться в файле публичный-ключ.json, расположенном в /Users/user/.near-credentials/имя-сети/имя-пользователя/. Например, /Users/frovolod/.near-credentials/testnet/volodymyr.testnet/ed25519_8h7kFK4quSUJRkUwo3LLiK83sraEm2jnQTECuZhWu8HC.json

      Демонстрация работы команды в интерактивном режиме

    • sign-with-ledger - Sign the transaction with Ledger Nano device

      Этот вариант предполагает подписание созданной транзакции при помощи леджера.

    • sign-with-plaintext-private-key - Sign the transaction with a plaintext private key

      При выборе этого варианта подписи near CLI попросит пользователя ввести ключи доступа:

      • "public_key":"ed25519:Ebx7...",
      • "private_key":"ed25519:2qM8..."

    • sign-with-access-key-file - Sign the transaction using the account access key file (access-key-file.json)

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

    • sign-with-seed-phrase - Sign the transaction using the seed phrase

      При выборе этого варианта подписи near CLI попросит пользователя ввести мнемоническую фразу, связанную с аккаунтом.

    • sign-later - Prepare unsigned transaction (we'll use base64 encoding to simplify copy-pasting)

      Этот вариант предполагает подписание созданной транзакции позже.

  2. Действия с подписанной транзакцией

    near CLI поддерживает мета-транзакции, описанные в спецификации NEP-366. Для её создания достаточно указать network, поддерживающую мета-транзакции. Узнать о такой поддержке можно в конфигурационном файле. За возможность поддержки мета-транзакции отвечает поле meta_transaction_relayer_url. Например:

    meta_transaction_relayer_url = "https://near-testnet.api.pagoda.co/relay"

    Подписанную транзакцию / мета-транзакцию можно либо немедленно отправить на выполнение:

    • send - Send the transaction to the network

    либо вывести на экран в формате base64 для последующей отправки:

    • display - Print only the signed transaction in base64 encoding. We will use it to send it later. (Example: near transaction send-signed-transaction 'EQAAAHZvb...' ...)

Группы команд

account - Manage accounts

Просмотреть сведения об аккаунте (View properties for an account) и просмотреть ключи доступа к аккаунту (View a list of access keys of an account) возможно на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). На примерах ниже показаны варианты применения этих режимов.

view-account-summary - View properties for an account

now - View properties in the final block

Для просмотра сведений об аккаунте на последнем блоке необходимо ввести в командной строке терминала:

near account \
    view-account-summary fro_volod.testnet \
    network-config testnet \
    now
Результат выполнения команды 
Account details for 'fro_volod.testnet' at block #97804915 (5G8HHWMJMHRMMaHTjeZLSvL7ruYMtH9tXq25Q6BPUivu)
Native account balance: 182.685021399504861699999997 NEAR
Validator stake: 0 NEAR
Storage used by the account: 288962 bytes
Contract code SHA-256 checksum (hex): fd999145baf49ece7d09fca7d030d384c4ea8ed4df651c6e87a015c4dfa6c0ec
Number of access keys: 14
   1. ed25519:2QFAeUutKUDpmgKDyHXm7Wcz1uhjxk92fK6zY2dB7FCD (nonce: 97492076000000) is granted to only do [] function calls on v2.ref-farming.testnet with an allowance of 0.25 NEAR
   2. ed25519:3p1HbrTDYxY4q3V6QznW14qkuv3Bq1phFpCTsbrJpbEC (nonce: 94363284000000) is granted to full access
   3. ed25519:5UJE4PzyxECS42hBZSD1QQCLdq5j39vCtzshFPbnGdm1 (nonce: 73069087000002) is granted to full access
   4. ed25519:6YU78BezKwQNrz5vmtkSCALtx7cPDC1JBs9DhjeSJ39X (nonce: 97490513000000) is granted to only do [] function calls on v2.ref-farming.testnet with an allowance of 0.25 NEAR
   5. ed25519:7YCfA1KrToJtAYGTBgAMe4LWfQEi4iwLGcH2q5SvGKzD (nonce: 94982716000000) is granted to only do [] function calls on mintspace2.testnet with an allowance of 0.25 NEAR
   6. ed25519:95w5YFsJ3iktzDwRBWUGqLF6Gv5CoJuVifBjcEEdJs8s (nonce: 72253433000003) is granted to full access
   7. ed25519:9nyDySTNAGPywxC9pG4DPdnF3eEVexDgrfzZYsoahPsV (nonce: 76057805000000) is granted to full access
   8. ed25519:AEC4szaeNzT8PQAifsnisdivq4mwswJbBM65DdkT6kdS (nonce: 72263674000000) is granted to full access
   9. ed25519:D31un5TFeABdNUVMaf3QzeBz3Z3yau2GZA2VPe8XX6GB (nonce: 72325441000021) is granted to full access
  10. ed25519:DZz4r5oLSBVcLuqFzSoLUEJ3Qv67cpgGbsRHy8SvbGiU (nonce: 72253481000000) is granted to full access
  11. ed25519:DyKmdLkWMqC1HFs6t6PfNhVemjQE16W2RNofWPpW5ZZh (nonce: 72325378000007) is granted to full access
  12. ed25519:EWoYxHNZHtApUfu1nTGC49XHW5dNinoDKABcauHnjevZ (nonce: 73069042000001) is granted to full access
  13. ed25519:EYtsL67TpgfpE1udnga2m41vDoBqeZ2DB32onhsxsVUb (nonce: 72251760000002) is granted to full access
  14. ed25519:G2U7aZ91pgG3TS96gCWov5L1DkNWSi3756RRkwuspZ4L (nonce: 72251684000002) is granted to full access
Демонстрация работы команды в интерактивном режиме
at-block-height - View properties in a height-selected block

Для просмотра сведений об аккаунте на конктретном блоке можно указать высоту данного блока. Для этого нужно ввести в командной строке терминала:

near account \
    view-account-summary fro_volod.testnet \
    network-config testnet \
    at-block-height 73069245
Результат выполнения команды 
Account details for 'fro_volod.testnet' at block #73069245 (HCUJq3vQ3ztyCZAhmRmHR3cwSDcoE4zEbaWkhAjFuxUY)
Native account balance: 198.9924766125790117 NEAR
Validator stake: 0 NEAR
Storage used by the account: 288660 bytes
Contract code SHA-256 checksum (hex): fd999145baf49ece7d09fca7d030d384c4ea8ed4df651c6e87a015c4dfa6c0ec
Number of access keys: 12
   1. ed25519:5UJE4PzyxECS42hBZSD1QQCLdq5j39vCtzshFPbnGdm1 (nonce: 73069087000001) is granted to full access
   2. ed25519:95w5YFsJ3iktzDwRBWUGqLF6Gv5CoJuVifBjcEEdJs8s (nonce: 72253433000003) is granted to full access
   3. ed25519:AEC4szaeNzT8PQAifsnisdivq4mwswJbBM65DdkT6kdS (nonce: 72263674000000) is granted to full access
   4. ed25519:D31un5TFeABdNUVMaf3QzeBz3Z3yau2GZA2VPe8XX6GB (nonce: 72325441000009) is granted to full access
   5. ed25519:DZz4r5oLSBVcLuqFzSoLUEJ3Qv67cpgGbsRHy8SvbGiU (nonce: 72253481000000) is granted to full access
   6. ed25519:DyKmdLkWMqC1HFs6t6PfNhVemjQE16W2RNofWPpW5ZZh (nonce: 72325378000001) is granted to full access
   7. ed25519:EWoYxHNZHtApUfu1nTGC49XHW5dNinoDKABcauHnjevZ (nonce: 73069042000001) is granted to full access
   8. ed25519:EYtsL67TpgfpE1udnga2m41vDoBqeZ2DB32onhsxsVUb (nonce: 72251760000002) is granted to full access
   9. ed25519:G2U7aZ91pgG3TS96gCWov5L1DkNWSi3756RRkwuspZ4L (nonce: 72251684000002) is granted to full access
  10. ed25519:H5A5WfckocSLeXC7h22PcnscrWWrADHaRzrVWFMYT5o9 (nonce: 72254265000000) is granted to full access
  11. ed25519:HXHM2GTqDzCZnd7UQzPtL7VwcFfcm7n8Z8voo1ArE4Tr (nonce: 72263503000002) is granted to full access
  12. ed25519:HjzSeCGdWT15iSj2TybmKV2dZteu1VYYAaYvNYVNZY2W (nonce: 72253750000000) is granted to full access
Демонстрация работы команды в интерактивном режиме
at-block-hash - View properties in a hash-selected block

Для просмотра сведений об аккаунте необходимо ввести в командной строке терминала:

near account \
    view-account-summary fro_volod.testnet \
    network-config testnet \
    at-block-hash HCUJq3vQ3ztyCZAhmRmHR3cwSDcoE4zEbaWkhAjFuxUY
Результат выполнения команды 
Account details for 'fro_volod.testnet' at block #73069245 (HCUJq3vQ3ztyCZAhmRmHR3cwSDcoE4zEbaWkhAjFuxUY)
Native account balance: 198.9924766125790117 NEAR
Validator stake: 0 NEAR
Storage used by the account: 288660 bytes
Contract code SHA-256 checksum (hex): fd999145baf49ece7d09fca7d030d384c4ea8ed4df651c6e87a015c4dfa6c0ec
Number of access keys: 12
   1. ed25519:5UJE4PzyxECS42hBZSD1QQCLdq5j39vCtzshFPbnGdm1 (nonce: 73069087000001) is granted to full access
   2. ed25519:95w5YFsJ3iktzDwRBWUGqLF6Gv5CoJuVifBjcEEdJs8s (nonce: 72253433000003) is granted to full access
   3. ed25519:AEC4szaeNzT8PQAifsnisdivq4mwswJbBM65DdkT6kdS (nonce: 72263674000000) is granted to full access
   4. ed25519:D31un5TFeABdNUVMaf3QzeBz3Z3yau2GZA2VPe8XX6GB (nonce: 72325441000009) is granted to full access
   5. ed25519:DZz4r5oLSBVcLuqFzSoLUEJ3Qv67cpgGbsRHy8SvbGiU (nonce: 72253481000000) is granted to full access
   6. ed25519:DyKmdLkWMqC1HFs6t6PfNhVemjQE16W2RNofWPpW5ZZh (nonce: 72325378000001) is granted to full access
   7. ed25519:EWoYxHNZHtApUfu1nTGC49XHW5dNinoDKABcauHnjevZ (nonce: 73069042000001) is granted to full access
   8. ed25519:EYtsL67TpgfpE1udnga2m41vDoBqeZ2DB32onhsxsVUb (nonce: 72251760000002) is granted to full access
   9. ed25519:G2U7aZ91pgG3TS96gCWov5L1DkNWSi3756RRkwuspZ4L (nonce: 72251684000002) is granted to full access
  10. ed25519:H5A5WfckocSLeXC7h22PcnscrWWrADHaRzrVWFMYT5o9 (nonce: 72254265000000) is granted to full access
  11. ed25519:HXHM2GTqDzCZnd7UQzPtL7VwcFfcm7n8Z8voo1ArE4Tr (nonce: 72263503000002) is granted to full access
  12. ed25519:HjzSeCGdWT15iSj2TybmKV2dZteu1VYYAaYvNYVNZY2W (nonce: 72253750000000) is granted to full access
Демонстрация работы команды в интерактивном режиме

import-account - Import existing account (a.k.a. "sign in")

using-web-wallet - Import existing account using NEAR Wallet (a.k.a. "sign in")

Для авторизации пользователя необходимо ввести в командной строке терминала:

near account \
    import-account \
    using-web-wallet \
    network-config testnet

Вы будете перенаправлены браузер для авторизации. По умолчанию - это https://app.mynearwallet.com/ (для testnet - https://testnet.mynearwallet.com/). Но вы можете изменить адрес для авторизации с помощью флага --wallet-url:

near account \
    import-account \
    using-web-wallet \
    network-config testnet\
    --wallet-url 'https://wallet.testnet.near.org/'

После успешной авторизации в NEAR Wallet необходимо вернуться в терминал и ввести имя пользователя.

Результат выполнения команды 
The data for the access key is saved in macOS Keychain
Демонстрация работы команды в интерактивном режиме

using-seed-phrase - Import existing account using a seed phrase

Для авторизации пользователя необходимо ввести в командной строке терминала:

near account \
    import-account \
    using-seed-phrase 'rapid cover napkin accuse junk drill sick tooth poem patch evil fan' \
        --seed-phrase-hd-path 'm/44'\''/397'\''/0'\''' \
    network-config testnet
Результат выполнения команды 
The data for the access key is saved in macOS Keychain
Демонстрация работы команды в интерактивном режиме

using-private-key - Import existing account using a private key

Для авторизации пользователя необходимо ввести в командной строке терминала:

near account \
    import-account \
    using-private-key ed25519:5YhAaEe3G4VtiBavJMvpzPPmknfsTauzVjwK1ZjPVw2MFM6zFyUv4tSiSfCbCn78mEnMifE6iX5qbhFsWEwErcC2 \
    network-config testnet
Результат выполнения команды 
The data for the access key is saved in macOS Keychain
Демонстрация работы команды в интерактивном режиме

export-account - Export existing account

using-web-wallet - Export existing account using NEAR Wallet

Для экспорта существующего аккаунта необходимо ввести в командной строке терминала:

near account \
    export-account volodymyr.testnet \
    using-web-wallet \
    network-config testnet

Вы будете перенаправлены браузер. По умолчанию - это https://app.mynearwallet.com/ (для testnet - https://testnet.mynearwallet.com/). Но вы можете изменить адрес для авторизации с помощью флага --wallet-url:

near account \
    export-account volodymyr.testnet \
    using-web-wallet \
    network-config testnet\
    --wallet-url 'https://wallet.testnet.near.org/'
Демонстрация работы команды в интерактивном режиме

using-seed-phrase - Export existing account using a seed phrase

Для экспорта существующего аккаунта необходимо ввести в командной строке терминала:

near account \
    export-account volodymyr.testnet \
    using-seed-phrase \
    network-config testnet
Результат выполнения команды 
Here is the secret recovery seed phrase for account <volodymyr.testnet>: "feature army carpet ..." (HD Path: m/44'/397'/0').

using-private-key - Export existing account using a private key

Для экспорта существующего аккаунта необходимо ввести в командной строке терминала:

near account \
    export-account volodymyr.testnet \
    using-private-key \
    network-config testnet
Результат выполнения команды 
Here is the private key for account <volodymyr.testnet>: ed25519:4TKr1c7p...y7p8BvGdB

create-account - Create a new account

sponsor-by-faucet-service - I would like the faucet service sponsor to cover the cost of creating an account (testnet only for now)

С помощью этой команды можно создать аккаунт при помощи вспомогательного сервиса, который может спонсировать создание учетной записи (пока только testnet). При добавлении собственной сети в конфигураторе add-connection можете указать свой сервис в поле faucet_url. Ключи доступа к создаваемому аккаунту можно добавить несколькими способами:

autogenerate-new-keypair - Automatically generate a key pair

Для создания аккаунта необходимо ввести в командной строке терминала:

near account \
    create-account sponsor-by-faucet-service test_fro.testnet \
    autogenerate-new-keypair \
    save-to-keychain \
    network-config testnet \
    create
Результат выполнения команды 
The data for the access key is saved in a file /Users/frovolod/.near-credentials/testnet/test_fro.testnet/ed25519_CCwvhsp3Y3BfLbfYJQJqXJA2CaSP7CRjn1t7PyEtsjej.json
The data for the access key is saved in a file /Users/frovolod/.near-credentials/testnet/test_fro.testnet.json

New account <test_fro.testnet> created successfully.
Transaction ID: FnsrXbnzH1jjTWpAo1M8cZhEN5p7jyqgRPa1aqnRzxp3
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/FnsrXbnzH1jjTWpAo1M8cZhEN5p7jyqgRPa1aqnRzxp3
Демонстрация работы команды в интерактивном режиме
use-manually-provided-seed-prase - Use the provided seed phrase manually

Данная команда добавляет аккаунту заранее известную мнемоническую фразу. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account sponsor-by-faucet-service test_fro1.testnet \
    use-manually-provided-seed-phrase 'start vote foot cereal link cabin fantasy universe hero drama bird fiction' \
    network-config testnet \
    create
Результат выполнения команды 
New account <test_fro1.testnet> created successfully.
Transaction ID: D1rRpZx5AcYWzC91Jdt69qF1iqai7knUAtvdvqNA2bv
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/D1rRpZx5AcYWzC91Jdt69qF1iqai7knUAtvdvqNA2bv
Демонстрация работы команды в интерактивном режиме
use-manually-provided-public-key - Use the provided public key manually

Данная команда добавляет аккаунту заранее известный публичный ключ доступа. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account sponsor-by-faucet-service test_fro2.testnet \
    use-manually-provided-public-key ed25519:HVPgAsZkZ7cwLZDqK313XJsDyqAvgBxrATcD7VacA8KE \
    network-config testnet \
    create
Результат выполнения команды 
New account <test_fro2.testnet> created successfully.
Transaction ID: E7rKjJiYg1BwXa6e7xMueDS8NUNjqZSN5zDRpB5sARTi
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/E7rKjJiYg1BwXa6e7xMueDS8NUNjqZSN5zDRpB5sARTi
Демонстрация работы команды в интерактивном режиме
use-ledger - Use a ledger

Данная команда с помощью леджера добавляет ключи доступа аккаунту. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account sponsor-by-faucet-service test_fro3.testnet \
    use-ledger \
    network-config testnet \
    create
Результат выполнения команды 
New account <test_fro3.testnet> created successfully.
Transaction ID: BStBXVisyR5FUj3ZfCAeQ1ohfwTnx2vTbYaRPLTQ5Uek
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/BStBXVisyR5FUj3ZfCAeQ1ohfwTnx2vTbYaRPLTQ5Uek
Демонстрация работы команды в интерактивном режиме

fund-myself - I would like fund myself to cover the cost of creating an account

С помощью этой команды можно создать как суб-аккаунт, так и аккаунт с коротким именем, например, alice.near или alice.testnet (в сети testnet). Ключи доступа к создаваемому аккаунту можно добавить несколькими способами:

autogenerate-new-keypair - Automatically generate a key pair

Для создания суб-аккаунта необходимо ввести в командной строке терминала:

near account \
    create-account fund-myself new.fro_volod.testnet '1 NEAR' \
    autogenerate-new-keypair \
    save-to-keychain \
    sign-as \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
New account <new.fro_volod.testnet> created successfully.
Transaction ID: DRT3EpCK9iT5APyGgfcgSoLPCLCYYKtnrVgDhGLDEZFo
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/DRT3EpCK9iT5APyGgfcgSoLPCLCYYKtnrVgDhGLDEZFo

The data for the access key is saved in a file /Users/frovolod/.near-credentials/testnet/new.fro_volod.testnet/ed25519_3ngtirechhepHKrzfkdgqqtwqSMtdbSLR6N1c4ivnzu6.json
The data for the access key is saved in a file "/Users/frovolod/.near-credentials/testnet/new.fro_volod.testnet.json"
Демонстрация работы команды в интерактивном режиме

Для создания аккаунта с коротким именем необходимо ввести в командной строке терминала:

near account \
    create-account fund-myself new7.testnet '0.1 NEAR' \
    autogenerate-new-keypair \
    save-to-keychain \
    sign-as fro_volod.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
New account <new7.testnet> created successfully.
Transaction ID: GxZRjmYxZyo6X6Mn1kfuRJhfUnxsUVCiHZAZKqrLtR27
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/GxZRjmYxZyo6X6Mn1kfuRJhfUnxsUVCiHZAZKqrLtR27

The data for the access key is saved in a file "/Users/frovolod/.near-credentials/testnet/new7.testnet/ed25519_EX1qK1S1T4WxXJFLH7qZvKxnGQtcKfEEsiA4BNxAZ6mP.json"
The file: /Users/frovolod/.near-credentials/testnet/new7.testnet.json already exists! Therefore it was not overwritten.
Демонстрация работы команды в интерактивном режиме
use-manually-provided-seed-prase - Use the provided seed phrase manually

Данная команда добавляет аккаунту заранее известную мнемоническую фразу. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account fund-myself seed.volodymyr.testnet '0.1 NEAR' \
    use-manually-provided-seed-phrase 'start vote foot cereal link cabin fantasy universe hero drama bird fiction' \
    sign-as volodymyr.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
New account <seed.volodymyr.testnet> created successfully.
Transaction ID: 31iA2SsxtrRzb3fD5KtsFTZni8yUi2iZboNQih9bZuDt
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/31iA2SsxtrRzb3fD5KtsFTZni8yUi2iZboNQih9bZuDt
Демонстрация работы команды в интерактивном режиме
use-manually-provided-public-key - Use the provided public key manually

Данная команда добавляет аккаунту заранее известный публичный ключ доступа. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account fund-myself pk.volodymyr.testnet '0.1 NEAR' \
    use-manually-provided-public-key ed25519:6jm8hWUgwoEeGmpdEyk9zrCqtXM8kHhvg8M236ZaGusS \
    sign-as volodymyr.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
New account <pk.volodymyr.testnet> created successfully.
Transaction ID: CAVAR7jx2ofnbjxFFL2JVNbLsGNWF2q2tqMEtHxXmRLi
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/CAVAR7jx2ofnbjxFFL2JVNbLsGNWF2q2tqMEtHxXmRLi
Демонстрация работы команды в интерактивном режиме
use-ledger - Use a ledger

Данная команда с помощью леджера добавляет ключи доступа аккаунту. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account fund-myself ledger1.volodymyr.testnet '0.1 NEAR' \
    use-ledger \
    sign-as volodymyr.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
New account <ledger1.volodymyr.testnet> created successfully.
Transaction ID: BKJp3QdaLtnXA8xwfqyk6JfrDsDxbxqADVyuNzQmKGNL
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/BKJp3QdaLtnXA8xwfqyk6JfrDsDxbxqADVyuNzQmKGNL
Демонстрация работы команды в интерактивном режиме

fund-later - Create an implicit-account

use-auto-generation - Use auto-generation to create an implicit account

Данная команда автоматически генерирует ключи доступа и сохраняет их в файле с именем implicit-account-id. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account \
    fund-later \
    use-auto-generation \
    save-to-folder /Users/frovolod/.near-credentials/implicit
Результат выполнения команды 
The file "/Users/frovolod/.near-credentials/implicit/1573066d3fa7a2d56357aa5ddbc84295d94c61590390000981f5900b04e2f55f.json" was saved successfully
Демонстрация работы команды в интерактивном режиме
use-ledger - Use ledger to create an implicit account

Данная команда с помощью леджера генерирует ключи доступа и сохраняет их в файле с именем implicit-account-id. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account \
    fund-later \
    use-ledger \
    save-to-folder /Users/frovolod/.near-credentials/implicit/ledger
Результат выполнения команды 
The file "/Users/frovolod/.near-credentials/implicit/ledger/739c872c3057cd5d812c49345248b9fdd318c8ad33ace6cf0468109eae972c8e.json" was saved successfully
Демонстрация работы команды в интерактивном режиме
use-seed-phrase - Use seed phrase to create an implicit account

Данная команда с помощью мнемонической фразы генерирует ключи доступа и сохраняет их в файле с именем implicit-account-id. Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    create-account \
    fund-later \
    use-seed-phrase 'start vote foot cereal link cabin fantasy universe hero drama bird fiction' \
        --seed-phrase-hd-path 'm/44'\''/397'\''/0'\''' \
    save-to-folder /Users/frovolod/.near-credentials/implicit
Результат выполнения команды 
The file "/Users/frovolod/.near-credentials/implicit/eca9e1a6e0fa9a6af6d046bcffa6508f90f98e646836647ecd883d1d2b1989e5.json" was saved successfully
Демонстрация работы команды в интерактивном режиме

update-social-profile - Update NEAR Social profile

json-args - Valid JSON arguments (e.g. {"token_id": "42"})

Для изменения профиля аккаунта на контракте с использованием аргументов в формате JSON необходимо ввести в командной строке терминала:

near account \
    update-social-profile fro_volod.testnet \
    json-args '{"name":"frovolod","image":{"ipfs_cid":"bafkreifdzusz6hp3j4njdtqqxr3tlvx4agedgh7znyac4wbuiao3gtppde"},"linktree":{"github":"FroVolod","telegram":"frovolod"},"tags": {"rust":"","near":"","developer":""}}' \
    sign-as fro_volod.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Profile for fro_volod.testnet updated successfully
Демонстрация работы команды в интерактивном режиме
file-args - Read from file (e.g. reusable JSON or binary data)

Для изменения профиля аккаунта на контракте с использованием подготовленного файла необходимо ввести в командной строке терминала:

near account \
    update-social-profile fro_volod.testnet \
    file-args profile.txt \
    sign-as fro_volod.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Profile for fro_volod.testnet updated successfully
Демонстрация работы команды в интерактивном режиме
manually - Interactive input of arguments

Для изменения профиля аккаунта на контракте с использованием интерактивного режима необходимо воспользоваться диалоговыми подсказками либо ввести в командной строке терминала:

near account \
    update-social-profile fro_volod.testnet \
    manually \
        --name fro_volod.testnet \
        --image-ipfs-cid bafkreifdzusz6hp3j4njdtqqxr3tlvx4agedgh7znyac4wbuiao3gtppde \
        --description 'This is my profile' \
        --github FroVolod \
        --website https://auto-rti.com/ \
        --tags dev,rust \
    sign-as fro_volod.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Profile for fro_volod.testnet updated successfully
Демонстрация работы команды в интерактивном режиме

delete-account - Delete an account

Данная команда предназначена для удаления текущего аккаунта. Важно помнить, что все средства удаляемого аккаунта перейдут на счет "beneficiary". Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    delete-account 2.fro_volod.testnet \
    beneficiary volodymyr.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
Account <2.fro_volod.testnet> has been successfully deleted.
Transaction ID: EHvB47npN8Z46qhsrw5XpKmD3n3jDn4MGiD85YSqw7cy
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/EHvB47npN8Z46qhsrw5XpKmD3n3jDn4MGiD85YSqw7cy
Демонстрация работы команды в интерактивном режиме

list-keys - View a list of access keys of an account

Просмотр ключей доступа аккаунта возможен на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). Примеры использования этих параметров рассмотрены в разделе View properties for an account.

Для просмотра списка ключей доступа необходимо ввести в командной строке терминала:

near account \
    list-keys fro_volod.testnet \
    network-config testnet \
    now
Результат выполнения команды 
Number of access keys: 14
   1. ed25519:2QFAeUutKUDpmgKDyHXm7Wcz1uhjxk92fK6zY2dB7FCD (nonce: 97492076000000) is granted to only do [] function calls on v2.ref-farming.testnet with an allowance of 0.25 NEAR
   2. ed25519:3p1HbrTDYxY4q3V6QznW14qkuv3Bq1phFpCTsbrJpbEC (nonce: 94363284000000) is granted to full access
   3. ed25519:5UJE4PzyxECS42hBZSD1QQCLdq5j39vCtzshFPbnGdm1 (nonce: 73069087000002) is granted to full access
   4. ed25519:6YU78BezKwQNrz5vmtkSCALtx7cPDC1JBs9DhjeSJ39X (nonce: 97490513000000) is granted to only do [] function calls on v2.ref-farming.testnet with an allowance of 0.25 NEAR
   5. ed25519:7YCfA1KrToJtAYGTBgAMe4LWfQEi4iwLGcH2q5SvGKzD (nonce: 94982716000000) is granted to only do [] function calls on mintspace2.testnet with an allowance of 0.25 NEAR
   6. ed25519:95w5YFsJ3iktzDwRBWUGqLF6Gv5CoJuVifBjcEEdJs8s (nonce: 72253433000003) is granted to full access
   7. ed25519:9nyDySTNAGPywxC9pG4DPdnF3eEVexDgrfzZYsoahPsV (nonce: 76057805000000) is granted to full access
   8. ed25519:AEC4szaeNzT8PQAifsnisdivq4mwswJbBM65DdkT6kdS (nonce: 72263674000000) is granted to full access
   9. ed25519:D31un5TFeABdNUVMaf3QzeBz3Z3yau2GZA2VPe8XX6GB (nonce: 72325441000021) is granted to full access
  10. ed25519:DZz4r5oLSBVcLuqFzSoLUEJ3Qv67cpgGbsRHy8SvbGiU (nonce: 72253481000000) is granted to full access
  11. ed25519:DyKmdLkWMqC1HFs6t6PfNhVemjQE16W2RNofWPpW5ZZh (nonce: 72325378000007) is granted to full access
  12. ed25519:EWoYxHNZHtApUfu1nTGC49XHW5dNinoDKABcauHnjevZ (nonce: 73069042000001) is granted to full access
  13. ed25519:EYtsL67TpgfpE1udnga2m41vDoBqeZ2DB32onhsxsVUb (nonce: 72251760000002) is granted to full access
  14. ed25519:G2U7aZ91pgG3TS96gCWov5L1DkNWSi3756RRkwuspZ4L (nonce: 72251684000002) is granted to full access
Демонстрация работы команды в интерактивном режиме

add-key - Add an access key to an account

Выполним команду добавления новой пары ключей доступа аккаунту с такими условиями:

  • публичный ключ доступа будет введен вручную
  • ключи будут иметь полный доступ
  • транзакция будет подписана автоматически (при наличии файла с ключами доступа)

Для выполнения этой команды необходимо ввести в командной строке терминала:

near account \
    add-key fro_volod.testnet \
    grant-full-access \
    use-manually-provided-public-key ed25519:75a5ZgVZ9DFTxs4THtFxPtLj7AY3YzpxtapTQBdcMXx3 \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
Added access key = ed25519:75a5ZgVZ9DFTxs4THtFxPtLj7AY3YzpxtapTQBdcMXx3 to fro_volod.testnet.
Transaction ID: 2oVDKopcWphN3qrUoq7XjFMpRuCUjz6jSU327q8trAQ5
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/2oVDKopcWphN3qrUoq7XjFMpRuCUjz6jSU327q8trAQ5
Демонстрация работы команды в интерактивном режиме

Изменим наши парамерты для добавления кючей доступа:

  • ключи будут сгенерированы автоматически
  • будут иметь функциональный доступ
  • транзакция будет подписана вручную

Для этого введем следующую команду:

near account \
    add-key fro_volod.testnet \
    grant-function-call-access \
        --allowance '1 NEAR' \
        --receiver-account-id 'meta.pool.testnet' \
        --method-names 'set_a, set_b' \
    autogenerate-new-keypair \
    save-to-keychain \
    network-config testnet \
    sign-with-plaintext-private-key \
        --signer-public-key ed25519:D31un5TFeABdNUVMaf3QzeBz3Z3yau2GZA2VPe8XX6GB \
        --signer-private-key  ed25519:3UVo1GAatRz12iX3CRuKAuK3MPLDD9bPf4LXJD5DkHs13er3UeJLW7aRPAVsFQ2FjopUw6DEApEngac8FPtnnkYB \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
Added access key = ed25519:27R66L6yevyHbsk4fESZDC8QUQBwCdx6vvkk1uQmG7NY to fro_volod.testnet.
Transaction ID: DaJySrNtSUZU7KPyvfUMbh6xYi9vZeMvnj4Umo7ZzdB3
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/DaJySrNtSUZU7KPyvfUMbh6xYi9vZeMvnj4Umo7ZzdB3
Демонстрация работы команды в интерактивном режиме

delete-key - Delete an access key from an account

Для удаления ключей доступа необходимо ввести в командной строке терминала:

near account \
    delete-key fro_volod.testnet \
    ed25519:75a5ZgVZ9DFTxs4THtFxPtLj7AY3YzpxtapTQBdcMXx3 \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
Access key <ed25519:75a5ZgVZ9DFTxs4THtFxPtLj7AY3YzpxtapTQBdcMXx3> for account <fro_volod.testnet> has been successfully deleted.
Transaction ID: 6S7bJ76QNFypUvP7PCB1hkLM7X5GxPxP2gn4rnDHMzPz
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/6S7bJ76QNFypUvP7PCB1hkLM7X5GxPxP2gn4rnDHMzPz
Демонстрация работы команды в интерактивном режиме

manage-storage-deposit - Storage management: deposit, withdrawal, balance review

view-balance - View storage balance for an account

Для просмотра баланса аккаунта на контракте на последнем блоке необходимо ввести в командной строке терминала:

near account \
    manage-storage-deposit v1.social08.testnet \
    view-balance volodymyr.testnet \
    network-config testnet \
    now
Результат выполнения команды 
storage balance for <volodymyr.testnet>:
 available:        1.6 MB   (15.878059999854543210876557 NEAR [  15878059999854543210876557 yoctoNEAR])
 total:            1.6 MB   (16.238949999854543210876557 NEAR [  16238949999854543210876557 yoctoNEAR])
Демонстрация работы команды в интерактивном режиме
deposit - Make a storage deposit for the account

Для пополнения баланса аккаунта на контракте необходимо ввести в командной строке терминала:

near account \
    manage-storage-deposit v1.social08.testnet \
    deposit volodymyr.testnet '1 NEAR' \
    sign-as fro_volod.testnet \
    network-config testnet \
    sign-with-macos-keychain \
    send
Результат выполнения команды 
<fro_volod.testnet> has successfully added a deposit of 1 NEAR to <volodymyr.testnet> on contract <v1.social08.testnet>.
Демонстрация работы команды в интерактивном режиме
withdraw - Withdraw a deposit from storage for an account ID

Для вывода средств с баланса аккаунта на контракте необходимо ввести в командной строке терминала:

near account \
    manage-storage-deposit v1.social08.testnet \
    withdraw '0.5 NEAR' \
    sign-as volodymyr.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
<volodymyr.testnet> has successfully withdraw 0.5 NEAR from <v1.social08.testnet>.
Демонстрация работы команды в интерактивном режиме

tokens - Manage token assets such as NEAR, FT, NFT

send-near - The transfer is carried out in NEAR tokens

Данная команда служит для перевода средств NEAR токенах между аккаунтами. Обратите внимание, что количество пересылаемых токенов указывается совместно с размерной единицей (это NEAR либо yoctoNEAR). Для выполнения этой команды необходимо ввести в командной строке терминала:

near tokens \
    fro_volod.testnet \
    send-near volodymyr.testnet 0.1NEAR \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
<fro_volod.testnet> has transferred 0.1 NEAR to <volodymyr.testnet> successfully.
Transaction ID: 8BbB674VDxeg36egMzdHFsCUExpkLWAWeYqEfd9u9ZaD
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/8BbB674VDxeg36egMzdHFsCUExpkLWAWeYqEfd9u9ZaD
Демонстрация работы команды в интерактивном режиме

send-ft - The transfer is carried out in FT tokens

Данная команда служит для перевода средств в FT токенах между аккаунтами. Обратите внимание, что количество пересылаемых токенов указывается в безразмерных единицах. Для выполнения этой команды необходимо ввести в командной строке терминала:

near tokens \
    fro_volod.testnet \
    send-ft usdn.testnet volodymyr.testnet 10000000000000000000 \
        --prepaid-gas 100.000TeraGas \
        --attached-deposit 1yoctoNEAR \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
The "ft_transfer" call to <usdn.testnet> on behalf of <fro_volod.testnet> succeeded.
Transaction ID: 5a7YmANdpimiqUm6WC6n4dd91b6A9PafNNhad8HWKugN
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/5a7YmANdpimiqUm6WC6n4dd91b6A9PafNNhad8HWKugN
Демонстрация работы команды в интерактивном режиме

send-nft - The transfer is carried out in NFT tokens

Данная команда служит для перевода средств в NFT токенах между аккаунтами. Для выполнения этой команды необходимо ввести в командной строке терминала:

near tokens \
    fro_volod.testnet \
    send-nft paras-token-v2.testnet volodymyr.testnet 1604:4 \
        --prepaid-gas 100.000TeraGas \
        --attached-deposit 1yoctoNEAR \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
The "nft_transfer" call to <paras-token-v2.testnet> on behalf of <fro_volod.testnet> succeeded.
Transaction ID: 9q2VbakZbj5ja6GAFXpFnbtbYHijEHyT7Ry34GQ6cvLB
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/9q2VbakZbj5ja6GAFXpFnbtbYHijEHyT7Ry34GQ6cvLB
Демонстрация работы команды в интерактивном режиме

view-near-balance - View the balance of Near tokens

Просмотр баланса аккаунта возможен на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). Примеры использования этих параметров рассмотрены в разделе View properties for an account.

Для просмотра средств в NEAR токенах на счету аккаунта необходимо ввести в командной строке терминала:

near tokens \
    fro_volod.testnet \
    view-near-balance \
    network-config testnet \
    now
Результат выполнения команды 
fro_volod.testnet account has 169.589001320890476999999994 NEAR available for transfer (the total balance is 172.482461320890476999999994 NEAR, but 2.89246 NEAR is locked for storage and the transfer transaction fee is ~0.001 NEAR)
Демонстрация работы команды в интерактивном режиме

view-ft-balance - View the balance of FT tokens

Просмотр баланса аккаунта возможен на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). Примеры использования этих параметров рассмотрены в разделе View properties for an account.

Для просмотра средств в FT токенах на счету аккаунта необходимо ввести в командной строке терминала:

near tokens \
    fro_volod.testnet \
    view-ft-balance usdn.testnet \
    network-config testnet \
    now
Результат выполнения команды 
fro_volod.testnet account has "31942967677775774595" FT tokens (FT-contract: usdn.testnet)
Демонстрация работы команды в интерактивном режиме

view-nft-assets - View the balance of NFT tokens

Просмотр баланса аккаунта возможен на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). Примеры использования этих параметров рассмотрены в разделе View properties for an account.

Для просмотра средств в NFT токенах на счету аккаунта необходимо ввести в командной строке терминала:

near tokens \
    fro_volod.testnet \
    view-nft-assets paras-token-v2.testnet \
    network-config testnet \
    now
Результат выполнения команды 
fro_volod.testnet account has NFT tokens:
[
  {
    "approved_account_ids": {},
    "metadata": {
      "copies": 100,
      "description": null,
      "expires_at": null,
      "extra": null,
      "issued_at": "1657613801537412611",
      "media": "bafybeib65t37t2tagukok4m7f5rldfirzb5ykvdq3yqbwnbcrtllpggg6u",
      "media_hash": null,
      "reference": "bafkreidmbv4j2qylxc2mngsup7cxakw7gwyd7lu2zycznrdtqw4kc52cwu",
      "reference_hash": null,
      "starts_at": null,
      "title": "Apollo42 #01 #4",
      "updated_at": null
    },
    "owner_id": "fro_volod.testnet",
    "token_id": "1604:4"
  }
]
Демонстрация работы команды в интерактивном режиме

staking - Manage staking: view, add and withdraw stake

validator-list - View the list of validators to delegate

Для просмотра списка валидаторов необходимо ввести в командной строке терминала:

near staking \
    validator-list \
    network-config mainnet
Результат выполнения команды 
+-----+----------------------------------------------+----------+------------+----------------------------------------+
| #   | Validator Id                                 | Fee      | Delegators | Stake                                  |
+-----+----------------------------------------------+----------+------------+----------------------------------------+
| 1   | staked.poolv1.near                           |     10 % |     3207   | 44135674.18356215181482959363448 NEAR  |
| 2   | figment.poolv1.near                          |     10 % |     1911   | 43158696.364374348313201031661037 NEAR |
| 3   | astro-stakers.poolv1.near                    |      1 % |    11528   | 26760042.204197815051321354819805 NEAR |
| 4   | bzam6yjpnfnxsdmjf6pw.poolv1.near             |    100 % |      772   | 23347900.996610021010359525969384 NEAR |
| 5   | zavodil.poolv1.near                          |      1 % |     7116   | 20700903.223980192761611953425855 NEAR |
| 6   | binancenode1.poolv1.near                     |      5 % |     1250   | 14209385.916611355199355410152982 NEAR |
| 7   | staking_yes_protocol1.poolv1.near            |    100 % |       65   | 13590245.381034035922399111793022 NEAR |
| 8   | pinnacle1.poolv1.near                        |    100 % |        4   | 13509874.537453205747773186007329 NEAR |
| 9   | priory.poolv1.near                           |    100 % |       15   | 12727257.514716521676379711750814 NEAR |
| 10  | stake1.poolv1.near                           |      3 % |      754   | 12449700.095021989100340879377004 NEAR |
| 11  | mockingbird.poolv1.near                      |    100 % |       28   | 11501759.018634341466180769487983 NEAR |
| 12  | dqw9k3e4422cxt92masmy.poolv1.near            |    100 % |       36   | 11122519.385245577197951932017032 NEAR |
| 13  | flipside.pool.near                           |    100 % |        9   | 11087540.718366137730589600283212 NEAR |
| 14  | sweat_validator.poolv1.near                  |    100 % |      112   | 10900424.272450229667472212076621 NEAR |
| 15  | epic.poolv1.near                             |      1 % |     5363   | 10769900.629411406438519703653828 NEAR |
| 16  | future_is_near.poolv1.near                   |      9 % |      355   | 10243082.132364573976720438585765 NEAR |
| 17  | cosmose.poolv1.near                          |    100 % |       10   | 10064982.806109296980776431396738 NEAR |
| 18  | aurora.pool.near                             |     99 % |     3301   | 9298278.181302142009939675438401 NEAR  |
...
Демонстрация работы команды в интерактивном режиме

delegation - Delegation management

view-balance - View the delegated stake balance for a given account

Для просмотра порученного баланса аккаунта в общий фонд валидатора необходимо ввести в командной строке терминала:

near staking \
    delegation volodymyr.testnet \
    view-balance aurora.pool.f863973.m0 \
    network-config testnet \
    now
Результат выполнения команды 
Delegated stake balance with validator <aurora.pool.f863973.m0> by <volodymyr.testnet>:
      Staked balance:           38.021465232511349340052266 NEAR
      Unstaked balance:          0.000000000000000000000001 NEAR
      Total balance:            38.021465232511349340052267 NEAR
Демонстрация работы команды в интерактивном режиме
deposit-and-stake - Delegate NEAR tokens to a validator's staking pool

Чтобы поручить ваши NEAR токены в общий фонд одного из валидаторов и получения наград, передайте ваши NEAR токены и переведите их в ставку валидатора, используя следующую командну в терминале (обратите внимание, что вам необходимо использовать свой собственный идентификатор аккаунта, указать желаемое количество NEAR токенов, а также выбрать идентификатор аккаунта валидатора):

near staking \
    delegation volodymyr.testnet \
    deposit-and-stake '15 NEAR' aurora.pool.f863973.m0 \
    network-config testnet \
    sign-with-legacy-keychain \
    send
Результат выполнения команды 
<volodymyr.testnet> has successfully deposited and staked 15 NEAR on <aurora.pool.f863973.m0>.
Демонстрация работы команды в интерактивном режиме
stake - Delegate a certain amount of previously deposited or unstaked NEAR tokens to a validator's staking pool

Чтобы поручить ваши NEAR токены в общий фонд одного из валидаторов и получения наград, переведите раннее переданные NEAR токены в ставку валидатора, используя следующую командну в терминале (обратите внимание, что вам необходимо использовать свой собственный идентификатор аккаунта, указать желаемое количество NEAR токенов, а также выбрать идентификатор аккаунта валидатора):

near staking \
    delegation volodymyr.testnet \
    stake '5 NEAR' aurora.pool.f863973.m0 \
    network-config testnet \
    sign-with-legacy-keychain \
    send
Результат выполнения команды 
<volodymyr.testnet> has successfully stake 5 NEAR on <aurora.pool.f863973.m0>.
Демонстрация работы команды в интерактивном режиме
stake-all - Delegate all previously deposited or unstaked NEAR tokens to a validator's staking pool

Чтобы поручить ваши NEAR токены в общий фонд одного из валидаторов и получения наград, переведите все раннее переданные NEAR токены в ставку валидатора, используя следующую командну в терминале (обратите внимание, что вам необходимо использовать свой собственный идентификатор аккаунта, а также выбрать идентификатор аккаунта валидатора):

near staking \
    delegation volodymyr.testnet \
    stake-all aurora.pool.f863973.m0 \
    network-config testnet \
    sign-with-legacy-keychain \
    send
Результат выполнения команды 
<volodymyr.testnet> has successfully stake the entire amount on <aurora.pool.f863973.m0>.
Демонстрация работы команды в интерактивном режиме
unstake - Unstake a certain amount of delegated NEAR tokens from a avalidator's staking pool

Чтобы отменить определённую часть ставки, совершённую через общий фонд валидатора, используйте следующую командну в терминале (обратите внимание, что вам необходимо использовать свой собственный идентификатор аккаунта, указать желаемое количество NEAR токенов, а также выбрать идентификатор аккаунта валидатора):

near staking \
    delegation volodymyr.testnet \
    unstake '7 NEAR' aurora.pool.f863973.m0 \
    network-config testnet \
    sign-with-legacy-keychain \
    send
Результат выполнения команды 
<volodymyr.testnet> has successfully unstake 7 NEAR from <aurora.pool.f863973.m0>.
Демонстрация работы команды в интерактивном режиме
unstake-all - Unstake all delegated NEAR tokens from a avalidator's staking pool

Чтобы отменить всю ставку, совершённую через общий фонд валидатора, используйте следующую командну в терминале (обратите внимание, что вам необходимо использовать свой собственный идентификатор аккаунта, а также выбрать идентификатор аккаунта валидатора):

near staking \
    delegation volodymyr.testnet \
    unstake-all aurora.pool.f863973.m0 \
    network-config testnet \
    sign-with-legacy-keychain \
    send
Результат выполнения команды 
<volodymyr.testnet> has successfully unstake the entire amount from <aurora.pool.f863973.m0>.
Демонстрация работы команды в интерактивном режиме
withdraw - Withdraw a certain amount of unstaked NEAR tokens from a avalidator's staking pool

Чтобы получить ваши раннее порученные NEAR токены и награды из общего фонда валидатора после того как ставка была снята и прошло 4 эпохи, используйте следующую командну в терминале (обратите внимание, что вам необходимо использовать свой собственный идентификатор аккаунта, указать желаемое количество NEAR токенов, а также выбрать идентификатор аккаунта валидатора):

near staking \
    delegation volodymyr.testnet \
    withdraw '3 NEAR' aurora.pool.f863973.m0 \
    network-config testnet \
    sign-with-legacy-keychain \
    send
Результат выполнения команды 
Error:
   0: <volodymyr.testnet> can't withdraw tokens in the current epoch.
Демонстрация работы команды в интерактивном режиме
withdraw-all - Withdraw all unstaked NEAR tokens from a avalidator's staking pool

Чтобы получить все ваши раннее порученные NEAR токены и награды из общего фонда валидатора после того как ставка была снята и прошло 4 эпохи, используйте следующую командну в терминале (обратите внимание, что вам необходимо использовать свой собственный идентификатор аккаунта, а также выбрать идентификатор аккаунта валидатора):

near staking \
    delegation volodymyr.testnet \
    withdraw-all aurora.pool.f863973.m0 \
    network-config testnet \
    sign-with-legacy-keychain \
    send
Результат выполнения команды 
Error:
   0: <volodymyr.testnet> can't withdraw tokens in the current epoch.
Демонстрация работы команды в интерактивном режиме

contract - Manage smart-contracts: deploy code, call functions

call-function - Execute function (contract method)

as-read-only - Calling a view method

Просмотр данных возможен на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). Примеры использования этих параметров рассмотрены в разделе View properties for an account.

Для выполнения этой команды необходимо ввести в командной строке терминала:

near contract \
    call-function \
    as-read-only zavodil.poolv1.near get_accounts \
    json-args '{"from_index": 0, "limit": 3}' \
    network-config mainnet \
    now
Результат выполнения команды 
[
  {
    "account_id": "zavodil.near",
    "can_withdraw": false,
    "staked_balance": "107480661091559500516766891",
    "unstaked_balance": "1307739180247557404925470405"
  },
  {
    "account_id": "gagdiez.near",
    "can_withdraw": true,
    "staked_balance": "4387193990112136827894210960",
    "unstaked_balance": "1"
  },
  {
    "account_id": "gibby49.near",
    "can_withdraw": true,
    "staked_balance": "1105950300133283278041226",
    "unstaked_balance": "1"
  }
]
Демонстрация работы команды в интерактивном режиме
as-transaction - Calling a change method

Для выполнения этой команды необходимо ввести в командной строке терминала:

near contract \
    call-function \
    as-transaction turbo.volodymyr.testnet rate \
    json-args '{"other_user":"volodymyr.testnet", "vote":5}' \
    prepaid-gas '3 Tgas' \
    attached-deposit '1 NEAR' \
    sign-as fro_volod.testnet \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
The "rate" call to <turbo.volodymyr.testnet> on behalf of <fro_volod.testnet> succeeded.
Transaction ID: 7RuoSAdCctSEw63GKsfQJg1YXRzH3msUCo4oygzauPko
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/7RuoSAdCctSEw63GKsfQJg1YXRzH3msUCo4oygzauPko
Демонстрация работы команды в интерактивном режиме

deploy - Add a new contract code

Для добавления нового контракта необходимо ввести в командной строке терминала:

near contract \
    deploy \
    262.volodymyr.testnet \
    use-file /Users/frovolod/Documents/NEAR/rust-counter/contract/target/wasm32-unknown-unknown/release/rust_counter_tutorial.wasm \
    with-init-call increment \
    json-args {} \
    prepaid-gas '1 TGas' \
    attached-deposit '0 NEAR' \
    network-config testnet \
    sign-with-keychain \
    send
Результат выполнения команды 
Transaction sent ...
Successful transaction
Contract code has been successfully deployed.
The "increment" call to <262.volodymyr.testnet> on behalf of <262.volodymyr.testnet> succeeded.
Transaction ID: 4YGGhF88aevNGpF5uaXNGHfQprHRqkia7eTpyxegJVms
To see the transaction in the transaction explorer, please open this url in your browser:
https://explorer.testnet.near.org/transactions/4YGGhF88aevNGpF5uaXNGHfQprHRqkia7eTpyxegJVms
Демонстрация работы команды в интерактивном режиме

download-wasm - Download wasm

Скачать файл контракта возможно на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). Примеры использования этих параметров рассмотрены в разделе View properties for an account.

Для получения файла контракта необходимо ввести в командной строке терминала:

near contract \
    download-wasm 262.volodymyr.testnet \
    to-folder /Users/frovolod/Downloads \
    network-config testnet \
    now
Результат выполнения команды ```txt The file "/Users/frovolod/Downloads/contract_262_volodymyr_testnet.wasm" was downloaded successfully ```
Демонстрация работы команды в интерактивном режиме

view-storage - View contract storage state

Просмотреть значения ключей контракта возможно на текущий момент времени (now) и на определеный момент в прошлом, указав блок (at-block-height или at-block-hash). Примеры использования этих параметров рассмотрены в разделе View properties for an account. Сами же ключи можно просмотреть все (all) или отфильтрованные с помощью keys-start-with-string или keys-start-with-bytes-as-base64.

Для просмотра ключей контракта необходимо ввести в командной строке терминала:

near contract \
    view-storage turbo.volodymyr.testnet \
    all \
    as-json \
    network-config testnet \
    now
Результат выполнения команды ```txt Contract state (values): [ { "key": "MjF2b2xvZHlteXIudGVzdG5ldA==", "value": "JwAAAAAAAAAIAAAAAAAAAA==" }, { "key": "U1RBVEU=", "value": "" }, { "key": "ZnJvX3ZvbG9kLnRlc3RuZXQ=", "value": "HQAAAAAAAAAGAAAAAAAAAA==" }, { "key": "dm9sb2R5bXlyLnRlc3RuZXQ=", "value": "QAEAAAAAAABAAAAAAAAAAA==" } ] Contract state (proof): [] ```
Демонстрация работы команды в интерактивном режиме

transaction - Operate transactions

view-status - View a transaction status

Для просмотра статуса желаемой транзакции необходимо ввести в командной строке терминала её хэш:

near transaction \
    view-status GDoinMecpvnqahzJz9tXLxYycznL4cAoxKTPEnJZ3ank \
    network-config testnet
Результат выполнения команды 
Transaction status: FinalExecutionOutcomeWithReceiptView {
    final_outcome: FinalExecutionOutcome {
        status: SuccessValue(``),
        transaction: SignedTransactionView {
            signer_id: AccountId(
                "volodymyr.testnet",
            ),
            public_key: ed25519:7FmDRADa1v4BcLiiR9MPPdmWQp3Um1iPdAYATvBY1YzS,
            nonce: 165,
            receiver_id: AccountId(
                "qweqweqwe.volodymyr.testnet",
            ),
            actions: [
                CreateAccount,
                Transfer {
                    deposit: 100000000000000000000000000,
                },
                AddKey {
                    public_key: ed25519:AgVv8qjZ7yix3pTo7BimT1zoDYUSTGcg73RBssC5JMRf,
                    access_key: AccessKeyView {
                        nonce: 0,
                        permission: FullAccess,
                    },
                },
            ],
            signature: ed25519:266jBRjvnaxe4mDyHRGwv3TJesvgRo2umJBqkZU26fRwmhVHciu3tBSLqRZFjEuqLTiwDTrFvfxpJ8Sbd2PqHHhv,
            hash: `GDoinMecpvnqahzJz9tXLxYycznL4cAoxKTPEnJZ3ank`,
        },
        transaction_outcome: ExecutionOutcomeWithIdView {
            proof: [],
            block_hash: `AQH6jDqqxpBYj5NSZv3Skg5hUZQRsn16jvDuphCTugSQ`,
            id: `GDoinMecpvnqahzJz9tXLxYycznL4cAoxKTPEnJZ3ank`,
            outcome: ExecutionOutcomeView {
                logs: [],
                receipt_ids: [
                    `5DmuFwQaiSbEDiR7dx6sDurjyDyF92c1tK7gfN7bXqPh`,
                ],
                gas_burnt: 424555062500,
                tokens_burnt: 42455506250000000000,
                executor_id: AccountId(
                    "volodymyr.testnet",
                ),
                status: SuccessReceiptId(5DmuFwQaiSbEDiR7dx6sDurjyDyF92c1tK7gfN7bXqPh),
                metadata: ExecutionMetadataView {
                    version: 1,
                    gas_profile: None,
                },
            },
        },
        receipts_outcome: [
            ExecutionOutcomeWithIdView {
                proof: [],
                block_hash: `DBUpiLVVDBQwSAPU8ZTE8KQnX5skDD1dTsBjJQ8kV24R`,
                id: `5DmuFwQaiSbEDiR7dx6sDurjyDyF92c1tK7gfN7bXqPh`,
                outcome: ExecutionOutcomeView {
                    logs: [],
                    receipt_ids: [
                        `851GMnZZ5FJ2aDSHM34N99yVb1ZkwY8n7F8rUcvuRpUU`,
                    ],
                    gas_burnt: 424555062500,
                    tokens_burnt: 42455506250000000000,
                    executor_id: AccountId(
                        "qweqweqwe.volodymyr.testnet",
                    ),
                    status: SuccessValue(``),
                    metadata: ExecutionMetadataView {
                        version: 1,
                        gas_profile: None,
                    },
                },
            },
            ExecutionOutcomeWithIdView {
                proof: [],
                block_hash: `BSjrH3WyKnXhD17drR94YfM725Ho59us9N4msXrrgHEw`,
                id: `851GMnZZ5FJ2aDSHM34N99yVb1ZkwY8n7F8rUcvuRpUU`,
                outcome: ExecutionOutcomeView {
                    logs: [],
                    receipt_ids: [],
                    gas_burnt: 0,
                    tokens_burnt: 0,
                    executor_id: AccountId(
                        "volodymyr.testnet",
                    ),
                    status: SuccessValue(``),
                    metadata: ExecutionMetadataView {
                        version: 1,
                        gas_profile: None,
                    },
                },
            },
        ],
    },
    receipts: [
        ReceiptView {
            predecessor_id: AccountId(
                "volodymyr.testnet",
            ),
            receiver_id: AccountId(
                "qweqweqwe.volodymyr.testnet",
            ),
            receipt_id: `5DmuFwQaiSbEDiR7dx6sDurjyDyF92c1tK7gfN7bXqPh`,
            receipt: Action {
                signer_id: AccountId(
                    "volodymyr.testnet",
                ),
                signer_public_key: ed25519:7FmDRADa1v4BcLiiR9MPPdmWQp3Um1iPdAYATvBY1YzS,
                gas_price: 103000000,
                output_data_receivers: [],
                input_data_ids: [],
                actions: [
                    CreateAccount,
                    Transfer {
                        deposit: 100000000000000000000000000,
                    },
                    AddKey {
                        public_key: ed25519:AgVv8qjZ7yix3pTo7BimT1zoDYUSTGcg73RBssC5JMRf,
                        access_key: AccessKeyView {
                            nonce: 0,
                            permission: FullAccess,
                        },
                    },
                ],
            },
        },
        ReceiptView {
            predecessor_id: AccountId(
                "system",
            ),
            receiver_id: AccountId(
                "volodymyr.testnet",
            ),
            receipt_id: `851GMnZZ5FJ2aDSHM34N99yVb1ZkwY8n7F8rUcvuRpUU`,
            receipt: Action {
                signer_id: AccountId(
                    "volodymyr.testnet",
                ),
                signer_public_key: ed25519:7FmDRADa1v4BcLiiR9MPPdmWQp3Um1iPdAYATvBY1YzS,
                gas_price: 0,
                output_data_receivers: [],
                input_data_ids: [],
                actions: [
                    Transfer {
                        deposit: 1273665187500000000,
                    },
                ],
            },
        },
    ],
}
Демонстрация работы команды в интерактивном режиме

reconstruct-transaction - Use any existing transaction from the chain to construct NEAR CLI command (helpful tool for re-submitting similar transactions)

Рассмотрим пример, когда необходимо повторить выполненную ранее транзакцию:

near transaction \
    reconstruct-transaction GDoinMecpvnqahzJz9tXLxYycznL4cAoxKTPEnJZ3ank \
    network-config testnet
Результат выполнения команды 
Transaction GDoinMecpvnqahzJz9tXLxYycznL4cAoxKTPEnJZ3ank:

signer_id:    volodymyr.testnet
receiver_id:  qweqweqwe.volodymyr.testnet
actions:
   -- create account:      qweqweqwe.volodymyr.testnet
   -- transfer deposit:    100 NEAR
   -- add access key:     
                   public key:   ed25519:AgVv8qjZ7yix3pTo7BimT1zoDYUSTGcg73RBssC5JMRf
                   nonce:        0
                   permission:   FullAccess

Here is your console command to run archive transaction. You can to edit it or re-run:
near transaction construct-transaction volodymyr.testnet qweqweqwe.volodymyr.testnet add-action create-account add-action transfer '100 NEAR' add-action add-key grant-full-access use-manually-provided-public-key ed25519:AgVv8qjZ7yix3pTo7BimT1zoDYUSTGcg73RBssC5JMRf skip network-config testnet
Демонстрация работы команды в интерактивном режиме

construct-transaction - Construct a new transaction

Рассмотрим пример, когда необходимо выполнить несколько действий в рамках одной транзакции:

  1. Создать аккаунт
  2. Добавить созданному аккаунту ключи доступа
  3. Осуществить перевод токенов на созданный аккаунт

Для этого воспользуемся конструктором транзакции:

Construct a new transaction (демонстрация работы команды)

sign-transaction - Sign previously prepared unsigned transaction

Рассмотрим пример, применив возможность создания транзакции в режиме offline:

  1. Создать транзакцию.
  2. При выборе средств подписи транзакции указать пункт sign-later и следовать дальнейшим инструкциям.
  3. Выведенная на экран транзакция в формате base64 может быть использована здесь для её подписи и/или последующей отправки.
Демонстрация работы команды в интерактивном режиме

send-signed-transaction - Send a signed transaction

Рассмотрим предыдущий пример, применив возможности отправки подписанной транзакции транзакции:

  1. Создать транзакцию.
  2. Подписать транзакцию своими ключами доступа.
  3. Вывести подписанную транзакцию на экран в формате base64.
  4. Отправить транзакцию.
Демонстрация работы команды в интерактивном режиме

send-meta-transaction - Act as a relayer to send a signed delegate action (meta-transaction)

Рассмотрим пример, применив возможности мета-транзакции:

  1. Создать транзакцию.
  2. Указать network с поддержкой мета-транзакции.
  3. Подписать транзакцию своими ключами доступа.
  4. Вывести транзакцию на экран в формате base64 и передать её ретранслятору для отправки.

Отправить делегированную транзакцию:

Демонстрация работы команды в интерактивном режиме

config - Manage connections in a configuration file

show-connections - Show a list of network connections

Для просмотра данных конфигурационного файла (config.toml) можно воспользоваться интерактивным режимом либо ввести в командной строке терминала:

near config show-connections
Результат выполнения команды 
credentials_home_dir = "/Users/frovolod/.near-credentials"
[network_connection.mainnet]
network_name = "mainnet"
rpc_url = "https://archival-rpc.mainnet.near.org/"
wallet_url = "https://wallet.near.org/"
explorer_transaction_url = "https://explorer.near.org/transactions/"
linkdrop_account_id = "near"

[network_connection.testnet]
network_name = "testnet"
rpc_url = "https://archival-rpc.testnet.near.org/"
wallet_url = "https://wallet.testnet.near.org/"
explorer_transaction_url = "https://explorer.testnet.near.org/transactions/"
linkdrop_account_id = "testnet"
faucet_url = "https://helper.nearprotocol.com/account"

[network_connection.pagoda-testnet]
network_name = "testnet"
rpc_url = "https://near-testnet.api.pagoda.co/rpc/v1/"
rpc_api_key = "c0a25b3c-39c2-4f62-a621-50e208b88e64"
wallet_url = "https://wallet.testnet.near.org/"
explorer_transaction_url = "https://explorer.testnet.near.org/transactions/"
linkdrop_account_id = "testnet"
faucet_url = "https://helper.nearprotocol.com/account"
meta_transaction_relayer_url = "https://near-testnet.api.pagoda.co/relay"

add-connection - Add a network connection

Для добавления данных о сети в конфигурационный файл (config.toml) можно воспользоваться интерактивным режимом либо ввести в командной строке терминала:

near config \
    add-connection \
        --network-name testnet \
        --connection-name pagoda-testnet \
        --rpc-url https://near-testnet.api.pagoda.co/rpc/v1/ \
        --wallet-url https://wallet.testnet.near.org/ \
        --explorer-transaction-url https://explorer.testnet.near.org/transactions/ \
        --rpc-api-key 'c0a25b3c-39c2-4f62-a621-50e208b88e64' \
        --linkdrop-account-id testnet \
        --faucet-url https://helper.nearprotocol.com/account \
        --meta-transaction-relayer-url https://near-testnet.api.pagoda.co/relay
Результат выполнения команды 
Configuration data is stored in a file "/Users/frovolod/Library/Application Support/near-cli/config.toml"
Network connection "pagoda-testnet" was successfully added to config.toml
Демонстрация работы команды в интерактивном режиме

delete-connection - Delete a network connection

Для удаления сети из конфигурационного файла (config.toml) можно воспользоваться интерактивным режимом либо ввести в командной строке терминала:

near config delete-connection pagoda-testnet
Результат выполнения команды 
Configuration data is stored in a file "/Users/frovolod/Library/Application Support/near-cli/config.toml"
Network connection "pagoda-testnet" was successfully removed from config.toml