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 agreedconst expectedExpiry = 1_798_761_600n; // as agreed, unix secondsif (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
- Rozliczenie transakcji: organ rozliczający wymienia obie nogi w jednej transakcji
- Cofnięcie transakcji: odzyskanie zasilonej nogi, gdy transakcja nie zostaje rozliczona
Is this page helpful?