> ## 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
> Trả về trạng thái của một danh sách chữ ký. Mỗi chữ ký phải là một txid, tức chữ ký đầu tiên của một giao dịch.
## Tham số yêu cầu
Mảng chữ ký giao dịch (tối đa 256), dưới dạng chuỗi được mã hóa base-58.
Cho phép tìm kiếm ngoài bộ nhớ đệm trạng thái gần đây để tìm các giao dịch cũ hơn trong lịch sử.
## OpenAPI
````yaml vi/openapi/rpc-http/getSignatureStatuses.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API theo dõi xác nhận giao dịch để giám sát trạng thái và mức độ hoàn tất
của nhiều giao dịch Solana với các bản cập nhật theo thời gian thực.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Điểm cuối RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Điểm cuối RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getSignatureStatuses
description: >
Truy xuất trạng thái xác nhận của nhiều giao dịch Solana trong một yêu
cầu theo lô hiệu quả.
API theo dõi giao dịch thiết yếu này cho phép các ứng dụng giám sát tiến
trình của giao dịch
qua quy trình đồng thuận Solana, từ lúc gửi ban đầu đến khi xác nhận
cuối cùng. API trả về thông tin
chi tiết về trạng thái giao dịch, bao gồm slot xử lý, số lần xác nhận,
chi tiết lỗi
và mức độ hoàn tất. Đây là API quan trọng đối với ví, sàn giao dịch, hệ
thống xử lý thanh toán và mọi ứng dụng
cần xác minh thời điểm giao dịch đã được quyết toán thành công trên
blockchain, với các tùy chọn
tra cứu lịch sử giao dịch có thể cấu hình.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Phiên bản giao thức JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Mã định danh duy nhất cho yêu cầu.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: Tên của phương thức RPC cần gọi.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: Mảng chứa chữ ký giao dịch và đối tượng cấu hình tùy chọn.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: >-
Mảng chữ ký giao dịch (tối đa 256), dưới dạng chuỗi
được mã hóa base-58.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: Các tùy chọn cấu hình.
properties:
searchTransactionHistory:
type: boolean
description: >-
Cho phép tìm kiếm ngoài bộ nhớ đệm trạng thái gần
đây để tìm các giao dịch cũ hơn trong lịch sử.
example: true
responses:
'200':
description: Đã truy xuất thành công trạng thái chữ ký.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: Phiên bản giao thức JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Mã định danh khớp với yêu cầu.
example: '1'
result:
type: object
description: Chứa ngữ cảnh và các giá trị trạng thái chữ ký.
properties:
context:
type: object
properties:
slot:
type: integer
description: Slot nơi dữ liệu được truy xuất.
example: 82
value:
type: array
description: Danh sách trạng thái chữ ký giao dịch.
items:
oneOf:
- type: 'null'
description: Null nếu giao dịch không xác định.
- type: object
properties:
slot:
type: integer
description: >-
Số slot trên blockchain Solana mà giao dịch
này được đưa vào một khối.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
Số khối đã được xác nhận kể từ khi giao
dịch này được xử lý (null nếu đã hoàn
tất đầy đủ).
- type: 'null'
description: >-
Null cho biết giao dịch đã đạt mức hoàn
tất tối đa (đã được root).
example: 48
err:
oneOf:
- type: object
description: >-
Đối tượng lỗi chứa thông tin chi tiết
nếu giao dịch thất bại trong quá trình
thực thi.
- type: 'null'
description: >-
Null cho biết giao dịch đã được thực thi
thành công mà không có lỗi.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Trạng thái hoàn tất hiện tại của giao dịch
trên mạng Solana (đã xử lý → đã xác nhận →
đã hoàn tất).
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: >-
Yêu cầu không hợp lệ - Tham số yêu cầu không hợp lệ hoặc yêu cầu sai
định dạng.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Tham số không hợp lệ
id: '1'
'401':
description: Không được phép - Khóa API không hợp lệ hoặc bị thiếu.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Không được phép
id: '1'
'429':
description: Quá nhiều yêu cầu - Đã vượt quá giới hạn tốc độ.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Quá nhiều yêu cầu
id: '1'
'500':
description: Lỗi máy chủ nội bộ - Đã xảy ra lỗi trên máy chủ.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Lỗi nội bộ
id: '1'
'503':
description: Dịch vụ không khả dụng - Dịch vụ tạm thời không khả dụng.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Dịch vụ không khả dụng
id: '1'
'504':
description: Cổng kết nối hết thời gian chờ - Yêu cầu đã hết thời gian chờ.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32003
message: Cổng kết nối hết thời gian chờ
id: '1'
security:
- ApiKeyQuery: []
components:
schemas:
ErrorResponse:
type: object
properties:
jsonrpc:
type: string
description: Phiên bản giao thức JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Mã lỗi.
example: -32602
message:
type: string
description: Thông báo lỗi.
data:
type: object
description: Dữ liệu bổ sung về lỗi.
id:
type: string
description: Mã định danh khớp với yêu cầu.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong [bảng điều
khiển](https://dashboard.helius.dev/api-keys).
````