Die Finanzierung ist ein einfacher TransferChecked in das Escrow des Legs, sodass jede Wallet und jedes Custody-System, das einen Token-Transfer senden kann,
ein Leg finanzieren kann. Nur das Lesen des Trade-Datensatzes vor der Finanzierung
erfordert den DvP-Client. Das Programm prüft die Escrow-Guthaben erst bei der Abwicklung;
nichts prüft den Transfer, wenn er ankommt, daher liest jede Partei
den Trade-Datensatz, bevor sie überweist.
Diese Seite setzt die Anleitung Einen Trade erstellen fort; Client und Signer werden übernommen.
Die Konditionen prüfen
Das Erstellen eines Datensatzes ist permissionless, und die Escrow-Adressen werden allein aus dem
Datensatz und dem Mint abgeleitet, nie aus den Konditionen. Ein Transfer in ein Escrow kann
daher gegen Konditionen landen, denen du nie zugestimmt hast, einschließlich Abwicklungszielen,
die die Erlöse deiner Gegenpartei an eine dritte Adresse umleiten.
Lies vor der Finanzierung die Konten-Daten von SwapDvp und gleiche sie mit dem vereinbarten
Trade ab.
verifySwapDvp in TypeScript und verify::decode_swap_dvp_account in Rust
bestätigen, dass der Konten-Datensatz dem DvP-Programm gehört, genau 458 Bytes groß ist und
an der Adresse liegt, die sich aus seinen eigenen Feldern ableitet (fetchSwapDvpChecked führt nur die
ersten beiden Prüfungen durch). Die einfachen Reader fetchSwapDvp und decodeSwapDvp
führen keine dieser Prüfungen durch. Die Prüfungen von Parteien, Beträgen, Zeiten und Zielen
führt der Aufrufer gegen den vereinbarten Trade durch.
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");}
Wurde der Datensatz von deiner Gegenpartei oder der Settlement-Autorität erstellt, vergleiche jedes Feld mit den Konditionen, die ihr off-chain vereinbart habt. Hast du ihn selbst erstellt, bestätigt dieses Lesen, dass er wie gesendet angekommen ist.
In das Escrow überweisen
Finanziere das Leg exakt mit dem vereinbarten Betrag. Das Programm begrenzt die Abwicklung auf
amount_x und gibt einen Überschuss an die Partei des Legs zurück, ein Überschuss geht also nicht verloren,
erfordert aber bei der Abwicklung einen zweiten Transfer und kann bei manchen Transfer-Hooks
fehlschlagen (siehe die Hinweise unten).
Verwende TransferChecked, nicht ein ungeprüftes Transfer. Token-2022-Mints mit
Erweiterungen, die vom mint account abhängen, wie Pausable, lehnen einen Transfer ab,
der ihn nicht mitliefert, und ein Mint mit Transfer-Hook benötigt die aufgelösten und angehängten Konten des Hooks,
genauso wie bei jedem anderen Transfer dieses Tokens.
Die Partei des Asset-Legs signiert als userASigner und finanziert 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]);
Die Partei des Cash-Legs macht dasselbe für Escrow B mit userBAtaB, mintB,
userBSigner, t.amountB und { programAddress: tokenProgramB }.
Ein Funding-Transfer, der bei confirmed gesehen wird,
kann noch ersetzt werden. Das Programm liest das Escrow-Guthaben onchain bei der
Abwicklung, daher schlägt ein Settle, das gegen einen nicht angekommenen Funding-Transfer gesendet wird,
mit LegNotFunded fehl und nichts wird bewegt; die Kosten sind ein fehlgeschlagenes Settle und ein erneuter Versuch.
Betrachte ein Leg erst dann als finanziert, wenn sein Transfer finalized ist.
Hinweise
- Wrapped-SOL-Legs. Das Programm liest das Guthaben eines nativen Escrows nach dessen Synchronisierung, daher werden lamports, die per System-Transfer an ein Wrapped-SOL-Escrow gesendet wurden, mitgezählt. Sende niemals SOL an ein Escrow für einen anderen Mint: Das Programm kann es nicht zurückgeben, und es geht an denjenigen, der das Escrow schließt.
- Gated Mints. Bei einem Mint mit Default Account State frozen wird das Escrow eingefroren erstellt, und der Transfer schlägt fehl, bis der Emittent es freigibt oder zulässt. Die Übersicht beschreibt die Interaktion mit Token ACL.
- Transfer-Hooks. Finanziere Escrows mit Hook exakt mit dem vereinbarten Betrag. Erzwingt ein Überschuss bei der Abwicklung eine Rückerstattung, verwendet diese die Hook-Konten des Legs mit einem anderen Ziel und einem anderen Betrag, was manche Hooks ablehnen. Die Wiederherstellung: Reclaim, mit dem exakten Betrag erneut finanzieren und erneut abwickeln.
- Finanzierung nach Ablauf. Nichts verhindert einen Transfer nach
expiry_timestamp. Er kommt an, eine Abwicklung ist nicht mehr möglich, und die Partei des Legs holt ihn mit Reclaim zurück, solange der Trade offen ist, oder mit Recover, nachdem er geschlossen wurde. Siehe Einen Trade rückabwickeln. - Wer zuerst finanziert. Das Programm legt keine Reihenfolge der beiden Legs fest. Die Reihenfolge ist Sache der Parteien; jede Seite kann ihr eigenes Leg jederzeit vor der Abwicklung per Reclaim zurückholen, sofern keine Mint-Autorität (Freeze, Pause oder Transfer-Hook) das Escrow blockiert.
Nächste Schritte
- Den Trade abwickeln: Die Settlement- Autorität tauscht beide Legs in einer Transaktion aus
- Einen Trade rückabwickeln: Ein finanziertes Leg zurückholen, wenn der Trade nicht abgewickelt wird
Is this page helpful?