Установка и использование платформы

REST API: подписание и валидация сообщений в блокчейне

https://img.shields.io/badge/auth-required-orange.svg

Для подписания и валидации сообщений предусмотрены следующие методы группы addresses:

POST /addresses/sign/{address}

Метод подписывает строку, переданную в поле message, приватным ключом адресата {address}, а затем сериализует ее в формат base58.

Важно

Метод addresses/sign недоступен при использовании PKI, то есть когда в конфигурационном файле ноды параметру node.crypto.pki.mode присвоено значение ON. В тестовом режиме PKI (node.crypto.pki.mode = TEST) или при отключенном PKI (node.crypto.pki.mode = OFF) метод можно использовать.

В ответе метода возвращается сериализованная строка, публичный ключ и подпись адресата.

Примеры запроса и ответа:

POST /addresses/verify/{address}

Проверка подписи сообщения, выполненной адресатом {address}.

Примеры запроса и ответа:

POST /addresses/signText/{address}

Метод подписывает строку, переданную в поле message, приватным ключом адресата {address}. В отличие от метода POST /addresses/sign/{address}, строка передается в исходном формате.

Важно

Метод addresses/signText недоступен при использовании PKI, то есть когда в конфигурационном файле ноды параметру node.crypto.pki.mode присвоено значение ON. В тестовом режиме PKI (node.crypto.pki.mode = TEST) или при отключенном PKI (node.crypto.pki.mode = OFF) метод можно использовать.

Примеры запроса и ответа:

POST /addresses/verifyText/{address}

Проверка подписи сообщения, выполненной адресатом {address} посредством метода POST /addresses/signText/{address}.

Примеры запроса и ответа:

Поля message, publicKey, signature в запросе являются обязательными. Если значение в одном из полей невалидно, метод возвращает ошибку с указанием на это поле, например:

{'error': 108, 'message': 'invalid public key: I82TisHAE2vuEQuNQkGSdLau'}