Установка и использование платформы
REST API: подписание и валидация сообщений в блокчейне¶
Для подписания и валидации сообщений предусмотрены следующие методы группы 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'}