CreateDvp фиксирует условия сделки и создаёт два эскроу-аккаунта, которые
стороны будут пополнять. Токены она не перемещает. Отправить её может кто
угодно, поэтому запись может прийти от контрагента, оператора расчётного органа
или третьей стороны, а все остальные участники проверяют сохранённые условия,
прилежде чем действовать на их основе (см. пополнение сторон сделки).
В примерах напрямую используется сгенерированный клиент с адресами-заглушками, поэтому видны все задействованные аккаунты и подписанты. Они рассчитаны на devnet, где программа развёрнута по тому же адресу, что и в mainnet-beta.
Установка
По состоянию на 2 октября 2026 года пакеты для клиентов DvP не опубликованы. Оба клиента генерируются из IDL программы в репозитории и используются из исходного кода.
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
Эти страницы написаны для коммита df9919e, с @solana/kit 8 в TypeScript и
крейтами solana-* 2.x в Rust.
Фрагменты кода на страницах всех шагов продолжают друг друга: каждая страница
использует клиент, подписантов и адреса, определённые на предыдущих страницах.
payerSigner, userASigner, userBSigner и authoritySigner — это
TransactionSigner для плательщика rent, двух сторон и расчётного органа,
например полученные из createKeyPairSignerFromBytes. Rust-фрагменты собирают
инструкции, а подпись и отправку оставляют вызывающему коду.
Вычисление адресов
Запись сделки — это Program Derived Address, вычисляемый на основе расчётного органа, двух сторон, двух mint-аккаунтов и nonce. Каждый эскроу — это associated token account записи для одного из mint-аккаунтов. Для обоих вычислений доступ к сети не нужен.
Используйте для каждой сделки случайный 64-битный nonce. Поскольку создание не
требует разрешений, предсказуемый nonce позволяет третьей стороне занять адрес,
который должна была использовать сделка. Передавайте nonce и суммы как bigint
в TypeScript; сгенерированный клиент отклоняет number.
Перед запуском замените каждую заглушку ..._HERE реальным адресом.
address() проверяет base58 и выбрасывает исключение на заглушке, а pubkey!
не компилируется.
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,});
Фиксация условий
CreateDvp принимает две суммы в базовых единицах, срок действия, nonce и
четыре необязательных поля: непрозрачную ссылку размером до 64 байт, адрес
назначения расчёта для каждой стороны и самое раннее время расчёта (см.
примечания). Адрес назначения — это место, куда поступают средства этой стороны
при расчёте, например депозитный кошелёк кастодиана; по умолчанию это адрес самой
стороны, и после создания записи он не меняется. Возвраты и востребование
средств всегда направляются на token account стороны для mint этой части сделки,
а не на адрес назначения, независимо от того, кто пополнил эскроу.
Плательщик вносит rent за запись, tombstone-аккаунт nonce и оба эскроу. При
закрытии этот rent получает тот, кто подписывает инструкцию закрытия, а не
плательщик. Tombstone-аккаунт никогда не закрывается, поэтому каждая сделка
оставляет небольшой постоянный остаток. Планируя SOL плательщика, вычисляйте
суммы rent с помощью RPC-метода getMinimumBalanceForRentExemption, а не
задавайте их жёстко.
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);
Для TypeScript-фрагмента в области видимости должны быть
getProgramDerivedAddress и getAddressEncoder из @solana/kit, а также
DVP_SWAP_PROGRAM_PROGRAM_ADDRESS из клиента. Rust-билдер оставляет System
Program и Associated Token Program со значениями по умолчанию.
Примечания
- Срок действия. Срок действия проверяет только Settle. Reclaim, Cancel и Reject работают и после его истечения, а депозит, поступивший после истечения срока, может быть возвращён стороной этой части сделки. Срок действия может быть не более чем через год после создания.
- Время — это время сети. Программа считывает ончейн-часы, которые могут расходиться с реальным временем, иногда на десятки секунд, и могут скачком уходить вперёд. Оставляйте запас между сроком действия и планируемым временем расчёта, не пополняйте и не проводите расчёт вблизи любой из границ и не полагайтесь на срок действия как на способ обеспечить дедлайн с точностью до секунды. В README программы рекомендуется закладывать примерно минуту расхождения.
- Самое раннее время расчёта. Необязательно. Если оно задано, Settle до этого момента отклоняется, и оно не должно быть позже срока действия.
- Проверки при создании. Создание завершается ошибкой
PartyNotSignerCapable, если сторона не является аккаунтом, принадлежащим System Program (это исключает мультиподпись SPL Token),SettlementDestinationIsSwapDvp,SelfDvp,SameMint,ZeroAmount,SettlementAuthorityIsPartyилиExpiryNotInFuture. Полный список приведён в таблице ошибок.
Следующие шаги
- Пополнение сторон сделки: каждая сторона переводит свою часть в эскроу сделки
Is this page helpful?