Rahoitus on tavallinen TransferChecked-siirto osuuden escrow-tilille, joten mikä tahansa lompakko tai
säilytysjärjestelmä, joka pystyy lähettämään tokensiirron, voi rahoittaa osuuden. Vain kauppatietueen
luku ennen rahoitusta vaatii DvP-asiakasohjelman. Ohjelma tarkistaa
escrow-saldot vasta selvityksessä; mikään ei tarkista siirtoa sen saapuessa,
joten kunkin osapuolen on luettava kauppatietue ennen siirtoa.
Tämä sivu jatkaa sivulta luo kauppa; asiakasohjelma ja allekirjoittajat jatkuvat sellaisinaan.
Tarkista ehdot
Tietueen luominen ei vaadi lupaa, ja escrow-osoitteet johdetaan pelkästään
tietueesta ja mintistä, ei koskaan ehdoista. Siirto escrow-tilille voi siksi
osua ehtoihin, joista et ole koskaan sopinut, mukaan lukien selvityksen
kohteet, jotka ohjaavat vastapuolesi tuotot kolmanteen osoitteeseen.
Lue ennen rahoitusta SwapDvp-tili ja vertaa sitä sovittuun kauppaan.
TypeScriptin verifySwapDvp ja Rustin verify::decode_swap_dvp_account
varmistavat, että tilin omistaa DvP-ohjelma, että sen koko on täsmälleen 458 tavua ja että
se sijaitsee osoitteessa, joka johdetaan sen omista kentistä (fetchSwapDvpChecked suorittaa
vain kaksi ensimmäistä tarkistusta). Tavalliset fetchSwapDvp- ja decodeSwapDvp-lukijat
eivät tee mitään näistä tarkistuksista. Osapuolten, summien, aikojen ja kohteiden tarkistukset
tekee kutsuja sovittua kauppaa vasten.
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");}
Jos vastapuolesi tai selvitysviranomainen loi tietueen, vertaa jokaista kenttää ehtoihin, joista sovit pääkirjan ulkopuolella. Jos loit sen itse, tämä luku vahvistaa, että se tallentui lähetetyssä muodossa.
Siirrä varat escrow-tilille
Rahoita osuus täsmälleen sovitulla summalla. Ohjelma rajaa selvityksen
summaan amount_x ja palauttaa ylimenevän osan osuuden osapuolelle, joten ylijäämä ei katoa,
mutta se lisää selvitykseen toisen siirron ja voi epäonnistua joidenkin transfer hookien kanssa
(katso alla olevat huomautukset).
Käytä TransferChecked-siirtoa, älä tarkistamatonta Transfer-siirtoa. Token-2022-mintit,
joiden laajennukset riippuvat mint accountista, kuten Pausable, hylkäävät siirron,
joka ei sisällä sitä, ja mint, jolla on transfer hook, vaatii hookin
tilien selvittämisen ja liittämisen samalla tavalla kuin minkä tahansa muun
kyseisen tokenin siirron kohdalla.
Omaisuusosuuden osapuoli rahoittaa allekirjoittajanaan userASigner escrow A:n:
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]);
Käteisosuuden osapuoli tekee saman escrow B:lle käyttäen arvoja userBAtaB, mintB,
userBSigner, t.amountB ja { programAddress: tokenProgramB }.
Rahoitussiirto, joka näkyy tilassa confirmed,
voi silti korvautua toisella. Ohjelma lukee escrow-saldon ketjusta
selvityshetkellä, joten Settle-instruktio, joka lähetetään sellaista rahoitussiirtoa vasten, joka ei tallentunut, epäonnistuu
virheeseen LegNotFunded eikä mikään liiku; kustannuksena on epäonnistunut Settle ja uusi yritys.
Käsittele osuutta rahoitettuna vasta, kun sen siirto on tilassa finalized.
Huomautukset
- Wrapped SOL -osuudet. Ohjelma lukee natiivin escrow-tilin saldon synkronoituaan sen, joten järjestelmäsiirrolla wrapped SOL -escrow-tilille lähetetyt lamport-yksiköt lasketaan mukaan. Älä koskaan lähetä SOLia escrow-tilille minkään muun mintin osalta: ohjelma ei voi palauttaa sitä, ja se päätyy sille, joka sulkee tilin.
- Rajatut mintit. Mintillä, jonka Default Account State on frozen, escrow-tili luodaan jäädytettynä, ja siirto epäonnistuu, kunnes liikkeeseenlaskija sulattaa tilin tai hyväksyy sen. Yleiskatsaus kuvaa vuorovaikutuksen Token ACL:n kanssa.
- Transfer hookit. Rahoita hookia käyttävät escrow-tilit täsmälleen sovitulla summalla. Jos ylijäämä pakottaa palautuksen selvityksessä, palautus käyttää uudelleen osuuden hook-tilejä eri kohteella ja summalla, minkä jotkin hookit hylkäävät. Korjaus on Reclaim, rahoitus uudelleen täsmällisellä summalla ja uusi selvitys.
- Rahoitus eräpäivän jälkeen. Mikään ei estä siirtoa
expiry_timestamp-ajan jälkeen. Se tallentuu, selvitys ei ole enää mahdollinen, ja osuuden osapuoli saa varat takaisin Reclaim-instruktiolla kaupan ollessa avoin tai Recover-instruktiolla sen sulkeuduttua. Katso kaupan purkaminen. - Kuka rahoittaa ensin. Ohjelma ei järjestä kahta osuutta jonoon. Järjestys on osapuolten sovittavissa; kumpi tahansa osapuoli voi lunastaa oman osuutensa takaisin milloin tahansa ennen selvitystä, ellei mintin valtuutettu (freeze, pause tai transfer hook) estä escrow-tiliä.
Seuraavat vaiheet
- Selvitä kauppa: selvitysviranomainen vaihtaa molemmat osuudet yhdessä transaktiossa
- Kaupan purkaminen: rahoitetun osuuden palauttaminen, kun kauppa ei selviä
Is this page helpful?