레그에 자금 예치하기

자금 예치는 레그의 에스크로로 보내는 일반 TransferChecked이므로, 토큰 전송을 보낼 수 있는 모든 지갑이나 수탁 시스템에서 레그에 자금을 예치할 수 있습니다. 자금을 예치하기 전에 거래 레코드를 읽을 때만 DvP 클라이언트가 필요합니다. 프로그램은 결제 시점에만 에스크로 잔액을 확인하며, 전송이 반영될 때는 아무것도 검사하지 않습니다. 따라서 각 당사자는 전송하기 전에 거래 레코드를 읽어야 합니다.

이 페이지는 거래 생성에서 이어지며, 클라이언트와 서명자를 그대로 사용합니다.

조건 확인하기

레코드 생성은 누구나 할 수 있으며, 에스크로 주소는 조건과 무관하게 레코드와 민트만으로 도출됩니다. 따라서 에스크로로 보낸 전송이 합의한 적 없는 조건에 대해 반영될 수 있으며, 여기에는 상대방의 대금을 제3의 주소로 돌리는 결제 대상 주소도 포함됩니다. 자금을 예치하기 전에 SwapDvp 계정을 읽고 합의한 거래와 대조하여 확인하세요.

TypeScript의 verifySwapDvp와 Rust의 verify::decode_swap_dvp_account는 해당 계정이 DvP 프로그램 소유인지, 크기가 정확히 458바이트인지, 계정 자체의 필드에서 도출되는 주소에 위치하는지를 확인합니다(fetchSwapDvpChecked는 처음 두 가지 검사만 수행합니다). 일반 fetchSwapDvp 및 decodeSwapDvp 리더는 이 검사를 전혀 수행하지 않습니다. 당사자, 금액, 시간, 대상 주소에 대한 검사는 호출하는 쪽에서 합의한 거래와 대조하여 직접 수행해야 합니다.

import { unwrapOption } from "@solana/kit";
import { verifySwapDvp } from "./dvp";
const trade = await verifySwapDvp(client.rpc, swapDvp);
const t = trade.data;
const expectedAmountA = 1_000_000_000n;
const expectedAmountB = 998_500_000n;
const expectedEarliestSettlement: bigint | null = null; // as agreed
const expectedExpiry = 1_798_761_600n; // as agreed, unix seconds
if (
t.userA !== userA ||
t.userB !== userB ||
t.mintA !== mintA ||
t.mintB !== mintB ||
t.settlementAuthority !== settlementAuthority ||
t.tokenProgramA !== tokenProgramA ||
t.tokenProgramB !== tokenProgramB ||
t.amountA !== expectedAmountA ||
t.amountB !== expectedAmountB ||
unwrapOption(t.earliestSettlementTimestamp) !== expectedEarliestSettlement ||
t.expiryTimestamp !== expectedExpiry ||
t.userASettlementDestination !== userA ||
t.userBSettlementDestination !== userB
) {
throw new Error("Stored terms do not match the agreed trade; do not fund");
}
if (t.expiryTimestamp <= BigInt(Math.floor(Date.now() / 1000)) + 60n) {
throw new Error("Trade expires too soon to fund safely");
}

상대방 또는 결제 권한자가 레코드를 생성한 경우, 장부 외부에서 합의한 조건과 모든 필드를 비교하세요. 직접 생성했다면, 이 읽기 작업으로 레코드가 보낸 그대로 반영되었는지 확인할 수 있습니다.

에스크로로 전송하기

합의한 금액과 정확히 일치하게 레그에 자금을 예치하세요. 프로그램은 결제 금액을 amount_x로 제한하고 초과분은 레그의 당사자에게 반환하므로 초과분이 손실되지는 않지만, 결제 시점에 전송이 한 번 더 발생하며 일부 전송 훅에서는 실패할 수 있습니다(아래 참고 사항 확인).

검증 없는 Transfer가 아니라 TransferChecked를 사용하세요. Pausable처럼 mint account에 의존하는 확장 기능이 있는 Token-2022 민트는 이를 제공하지 않는 전송을 거부하며, 전송 훅이 있는 민트는 해당 토큰의 다른 전송과 마찬가지로 훅의 계정을 확인하여 추가해야 합니다.

자산 레그 당사자가 userASigner로 서명하여 에스크로 A에 자금을 예치합니다.

import {
findAssociatedTokenPda,
getTransferCheckedInstruction,
} from "@solana-program/token-2022";
const [userAAtaA] = await findAssociatedTokenPda({
mint: mintA,
owner: userA,
tokenProgram: tokenProgramA,
});
const [userBAtaB] = await findAssociatedTokenPda({
mint: mintB,
owner: userB,
tokenProgram: tokenProgramB,
});
const fundAssetLeg = getTransferCheckedInstruction({
source: userAAtaA,
mint: mintA,
destination: escrowA,
authority: userASigner,
amount: t.amountA,
decimals: 6,
}, { programAddress: tokenProgramA });
await client.sendTransaction([fundAssetLeg]);

현금 레그 당사자는 에스크로 B에 대해 userBAtaB, mintB, userBSigner, t.amountB, { programAddress: tokenProgramB }를 사용하여 동일하게 수행합니다.

confirmed 상태로 확인된 자금 예치 전송도 이후에 대체될 수 있습니다. 프로그램은 결제 시점에 온체인에서 에스크로 잔액을 읽으므로, 반영되지 않은 자금 예치 전송을 기준으로 보낸 Settle은 LegNotFunded와 함께 실패하며 아무것도 이동하지 않습니다. 비용은 실패한 Settle과 재시도뿐입니다. 전송이 finalized 상태가 되었을 때 레그에 자금이 예치된 것으로 간주하세요.

참고 사항

  • 래핑된 SOL 레그. 프로그램은 네이티브 에스크로의 잔액을 동기화한 후 읽으므로, 시스템 전송으로 래핑된 SOL 에스크로에 보낸 lamport도 합산됩니다. 다른 민트의 에스크로에는 절대 SOL을 보내지 마세요. 프로그램이 이를 반환할 수 없으며, 해당 계정을 닫는 사람에게 넘어갑니다.
  • 제한된 민트. Default Account State가 동결로 설정된 민트에서는 에스크로가 동결 상태로 생성되며, 발행자가 동결을 해제하거나 승인할 때까지 전송이 실패합니다. 개요에서 Token ACL과의 상호작용을 설명합니다.
  • 전송 훅. 훅이 있는 에스크로에는 합의한 금액과 정확히 일치하게 자금을 예치하세요. 초과분 때문에 결제 시점에 환불이 필요하면, 환불 시 레그의 훅 계정을 다른 대상과 금액으로 재사용하는데, 일부 훅은 이를 거부합니다. 복구 방법은 Reclaim을 실행하고, 정확한 금액으로 다시 자금을 예치한 뒤, 다시 결제하는 것입니다.
  • 만료 이후의 자금 예치. expiry_timestamp 이후에도 전송을 막는 장치는 없습니다. 전송은 반영되지만 결제는 더 이상 불가능하며, 레그의 당사자는 거래가 열려 있는 동안에는 Reclaim으로, 종료된 후에는 Recover로 자금을 회수합니다. 거래 되돌리기를 참조하세요.
  • 누가 먼저 자금을 예치하는가. 프로그램은 두 레그의 순서를 정하지 않습니다. 순서는 당사자들이 정할 문제이며, 민트 권한(동결, 일시 중지 또는 전송 훅)이 에스크로를 차단하지 않는 한 각 당사자는 결제 전에 언제든지 자신의 레그를 회수할 수 있습니다.

다음 단계

  • 거래 결제하기: 결제 권한자가 하나의 트랜잭션에서 두 레그를 교환합니다
  • 거래 되돌리기: 거래가 결제되지 않을 때 자금이 예치된 레그를 회수합니다

Is this page helpful?

목차

페이지 편집