В данном руководстве рассматривается метод приема платежей с примечанием к платежу (сообщением) в экосистеме SmartHoldem. Сервис использует 1 адрес, но для каждого пользователя генерируется уникальная строка.

Для простоты понимания в качестве бэкенда используется язык PHP.

В процессе участвуют: сервис (обменник) и пользователь (клиент).

Клиент

Со стороны клиента некий сервис - обменник, генерирует для клиента исходные данные.

• сумма к получению в меняемой монете (задаваемая клиентом)
• расчетный результат к получению по текущему курсу STH > COIN
• адрес для отправки STH (для всех один)
• уникальная строка сообщения (идентифицирует отправителя)

Здесь на стороне сервиса в backend генерируется уникальная строка для каждого пользователя и сохраняется в базу данных, к примеру таблица вида:
userid(int), msg(string)

<?php
$msg = substr(md5(uniqid(microtime(), 1)) . getmypid(), 1, 8);

// результат уникальная строка:  561559b2

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

Сервис

Теперь в работу вступает backend сервиса, обработчик транзакций. Для простоты понимания будем использовать выполнения скрипта по crontab.

Создаем на стороне сервера php-файл, далее пропишем его на выполнение cron каждую минуту.

<?php
$addr = 'Sg13BhANeairfS3o3w8N9sKaFrsht2bt4V'; //адрес проверки транзакций
$limit  = 25; //лимит выдачи транзакций
$offset = 0; // смещение

//сортируем выдачу транзакций по timestamp с помощью orderBy
$url = 'http://your_node_ip:6100/api/transactions?recipientId='.$addr.'&orderBy=timestamp&offset=0'; 

//получаем данные и преобразуем в массив
$tx = json_decode(file_get_contents($url),true); 

/* 
если транзакций более лимита, 
смещаем offset указатель выдачи транзакций и получаем последние $limit транзакций, 
т.к. транзакций может быть сотни тысяч
*/
if ($tx['count'] > $limit) {
    $offset = $tx['count'] - $limit; // расчет смещения
    $url = 'http://your_node_ip:6100/api/transactions?recipientId=Sg13BhANeairfS3o3w8N9sKaFrsht2bt4V&orderBy=timestamp&offset='.$offset;
    $tx = json_decode(file_get_contents($url),true);
}

// обрабатываем данные
for ($i = 0; $i < count($tx['transactions']); $i++) {
print "<br>amount:".$tx['transactions'][$i]['amount'].
" timestamp:".$tx['transactions'][$i]['timestamp'].
" msg:".$tx['transactions'][$i]['vendorField'].
" senderId:".$tx['transactions'][$i]['senderId'].
" Txid:".$tx['transactions'][$i]['id'];

/*
здесь выполняем необходимые проверки и операции записи в базу данных, 
к примеру добавляем баланс

сохраняем в таблицу транзакций уникальные транзакции, 
которые и проверям при получении, 
к примеру txid, userid, timestamp, sum_sth, sum_coin
*/

/* 
помним, баланс выдается в сатоши, 
не забываем его преобразовать точными функциями
*/
$sumCOIN = bcdiv($tx['transactions'][$i]['amount'],100000000,8); 

$set['btc_sth'] = 1; //курс по отношению к STH
$sumBTC = bcdiv($sumCOIN, $set['btc_sth'], 8); //расчитываем курс монеты

}

Вот и все, транзакция обработана, операция выполнена.

Новые операции
+BTC за STH
1.28 BTC / 0.32000000 STH
03.04.18 09:59

пример не претендует на качество кода, он предназначен для базового понимания приема платежей.

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

P.S. Событийный подход мы рассмотрим в следующих публикациях.

P.P.S. Функция отправки сообщений будет доступна в версии кошелька 1.0 в ближайшие дни/неделю, с сотнями других дополнений и исправлений.