CreateDvp は取引条件を記録し、当事者が資金を入れる2つのエスクローアカウントを作成します。トークンの移動は一切行いません。誰でも送信できるため、レコードは取引相手、決済オーソリティのオペレーター、または第三者から作成される可能性があり、他のすべての参加者は、保存された条件に基づいて行動する前にその内容を検証します(各レッグへの入金を参照)。
スニペットでは、関係するアカウントと署名者が分かるように、プレースホルダーアドレスを使って生成されたクライアントを直接使用します。対象は devnet で、プログラムは mainnet-beta と同じアドレスにデプロイされています。
インストール
2026年10月2日時点で、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 に基づいて書かれており、TypeScript では @solana/kit 8、Rust では solana-* 2.x クレートを使用しています。
各ステップページのスニペットは引き継がれます。各ページでは、前のページで定義したクライアント、署名者、アドレスを使用します。payerSigner、userASigner、userBSigner、authoritySigner は、それぞれ rent の支払者、2人の当事者、決済オーソリティの TransactionSigner で、たとえば createKeyPairSignerFromBytes から取得します。Rust のスニペットは instructions を構築するだけで、署名と送信は呼び出し側に任せます。
アドレスを導出する
取引レコードは、決済オーソリティ、2人の当事者、2つのミント、およびnonceから導出される Program Derived Address です。各エスクローは、いずれかのミントに対するレコードの associated token account です。どちらの導出もネットワークアクセスは不要です。
取引ごとにランダムな64ビットのnonceを使用してください。作成にはパーミッションが不要なため、nonceが予測可能だと、第三者が取引で使う予定だったアドレスを先に占有できてしまいます。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 は、基本単位の2つの金額、有効期限、nonce、および4つのオプションフィールド(最大64バイトの不透明な参照、各当事者の決済先、最早決済時刻。注意事項を参照)を受け取ります。決済先とは、決済時にその当事者の受取分が送られる先で、たとえばカストディアンの入金用ウォレットです。デフォルトは当事者自身のアドレスで、レコードが作成された後は変更できません。返金と回収は、エスクローに誰が入金したかにかかわらず、決済先ではなく常に、そのレッグのミントに対する当事者自身の token account に送られます。
支払者は、レコード、nonceトゥームストーン、および両方のエスクローの rent を負担します。クローズ時には、その rent は支払者ではなく、クローズ用の instruction に署名した人に渡ります。トゥームストーンは決してクローズされないため、取引ごとに少額の残高が永続的に残ります。支払者の 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 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のスニペットでは、@solana/kit の getProgramDerivedAddress と getAddressEncoder、およびクライアントの DVP_SWAP_PROGRAM_PROGRAM_ADDRESS をスコープ内に用意しておく必要があります。Rustのビルダーでは、System Program と Associated Token Program はデフォルトのままになります。
注意事項
- 有効期限。 有効期限を確認するのはSettleのみです。Reclaim、Cancel、Rejectは期限後も実行できます。また、期限後に入金されたデポジットは、そのレッグの当事者が回収できます。有効期限は、作成から最長1年後までに設定できます。
- 時間はネットワーク時間です。 プログラムはオンチェーンのクロックを読み取ります。これは実際の時刻と異なる場合があり、数十秒ずれることもあれば、前方に飛ぶこともあります。有効期限と意図する決済時刻の間には余裕を持たせ、どちらの境界付近でも入金や決済を避け、秒単位の期限を強制する目的で有効期限に頼らないでください。プログラムのREADMEでは、約1分のずれを見込むことを推奨しています。
- 最早決済時刻。 オプションです。設定した場合、その時刻より前のSettleは拒否されます。有効期限より後の時刻は設定できません。
- 作成時のチェック。 当事者が System Program 所有のアカウントでない場合(これにより SPL Token マルチシグは除外されます)は
PartyNotSignerCapableで、そのほかSettlementDestinationIsSwapDvp、SelfDvp、SameMint、ZeroAmount、SettlementAuthorityIsParty、ExpiryNotInFutureの場合も、Createは失敗します。完全な一覧はエラー表にあります。
次のステップ
- 各レッグへの入金: 各当事者が自分のレッグを取引のエスクローに転送します
Is this page helpful?