Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.orbitflare.com/llms.txt

Use this file to discover all available pages before exploring further.

OrbitFlare CLI, RPC sorgularını, YAML yapılandırmalı gRPC ve Jetstream akışını, proje iskeletini ve hesap yönetimini saran tek ikilidir. Ajan ve otomasyon iş akışları için kritik özellik --jsondır: her komut jq, kabuk boruları, GitHub Actions ve cron işleriyle düzgün birleşen yapılandırılmış çıktı üretir.
Claude Code, Cursor veya diğer MCP ana bilgisayarlarında etkileşimli yapay zekâ iş akışları için MCP sunucusunu tercih edin. CLI, belirleyici çıkış kodları ve ayrıştırılabilir çıktı istediğiniz kabuk tabanlı otomasyon için daha uygundur.

Kurulum

cargo install orbitflare           # Rust 1.85+ gerekir
orbitflare --version
Kurulum alternatifleri, kimlik doğrulama yöntemleri ve tam komut yüzeyi için tam CLI referansına bakın.

Başsız kurulum

Etkileşimsiz ortamlar (CI, konteynerler, betikler) için doğrudan API anahtarıyla kimlik doğrulayın; tarayıcı akışı gerekmez:
orbitflare auth login --x-orbit-key "$ORBITFLARE_API_KEY"
orbitflare config set rpc.url "$ORBITFLARE_RPC_URL"
orbitflare config set grpc.url "$ORBITFLARE_GRPC_URL"
orbitflare config set jetstream.url "$ORBITFLARE_JETSTREAM_URL"
orbitflare ping --json
Kimlik bilgileri varsayılan olarak işletim sistemi anahtarlığında saklanır. Anahtarlığı olmayan konteynerlerde ORBITFLARE_CONFIG_DIR yazılabilir bir yola ayarlayın; CLI dosya tabanlı yapılandırmaya düşer.

JSON çıktısı

Her komut --json destekler:
$ orbitflare rpc slot --json
{"slot": 312456789}

$ orbitflare rpc balance Gh9ZwEm... --json
{"address": "Gh9ZwEm...", "lamports": 12500000000, "sol": 12.5}
jq ile tek satırlıklar oluşturun:
# Yalnızca slotu yazdır
orbitflare rpc slot --json | jq -r '.slot'

# Bakiye 1 SOL’un altına düşerse uyar
SOL=$(orbitflare rpc balance "$WALLET" --json | jq -r '.sol')
if (( $(echo "$SOL < 1" | bc -l) )); then
  echo "Balance low: $SOL SOL"
  exit 1
fi

YAML yapılandırmaları ile akış

CLI, Jetstream ve Yellowstone gRPC için bildirimsel bir YAML yapılandırması ile kod gerektirmeden akış yapar:
# pump-trades.yaml
transactions:
  pump_trades:
    account_include:
      - "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P"

reconnect:
  initial_delay_ms: 100
  max_delay_ms: 30000
  multiplier: 2.0
  max_retries: 0
Çalıştırma (Jetstream veya Yellowstone gRPC):
orbitflare jet --config pump-trades.yaml | your-indexer
orbitflare grpc --config pump-trades.yaml | your-indexer
YAML’ı MCP destekli bir ajandan oluşturun. MCP sunucusu subscribeTransactions aracı, doğal dil açıklamasından CLI’ye hazır bir yapılandırma üretir.

Betikleme desenleri

Son imzaları kuyruklayıp işleme

orbitflare rpc history "$WALLET" --limit 50 --json \
  | jq -r '.[].signature' \
  | while read sig; do
      orbitflare rpc tx "$sig" --json > "txs/$sig.json"
    done

CI sağlık kontrolü

# .github/workflows/rpc-health.yml
name: OrbitFlare RPC health
on:
  schedule:
    - cron: '*/15 * * * *'
jobs:
  ping:
    runs-on: ubuntu-latest
    steps:
      - uses: actions-rs/toolchain@v1
        with: { toolchain: stable }
      - run: cargo install orbitflare
      - run: orbitflare auth login --x-orbit-key ${{ secrets.ORBITFLARE_API_KEY }}
      - run: orbitflare config set rpc.url ${{ secrets.ORBITFLARE_RPC_URL }}
      - run: orbitflare ping --json

Ajanla projeyi iskeletleme

CLI yaygın Solana projeleri için şablonlar içerir. Bir ajan bunları listeleyip tek seferde kurabilir:
orbitflare template --list --json
orbitflare template --install solana-copy-trader --dir ./bot

Profiller

Her seferinde yeniden kimlik doğrulamadan hesaplar veya ortamlar arasında geçin:
orbitflare auth login --profile prod --x-orbit-key "$PROD_KEY"
orbitflare auth login --profile dev  --x-orbit-key "$DEV_KEY"

orbitflare auth switch --profile prod
orbitflare auth status --json

Kaynak