認証 - Helius Docs

Helius APIは、APIキーを使用してリクエストを認証します。すべてのAPIリクエストには、APIキーを含めて、あなたの識別と権限を確認する必要があります。

あなたのAPIキーは、あなたのHeliusアカウントへのアクセスを許可する機密情報です。クライアントサイドのコードや公開リポジトリ、ブラウザでアクセス可能な箇所に公開しないでください。

はじめに

1. APIキーを作成する

サインアップまたはログイン

Helius Dashboardでアカウントを作成するか、既存のアカウントにログインしてください。

APIキーに移動

ダッシュボードのサイドバーでAPIキーセクションに移動します。

新しいキーを生成する

新しいAPIキーを作成をクリックし、プロジェクトに説明的な名前を付けてください（例：「Production App」、「Development Environment」）。

キーをコピーして安全に保管する

APIキーをすぐにコピーして安全に保存してください。一度移動すると再度見ることができません。

2. APIキーの使用

すべてのリクエストでクエリパラメーターとしてAPIキーを含めます。

curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getAccountInfo","params":["ACCOUNT_ADDRESS"]}'

const url = `https://mainnet.helius-rpc.com/?api-key=${YOUR_API_KEY}`;
const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'getAccountInfo',
    params: ['ACCOUNT_ADDRESS']
  })
});

import requests

url = f"https://mainnet.helius-rpc.com/?api-key={YOUR_API_KEY}"
payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getAccountInfo",
    "params": ["ACCOUNT_ADDRESS"]
}
response = requests.post(url, json=payload)

はじめに（エージェント向け）

エージェントは、Helius CLIを使用してプログラムでHeliusアカウントにサインアップし、プロジェクトを作成し、APIキーを生成できます。完全な手順は、https://dashboard.helius.dev/agents.md を読んでください。

Helius CLIをインストールする

npm install -g helius-cli

キーペアを生成する

helius keygen

ウォレットに資金を提供する（オートペイのみ）

ホストされた支払いリンクを介して支払う場合はこのステップをスキップします（--pay / --resume）。オートペイの場合は、ステップ2で提供されたウォレットアドレスに1 USDCと0.001 SOLを送信します。

サインアップしてAPIキーを取得する

helius signup --email you@example.com --first-name Jane --last-name Doe --json

セキュリティのベストプラクティス

環境変数

ソースコードではなく、環境変数にAPIキーを保存します。

export HELIUS_API_KEY="YOUR_API_KEY"

IP制限

特定のIPアドレスまたは範囲へのアクセスを制限するために、ダッシュボードでAPIキーのIP制限を設定します。

別々のキー

開発、ステージング、本番環境ごとに異なるAPIキーを使用して、使用を分離し、セキュリティを向上させます。

使用状況の監視

ダッシュボードで定期的にAPI使用状況を確認し、異常なパターンや潜在的なセキュリティの問題を検出します。

秘密管理

Node.js
Python
Docker

// Use environment variables
const apiKey = process.env.HELIUS_API_KEY;

// Or use a secrets manager
const { SecretManagerServiceClient } = require('@google-cloud/secret-manager');
const client = new SecretManagerServiceClient();

async function getApiKey() {
  const [version] = await client.accessSecretVersion({
    name: 'projects/PROJECT_ID/secrets/helius-api-key/versions/latest',
  });
  return version.payload.data.toString();
}

import os
from dotenv import load_dotenv

# Load environment variables
load_dotenv()
api_key = os.getenv('HELIUS_API_KEY')

# Or use AWS Secrets Manager
import boto3

def get_secret():
    client = boto3.client('secretsmanager')
    response = client.get_secret_value(SecretId='helius-api-key')
    return response['SecretString']

# In your Dockerfile
ENV HELIUS_API_KEY=""

# Or use Docker secrets
RUN --mount=type=secret,id=helius_key \
    cat /run/secrets/helius_key > /app/api_key.txt

レート制限と使用

レート制限はサブスクリプションプランによって異なります。割り当てられた制限内に収まるように、Helius Dashboardで使用状況を監視してください。

レート制限について理解する

秒あたりのリクエスト数: サブスクリプションのティアに基づく
月間リクエストクォータ: 課金サイクルごとに許可される総リクエスト数
バースト許容量: 基本レート制限を超えた短期間のスパイク

レート制限の処理

async function makeRequest(url, data) {
  try {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data)
    });
    
    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      console.log(`Rate limited. Retry after ${retryAfter} seconds`);
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      return makeRequest(url, data); // Retry
    }
    
    return response.json();
  } catch (error) {
    console.error('Request failed:', error);
    throw error;
  }
}

import time
import requests

def make_request(url, data):
    try:
        response = requests.post(url, json=data)
        
        if response.status_code == 429:
            retry_after = int(response.headers.get('Retry-After', 60))
            print(f"Rate limited. Waiting {retry_after} seconds...")
            time.sleep(retry_after)
            return make_request(url, data)  # Retry
        
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Request failed: {e}")
        raise

トラブルシューティング

無効なAPIキーエラー

症状: 401 Unauthorizedまたは「Invalid API Key」エラー解決策:

APIキーが正しいことを確認し、再生成されていないか確認する
クエリパラメーターとしてAPIキーを含めていることを確認する: ?api-key=YOUR_KEY
APIキーに余分なスペースや文字が含まれていないことを確認する
APIキーが期限切れまたは無効になっていないことを確認する

レート制限を超えた

症状: 429 Too Many Requestsエラー解決策:

ダッシュボードで現在の使用状況を確認する
リトライロジックに指数バックオフを実装する
高い制限のプランにアップグレードを検討する
不要な呼び出しを減らすようリクエストを最適化する

アクセス禁止

症状: 403 Forbiddenエラー解決策:

IP制限がリクエストをブロックしていないことを確認する
サブスクリプションにエンドポイントへのアクセスが含まれていることを確認する
APIキーに必要な権限があることを確認する

次のステップ

クイックスタートガイド

Heliusで最初のAPIコールを始める

APIリファレンス

利用可能なすべてのエンドポイントと方法を探索する

レート制限

レート制限とアップグレードのオプションを理解する

ダッシュボード

API使用状況を監視し、キーを管理する

サポート

認証について助けが必要ですか、APIキーに関する質問がありますか？

Discordコミュニティ

リアルタイムのヘルプとコミュニティサポートのためにDiscordに参加する

メールサポート

サポートチームに直接連絡する

API リファレンス

Solana RPC API

Solana API

データストリーミング API

イベントリスニング API

アカウント管理 API

認証

はじめに

1. APIキーを作成する

2. APIキーの使用

はじめに（エージェント向け）

Helius CLIをインストールする

キーペアを生成する

ウォレットに資金を提供する（オートペイのみ）

サインアップしてAPIキーを取得する

セキュリティのベストプラクティス

環境変数

IP制限

別々のキー

使用状況の監視

秘密管理

レート制限と使用

レート制限について理解する

レート制限の処理

トラブルシューティング

次のステップ

クイックスタートガイド

APIリファレンス

レート制限

ダッシュボード

サポート

Discordコミュニティ

メールサポート

​はじめに

​1. APIキーを作成する

​2. APIキーの使用

​はじめに（エージェント向け）

​Helius CLIをインストールする

​キーペアを生成する

​ウォレットに資金を提供する（オートペイのみ）

​サインアップしてAPIキーを取得する

​セキュリティのベストプラクティス

環境変数

IP制限

別々のキー

使用状況の監視

​秘密管理

​レート制限と使用

​レート制限について理解する

​レート制限の処理

​トラブルシューティング

​次のステップ

クイックスタートガイド

APIリファレンス

レート制限

ダッシュボード

​サポート

Discordコミュニティ

メールサポート

はじめに

1. APIキーを作成する

2. APIキーの使用

はじめに（エージェント向け）

Helius CLIをインストールする

キーペアを生成する

ウォレットに資金を提供する（オートペイのみ）

サインアップしてAPIキーを取得する

セキュリティのベストプラクティス

秘密管理

レート制限と使用

レート制限について理解する

レート制限の処理

トラブルシューティング

次のステップ

サポート