SettleDvp 由交易记录中指定的结算授权方签名。它在一笔交易中将 amount_a 的资产腿转入现金腿参与方的目标账户,将 amount_b 的现金腿转入资产腿参与方的目标账户,把任一托管账户中的剩余部分退还给该腿对应的参与方,并关闭交易记录和两个托管账户。如果其中任何一笔转账无法完成,该指令会失败,且不会有任何资金移动。
本页承接创建交易和为两条腿注资;客户端、签名者、trade 以及参与方的 token account 均沿用之前的内容。
签名前重新验证
结算授权方签署的交易会转移两条腿的资金,因此在签名之前,它要像各参与方一样执行相同的读取检查:所有者、大小、参与方、mint、金额、到期时间以及两个目标账户(参见为两条腿注资)。程序本身在结算时还会再次检查:每个 mint 是否仍属于创建时记录的 token program,是否不含被禁止的扩展,以及 mint 权限是否与交易创建时相同。因此,如果 mint 被重新创建并带有被禁止的扩展、使用了不同的 token program 或不同的 mint 权限,则无法结算。
创建接收方账户
Settle 会写入四个程序不会创建的 token account:
| 账户 | 接收内容 | 所有者 |
|---|---|---|
userADestinationAtaB | 现金腿(amount_b) | user_a_settlement_destination |
userBDestinationAtaA | 资产腿(amount_a) | user_b_settlement_destination |
userAAtaA | 资产腿上的任何剩余部分 | user_a |
userBAtaB | 现金腿上的任何剩余部分 | user_b |
只有当托管账户中的金额超过约定金额时,才会用到剩余部分账户,但任何持有该 mint 的人只需向托管账户转入几个最小单位,就能制造出剩余。如果退款账户不存在,整个 Settle 都会失败,因此请在同一笔交易中以幂等方式创建全部四个账户。
import {findAssociatedTokenPda,getCreateAssociatedTokenIdempotentInstruction,} from "@solana-program/token-2022";const destinationA = t.userASettlementDestination; // defaults to userAconst destinationB = t.userBSettlementDestination; // defaults to userBconst [userADestinationAtaB] = await findAssociatedTokenPda({mint: mintB,owner: destinationA,tokenProgram: tokenProgramB,});const [userBDestinationAtaA] = await findAssociatedTokenPda({mint: mintA,owner: destinationB,tokenProgram: tokenProgramA,});// userAAtaA and userBAtaB are from fund the legs.const createRecipientAccounts = [{ ata: userADestinationAtaB, owner: destinationA, mint: mintB, tokenProgram: tokenProgramB },{ ata: userBDestinationAtaA, owner: destinationB, mint: mintA, tokenProgram: tokenProgramA },{ ata: userAAtaA, owner: userA, mint: mintA, tokenProgram: tokenProgramA },{ ata: userBAtaB, owner: userB, mint: mintB, tokenProgram: tokenProgramB },].map(({ ata, owner, mint, tokenProgram }) =>getCreateAssociatedTokenIdempotentInstruction({payer: authoritySigner,ata,owner,mint,tokenProgram,}),);
Settle
legAExtrasCount 用于告知程序:在固定列表之后追加的账户中,有多少个属于资产腿的 transfer hook,其余的则属于现金腿。对于没有 transfer hook 的 mint,传入零且不追加任何账户。memo program account 是该指令所必需的,仅用于要求附带 memo 的目标账户。
import { MEMO_PROGRAM_ADDRESS } from "@solana-program/memo";import { getSettleDvpInstruction } from "./dvp";const settleInstruction = getSettleDvpInstruction({settlementAuthority: authoritySigner,swapDvp,mintA,mintB,dvpAtaA: escrowA,dvpAtaB: escrowB,userADestinationAtaB,userBDestinationAtaA,userAAtaA,userBAtaB,tokenProgramA,tokenProgramB,memoProgram: MEMO_PROGRAM_ADDRESS,legAExtrasCount: 0,});const { context: settleContext } = await client.sendTransaction([...createRecipientAccounts,settleInstruction,]);const settleSignature = settleContext.signature;console.log("Submitted:", settleSignature);// sendTransaction returns at the client's commitment (confirmed by default).// Wait for finalized before recording the trade as settled.let finalized = false;for (let attempt = 0; attempt < 30 && !finalized; attempt++) {const {value: [status],} = await client.rpc.getSignatureStatuses([settleSignature]).send();if (status?.err) {throw new Error("Settle transaction failed");}finalized = status?.confirmationStatus === "finalized";if (!finalized) {await new Promise((resolve) => setTimeout(resolve, 2_000));}}if (!finalized) {// A closed record means it settled; an open one is safe to settle again.throw new Error("Settle not finalized after 60s; read the trade record");}console.log("Settled:", settleSignature);
Transfer hook
生成的 IDL 只列出固定账户,因此生成的构建器并不了解 hook 账户。请按照直接转账该 token 时的方式,解析每个 hook mint 的额外账户元数据(extra account metas),然后将其追加到指令中:先是资产腿的账户,再是现金腿的账户,并将 legAExtrasCount 设为第一组的数量。在 TypeScript 中,将解析出的 metas 展开到指令的 accounts 数组中;在 Rust 中,使用构建器上的 add_remaining_accounts。每条腿的上限为 32 个账户,包括 hook 程序和验证账户;当两条腿都带有 hook 时,交易的账户数量限制可能会先达到上限。程序会从每个转发的账户中去除签名者标志,因此 hook 无法通过这条路径获取结算授权方的签名。
记录结果
当 Settle 交易达到 finalized 状态时,才可将该交易视为已结算。结算后,交易记录和两个托管账户都不再存在,因此之后需要这些条款的系统,应从结算前的读取结果或创建交易中保存它们。已关闭账户的 rent 已归结算授权方所有。
Settle 错误
LegNotFunded 表示某个托管账户中的金额少于其约定金额;DvpExpired 和 SettlementTooEarly 表示错过了时间窗口;MintAuthorityChanged 和 BlockedMintExtension 表示某个 mint 在创建之后发生了变化;RecipientAtaMismatch 表示目标账户或退款 token account 缺失,或者不再属于预期的所有者和 mint,通常是因为跳过了上面的账户创建步骤。在所有这些情况下,都不会有任何资金移动,参与方可以撤销交易,但需受 mint 权限的约束(参见撤销交易)。
后续步骤
- 撤销交易:当交易未能结算时,收回已注资的两条腿
Is this page helpful?