> ## 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.
# getVoteAccounts
> Trả về thông tin tài khoản và lượng stake liên quan cho tất cả tài khoản biểu quyết trong bank hiện tại.
## Tham số yêu cầu
Mức cam kết cho yêu cầu.
* `confirmed`
* `finalized`
* `processed`
Địa chỉ tài khoản biểu quyết cụ thể của trình xác thực dùng để lọc kết quả (được mã hóa base-58).
Bao gồm các trình xác thực bị chậm nhưng không được ủy quyền stake.
Ngưỡng tùy chỉnh về số slot bị chậm để đánh dấu trình xác thực là không hoạt động đúng hạn hoặc có hiệu suất kém.
## OpenAPI
````yaml vi/openapi/rpc-http/getVoteAccounts.yaml POST /
openapi: 3.1.0
info:
title: API RPC Solana
version: 1.0.0
description: >-
API giám sát trình xác thực Solana toàn diện để theo dõi người tham gia
mạng, hoạt động staking và mức độ tham gia đồng thuận trên toàn hệ sinh thái
blockchain.
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: getVoteAccounts
description: >
Truy xuất thông tin chi tiết về các trình xác thực Solana và mức độ tham
gia của họ vào cơ chế đồng thuận mạng.
API mạnh mẽ này cung cấp các chỉ số toàn diện về trình xác thực, bao gồm
địa chỉ định danh, lượng stake,
tỷ lệ hoa hồng, hoạt động bỏ phiếu và trạng thái hiệu suất. Đây là công
cụ thiết yếu cho các ứng dụng staking, công cụ
lựa chọn trình xác thực, bảng điều khiển giám sát mạng và phân tích tính
phi tập trung. API phân loại trình xác thực
thành hiện tại (người tham gia đang hoạt động) hoặc chậm trễ (hoạt động
kém hiệu quả), cung cấp thông tin chuyên sâu quan trọng
cho người ủy quyền muốn tối ưu hóa chiến lược staking và phần thưởng của
họ trên blockchain Solana.
operationId: getVoteAccounts
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:
- getVoteAccounts
description: Tên của phương thức RPC cần gọi.
example: getVoteAccounts
default: getVoteAccounts
params:
type: array
description: Đối tượng cấu hình tùy chọn để lọc các tài khoản bỏ phiếu.
items:
type: object
properties:
commitment:
type: string
description: Mức cam kết cho yêu cầu.
enum:
- confirmed
- finalized
- processed
example: finalized
votePubkey:
type: string
description: >-
Địa chỉ tài khoản bỏ phiếu cụ thể của trình xác thực
dùng để lọc kết quả (được mã hóa base-58).
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
keepUnstakedDelinquents:
type: boolean
description: >-
Bao gồm các trình xác thực bị tụt lại nhưng không có
stake nào được ủy quyền cho họ.
example: true
delinquentSlotDistance:
type: integer
description: >-
Ngưỡng tùy chỉnh về số slot bị tụt lại để đánh dấu
trình xác thực là chậm trễ hoặc hoạt động kém hiệu
quả.
example: 128
responses:
'200':
description: Đã truy xuất thành công các tài khoản bỏ phiếu.
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: Danh sách các tài khoản bỏ phiếu hiện tại và chậm trễ.
properties:
current:
type: array
description: >-
Các trình xác thực đang hoạt động và tham gia đúng
cách vào cơ chế đồng thuận của mạng Solana.
items:
type: object
properties:
votePubkey:
type: string
description: >-
Địa chỉ tài khoản bỏ phiếu Solana duy nhất được
liên kết với trình xác thực này.
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey:
type: string
description: >-
Địa chỉ định danh của trình xác thực kiểm soát
tài khoản bỏ phiếu.
example: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake:
type: integer
description: >-
Tổng số SOL được ủy quyền cho trình xác thực
này, tính bằng lamport, dùng để xác định trọng
số đồng thuận của họ.
example: 42
epochVoteAccount:
type: boolean
description: >-
Cho biết trình xác thực này có đủ điều kiện nhận
phần thưởng trong epoch hiện tại hay không.
example: true
commission:
type: integer
description: >-
Tỷ lệ phần trăm hoa hồng của trình xác thực
(0-100) được trích từ phần thưởng staking.
example: 0
lastVote:
type: integer
description: >-
Slot Solana gần nhất mà trình xác thực này đã bỏ
phiếu, thể hiện mức độ hoạt động.
example: 147
epochCredits:
type: array
description: >-
Lịch sử credit kiếm được gần nhất trong tối đa
năm epoch.
items:
type: array
description: >-
Lịch sử credit [epoch, credits,
previousCredits].
items:
type: integer
example:
- 1
- 64
- 0
rootSlot:
type: integer
description: Slot gốc hiện tại của tài khoản bỏ phiếu này.
example: 42
delinquent:
type: array
description: >-
Các trình xác thực hoạt động kém hiệu quả và bị tụt
lại trong quá trình tham gia đồng thuận.
items:
type: object
properties:
votePubkey:
type: string
description: Địa chỉ tài khoản bỏ phiếu.
example: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey:
type: string
description: Danh tính trình xác thực.
example: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake:
type: integer
description: >-
Stake được ủy quyền cho tài khoản bỏ phiếu này
(lamport).
example: 0
epochVoteAccount:
type: boolean
description: >-
Cho biết tài khoản bỏ phiếu có được stake trong
epoch này hay không.
example: false
commission:
type: integer
description: >-
Tỷ lệ phần trăm (0-100) khoản phần thưởng được
trả cho tài khoản bỏ phiếu.
example: 0
lastVote:
type: integer
description: >-
Slot gần nhất mà tài khoản bỏ phiếu này đã bỏ
phiếu.
example: 147
epochCredits:
type: array
description: >-
Lịch sử credit kiếm được gần nhất trong tối đa
năm epoch.
items:
type: array
description: >-
Lịch sử credit [epoch, credits,
previousCredits].
items:
type: integer
example:
- 1
- 64
- 0
rootSlot:
type: integer
description: Slot gốc hiện tại của tài khoản bỏ phiếu này.
example: 42
examples:
default:
value:
jsonrpc: '2.0'
id: '1'
result:
current:
- votePubkey: 3ZT31jkAGhUaw8jsy4bTknwBMP8i4Eueh52By4zXcsVw
nodePubkey: B97CCUW3AEZFGy6uUg6zUdnNYvnVq5VG8PUtb2HayTDD
activatedStake: 42
epochVoteAccount: true
commission: 0
lastVote: 147
epochCredits:
- - 1
- 64
- 0
- - 2
- 192
- 64
rootSlot: 42
delinquent: []
'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 có
định dạng sai.
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: Hết thời gian chờ cổng kết nối - 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: Hết thời gian chờ cổng kết nối
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).
````