Multi-send: массовые выплаты на множество адресов

От CSV до закрытого запуска

1. Проверьте список до того, как считать котировки

   Каждая строка — адрес, актив, сеть, сумма. Прогоните их через GET /v1/validate-address (вызов без ключа) и отклоняйте файл, а не выплату. known:false означает, что для сети нет шаблона проверки: это «не проверено», а не «верно».

2. Котировка каждой строки

   По одной котировке на получателя, по сумме к получению (amount_to). Сумма возвращённых FromAmount — это стоимость запуска; согласуйте её до того, как что-то создано.

3. Создавайте ордера небольшими партиями

   Пять–десять параллельных созданий — правильный темп: провайдеры троттлят всплески, а каждый ордер нужно успеть создать и оплатить за пять минут жизни предложения. В каждом создании — Idempotency-Key из идентификатора запуска и строки.

4. Оплатите каждый ордер

   У каждого свой DepositAddress и точная сумма AmountFrom. Здесь и живут комиссии сети: сто получателей — сто исходящих переводов с вашего кошелька.

5. Соберите результаты

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

Веерная отправка

import pLimit from "p-limit";
const limit = pLimit(8);                      // провайдеры не любят всплески

const results = await Promise.all(rows.map((row, i) => limit(async () => {
  try {
    const order = await createPayout(runID, row, i);   // котировка → POST /orders
    return { row: i, ok: true, id: order.ID, send: order.AmountFrom,
             to: order.DepositAddress };
  } catch (e) {
    return { row: i, ok: false, error: String(e) };    // одна строка, а не весь запуск
  }
})));

const payable = results.filter((r) => r.ok);
const rejected = results.filter((r) => !r.ok);         // покажите их до оплаты

Перезапускаемым запуск делает именно idempotency-ключ. Стройте его из запуска и строки, но не из часов:

const key = `${runID}:${row.address}:${row.amount}`;  // не меняется при повторах
// POST /v1/partner/orders с заголовком "Idempotency-Key: "
// Повтор вернёт тот же ордер — упавший запуск продолжится, а не задвоится.

Когда строка не проходит

Чем это отличается от ончейн-multisend

Чего нет и что стоит учесть заранее: единого batch-эндпоинта, одной оплачивающей транзакции, вебхуков и фиатного плеча. Запуск — это цикл на вашей стороне; API делает безопасной каждую его итерацию.

Что рассылают веером

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

Вопросы