트레이드 생성

CreateDvp는 트레이드 조건을 기록하고 당사자들이 자금을 넣을 두 개의 에스크로 계정을 생성합니다. 토큰은 전혀 이동하지 않습니다. 누구나 이 명령을 보낼 수 있으므로, 레코드는 상대방, 정산 권한(settlement authority)의 운영자, 또는 제3자가 만들 수 있으며, 다른 모든 참여자는 저장된 조건을 확인한 후에 진행해야 합니다 (레그 펀딩하기 참고).

스니펫은 생성된 클라이언트를 직접 사용하며 주소는 플레이스홀더로 되어 있어, 관련된 계정과 서명자를 한눈에 볼 수 있습니다. 대상은 devnet이며, 프로그램은 mainnet-beta와 같은 주소에 배포되어 있습니다.

설치

2026년 10월 2일 기준으로 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를 기준으로 작성되었으며, TypeScript는 @solana/kit 8, Rust는 solana-* 2.x 크레이트를 사용합니다.

모든 단계 페이지의 스니펫은 이어집니다. 각 페이지는 이전 페이지에서 정의한 클라이언트, 서명자, 주소를 사용합니다. payerSigner, userASigner, userBSigner, authoritySigner는 각각 rent 납부자, 두 당사자, 정산 권한을 나타내는 TransactionSigner이며, 예를 들어 createKeyPairSignerFromBytes로 만들 수 있습니다. Rust 스니펫은 instruction을 구성하기만 하고 서명과 전송은 호출자에게 맡깁니다.

주소 파생

트레이드 레코드는 정산 권한, 두 당사자, 두 mint, 그리고 nonce를 기반으로 한 program-derived address입니다. 각 에스크로는 해당 레코드의 mint 중 하나에 대한 associated token account입니다. 두 파생 모두 네트워크 접근이 필요하지 않습니다.

트레이드마다 무작위 64비트 nonce를 사용하세요. 생성에 별도의 권한이 필요 없기 때문에, 예측 가능한 nonce를 쓰면 제3자가 트레이드가 사용하려던 주소를 선점할 수 있습니다. TypeScript에서는 nonce와 금액을 bigint로 전달하세요. 생성된 클라이언트는 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는 기본 단위(base units)의 두 금액, 만료 시각, nonce, 그리고 네 개의 선택 필드를 받습니다. 선택 필드는 최대 64바이트의 불투명한 참조값, 각 측의 정산 목적지, 그리고 가장 이른 정산 시각입니다(참고 사항 참조). 정산 목적지는 정산 시 해당 당사자의 수령액이 도착하는 곳으로, 예를 들어 수탁기관의 입금 지갑입니다. 기본값은 당사자 본인의 주소이며 레코드가 생성되면 변경할 수 없습니다. 환불과 회수는 에스크로에 누가 자금을 넣었든 항상 해당 레그의 mint에 대한 당사자 본인의 token account로 가며, 목적지로는 가지 않습니다.

payer는 레코드, nonce tombstone, 두 에스크로의 rent를 부담합니다. 종료 시 이 rent는 payer가 아니라 종료 instruction에 서명한 사람에게 돌아갑니다. tombstone은 닫히지 않으므로 트레이드마다 소액의 잔액이 영구적으로 남습니다. payer의 SOL 예산을 책정할 때는 rent 금액을 하드코딩하지 말고 getMinimumBalanceForRentExemption RPC 메서드로 구하세요.

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 스니펫을 사용하려면 @solana/kit의 getProgramDerivedAddress와 getAddressEncoder, 그리고 클라이언트의 DVP_SWAP_PROGRAM_PROGRAM_ADDRESS가 스코프에 있어야 합니다. Rust 빌더는 system program과 associated token program을 기본값 그대로 둡니다.

참고 사항

  • 만료. 만료 시각을 확인하는 것은 Settle뿐입니다. Reclaim, Cancel, Reject는 만료 후에도 동작하며, 만료 후에 들어온 입금은 해당 레그의 당사자가 회수할 수 있습니다. 만료 시각은 생성 시점으로부터 최대 1년 이내로 설정할 수 있습니다.
  • 시간은 네트워크 시간입니다. 프로그램은 온체인 클록을 읽으며, 이는 실제 시계 시간과 때로는 수십 초까지 차이가 날 수 있고 앞으로 건너뛸 수도 있습니다. 만료 시각과 의도한 정산 시각 사이에 여유를 두고, 어느 경계 근처에서도 자금 입금이나 정산을 피하며, 만료 시각으로 초 단위의 마감을 강제하는 데 의존하지 마세요. 프로그램 README는 약 1분의 오차를 감안할 것을 권장합니다.
  • 가장 이른 정산 시각. 선택 사항입니다. 설정하면 그 시각 이전의 Settle은 거부되며, 만료 시각보다 늦어서는 안 됩니다.
  • 생성 시 검증. 당사자가 시스템 소유 계정이 아니면(SPL Token 멀티시그는 허용되지 않습니다) Create는 PartyNotSignerCapable로 실패하며, 그 외에도 SettlementDestinationIsSwapDvp, SelfDvp, SameMint, ZeroAmount, SettlementAuthorityIsParty, ExpiryNotInFuture로 실패할 수 있습니다. 전체 목록은 오류 표에 있습니다.

다음 단계

  • 레그 펀딩하기: 각 당사자가 자신의 레그를 트레이드의 에스크로로 전송합니다

Is this page helpful?

목차

페이지 편집