ERPC CLI komutları

Tüm ERPC CLI komut grupları tek bir tabloda; ayrıca her komutta çalışan seçenekler ve bir betiğin güvenebileceği çıkış kodları.
Bu sayfada bir ön sürüm olan ERPC CLI v0.1.0-rc.4 anlatılır.

Komut grupları

Alt komutlarını listelemek için herhangi bir komut grubunu, örneğin erpc validator veya erpc worker grubunu, alt komut olmadan çalıştırın.
KomutNe yapar
validator (v), rpc (r), node (n)Validator'lar ve RPC düğümleri
rpc callPaylaşımlı, özel veya x402 endpoint'ine tek bir JSON-RPC isteği gönderir (RPC çağrıları ve webhook'lar)
webhookYerel RPC aboneliklerini yönetir ve olayları bir HTTP geri çağırma adresine iletir
ai, resume, memory, skillsERPC AI, kayıtlı konuşmaları, hafızası ve becerileri
worker (w)Bir sunucudaki kendi uygulamalarınız
storage (st), backupERPC Global Storage ve makine yedekleri (aşağıda)
walletERPC Credit'i EURC ile satın alan Base cüzdanı (Cüzdandan ödeme)
signup, login, logout, whoamiERPC hesabınız (Oturum açma ve anahtarlar)
doctorBu makinenin oturumunuzu nasıl sakladığını raporlar
config~/.erpc/config.toml dosyasını okur ve değiştirir (yalnızca herkese açık ayarlar). erpc config init, mevcut bir dosya yoksa yorumlu bir başlangıç dosyası yazar
versionSürüm, derleme ve bileşen bilgileri
completionsKabuk tamamlamaları üretir: erpc completions zsh; ayrıca bash, fish, powershell ve elvish

Genel seçenekler

  • --json makinece okunabilir çıktı verir: erpc --json <command>. ERPC_JSON=true da aynı etkiyi yapar. Düğüm komutlarında --json komuttan önce gelmelidir.
  • --lang erpc'nin konuştuğu dili ayarlar: en, ja, zh veya ru. Bu seçenek verilmezse erpc locale ayarını, o da yoksa sistemin dilini kullanır.

Hatalar ve çıkış kodları

Bir hata her yerde aynı biçimde okunur: neyin yanlış gittiğini söyleyen bir error: satırı ve varsa, sonra ne yapılacağını söyleyen bir hint: satırı. --json ile bir hata, standart çıktıda tek bir nesnedir: {"error": {"code", "exit", "message", "hint"}}. İki durumda ise bunun yerine clap'in kendi mesajı yazdırılır ve çıkış kodu 2 olur: clap'in terminalde ayrıştıramadığı bir komut satırı ve --json altında bile, bir düğüm ağacının (erpc validator, rpc, node) alt komutunun almadığı bir argüman. details alanı yalnızca bir komutun, başarısız olmadan önce ne yaptığına dair bir betiğe söyleyecek daha fazla şeyi olduğunda görünür ve terminalde asla görünmez.
ÇıkışKodAnlamı
0Başarılı oldu
1failedİsteneni yapamadı
2usageKomut satırı kullanılabilir değildi
3needs_terminalBir kişinin yanıt vermesi gerekir: --yes verin veya komutu terminalde çalıştırın
4not_signed_inerpc login çalıştırın
5problems_foundBir kontrol (status, doctor) sorun buldu; hangileri olduğunu raporu söyler
6declinedHayır dediniz ve hiçbir şey değiştirilmedi
7networkERPC'ye veya başka bir hizmete ulaşılamadı
Ctrl-C (veya SIGTERM, SIGHUP) ile durdurulduğunda erpc doğrudan o sinyalle sonlanır; böylece bir betikteki döngü de durur. Yayımlanmış bir kod adını ve çıkış kodunu korur ve bir kod asla yeniden kullanılmaz.

Depolama ve yedekler

bash
erpc storage buy 5        # an ERPC Global Storage plan
erpc backup init          # back this machine up with restic, on a schedule if you like
erpc storage buy, ERPC Credit ile ödenen bir ERPC Global Storage planı satın alır. Planlar ve fiyatlar Fiyatlandırma sayfasında yer alır.

erpc storage

  • erpc storage put, --no-encrypt verilmedikçe bir dosyayı, herhangi bir kısmı gönderilmeden önce bu makinede şifreler. ERPC yalnızca şifrelenmiş baytları saklar ve anahtarı asla tutmaz. erpc storage get şifrelenmiş bir dosyayı fark eder ve şifresini çözer.
  • Hesap başına bir depolama anahtarı vardır ve erpc login komutunun seçtiği saklama yerinde tutulur. erpc bu anahtarı, makine yeniden başlatıldığında kaybolan Linux çekirdeğinin anahtarlığında tutmaz: --store 1password veya --store file ile oturum açın ya da --no-encrypt kullanın. file saklama yeri kullanıldığında anahtar ~/.erpc/storage-key içinde (mod 0600) şifrelenmemiş olarak durur. --no-encrypt, gönderdiğiniz dosyayı şifrelemeden olduğu gibi yükler.
  • Depolama anahtarını kaybetmek, onunla şifrelenmiş her dosyayı kaybetmek demektir ve ERPC bu anahtarı kurtaramaz. erpc storage key export --show, bir kopyası makineden uzakta saklanabilsin diye anahtarı yazdırır; erpc storage key import ise anahtarı başka bir makinede yeniden içe aktarır.
  • Bir dosyanın saklandığı yol ve dosyanın boyutu ERPC tarafından görülebilir.
  • erpc storage keys list depolama erişim anahtarlarını gösterir; erpc storage keys revoke <n> bunlardan birini iptal eder.

erpc backup

erpc backup, bir makineyi restic ile ERPC Global Storage'a yedekler. Dosyalar makinenizden çıkmadan önce makinenizde şifrelenir ve ERPC yedekleri açan bir parolayı asla tutmaz.
KomutNe yapar
erpc backup initrestic'i kurar, erişim anahtarlarını ve depoyu oluşturur ve bu makineye kendi restic anahtarını verir
erpc backup run [paths]Yedekler. Linux'ta yol verilmezse sahte dosya sistemleri, bağlama noktaları ve geçici yollar dışında kalan /. Diğer sistemlerde yolları belirtin
erpc backup snapshotsBu makinenin snapshot'ları; tüm makinelerinkiler için --all-hosts
erpc backup restore <id|latest>--target başka bir dizin belirtmedikçe yeni bir dizine geri yükler. --in-place sorduktan sonra bu makinenin üzerine yazar
erpc backup checkDepoyu kontrol eder ve verinin %5'ini geri okur
erpc backup pruneSorduktan sonra, bir makinenin günlük 7, haftalık 4 ve aylık 6 snapshot'ını tutar
erpc backup schedule daily|weekly|off [paths]run komutunu bir zamanlayıcıyla, --at ile verilen saatte çalıştırır (varsayılan 03:00)
erpc backup statusZamanlama ve son çalıştırmanın nasıl sonlandığı
erpc backup password --showKopyası başka bir yerde saklansın diye deponun ana parolasını yazdırır
  • Her makine yalnızca ekleme yapabilen bir anahtar alır; bu anahtar kendi yedeklerini silemez. erpc backup init komutunu çalıştırdığınız makine, silebilen anahtarları da tutar; bu yüzden koruma yalnızca ne erpc oturumunu ne de hesabın yedek gizli değerlerini tutan bir makinede geçerlidir.
  • erpc backup password --show çıktısının bir kopyasını makinelerden uzakta saklayın. Ana parolayı ve her makinenin backup.env dosyasını kaybetmek, yedekleri kaybetmek demektir.
  • Bir yedek, bilinen anahtar dosyalarını ve sistem gizli değerlerini dışarıda bırakır; örneğin .ssh/id_*, .config/solana/id.json, erpc'nin oturumu ve SSH host anahtarları. Başka bir adla veya başka bir yerde bulunan anahtar materyali diğer dosyalar gibi yedeklenir: bunu --exclude ile dışarıda bırakın.
  • erpc, restic 0.19.1'i kurar ve hem arşivi hem de programı erpc'ye derlenmiş SHA-256 özetleriyle kontrol eder.
  • Zamanlama: Linux'ta sudo erpc backup init, ardından sudo erpc backup schedule daily. macOS'te erpc backup schedule daily ~/Documents; iş sizin kullanıcınızla, siz oturum açmışken çalışır.
  • Yedekler hesabın varsayılan bölgesine gider. erpc backup yedeklediği makinede çalışır; bir worker'ın sunucusu ise bunun yerine erpc worker backup on ile ayarlanır (Uygulamanın durum verisini yedekleme).