> ## 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.
# requestAirdrop
> requestAirdrop gửi một lượng lamport qua airdrop đến bất kỳ tài khoản Solana nào trên devnet — cấp SOL cho ví thử nghiệm trước khi gửi giao dịch trong quá trình phát triển.
## Tham số yêu cầu
Địa chỉ ví Solana (khóa công khai) nhận token SOL thử nghiệm qua airdrop.
Lượng SOL cần airdrop, tính bằng lamport (1 SOL = 1.000.000.000 lamport), để thử nghiệm.
Mức cam kết cho yêu cầu.
* `confirmed`
* `finalized`
* `processed`
## OpenAPI
````yaml vi/openapi/rpc-http/requestAirdrop.yaml POST /
openapi: 3.1.0
info:
title: Solana RPC API
version: 1.0.0
description: >-
API Solana dành cho phát triển, dùng để yêu cầu airdrop token SOL trên các
mạng thử nghiệm nhằm cấp vốn cho tài khoản phục vụ phát triển, kiểm thử và
thử nghiệm ứng dụng.
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://devnet.helius-rpc.com
description: Điểm cuối RPC của devnet
security: []
paths:
/:
post:
tags:
- RPC
summary: requestAirdrop
description: >
Yêu cầu token SOL miễn phí trên các mạng thử nghiệm Solana để phục vụ
mục đích phát triển và kiểm thử.
API chỉ dành cho phát triển này cho phép nhà phát triển nạp SOL vào ví
trong môi trường devnet và testnet
để xây dựng và kiểm thử ứng dụng Solana mà không cần sử dụng tiền thật.
API này cần thiết cho
quá trình phát triển cục bộ, quy trình CI/CD, kiểm thử tự động và thử
nghiệm các tính năng Solana
mới. SOL nhận được qua airdrop có thể dùng để thanh toán phí giao dịch,
tạo tài khoản
và kiểm thử logic tài chính trong môi trường phi sản xuất.
operationId: requestAirdrop
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:
- requestAirdrop
description: Tên của phương thức RPC cần gọi.
example: requestAirdrop
default: requestAirdrop
params:
type: array
description: Các tham số cho yêu cầu airdrop.
default:
- 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
- 1000000000
items:
oneOf:
- type: string
description: >-
Địa chỉ ví Solana (khóa công khai) để nhận token SOL
thử nghiệm qua airdrop.
example: 83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri
- type: integer
description: >-
Lượng SOL cần airdrop, tính bằng lamport (1 SOL =
1.000.000.000 lamport), để kiểm thử.
example: 1000000000
- type: object
description: Đối tượng cấu hình cho airdrop.
properties:
commitment:
type: string
description: Mức cam kết cho yêu cầu.
enum:
- confirmed
- finalized
- processed
example: finalized
responses:
'200':
description: Đã yêu cầu airdrop thành công.
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: string
description: >-
Chữ ký giao dịch Solana của airdrop đã hoàn tất, có thể
dùng để xác minh rằng SOL đã được nhận.
example: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
examples:
responseExample:
value:
jsonrpc: '2.0'
id: '1'
result: >-
5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW
'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).
````