Назад к обновлениям
New releaseSep 16, 2026

bithoven v0.1.0

Bithoven — это язык смарт-контрактов для создания мощных и безопасных инструментов на Bitcoin. LR(1)-парсер со статическим анализом для обеспечения безопасности на этапе компиляции. Статья о формальной верификации: https://arxiv.org/abs/2601.01436

Поделиться

Bithoven 🎼

Формальная безопасность для выразительных смарт-контрактов Bitcoin

Bithoven — это высокоуровневый императивный язык для смарт-контрактов Bitcoin. Он компилируется в нативный Bitcoin Script для выходов legacy (P2SH), segwit (P2WSH) и taproot (P2TR). Вы пишете читаемые контракты с if/else, именованными и типизированными witness-входами, а также встроенными примитивами таймлоков и подписей, вместо того чтобы вручную жонглировать стеком.

Bithoven выделяется анализом, стоящим за синтаксисом. Прежде чем выпустить один-единственный опкод, компилятор отвергает любой контракт, который мог бы достичь неопределённого состояния, нарушить правило консенсусной кодировки, потребить элемент witness не ровно один раз или не в порядке стека, оставить путь без явного return или позволить пути завершиться успешно без действительной подписи. Он также отвергает любой контракт, для которого может доказать, что никакой witness никогда не сможет его потратить.

⚡ Ключевые возможности

  • Императивный синтаксис: if/else, verify и return вместо мысленного жонглирования стеком.
  • Типизированные witness-входы: каждый путь расходования объявляет свои элементы witness по имени и типу (number, bool, string, signature).
  • Необходимость подписи на каждом пути: анализатор, чувствительный к путям, доказывает, что ни один путь расходования не может завершиться успешно без действительной подписи, какую бы форму ни принимала проверка.
  • Строгие типы и литералы с консенсусной проверкой: никакой арифметики над строками или над результатами checksig; числа, байтовые строки, таймлоки и публичные ключи проверяются на диапазон и кодировку во время компиляции.
  • Линейное потребление witness: каждый объявленный элемент потребляется ровно один раз, в порядке стека, на каждом пути.
  • Целевая компиляция: один исходник компилируется для legacy, segwit или taproot; мультиподпись становится OP_CHECKMULTISIG или OP_CHECKSIGADD в зависимости от требований цели.
  • Формально специфицирован, протестирован против Bitcoin Core: типовая корректность и теорема уточнения связывают исходник с выпущенным скриптом, а компилятор дифференциально тестируется против libbitcoinconsensus.
  • Низкие накладные расходы: на стандартных политиках Miniscript выпущенные скрипты укладываются в медиану в один байт от rust-miniscript.

🆕 Что нового в v0.1.0

v0.1.0 — это крупная переработка анализатора и бэкенда, сопровождающая статью.

  • Чувствительная к путям необходимость подписи. В 0.0.x объявление должно было лишь содержать элемент signature, и помечалась только буквальная форма !checksig(..). v0.1.0 решает для каждого пути, может ли он завершиться успешно, когда все checksig терпят неудачу. Переписывания, которые 0.0.x компилировал в скрипты, тратящиеся кем угодно, такие как checksig(..) == false, checksig(..) || flag или инвертированный if checksig(..), теперь отвергаются. !!checksig(..), который 0.0.x ошибочно отвергал, теперь компилируется.
  • Обнаружение мёртвых контрактов. Контракт, каждый путь которого доказуемо невыполним, отвергается с DeadPath вместо компиляции в непотрачиваемый выход.
  • Принудительная корректность формы. Каждый if требует else, на каждый путь расходования приходится ровно одно объявление стека, а пути, разделяющиеся на ветвлении, должны согласовываться по элементам witness, потреблённым до него.
  • Живость на каждом пути. Потребление witness отслеживается для каждого пути расходования, поэтому две ветви могут повторно использовать имя, например sig; 0.0.x отвергал это с VariableConsumed.
  • Более строгие типы и литералы. Операнды verify, return и if должны быть bool; байтовые строки ограничены лимитом push в 520 байт; литералы ключей должны использовать кодировку цели.
  • Исправления бэкенда. Равенство над арифметикой компилируется в OP_NUMEQUAL, поэтому переполняющаяся сумма больше не может сравниваться как равная побайтово, а длинные литералы байтовых строк, которые могли обрушить компилятор 0.0.x, теперь компилируются.
  • Воспроизводимая оценка. Дифференциальная валидация против Bitcoin Core, мутационный анализ, таксономический бенчмарк BSHunter и корпус ложноположительных срабатываний поставляются вместе с репозиторием (см. tests/README.md).

Обновляетесь с 0.0.x? Контракты, полагавшиеся на более мягкие правила, могут перестать компилироваться. Добавьте каждому if ветку else (NoReturn), пишите ровно одно объявление на каждый путь расходования (DeclarationPathMismatch) и используйте 32-байтовые x-only ключи в taproot или 33-байтовые сжатые ключи в legacy/segwit (MalformedPubkey).

🚀 Быстрый старт

Установка

# For CLI user
cargo install bithoven
# For rust user
cargo add bithoven
# For js user
npm install bithoven

Написание первого контракта

Контракты Bithoven определяются с расширением .bithoven. Ниже приведена реализация стандартного контракта с хешированным временным замком (HTLC), демонстрирующая, как Bithoven упрощает условные пути расходования средств.

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");
    }
}

🛠 Компиляция

При компиляции Bithoven переводит высокоуровневую императивную логику в эквивалентные опкоды Bitcoin Script, автоматически управляя потоком выполнения и стеком.

Команда:

bithoven compile htlc.bithoven --format asm

Без --format CLI записывает ASM, hex и bytes в htlc.bithoven.json; --format hex и --format json вместо этого выводят в stdout.

Сгенерированный Bitcoin Script (ASM, отформатирован для удобочитаемости):

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

🛡️ Что компилятор отклоняет

Каждая проверка выполняется во время компиляции, и каждое отклонение сопровождается диагностическим сообщением, указывающим на проблемную строку. Этот контракт выглядит как защищённый сигнатурой, но его единственный путь завершается успешно именно тогда, когда проверка сигнатуры проваливается:

pragma bithoven version 0.0.1;
pragma bithoven target segwit;

(sig_alice: signature)
{
    return checksig(sig_alice, "0245a6b3f8eeab8e88501a9a25391318dce9bf35e24c377ee82799543606bf5212") == false;
}
Error at line 6:5: UselessSig("A checksig is present on the top-level path but it does not gate the spend: the return at line 6:5 can succeed without a valid signature.")

Категории