# 🔑 @coopenomics/cleos

Обёртка над утилитой `cleos` из набора инструментов EOSIO. Запускает Docker-контейнер с предустановленным кошельком для прямого взаимодействия с блокчейном — отправки транзакций, просмотра таблиц контрактов, управления ключами и аккаунтами.

## Основные возможности

- Готовая среда с кошельком и ключами для локальной разработки
- Отправка транзакций в блокчейн
- Просмотр таблиц смарт-контрактов
- Управление аккаунтами и ключами блокчейна
- Разблокировка и сброс кошелька через вспомогательные скрипты

## Установка

Компонент является частью монорепозитория. Установка зависимостей из корня проекта:

```bash
pnpm install
```

## Скрипты

| Скрипт | Команда | Описание |
|--------|---------|----------|
| `run` | `pnpm run run` | Запуск Docker-контейнера с кошельком |

Из корня монорепозитория можно использовать:

```bash
pnpm run enter
```

## Использование

Для работы необходима запущенная инфраструктура (см. `docker-compose.yaml` в корне проекта).

### Запуск

```bash
pnpm run enter
```

### Внутри контейнера

```bash
./unlock.sh              # Разблокировка кошелька
./cleos.sh get info      # Информация о блокчейне
./cleos.sh get table <contract> <scope> <table>  # Просмотр таблиц
```

### Вспомогательные скрипты

| Скрипт | Назначение |
|--------|-----------|
| `unlock.sh` | Разблокировка кошелька (пароль применяется автоматически) |
| `cleos.sh` | Прокси-вызов `cleos` с настроенным подключением к ноде |
| `reset.sh` | Сброс состояния кошелька |

## Конфигурация

Кошелёк использует дефолтный ключ для локальной среды разработки. Пароль хранится в файле `password` внутри директории `eosio-wallet` и применяется автоматически при разблокировке.

## Архитектура

```
├── run.sh                # Скрипт запуска Docker-контейнера
├── eosio-wallet/         # Хранилище кошелька
│   └── password          # Пароль для разблокировки
└── scripts/              # Вспомогательные скрипты
    ├── unlock.sh         # Разблокировка кошелька
    ├── cleos.sh          # Прокси-вызов cleos
    └── reset.sh          # Сброс кошелька
```

## Лицензия

[BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.ru)