LibreMoney
2. Основная часть
2.8. API (RestAPI)
Системные функции для работы с произвольными сообщениями
Send Message
Создает транзакцию с исходящим произвольным сообщением.
Запрос
http://localhost:1400/api/sendMessage? secretPhrase=SECRET& recipient=RECIP_ACCOUNT& fee=FEE& message=HEX_STRING& deadline=DEADLINE& referencedTransaction=REFTXID& broadcast=BROAD
Где:
- SECRET секретная фраза аккаунта, который отправляет сообщение
- RECIP_ACCOUNT номер аккаунта, которому отправляется сообщение (получателя)
- HEX_STRING сообщение в hex кодировке. Механизмы шифрования сообщения не предусмотрены, оставлено для разработчиков. Длинна сообщения ограниченна 1000 байтами.
- FEE комиссия (в MilliLm) за транзакцию
- DEADLINE дедлайн транзакции, указывается в минутах
- REFTXID ID предыдущей транзакции на которую вы ссылаетесь. Это создает зависимые транзакции (цепочка транзакций), означая, что текущая транзакция не может быть подтверждена, пока транзакция на которую вы ссылаетесь, не будет подтверждена. (опционально)
- BROAD если вы хотите чтобы транзакция широковещательно передавалась или нет (опционально)
Ответ
{ "fullHash": "FULLHASH", "signatureHash": "SIGHASH", "transactionBytes": "TXBYTES", "hash": "HASH", "transaction": "TX", "broadcasted": BROAD, "unsignedTransactionBytes": "UNTXBYTES" }
Где:
- FULLHASH полный хэш транзакции
- SIGHASH sha256 хэш подписи транзакции. Используется для транзакций условного депонирования
- TXBYTES байткод транзакции
- HASH хэш всех полей транзакции, за исключение подписи
- TX ID транзакции
- BROAD указывает была транзакция передана или нет
- UNTXBYTES байты транзакции c подписью, частично замененной нулями
Пример
Запрос:
http://localhost:1400/api/sendMessage? secretPhrase=MySuperSecretPasswordThatYouDoNotKnow& recipient=501860284368& message= 6602b1611f921092bdf2a89fc97148ec9684066776b83fd3& deadline=720& referencedTransaction=8815617645011985536
Ответ:
{ "fullHash": "d56ade2c322083d76ebcdb9f9ef18d7d52c6d105f67be040cc423c7a41a47aea", "signatureHash": "458514e72f4272c789f99201c27cff611460de10fe484b474166c1199c23e754", "transactionBytes": "0100471ddb00a005668683e673274c671802492d6f54cdc33d247aa426e7cef...", "hash": "36a0dc90736d95ad5302f078d5db6fc48e5c087b76da65944f7fe2836b73abcd", "transaction": "15529291339976829653", "broadcasted": true, "unsignedTransactionBytes": "0100471ddb00a005668683e673274c671802492d6f54cdc33d247aa4..." }