完成交易结算

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 userA
const destinationB = t.userBSettlementDestination; // defaults to userB
const [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?

Table of Contents

Edit Page
©️ 2026 Solana 基金会版权所有