Skip to main content
getBlocksWithLimit RPC 메서드는 지정된 슬롯에서 시작하여 주어진 제한까지 확정된 블록 슬롯 번호 목록을 검색할 수 있게 합니다. 이는 원장 내 특정 지점에서 후속 확정 블록이 필요한 경우 유용합니다.
더 나은 성능을 위해 배칭을 피하세요배칭 아카이브 방법은 지연 시간을 크게 증가시킵니다. 10개 이상의 요청 배치는 허용되지 않습니다.

일반적인 사용 사례

  • 후속 블록의 고정된 수 가져오기: 특정 시작 슬롯 이후에 확정된 블록 슬롯의 정의된 수를 가져옵니다.
  • 페이지네이션된 블록 탐색: 블록체인의 일부를 분석할 때 블록을 부분적으로 수집합니다.
  • 최근 블록 모니터링: 최근 슬롯에서 마지막 N 블록을 가져옵니다.

요청 매개변수

getBlocksWithLimit 메서드는 다음 매개변수를 사용합니다:
  1. start_slot (u64, 필수): 고려할 첫 번째 슬롯(포함).
  2. limit (u64, 필수): 반환할 최대 블록 슬롯 수. 쿼리된 총 슬롯 수(start_slot부터 limit 이후의 블록까지)는 500,000 슬롯을 초과할 수 없습니다.
  3. commitment (문자열, 선택 사항): 쿼리에 대한 커밋 수준을 지정합니다. 생략할 경우 기본 노드의 커밋을 사용합니다. 이 매개변수는 구성 개체의 유일한 필드로 마지막 매개변수로 전달됩니다.

응답 구조

JSON-RPC 응답의 result 필드는 u64 정수의 배열이 될 것입니다. 배열의 각 정수는 확정된 블록 슬롯 번호를 나타내며, start_slot부터 지정된 limit까지 계속됩니다.
  • 예: start_slot이 5이고 limit이 3인 경우 가능한 결과는 [5, 6, 7]입니다.

예제

1. 시작 슬롯에서 제한된 수의 블록 가져오기

이 예제는 슬롯 280000000에서 시작하여 최대 5개의 확정된 블록 슬롯 목록을 가져옵니다.

2. 특정 커밋 수준과 함께 블록 가져오기

이 예제는 슬롯 290000000에서 시작하여 confirmed 커밋 수준을 사용하여 최대 3개의 블록을 가져옵니다.

개발자 팁

  • 범위 명확화: limit 매개변수는 반환할 최대 블록 슬롯 수를 결정합니다. 500,000 슬롯 제한은 개념적으로 스캔한 범위에 적용됩니다(즉, start_slot에서 start_slot + limit - 1까지). 이 개념적 범위가 500,000 슬롯을 초과하지 않도록 하세요. 해당 범위 내에서 찾고 반환되는 실제 블록 수가 적더라도 말입니다.
  • 노드 데이터 가용성: 노드가 모든 역사적 슬롯에 대한 정보를 보유하지 않을 수 있습니다. 매우 오래된 start_slot은 지정된 limit보다 적은 블록을 반환하거나 노드의 원장 보유에 따라 빈 배열을 반환할 수 있습니다.
  • 블록 확인: 이 메서드는 확정된 블록을 반환합니다. 선택한 commitment 수준과 쿼리하는 노드에 따라 정확한 블록 집합이 약간 다를 수 있으며, 특히 매우 최근 슬롯의 경우에는 더욱 그렇습니다.
  • 사용 사례 특이성: getBlocksWithLimit는 시작점을 알고 후속 블록의 고정 수가 필요한 경우 이상적입니다. 알려진 슬롯 범위 내의 모든 블록이 필요한 경우 getBlocks가 더 적절할 수 있습니다.
이 가이드는 Solana 네트워크에서 확정된 블록 슬롯의 특정 수를 나열하기 위해 getBlocksWithLimit RPC 메서드를 사용하는 방법에 대한 명확한 개요를 제공합니다.

관련 메서드

getBlocks

슬롯 범위 내의 모든 블록 가져오기

getBlock

특정 블록에 대한 자세한 정보 가져오기