Thanh toán giao dịch

SettleDvp được ký bởi settlement authority có tên trong bản ghi giao dịch. Trong một transaction, lệnh này chuyển amount_a của chân tài sản đến địa chỉ đích của bên giữ chân tiền mặt và amount_b của chân tiền mặt đến địa chỉ đích của bên giữ chân tài sản, hoàn lại phần dư ở bất kỳ escrow nào cho bên của chân đó, đồng thời đóng bản ghi và cả hai escrow. Nếu bất kỳ khoản chuyển nào không thể hoàn tất, lệnh sẽ thất bại và không có gì được chuyển đi.

Trang này tiếp nối từ tạo giao dịch và nạp tiền cho các chân; client, các signer, trade và các token account của các bên được giữ nguyên từ các bước trước.

Xác thực lại trước khi ký

Settlement authority ký transaction chuyển cả hai chân, vì vậy nó thực hiện cùng thao tác đọc như mỗi bên trước khi ký: chủ sở hữu, kích thước, các bên, mint, số lượng, thời hạn và cả hai địa chỉ đích (xem nạp tiền cho các chân). Bản thân chương trình cũng kiểm tra lại khi thanh toán rằng mỗi mint vẫn thuộc về token program đã được ghi nhận lúc tạo, không có extension bị chặn, và có cùng mint authority như khi giao dịch được tạo, do đó một mint được tạo lại với extension bị chặn, token program khác hoặc mint authority khác sẽ không thể thanh toán.

Tạo các tài khoản nhận

Settle ghi vào bốn token account mà chương trình không tạo:

Tài khoảnNhậnChủ sở hữu
userADestinationAtaBChân tiền mặt (amount_b)user_a_settlement_destination
userBDestinationAtaAChân tài sản (amount_a)user_b_settlement_destination
userAAtaAPhần dư của chân tài sảnuser_a
userBAtaBPhần dư của chân tiền mặtuser_b

Các tài khoản nhận phần dư chỉ được dùng khi một escrow chứa nhiều hơn số lượng đã thỏa thuận, nhưng bất kỳ ai nắm giữ mint đều có thể tạo ra phần dư bằng cách gửi vài đơn vị cơ sở vào escrow. Nếu tài khoản hoàn tiền không tồn tại, toàn bộ lệnh Settle sẽ thất bại, vì vậy hãy tạo cả bốn tài khoản theo kiểu idempotent trong cùng một transaction.

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

Thanh toán

legAExtrasCount cho chương trình biết có bao nhiêu tài khoản trong số các tài khoản được thêm vào sau danh sách cố định thuộc về transfer hook của chân tài sản; phần còn lại thuộc về chân tiền mặt. Với các mint không có transfer hook, hãy truyền giá trị 0 và không thêm gì. Memo program account là bắt buộc đối với lệnh này và chỉ được dùng cho các địa chỉ đích yêu cầu 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 được tạo tự động chỉ liệt kê các tài khoản cố định, vì vậy các builder được tạo không biết về các tài khoản hook. Hãy phân giải các extra account meta của từng hook mint theo cách bạn làm với một lệnh chuyển trực tiếp token đó, rồi thêm chúng vào lệnh: các tài khoản của chân tài sản trước, sau đó đến chân tiền mặt, với legAExtrasCount được đặt bằng số lượng trong nhóm đầu tiên. Trong TypeScript, hãy spread các meta đã phân giải vào mảng accounts của lệnh; trong Rust, hãy dùng add_remaining_accounts trên builder. Giới hạn là 32 tài khoản cho mỗi chân, bao gồm hook program và tài khoản xác thực; giới hạn số tài khoản của transaction có thể bị chạm trước khi cả hai chân đều có hook. Chương trình loại bỏ cờ signer khỏi mọi tài khoản được chuyển tiếp, vì vậy một hook không thể lấy được chữ ký của settlement authority qua đường này.

Ghi nhận kết quả

Hãy coi giao dịch là đã thanh toán khi transaction Settle đạt trạng thái finalized. Bản ghi và cả hai escrow không còn tồn tại sau khi thanh toán, vì vậy hệ thống cần các điều khoản về sau phải lưu chúng từ lần đọc trước khi thanh toán hoặc từ transaction tạo giao dịch. Khoản rent của các tài khoản đã đóng được chuyển cho settlement authority.

Lỗi khi thanh toán

LegNotFunded nghĩa là một escrow chứa ít hơn số lượng đã thỏa thuận; DvpExpired và SettlementTooEarly nghĩa là đã bỏ lỡ khung thời gian; MintAuthorityChanged và BlockedMintExtension nghĩa là một mint đã thay đổi sau khi tạo; RecipientAtaMismatch nghĩa là token account đích hoặc token account hoàn tiền bị thiếu hoặc không còn thuộc về chủ sở hữu và mint như mong đợi, thường là do bước tạo tài khoản ở trên đã bị bỏ qua. Trong mọi trường hợp, không có gì được chuyển đi, và các bên có thể hoàn tác, tùy thuộc vào các authority của mint (xem hoàn tác giao dịch).

Các bước tiếp theo

Is this page helpful?

Mục lục

Chỉnh sửa trang