Solana 과거 계정 API (베타)

과거 계정 상태란 무엇인가요?

• 감사, 회계 또는 세금 신고를 위해 특정 시점의 지갑 토큰 잔액 확인
• 트랜잭션이 실행되기 직전과 직후에 접근한 계정을 읽어 트랜잭션 디버깅
• 원장을 직접 재실행하지 않고 과거 슬롯 시점의 풀, 볼트, 오라클 같은 프로토콜 계정 읽기

어떤 메서드를 사용해야 하나요?

제공 여부 및 가격

• 플랜: Business 플랜 이상.
• 비용: 베타 기간에는 호출당 0크레딧입니다(가격은 변경될 수 있음).
• 요청 속도 제한: getHistoricalAccountInfo는 초당 100개의 요청을 허용하며 최대 버스트는 100입니다. getHistoricalTokenAccountsByOwner는 초당 10개의 요청을 허용하며 최대 버스트는 10입니다. 이 제한은 플랜의 RPC 요청 속도 제한과 별개이며, 이를 초과한 요청은 HTTP 429을 반환합니다. 요청 속도 제한을 참조하세요.
• 네트워크: 메인넷에서만 사용할 수 있습니다. 표준 메인넷 엔드포인트인 https://mainnet.helius-rpc.com 또는 Gatekeeper 엔드포인트인 https://beta.helius-rpc.com에서 호출하세요. 데브넷은 오류 -32601을 반환합니다.

데이터 범위

기록상 위치 선택

트랜잭션 전후의 상태 읽기

• 트랜잭션 이후: 해당 트랜잭션 자체의 slot 및 transactionIndex를 쿼리합니다.
• 트랜잭션 이전: 동일한 slot와 트랜잭션의 transactionIndex에서 1을 뺀 값을 쿼리합니다. 트랜잭션이 해당 슬롯의 첫 번째 트랜잭션(인덱스 0)이면 transactionIndex 없이 이전 슬롯을 쿼리합니다.

# State of the account right after the transaction at index 10 in slot 445000000
curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getHistoricalAccountInfo",
    "params": [
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      { "slot": 445000000, "transactionIndex": 10 },
      { "encoding": "jsonParsed" }
    ]
  }'

lastUpdatedAt 이해하기

"lastUpdatedAt": { "slot": 444999837, "transactionIndex": 700 }

• **slot 및 transactionIndex**는 쿼리한 위치 또는 그 이전의 마지막 쓰기를 가리킵니다. 위 예시에서는 슬롯 445,000,000에 대한 쿼리가 슬롯 444,999,837에서 인덱스 700인 트랜잭션이 마지막으로 쓴 상태를 반환했습니다.
• **transactionIndex: null**는 에포크 보상처럼 쓰기가 트랜잭션 외부에서 발생했다는 의미입니다.
• **transactionIndex: null가 포함된 slot: 444959999**는 기록 범위가 시작된 이후 계정이 변경되지 않았다는 의미입니다. 해당 슬롯에서 계정이 작성되었다는 의미는 아닙니다.

null 값의 의미

• null 응답에는 lastUpdatedAt가 없습니다. 따라서 계정이 생성되거나 닫힌 시점을 알 수 없습니다. 해당 트랜잭션을 찾으려면 getTransactionsForAddress를 사용하세요.
• 존재한 적이 없는 주소도 오류가 아닌 null를 반환합니다.
• 기록 범위보다 이전의 슬롯은 계정 존재 여부와 관계없이 모든 주소에 대해 오류 -32018을 반환합니다.

계정 기록을 역순으로 탐색하기

const url = `https://mainnet.helius-rpc.com/?api-key=${process.env.HELIUS_API_KEY}`;
const COVERAGE_START_SLOT = 444959999;

type Position = { slot?: number; transactionIndex?: number };

async function getAccountHistory(address: string, start: Position = {}, maxStates = 100) {
  const states = [];
  let position = start;

  while (states.length < maxStates) {
    const response = await fetch(url, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        jsonrpc: "2.0",
        id: "1",
        method: "getHistoricalAccountInfo",
        params: [address, position, { encoding: "base64" }],
      }),
    });
    const { result, error } = await response.json();
    if (error) throw new Error(`${error.code}: ${error.message}`);

    const account = result.value;
    if (!account) break; // The account didn't exist before this write

    states.push(account);
    const { slot, transactionIndex } = account.lastUpdatedAt;
    if (slot <= COVERAGE_START_SLOT) break; // Reached the start of history coverage

    // Step to the position just before this write
    position = transactionIndex ? { slot, transactionIndex: transactionIndex - 1 } : { slot: slot - 1 };
  }

  return states; // Newest first
}

• 현재 닫힌 계정은 최신 슬롯에서 null를 반환합니다. 계정이 아직 존재했던 시점의 start 위치를 전달하세요.
• 비트랜잭션 쓰기는 이전 슬롯으로 이동합니다. 해당 슬롯의 앞부분에서 트랜잭션이 동일한 계정에 쓰기도 했다면 탐색 시 그 상태를 건너뜁니다.
• 시간순으로 탐색하려면 getTransactionsForAddress 및 sortOrder: "asc"를 사용하여 계정의 트랜잭션을 오래된 순서대로 나열하세요. 그런 다음 각 트랜잭션의 slot 및 transactionIndex에서 상태를 읽습니다.

응답 컨텍스트

일관된 페이지네이션

• paginationKey를 다시 전달하여 구성 객체에서 다음 페이지를 가져오세요.
• paginationKey가 null일 때만 중지하세요. 페이지가 짧거나 비어 있어도 뒤에 결과가 더 있을 수 있습니다.
• 모든 페이지에서 slot를 고정하세요. slot를 생략하면 각 페이지가 최신 인덱싱 슬롯을 읽으므로 페이지마다 서로 다른 시점의 데이터가 반환될 수 있습니다.
• limit를 1~5,000 사이로 설정하세요. 기본값은 5,000입니다.

인코딩 및 파싱된 데이터

• 지원되는 인코딩은 base64(기본값), base64+zstd 및 jsonParsed입니다. base58 및 binary는 지원되지 않습니다.
• jsonParsed 토큰 계정은 쿼리한 위치 시점의 민트 소수 자릿수를 사용하므로 이후 민트가 변경되었더라도 수량이 정확합니다. 해당 위치에서 민트를 읽을 수 없으면 계정은 base64로 대체됩니다.
• **dataSlice**는 getAccountInfo에서와 동일하게 작동합니다.

확정 수준

오류

자주 묻는 질문

특정 슬롯에서 Solana 계정의 상태를 가져오려면 어떻게 해야 하나요?

같은 슬롯의 두 트랜잭션 사이에 있는 계정 상태를 읽을 수 있나요?

얼마나 오래된 기록까지 쿼리할 수 있나요?

과거 계정 메서드가 포함된 플랜은 무엇인가요?

요청 속도 제한은 어떻게 되나요?

계정의 모든 과거 상태를 가져오려면 어떻게 해야 하나요?

새로운 SDK가 필요한가요?

다음 단계