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ản | Nhận | Chủ sở hữu |
|---|---|---|
userADestinationAtaB | Chân tiền mặt (amount_b) | user_a_settlement_destination |
userBDestinationAtaA | Chân tài sản (amount_a) | user_b_settlement_destination |
userAAtaA | Phần dư của chân tài sản | user_a |
userBAtaB | Phần dư của chân tiền mặt | user_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 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,}),);
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
- Hoàn tác giao dịch: thu hồi các chân đã nạp tiền khi giao dịch không được thanh toán
Is this page helpful?