Utwórz transakcję

CreateDvp zapisuje warunki transakcji i tworzy dwa konta escrow, które strony zasilą środkami. Nie przenosi żadnych tokenów. Może go wysłać każdy, więc rekord może pochodzić od kontrahenta, operatora organu rozliczeniowego lub strony trzeciej, a każdy inny uczestnik weryfikuje zapisane warunki, zanim na ich podstawie zadziała (zob. Zasil legi).

Fragmenty kodu korzystają bezpośrednio z wygenerowanego klienta, z adresami zastępczymi, dzięki czemu widać, jakie konta i podpisujący są zaangażowani. Dotyczą devnetu, gdzie program jest wdrożony pod tym samym adresem co w mainnet-beta.

Instalacja

Na dzień 2 października 2026 r. nie opublikowano żadnego pakietu klientów DvP. Oba klienty są generowane z IDL programu w repozytorium i używane ze źródeł.

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

Te strony są napisane dla commita df9919e, z @solana/kit 8 w TypeScript i crate'ami solana-* 2.x w Rust.

Fragmenty kodu na każdej stronie kroku są ze sobą powiązane: każda strona korzysta z klienta, podpisujących i adresów zdefiniowanych na wcześniejszych stronach. payerSigner, userASigner, userBSigner i authoritySigner to obiekty TransactionSigner odpowiednio dla płatnika rent, obu stron i organu rozliczeniowego, np. z createKeyPairSignerFromBytes. Fragmenty w Rust budują instrukcje, a podpisywanie i wysyłanie pozostawiają wywołującemu.

Wyprowadzenie adresów

Rekord transakcji jest adresem typu Program Derived Address wyznaczonym na podstawie organu rozliczeniowego, dwóch stron, dwóch mintów i nonce. Każdy escrow to associated token account rekordu dla jednego z mintów. Obie derywacje nie wymagają dostępu do sieci.

Używaj losowego 64-bitowego nonce dla każdej transakcji. Ponieważ tworzenie nie wymaga uprawnień, przewidywalny nonce pozwala osobie trzeciej zająć adres, którego miała użyć transakcja. Przekazuj nonce i kwoty jako bigint w TypeScript; wygenerowany klient odrzuca number.

Przed uruchomieniem zastąp każdy symbol zastępczy ..._HERE prawdziwym adresem. address() waliduje base58 i zgłasza błąd dla symbolu zastępczego, a pubkey! nie skompiluje się.

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,
});

Zapis warunków

CreateDvp przyjmuje dwie kwoty w jednostkach bazowych, termin wygaśnięcia, nonce oraz cztery pola opcjonalne: nieprzejrzystą referencję o długości do 64 bajtów, miejsce docelowe rozliczenia dla każdej ze stron oraz najwcześniejszy czas rozliczenia (zob. Uwagi). Miejsce docelowe to adres, na który trafiają środki danej strony przy rozliczeniu, na przykład portfel depozytowy powiernika; domyślnie jest to własny adres strony i nie można go zmienić po utworzeniu rekordu. Zwroty i odzyskiwanie środków zawsze trafiają na własny token account strony dla mintu danego lega, nigdy na miejsce docelowe, bez względu na to, kto zasilił escrow.

Płatnik pokrywa rent za rekord, znacznik nonce (tombstone) i oba konta escrow. Przy zamknięciu ten rent trafia do osoby podpisującej instrukcję zamknięcia, a nie z powrotem do płatnika. Tombstone nigdy nie jest zamykany, więc każda transakcja zostawia niewielkie trwałe saldo. Planując budżet SOL płatnika, wyznaczaj kwoty rent metodą RPC getMinimumBalanceForRentExemption, zamiast wpisywać je na stałe.

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);

Fragment w TypeScript wymaga, aby w zakresie były dostępne getProgramDerivedAddress i getAddressEncoder z @solana/kit oraz DVP_SWAP_PROGRAM_PROGRAM_ADDRESS z klienta. Builder w Rust pozostawia System Program i Associated Token Program na wartościach domyślnych.

Uwagi

  • Wygaśnięcie. Termin wygaśnięcia sprawdza tylko Settle. Reclaim, Cancel i Reject działają po jego upływie, a depozyt, który wpłynie po wygaśnięciu, może odzyskać strona danego lega. Termin wygaśnięcia może przypadać najwyżej rok po utworzeniu.
  • Czas to czas sieci. Program odczytuje zegar onchain, który może różnić się od czasu zegarowego, czasem o dziesiątki sekund, i może skoczyć do przodu. Zostaw margines między terminem wygaśnięcia a planowanym czasem rozliczenia, unikaj zasilania lub rozliczania w pobliżu którejkolwiek z tych granic i nie polegaj na terminie wygaśnięcia do egzekwowania terminu co do sekundy. README programu sugeruje zaplanowanie około minuty dryfu.
  • Najwcześniejsze rozliczenie. Opcjonalne. Jeśli jest ustawione, Settle jest odrzucane przed tym czasem, a czas ten nie może być późniejszy niż termin wygaśnięcia.
  • Kontrole przy tworzeniu. Create kończy się błędem PartyNotSignerCapable, jeśli strona nie jest kontem należącym do systemu (wyklucza to multisig SPL Token), albo jednym z błędów: SettlementDestinationIsSwapDvp, SelfDvp, SameMint, ZeroAmount, SettlementAuthorityIsParty lub ExpiryNotInFuture. Pełna lista znajduje się w tabeli błędów.

Kolejne kroki

  • Zasil legi: każda strona przelewa swój leg do escrow transakcji

Is this page helpful?

Spis treści

Edytuj stronę