OrbitFlare CLI - OrbitFlare

OrbitFlare CLI, geliştiricinin ihtiyaç duyduğu her şey için tek giriş noktasıdır: gRPC üzerinden zincir üstü veriyi akışa alma, blokzinciri sorgulama, şablonlardan proje iskeleti çıkarma ve etkileşimli bir gösterge paneliyle hesabınızı yönetme.

CLI kimlik bilgilerinizi işletim sistemi anahtarlığında saklar ve birden çok kimlik profilini destekler; hesaplar veya ağlar arasında anında geçiş yapabilirsiniz.

Kurulum

Cargo (önerilen)
Kaynaktan

cargo install orbitflare

git clone https://github.com/orbitflare/orbit-cli.git
cd orbit-cli
cargo install --path .

Rust 1.92+ gerekir. Kurulumu doğrulayın:

orbitflare --version

Hızlı başlangıç: Mevcut kullanıcılar

Zaten gösterge panelinden bir OrbitFlare hesabınız ve API anahtarınız varsa:

# Authenticate with your API key
orbitflare auth login --x-orbit-key YOUR_API_KEY

# Pick the region closest to you (default: fra)
orbitflare config set region ams

# Verify everything works
orbitflare ping
orbitflare rpc slot

Uç noktalar varsayılan olarak yapılandırılmış bölgeyi kullanır (ayarlanmamışsa fra); bu sayede ping, rpc, das, ws, jet ve grpc girişten hemen sonra çalışır. Açıkça ayarlanan rpc.url, grpc.url veya jetstream.url bölgeye göre önceliklidir.

Uç nokta URL’leri şu biçimi kullanır:

Protokol	Biçim	Örnek
RPC	`https://{region}.rpc.orbitflare.com`	`https://ams.rpc.orbitflare.com`
WS	`wss://{region}.rpc.orbitflare.com`	`wss://ams.rpc.orbitflare.com`
gRPC (Yellowstone)	`http://{region}.rpc.orbitflare.com:10000`	`http://ams.rpc.orbitflare.com:10000`
Jetstream	`http://{region}.jetstream.orbitflare.com`	`http://ams.jetstream.orbitflare.com`

RPC, WebSocket ve Yellowstone bölgeleri: va, ny, la, slc, ams, fra, lon, jp, sg. Jetstream bölgeleri: ny, slc, ams, fra, lon, dub, sqq, jp, sgp; Jetstream uç noktası olmayan RPC bölgeleri en yakın bölgeye eşlenir (va → ny, la → slc, sg → sgp).

Hızlı başlangıç: Yeni kullanıcılar

Hesap oluşturun

orbitflare.com adresinden kaydolun ve bir plan seçin.

Kimlik doğrulayın

CLI üç giriş yöntemini destekler. İş akışınıza uygun olanı seçin:

# API key (from orbitflare.com/dashboard)
orbitflare auth login --x-orbit-key YOUR_API_KEY

# Solana wallet keypair
orbitflare auth login --wallet ~/.config/solana/id.json

# Device flow (opens browser)
orbitflare auth login

CLI giriş sırasında RPC lisans anahtarınızı otomatik alır ve saklar. Elle ayarlamak için:

orbitflare auth set-license-key YOUR_LICENSE_KEY

API anahtarınızı ve lisans anahtarınızı gizli tutun. Sürüm denetimine eklemeyin veya istemci tarafı kodda açığa çıkarmayın.

Uç noktalarınızı yapılandırın

Uç noktalar varsayılan olarak fra bölgesini kullanır. Size en yakın bölgeyi seçin veya gösterge panelinizin Services bölümündeki tam uç nokta URL’lerini ayarlayın:

# Use a region for every service
orbitflare config set region ams

# (Optional) Set endpoints explicitly
orbitflare config set rpc.url ORBITFLARE_RPC_URL
orbitflare config set grpc.url ORBITFLARE_GRPC_URL
orbitflare config set jetstream.url ORBITFLARE_JETSTREAM_URL

# Verify connectivity
orbitflare ping

Tüm bölge uç noktaları için Kimlik doğrulama ve limitler sayfasına bakın.

Geliştirmeye başlayın

# Query your SOL balance
orbitflare rpc balance YOUR_WALLET_ADDRESS

# Get current slot
orbitflare rpc slot

# Wallet portfolio with token prices
orbitflare das owner YOUR_WALLET_ADDRESS

# Scaffold a project
orbitflare template --list
orbitflare template --install solana-copy-trader

# Launch the TUI dashboard
orbitflare dashboard

Kimlik doğrulama

Kimlik bilgileri işletim sistemi anahtarlığında güvenle saklanır. CLI, ayrı hesapları veya ortamları yönetmek için birden çok adlandırılmış profil destekler.

# Check current auth status
orbitflare auth status

# Switch profile
orbitflare auth switch --profile work

# Log out (also revokes device and wallet session tokens)
orbitflare auth logout

# Store an Apex API key for `apex send` and `apex transfer`
orbitflare auth set-apex-key YOUR_APEX_KEY

Kimlik doğrulama yöntemleri

API anahtarı
Cüzdan
Cihaz akışı

Gösterge panelinizden aldığınız API anahtarıyla kimlik doğrulayın. Anahtar Müşteri API’sine X-ORBIT-KEY başlığıyla iletilir.

orbitflare auth login --x-orbit-key YOUR_API_KEY

Solana anahtar çiftinizle bir meydan okumayı imzalayarak kimlik doğrulayın. Cüzdan bir hesaba bağlı değilse CLI kayıt sürecinde size eşlik eder.

orbitflare auth login --wallet ~/.config/solana/id.json

OAuth tarzı kimlik doğrulama için tarayıcınızı açar. Etkileşimli kullanım için idealdir.

orbitflare auth login

CLI bir doğrulama URL’si ve kodu gösterir, tamamlanana kadar yoklar ve ardından oturum belirtecini otomatik saklar.

Anahtar çözümleme sırası

Saklı profili seçmek için --profile bayrağı
~/.orbitflare/config.yml içindeki varsayılan profil
Ortam değişkenleri: RPC için ORBITFLARE_LICENSE_KEY, Apex için ORBITFLARE_APEX_KEY

Komut referansı

CLI’nin kimlik doğrulama, yapılandırma, blokzinciri sorguları, gerçek zamanlı akış, proje iskeleti ve hesap yönetimini kapsayan üst düzey komutları vardır.

Temel komutlar

Komut	Açıklama
`auth login`	Kimlik doğrulama (API anahtarı, cüzdan veya cihaz akışı)
`auth logout`	Saklı kimlik bilgilerini kaldırır
`auth status`	Geçerli kimlik doğrulama durumunu gösterir
`auth switch --profile <NAME>`	Farklı bir kimlik profiline geçer
`auth set-license-key <KEY>`	Geçerli profil için RPC lisans anahtarını saklar
`auth set-apex-key <KEY>`	Geçerli profil için Apex API anahtarını saklar
`config show`	Tüm yapılandırma değerlerini gösterir
`config set <KEY> <VALUE>`	Bir yapılandırma değerini ayarlar
`config remove <KEY> <VALUE>`	Liste yapılandırmasından bir değeri kaldırır
`config reset`	Yapılandırmayı varsayılanlara sıfırlar (kimlik doğrulamayı korur)
`ping`	Yapılandırılmış tüm hizmetlere bağlantıyı kontrol eder
`ping --service <SVC>`	Belirli bir hizmete ping (`rpc`, `jetstream`, `grpc`)
`docs [TOPIC...]`	Dokümantasyonu tarayıcınızda açar (`cli`, `rpc`, `ws`, `jet`, `grpc`, `das`, `history`, `apex`, `sdk`, `api` veya bir doküman yolu)
`plan list`	Mevcut RPC planlarını listeler
`plan view <SLUG>`	Plan ayrıntılarını gösterir
`plan compare --all`	Tüm planları yan yana karşılaştırır
`pay check-balance`	Hesap bakiyesini kontrol eder
`pay topup <AMOUNT>`	USDC ile bakiye yükler (zincir üstü)
`pay history`	Yükleme / kredi geçmişi
`pay purchase <SLUG> <PERIOD>`	Bakiyeden plan satın alır
`pay order --history`	Siparişleri listeler
`pay order <REF>`	Sipariş ayrıntılarını gösterir
`pay invoice --list`	Faturaları listeler
`pay invoice <REF>`	Fatura ayrıntılarını gösterir
`pay renew <INVOICE>`	Bakiyeden fatura öder (yenileme)

RPC komutları

Solana blokzincirini doğrudan terminalinizden sorgulayın.

orbitflare rpc account <ADDRESS>
orbitflare rpc tokens <WALLET>
orbitflare rpc balance <ADDRESS>
orbitflare rpc tx <SIGNATURE>
orbitflare rpc history <ADDRESS> --limit 20
orbitflare rpc program-accounts <PROGRAM_ID> --limit 10
orbitflare rpc slot
orbitflare rpc epoch
orbitflare rpc blockhash
orbitflare rpc stats
orbitflare rpc priority-fees --account <ADDRESS>
orbitflare rpc raw '{"jsonrpc":"2.0","id":1,"method":"getSlot","params":[]}'

rpc tokens, Token ve Token-2022 hesaplarını listeler. rpc history, getTransactionsForAddress kullanır ve filtreler ile sayfalama alır:

# Oldest first, failed transactions only, from a date
orbitflare rpc history <ADDRESS> --oldest-first --status failed --since 2026-01-01

# Include token account activity, then fetch the next page
orbitflare rpc history <ADDRESS> --token-accounts balanceChanged --limit 100
orbitflare rpc history <ADDRESS> --page-token <TOKEN>

DAS Komutları

Token’ları, NFT’leri ve sıkıştırılmış NFT’leri Digital Asset Standard API üzerinden sorgulayın. Liste komutları --limit (en fazla 1000) ve --page alır.

# One or more assets by ID
orbitflare das asset <ID> [<ID>...]

# Wallet portfolio: SOL, priced tokens and NFTs
orbitflare das owner <WALLET>
orbitflare das owner <WALLET> --tokens
orbitflare das owner <WALLET> --nfts

# Search by owner, creator, authority, collection, name, type, compression or burn state
orbitflare das search --owner <WALLET> --token-type compressedNFT
orbitflare das search --creator <ADDRESS> --burnt false

# Assets in a collection, token accounts of a mint
orbitflare das collection <COLLECTION>
orbitflare das holders <MINT>

# Compressed asset Merkle proof and history
orbitflare das proof <ASSET_ID>
orbitflare das signatures <ASSET_ID>

Apex Komutları

İşlemleri Apex üzerinden gönderin. ping ve tip-accounts anahtar gerektirmez; send ve transfer, auth set-apex-key ile saklanan veya ORBITFLARE_APEX_KEY içindeki Apex API anahtarını kullanır.

orbitflare apex ping
orbitflare apex tip-accounts --region fra
orbitflare apex send <BASE64_TX> --region fra --confirm
orbitflare apex send --file tx.b64
orbitflare apex transfer <TO> <SOL> --wallet ~/.config/solana/id.json --tip 0.001

Bölgeler: global, fra, ams, dub, lon, nyc, slc, sgp, tyo, sqq. Her işlem, bir Apex bahşiş hesabına en az 0.001 SOL gönderen tam olarak bir üst düzey SystemProgram transferi içermelidir; send bunu göndermeden önce denetler, transfer ise sizin yerinize ekler.

WebSocket komutları

WebSocket üzerinden canlı Solana pubsub olaylarına abone olun. Her abonelik Ctrl+C basana kadar çalışır ve olayları geldikçe yazdırır (makine tarafından okunabilir çıktı için --json kullanın).

# Live slot updates
orbitflare ws slot

# Account changes for a specific address
orbitflare ws account <ADDRESS>

# Transaction logs mentioning one or more addresses (omit --mentions for all)
orbitflare ws logs --mentions <ADDRESS> --mentions <ANOTHER>

# Confirmation of a single transaction signature
orbitflare ws signature <SIGNATURE>

Uç nokta RPC uç noktanızdan türetilir: http:// → ws://, https:// → wss://. Tek komutta farklı bir ana bilgisayar hedeflemek için --ws-url geçin:

orbitflare ws slot --ws-url wss://ams.rpc.orbitflare.com

Akış komutları

gRPC üzerinden gerçek zamanlı Solana verisini akışa alın. Her iki komut da filtrelerinizi ve yeniden bağlanma stratejinizi tanımlayan bir YAML yapılandırma dosyası alır, Ctrl+C ile ya da --duration <SECONDS> sonunda durur ve --json ile her olay için bir JSON nesnesi yazdırır.

Jetstream
Yellowstone gRPC

orbitflare jet --config stream.yml

# Inline filters, no config file
orbitflare jet --required 6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P --enrichment

# Slot lifecycle events (alive, complete, dead)
orbitflare jet --slots

Jetstream, v2 protokolü üzerinden ultra düşük gecikmeli işlem akışı sağlar. Filtreler account_include, account_exclude ve account_required alır; Jetstream’de hesap filtresi yoktur, hesap güncellemeleri için Yellowstone gRPC kullanın. --enrichment ya da herhangi bir filtrede include_enrichment: true, ücret ödeyiciyi, hesaplama birimi fiyatı ve limitini, öncelik ücretini, program kimliklerini, yazılabilir hesapları, işlem boyutunu ve çözümlenmiş adres arama tablosu adreslerini ekler. --v1 kullanımdan kaldırılmış v1 protokolünü kullanır.

stream.yml

transactions:
  pump_trades:
    account_include:
      - "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P"
    include_enrichment: true

reconnect:
  initial_delay_ms: 100
  max_delay_ms: 30000
  multiplier: 2.0
  max_retries: 0    # 0 = unlimited

orbitflare grpc --config grpc-stream.yml

Yellowstone, slotlar ve blok üst verisi dahil tam Geyser eklentisi veri akışını sağlar.

grpc-stream.yml

transactions:
  jupiter_swaps:
    account_include:
      - "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"
    vote: false
    failed: false

slots:
  all_slots:
    filter_by_commitment: true

commitment: confirmed

reconnect:
  initial_delay_ms: 100
  max_delay_ms: 30000
  multiplier: 2.0
  max_retries: 0

Her iki akış komutu da otomatik uç nokta yedeklemesi ve üstel geri çekilme ile yeniden bağlanmayı destekler. Yapılandırma dosyalarında ${VAR} sözdizimi ile ortam değişkenleri kullanılabilir.

Şablon komutları

Üretime hazır başlangıç şablonlarından projeler iskeletleyin.

# List all templates
orbitflare template --list

# Filter by language
orbitflare template --list --filter rust

# View template details
orbitflare template --view solana-copy-trader

# Install a template
orbitflare template --install solana-copy-trader --dir ./my-bot

Şablonlar orbitflare/templates deposundan alınır ve çevrimdışı kullanım için yerel önbelleğe alınır.

Plan komutları

Mevcut RPC planlarına göz atın ve karşılaştırın. Plan verisi yerel olarak 6 saat önbelleğe alınır. Giriş yapılmamışsa herkese açık katalog gösterilir.

# List all plans (sorted by price)
orbitflare plan list

# View plan details
orbitflare plan view <SLUG>

# Compare all plans side by side
orbitflare plan compare --all

# Compare specific plans
orbitflare plan compare dev growth scale

Ödeme komutları

Hesap bakiyenizi yönetin, plan satın alın ve faturaları halledin. Yalnızca topup Solana cüzdanı gerektirir — geri kalanı hesap bakiyenizi kullanır.

# Check account balance
orbitflare pay check-balance

# Top up balance with USDC (on-chain)
orbitflare pay topup <AMOUNT> --wallet ~/.config/solana/id.json

# Top-up / credit history
orbitflare pay history

# Purchase a plan from balance
orbitflare pay purchase <SLUG> <PERIOD> --coupon <CODE>

# View orders
orbitflare pay order --history
orbitflare pay order <REFERENCE>

# View invoices
orbitflare pay invoice --list
orbitflare pay invoice <REFERENCE>

# Pay an invoice from balance (renewal)
orbitflare pay renew <INVOICE_REF>

topup komutu cüzdan anahtar çifti için varsayılan olarak ~/.config/solana/id.json kullanır. Farklı bir yol için --wallet kullanın. Faturalama dönemleri: monthly, quarterly, semi-annual, annual.

purchase komutu önce kuru bir doğrulama çalıştırır; onaylamadan önce fiyat dökümünü ve bakiyenizin yeterli olup olmadığını gösterir.

Gösterge paneli

Terminalden çıkmadan OrbitFlare hesabınızı yönetmek için etkileşimli bir TUI başlatın.

orbitflare dashboard

Gösterge paneli profilinize, hizmetlere, API anahtarlarına ve faturalara tam klavye ile erişim sağlar. Lisans anahtarı ayarlıysa üst çubuk DAS API’den canlı token fiyatlarını gösterir.

Gezinme kısayolları

Tuş	Eylem
`q`	Çıkış
`Esc`	Geri
`Tab`	Sekme / odak değiştir
`↑↓` / `jk`	Gezin
`Enter`	Seç / genişlet / aç-kapa
`t` / `T`	Temayı değiştir
`[`	Kenar çubuğunu aç-kapa
`R`	Verileri yenile

Hizmet yönetimi kısayolları

Tuş	Sekme	Eylem
`m`	Ayrıntılar	Kimlik modunu aç-kapa (IP / API anahtarı)
`w`	Ayrıntılar	Otomatik yenilemeyi aç-kapa
`r`	Ayrıntılar	Lisans anahtarını yeniden üret
`n`	IP’ler / Alanlar	Mainnet / Devnet arasında geç
`a`	IP’ler / Alanlar	IP veya alan ekle
`d`	IP’ler / Alanlar	IP veya alan kaldır

API anahtarı yönetimi kısayolları

Tuş	Eylem
`c`	Yeni API anahtarı oluştur
`e`	Etkin / devre dışı aç-kapa
`r`	Anahtarı yeniden üret
`x`	Anahtarı sil
`a`	IP ekle (genişletilmişken)
`d`	IP kaldır (genişletilmişken)

Fatura ve profil kısayolları

Tuş	Bölüm	Eylem
`p`	Faturalar	Hesap bakiyesiyle öde
`e`	Profil	Adı ve ödeme cüzdanını düzenle

JSON çıktısı

Tüm komutlar makine tarafından okunabilir çıktı için --json destekler; böylece CLI betiklere ve otomasyon boru hatlarına kolayca entegre olur.

orbitflare rpc slot --json
orbitflare rpc balance Gh9ZwEm... --json
orbitflare auth status --json

Örnek çıktı:

{
  "confirmed": 312849571,
  "finalized": 312849539
}

Yapılandırma

Yapılandırma ~/.orbitflare/config.yml dosyasında saklanır. config komutuyla yönetin:

# View current config
orbitflare config show

# Set network
orbitflare config set network devnet

# Set region for all default endpoints
orbitflare config set region ams

# Set RPC endpoint
orbitflare config set rpc.url https://ams.rpc.orbitflare.com

# Set gRPC and Jetstream endpoints
orbitflare config set grpc.url http://ams.rpc.orbitflare.com:10000
orbitflare config set jetstream.url http://ams.jetstream.orbitflare.com

# Set commitment level
orbitflare config set commitment finalized

# Change TUI theme
orbitflare config set theme dracula

# Set template repository
orbitflare config set templates.repo https://github.com/your-org/templates

# Reset to defaults
orbitflare config reset

Devnet uç noktaları varsayılan olarak önceden yapılandırılmıştır:

RPC: https://devnet.rpc.orbitflare.com (yedek: https://api.devnet.solana.com)
gRPC: http://devnet.rpc.orbitflare.com:10000

Çalışma zamanında geçiş için --network devnet kullanın. Jetstream yalnızca mainnet’te çalışır.

Dosya konumları

~/.orbitflare/
├── config.yml                  # Main configuration
├── templates_cache.json        # Template registry cache
└── cache/
    └── rpc-plans.json          # Plans cache (6-hour TTL)

API anahtarları, belirteçler ve lisans anahtarları işletim sistemi anahtarlığında saklanır, diskte değil.

Genel bayraklar

Bu bayraklar her komutta çalışır ve o çağrı için ilgili yapılandırma değerini geçersiz kılar.

Bayrak	Açıklama
`--json`	Ham JSON çıktısı
`--raw`	Minimal çıktı, biçimlendirme yok
`--network <NET>`	Ağı geçersiz kılar (`mainnet` / `devnet`)
`--region <CODE>`	Varsayılan uç noktalar için bölge
`--commitment <C>`	Taahhüdü geçersiz kılar (`processed` / `confirmed` / `finalized`)
`--rpc-url <URL>`	RPC uç noktasını geçersiz kılar
`--grpc-url <URL>`	Yellowstone gRPC uç noktasını geçersiz kılar
`--jetstream-url <URL>`	Jetstream uç noktasını geçersiz kılar
`--ws-url <URL>`	WebSocket uç noktasını geçersiz kılar (varsayılan: RPC URL’sinden türetilir)
`--fallback-url <URL>`	Yedek URL’ler (tekrarlanabilir)
`--profile <NAME>`	Belirli bir kimlik profili kullan
`--quiet`	Gerekli olmayan çıktıyı bastır
`--no-color`	Renkli çıktıyı kapat

Tam iş akışı örneği

Kurulumdan sorguya kadar eksiksiz bir tur:

# 1. Install the CLI
cargo install orbitflare

# 2. Authenticate
orbitflare auth login --x-orbit-key YOUR_API_KEY

# 3. Pick your region
orbitflare config set region ams

# 4. Verify connectivity
orbitflare ping

# 5. Query the blockchain
orbitflare rpc slot
orbitflare rpc balance YOUR_WALLET_ADDRESS

# 6. Scaffold a project
orbitflare template --install solana-copy-trader --dir ./my-bot

# 7. Stream real-time data
orbitflare jet --config stream.yml
orbitflare jet --required 6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P --enrichment

Sırada ne var?

RPC yöntemleri

Tam Solana RPC yöntemi referansını keşfedin.

Jetstream akışı

Gerçek zamanlı gRPC veri akışı hakkında bilgi edinin.

Yellowstone gRPC

Yellowstone ile tam Geyser eklentisi verisi.

Başlangıç şablonları

Üretime hazır proje şablonlarına göz atın.

Destek

Discord

Yardım ve tartışmalar için topluluğa katılın.

GitHub

Sorun bildirin veya CLI’ye katkıda bulunun.

​Kurulum

​Hızlı başlangıç: Mevcut kullanıcılar

​Hızlı başlangıç: Yeni kullanıcılar

​Kimlik doğrulama

​Kimlik doğrulama yöntemleri

​Anahtar çözümleme sırası

​Komut referansı

​Temel komutlar

​RPC komutları

​DAS Komutları

​Apex Komutları

​WebSocket komutları

​Akış komutları

​Şablon komutları

​Plan komutları

​Ödeme komutları

​Gösterge paneli

​JSON çıktısı

​Yapılandırma

​Dosya konumları

​Genel bayraklar

​Tam iş akışı örneği

​Sırada ne var?

RPC yöntemleri

Jetstream akışı

Yellowstone gRPC

Başlangıç şablonları

​Destek

Discord

GitHub

Kurulum

Hızlı başlangıç: Mevcut kullanıcılar

Hızlı başlangıç: Yeni kullanıcılar

Kimlik doğrulama

Kimlik doğrulama yöntemleri

Anahtar çözümleme sırası

Komut referansı

Temel komutlar

RPC komutları

DAS Komutları

Apex Komutları

WebSocket komutları

Akış komutları

Şablon komutları

Plan komutları

Ödeme komutları

Gösterge paneli

JSON çıktısı

Yapılandırma

Dosya konumları

Genel bayraklar

Tam iş akışı örneği

Sırada ne var?

Destek