Kaupan purkaminen

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.

InstruktioAllekirjoittajaLaajuusKauppa sen jälkeen
ReclaimDvpuser_a tai user_bAllekirjoittajan oma osuusEdelleen avoin
CancelDvpSelvitysviranomainenMolemmat osuudetSuljettu
RejectDvpuser_a tai user_bMolemmat osuudetSuljettu
RecoverDvpuser_a tai user_bAllekirjoittajan osuus sulkemisen jälkeenJo 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

Is this page helpful?

Sisällysluettelo

Muokkaa sivua
© 2026 Solana Foundation. Kaikki oikeudet pidätetään.