Neljä instruktiota palauttaa varat ilman selvitystä: Reclaim, Cancel ja Reject kaupan ollessa avoinna sekä Recover talletukselle, joka saapuu kaupan sulkeutumisen jälkeen. Mikään niistä ei tarkista erääntymistä. Jäädytetty escrow tai muuttunut mint voi silti pidättää osuuden, kuten lopun huomautukset kuvaavat.
| Instruktio | Allekirjoittaja | Laajuus | Kauppa sen jälkeen |
|---|---|---|---|
ReclaimDvp | user_a tai user_b | Allekirjoittajan oma osuus | Edelleen avoin |
CancelDvp | Selvitysviranomainen | Molemmat osuudet | Suljettu |
RejectDvp | user_a tai user_b | Molemmat osuudet | Suljettu |
RecoverDvp | user_a tai user_b | Allekirjoittajan osuus sulkemisen jälkeen | Jo suljettu |
Kussakin tapauksessa escrow tyhjennetään kaikesta sisältämästään osuuden
osapuolelle: escrow A user_a:n token account -tilille mintille mint_a,
escrow B user_b:n token account -tilille mintille mint_b, riippumatta siitä,
kuka sen rahoitti. Memo program account annetaan palautustileille, jotka
vaativat memon.
Tämä sivu jatkuu aiemmista vaiheista: client ja allekirjoittajat kohdasta
kaupan luominen, userAAtaA ja
userBAtaB kohdasta osuuksien rahoitus sekä
MEMO_PROGRAM_ID ja authority kohdasta
kaupan selvitys siirtyvät mukaan.
Osuuden takaisinotto
Reclaim palauttaa allekirjoittajan osuuden ja jättää kaupan avoimeksi, joten osuus voidaan rahoittaa uudelleen. Käytä sitä, kun ongelma on vastapuolen osuudessa; Cancel ja Reject sulkevat koko kaupan.
import { MEMO_PROGRAM_ADDRESS } from "@solana-program/memo";import { getReclaimDvpInstruction } from "./dvp";// The asset-leg party takes its asset back.const reclaimInstruction = getReclaimDvpInstruction({signer: userASigner,swapDvp,mint: mintA,dvpSourceAta: escrowA,signerDestAta: userAAtaA,tokenProgram: tokenProgramA,memoProgram: MEMO_PROGRAM_ADDRESS,});await client.sendTransaction([reclaimInstruction]);
Cancel tai Reject
Cancelin allekirjoittaa selvitysviranomainen ja Rejectin kumpi tahansa osapuoli. Molemmat palauttavat kunkin escrow-tilin sisällön osuuden osapuolelle ja sulkevat tietueen sekä molemmat escrow-tilit, ja suljettujen tilien rent menee allekirjoittajalle. Kaksi instruktiota käyttää samoja tilejä; vain allekirjoittaja eroaa.
import { getCancelDvpInstruction, getRejectDvpInstruction } from "./dvp";const unwindAccounts = {swapDvp,mintA,mintB,dvpAtaA: escrowA,dvpAtaB: escrowB,userAAtaA,userBAtaB,tokenProgramA,tokenProgramB,memoProgram: MEMO_PROGRAM_ADDRESS,legAExtrasCount: 0,};// Signed by the settlement authority:const cancelInstruction = getCancelDvpInstruction({settlementAuthority: authoritySigner,...unwindAccounts,});// Or signed by either party:const rejectInstruction = getRejectDvpInstruction({signer: userBSigner,...unwindAccounts,});
Palautustilien (userAAtaA, userBAtaB) on oltava olemassa jokaiselle
osuudelle, jolla on saldo; alustamaton palautustili saa tokenien siirron
epäonnistumaan ja peruu instruktion. Osuus, jota ei koskaan rahoitettu, ei
tarvitse siirtoa ja sietää puuttuvan tilin.
Myöhäisen talletuksen palautus
Settle, Cancel ja Reject sulkevat kaikki molemmat escrow token account -tilit, joten pelkkä siirto suljettuun escrow-tiliin epäonnistuu. Talletus päätyy perille sulkemisen jälkeen vain, jos jokin luo escrow-tilin ensin uudelleen, esimerkiksi rahoitustransaktio, joka sisältää ennen siirtoa create-idempotent- muotoisen associated token account -instruktion ja oli matkalla, kun vastapuoli lähetti Rejectin. Tokenit jäävät silloin escrow-tilille, jonka kauppaa ei enää ole: tietue on poissa, joten Reclaim ei löydä sitä, ja nonce tombstone estää luomasta uutta kauppaa samaan osoitteeseen ja sieppaamasta talletusta.
RecoverDvp-instruktion käyttämiseksi osuuden osapuoli antaa alkuperäiset
seed-syötteet (selvitysviranomainen, molemmat osapuolet, molemmat mintit,
nonce). Ohjelma johtaa tietueen osoitteen uudelleen, edellyttää sen
tombstonea todisteena kaupan olemassaolosta, tyhjentää escrow-tilin
allekirjoittajan omalle token account -tilille ja sulkee sen palauttaen
escrow-tilin rent-summan allekirjoittajalle. Allekirjoittajan osuus määräytyy
sen mukaan, kumpi osapuoli allekirjoittaa: mint_a user_a:lle, mint_b
user_b:lle.
import { getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";import { DVP_SWAP_PROGRAM_PROGRAM_ADDRESS, getRecoverDvpInstruction } from "./dvp";const [nonceTombstone] = await getProgramDerivedAddress({programAddress: DVP_SWAP_PROGRAM_PROGRAM_ADDRESS,seeds: ["nonce", getAddressEncoder().encode(swapDvp)],});const recoverInstruction = getRecoverDvpInstruction({signer: userASigner,swapDvp,nonceTombstone,mint: mintA,dvpEscrowAta: escrowA,signerDestAta: userAAtaA,tokenProgram: tokenProgramA,memoProgram: MEMO_PROGRAM_ADDRESS,settlementAuthority,userA,userB,mintA,mintB,nonce,});await client.sendTransaction([recoverInstruction]);
Palautus edellyttää, että osapuoli säilyttää luontiparametrit. Kauppoja rahoittava järjestelmä tallentaa seed-syötteet jokaisen toimeksiannon mukana, kunnes kauppa on suljettu ja escrow-saldojen on vahvistettu olevan tyhjiä.
Huomautukset
- Jäädytetyt osuudet. Rajoitetulla mintillä jäädytetty escrow estää näiden instruktioiden suorittaman tokenien siirron, kunnes freeze authority vapauttaa jäädytyksen. Katso yleiskatsaus.
- Mintin muutokset luomisen jälkeen. Purkupolut ohittavat laajennus- ja mint authority -tarkistukset, jotta ohjelman omat tarkistukset eivät estä palautusta. Myös token program soveltaa omia sääntöjään. Mintin voi sulkea vain, kun sen supply on nolla, joten se ei voi muuttua escrow-tilillä olevan saldon aikana, mutta mint, joka suljetaan ja luodaan uudelleen NonTransferable-tyyppisenä tai transfer fee -maksulla ennen myöhäisen talletuksen saapumista, voi tehdä talletuksesta siirtokelvottoman tai maksullisen. Tämä on mint authority -riippuvuus, joka mainitaan kohdassa tuetut tokenit.
Seuraavat vaiheet
- DvP-ohjelma: yleiskatsaus, tuetut tokenit ja mintin konfiguraatiorajoitukset
- Delivery vs Payment (DvP) delegoinnilla: sama vaihto delegoidun valtuuden kautta ilman ohjelmaa
Is this page helpful?