Создание сделки

CreateDvp фиксирует условия сделки и создаёт два эскроу-аккаунта, которые стороны будут пополнять. Токены она не перемещает. Отправить её может кто угодно, поэтому запись может прийти от контрагента, оператора расчётного органа или третьей стороны, а все остальные участники проверяют сохранённые условия, прилежде чем действовать на их основе (см. пополнение сторон сделки).

В примерах напрямую используется сгенерированный клиент с адресами-заглушками, поэтому видны все задействованные аккаунты и подписанты. Они рассчитаны на devnet, где программа развёрнута по тому же адресу, что и в mainnet-beta.

Установка

По состоянию на 2 октября 2026 года пакеты для клиентов DvP не опубликованы. Оба клиента генерируются из IDL программы в репозитории и используются из исходного кода.

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

Эти страницы написаны для коммита 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 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);

Для 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?

Содержание

Редактировать страницу