ПРОВЕРКА АДРЕСА

Проверка адреса депозита

Продавец отправляет USDT на адрес, который показывает платформа. До активации контракта по этому адресу ничего нет: адрес вычисляется из условий сделки, и создать по нему можно только эскроу ровно с этими условиями. Это можно проверить до депозита по блокчейну, не доверяя нам.

Какие данные нужны

ЧтоОткуда
Адрес депозитаСтраница сделки (адрес эскроу).
Упакованные условия: шесть 32-байтных слов, 0x hexСтраница сделки. Условия ровно в том виде, в каком их принимают контракты.
Хеш условийСтраница сделки: keccak256 от шести слов, соль CREATE2.
Суммы и срокиСтраница сделки: депозит, комиссия, комиссия за возврат, срок внесения, окно оплаты (суммы в единицах с 6 знаками).
Фабрика, реализация, хеш init codeТаблица ниже. Они фиксированы: фабрика принимает свою реализацию один раз, обновить её нельзя.
Арбитр и получатель комиссииСами условия (шаг 3).

Развёртывание контрактов

Контракты этого окружения, как их отдаёт API.

Загрузка…

В условиях нет секретов

sellerKey и buyerKey — это 20-байтные адреса ключей, а не сами ключи. При активации все условия и так публикуются в блокчейне (событие Initialized и данные каждого вызова эскроу).

Как проверить в Tronscan

1. Фабрика использует ожидаемую реализацию

Откройте фабрику в Tronscan → Contract → Read Contract. Значения implementation() и initCodeHash() должны совпадать с таблицей выше.

2. Адрес депозита принадлежит этим условиям

На той же странице вызовите predictAddress(t), передав шесть слов условий как t (JSON-массив: ["0x…","0x…",…]). Результат должен совпасть с адресом депозита на странице сделки. Tronscan показывает его как адрес T… или как 20 байт в hex; офлайн-скрипт переводит одно в другое.

3. Условия соответствуют договорённости

Откройте реализацию (TradeEscrow) → Read Contract → unpack(t) с теми же шестью словами. Функция вернёт условия в читаемом виде:

ПолеПроверка
buyerPayoutАдрес выплаты покупателя на странице сделки.
sellerRefundАдрес возврата продавца на странице сделки.
sellerKey, buyerKeyВаш — это адрес ключа подписи, выбранного для сделки (страница ключей).
amountСумма депозита.
feeКомиссия за сделку; покупатель получает amount − fee.
refundFeeBps, refundFeeFixed0 и комиссия за возврат (удерживается, только если депозит неполный, контракт активирован с опозданием или арбитр вернул деньги продавцу с комиссией).
payWindowОкно оплаты в секундах.
fundingDeadlineСрок внесения депозита, в секундах Unix.
excessMinПри завершении сделки излишек депозита не меньше этой суммы возвращается на sellerRefund, меньший уходит на feeReceiver вместе с комиссией.
arbiterАрбитр платформы для этой сделки. Единственное, что он может: завершить сделку в статусе Paid или Disputed — либо на buyerPayout (с fee или без), либо на sellerRefund (с refundFeeFixed или без).
feeReceiverКуда уходят комиссии: не больше fee (вместе с излишком меньше excessMin), если деньги получил покупатель, и не больше refundFeeFixed при возврате продавцу с комиссией. Никогда больше.

У контракта нет функции, которая принимает адрес назначения или сумму: что бы ни случилось, деньги могут попасть только на buyerPayout, sellerRefund или — не больше согласованной комиссии (и излишка меньше excessMin) — на feeReceiver.

Некоторые экраны показывают адреса как 20 байт в hex; скрипт ниже переводит их.

Если хоть одна проверка не прошла: не отправляйте депозит и напишите в поддержку. Контакты →

Без Tronscan: офлайн

Шаги 2 и 3 вообще без узла сети. Нужен Node.js и npm install ethers@6. Сохраните скрипт как verify.mjs, впишите четыре значения и запустите node verify.mjs.

import { concat, dataSlice, decodeBase58, encodeBase58, keccak256, sha256, toBeHex } from "ethers";

// From the trade (GET /trades/{id}, the `terms` object):
const packedTerms = ["0x…", "0x…", "0x…", "0x…", "0x…", "0x…"];
const shownAddress = "T…";
// From the contracts table:
const factory = "T…";
const initCodeHash = "0x…";

// T-address <-> 20 bytes: Base58Check of 0x41 ++ address ++ 4-byte checksum.
const hex20 = (t) => dataSlice(toBeHex(decodeBase58(t), 25), 1, 21);
const toBase58 = (h20) => {
  const payload = concat(["0x41", h20]);
  return encodeBase58(concat([payload, dataSlice(sha256(sha256(payload)), 0, 4)]));
};

// The deposit address: TRON CREATE2 (0x41 where Ethereum uses 0xff).
const salt = keccak256(concat(packedTerms)); // = terms.terms_hash
const escrow = toBase58(dataSlice(keccak256(concat(["0x41", hex20(factory), salt, initCodeHash])), 12));
console.log("terms hash:", salt);
console.log("computed  :", escrow);
console.log(escrow === shownAddress ? "MATCH" : "MISMATCH: do not deposit");

// What the terms say (same layout as TradeEscrow.unpack).
const w = packedTerms.map(BigInt);
const bits = (x, shift, n) => (x >> BigInt(shift)) & ((1n << BigInt(n)) - 1n);
const key = (x) => toBeHex(bits(x, 0, 160), 20);
console.log({
  tradeId: toBeHex(bits(w[3], 160, 96), 12),
  sellerKey: key(w[0]),
  buyerKey: key(w[1]),
  buyerPayout: toBase58(key(w[2])),
  sellerRefund: toBase58(key(w[3])),
  arbiter: toBase58(key(w[4])),
  feeReceiver: toBase58(key(w[5])),
  amount: bits(w[0], 160, 64).toString(),
  fee: bits(w[1], 160, 64).toString(),
  refundFeeFixed: bits(w[2], 160, 64).toString(),
  refundFeeBps: Number(bits(w[2], 224, 16)),
  payWindowSec: Number(bits(w[0], 224, 32)),
  fundingDeadline: new Date(Number(bits(w[1], 224, 32)) * 1000).toISOString(),
  // At release an overpayment of at least this goes back to the seller, a smaller one to
  // the fee receiver with the fee.
  excessMin: bits(w[4], 160, 64).toString(),
});

Пример: реальная сделка в mainnet

Лабораторная сделка M1, эскроу TYZeQT7E8QKWgftia8obaWyeCHdTB2abCu в mainnet. На ней можно попробовать шаги и скрипт (с фабрикой и хешем init code для mainnet).

[
 "0x00000e1000000000009896806d780282fc9d0668e4f3b97d01e87024010bc062",
 "0x6ad09f2800000000003e8fa045cea6936004e48b591a7071338f505fc49ee3f3",
 "0x0000006400000000003d0900907f09e8dae3d6239cc2a322299ee6085589b8b9",
 "0x7619b0a72a694a457271066d253f1b66232937fb4450f687709308c2bcd7768a",
 "0x000000000000000000000000c198c33919888ccaf95745c071e8b4de1961c713",
 "0x000000000000000000000000c198c33919888ccaf95745c071e8b4de1961c713"
]

Ожидается: хеш условий 0xe48e8e222792b893c63dd13df530471e04b715ffb176bea7e7d8117e8b1248fb; скрипт, predictAddress фабрики и бэкенд дают TYZeQT7E8QKWgftia8obaWyeCHdTB2abCu; unpack даёт адрес выплаты TP9EVVC1hJvFdv5Gdsdsz4muaCATEKKdEp, адрес возврата TDN9buiyr23Bd6JhpMXct63KS7oxhWhCZx, amount 10 USDT, fee 4,10 USDT. (Эта сделка старше фиксированной комиссии за возврат, поэтому refundFeeBps равно 100.)