
bithoven v0.1.0
Bithoven est un langage de contrats intelligents pour composer des instruments puissants et sécurisés sur Bitcoin. Analyseur LR(1) avec analyse statique pour une sécurité à la compilation. Article de vérification formelle : https://arxiv.org/abs/2601.01436
Bithoven 🎼
Sécurité formelle pour les contrats intelligents Bitcoin expressifs
Bithoven est un langage impératif de haut niveau pour les contrats intelligents Bitcoin. Il se compile en Bitcoin Script natif pour les sorties legacy (P2SH), segwit (P2WSH) et taproot (P2TR). Vous écrivez des contrats lisibles avec if/else, des entrées témoin nommées et typées, ainsi que des primitives intégrées de verrouillage temporel et de signature, au lieu de jongler manuellement avec une pile.
Ce qui distingue Bithoven, c'est l'analyse qui sous-tend la syntaxe. Avant d'émettre le moindre opcode, le compilateur rejette tout contrat susceptible d'atteindre un état indéfini, d'enfreindre une règle d'encodage de consensus, de consommer un élément témoin autrement qu'exactement une fois et dans l'ordre de la pile, de laisser un chemin sans return explicite, ou de permettre à un chemin de réussir sans signature valide. Il rejette également tout contrat dont il peut prouver qu'aucun témoin ne pourrait jamais le dépenser.
⚡ Fonctionnalités clés
- Syntaxe impérative :
if/else,verifyetreturnau lieu de la jonglerie mentale avec la pile. - Entrées témoin typées : chaque chemin de dépense déclare ses éléments témoin par nom et par type (
number,bool,string,signature). - Nécessité de signature sur chaque chemin : un analyseur sensible aux chemins prouve qu'aucun chemin de dépense ne peut réussir sans signature valide, quelle que soit la forme de la vérification.
- Types stricts et littéraux vérifiés par consensus : pas d'arithmétique sur les chaînes ni sur les résultats de
checksig; les nombres, chaînes d'octets, verrouillages temporels et clés publiques sont vérifiés en plage et en encodage à la compilation. - Consommation linéaire des témoins : chaque élément déclaré est consommé exactement une fois, dans l'ordre de la pile, sur chaque chemin.
- Compilation ciblée : une seule source se compile pour
legacy,segwitoutaproot; le multisig devientOP_CHECKMULTISIGouOP_CHECKSIGADDselon les besoins de la cible. - Spécifié formellement, testé contre Bitcoin Core : la sûreté des types et un théorème de raffinement relient la source au script émis, et le compilateur est testé différentiellement contre
libbitcoinconsensus. - Faible surcoût : sur les politiques Miniscript standard, les scripts émis sont à une médiane d'un octet de
rust-miniscript.
🆕 Nouveautés de la v0.1.0
La v0.1.0 est une révision majeure de l'analyseur et du back-end, accompagnant l'article.
- Nécessité de signature sensible aux chemins. En 0.0.x, une déclaration devait seulement contenir un élément
signature, et seule la forme littérale!checksig(..)était signalée. La v0.1.0 décide, pour chaque chemin, s'il peut réussir alors que tous leschecksigéchouent. Les réécritures que 0.0.x compilait en scripts dépensables par n'importe qui, telles quechecksig(..) == false,checksig(..) || flagou unif checksig(..)inversé, sont désormais rejetées.!!checksig(..), que 0.0.x rejetait à tort, se compile maintenant. - Détection de contrats morts. Un contrat dont chaque chemin est prouvablement insatisfaisable est rejeté avec
DeadPathau lieu d'être compilé en une sortie non dépensable. - Bien-formage imposé. Chaque
ifnécessite unelse, il y a exactement une déclaration de pile par chemin de dépense, et les chemins qui se séparent à une branche doivent s'accorder sur les éléments témoin consommés avant celle-ci. - Vivacité par chemin. La consommation des témoins est suivie par chemin de dépense, de sorte que deux branches peuvent réutiliser un nom tel que
sig; 0.0.x rejetait cela avecVariableConsumed. - Types et littéraux plus stricts. Les opérandes de
verify,returnetifdoivent être de typebool; les chaînes d'octets sont limitées à la limite de push de 520 octets ; les littéraux de clé doivent utiliser l'encodage de la cible. - Corrections du back-end. L'égalité sur l'arithmétique se compile en
OP_NUMEQUAL, de sorte qu'une somme en débordement ne peut plus être comparée égale octet par octet, et les longs littéraux de chaînes d'octets qui pouvaient faire planter le compilateur 0.0.x se compilent désormais. - Évaluation reproductible. La validation différentielle contre Bitcoin Core, l'analyse de mutation, le benchmark de taxonomie BSHunter et un corpus de faux positifs sont fournis avec le dépôt (voir
tests/README.md).
Vous effectuez une mise à niveau depuis la version 0.0.x ? Les contrats qui reposaient sur les règles plus permissives peuvent cesser de se compiler. Donnez à chaque
ifunelse(NoReturn), écrivez exactement une déclaration par chemin de dépense (DeclarationPathMismatch), et utilisez des clés x-only de 32 octets soustaprootou des clés compressées de 33 octets souslegacy/segwit(MalformedPubkey).
🚀 Démarrage rapide
- Bithoven Web IDE, voir : https://bithoven-lang.github.io/bithoven/ide/
- Documentation Bithoven, voir : https://bithoven-lang.github.io/bithoven/docs/
Installation
# For CLI user
cargo install bithoven
# For rust user
cargo add bithoven
# For js user
npm install bithoven
Écrire votre premier contrat
Les contrats Bithoven sont définis avec une extension .bithoven. Voici une implémentation d'un Hashed Time-Locked Contract (HTLC) standard, démontrant comment Bithoven simplifie les chemins de dépense conditionnels.
htlc.bithoven
pragma bithoven version 0.0.1;
pragma bithoven target segwit;
/*
* Stack input declarations: one per spending path, in the order the
* paths' returns appear below. Each lists its items in the order the path
* consumes them, so the first item (here the branch condition) is the top
* of the witness stack.
*/
(condition: bool, sig_alice: signature)
(condition: bool, preimage: string, sig_bob: signature)
{
// If 'condition' is true, we enter the Refund Path (Alice)
if condition {
// Enforce relative timelock of 1000 blocks
older 1000;
// If timelock is satisfied, Alice can spend with her signature
return checksig(sig_alice, "0245a6b3f8eeab8e88501a9a25391318dce9bf35e24c377ee82799543606bf5212");
} else {
// Redeem Path (Bob)
// Bob must reveal the secret preimage that hashes to the expected value
verify sha256(sha256(preimage)) == "53de742e2e323e3290234052a702458589c30d2c813bf9f866bef1b651c4e45f";
// If hash matches, Bob can spend with his signature
return checksig(sig_bob, "0345a6b3f8eeab8e88501a9a25391318dce9bf35e24c377ee82799543606bf5212");
}
}
🛠 Compilation
Lors de la compilation, Bithoven traduit la logique impérative de haut niveau en opcodes Bitcoin Script équivalents, en gérant automatiquement le flux de contrôle et la gestion de la pile.
Commande :
bithoven compile htlc.bithoven --format asm
Sans --format, la CLI écrit l'ASM, l'hexadécimal et les octets dans htlc.bithoven.json ; --format hex et --format json affichent sur stdout à la place.
Script Bitcoin généré (ASM, formaté pour la lisibilité) :
OP_IF
<0xe803> OP_CHECKSEQUENCEVERIFY OP_DROP
<pubkey_alice> OP_CHECKSIG
OP_ELSE
OP_HASH256 OP_TOALTSTACK <hash_digest> OP_FROMALTSTACK OP_SWAP OP_EQUALVERIFY
<pubkey_bob> OP_CHECKSIG
OP_ENDIF
🛡️ Ce que le compilateur rejette
Chaque vérification s'exécute à la compilation, et chaque rejet s'accompagne d'un diagnostic pointant vers la ligne fautive. Ce contrat semble conditionné par une signature, mais son unique chemin ne réussit que lorsque la vérification de signature échoue :
pragma bithoven version 0.0.1;
pragma bithoven target segwit;