Flow CLI (Dapper Labs)

Что такое Flow CLI?

Flow CLI — официальный интерфейс командной строки для разработки приложений и взаимодействия с блокчейном Flow.

CLI — это сокращение от command-line interface, то есть интерфейса командной строки. Разработчики управляют этим инструментом, вводя текстовые команды в терминале, а не нажимая кнопки в графическом приложении.

Flow CLI позволяет создавать блокчейн-проекты, запускать локальную сеть Flow, тестировать код Cadence, развертывать смарт-контракты, отправлять транзакции, выполнять скрипты, управлять аккаунтами, генерировать ключи, устанавливать зависимости контрактов и получать данные из блокчейна.

Инструмент обеспечивает общий рабочий процесс разработки для локального Flow Emulator, Flow Testnet и Flow Mainnet.

Flow CLI предназначен главным образом для разработчиков смарт-контрактов, команд децентрализованных приложений, инженеров инфраструктуры, тестировщиков и других технических специалистов, создающих продукты на Flow.

Flow CLI — это не криптовалюта, криптокошелек, узел блокчейна, потребительское приложение или торговый продукт.

Это программное обеспечение для разработчиков, которое взаимодействует с Flow Access Nodes и локальными сервисами разработки.

В официальной документации Flow CLI он описан как инструмент для управления проектами, аккаунтами, контрактами, транзакциями, зависимостями и запросами к блокчейну из единого интерфейса.

Как Flow CLI связан с Dapper Labs?

Flow изначально проектировала и разрабатывала компания Dapper Labs, поэтому пользователи иногда ищут Flow CLI по запросу «Flow CLI Dapper Labs».

Dapper Labs создала Flow для поддержки блокчейн-приложений, рассчитанных на широкую аудиторию, без необходимости конкурировать за одни и те же ограниченные вычислительные ресурсы для каждого приложения.

В официальной истории Flow и Cadence Dapper Labs указана как первоначальный разработчик и создатель блокчейна.

Сейчас Flow CLI распространяется как программное обеспечение с открытым исходным кодом организацией Onflow и входит в более широкую экосистему разработчиков Flow.

Официальный репозиторий исходного кода инструмента открыт и распространяется по лицензии Apache 2.0.

Таким образом, Flow CLI следует рассматривать как официальный инструмент для работы с сетью Flow, а не как закрытое потребительское приложение, которым управляет только Dapper Labs.

Какая версия Flow CLI является последней?

По состоянию на 14 июля 2026 года последняя опубликованная версия Flow CLI — 2.17.4.

Версия 2.17.4 выпущена 4 июня 2026 года и обновила инструмент до Cadence версии 1.10.3.

В выпуске также обновлены включенные в пакет компоненты основных контрактов Flow до версий, совместимых с Cadence 1.10.3.

Разработчики могут проверить актуальную версию на официальной странице релизов Flow CLI.

Информация о версиях может часто меняться, поскольку CLI необходимо поддерживать совместимость с новыми версиями Cadence, обновлениями эмулятора, основными контрактами, функциями сети и исправлениями безопасности.

Установленную локально версию можно проверить, выполнив в терминале команду

.

Командам, работающим с производственными системами, следует использовать проверенную и зафиксированную версию CLI в автоматизированных системах сборки, а не менять ее автоматически при каждом развертывании.

Почему Flow CLI важен?

Разработка блокчейн-приложения не ограничивается написанием файла смарт-контракта.

Разработчику также необходимо создавать аккаунты, управлять ключами, определять адреса контрактов, отправлять подписанные транзакции, проверять результаты, тестировать сценарии ошибок и развертывать код в нужной сети.

Flow CLI объединяет эти задачи в одном последовательном инструменте.

Он позволяет реже вручную формировать необработанные запросы к Flow Access Nodes для стандартных операций разработки.

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

Команду, сохраненную в скрипте развертывания, можно проверить и одинаково выполнять в нескольких средах разработки.

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

Как установить Flow CLI

Flow CLI можно установить на macOS, Windows и большинство систем Linux.

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

Для macOS часто используется команда установки

.

Установку через Homebrew обычно можно обновить командой

.

Для поддерживаемых сред Linux, macOS и Windows также доступны официальные установочные скрипты.

Перед запуском установочного скрипта с повышенными системными привилегиями разработчику следует ознакомиться с его содержимым.

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

После установки разработчику следует выполнить команды

и , чтобы убедиться, что программа работает и доступна через системный путь.

Как начать работу над проектом Flow

Основная команда для создания проекта Flow —

.

Эта команда создает структуру проекта и основной файл конфигурации

.

Актуальные версии Flow CLI могут предлагать шаблоны проектов для разных типов приложений, в том числе базовых проектов Cadence и специализированных блокчейн-сценариев.

Шаблон может включать каталоги для смарт-контрактов, транзакций, скриптов, тестов и конфигурации проекта.

В официальном руководстве по созданию проекта объясняется, как команда

создает файлы, необходимые для новой среды разработки.

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

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

Что такое flow.json?

— это основной файл конфигурации Flow CLI.

В нем описаны сети, аккаунты, контракты, зависимости, цели развертывания и пути проекта, которые должен использовать CLI.

Доступные разделы и форматы описаны в официальном справочнике по конфигурации flow.json.

В разделе

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

В разделе

читаемые имена аккаунтов связываются с адресами Flow и настройками ключей для подписания.

В разделе

имена контрактов Cadence связываются с исходными файлами и адресами для конкретных сетей.

В разделе

указываются контракты, которые необходимо развернуть в определенных аккаунтах в каждой сети.

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

Так разработчикам не приходится прописывать адрес контракта одной сети непосредственно в каждом исходном файле.

Командам следует проверять изменения в

с помощью системы контроля версий: измененный адрес развертывания или псевдоним аккаунта может привести к отправке транзакции не в ту среду.

Хранятся ли приватные ключи в flow.json?

Flow CLI поддерживает конфигурации с информацией о приватных ключах, однако хранить незашифрованный производственный ключ непосредственно в общем файле

опасно.

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

Если файл конфигурации загрузить в общедоступный репозиторий, злоумышленник может получить контроль над контрактами, токенами и административными возможностями.

В актуальных версиях Flow CLI поддерживаются прямое указание ключей в шестнадцатеричном формате, внешние файлы ключей, деривация на основе мнемонической фразы и интеграция с Google Cloud KMS.

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

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

Разработчикам также следует разделять ключи для эмулятора, тестовой и основной сетей.

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

С какими сетями может работать Flow CLI?

Flow CLI может взаимодействовать с локальным Flow Emulator, Flow Testnet, Flow Mainnet и пользовательскими конечными точками Flow Access Node.

Эмулятор предназначен для локальной разработки.

Testnet — это публичная среда для тестирования приложений без использования производственных активов Flow.

Mainnet — это производственный блокчейн, где транзакции могут влиять на реальные аккаунты, развернутые контракты и криптоактивы.

Во многих командах используется параметр

, задающий целевую среду.

Например, разработчик может указать

, или .

Если не указать или не проверить сеть, контракт или транзакция могут быть отправлены не туда, куда планировал разработчик.

В производственных скриптах следует явно указывать выбранную сеть и предусматривать дополнительные проверки перед использованием подписантов основной сети.

Что такое Flow Emulator?

Flow Emulator — это облегченная локальная сеть, которая воспроизводит важные функции блокчейна Flow для разработки и тестирования.

Он входит в состав Flow CLI и запускается командой

.

В официальной документации Flow Emulator он описывается как локальная среда для выполнения транзакций, развертывания контрактов и тестирования приложений до использования публичной сети.

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

В эмулятор входит сервисный аккаунт, который может создавать аккаунты, подписывать транзакции и развертывать контракты в локальной среде.

Его приватный ключ не подходит для основной сети, поскольку он намеренно общедоступен и предсказуем.

Эмулятор почти полностью соответствует функциям Flow Access API, однако разработчикам не следует считать, что любой производственный сценарий можно безошибочно воспроизвести на одном компьютере.

Задержки публичной сети, поведение валидаторов, перегрузка сети, внешние сервисы и настройки производственных аккаунтов могут приводить к другим результатам.

Как устроен локальный рабочий процесс разработки?

Обычный рабочий процесс с Flow CLI начинается с создания проекта командой

.

Затем разработчик запускает локальный блокчейн командой

.

В проект добавляются контракты Cadence, которые указываются в

.

Разработчик развертывает контракты в аккаунтах эмулятора и выполняет тестовые транзакции или скрипты.

Автоматизированные тесты можно запустить командой

.

После успешного прохождения локальных тестов проект можно развернуть в тестовой сети и проверить в общей публичной среде.

Развертывать проект в основной сети следует только после проверки кода, конфигурации аккаунтов, разрешений подписантов, зависимостей и плана развертывания.

Как Flow CLI развертывает смарт-контракты?

Flow CLI может развертывать смарт-контракты Cadence в аккаунтах, указанных в конфигурации проекта.

Команда развертывания проекта —

.

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

.

При развертывании разработчик может указать нужную сеть.

Например, команда

развертывает заданные контракты проекта в локальной среде.

При выборе testnet или mainnet CLI использует соответствующие аккаунты, псевдонимы и настройки Access Node.

Развертывание смарт-контракта — это блокчейн-транзакция, поэтому для него требуется авторизация аккаунта с соответствующими разрешениями на ключи.

Развертывание может завершиться с ошибкой из-за недействительного кода Cadence, неразрешенных импортов, недостаточных прав аккаунта, неверного ключа для подписи или проблем с подключением к сети.

Развертывание в основной сети может иметь необратимые последствия, поэтому перед подписанием разработчикам следует проверить исходный код контракта и адрес аккаунта.

Может ли Flow CLI обновить существующий контракт?

Flow CLI может отправлять транзакции обновления контрактов, уже размещенных в аккаунте Flow.

Обновление должно быть авторизовано ключом с достаточным весом в аккаунте, которому принадлежит контракт.

Обновления контрактов Cadence подчиняются правилам языка и сети, защищающим сохраненные ресурсы и состояние существующих приложений.

Даже технически корректное обновление может содержать ошибки, нарушить работу зависимых приложений или изменить ожидаемое поведение.

Перед обновлением производственного контракта разработчикам следует провести тестирование миграции и проверить совместимость с существующими данными аккаунта.

В официальном руководстве по развертыванию контрактов Flow рассматриваются настройка аккаунта, развертывание и обновление контрактов.

Что такое Cadence?

Cadence — это язык программирования смарт-контрактов, разработанный для блокчейна Flow.

В нем применяются концепции ресурсно-ориентированного программирования для представления криптоактивов и других значений, которые нельзя случайно скопировать или потерять.

Flow CLI включает инструменты для выполнения, тестирования, проверки, развертывания кода Cadence и взаимодействия с ним.

Версии CLI и Cadence должны оставаться совместимыми, поскольку изменения языка могут повлиять на разбор кода, проверку типов, выполнение и поведение контрактов.

В Flow CLI версии 2.17.4 используется Cadence версии 1.10.3.

Узнать о текущем поведении языка можно в официальной документации Cadence.

Чем скрипт Cadence отличается от транзакции?

Скрипт Cadence считывает состояние блокчейна, не изменяя его окончательно.

Скрипт может получить баланс аккаунта, прочитать общедоступное поле контракта, выполнить расчет или проверить сохраненные публичные возможности.

Скриптам не требуется авторизация транзакций, поскольку они не могут изменять состояние блокчейна.

Транзакция Cadence может изменить состояние блокчейна.

Транзакции могут переводить криптоактивы, создавать ресурсы, вызывать функции контрактов, изменять хранилище аккаунта и выполнять другие авторизованные действия.

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

Flow CLI предоставляет отдельные группы команд для выполнения скриптов и отправки транзакций.

Это различие важно, поскольку отправка транзакции связана с рисками авторизации, комиссий и изменения состояния, которые не возникают таким же образом при запуске скрипта только для чтения.

Как Flow CLI отправляет транзакции?

Flow CLI может формировать, подписывать, отправлять транзакции Flow и получать их результаты.

В команде транзакции указываются файл транзакции Cadence, аргументы, настройки подписанта и целевая сеть.

Для создания необходимых подписей CLI использует данные аккаунта из

или параметры командной строки.

После отправки транзакция Flow проходит несколько статусов, прежде чем получить окончательный статус sealed.

После отправки транзакция может завершиться ошибкой, если при выполнении кода Cadence возникнет проблема.

Разработчику следует изучить результат транзакции, сгенерированные события и сообщения об ошибках, а не считать сам факт отправки доказательством успешного выполнения.

Синтаксис команд и доступные флаги указаны в официальном обзоре команд Flow CLI.

Как Flow CLI управляет аккаунтами?

В аккаунтах Flow могут находиться криптоактивы, смарт-контракты, сохраненные ресурсы, публичные возможности и один или несколько публичных ключей.

Flow CLI позволяет создавать аккаунты, получать сведения о них, проверять ключи, добавлять и отзывать ключи, а также развертывать контракты в аккаунтах, для которых есть разрешение.

В модели аккаунтов Flow адрес аккаунта не привязан к одному конкретному публичному ключу.

В аккаунте может быть несколько ключей с разным весом, алгоритмами подписи и хеширования и номерами последовательности.

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

В официальной документации по аккаунтам Flow объясняется, чем они отличаются от моделей адресов, в которых один ключ навсегда определяет один адрес.

Отзыв скомпрометированного ключа может защитить аккаунт только в том случае, если другие действующие ключи по-прежнему обеспечивают достаточный вес авторизации.

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

Как Flow CLI работает с криптографическими ключами?

Flow CLI содержит команды для генерации и декодирования ключей, совместимых с Flow.

В нем также есть команды для создания и проверки цифровых подписей.

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

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

История командной строки также может раскрыть секреты, если приватные ключи указываются непосредственно в качестве аргументов команд.

В производственных системах следует отдавать предпочтение специальным файлам ключей с ограниченными правами доступа, аппаратному хранилищу или поддерживаемому сервису управления ключами.

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

Что такое менеджер зависимостей Flow CLI?

Менеджер зависимостей Flow CLI устанавливает и отслеживает внешние контракты Cadence, используемые в проекте.

Смарт-контракты часто зависят от стандартов, интерфейсов и реализаций, развернутых в других местах сети Flow.

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

Команда

отображает зависимости, зарегистрированные в проекте.

Команда

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

В официальной документации по управлению зависимостями объясняется, как устанавливать, проверять и контролировать зависимости контрактов.

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

Вредоносная или неправильно определенная зависимость может привнести в децентрализованное приложение несанкционированное поведение.

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

Как Flow CLI тестирует смарт-контракты Cadence?

Flow CLI включает Cadence Testing Framework и запускает тестовые файлы командой

.

Тесты могут проверять смарт-контракты, скрипты, транзакции, сгенерированные события, изменения аккаунтов и ожидаемые ошибки.

В основе тестовой среды Cadence используется Flow Emulator.

Благодаря этому тесты могут создавать аккаунты, развертывать контракты, отправлять транзакции и проверять состояние, не затрагивая публичный блокчейн.

В официальном руководстве по тестированию Cadence описаны модульное и интеграционное тестирование.

Интеграционные тесты особенно полезны для выявления проблем с настройкой аккаунтов, авторизацией транзакций, импортами, возможностями и перемещением ресурсов.

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

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

Что такое тестирование форков в Flow CLI?

Тестирование форков создает локальную среду разработки, которая считывает состояние Flow Mainnet или Testnet, выполняя изменения локально.

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

Запустить форк на основе основной сети можно, например, командой

.

В официальном руководстве Flow по тестированию форков объясняется, как локальный эмулятор копирует состояние другой сети Flow.

Тестирование форков полезно, если приложение зависит от контрактов или данных аккаунтов, которые трудно воспроизвести вручную.

Оно также помогает выявить проблемы совместимости до обновления производственного контракта.

Форк-среда не является созданием постоянного форка блокчейна Flow.

Это закрытая тестовая копия, транзакции в которой не изменяют mainnet или testnet.

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

Что такое линтинг в Flow CLI?

Линтинг анализирует исходный код на предмет возможных ошибок, небезопасных шаблонов, проблем форматирования и других недочетов без развертывания контракта.

Для проектов Cadence в Flow CLI предусмотрена команда

.

Линтинг помогает выявлять некоторые проблемы на ранних этапах разработки, а также может быть добавлен в автоматизированные проверки.

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

Успешный результат линтинга не доказывает правильность бизнес-логики, контроля доступа, экономических стимулов или управления ресурсами.

Линтинг следует сочетать с тестированием, проверкой кода и мониторингом производственной среды.

Как Flow CLI запрашивает данные блокчейна?

Flow CLI может получать данные об аккаунтах, блоках, коллекциях, событиях, транзакциях, результатах их выполнения и другую информацию, доступную через Flow Access API.

Команда

позволяет получить блок по идентификатору, высоте или запросить последний доступный блок.

Команда

возвращает информацию об аккаунте Flow.

Команды для событий позволяют получать события, созданные в выбранном диапазоне блоков.

С помощью команд для транзакций можно проверять статус и результат отправленной транзакции.

Эти возможности полезны для разработки, отладки, мониторинга и простых исследований блокчейна.

CLI не является полноценным индексатором исторических данных, поскольку Access Nodes и специализированные сервисы индексирования могут предоставлять разные возможности для запросов.

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

Что такое шаблоны взаимодействия Flow?

Шаблоны взаимодействия Flow предоставляют стандартизированные описания транзакций и скриптов Cadence.

Их также называют шаблонами FLIX.

В шаблоне могут быть описаны код взаимодействия, аргументы, зависимости и метаданные, необходимые кошелькам или приложениям для понимания операции.

В Flow CLI есть команды FLIX для выполнения, создания и упаковки поддерживаемых взаимодействий.

Шаблоны могут повысить согласованность взаимодействия разработчиков приложений, кошельков и смарт-контрактов.

Перед подписанием пользователям все равно следует проверять код и аргументы транзакции, поскольку шаблон не устраняет риски смарт-контракта или кошелька.

Что такое команды для запланированных транзакций?

В актуальных версиях Flow CLI есть команды для работы с запланированными транзакциями Flow.

Запланированные транзакции позволяют смарт-контрактам организовывать автономное выполнение в будущем в соответствии с правилами планирования сети.

Возможные варианты применения в криптовалютной сфере включают повторяющиеся переводы, отложенные действия контрактов, автоматизированную финансовую логику и работу приложений по расписанию.

Команда

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

Дополнительные команды позволяют просматривать список и сведения о поддерживаемых запланированных транзакциях, а также отменять их.

В официальной документации по запланированным транзакциям описаны требования к настройке, приоритеты и работа команд.

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

Что такое Flowser?

Flowser — это визуальный обозреватель, который можно использовать с локальной средой Flow Emulator.

В Flow CLI предусмотрена команда для запуска Flowser, если необходимые компоненты доступны.

Интерфейс позволяет разработчикам изучать локальные аккаунты, контракты, блоки, транзакции и события, не запрашивая каждый элемент вручную.

Flowser дополняет командную строку, но не заменяет автоматизированное тестирование или проверку исходного кода.

Результаты, отображаемые в локальном обозревателе, относятся к текущему состоянию эмулятора и не должны восприниматься как активность в основной сети.

Что такое Flow Dev Wallet?

Flow Dev Wallet — это инструмент разработки для тестирования авторизации кошелька и взаимодействия приложений.

Для поддерживаемых локальных сценариев Flow CLI может запускать среду кошелька для разработчиков.

Разработчик может использовать ее для имитации входа, авторизации аккаунта, подтверждения транзакций и других функций кошелька при создании децентрализованного приложения.

Dev Wallet не предназначен для защиты ценных производственных активов.

В производственных приложениях необходимо интегрировать подходящие пользовательские кошельки и соблюдать правила безопасной аутентификации и проверки транзакций.

Поддерживает ли Flow CLI Flow EVM?

Flow поддерживает как смарт-контракты Cadence, так и среду Ethereum Virtual Machine, однако Flow CLI — это прежде всего официальный инструмент командной строки для работы с Cadence и моделью разработки через Flow Access API.

Для Solidity-приложений на Flow EVM обычно используются совместимые с EVM инструменты JSON-RPC и EVM Gateway.

В официальной документации Flow EVM Gateway объясняется, что клиенты EVM подключаются через шлюз, реализующий спецификацию Ethereum JSON-RPC.

Приложения Cadence также могут взаимодействовать с Flow EVM посредством Cadence Owned Accounts и сетевых контрактов.

Разработчику следует выбирать инструменты в зависимости от того, написано ли приложение на Cadence, Solidity или объединяет обе среды выполнения.

Использование названия Flow CLI не означает, что все операции, специфичные для EVM, выполняются с помощью одного и того же набора команд.

Flow CLI и Flow SDK

Flow CLI — это интерактивный инструмент командной строки, который можно использовать в скриптах.

Flow SDK — это программная библиотека, подключаемая к коду приложения.

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

SDK лучше подходит для серверных служб, серверов приложений, ботов, кошельков, индексаторов и другого программного обеспечения, которому необходимо взаимодействовать с Flow во время работы.

Команда разработчиков может использовать Flow CLI для развертывания контракта, а затем взаимодействовать с ним из приложения с помощью SDK для JavaScript, Go или мобильной платформы.

Эти категории инструментов дополняют друг друга, а не являются прямыми заменами.

Flow CLI и графическая среда разработки

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

Команды Flow CLI проще автоматизировать, сохранять в скриптах и повторно выполнять в рамках непрерывной интеграции.

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

Многие разработчики используют оба подхода: редактируют Cadence в интегрированной среде разработки, а команды Flow CLI запускают во встроенном терминале.

Официальное расширение Cadence может обеспечивать подсветку синтаксиса и помогать разработке, а Flow CLI — выполнять код и развертывание.

Можно ли использовать Flow CLI в непрерывной интеграции?

Команды Flow CLI можно включать в процессы непрерывной интеграции и непрерывного развертывания.

В конвейере можно установить зафиксированную версию CLI, проверить файлы Cadence линтером, запустить тесты, инициализировать эмулятор, развернуть тестовые контракты и проверить ожидаемые транзакции.

Для автоматизированного развертывания в основной сети нужны гораздо более строгие меры контроля, чем для автоматизированного тестирования.

Приватные ключи следует хранить в защищенной системе управления секретами, а не непосредственно в файле конвейера.

Для производственного развертывания могут потребоваться ручное подтверждение, подписанные артефакты релиза, защищенные ветки и несколько проверяющих.

Конвейер должен завершаться ошибкой, если тесты, проверки линтером, проверка развертывания или результаты транзакций не соответствуют ожиданиям.

Командам также следует фиксировать версии Flow CLI и Cadence, использованные для каждого выпуска.

Собирает ли Flow CLI данные об использовании?

В настоящее время Flow CLI по умолчанию собирает сводные данные о количестве запусков команд через Mixpanel.

Согласно официальной документации, система сбора статистики не собирает значения аргументов команд и флагов.

Сбор метрик можно отключить командой

.

Повторно включить метрики можно командой

.

На официальной странице о сборе данных Flow CLI объясняется, какие данные собираются и как изменить настройки.

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

Рекомендации по безопасности Flow CLI

Разработчикам следует устанавливать Flow CLI только по официальной документации или из проверенных файлов релиза.

Перед подписанием или развертыванием любой транзакции необходимо проверить выбранную сеть.

Приватные ключи основной сети не следует хранить в открытом виде в общедоступных файлах проекта.

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

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

Импорты контрактов и адреса зависимостей необходимо проверять отдельно для каждой сети.

Перед отправкой транзакции следует проверить роли подписантов, аргументы, лимиты газа и целевые контракты.

Разработчикам следует изучать окончательный результат транзакции со статусом sealed, а не считать отправленную транзакцию успешно выполненной.

Перед обновлением CLI в производственных процессах новые версии следует протестировать.

Старые или неиспользуемые ключи аккаунтов следует отзывать, если уже существует безопасный способ авторизации с помощью нового ключа.

Нельзя вводить сид-фразы и приватные ключи на сайтах, утверждающих, что они нужны для активации Flow CLI.

Распространенные ошибки Flow CLI

Ошибка подключения может означать, что эмулятор не запущен, адрес Access Node указан неправильно, выбранный порт недоступен или невозможно подключиться к сетевому сервису.

Ошибка авторизации может быть вызвана неправильным приватным ключом, индексом ключа, номером последовательности, алгоритмом подписи, алгоритмом хеширования или адресом аккаунта.

Ошибка импорта может возникнуть, если псевдоним контракта Cadence отсутствует или указывает на неверный адрес в сети.

Ошибка развертывания может быть вызвана недействительным кодом Cadence, несовместимой версией языка, отсутствующими зависимостями или недостаточной авторизацией аккаунта.

Транзакция может завершиться ошибкой, если аргумент имеет неправильный тип Cadence или аккаунту не хватает необходимого ресурса или возможности.

Ошибка номера последовательности может возникнуть, если несколько транзакций почти одновременно пытаются использовать один ключ инициатора.

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

, прежде чем менять другие настройки проекта.

Распространенные варианты использования Flow CLI

Flow CLI можно использовать для создания и настройки проекта Cadence.

С его помощью можно запускать локальный блокчейн для разработки смарт-контрактов.

Он позволяет создавать аккаунты и управлять их ключами.

С его помощью можно развертывать и обновлять контракты Cadence.

Он позволяет запускать скрипты только для чтения и подписанные транзакции.

С его помощью можно устанавливать зависимости контрактов и управлять псевдонимами сетей.

Он позволяет запускать модульные и интеграционные тесты, проверки линтером и тесты форков на основе состояния основной сети.

С его помощью можно получать данные о блоках, транзакциях, аккаунтах, коллекциях и событиях.

Flow CLI можно использовать в автоматизированных конвейерах сборки и развертывания.

Он также помогает разработчикам воспроизводить операции в блокчейне при расследовании ошибок приложений.

Ограничения Flow CLI

Flow CLI не обеспечивает безопасность смарт-контракта автоматически.

Он не может помешать разработчику подписать опасную транзакцию или развернуть код не в том аккаунте.

CLI не заменяет профессиональный аудит, моделирование угроз, проектирование системы контроля доступа и операционный мониторинг.

Локальный эмулятор не способен в точности воспроизвести все условия публичной сети.

CLI также не является полноценным интерфейсом кошелька для обычных пользователей.

Он не предоставляет полную базу исторических данных для анализа каждой транзакции Flow.

Разработчикам необходимо разбираться в Cadence, аккаунтах Flow, ролях транзакций, возможностях, хранении ресурсов, зависимостях и безопасности сетей.

Часто задаваемые вопросы

Что означает Flow CLI?

Flow CLI — это Flow Command-Line Interface, официальный инструмент разработки для работы с блокчейном Flow через терминал.

Flow CLI создан компанией Dapper Labs?

Изначально Flow проектировала и разрабатывала Dapper Labs, а сейчас Flow CLI поддерживается как официальное программное обеспечение экосистемы Flow с открытым исходным кодом организацией Onflow.

Является ли Flow CLI криптовалютным кошельком?

Нет, Flow CLI — инструмент для разработчиков, хотя он может использовать настроенные приватные ключи для подписания транзакций и управления аккаунтами Flow.

Какая версия Flow CLI является последней?

По состоянию на 14 июля 2026 года последняя официальная версия Flow CLI — 2.17.4.

Какая версия Cadence входит в Flow CLI 2.17.4?

В Flow CLI версии 2.17.4 входит Cadence версии 1.10.3.

Как установить Flow CLI на macOS?

Один из распространенных способов — выполнить команду

с помощью Homebrew.

Как проверить версию Flow CLI?

Выполните в терминале команду

.

Как создать новый проект Flow?

Выполните команду

и выберите подходящий шаблон проекта.

Что такое flow.json?

— основной файл конфигурации проекта, в котором задаются сети, аккаунты, контракты, зависимости и цели развертывания.

Как запустить Flow Emulator?

Выполните в терминале команду

.

Использует ли Flow Emulator реальные FLOW?

Нет. Локальный эмулятор использует состояние разработки и активы, не имеющие стоимости в основной сети.

Может ли Flow CLI развертывать контракты в основной сети?

Да. Flow CLI может развертывать контракты в Flow Mainnet, если указаны правильные сеть, аккаунт, ключ и конфигурация развертывания.

Какая команда развертывает проект Flow?

Стандартная команда развертывания проекта —

; обычно ее используют с явно указанным параметром сети.

Может ли Flow CLI обновлять смарт-контракты?

Да, он может отправлять авторизованные транзакции обновления контрактов с учетом правил Cadence и сети Flow.

Как запустить тесты Cadence?

Выполните команду

в настроенном проекте Flow.

Что такое тестирование форков Flow?

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

Поддерживает ли Flow CLI создание аккаунтов?

Да. Flow CLI позволяет создавать аккаунты Flow, получать сведения о них и управлять их ключами.

Может ли Flow CLI считывать данные блокчейна?

Да. Он может получать блоки, данные аккаунтов и транзакций, события, коллекции и другую информацию, доступную через Flow Access Nodes.

Чем скрипт Flow отличается от транзакции?

Скрипт считывает состояние, не изменяя блокчейн, а подписанная транзакция может изменить его состояние.

Может ли Flow CLI управлять зависимостями контрактов?

Да. Менеджер зависимостей позволяет устанавливать, просматривать и отслеживать внешние контракты Cadence, используемые проектом.

Собирает ли Flow CLI телеметрию?

В настоящее время Flow CLI по умолчанию собирает сводные данные о количестве запусков команд. Эту функцию можно отключить командой

.

Следует ли хранить приватные ключи в flow.json?

Производственные приватные ключи не следует хранить в незашифрованном виде в общем или общедоступном файле

.

Можно ли использовать Flow CLI для автоматизированного развертывания?

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

Работает ли Flow CLI с Flow Testnet?

Да, тестовая сеть входит в число стандартных сред, поддерживаемых конфигурацией сетей Flow CLI.

Используется ли Flow CLI для разработки на Solidity?

Flow CLI предназначен главным образом для работы с Cadence и Flow Access API, а для Solidity-приложений на Flow EVM обычно применяются совместимые с EVM инструменты JSON-RPC.

Является ли Flow CLI программным обеспечением с открытым исходным кодом?

Да, исходный код Flow CLI общедоступен и распространяется по лицензии Apache 2.0.

Может ли использование Flow CLI привести к потере криптовалюты?

Да. Ошибки в ключах, сетях, адресах, коде контрактов или аргументах транзакции могут привести к необратимым потерям в основной сети.

Заключение

Flow CLI — официальный инструмент командной строки для разработки и взаимодействия с приложениями на блокчейне Flow.

Связь инструмента с Dapper Labs объясняется тем, что эта компания изначально спроектировала и разработала Flow. Сейчас CLI распространяется как программное обеспечение экосистемы Flow с открытым исходным кодом.

Инструмент объединяет создание проекта, работу с эмулятором, тестирование Cadence, управление аккаунтами и ключами, развертывание контрактов, управление зависимостями, отправку транзакций и запросы к блокчейну.

Система конфигурации

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

Flow CLI помогает сделать разработку блокчейн-приложений более воспроизводимой, но не устраняет риски, связанные с ненадежным хранением ключей, ошибочными контрактами, неправильной целевой сетью, вредоносными зависимостями или необратимыми транзакциями.

Разработчикам следует использовать официальные релизы, защищать учетные данные для подписи, тестировать код в нескольких средах, проверять результаты транзакций и применять строгие процедуры контроля перед развертыванием в Flow Mainnet.