Перейти к основному содержанию

Параметры

pubkey
string
обязательно
Публичный ключ аккаунта для запроса (строка, закодированная в base-58)
config
object
Объект конфигурации, содержащий следующие необязательные поля:

Ответ

result
object

Примеры кода

Базовый запрос

curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"
  ]
}'

Запрос с commitment

curl https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri",
    {
      "commitment": "finalized"
    }
  ]
}'

Использование web3.js

import { Connection, PublicKey } from '@solana/web3.js';

const connection = new Connection('https://fra.rpc.orbitflare.com?api_key=YOUR-API-KEY');
const publicKey = new PublicKey('83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri');

const balance = await connection.getBalance(
  publicKey,
  'confirmed'
);

console.log(`Balance: ${balance / 1e9} SOL`);

Примечания

  1. Баланс возвращается в lamports (1 SOL = 1 000 000 000 lamports)
  2. Для новых аккаунтов баланс будет равен 0
  3. Баланс включает все токены SOL, в том числе делегированные для стейкинга
  4. Ответ приходит немедленно, поскольку считывается из текущего состояния

Лучшие практики

  1. Используйте подходящий уровень commitment в зависимости от ваших потребностей:
    • processed для обновлений интерфейса
    • confirmed для большинства операций
    • finalized для критических операций
  2. Конвертируйте lamports в SOL, разделив на 1e9, при отображении пользователям
  3. Рассмотрите использование getAccountInfo, если вам нужны дополнительные сведения об аккаунте

Распространённые ошибки

КодСообщениеРешение
-32602Invalid param: WrongSizeУбедитесь, что публичный ключ действителен
-32602Invalid param: not base58 encoded stringУбедитесь, что публичный ключ закодирован в base58
-32007Account not foundАккаунт не существует (баланс будет 0)