> ## 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.
# getSignatureStatuses
> 서명 목록의 상태를 반환합니다. 각 서명은 거래의 첫 번째 서명이 되는 txid여야 합니다.
## 요청 매개변수
Base-58로 인코딩된 문자열로 된 거래 서명 배열(최대 256개).
최근 상태 캐시를 넘어 과거의 거래를 찾기 위한 검색 활성화.
## OpenAPI
````yaml ko/openapi/rpc-http/getSignatureStatuses.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: Mainnet RPC 엔드포인트
- url: https://devnet.helius-rpc.com
description: Devnet RPC 엔드포인트
security: []
paths:
/:
post:
tags:
- RPC
summary: getSignatureStatuses
description: >
단일 효율적인 배치 요청으로 여러 Solana 트랜잭션의 확인 상태를 검색합니다.
이 필수 트랜잭션 추적 API는 트랜잭션이 Solana 합의 프로세스를 통해 초기 제출에서 최종 확인으로 진행되는 과정을
애플리케이션이 모니터링할 수 있게 합니다. 트랜잭션 상태에 대한
자세한 정보를 반환하여 처리 슬롯, 확인 횟수, 오류 세부사항, 최종성 수준 등을 포함합니다.
지갑, 거래소, 결제 처리기 및 트랜잭션이 성공적으로 블록체인에 정산되었는지 확인해야 하는
애플리케이션에 필수적이며 구성 가능한 기록 트랜잭션 조회 옵션을 제공합니다.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPC 프로토콜 버전입니다.
example: '2.0'
default: '2.0'
id:
type: string
description: 요청에 대한 고유 식별자입니다.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: 호출할 RPC 메서드의 이름입니다.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: 트랜잭션 서명 및 옵션 구성 개체를 포함하는 배열입니다.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: 기본-58 인코딩된 문자열로 최대 256개의 트랜잭션 서명 배열입니다.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: 구성 옵션입니다.
properties:
searchTransactionHistory:
type: boolean
description: 오래된 기록 트랜잭션을 찾기 위해 최근 상태 캐시를 넘어 검색을 활성화합니다.
example: true
responses:
'200':
description: 서명 상태를 성공적으로 검색했습니다.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC 프로토콜 버전입니다.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: 요청과 일치하는 식별자입니다.
example: '1'
result:
type: object
description: 컨텍스트 및 서명 상태 값을 포함합니다.
properties:
context:
type: object
properties:
slot:
type: integer
description: 데이터가 검색된 슬롯입니다.
example: 82
value:
type: array
description: 트랜잭션 서명 상태 목록입니다.
items:
oneOf:
- type: 'null'
description: 트랜잭션이 알 수 없는 경우 null입니다.
- type: object
properties:
slot:
type: integer
description: 이 트랜잭션이 포함된 블록에 포함된 Solana 블록체인 슬롯 번호입니다.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
이 트랜잭션이 처리된 이후 확인된 블록 수 (완전히 최종화된 경우
null).
- type: 'null'
description: null은 트랜잭션이 최대 최종성(루트)에 도달했음을 나타냅니다.
example: 48
err:
oneOf:
- type: object
description: 트랜잭션이 실행 중 실패한 경우 세부정보를 포함하는 오류 객체입니다.
- type: 'null'
description: null은 트랜잭션이 오류 없이 성공적으로 실행되었음을 나타냅니다.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Solana 네트워크에서 트랜잭션의 현재 최종 상태 (processed →
confirmed → finalized).
example: finalized
examples:
responseExample:
value:
jsonrpc: '2.0'
id: '1'
result:
context:
slot: 82
value:
- slot: 48
confirmations: 48
err: null
confirmationStatus: finalized
- null
'400':
description: 잘못된 요청 - 잘못된 요청 매개변수 또는 형식이 잘못된 요청입니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: 권한 없음 - 잘못되었거나 누락된 API 키입니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: 요청이 너무 많음 - 속도 제한 초과.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: 서비스 사용할 수 없음 - 서비스가 일시적으로 사용할 수 없습니다.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: 게이트웨이 시간 초과 - 요청 시간 초과.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Gateway timeout
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: JSON-RPC 프로토콜 버전입니다.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: 에러 코드입니다.
example: -32602
message:
type: string
description: 에러 메시지입니다.
data:
type: object
description: 에러에 대한 추가 데이터입니다.
id:
type: string
description: 요청과 일치하는 식별자입니다.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
귀하의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서 무료로
받을 수 있습니다.
````