Een trade aanmaken

CreateDvp legt de voorwaarden van een trade vast en maakt de twee escrow-accounts aan die de partijen gaan funden. Het verplaatst geen tokens. Iedereen kan het versturen, dus het record kan afkomstig zijn van een tegenpartij, de operator van de settlement authority of een derde, en elke andere deelnemer controleert de opgeslagen voorwaarden voordat hij erop handelt (zie de legs financieren).

De voorbeelden gebruiken direct de gegenereerde client, met placeholderadressen, zodat de betrokken accounts en ondertekenaars zichtbaar zijn. Ze richten zich op devnet, waar het programma op hetzelfde adres is gedeployed als op mainnet-beta.

Installeren

Er is per 2 oktober 2026 geen pakket gepubliceerd voor de DvP-clients. Beide worden gegenereerd op basis van de IDL van het programma in de repository en vanuit de broncode gebruikt.

git clone https://github.com/solana-foundation/dvp.git
cd dvp && git checkout df9919ed02c25a93620e7f6820107c9050ce3b92
pnpm install && pnpm generate-clients && pnpm build
# The client is clients/typescript/src; copy or link it into your project as ./dvp
pnpm add @solana/kit @solana/kit-plugin-rpc @solana/kit-plugin-signer @solana-program/token-2022 @solana-program/memo

Deze pagina's zijn geschreven op basis van commit df9919e, met @solana/kit 8 in TypeScript en de solana-* 2.x-crates in Rust.

De voorbeelden op elke stappenpagina bouwen op elkaar voort: elke pagina gebruikt de client, ondertekenaars en adressen die op eerdere pagina's zijn gedefinieerd. payerSigner, userASigner, userBSigner en authoritySigner zijn TransactionSigners voor de rent- betaler, de twee partijen en de settlement authority, bijvoorbeeld afkomstig van createKeyPairSignerFromBytes. De Rust-voorbeelden bouwen instructies op en laten het ondertekenen en versturen over aan de aanroeper.

De adressen afleiden

Het trade-record is een program-derived address op basis van de settlement authority, de twee partijen, de twee mints en een nonce. Elke escrow is de associated token account van het record voor een van de mints. Beide afleidingen hebben geen netwerktoegang nodig.

Gebruik voor elke trade een willekeurige 64-bits nonce. Omdat het aanmaken permissionless is, kan een voorspelbare nonce ervoor zorgen dat een derde het adres bezet dat een trade zou gaan gebruiken. Geef de nonce en de bedragen in TypeScript door als bigint; de gegenereerde client weigert een number.

Vervang elke ..._HERE-placeholder door een echt adres voordat je het uitvoert. address() valideert base58 en geeft een foutmelding bij een placeholder, en pubkey! compileert niet.

import { address, createClient } from "@solana/kit";
import { solanaRpc } from "@solana/kit-plugin-rpc";
import { signer } from "@solana/kit-plugin-signer";
import { TOKEN_2022_PROGRAM_ADDRESS } from "@solana-program/token-2022";
import { findSwapDvpEscrowAta, findSwapDvpPda } from "./dvp";
const client = createClient()
.use(signer(payerSigner))
.use(
solanaRpc({
rpcUrl: "https://api.devnet.solana.com",
rpcSubscriptionsUrl: "wss://api.devnet.solana.com",
}),
);
const settlementAuthority = address("SETTLEMENT_AUTHORITY_ADDRESS_HERE");
const userA = address("ASSET_LEG_PARTY_ADDRESS_HERE");
const userB = address("CASH_LEG_PARTY_ADDRESS_HERE");
const mintA = address("ASSET_MINT_ADDRESS_HERE");
const mintB = address("CASH_MINT_ADDRESS_HERE");
const tokenProgramA = TOKEN_2022_PROGRAM_ADDRESS;
const tokenProgramB = TOKEN_2022_PROGRAM_ADDRESS;
// A fresh random nonce per trade, as a bigint.
const nonce = new DataView(
crypto.getRandomValues(new Uint8Array(8)).buffer,
).getBigUint64(0);
const [swapDvp] = await findSwapDvpPda({
settlementAuthority,
userA,
userB,
mintA,
mintB,
nonce,
});
const [escrowA] = await findSwapDvpEscrowAta({
swapDvp,
mint: mintA,
tokenProgram: tokenProgramA,
});
const [escrowB] = await findSwapDvpEscrowAta({
swapDvp,
mint: mintB,
tokenProgram: tokenProgramB,
});

De voorwaarden vastleggen

CreateDvp neemt de twee bedragen in basiseenheden, een vervaldatum, de nonce en vier optionele velden: een ondoorzichtige referentie van maximaal 64 bytes, een settlementbestemming voor elke kant en een vroegst mogelijk settlementtijdstip (zie Opmerkingen). De bestemming is waar de opbrengst van die partij bij settlement terechtkomt, bijvoorbeeld de deposit-wallet van een custodian; standaard is dit het eigen adres van de partij en het staat vast zodra het record bestaat. Terugbetalingen en reclaims gaan altijd naar de eigen token account van de partij voor de mint van die leg, nooit naar een bestemming, ongeacht wie de escrow heeft gefund.

De payer financiert de rent voor het record, de nonce-tombstone en beide escrows. Bij het sluiten gaat die rent naar degene die de sluitingsinstructie ondertekent, niet terug naar de payer. De tombstone wordt nooit gesloten, dus elke trade laat een klein permanent saldo achter. Leid bij het budgetteren van de SOL van de payer de rent-bedragen af met de RPC-methode getMinimumBalanceForRentExemption in plaats van ze hard te coderen.

import { getCreateDvpInstruction } from "./dvp";
const nowSeconds = BigInt(Math.floor(Date.now() / 1000));
const createInstruction = getCreateDvpInstruction({
payer: payerSigner,
swapDvp,
nonceTombstone: (
await getProgramDerivedAddress({
programAddress: DVP_SWAP_PROGRAM_PROGRAM_ADDRESS,
seeds: ["nonce", getAddressEncoder().encode(swapDvp)],
})
)[0],
settlementAuthority,
userA,
userB,
mintA,
mintB,
dvpAtaA: escrowA,
dvpAtaB: escrowB,
tokenProgramA,
tokenProgramB,
amountA: 1_000_000_000n, // 1,000 units of a 6-decimal asset
amountB: 998_500_000n, // 998.50 units of a 6-decimal cash token
expiryTimestamp: nowSeconds + 60n * 60n * 24n, // one day
nonce,
refString: "ORDER-2026-10-02-0001",
userASettlementDestination: null, // defaults to userA
userBSettlementDestination: null, // defaults to userB
earliestSettlementTimestamp: null,
});
const { context } = await client.sendTransaction([createInstruction]);
console.log("Trade record:", swapDvp, "signature:", context.signature);

Voor het TypeScript-voorbeeld moeten getProgramDerivedAddress en getAddressEncoder uit @solana/kit, en DVP_SWAP_PROGRAM_PROGRAM_ADDRESS uit de client, beschikbaar zijn in de scope. De Rust-builder laat de system program en associated token program op hun standaardwaarden staan.

Opmerkingen

  • Vervaldatum. Alleen Settle controleert de vervaldatum. Reclaim, Cancel en Reject werken er ook na, en een storting die na de vervaldatum binnenkomt, kan door de partij van die leg worden teruggehaald. De vervaldatum mag maximaal een jaar na het aanmaken liggen.
  • Tijd is netwerktijd. Het programma leest de onchain klok, die kan afwijken van de echte kloktijd, soms met tientallen seconden, en vooruit kan springen. Laat een marge tussen de vervaldatum en het beoogde settlementtijdstip, vermijd funden of settlen vlak bij een van beide grenzen en vertrouw er niet op dat de vervaldatum een deadline op de seconde afdwingt. De README van het programma adviseert ongeveer een minuut afwijking in te calculeren.
  • Vroegste settlement. Optioneel. Indien ingesteld, wordt Settle daarvoor afgewezen, en mag het niet later zijn dan de vervaldatum.
  • Controles bij het aanmaken. Create mislukt met PartyNotSignerCapable als een partij geen account is dat eigendom is van het System Program (dit sluit een SPL Token-multisig uit), SettlementDestinationIsSwapDvp, SelfDvp, SameMint, ZeroAmount, SettlementAuthorityIsParty of ExpiryNotInFuture. De volledige lijst staat in de foutentabel.

Volgende stappen

Is this page helpful?

Inhoudsopgave

Pagina Bewerken
© 2026 Solana Foundation. Alle rechten voorbehouden.