При розробці смарт-контрактів важливо також створити клієнта, який може взаємодіяти з ними. Окрім простого витягування даних з блокчейну, клієнти також можуть читати та виконувати функції, визначені доступними примітивами контракту.

Одним з найбільш зручних інструментів для цієї роботи є Sui CLI, оскільки він дозволяє здійснювати дзвінки командного рядка практично з будь-якої мови програмування, яку ви вирішите використовувати для свого клієнта. У цьому посібнику я розповім вам про ключові команди, які ви зазвичай використовуєте під час роботи з Sui.

Початок роботи з Sui CLI

Для початку вам потрібно буде встановити Sui CLI на своїй машині. Процес встановлення залежить від вашої операційної системи та бажаного менеджера пакетів.

Якщо ви використовуєте систему на базі Unix, як-от macOS або Linux, і встановлено Homebrew, просто запустіть наступну команду у вашому терміналі, щоб встановити Sui CLI:

brew install sui

Виконайте цю команду на своєму терміналі, щоб встановити Sui CLI, якщо ви працюєте під керуванням Windows через Chocolatey:

choco install sui

Інший маршрут, який ви можете використовувати, - це маршрут Cargo (менеджер пакетів Rust). Спочатку вам потрібно буде встановити Rust (судна з вантажем), а потім виконати цю команду, щоб встановити Sui CLI.

cargo install --locked --git https://github.com/MystenLabs/sui.git --branch testnet sui --features tracing

Ви завжди можете виконати прапор --version, щоб перевірити установку та перевірити версію Sui CLI, яку ви встановили.

sui --version

Одним із прапорців, які ви будете часто використовувати, є helpпрапор—- для опису кожної команди:

sui --help

Працює практично з кожною командою. Це повинна бути ваша мантія, коли ви застрягли:

Незалежно від команди, використання -h або --help для допомоги завжди буде зручно.

Управління навколишнім середовищем за допомогою Sui CLI

Кожен ланцюжок надає вам три основні мережі: Mainnet, Testnet та Devnet. Ви також можете створити тестовий ланцюжок локально, щоб підтримувати розробку в невидимому режимі.

Ось команда, яку ви виконаєте, щоб створити локальну мережу.

RUST_LOG="off,sui_node=info" sui start --with-faucet --force-regenesis

Команда викликає двійковий файл Sui CLI для запуску служби змішувача та створення нового блоку генезису без збереження стану локальної мережі.

Тепер ви можете підключитися до локальної мережі за допомогою команди new-env так:

sui client new-env --alias local --rpc <rpc-url>
 
# sui client new-env --alias local --rpc http://127.0.0.1:9000

Ви можете перемикати та активувати будь-яке середовище за допомогою цієї загальної команди.

sui client switch --env <ENV_NAME>

Тепер ви можете скористатися цією командою, щоб встановити активне середовище на нове локальне середовище, яке ви створили.

sui client switch --env local

Команда перемикає поточне активне середовище на локальну мережу, яку ви запустили.

Адреса та управління ключами за допомогою Sui CLI

Ви будете перемикати ключі під час розгортання смарт-контрактів через Sui CLI, тому ось як це зробити.

Ви можете переглянути поточний активний адресу за допомогою active-addressкоманди:

sui client active-address

Ви можете перерахувати всі адреси у вашому клієнті за допомогою addressesкоманди.

sui client addresses

Ви можете перемикати адреси як завгодно за допомогою --addressпрапорця, перш ніж вказувати адресу.

Управління ключами за допомогою Sui CLI

Під час створення програм з метою безпеки або інших причин вам може знадобитися запускати команди CLI для роботи з ключами. Команда keytool

Ви можете перерахувати всі ключі у сховищі ключів за допомогою команди list так:

sui keytool list

Ви можете генерувати ключі за допомогою generateкоманди, за якою слідує специфікація схеми.

sui keytool generate [OPTIONS] <KEY_SCHEME> [DERIVATION_PATH] [WORD_LENGTH]

Ви, напевно, знайомі з ed25519, оскільки саме це використовує більшість гаманців. Вкажіть його так.

sui keytool generate ed25519

Ви повинні отримати вихід з адресою Sui, мнемонікою та іншими деталями.

sui keytool import "<MNEMONIC_PHRASE>" ed25519

Імпортувавши його, ви можете перейти на пару ключів і розпочати надсилання транзакцій з нею.