Commandes d'ERPC CLI

Tous les groupes de commandes d'ERPC CLI dans un seul tableau, les options valables pour toutes les commandes et les codes de sortie sur lesquels un script peut compter.

Cette page décrit ERPC CLI v0.1.0-rc.4, une préversion.

Groupes de commandes

Exécutez n'importe quel groupe de commandes sans verbe, comme erpc validator ou erpc worker, pour lister ses verbes.

Commande	Ce qu'elle fait
`validator` (`v`), `rpc` (`r`), `node` (`n`)	Validateurs et nœuds RPC
`rpc call`	Envoie une requête JSON-RPC à un endpoint partagé, personnalisé ou x402 (Appels RPC et webhooks)
`webhook`	Gère les abonnements RPC locaux et livre les événements à un callback HTTP
`ai`, `resume`, `memory`, `skills`	ERPC AI, ses conversations enregistrées, ses faits mémorisés et ses skills
`worker` (`w`)	Vos propres applications sur un serveur
`storage` (`st`), `backup`	ERPC Global Storage et sauvegardes de machines (ci-dessous)
`wallet`	Le wallet Base qui achète de l'ERPC Credit avec des EURC (Payer depuis un wallet)
`signup`, `login`, `logout`, `whoami`	Votre compte ERPC (Connexion et clés)
`doctor`	Indique comment cette machine stocke votre session
`config`	Lit et modifie `~/.erpc/config.toml` (paramètres publics uniquement). `erpc config init` écrit un fichier de départ commenté, sauf s'il en existe déjà un
`version`	Informations de version, de build et de composants
`completions`	Génère les complétions du shell : `erpc completions zsh`, ainsi que bash, fish, powershell et elvish

Options globales

--json produit une sortie lisible par une machine : erpc --json <command>. ERPC_JSON=true a le même effet. Sur les commandes de nœud, --json doit être placé avant la commande.
--lang définit la langue dans laquelle erpc s'exprime : en, ja, zh ou ru. Sans cette option, erpc utilise le paramètre locale, à défaut la langue du système.

Erreurs et codes de sortie

Un échec se présente partout de la même façon : une ligne error: qui dit ce qui s'est mal passé, et une ligne hint: qui dit quoi faire ensuite, lorsqu'il y en a une. Avec --json, un échec est un seul objet sur la sortie standard, {"error": {"code", "exit", "message", "hint"}}. Deux cas affichent à la place le message propre à clap et sortent avec le statut 2 : une ligne de commande que clap ne parvient pas à analyser dans un terminal, et un argument que le verbe d'une arborescence de nœuds (erpc validator, rpc, node) n'accepte pas, même avec --json. Un champ details n'apparaît que lorsqu'une commande a davantage à dire à un script sur ce qu'elle a fait avant d'échouer, et jamais dans un terminal.

Sortie	Code	Signification
0		La commande a abouti
1	`failed`	La commande n'a pas pu faire ce qui était demandé
2	`usage`	La ligne de commande n'était pas utilisable
3	`needs_terminal`	Une personne doit répondre : passez `--yes` ou exécutez la commande dans un terminal
4	`not_signed_in`	Exécutez `erpc login`
5	`problems_found`	Une vérification (`status`, `doctor`) a trouvé des problèmes, et son rapport indique lesquels
6	`declined`	Vous avez répondu non, et rien n'a été modifié
7	`network`	ERPC ou un autre service n'a pas pu être joint

Interrompu par Ctrl-C (ou SIGTERM, SIGHUP), erpc se termine par le signal lui-même, si bien qu'une boucle dans un script s'arrête aussi. Un code publié conserve son nom et son statut de sortie, et un code n'est jamais réutilisé.

Stockage et sauvegardes

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 achète un forfait ERPC Global Storage, payé en ERPC Credit. Les forfaits et les prix figurent sur la page Tarifs.

erpc storage

erpc storage put chiffre un fichier sur cette machine avant d'en envoyer quoi que ce soit, sauf si --no-encrypt est indiqué. ERPC ne stocke que les octets chiffrés et ne détient jamais la clé. erpc storage get reconnaît un fichier chiffré et le déchiffre.
Il existe une clé de stockage par compte, conservée dans l'emplacement de stockage choisi par erpc login. erpc ne la conserve pas dans le keyring du noyau Linux, qui est perdu au redémarrage : connectez-vous avec --store 1password ou --store file, ou utilisez --no-encrypt. Avec le stockage file, la clé se trouve dans ~/.erpc/storage-key (mode 0600), non chiffrée. --no-encrypt téléverse le fichier que vous envoyez tel quel, sans le chiffrer.
Perdre la clé de stockage, c'est perdre tous les fichiers chiffrés avec elle, et ERPC ne peut pas la récupérer. erpc storage key export --show affiche la clé afin d'en garder une copie hors de la machine, et erpc storage key import la réimporte sur une autre machine.
Le chemin sous lequel un fichier est stocké, ainsi que sa taille, sont visibles par ERPC.
erpc storage keys list affiche les clés d'accès au stockage, et erpc storage keys revoke <n> en révoque une.

erpc backup

erpc backup sauvegarde une machine sur ERPC Global Storage avec restic. Les fichiers sont chiffrés sur votre machine avant de la quitter, et ERPC ne détient jamais de mot de passe permettant d'ouvrir les sauvegardes.

Commande	Ce qu'elle fait
`erpc backup init`	Installe restic, crée les clés d'accès et le dépôt, et donne à cette machine sa propre clé restic
`erpc backup run [paths]`	Effectue la sauvegarde. Sous Linux, sans chemin indiqué, `/` hors pseudo-systèmes de fichiers, points de montage et chemins volatils. Ailleurs, indiquez les chemins
`erpc backup snapshots`	Les snapshots de cette machine ; `--all-hosts` pour ceux de toutes les machines
`erpc backup restore <id\|latest>`	Restaure dans un nouveau répertoire, sauf si `--target` en désigne un autre. `--in-place` écrase les données de cette machine, après confirmation
`erpc backup check`	Vérifie le dépôt et relit 5 % des données
`erpc backup prune`	Conserve 7 snapshots quotidiens, 4 hebdomadaires et 6 mensuels d'une machine, après confirmation
`erpc backup schedule daily\|weekly\|off [paths]`	Exécute `run` selon un minuteur, à l'heure `--at` (03:00 par défaut)
`erpc backup status`	La planification, et la façon dont la dernière exécution s'est terminée
`erpc backup password --show`	Affiche le mot de passe maître du dépôt, pour en garder une copie ailleurs

Chaque machine reçoit une clé en ajout seul qui ne peut pas supprimer ses propres sauvegardes. La machine sur laquelle vous avez exécuté erpc backup init détient aussi les clés qui le peuvent : la protection ne vaut donc que sur une machine qui ne conserve ni la session erpc ni les secrets de sauvegarde du compte.
Gardez une copie de erpc backup password --show hors des machines. Perdre le mot de passe maître et le backup.env de chaque machine, c'est perdre les sauvegardes.
Une sauvegarde exclut les fichiers de clés connus et les secrets système, comme .ssh/id_*, .config/solana/id.json, la session d'erpc et les clés d'hôte SSH. Du matériel de clés portant un autre nom ou situé ailleurs est sauvegardé comme n'importe quel autre fichier : excluez-le avec --exclude.
erpc installe restic 0.19.1 et vérifie l'archive comme le programme par rapport à des empreintes SHA-256 compilées dans erpc.
Planification : sous Linux, sudo erpc backup init, puis sudo erpc backup schedule daily. Sous macOS, erpc backup schedule daily ~/Documents ; la tâche s'exécute sous votre identité, tant que vous êtes connecté.
Les sauvegardes sont envoyées dans la région par défaut du compte. erpc backup s'exécute sur la machine qu'il sauvegarde ; le serveur d'un worker se configure plutôt avec erpc worker backup on (Sauvegarder l'état de l'application).