Aller au contenu principal

Restaking BTC (Babylon)

Le module x/babylon est conçu pour intégrer QoreChain au protocole Babylon afin d'hériter des garanties de finalité par preuve de travail de Bitcoin. Grâce au restaking BTC, QoreChain disposerait d'une couche de finalité secondaire adossée à la puissance de hachage de Bitcoin — sans nécessiter de modification du protocole Bitcoin lui-même.

Phase de conception

L'intégration Babylon est spécifiée, mais ses transactions ne sont pas activées sur les réseaux en production : le module est désactivé dans la configuration genesis (enabled = false), ne dispose d'aucun service de transaction, service de requête, CLI ni route REST, et aucun canal IBC vers Babylon n'est ouvert sur l'un ou l'autre réseau. Cela est inchangé sur le mainnet (v3.2.4) et le testnet (v3.2.6) (vérifié le 23 octobre 2026 sur les deux, puis de nouveau le 27 octobre 2026 pour l'état IBC du testnet : le nœud ne répond à aucune requête babylon, le seul canal IBC sur l'un ou l'autre réseau est l'unique canal de test du testnet vers une chaîne d'ID provider, et la méthode qor_getBTCStakingPosition n'est pas servie). Tout ce qui suit décrit la conception prévue ; les noms de messages, les chemins REST et les commandes CLI ne sont pas disponibles aujourd'hui.

Vue d'ensemble​

Le protocole Babylon permet aux chaînes en preuve d'enjeu de tirer parti de la sécurité de Bitcoin au moyen d'un mécanisme d'horodatage et de checkpointing. L'intégration de QoreChain fonctionne comme suit :

  1. Les stakers BTC verrouillent des bitcoins dans des transactions de staking Babylon et enregistrent leurs positions sur QoreChain.
  2. Les checkpoints d'époque de QoreChain sont périodiquement relayés vers Babylon, qui les horodate sur Bitcoin.
  3. Héritage de finalité : une fois qu'une époque QoreChain est checkpointée sur Bitcoin, l'état couvert par cette époque hérite des garanties de finalité par preuve de travail de Bitcoin.

Cela offre une défense contre les attaques à longue portée et l'équivocation, ancrée dans la puissance de hachage cumulée de Bitcoin plutôt que de s'appuyer uniquement sur l'ensemble de validateurs propre à QoreChain.

Positions de staking BTC​

Les utilisateurs enregistreraient des positions de staking BTC sur QoreChain en soumettant une transaction MsgBTCRestake qui référence une transaction de staking Bitcoin.

Conditions d'enregistrement​

ParamètreValeurDescription
Stake minimal100 000 satoshis (0.001 BTC)BTC minimal requis par position de staking
Période de désengagement144 blocs BTC (~1 jour)Délai d'attente avant que le BTC staké puisse être retiré
Intervalle de checkpointToutes les 10 époques QoreChainFréquence à laquelle l'état est checkpointé vers Babylon

Structure d'une position de staking​

Chaque position de staking BTC suit l'état on-chain suivant :

ChampDescription
staker_addressAdresse QoreChain du staker (qor1...)
btc_tx_hashHash de la transaction Bitcoin de staking
amount_satoshisMontant de BTC staké en satoshis
statusÉtat du cycle de vie de la position : active, unbonding, ou withdrawn
staked_atHorodatage de l'enregistrement de la position
unbonding_heightHauteur de bloc à laquelle le désengagement a été initié (le cas échéant)
validator_addrAdresse du validateur QoreChain auquel ce stake est délégué

Flux d'enregistrement​

  1. Créer la transaction de staking BTC — Sur le réseau Bitcoin, créer la transaction de staking BTC.
  2. Soumettre MsgBTCRestake sur QoreChain — Sur QoreChain, soumettre MsgBTCRestake avec btc_tx_hash, amount et validator.
  3. Position enregistrée — La position est enregistrée on-chain comme « active ».

Checkpoints d'époque​

Les racines d'état d'époque de QoreChain sont périodiquement checkpointées sur Bitcoin via la chaîne de relais Babylon.

Flux de checkpoint​

  1. Soumettre le checkpoint — Un validateur QoreChain soumet MsgSubmitBTCCheckpoint contenant le numéro d'époque, le hash de bloc BTC, la hauteur de bloc BTC et la racine d'état QoreChain.
  2. Relais IBC — Les données de checkpoint sont relayées vers la chaîne Babylon via IBC.
  3. Horodatage sur Bitcoin — Babylon inclut le checkpoint dans une transaction Bitcoin, ancrant l'état de QoreChain à la blockchain Bitcoin.
  4. Confirmation — Une fois la transaction Bitcoin confirmée, la finalité reflue à travers Babylon vers QoreChain.
  5. Finalisation — Le statut du checkpoint passe de pending à confirmed puis à finalized.

Structure d'un checkpoint​

ChampDescription
epoch_numNuméro d'époque QoreChain en cours de checkpointing
btc_block_hashHash de bloc Bitcoin contenant le checkpoint
btc_block_heightHauteur de bloc Bitcoin
state_rootRacine d'état QoreChain à la limite d'époque
submitted_atHorodatage de la soumission du checkpoint
statusÉtat du checkpoint : pending, confirmed, ou finalized

Instantanés d'époque​

À chaque limite de checkpoint, un instantané d'époque capture l'état réseau agrégé :

ChampDescription
total_stakedTotal de BTC staké sur toutes les positions (satoshis)
active_positionsNombre de positions de staking actives
validator_countNombre de validateurs avec des délégations adossées au BTC
block_heightHauteur de bloc QoreChain au moment de l'instantané

Couche de finalité secondaire​

L'intégration Babylon fournit une garantie de finalité secondaire qui complète la finalité de consensus native de QoreChain :

Couche de finalitéSourceVitesseSécurité
PrimaireMoteur de consensus QoreChain~3 secondesAdossée au stake QOR + signatures PQC
SecondaireBabylon + Bitcoin~60 minutesAdossée à la puissance de hachage cumulée de Bitcoin

La couche secondaire est particulièrement précieuse pour :

  • Prévention des attaques à longue portée : même si un attaquant accumule un stake QOR important, il ne peut pas réécrire l'historique qui a été checkpointé sur Bitcoin.
  • Sécurité du bridge inter-chaînes : les opérations de bridge impliquant de grosses valeurs peuvent attendre une finalité de niveau Bitcoin avant de libérer les fonds.
  • Confiance institutionnelle : l'horodatage Bitcoin fournit une preuve vérifiable de manière indépendante de l'historique d'état de QoreChain.

Configuration​

ParamètreDéfautDescription
enabledfalseInterrupteur principal des fonctionnalités de restaking BTC
min_stake_amount100 000 satoshisBTC minimal par position de staking
unbonding_period144 blocs BTCDurée de désengagement libellée en BTC
checkpoint_interval10 époquesÉpoques entre les checkpoints Babylon
babylon_chain_idbbn-1ID de chaîne du réseau Babylon connecté

Événements​

Le module émet les événements on-chain suivants :

Type d'événementAttributsDescription
btc_restakestaker, btc_tx_hash, amount, validatorNouvelle position de staking BTC enregistrée
btc_unbondstaker, amountPosition de staking BTC entrée en désengagement
btc_checkpointepoch, checkpoint_idCheckpoint d'époque soumis à Babylon
babylon_epoch_completeepochÉpoque Babylon finalisée avec horodatage Bitcoin

Points de terminaison de l'API (prévus)​

Aucun des points de terminaison ni des commandes de cette section n'est servi ni disponible aujourd'hui sur les réseaux en production.

REST​

MéthodePoint de terminaisonDescription
GET/babylon/v1/staking/{address}Obtenir les positions de staking BTC pour une adresse
GET/babylon/v1/checkpoint/{epoch}Obtenir les données de checkpoint pour une époque spécifique
GET/babylon/v1/paramsObtenir les paramètres de configuration du module

JSON-RPC​

Pas encore servi : aucune version publiée du nœud ne sert l'espace de noms JSON-RPC qor_, de sorte que cet appel renvoie -32601 (méthode introuvable) sur chaque point de terminaison public aujourd'hui. Voir l'espace de noms qor_.

MéthodeParamètresDescription
qor_getBTCStakingPositionaddress (string)Renvoie la position de staking BTC pour l'adresse QoreChain donnée

Commandes CLI (prévues)​

Commandes de requête​

# Query BTC restaking configuration
qorechaind query babylon config

# Query a staking position by address
qorechaind query babylon position <staker-address>

Commandes de transaction​

# Register a BTC restaking position
qorechaind tx babylon restake \
--btc-tx-hash <hash> \
--amount-satoshis <amount> \
--validator <qorvaloper1...> \
--from <key-name>

# Submit a BTC checkpoint
qorechaind tx babylon submit-checkpoint \
--epoch <epoch-number> \
--btc-block-hash <hash> \
--btc-block-height <height> \
--state-root <root> \
--from <key-name>