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

Рекомендуемый способ

Чаще всего удобнее, чтобы keosd запускал автоматически cleos. Файлы кошельков создаются в каталоге по умолчанию (~/eosio-wallet).

Ручной запуск keosd

keosd можно запустить вручную в терминале:

keosd

По умолчанию keosd создаёт папку ~/eosio-wallet и базовый файл config.ini. Расположение конфигурации задаётся аргументом --config-dir. В конфигурации задаётся HTTP-endpoint для входящих соединений и прочие параметры CORS.

Расположение кошелька

Каталог данных кошелька задаётся опцией --data-dir.

Автоблокировка

По умолчанию keosd блокирует кошелёк после 15 минут неактивности. В config.ini это настраивается секундами в unlock-timeout. В исходной документации указано, что значение 0 приводит к тому, что кошелёк всегда остаётся заблокированным; уточните поведение для вашей версии по выводу keosd --help.

Остановка keosd

Надёжный способ — найти процесс keosd и отправить ему сигнал SIGTERM.

Прочие опции

Список опций keosd — запуск без аргументов:

keosd --help

Параметры приложения:

Опции конфигурации eosio::http_plugin:
  --unix-socket-path arg (=keosd.sock)  Имя файла (относительно data-dir) для
                                        Unix-сокета HTTP RPC; пустое значение —
                                        отключить.
  --http-server-address arg             Локальный IP и порт для входящих HTTP;
                                        пустое значение — отключить.
  --access-control-allow-origin arg     Значение Access-Control-Allow-Origin в
                                        ответе на каждый запрос.
  --access-control-allow-headers arg    Значение Access-Control-Allow-Headers в
                                        ответе на каждый запрос.
  --access-control-max-age arg          Значение Access-Control-Max-Age в ответе
                                        на каждый запрос.
  --access-control-allow-credentials    Возвращать ли Access-Control-Allow-Credent
                                        ials: true в ответе на каждый запрос.
  --max-body-size arg (=1048576)        Максимальный размер тела входящих RPC-
                                        запросов в байтах.
  --http-max-bytes-in-flight-mb arg (=500)
                                        Лимит памяти (МБ) http_plugin на обработку
                                        HTTP-запросов; при превышении — ответ 503.
  --verbose-http-errors                 Добавлять запись об ошибке в тело HTTP-
                                        ответа.
  --http-validate-host arg (=1)         Если false, заголовок Host входящих
                                        запросов считается допустимым всегда.
  --http-alias arg                      Дополнительные допустимые значения Host
                                        для входящих HTTP-запросов; можно задать
                                        несколько раз. По умолчанию включает
                                        http/s_server_address.
  --http-threads arg (=2)               Число рабочих потоков в пуле HTTP.

Опции конфигурации eosio::wallet_plugin:
  --wallet-dir arg (=".")               Каталог файлов кошельков (абсолютный путь
                                        или относительно каталога данных
                                        приложения).
  --unlock-timeout arg (=900)           Таймаут разблокировки кошелька в секундах
                                        (по умолчанию 900, т.е. 15 минут). Кошелёк
                                        снова блокируется после указанного числа
                                        секунд бездействия. Активность — любая
                                        команда кошелька, например list-wallets.

Параметры конфигурации приложения:
  --plugin arg                          Включаемые плагины; можно указать
                                        несколько раз.

Параметры командной строки приложения:
  -h [ --help ]                         Вывести справку и выйти.
  -v [ --version ]                      Вывести версию.
  --print-default-config                Вывести шаблон конфигурации по умолчанию.
  -d [ --data-dir ] arg                 Каталог рабочих данных программы.
  --config-dir arg                      Каталог с файлами конфигурации
                                        (например config.ini).
  -c [ --config ] arg (=config.ini)     Имя файла конфигурации относительно
                                        config-dir.
  -l [ --logconf ] arg (=logging.json)  Файл или путь конфигурации логирования
                                        для пользователей библиотеки.