Solana API 認証 APIキーによる

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

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

ホスト型決済リンクで支払う場合は、この手順をスキップしてください（デフォルトの登録モードで、helius signup --resume を使用して完了します）。自動支払い（--pay）では、ローカルのキーペアから支払います。プラン料金分のUSDC（Agentプランの場合は$10）と約0.001 SOLを、前の手順で取得したウォレットアドレスに送金してください。

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

Agentプランを含むすべての新規登録には、--email、--first-name、--last-name が必要です。ウォレットは支払いにのみ使用されます。

# Default: prints a hosted payment link — pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe --json

# After paying via the link, finalize the account
helius signup --resume --json

# Or autopay from the funded local keypair
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe --json

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

Environment Variables

APIキーはソースコードではなく、環境変数に保存してください。

export HELIUS_API_KEY="YOUR_API_KEY"

IP Restrictions

ダッシュボードでAPIキーのIP制限を設定し、特定のIPアドレスまたは範囲からのみアクセスできるようにしてください。

Separate Keys

開発環境、ステージング環境、本番環境で異なるAPIキーを使用し、利用を分離してセキュリティを強化してください。

Monitor Usage

ダッシュボードで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で使用状況を監視してください。

レート制限について

1秒あたりのリクエスト数: サブスクリプションのティアに基づきます
月間リクエストクォータ: 請求サイクルごとに許可されるリクエストの合計数です
バースト許容量: 基本レート制限を一時的に超えるスパイクです

レート制限への対処

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

トラブルシューティング

Invalid API Key Error

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

APIキーが正しく、再生成されていないことを確認してください
APIキーをクエリパラメータとして含めていることを確認してください: ?api-key=YOUR_KEY
APIキーに余分なスペースや文字が含まれていないことを確認してください
APIキーの有効期限が切れておらず、無効化されていないことを確認してください

Rate Limit Exceeded

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

ダッシュボードで現在の使用状況を確認してください
再試行ロジックに指数バックオフを実装してください
上限を引き上げるために、プランのアップグレードを検討してください
リクエストを最適化し、不要な呼び出しを減らしてください

Forbidden Access

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

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

次のステップ

Quickstart Guide

Heliusで最初のAPI呼び出しを行います

API Reference

利用可能なすべてのエンドポイントとメソッドを確認します

Rate Limits

レート制限とアップグレードオプションについて確認します

Dashboard

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

サポート

認証に関するサポートが必要な場合や、APIキーについて質問がある場合は、以下をご利用ください。

Discord Community

Discordに参加すると、リアルタイムのサポートやコミュニティによる支援を受けられます

Email Support

サポートチームに直接お問い合わせください

はじめに

取引

トランザクションの送信

アカウント管理

認証

はじめに

1. APIキーを作成する

2. APIキーの使用

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

Helius CLIをインストールする

キーペアを生成する

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

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

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

Environment Variables

IP Restrictions

Separate Keys

Monitor Usage

シークレット管理

レート制限と使用量

レート制限について

レート制限への対処

トラブルシューティング

次のステップ

Quickstart Guide

API Reference

Rate Limits

Dashboard

サポート

Discord Community

Email Support

​はじめに

​1. APIキーを作成する

​2. APIキーの使用

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

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

​キーペアを生成する

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

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

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

Environment Variables

IP Restrictions

Separate Keys

Monitor Usage

​シークレット管理

​レート制限と使用量

​レート制限について

​レート制限への対処

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

​次のステップ

Quickstart Guide

API Reference

Rate Limits

Dashboard

​サポート

Discord Community

Email Support

はじめに

1. APIキーを作成する

2. APIキーの使用

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

Helius CLIをインストールする

キーペアを生成する

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

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

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

シークレット管理

レート制限と使用量

レート制限について

レート制限への対処

トラブルシューティング

次のステップ

サポート