Фінансування ніг угоди

Фінансування — це звичайний TransferChecked в ескроу ноги, тому будь-який гаманець або система зберігання, що може надіслати переказ токена, може профінансувати ногу. Клієнт DvP потрібен лише для читання запису угоди перед фінансуванням. Програма перевіряє баланси ескроу лише під час розрахунку; ніщо не перевіряє переказ у момент його надходження, тому кожна сторона читає запис угоди перед переказом.

Ця сторінка є продовженням розділу створення угоди; клієнт і підписанти переносяться.

Перевірте умови

Створення запису не потребує дозволів, а адреси ескроу виводяться лише із запису та mint, але ніколи не з умов. Тому переказ в ескроу може потрапити під умови, з якими ви ніколи не погоджувалися, зокрема під адреси призначення розрахунку, що перенаправляють виручку вашого контрагента на третю адресу. Перед фінансуванням прочитайте акаунт SwapDvp і звірте його з погодженою угодою.

verifySwapDvp у TypeScript і verify::decode_swap_dvp_account у Rust підтверджують, що акаунт належить програмі DvP, має рівно 458 байтів і знаходиться за адресою, яка виводиться з його власних полів (fetchSwapDvpChecked виконує лише перші дві перевірки). Звичайні зчитувачі fetchSwapDvp і decodeSwapDvp не виконують жодної з цих перевірок. Перевірки сторін, сум, часу та призначень виконує той, хто викликає, звіряючи їх із погодженою угодою.

import { unwrapOption } from "@solana/kit";
import { verifySwapDvp } from "./dvp";
const trade = await verifySwapDvp(client.rpc, swapDvp);
const t = trade.data;
const expectedAmountA = 1_000_000_000n;
const expectedAmountB = 998_500_000n;
const expectedEarliestSettlement: bigint | null = null; // as agreed
const expectedExpiry = 1_798_761_600n; // as agreed, unix seconds
if (
t.userA !== userA ||
t.userB !== userB ||
t.mintA !== mintA ||
t.mintB !== mintB ||
t.settlementAuthority !== settlementAuthority ||
t.tokenProgramA !== tokenProgramA ||
t.tokenProgramB !== tokenProgramB ||
t.amountA !== expectedAmountA ||
t.amountB !== expectedAmountB ||
unwrapOption(t.earliestSettlementTimestamp) !== expectedEarliestSettlement ||
t.expiryTimestamp !== expectedExpiry ||
t.userASettlementDestination !== userA ||
t.userBSettlementDestination !== userB
) {
throw new Error("Stored terms do not match the agreed trade; do not fund");
}
if (t.expiryTimestamp <= BigInt(Math.floor(Date.now() / 1000)) + 60n) {
throw new Error("Trade expires too soon to fund safely");
}

Якщо запис створив ваш контрагент або розрахунковий орган, звірте кожне поле з умовами, які ви погодили поза реєстром. Якщо ви створили його самі, це читання підтверджує, що запис потрапив у мережу в надісланому вигляді.

Переказ в ескроу

Профінансуйте ногу рівно на погоджену суму. Програма обмежує розрахунок значенням amount_x і повертає будь-який надлишок стороні ноги, тож надлишок не втрачається, але він додає другий переказ під час розрахунку і може спричинити збій з деякими хуками переказу (див. примітки нижче).

Використовуйте TransferChecked, а не неперевірений Transfer. Mint-и Token-2022 із розширеннями, що залежать від mint account, як-от Pausable, відхиляють переказ, який його не надає, а mint із хуком переказу потребує, щоб акаунти хука були визначені й додані так само, як і для будь-якого іншого переказу цього токена.

Сторона ноги з активом, підписуючи як userASigner, фінансує ескроу A:

import {
findAssociatedTokenPda,
getTransferCheckedInstruction,
} from "@solana-program/token-2022";
const [userAAtaA] = await findAssociatedTokenPda({
mint: mintA,
owner: userA,
tokenProgram: tokenProgramA,
});
const [userBAtaB] = await findAssociatedTokenPda({
mint: mintB,
owner: userB,
tokenProgram: tokenProgramB,
});
const fundAssetLeg = getTransferCheckedInstruction({
source: userAAtaA,
mint: mintA,
destination: escrowA,
authority: userASigner,
amount: t.amountA,
decimals: 6,
}, { programAddress: tokenProgramA });
await client.sendTransaction([fundAssetLeg]);

Сторона грошової ноги робить те саме для ескроу B з userBAtaB, mintB, userBSigner, t.amountB і { programAddress: tokenProgramB }.

Переказ фінансування, побачений зі статусом confirmed, ще може бути скасований. Програма зчитує баланс ескроу ончейн під час розрахунку, тому Settle, надісланий після переказу фінансування, який не потрапив у мережу, завершується помилкою LegNotFunded, і нічого не переміщується; ціна цього — невдалий Settle і повторна спроба. Вважайте ногу профінансованою, коли її переказ має статус finalized.

Примітки

  • Ноги з wrapped SOL. Програма зчитує баланс нативного ескроу після його синхронізації, тож lamports, надіслані в ескроу wrapped SOL системним переказом, враховуються. Ніколи не надсилайте SOL в ескроу для будь-якого іншого mint: програма не може його повернути, і він дістанеться тому, хто закриє акаунт.
  • Mint-и з обмеженим доступом. Для mint зі станом акаунта за замовчуванням Default Account State frozen ескроу створюється замороженим, і переказ завершується помилкою, доки емітент не розморозить його або не допустить. Огляд описує взаємодію з Token ACL.
  • Хуки переказу. Фінансуйте ескроу з хуками рівно на погоджену суму. Якщо надлишок змушує повернути кошти під час розрахунку, повернення повторно використовує акаунти хука ноги з іншим призначенням і сумою, що деякі хуки відхиляють. Відновлення: Reclaim, повторне фінансування на точну суму та новий розрахунок.
  • Фінансування після завершення строку. Ніщо не зупиняє переказ після expiry_timestamp. Він потрапляє в мережу, розрахунок уже неможливий, і сторона ноги повертає кошти через Reclaim, поки угода відкрита, або через Recover після її закриття. Див. згортання угоди.
  • Хто фінансує першим. Програма не задає черговість двох ног. Порядок — справа сторін; кожна сторона може повернути власну ногу в будь-який момент до розрахунку, якщо тільки орган mint (заморожування, пауза або хук переказу) не блокує ескроу.

Наступні кроки

Is this page helpful?

Зміст

Редагувати сторінку