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.gitcd dvp && git checkout df9919ed02c25a93620e7f6820107c9050ce3b92pnpm install && pnpm generate-clients && pnpm build# The client is clients/typescript/src; copy or link it into your project as ./dvppnpm 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 assetamountB: 998_500_000n, // 998.50 units of a 6-decimal cash tokenexpiryTimestamp: nowSeconds + 60n * 60n * 24n, // one daynonce,refString: "ORDER-2026-10-02-0001",userASettlementDestination: null, // defaults to userAuserBSettlementDestination: null, // defaults to userBearliestSettlementTimestamp: 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
PartyNotSignerCapableals een partij geen account is dat eigendom is van het System Program (dit sluit een SPL Token-multisig uit),SettlementDestinationIsSwapDvp,SelfDvp,SameMint,ZeroAmount,SettlementAuthorityIsPartyofExpiryNotInFuture. De volledige lijst staat in de foutentabel.
Volgende stappen
- De legs financieren: elke partij stort haar leg in de escrow van de trade
Is this page helpful?