Запускайте валидаторы, RPC-ноды и свои приложения с ERPC CLI

ERPC CLI — единая командная строка для RPC-нод в 18 блокчейнах, валидаторов в 13, ваших собственных приложений и вашего аккаунта ERPC. ERPC AI запускает его за вас, когда вы об этом просите.
Эта страница описывает ERPC CLI v0.1.0-rc.4 — пререлиз (Статус).
bash
curl -fsSL https://install.erpc.global | sh

Что можно делать с ERPC CLI

  • Запускать валидаторы и RPC-ноды. erpc rpc запускает RPC-ноды во всех 18 блокчейнах, а erpc validator — валидаторы в 13 из них, с одними и теми же подкомандами в каждом блокчейне. Их команды жизненного цикла бесплатны и не требуют аккаунта.
  • Запускать своё приложение на сервере. erpc worker компилирует ваше приложение в нативный бинарный файл Linux и запускает его на ERPC VPS или на вашем собственном сервере под усиленным юнитом systemd — без Docker и без промежуточной среды выполнения.
  • Не хранить ключи приложения на диске сервера. Его торговый ключ и секреты попадают из 1Password, вашей связки ключей или зашифрованного keystore erpc прямо в память воркера. Нет ни wallet.json, ни .env.
  • Спрашивать ERPC AI. erpc ai отвечает на основе документации ERPC и данных вашего аккаунта. С вашего одобрения он может запустить почасовой VPS, установить ваш SSH-ключ, отключить вход по паролю и разрешить SSH только с вашего адреса.
  • Вызывать RPC и получать вебхуки. erpc rpc call обращается к mainnet Solana или Ethereum от имени аккаунта, в который выполнен вход, или оплачивает каждый вызов через x402. erpc webhook отправляет события RPC POST-запросами на ваш URL.
  • Хранить файлы и делать резервные копии. erpc storage и erpc backup хранят ваши файлы в ERPC Global Storage, причём файлы шифруются на вашей машине ещё до того, как покинут её.

Установка

В macOS и Linux:
bash
curl -fsSL https://install.erpc.global | sh
В Windows, в PowerShell:
powershell
irm https://install.erpc.global/ps1 | iex
Эти URL выбирают последний стабильный релиз. Пока у проекта есть только пререлизы, они выбирают последний опубликованный пререлиз. Чтобы зафиксировать версию, используйте https://install.erpc.global/v0.1.0-rc.4 или https://install.erpc.global/v0.1.0-rc.4/ps1 в Windows. Кэши на edge и у клиентов могут задержать то, что клиенты видят после релиза.
Установщик помещает erpc в ~/.erpc/bin и записывает навыки ERPC AI в ~/.erpc/skills. Сборки публикуются для Linux (x86_64, arm64), macOS (Intel, Apple silicon) и Windows (x86_64).

Установка для валидатора в mainnet

Установщик выше ничего не проверяет. Путь с повышенными гарантиями проверяет подписанный манифест релиза до того, как что-либо запустится, и сегодня это единственный путь, который хоть что-то проверяет, поэтому операторам валидаторов в mainnet следует использовать его. Каждый релиз поставляется с подписанным release-manifest.json (minisign), CycloneDX SBOM и аттестациями происхождения сборки GitHub. Шаги описаны в разделе Проверка релиза.

Сборка из исходного кода

bash
git clone https://github.com/elsoul/erpc-cli
cd erpc-cli
cargo build --release
./target/release/erpc --help

Начать можно бесплатно

Команды жизненного цикла валидаторов и RPC-нод бесплатны и не требуют аккаунта. Аккаунт на dashboard.erpc.global открывает доступ к остальному:
КомандаБез аккаунтаС аккаунтом
Жизненный цикл валидаторов и RPC-нодДаДа
erpc aiДа
erpc workerДа
erpc storage, erpc backupДа
bash
erpc signup     # opens the sign-up page
erpc login      # signs this machine in; the session goes to the keychain or 1Password
erpc whoami
На странице Вход и ключи описано, где хранятся сессия и ваши ключи.

Как ERPC CLI хранит ваши ключи

ERPC CLI использует 1Password для реестра нод и управляемых резервных копий ключей подписи, а для учётных данных операторов поддерживает связку ключей операционной системы. API-токены и RPC-ключи указываются в erpc.toml по ссылке и никогда не по значению, а сами значения попадают на сервер через стандартный ввод и никогда не через командную строку.
Реестр нод тоже хранится в 1Password. Предоставьте общий доступ к сейфу — и каждый в вашей команде будет управлять одними и теми же нодами со своей машины. Что остаётся на сервере ноды, зависит от блокчейна: таблица — на странице Вход и ключи.

Статус

ERPC CLI находится на стадии пререлиза, версия v0.1.0-rc.4. Его команды существуют и проходят офлайн-проверки. Приёмочная проверка на реальных хостах ещё продолжается: как обстоят дела с каждым блокчейном, описано в разделе Состояние каждого блокчейна и в руководстве по соответствующему блокчейну.
Исправления безопасности получает только последний релиз, и до сих пор все релизы были пререлизами. Сообщайте об уязвимостях конфиденциально через GitHub private vulnerability reporting, а не в публичном issue.
ERPC CLI — преемник SLV, написанный на Rust. Его исходный код находится в elsoul/erpc-cli под лицензией Apache-2.0.

Подробнее об ERPC CLI

  • Вход и ключи: войдите, выберите, где хранится сессия, и посмотрите, где находится каждый ключ.
  • erpc ai: спрашивайте ERPC AI в терминале и выбирайте, что ему разрешено делать.
  • RPC и вебхуки: обращайтесь к mainnet Solana или Ethereum, оплачивайте каждый вызов через x402 и отправляйте события на свой URL.
  • Быстрый старт erpc worker: создайте HelloWorld, запустите его здесь и разверните на сервере.
  • Импорт приложения: разверните уже существующее приложение, не меняя его код.
  • Ключи и секреты: храните торговый ключ и секреты приложения в 1Password, связке ключей или keystore.
  • Брандмауэр и WAF: закройте доступ к серверу и поставьте WAF перед публичным API.
  • Статус и оплата: следите за приложением, смотрите его почасовую стоимость и делайте резервную копию его состояния.
  • Если произошёл сбой: сообщения об ошибках и что с ними делать, а также как восстановить сервер.
  • Ноды: запускайте валидаторы и RPC-ноды и находите руководство по каждому блокчейну.
  • Команды: все группы команд, глобальные опции, коды завершения, хранилище и резервные копии.