트랜잭션과 수수료

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

트랜잭션 구조

• 메시지: 명령어의 순서 목록, 참조하는 계정, 최근 블록해시입니다.
• 서명: 각 서명자마다 하나씩, 트랜잭션이 승인되었음을 증명합니다.
• 최근 블록해시: 트랜잭션이 최근 것임을 증명합니다. 오래된 블록해시(150개 슬롯 이상 지난)를 가진 트랜잭션은 거부됩니다.

​

명령어

• program_id — 호출할 프로그램입니다.
• accounts — 프로그램이 접근할 수 있는 계정(그리고 쓰기 가능/서명자 플래그)입니다.
• data — 프로그램이 해석하는 불투명한 바이트입니다.

1. ComputeBudget::SetComputeUnitLimit — 기본 CU 한도를 높입니다.
2. ComputeBudget::SetComputeUnitPrice — 우선순위 수수료를 설정합니다.
3. 선택사항 CreateAssociatedTokenAccount — 사용자가 없으면 출력 ATA를 생성합니다.
4. Raydium::SwapBaseInput — 스왑을 실행합니다.
5. 선택사항 CloseAccount — 래핑된 SOL ATA를 닫습니다.

​

트랜잭션의 계정

• 서명자 / 비서명자: 계정의 소유자가 트랜잭션에 서명해야 합니까?
• 쓰기 가능 / 읽기 전용: 트랜잭션이 계정을 수정할 수 있습니까?

​

트랜잭션 크기 제한

​

주소 조회 테이블 (ALTs)

• 20개 계정을 직접 참조하는 트랜잭션: ~640 B의 공개 키.
• ALT를 사용하는 동일한 트랜잭션: ~20 B의 인덱스 + ALT 참조.

import { VersionedTransaction } from "@solana/web3.js";

// SDK는 ALT 참조를 포함한 v0(버전화된) tx를 구축합니다
const { transaction } = await raydium.trade.swap({ /* ... */ });
// transaction은 VersionedTransaction이지, 레거시 Transaction이 아닙니다.

​

컴퓨트 예산

• 기본값: 트랜잭션당 200,000 CU입니다.
• 최대값: 트랜잭션당 1,400,000 CU입니다(ComputeBudget::SetComputeUnitLimit을 통해 상향 가능).
• 블록당 상한: 블록당 48M CU(프로토콜 수준).

import { ComputeBudgetProgram } from "@solana/web3.js";

tx.add(
  ComputeBudgetProgram.setComputeUnitLimit({ units: 300_000 }),
);

​

우선순위 수수료

priority_fee = compute_unit_price (micro-lamports) × compute_unit_limit

tx.add(
  ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 10_000 }),
);

​

명령어 개수 및 계정 개수 제한

• 트랜잭션당 최대 계정: 128입니다.
• 명령어당 최대 계정 (CPI): 64입니다.
• 트랜잭션당 최대 명령어: 하드 한도는 없으며, 크기 한도로만 제한됩니다.
• 최대 CPI 깊이: 4입니다(프로그램은 다른 프로그램을 호출할 수 있으며, 이는 4단계까지 중첩될 수 있습니다).

​

Raydium 스왑의 수수료 범주

​

Solana 네트워크 수수료

• 기본 서명 수수료: 서명당 5000 라모포트입니다. 거의 항상 1 서명 = 0.000005 SOL입니다.
• 우선순위 수수료: CU 가격 × CU 한도(마이크로라모포트). 혼잡도에 따라 다릅니다. integration-guides/priority-fee-tuning을 참조하세요.

​

Raydium 프로토콜 수수료

• 스왑 수수료: 입력의 백분율입니다(CPMM 일반적으로 0.25%, CLMM 등급당 0.01%–1%). LP와 프로토콜 목적지 사이에 분할됩니다. ray/protocol-fees를 참조하세요.

​

예: CPMM 0.25% 등급을 통해 $1000 USDC → SOL

​

버전화된 트랜잭션

• 레거시: 원본 형식, ALT 지원 없음.
• v0 (버전화됨): ALT 지원, 향후 버전으로 확장 가능.

// v0 tx를 직접 구축합니다
import { VersionedTransaction, TransactionMessage } from "@solana/web3.js";

const msg = new TransactionMessage({
  payerKey:        owner.publicKey,
  recentBlockhash: blockhash,
  instructions:    [ /* ... */ ],
}).compileToV0Message([lookupTableAccount]);

const tx = new VersionedTransaction(msg);
tx.sign([owner]);

​

블록해시 신선도

async function sendWithRetry(tx, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
    tx.message.recentBlockhash = blockhash;
    tx.sign([owner]);
    try {
      return await connection.sendRawTransaction(tx.serialize());
    } catch (e) {
      if (i === maxRetries - 1) throw e;
    }
  }
}

​

병렬 실행

• 동일한 풀의 두 스왑은 병렬로 실행될 수 없습니다. 둘 다 풀 상태에 씁니다.
• 풀 A의 스왑과 풀 B의 스왑은 계정 목록이 겹치지 않으면 병렬로 실행됩니다.
• 읽기 전용 트랜잭션은 동일한 계정에서 쓰기 프로그램을 절대 차단하지 않습니다(읽기 전용은 자신과 동시에 실행되지만 쓰기와는 동시에 실행되지 않음).

​

트랜잭션 확인 수준

await connection.sendAndConfirmTransaction(tx, [owner], {
  commitment: "confirmed",
});

​

시뮬레이션

const sim = await connection.simulateTransaction(tx);
console.log(sim.value.logs);
console.log(sim.value.unitsConsumed);

​

참고 자료

• solana-fundamentals/account-model — 트랜잭션의 계정.
• solana-fundamentals/pdas-and-cpis — 프로그램이 서로를 호출하는 방법.
• integration-guides/priority-fee-tuning — CU 한도 및 우선순위 수수료 조정.
• ray/protocol-fees — Raydium 프로토콜 수수료 구조.

• Solana Transaction docs.
• Address Lookup Tables proposal.
• Compute budget documentation.