Сервис BcAPI (Blockchain API)

Сервис BcAPI предоставляет возможность различным сервисам взаимодействовать с блокчейн сетью c2g основанной на hyperledger fabric. BcAPI может только вызывать методы смарт-контрактов. BcAPI является авторизационным и трансферным шлюзом и никак не валидирует данные, передаваемые в блокчейн. Идентификация и авторизация пользователя происходит на основе данных основной платформы С2G. Общение с BcAPI происходит с помощью протокола websocket. BcAPI использует строгий порядок обмена сообщениями, сопровождающимися кодами состояний.

Список кодов:

1. auth – стадия авторизации и аутентификации
2. query — запрос на получение данных из блокчейна
3. invoke — запись данных в блокчейн
4. proposal — данные транзакции которые нужно подписать клиенту
5. signature — подписаны данные
6. payload – транзакция, требующая подпись
7. result – результат выполнения транзакции
8. error – ошибка

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

• NewBcAPI(serverHost string, certPem, privKeyPem []byte) *BcAPI – создает клиент, который будет общаться с BcAPI.
• (b *BcAPI) SendTx(TxCode, orgID string, contract *Contract, function string, args ...string) – отправляет сообщение в BcAPI.
• TxCode может принимать 2 значения: query или invoke. Query используется если надо запросить данные, а invoke – если надо записать данные
• Contract – это структура, хранящая айди организации, канала и самого приложения. Ниже приведена структура этого типа.

type Contract struct {
    ChannelID string
    AppID string
    OrgID string
}

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