Крипто-payroll для подрядчиков и распределённых команд

Расчётный период по шагам

1. Реестр

   На каждого: сумма на руки, актив выплаты, сеть, адрес. Проверяйте адрес через GET /v1/validate-address при добавлении и ещё раз перед расчётом — опечатка, найденная в день выплаты, дорого стоит.

2. Котировка каждой строки по сумме на руки

   from_asset — актив вашего казначейства, to_asset — актив сотрудника, amount_to — то, что ему причитается. Предложение отвечает суммой FromAmount, то есть стоимостью расчёта, ещё до того, как сдвинулась хоть одна монета.

3. Ордер на каждого

   client_order_id — ваша пара период + сотрудник, и Idempotency-Key строится из неё же. Перезапуск наполовину выполненного расчёта вернёт уже созданные ордера как есть, а не удвоит их.

4. Оплата выплат

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

5. Закрытие расчёта

   Опрашивайте ордера до финального статуса. DONE даёт AmountToReceived и TxID для расчётного листка; всё остальное — строка на повтор с новой котировкой.

Цикл расчёта

const BASE = "https://api.swapzilla.io";
const head = { "X-API-Key": process.env.SWAPZILLA_KEY, "Content-Type": "application/json" };

async function payout(run, person) {
  const q = new URLSearchParams({
    from_asset: "USDT", from_network: "TRC20",
    to_asset: person.asset, to_network: person.network,
    amount_to: String(person.net), rate_type: "fixed",
  });
  const { offers } = await fetch(`${BASE}/v1/partner/quotes?${q}`, { headers: head })
    .then((r) => r.json());
  if (!offers?.length) throw new Error(`нет предложения для ${person.id}`);

  const order = await fetch(`${BASE}/v1/partner/orders`, {
    method: "POST",
    headers: { ...head, "Idempotency-Key": `${run}:${person.id}` },  // тот же ключ при повторе
    body: JSON.stringify({
      offer_id: offers[0].ID,
      to_address: person.address,
      refund_address: process.env.TREASURY_ADDRESS,                 // неудачи возвращаются домой
      client_order_id: `${run}:${person.id}`,
      expected_to_amount: person.net,
    }),
  }).then((r) => r.json());

  return order;      // DepositAddress + AmountFrom — то, что отправляет казначейство
}

// Пяти параллельных строк достаточно: провайдеры троттлят всплески, а расчёт
// зарплаты — не гонка. Оборачивайте каждую строку, чтобы один сбой был одним
// несостоявшимся расчётным листком, а не сорванным расчётом целиком.

Учёт по расчёту

Честные ограничения

Кто так платит

• Студии и агентства с удалёнными подрядчиками в десятке стран, где каждый предпочитает свой актив и свою сеть.
• Продуктовые команды, платящие в стейблкоинах из одного казначейского актива, без кошелька под каждую сеть.
• DAO и опенсорс-фонды, где каждая выплата должна прослеживаться до конкретного TxID.
• Все, кто перерос таблицу и горячий кошелёк, но не хочет отдавать фонд оплаты труда кастодиану.

Вопросы