Перейти к основному содержимому
Версия: Next

Общая информация по работе с messages

Основной таблицей БЧ в логике передачи данных является таблица msgs. В ней хранятся основные события и данные об этих событиях передаваемых через блокчейн. Событие представлено в виде одного сообщения в таблице. С более подробным описанием событий вы можете ознакомится в техническом описании системы в разделе Смарт контракты. Общее описание согласований, необходимых для запуска модели в Cleanroom представлено в разделе Безопасность - Проверка разрешений на запуск скриптов модели

В зависимости от получателя сообщения, обратившись к таблице msgs можно получить:

1) Для широковещательных сообщений - содержание сообщения

2) Для приватных сообщений, в случае если получатель сообщения не ваш инстанс - ошибку

3) Для приватных сообщений, в случае если получатель ваш инстанс - содержание сообщения

Факт получения этих сообщений является критерием успешности этого шага.

Основными скриптами для работы с сообщениями таблицы являются:

  1. search-messages.sh - для поиска сообщений определенного типа с поддерживаемым форматом команд:
     bash ./search-messages.sh $TOPIC $SENDER $RECEIVER $COUNT # TOPIC = [1 ... 7]
    bash ./search-messages.sh $TOPIC $SENDER $RECEIVER # TOPIC = [1 ... 7], $COUNT=1
    bash ./search-messages.sh $TOPIC $SENDER # TOPIC = [1 ... 7], filter with only $SENDER
    Где
    • TOPIC - уровень сообщения согласно описанию уровней в таблице msgs,
    • SENDER - id провайдера,
    • RECEIVER - id партнера,
    • COUNT - количество выводимых в ответе сообщений, по умолчанию 1.
  2. decrypt-message.sh - для расшифровки сообщений, с указанием id сообщения в качестве аргумента для чтения сообщения.

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