CreateDvp registra i termini di un trade e crea i due account di escrow che le
parti finanzieranno. Non sposta alcun token. Chiunque può inviarlo, quindi il record può
provenire da una controparte, dall'operatore dell'autorità di regolamento o da un terzo,
e ogni altro partecipante verifica i termini memorizzati prima di agire su di essi (vedi
finanziare le gambe).
Gli snippet usano direttamente il client generato, con indirizzi segnaposto, in modo che gli account e i firmatari coinvolti siano visibili. Hanno come target devnet, dove il programma è distribuito allo stesso indirizzo di mainnet-beta.
Installazione
Al 2 ottobre 2026 non è pubblicato alcun pacchetto per i client DvP. Entrambi sono generati dall'IDL del programma nel repository e usati dal sorgente.
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
Queste pagine sono scritte in riferimento al commit df9919e, con @solana/kit 8 in
TypeScript e i crate solana-* 2.x in Rust.
Gli snippet di ogni pagina dei passaggi sono cumulativi: ogni pagina usa il client, i firmatari
e gli indirizzi definiti nelle pagine precedenti. payerSigner, userASigner,
userBSigner e authoritySigner sono TransactionSigner per il payer della
rent, le due parti e l'autorità di regolamento, ad esempio ottenuti da
createKeyPairSignerFromBytes. Gli snippet Rust costruiscono le istruzioni e lasciano
la firma e l'invio al chiamante.
Derivare gli indirizzi
Il record del trade è un Program Derived Address calcolato sull'autorità di regolamento, sulle due parti, sui due mint e su un nonce. Ogni escrow è l'associated token account del record per uno dei mint. Entrambe le derivazioni non richiedono accesso alla rete.
Usa un nonce casuale a 64 bit per ogni trade. Poiché la creazione è senza permessi, un
nonce prevedibile consente a un terzo di occupare l'indirizzo che un trade avrebbe
usato. Passa il nonce e gli importi come bigint in TypeScript; il client
generato rifiuta un number.
Sostituisci ogni segnaposto ..._HERE con un indirizzo reale prima dell'esecuzione.
address() convalida la codifica base58 e genera un errore con un segnaposto, mentre pubkey! non
viene compilato.
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,});
Registrare i termini
CreateDvp accetta i due importi in unità di base, una scadenza, il nonce e quattro
campi opzionali: un riferimento opaco fino a 64 byte, una destinazione di regolamento
per ciascun lato e un orario di regolamento minimo (vedi Note). La destinazione è
dove finiscono i proventi di quella parte al momento del regolamento, ad esempio il wallet di
deposito di un custode; per impostazione predefinita è l'indirizzo della parte stessa e viene fissata una volta che
il record esiste. Rimborsi e recuperi vanno sempre al token account della parte
per il mint di quella gamba, mai a una destinazione, chiunque abbia finanziato l'escrow.
Il payer finanzia la rent per il record, il tombstone del nonce e entrambi gli escrow.
Alla chiusura, la rent va a chi firma l'istruzione di chiusura, non torna
al payer. Il tombstone non viene mai chiuso, quindi ogni trade lascia un piccolo saldo
permanente. Quando pianifichi il budget di SOL del payer, ricava gli importi della rent con il
metodo RPC getMinimumBalanceForRentExemption anziché inserirli nel codice in modo fisso.
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);
Lo snippet TypeScript richiede getProgramDerivedAddress e getAddressEncoder
da @solana/kit, e DVP_SWAP_PROGRAM_PROGRAM_ADDRESS dal client, nello
scope. Il builder Rust lascia System Program e Associated Token Program
ai loro valori predefiniti.
Note
- Scadenza. Solo Settle controlla la scadenza. Reclaim, Cancel e Reject funzionano anche dopo di essa, e un deposito che arriva dopo la scadenza è recuperabile dalla parte della gamba. La scadenza può essere al massimo un anno dopo la creazione.
- Il tempo è il tempo di rete. Il programma legge l'orologio onchain, che può differire dall'ora reale, a volte di decine di secondi, e può saltare in avanti. Lascia un margine tra la scadenza e l'orario di regolamento previsto, evita di finanziare o regolare vicino a entrambi i limiti e non fare affidamento sulla scadenza per imporre una scadenza al secondo. Il README del programma suggerisce di prevedere circa un minuto di deriva.
- Regolamento minimo. Opzionale. Se impostato, Settle viene rifiutato prima di esso e non deve essere successivo alla scadenza.
- Controlli in fase di creazione. Create fallisce con
PartyNotSignerCapablese una parte non è un account di proprietà del sistema (questo esclude un multisig SPL Token),SettlementDestinationIsSwapDvp,SelfDvp,SameMint,ZeroAmount,SettlementAuthorityIsPartyoExpiryNotInFuture. L'elenco completo è nella tabella degli errori.
Prossimi passaggi
- Finanziare le gambe: ogni parte trasferisce la propria gamba nell'escrow del trade
Is this page helpful?