Présentation
QORel est le relayeur IBC de QoreChain. Un relayeur est le programme qui transporte les paquets IBC, les preuves et les mises à jour de clients entre deux chaînes ; sans relayeur en marche, un transfert sur un canal IBC reste en attente. QORel s'adresse aux opérateurs, aux validateurs et aux équipes qui veulent assurer le relais d'un canal QoreChain, et à toute personne qui a besoin d'un relayeur capable de soumettre des transactions à QoreChain.
Nouveautés
Cette page liste ce que chaque version de QORel apporte. Elle s'adresse aux opérateurs qui hésitent à passer de Hermes, ou d'une version antérieure de QORel, et elle n'énonce que ce qu'une version fait, sous forme de comportements vérifiables. QORel est basé sur Hermes 1.13.3 (Informal Systems, Apache-2.0) ; chaque changement ci-dessous s'ajoute à cette base. Tout ce qui n'est pas listé se comporte comme dans Hermes.
Installation
QORel est un seul binaire, qorel. Cette page présente chaque façon de l'installer et comment vérifier ce que vous avez téléchargé. Elle s'adresse aux opérateurs qui installent un relayeur sur un serveur, un ordinateur portable ou une plateforme de conteneurs. Choisissez un seul canal ; ils installent tous le même programme.
Démarrage rapide
Ce guide décrit le relais entre le testnet QoreChain qorechain-diana et le testnet public de Cosmos Hub (identifiant de chaîne provider) : installer, configurer, ajouter et enregistrer les clés, vérifier l'état des clés, démarrer le relayeur et envoyer un premier transfert. Il s'adresse à quelqu'un qui n'a encore jamais fait tourner de relayeur. Tout ici concerne le testnet ; les jetons n'ont aucune valeur.
Configuration
QORel lit un seul fichier TOML (~/.hermes/config.toml par défaut, ou le chemin indiqué avec --config). Pour toute chaîne qui signe de la manière standard, le fichier est exactement la configuration de Hermes ; le guide de Hermes décrit chaque paramètre. Cette page couvre ce que QORel ajoute : l'entrée de chaîne QoreChain, les clés post-quantiques, les paramètres de gas et les vérifications effectuées avant l'envoi d'une transaction. Elle s'adresse aux opérateurs qui écrivent ou relisent une configuration QORel.
À côté d'un validateur
Les validateurs relaient souvent les canaux de leur propre chaîne. QORel peut tourner sur l'hôte du validateur, dans un conteneur sidecar ou dans Kubernetes. Cette page présente les trois dispositions et les règles qui maintiennent le relayeur isolé des propres clés du validateur. Elle s'adresse aux opérateurs de validateurs et de nœuds. Pour exécuter le nœud lui-même, voir Exécuter un validateur et Exécuter un nœud.
Surveillance
Un relayeur qui s'arrête en silence laisse des paquets en attente : il doit donc être surveillé. Cette page liste ce que QORel expose (télémétrie Prometheus, point d'accès REST optionnel, journaux et commandes) et ce qui mérite une alerte. Elle s'adresse aux opérateurs qui font tourner un relayeur pour un canal qui leur importe.
Signer depuis n'importe quel langage
QORel signe en Rust avec le crate qorel-signer. D'autres relayeurs, bots et outils peuvent produire la même signature hybride post-quantique dans d'autres langages avec le SDK QoreChain et les bibliothèques post-quantiques. Cette page énonce le contrat que tous suivent et liste la bibliothèque à utiliser pour Rust, TypeScript, Go, Python et Java. Elle s'adresse aux développeurs qui construisent un relayeur, un bot ou un backend qui soumet des transactions à QoreChain.
Dépannage
Questions et solutions pour faire tourner QORel, dans l'ordre où l'on y est habituellement confronté. Cette page s'adresse aux opérateurs dont le relayeur ne démarre pas, refuse d'envoyer ou laisse des paquets en attente. QORel est aujourd'hui réservé au testnet, donc chaque réponse suppose qorechain-diana.