Program Delivery vs Payment (DvP)

Program DvP adalah program standar untuk delivery versus payment di Solana, dikelola oleh Solana Foundation dan diaudit oleh Cantina. Dua pihak menyepakati sebuah trade, masing-masing mengirim sisinya ke akun escrow melalui transfer token biasa, lalu otoritas penyelesaian menyelesaikan kedua sisi dalam satu transaksi, sehingga keduanya berpindah atau tidak sama sekali. Otoritas penyelesaian adalah alamat ketiga yang disebutkan dalam trade, seperti venue atau agen yang mengaturnya. Tidak ada pihak yang menulis atau men-deploy program, dan dompet atau kustodian yang dapat mengirim transfer token standar (TransferChecked) dapat mendanai satu sisi tanpa integrasi khusus DvP. Sebelum penyelesaian, salah satu pihak dapat menarik kembali sisinya sendiri atau membatalkan trade.

Baca record sebelum bertindak berdasarkan isinya

Membuat record trade tidak memerlukan izin, sehingga sebuah record bukanlah bukti kesepakatan. Setiap pihak membaca ketentuan yang tersimpan sebelum mendanai, dan otoritas penyelesaian membacanya sebelum menyelesaikan (lihat verifikasi).

Cara kerja

Setiap trade mendapatkan satu record milik program dan dua akun escrow, satu untuk tiap sisi. Pihak sisi aset (user_a) dan pihak sisi kas (user_b) masing-masing mendanai sisinya dengan mentransfer token ke akun escrow untuk sisi tersebut. Otoritas penyelesaian adalah satu-satunya penandatangan yang dapat menyelesaikan trade. Penyelesaian mentransfer jumlah yang disepakati dari tiap sisi ke pihak lawan, mengembalikan kelebihan dana kepada pihak pemilik sisi tersebut, dan menutup record serta kedua escrow. Atomisitas berasal dari transaksi Solana: kedua transfer berada dalam satu transaksi, sehingga keduanya berlaku atau tidak sama sekali.

Setiap refund, penarikan kembali, dan pengembalian kelebihan dana masuk ke associated token account milik pihak itu sendiri: akun user_a untuk mint_a, akun user_b untuk mint_b. Sistem kustodian atau treasury dapat mendanai satu sisi dari akunnya sendiri, tetapi apa pun yang dikembalikan akan masuk ke akun pihak tersebut, bukan kembali ke kustodian. Setiap trade juga meninggalkan akun penanda permanen (lihat State).

Panduan

Halaman-halaman langkah ini membawa satu trade dari pembuatan hingga penyelesaian, dengan TypeScript dan Rust untuk setiap instruksi.

Sebuah demo devnet menjalankan trade dari awal hingga akhir: membuat trade, mendanai kedua escrow dengan transfer token standar, dan menyelesaikan kedua sisi dalam satu transaksi.

Memilih antara program dan delegasi

Delivery vs Payment (DvP) menggunakan delegasi menyelesaikan pertukaran yang sama tanpa program: masing-masing pihak mendelegasikan posisinya kepada agen penyelesaian, yang memindahkan kedua sisi dalam satu transaksi.

  • Program tidak memerlukan delegasi, sehingga batas satu delegasi per token account tidak berlaku, dan otoritas penyelesaian tidak dapat mengalihkan hasil. Setiap trade bergantung pada program yang dapat di-upgrade dan upgrade authority-nya.
  • Pola delegasi tidak bergantung pada program dan dapat digunakan dengan mint yang memiliki Scaled UI Amount. Program menolak mint tersebut, yang berarti mint apa pun yang dibuat dari template tokenized-security milik Mosaic tidak dapat digunakan (lihat batasan konfigurasi mint).

Peran

Program ini simetris. Pada antarmukanya, kedua pihak adalah user_a, yang menyerahkan mint_a, dan user_b, yang menyerahkan mint_b. README dan klien yang dihasilkan menyebut mint_a sebagai sisi aset dan mint_b sebagai sisi kas, dan halaman-halaman ini mengikuti konvensi tersebut, tetapi tidak ada ketentuan dalam program yang mengharuskan sisi kas berupa instrumen kas. Dua aset, atau dua stablecoin, diselesaikan dengan cara yang sama.

PeranSiapaMenandatanganiCatatan
Pihak sisi asetuser_a, menyerahkan mint_aTransfer pendanaannya sendiri; Reclaim, Reject, RecoverDompet keypair, atau dompet pintar berbasis PDA seperti vault multisig. Akun multisig SPL Token atau program account tidak dapat menjadi pihak: Create gagal dengan PartyNotSignerCapable
Pihak sisi kasuser_b, menyerahkan mint_bTransfer pendanaannya sendiri; Reclaim, Reject, RecoverPersyaratan yang sama
Otoritas penyelesaianAlamat ketiga yang disebutkan saat pembuatanSettle, CancelSatu-satunya penandatangan yang dapat menyelesaikan trade. Tidak dapat mengalihkan hasil, yang ditetapkan saat pembuatan. Menerima rent dari akun yang ditutup saat menyelesaikan atau membatalkan
Pembayar rentSiapa pun yang menandatangani CreateDvpCreateMendanai rent (deposit SOL yang menjaga akun tetap terbuka) untuk record, nonce tombstone, dan kedua escrow. Tidak dicatat sebagai penerima rent: rent dari akun yang ditutup diberikan kepada siapa pun yang menutup trade

ID Program

dvp34bdbcEm4f4FCUjGV4mDAkDshaQR4LkK8fdcsyZq
ClusterProgramUpgrade authorityslot deploy terakhir
mainnet-betadvp34bdbcEm4f4FCUjGV4mDAkDshaQR4LkK8fdcsyZqDXtFpbPjcn2hxPnw79x1Pfoj35vXh5AsWBkS37YnXMVv452,058,374
devnetdvp34bdbcEm4f4FCUjGV4mDAkDshaQR4LkK8fdcsyZq5EX1zFeJWj4rGYZv432WnYw8CbaSUeTdxPx4r573UgYU479,376,863

Program ini dapat di-upgrade di kedua cluster. Angka di atas adalah hasil yang dilaporkan solana program show pada 2 Oktober 2026; jalankan perintah yang sama untuk nilai terkini. Build devnet lebih lama daripada commit yang menjadi acuan halaman-halaman langkah (lihat Instal), dengan kumpulan instruksi dan error yang sama.

Siklus hidup

Sebuah trade terbuka sejak CreateDvp hingga salah satu dari Settle, Cancel, atau Reject menutupnya. Pendanaan tidak memiliki instruksi tersendiri: satu sisi dianggap terdanai ketika akun escrow-nya menyimpan setidaknya jumlah yang disepakati. Reclaim berlaku per sisi dan membiarkan trade tetap terbuka, sehingga masalah pada satu sisi tidak memaksa pihak lain membatalkan seluruh trade.

State

Setiap trade memiliki satu akun SwapDvp sebesar 458 byte, yang dimiliki oleh program. Alamatnya diturunkan dari otoritas penyelesaian, kedua pihak, kedua mint, dan sebuah nonce (seed ["dvp", settlement_authority, user_a, user_b, mint_a, mint_b, nonce]). Jumlah dan waktu disimpan di dalam akun dan tidak memengaruhi alamat, itulah sebabnya keduanya harus dibaca, bukan disimpulkan. Sebuah akun penanda kecil, yaitu nonce tombstone di ["nonce", swap_dvp], dibuat bersama trade dan tidak pernah ditutup, sehingga setiap kombinasi pihak, mint, otoritas, dan nonce hanya dapat digunakan untuk satu trade.

FieldTipeArti
bumpu8Bump PDA
user_a, user_bPubkeyKedua pihak
mint_a, mint_bPubkeyMint sisi aset dan sisi kas
settlement_authorityPubkeySatu-satunya penandatangan yang dapat menyelesaikan atau membatalkan
token_program_a, token_program_bPubkeytoken program yang memiliki setiap mint; satu trade dapat mencampur sisi SPL Token dan Token-2022
amount_a, amount_bu64Jumlah yang disepakati untuk tiap sisi, dalam satuan terkecil mint (base unit)
expiry_timestampi64Setelah waktu jaringan ini (jam onchain), Settle ditolak. Reclaim, Cancel, dan Reject tetap berfungsi
nonceu64Membedakan trade yang memiliki seed lain yang sama. Sekali pakai
ref_string[u8; 64]Referensi klien yang bersifat opak, diisi nol di sisa ruang; program tidak pernah membacanya
user_a_settlement_destinationPubkeyMenerima sisi kas saat Settle; defaultnya user_a
user_b_settlement_destinationPubkeyMenerima sisi aset saat Settle; defaultnya user_b
mint_a_authority, mint_b_authorityPubkeyMint authority yang dicatat saat pembuatan; Settle gagal jika salah satunya berubah
earliest_settlement_timestampOption<i64>Jika diatur, Settle ditolak sebelum waktu jaringan ini

Daftar field diambil dari IDL program pada commit yang disebutkan di bawah Buat trade.

Instruksi

InstruksiPenandatanganEfek
CreateDvpPembayar mana punMembuat record SwapDvp, nonce tombstone-nya, dan kedua akun escrow. Tidak memindahkan token
ReclaimDvpuser_a atau user_bMengembalikan sisi milik penandatangan dari escrow. Trade tetap terbuka dan sisi tersebut dapat didanai kembali
SettleDvpOtoritas penyelesaianMentransfer amount_a ke tujuan user_b dan amount_b ke tujuan user_a, mengembalikan kelebihan dana kepada pihak pemilik sisi tersebut, menutup record dan kedua escrow
CancelDvpOtoritas penyelesaianMe-refund apa pun yang disimpan escrow A kepada user_a dan escrow B kepada user_b, menutup record dan kedua escrow
RejectDvpuser_a atau user_bEfek yang sama seperti Cancel, tetapi ditandatangani oleh salah satu pihak
RecoverDvpuser_a atau user_bSetelah trade ditutup: mengosongkan escrow yang dibuat ulang ke token account milik penandatangan dan menutupnya. Mencakup deposit yang masuk setelah Settle, Cancel, atau Reject

Setiap refund masuk ke associated token account milik pihak itu sendiri untuk mint sisi tersebut, siapa pun yang mendanai escrow.

Akun dan argumen setiap instruksi tersedia di halaman untuk langkah tersebut.

Error

KodeErrorKapan
0SignerNotPartyReclaim, Reject, atau Recover ditandatangani oleh alamat yang bukan user_a atau user_b
1DvpExpiredSettle setelah expiry_timestamp
2SettlementAuthorityMismatchSettle atau Cancel ditandatangani oleh alamat selain otoritas penyelesaian
3SettlementTooEarlySettle sebelum earliest_settlement_timestamp
4LegNotFundedSettle saat salah satu escrow menyimpan kurang dari jumlah yang disepakati
5ExpiryNotInFutureCreate dengan waktu kedaluwarsa yang sama dengan atau sebelum waktu jaringan saat ini
6EarliestAfterExpiryCreate dengan waktu penyelesaian paling awal setelah waktu kedaluwarsa
7SelfDvpCreate dengan user_a sama dengan user_b
8SameMintCreate dengan mint_a sama dengan mint_b
9ZeroAmountCreate dengan jumlah nol pada salah satu sisi
10BlockedMintExtensionCreate atau Settle dengan mint yang memiliki TransferFee, InterestBearing, ScaledUiAmount, atau NonTransferable
11SettlementAuthorityIsPartyCreate dengan otoritas penyelesaian yang sama dengan salah satu pihak
12SettlementAuthorityExecutableCreate dengan otoritas penyelesaian yang executable
13NonceAlreadyUsedCreate yang menggunakan kembali (seeds, nonce) yang sudah memiliki tombstone
14ExpiryTooFarInFutureCreate dengan waktu kedaluwarsa lebih dari satu tahun ke depan
15RefStringTooLongCreate dengan referensi yang lebih panjang dari 64 byte
16DvpStillOpenRecover saat trade masih terbuka; gunakan Reclaim
17DvpNeverCreatedPulihkan dengan seed yang tidak memiliki tombstone
18EscrowPreloadedWithLamportsCreate saat escrow non-native menyimpan lamport melebihi batas minimum rent-exempt-nya
19SettlementDestinationIsSwapDvpCreate dengan tujuan settlement yang sama dengan catatan trade
20SwapDvpPreloadedWithLamportsCreate saat alamat catatan menyimpan lamport melebihi cadangan rent-nya
21RecipientAtaMismatchtoken account penerima atau pengembalian dana tidak lagi dimiliki oleh wallet dan mint yang diharapkan
22PartyNotSignerCapableCreate dengan pihak yang bukan akun milik sistem dan non-executable
23MintAuthorityChangedSettle saat mint authority suatu leg berbeda dari nilai yang dicatat saat pembuatan

Event dan pengindeksan

Program tidak memancarkan event onchain. Indexer atau sistem rekonsiliasi membaca status akun SwapDvp dan saldo token dari kedua escrow, serta menggunakan ref_string untuk mengorelasikan trade dengan order off-chain-nya. Karena catatan ditutup saat settlement, sistem yang membutuhkan ketentuannya di kemudian hari harus menyimpannya saat membacanya, atau merekonstruksinya dari transaksi yang membuat trade tersebut.

Token yang didukung

Sebuah trade dapat memasangkan leg SPL Token dengan leg Token-2022; setiap leg membawa token program-nya sendiri. Leg Wrapped SOL didukung.

Ekstensi Token-2022 pada mint suatu legPerilaku program
TransferFee, InterestBearing, ScaledUiAmount, NonTransferableDitolak saat Create dan Settle dengan BlockedMintExtension
PermanentDelegate, Pausable, DefaultAccountState, freeze authority, MintCloseAuthorityDiterima; setiap authority dapat bertindak atas token yang di-escrow
ConfidentialTransferDiterima; jumlah pada leg tersebut bersifat publik
TransferHookDidukung, hingga 32 akun tambahan per leg
MemoTransfer pada akun tujuan atau pengembalian danaDiterima; program mengirimkan memo yang diperlukan sebelum transfer

Biaya transfer akan membuat pihak penerima menerima kurang dari jumlah yang disepakati. Interest Bearing dan Scaled UI Amount tidak mengubah jumlah mentah, tetapi rate atau multiplier-nya dapat berubah antara pembuatan dan settlement trade, sehingga mengubah tampilan jumlah yang disepakati. NonTransferable akan membuat kedua leg terkunci.

Authority yang diterima dapat memindahkan, membekukan, atau menghentikan token yang di-escrow selama trade berlangsung (lihat di bawah). Escrow tidak dapat dikonfigurasi untuk menerima transfer rahasia, sehingga jumlah yang di-escrow dan di-settle pada leg confidential bersifat publik.

Untuk mint dengan hook, klien me-resolve akun tambahan milik hook dan menambahkannya ke Settle, Cancel, Reject, Reclaim, dan Recover. Batas 32 per leg mencakup program hook dan akun validasinya. Jika hook authority memperbesar daftar akun hook melebihi batas tersebut, setiap transfer pada leg itu gagal, termasuk Reclaim, Cancel, Reject, dan Recover, hingga authority membatalkannya. Batas akun transaksi dapat tercapai lebih dulu sebelum batas per leg ketika kedua leg memiliki hook.

Ketika akun tujuan atau pengembalian dana mewajibkan memo, program memanggil program Memo sebelum transfer, itulah sebabnya setiap instruksi yang memindahkan token keluar dari escrow menerima akun memo_program.

Batasan konfigurasi mint

Scaled UI Amount. Template tokenized-security di Mosaic, toolkit penerbitan milik Solana Foundation, selalu menambahkan Scaled UI Amount, sehingga program tidak menerima mint yang dibuat dari template tersebut sebagai leg. Mint yang ditujukan untuk program ini dapat dibuat tanpa ekstensi tersebut (lihat Token Extensions); DvP menggunakan delegasi di-settle melalui authority yang didelegasikan dan tidak menerapkan pemeriksaan ini.

Mint yang dibekukan secara default. Escrow setiap trade adalah associated token account yang dimiliki oleh program-derived address yang baru untuk trade tersebut. Pada mint dengan Default Account State diatur ke frozen, escrow dibuat dalam keadaan beku, dan transfer pendanaan ke dalamnya gagal hingga dicairkan (thaw). Di bawah Token ACL, artinya penerbit atau transfer agent-nya harus mengizinkan escrow trade sebelum didanai: baik dengan menambahkan alamat catatan trade (pemilik escrow) ke allowlist, sehingga siapa pun dapat men-thaw escrow di mana konfigurasi Token ACL mint mengaktifkan permissionless thaw, atau dengan meminta freeze authority men-thaw-nya secara langsung. Escrow yang beku juga memblokir Settle, Reclaim, Cancel, Reject, dan Recover pada leg tersebut, sehingga freeze authority, dan pada mint dengan hook adalah hook authority, menjadi pihak tepercaya selama masa berlaku trade. Jalur escrow beku dijelaskan di sini dan tidak dijalankan dalam cuplikan devnet.

Batasan

  • Tidak ada pencocokan, penemuan harga, atau order book. Para pihak menyepakati ketentuan di luar ledger dan salah satunya mencatatnya.
  • Tidak ada netting, dan hanya bilateral: satu catatan adalah satu trade antara dua pihak.
  • Tidak ada partial fill. Settle memindahkan tepat jumlah yang disepakati dari setiap leg dan mengembalikan kelebihan apa pun kepada pihak dari leg tersebut.
  • Tidak ada leg di luar ledger. Kedua leg adalah token account di Solana; leg tunai pada rel yang sudah ada di-settle secara terpisah dan direkonsiliasi.
  • Tidak ada pemeriksaan kelayakan, allowlist, atau KYC. Kontrol milik mint itu sendiri yang menegakkan kelayakan pemegang.
  • Tidak ada settlement otomatis. Settlement authority harus menandatangani.
  • Tidak ada event, dan tidak ada biaya protokol selain biaya transaksi dan rent.

Program ini menghilangkan risiko principal antara kedua pihak: tidak ada leg yang berpindah kecuali keduanya berpindah. Program ini tidak menghilangkan risiko kredit penerbit atau risiko penebusan pada kedua token, kemampuan freeze, pause, atau permanent delegate authority suatu mint untuk bertindak atas token yang di-escrow (lihat token yang didukung), maupun ketergantungan pada ketersediaan settlement authority untuk menandatangani.

Verifikasi sebelum pendanaan dan settlement

CreateDvp bersifat permissionless: hanya payer yang menandatangani, sedangkan para pihak dan settlement authority tidak. Karena itu siapa pun dapat membuat catatan yang menyebutkan pihak dan ketentuan apa pun. Sebelum pendanaan, dan lagi sebelum settlement, baca akun SwapDvp dan pastikan:

  1. Akun dimiliki oleh program DvP dan berukuran tepat 458 byte. Akun yang tidak dimiliki oleh program dapat diisi dengan byte yang dapat didekode seperti catatan asli.
  2. user_a, user_b, mint_a, mint_b, dan settlement_authority sesuai dengan trade yang disepakati.
  3. amount_a, amount_b, expiry_timestamp, dan earliest_settlement_timestamp sesuai dengan ketentuan yang disepakati.
  4. Kedua tujuan settlement adalah alamat yang disepakati. Catatan palsu dapat mengalihkan dana hasil.

Danai kedua leg mencantumkan checked reader dari klien yang dihasilkan dan menunjukkan pemeriksaannya dalam kode.

Anggap trade telah di-settle ketika transaksi Settle mencapai finalized. Itu adalah tingkat commitment jaringan; apakah ini juga menandai finalitas settlement untuk tujuan hukum bergantung pada perjanjian para pihak dan rezim yang berlaku.

Pembuatan versi

Akun SwapDvp tidak memiliki field versi. Tata letaknya tetap pada 458 byte (SwapDvp::LEN), dan checked reader menolak akun dengan panjang lain. IDL memiliki versinya sendiri, 0.1.0 per 2 Oktober 2026.

Program ini dapat di-upgrade di kedua cluster (lihat Program ID). Catatan trade hanya ada hingga di-settle, dibatalkan, atau ditolak, jadi periksa repositori untuk mengetahui bagaimana upgrade memperlakukan trade yang masih terbuka, dan buat ulang klien dari IDL build yang di-deploy.

Repositori dan audit

Source, IDL, klien yang dihasilkan, dan pengujian ada di solana-foundation/dvp dengan lisensi MIT. Program ini adalah program Pinocchio no_std; klien dihasilkan dari IDL dengan Codama. Laporan kerentanan disampaikan melalui tautan security advisory repositori, sesuai SECURITY.md-nya.

Program ini telah diaudit oleh Cantina.

Terkait

Is this page helpful?

Daftar Isi

Edit Halaman
© 2026 Yayasan Solana. Semua hak dilindungi.