Zasilanie nóg transakcji

Zasilenie to zwykły TransferChecked na escrow nogi, więc każdy portfel lub system powierniczy, który potrafi wysłać transfer tokena, może zasilić nogę. Klient DvP jest potrzebny wyłącznie do odczytu rekordu transakcji przed zasileniem. Program sprawdza salda escrow tylko podczas rozliczenia; nic nie weryfikuje transferu w chwili jego zaksięgowania, dlatego każda ze stron odczytuje rekord transakcji przed wykonaniem transferu.

Ta strona jest kontynuacją części tworzenie transakcji; klient i podpisujący zostają bez zmian.

Zweryfikuj warunki

Utworzenie rekordu nie wymaga uprawnień, a adresy escrow wynikają wyłącznie z rekordu i mint, nigdy z warunków. Transfer na escrow może więc trafić do transakcji o warunkach, których nigdy nie zaakceptowałeś, w tym o miejscach docelowych rozliczenia, które przekierowują środki Twojego kontrahenta na trzeci adres. Przed zasileniem odczytaj konto SwapDvp i porównaj je z uzgodnioną transakcją.

verifySwapDvp w TypeScript oraz verify::decode_swap_dvp_account w Rust potwierdzają, że konto należy do programu DvP, ma dokładnie 458 bajtów i znajduje się pod adresem wynikającym z jego własnych pól (fetchSwapDvpChecked wykonuje tylko dwie pierwsze kontrole). Zwykłe czytniki fetchSwapDvp i decodeSwapDvp nie wykonują żadnej z nich. Kontrole stron, kwot, terminów i miejsc docelowych wykonuje wywołujący, porównując je z uzgodnioną transakcją.

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");
}

Jeśli rekord utworzył Twój kontrahent lub organ rozliczający, porównaj każde pole z warunkami uzgodnionymi poza rejestrem. Jeśli utworzyłeś go samodzielnie, ten odczyt potwierdza, że został zapisany tak, jak został wysłany.

Transfer na escrow

Zasil nogę dokładnie uzgodnioną kwotą. Program ogranicza rozliczenie do amount_x i zwraca ewentualną nadwyżkę stronie nogi, więc nadwyżka nie przepada, ale dodaje drugi transfer podczas rozliczenia i może zakończyć się niepowodzeniem w przypadku niektórych transfer hooków (zob. uwagi poniżej).

Używaj TransferChecked, a nie niesprawdzanego Transfer. Mint Token-2022 z rozszerzeniami zależnymi od mint account, takimi jak Pausable, odrzucają transfer, który go nie zawiera, a mint z transfer hookiem wymaga, aby konta hooka zostały rozwiązane i dołączone tak samo jak przy każdym innym transferze tego tokena.

Strona nogi aktywa, podpisująca jako userASigner, zasila escrow 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]);

Strona nogi gotówkowej robi to samo dla escrow B, używając userBAtaB, mintB, userBSigner, t.amountB i { programAddress: tokenProgramB }.

Transfer zasilający widoczny ze statusem confirmed nadal może zostać zastąpiony. Program odczytuje saldo escrow onchain podczas rozliczenia, więc Settle wysłany po transferze zasilającym, który nie został zapisany, kończy się błędem LegNotFunded i nic się nie przemieszcza; kosztem jest nieudany Settle i ponowna próba. Uznaj nogę za zasiloną dopiero, gdy jej transfer ma status finalized.

Uwagi

  • Nogi z wrapped SOL. Program odczytuje saldo natywnego escrow po jego synchronizacji, więc lamports wysłane na escrow wrapped SOL zwykłym transferem systemowym są wliczane. Nigdy nie wysyłaj SOL na escrow dla żadnego innego mint: program nie może go zwrócić, a trafia on do osoby, która zamknie konto.
  • Mint z ograniczeniami. W przypadku mint z Default Account State ustawionym na frozen escrow jest tworzone jako zamrożone, a transfer kończy się niepowodzeniem, dopóki emitent go nie odblokuje lub nie dopuści. Przegląd opisuje współdziałanie z Token ACL.
  • Transfer hooki. Zasilaj escrow z hookami dokładnie uzgodnioną kwotą. Jeśli nadwyżka wymusza zwrot podczas rozliczenia, zwrot ponownie wykorzystuje konta hooka nogi z innym miejscem docelowym i kwotą, co niektóre hooki odrzucają. Rozwiązaniem jest Reclaim, ponowne zasilenie dokładną kwotą i ponowne rozliczenie.
  • Zasilanie po wygaśnięciu. Nic nie blokuje transferu po expiry_timestamp. Transfer zostaje zapisany, rozliczenie nie jest już możliwe, a strona nogi odzyskuje środki przez Reclaim, gdy transakcja jest otwarta, lub Recover po jej zamknięciu. Zobacz cofnięcie transakcji.
  • Kto zasila pierwszy. Program nie ustala kolejności obu nóg. Kolejność jest sprawą stron; każda ze stron może w dowolnym momencie przed rozliczeniem odzyskać własną nogę, chyba że autorytet mint (freeze, pause lub transfer hook) blokuje escrow.

Kolejne kroki

Is this page helpful?

Spis treści

Edytuj stronę