Befehle von ERPC CLI

Alle Befehlsgruppen von ERPC CLI in einer Tabelle, die Optionen, die bei jedem Befehl funktionieren, und die Exit-Codes, auf die sich ein Skript verlassen kann.

Diese Seite beschreibt ERPC CLI v0.1.0-rc.4, eine Vorabversion.

Befehlsgruppen

Führen Sie eine beliebige Befehlsgruppe ohne Verb aus, etwa erpc validator oder erpc worker, um ihre Verben aufzulisten.

Befehl	Was er tut
`validator` (`v`), `rpc` (`r`), `node` (`n`)	Validatoren und RPC-Knoten
`rpc call`	Sendet eine JSON-RPC-Anfrage an einen Shared-, eigenen oder x402-Endpunkt (RPC-Aufrufe und Webhooks)
`webhook`	Verwaltet lokale RPC-Abonnements und stellt Ereignisse an einen HTTP-Callback zu
`ai`, `resume`, `memory`, `skills`	ERPC AI, die gespeicherten Konversationen, das Gedächtnis und die Skills
`worker` (`w`)	Ihre eigenen Anwendungen auf einem Server
`storage` (`st`), `backup`	ERPC Global Storage und Backups von Rechnern (unten)
`wallet`	Die Base-Wallet, die ERPC Credit mit EURC kauft (Aus einer Wallet bezahlen)
`signup`, `login`, `logout`, `whoami`	Ihr ERPC-Konto (Anmeldung und Schlüssel)
`doctor`	Meldet, wie dieser Rechner Ihre Sitzung speichert
`config`	Liest und ändert `~/.erpc/config.toml` (nur öffentliche Einstellungen). `erpc config init` schreibt eine kommentierte Ausgangsdatei, sofern noch keine vorhanden ist
`version`	Version, Build- und Komponenteninformationen
`completions`	Erzeugt Shell-Vervollständigungen: `erpc completions zsh`, außerdem für bash, fish, powershell und elvish

Globale Optionen

--json liefert maschinenlesbare Ausgabe: erpc --json <command>. ERPC_JSON=true hat dieselbe Wirkung. Bei Knotenbefehlen muss --json vor dem Befehl stehen.
--lang legt die Sprache fest, in der erpc spricht: en, ja, zh oder ru. Ohne diese Option verwendet erpc die Einstellung locale und, falls diese fehlt, die Sprache des Systems.

Fehler und Exit-Codes

Ein Fehlschlag sieht überall gleich aus: eine Zeile error:, die sagt, was schiefgelaufen ist, und eine Zeile hint:, die sagt, was als Nächstes zu tun ist, sofern es so etwas gibt. Mit --json ist ein Fehlschlag ein einzelnes Objekt auf der Standardausgabe, {"error": {"code", "exit", "message", "hint"}}. Zwei Fälle geben stattdessen die eigene Meldung von clap aus und enden mit dem Exit-Status 2: eine Befehlszeile, die clap an einem Terminal nicht parsen kann, und ein Argument, das das Verb eines Knotenbaums (erpc validator, rpc, node) nicht annimmt, selbst mit --json. Ein Feld details erscheint nur, wenn ein Befehl einem Skript mehr darüber zu sagen hat, was er vor dem Fehlschlag getan hat, und nie an einem Terminal.

Exit	Code	Bedeutung
0		Es hat funktioniert
1	`failed`	Es konnte nicht tun, was verlangt wurde
2	`usage`	Die Befehlszeile war nicht verwendbar
3	`needs_terminal`	Eine Person muss antworten: Übergeben Sie `--yes` oder führen Sie den Befehl in einem Terminal aus
4	`not_signed_in`	Führen Sie `erpc login` aus
5	`problems_found`	Eine Prüfung (`status`, `doctor`) hat Probleme gefunden, und ihr Bericht nennt sie
6	`declined`	Sie haben Nein gesagt, und nichts wurde geändert
7	`network`	ERPC oder ein anderer Dienst war nicht erreichbar

Wird erpc durch Ctrl-C (oder SIGTERM, SIGHUP) gestoppt, endet es durch das Signal selbst, sodass auch eine Schleife in einem Skript anhält. Ein veröffentlichter Code behält seinen Namen und seinen Exit-Status, und ein Code wird nie wiederverwendet.

Speicher und Backups

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 5        # an ERPC Global Storage plan
erpc backup init          # back this machine up with restic, on a schedule if you like

erpc storage buy kauft einen Plan von ERPC Global Storage, bezahlt mit ERPC Credit. Pläne und Preise stehen auf der Seite Preise.

erpc storage

erpc storage put verschlüsselt eine Datei auf diesem Rechner, bevor irgendein Teil davon gesendet wird, sofern nicht --no-encrypt angegeben ist. ERPC speichert nur die verschlüsselten Bytes und besitzt den Schlüssel nie. erpc storage get erkennt eine verschlüsselte Datei und entschlüsselt sie.
Es gibt einen Storage-Schlüssel pro Konto, aufbewahrt in dem Speicherort, den erpc login gewählt hat. erpc bewahrt ihn nicht im Linux-Kernel-Keyring auf, der beim Neustart verloren geht: Melden Sie sich mit --store 1password oder --store file an, oder verwenden Sie --no-encrypt. Mit dem Speicherort file liegt der Schlüssel unverschlüsselt in ~/.erpc/storage-key (Modus 0600). --no-encrypt lädt die Datei, die Sie senden, unverändert und unverschlüsselt hoch.
Wer den Storage-Schlüssel verliert, verliert jede damit verschlüsselte Datei, und ERPC kann ihn nicht wiederherstellen. erpc storage key export --show gibt den Schlüssel aus, damit eine Kopie getrennt vom Rechner aufbewahrt werden kann, und erpc storage key import übernimmt ihn auf einem anderen Rechner.
Der Pfad, unter dem eine Datei gespeichert ist, und ihre Größe sind für ERPC sichtbar.
erpc storage keys list zeigt die Zugriffsschlüssel für den Storage, und erpc storage keys revoke <n> widerruft einen davon.

erpc backup

erpc backup sichert einen Rechner mit restic in ERPC Global Storage. Dateien werden auf Ihrem Rechner verschlüsselt, bevor sie ihn verlassen, und ERPC besitzt nie ein Passwort, das die Backups öffnet.

Befehl	Was er tut
`erpc backup init`	Installiert restic, erstellt die Zugriffsschlüssel und das Repository und gibt diesem Rechner einen eigenen restic-Schlüssel
`erpc backup run [paths]`	Erstellt ein Backup. Unter Linux ohne Pfadangabe `/`, ausgenommen Pseudo-Dateisysteme, Mounts und flüchtige Pfade. Auf anderen Systemen geben Sie die Pfade an
`erpc backup snapshots`	Die Snapshots dieses Rechners; `--all-hosts` für die aller Rechner
`erpc backup restore <id\|latest>`	Stellt in einem neuen Verzeichnis wieder her, sofern `--target` kein anderes angibt. `--in-place` überschreibt diesen Rechner, nach einer Rückfrage
`erpc backup check`	Prüft das Repository und liest 5 % der Daten zurück
`erpc backup prune`	Behält 7 tägliche, 4 wöchentliche und 6 monatliche Snapshots eines Rechners, nach einer Rückfrage
`erpc backup schedule daily\|weekly\|off [paths]`	Führt `run` per Timer aus, zu der Uhrzeit aus `--at` (Standard 03:00)
`erpc backup status`	Der Zeitplan und wie der letzte Lauf endete
`erpc backup password --show`	Gibt das Master-Passwort des Repositorys aus, um eine Kopie an anderer Stelle aufzubewahren

Jeder Rechner erhält einen Append-only-Schlüssel, der seine eigenen Backups nicht löschen kann. Der Rechner, auf dem Sie erpc backup init ausgeführt haben, besitzt auch die Schlüssel, die das können; der Schutz gilt also nur auf einem Rechner, der weder die erpc-Sitzung noch die Backup-Secrets des Kontos aufbewahrt.
Bewahren Sie eine Kopie von erpc backup password --show getrennt von den Rechnern auf. Wer das Master-Passwort und die backup.env jedes Rechners verliert, verliert die Backups.
Ein Backup lässt bekannte Schlüsseldateien und System-Secrets aus, etwa .ssh/id_*, .config/solana/id.json, die Sitzung von erpc und die SSH-Host-Schlüssel. Schlüsselmaterial unter einem anderen Namen oder an einem anderen Ort wird wie jede andere Datei gesichert: Schließen Sie es mit --exclude aus.
erpc installiert restic 0.19.1 und prüft sowohl das Archiv als auch das Programm gegen SHA-256-Digests, die in erpc einkompiliert sind.
Zeitplanung: Unter Linux sudo erpc backup init, dann sudo erpc backup schedule daily. Unter macOS erpc backup schedule daily ~/Documents; der Job läuft unter Ihrem Benutzer, solange Sie angemeldet sind.
Backups gehen in die Standardregion des Kontos. erpc backup läuft auf dem Rechner, den es sichert; der Server eines Workers wird stattdessen mit erpc worker backup on eingerichtet (Den Zustand der Anwendung sichern).