> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# getBlock
> 원장에 확인된 블록에 대한 정체성과 거래 정보를 반환합니다.
## 요청 매개변수
슬롯 번호를 INTEGER로 입력합니다.
요청에 대한 커밋 수준입니다.
* `finalized`
반환되는 각 거래의 인코딩 형식입니다.
* `json`
* `jsonParsed`
* `base58`
* `base64`
반환할 거래 세부사항의 수준입니다. 계정이 요청된 경우, 거래 세부사항에는 각 거래의 서명 및 주석이 달린 계정 목록만 포함됩니다. 거래 메타데이터에는 다음만 포함됩니다: 수수료, 오류, pre\_balances, post\_balances, pre\_token\_balances 및 post\_token\_balances.
* `full`
* `accounts`
* `signatures`
* `none`
응답에 반환할 수 있는 최대 거래 버전입니다. 요청된 블록에 더 높은 버전의 거래가 포함된 경우 오류가 반환됩니다. 생략 시, 레거시 거래만 반환됩니다.
보상 배열을 채울지 여부입니다.
## OpenAPI
````yaml ko/openapi/rpc-http/getBlock.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
트랜잭션, 서명, 보상을 포함한 포괄적인 블록체인 블록 정보를 접근할 수 있는 고급 Solana 블록 데이터 검색 API로, 구성 가능한
세부 수준을 제공합니다.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: 메인넷 RPC 엔드포인트
- url: https://devnet.helius-rpc.com
description: Devnet RPC 엔드포인트
security: []
paths:
/:
post:
tags:
- RPC
summary: getBlock
description: >
지정된 슬롯 번호에 대한 자세한 Solana 블록 정보를 검색합니다. 트랜잭션, 서명, 계정 변경, 보상 및 시간 정보를 포함한
전체 블록 데이터에 접근할 수 있습니다.
트랜잭션 세부 정보 및 인코딩 형식을 구성하여 특정 애플리케이션 요구 사항에 최적화하세요.
operationId: getBlock
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC 프로토콜 버전입니다.
default: '2.0'
id:
type: string
description: 요청의 고유 식별자입니다.
example: '1'
default: '1'
method:
type: string
enum:
- getBlock
description: 호출할 RPC 메서드의 이름입니다.
default: getBlock
params:
type: array
description: 요청의 매개변수입니다.
default:
- 430
items:
oneOf:
- type: integer
description: '`u64` 정수로 슬롯 번호입니다.'
example: 430
- type: object
description: 요청을 위한 추가 구성 옵션입니다.
properties:
commitment:
type: string
description: 요청의 커밋먼트 레벨입니다.
enum:
- finalized
default: finalized
encoding:
type: string
description: 각 반환된 트랜잭션의 인코딩 형식입니다.
enum:
- json
- jsonParsed
- base58
- base64
default: json
transactionDetails:
type: string
description: >-
돌려받을 트랜잭션 세부 정보 수준입니다. 계정이 요청된 경우 트랜잭션 세부 정보에는 서명
및 각 트랜잭션의 주석이 포함된 계정 목록만 포함됩니다. 트랜잭션 메타데이터에는 수수료,
오류, 사전 잔액, 사후 잔액, 사전 토큰 잔액, 사후 토큰 잔액만 포함됩니다.
enum:
- full
- accounts
- signatures
- none
default: full
maxSupportedTransactionVersion:
type: integer
description: >-
응답에 반환할 최대 트랜잭션 버전입니다. 요청된 블록에 더 높은 버전의 트랜잭션이 포함된
경우 오류가 반환됩니다. 생략된 경우 기존 트랜잭션만 반환됩니다.
rewards:
type: boolean
description: 보상 배열을 채울지 여부입니다.
default: true
responses:
'200':
description: 블록 세부 정보를 성공적으로 검색했습니다.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
id:
type: string
result:
type: object
properties:
blockhash:
type: string
description: 이 블록의 블록해시 (base-58로 인코딩된 문자열)입니다.
example: DUCT8VSgk2BXkMhQfxKVYfikEZCQf4dZ4ioPdGdaVxMN
previousBlockhash:
type: string
description: 블록의 부모 블록해시입니다.
example: HA2fJgGqmQezCXJRVNZAWPbRMXCPjUyo7VjRF47JGdYs
parentSlot:
type: integer
description: 이 블록의 부모 슬롯 인덱스입니다.
example: 429
transactions:
type: array
description: 트랜잭션 세부 정보 배열입니다.
items:
type: object
properties:
meta:
type: object
nullable: true
description: 트랜잭션에 관련된 메타데이터입니다.
transaction:
type: object
description: 트랜잭션 세부 정보입니다.
properties:
message:
type: object
properties:
accountKeys:
type: array
description: 이 트랜잭션에 사용된 계정 공개 키 배열입니다.
items:
type: string
header:
type: object
properties:
numReadonlySignedAccounts:
type: integer
description: 읽기 전용 서명 계정 수입니다.
numReadonlyUnsignedAccounts:
type: integer
description: 읽기 전용 서명되지 않은 계정 수입니다.
numRequiredSignatures:
type: integer
description: 필수 서명 수입니다.
instructions:
type: array
description: 프로그램 명령 배열입니다.
items:
type: object
properties:
accounts:
type: array
description: 계정 인덱스 배열입니다.
items:
type: integer
data:
type: string
description: base58로 인코딩된 프로그램 입력 데이터입니다.
programIdIndex:
type: integer
description: accountKeys 배열에서 프로그램 ID의 인덱스입니다.
stackHeight:
type: integer
nullable: true
description: 스택 높이입니다.
recentBlockhash:
type: string
description: 이 트랜잭션에 사용된 최근 블록해시입니다.
signatures:
type: array
description: 이 트랜잭션에 대한 서명 배열 (base-58로 인코딩)입니다.
items:
type: string
blockTime:
type: integer
nullable: true
description: Unix 타임스탬프로 추정된 생성 시간입니다.
example: null
blockHeight:
type: integer
nullable: true
description: 이 블록 아래의 블록 수입니다.
example: null
rewards:
type: array
description: 블록에 대한 보상입니다.
items:
type: object
properties:
pubkey:
type: string
description: 보상을 받은 계정의 공개 키입니다.
lamports:
type: integer
description: 크레딧 또는 차감된 보상 램포트 수입니다.
rewardType:
type: string
nullable: true
description: '보상의 종류 (예: "fee", "rent")입니다.'
'400':
description: 잘못된 요청 - 요청 매개변수 또는 잘못된 요청입니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: 잘못된 매개변수
id: '1'
'401':
description: 인증되지 않음 - API 키가 잘못되었거나 누락되었습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: 인증되지 않음
id: '1'
'429':
description: 요청 수 초과 - 속도 제한을 초과했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: 요청 수가 너무 많습니다
id: '1'
'500':
description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: 내부 오류
id: '1'
'503':
description: 서비스 이용 불가 - 서비스가 일시적으로 이용 불가능합니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: 서비스 이용 불가
id: '1'
'504':
description: 게이트웨이 시간 초과 - 요청 시간이 초과되었습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: 게이트웨이 시간 초과
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
error:
type: object
properties:
code:
type: integer
message:
type: string
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
귀하의 Helius API 키입니다. 이는 [대시보드](https://dashboard.helius.dev/api-keys)에서
무료로 받을 수 있습니다.
````