> ## 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
> Mengembalikan status dari daftar tanda tangan. Setiap tanda tangan harus berupa txid, yaitu tanda tangan pertama dari suatu transaksi.
## Parameter Permintaan
Larik tanda tangan transaksi (hingga 256), sebagai string yang dikodekan dengan base-58.
Aktifkan pencarian di luar cache status terbaru untuk menemukan transaksi historis yang lebih lama.
## OpenAPI
````yaml id/openapi/rpc-http/getSignatureStatuses.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API pelacakan konfirmasi transaksi untuk memantau status dan tingkat
finalitas beberapa transaksi Solana dengan pembaruan waktu nyata.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: Titik akhir RPC Mainnet
- url: https://devnet.helius-rpc.com
description: Titik akhir RPC Devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: getSignatureStatuses
description: >
Ambil status konfirmasi untuk beberapa transaksi Solana dalam satu
permintaan batch yang efisien.
API pelacakan transaksi penting ini memungkinkan aplikasi memantau
perkembangan transaksi
melalui proses konsensus Solana, mulai dari pengiriman awal hingga
konfirmasi akhir. Mengembalikan informasi
mendetail tentang status transaksi, termasuk slot pemrosesan, jumlah
konfirmasi, detail kesalahan,
dan tingkat finalitas. Sangat penting untuk dompet, bursa, pemroses
pembayaran, dan aplikasi apa pun yang
perlu memverifikasi kapan transaksi berhasil diselesaikan di blockchain
dengan opsi
pencarian transaksi historis yang dapat dikonfigurasi.
operationId: getSignatureStatuses
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: Versi protokol JSON-RPC.
example: '2.0'
default: '2.0'
id:
type: string
description: Pengidentifikasi unik untuk permintaan.
example: '1'
default: '1'
method:
type: string
enum:
- getSignatureStatuses
description: Nama metode RPC yang akan dipanggil.
example: getSignatureStatuses
default: getSignatureStatuses
params:
type: array
description: >-
Array yang berisi tanda tangan transaksi dan objek
konfigurasi opsional.
default:
- - >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
items:
oneOf:
- type: array
description: >-
Array tanda tangan transaksi (hingga 256), sebagai
string yang dikodekan dengan base-58.
items:
type: string
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
- type: object
description: Opsi konfigurasi.
properties:
searchTransactionHistory:
type: boolean
description: >-
Aktifkan pencarian di luar cache status terbaru
untuk menemukan transaksi historis yang lebih
lama.
example: true
responses:
'200':
description: Status tanda tangan berhasil diambil.
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
description: Versi protokol JSON-RPC.
enum:
- '2.0'
example: '2.0'
id:
type: string
description: Pengidentifikasi yang cocok dengan permintaan.
example: '1'
result:
type: object
description: Berisi konteks dan nilai status tanda tangan.
properties:
context:
type: object
properties:
slot:
type: integer
description: Slot tempat data diambil.
example: 82
value:
type: array
description: Daftar status tanda tangan transaksi.
items:
oneOf:
- type: 'null'
description: Null jika transaksi tidak diketahui.
- type: object
properties:
slot:
type: integer
description: >-
Nomor slot blockchain Solana tempat
transaksi ini disertakan dalam sebuah blok.
example: 48
confirmations:
oneOf:
- type: integer
description: >-
Jumlah blok yang dikonfirmasi sejak
transaksi ini diproses (null jika
sepenuhnya final).
- type: 'null'
description: >-
Null menunjukkan bahwa transaksi telah
mencapai finalitas maksimum (rooted).
example: 48
err:
oneOf:
- type: object
description: >-
Objek kesalahan yang berisi detail jika
transaksi gagal selama eksekusi.
- type: 'null'
description: >-
Null menunjukkan bahwa transaksi
berhasil dieksekusi tanpa kesalahan.
example: null
confirmationStatus:
type: string
enum:
- processed
- confirmed
- finalized
description: >-
Status finalitas transaksi saat ini di
jaringan 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: >-
Permintaan Tidak Valid - Parameter permintaan tidak valid atau
format permintaan salah.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32602
message: Invalid params
id: '1'
'401':
description: Tidak Diotorisasi - Kunci API tidak valid atau tidak disertakan.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32001
message: Unauthorized
id: '1'
'429':
description: Terlalu Banyak Permintaan - Batas laju terlampaui.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32005
message: Too many requests
id: '1'
'500':
description: Kesalahan Server Internal - Terjadi kesalahan pada server.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32603
message: Internal error
id: '1'
'503':
description: Layanan Tidak Tersedia - Layanan untuk sementara tidak tersedia.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
jsonrpc: '2.0'
error:
code: -32002
message: Service unavailable
id: '1'
'504':
description: Waktu Tunggu Gateway Habis - Waktu tunggu permintaan habis.
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: Versi protokol JSON-RPC.
enum:
- '2.0'
example: '2.0'
error:
type: object
properties:
code:
type: integer
description: Kode kesalahan.
example: -32602
message:
type: string
description: Pesan kesalahan.
data:
type: object
description: Data tambahan tentang kesalahan.
id:
type: string
description: Pengidentifikasi yang cocok dengan permintaan.
example: '1'
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
Kunci API Helius Anda. Anda dapat memperolehnya secara gratis di
[dasbor](https://dashboard.helius.dev/api-keys).
````