v1.0.0

Description

v1.0.0 Version of Babylon Genesis Node 🚀

🏗️ Binaries

If you prefer to build from source, use the following commands:

git clone https://github.com/babylonlabs-io/babylon.git
cd babylon
git checkout v1.0.0
# Only use the below command for mainnet
make build
# Only use the below command for testnet
BABYLON_BUILD_OPTIONS="testnet" make build

🐳 Docker Image

Image	Description
babylonlabs/babylond:v1.0.0	Mainnet image
babylonlabs/babylond:v1.0.0-testnet	Testnet image

v1.0.0-rc.10

Info

This release is not state-breaking for testnet and just adds a few improvements to the release process and upgrade handler for BTC mainnet

Changes

Improvements

• #761 Add mainnet allowed transaction hash to v1 upgrade handler.
• #760 Add mainnet BTC headers height from 854785 to 890123.
• #757 Statically link wasm and add binaries with [testnet, mainnet] flags to release assets.
• #746 Add mainnet parameters to v1 upgrade handler.

v1.0.0-rc.9

Info

This release is state breaking, and will require a coordinated upgrade on testnet with plan name v1rc9. Follow the upgrade steps here to upgrade your node.

Changes

Improvements

• #749 Upgrade handler for v1rc9

State Breaking

• #745 Hard limit of the number of finalized
  and rewarded blocks

Bug fixes

• #748 fix: gov resume finality, index block before tally.
• #731 chore: fix block timeout in Babylon client

v1.0.0-rc.8

Info

This release is both state and api breaking, and will require coordinated upgrade on testnet

Changes

API Breaking

• #690 Add new BLS password flow which includes env variable.
• #682 Avoid creating pop in babylond tx checkpointing create-validator

Bug fixes

• #657 crypto: fix adaptor sig timing side channels
• #656 crypto: fix adaptor sig validity and typos
• #658 crypto: check if Z==1 in ToBTCPK
• #667 crypto: enable groupcheck in BLS verification/aggregation
• #660 fix: ecdsa verification
• #680 crypto: fix bls rogue attack
• #673 fix: move bip322 signing functions to testutil
• #683 crypto: fix eots signing timing attack
• #691 crypto: fix eots missing normalization in use of secp256k1.FieldVal
• #671 crypto: align adaptor sig impl with Blockstream spec
• #705 Add bls key length validation from the ERC-2335 keystore
• #712 fix: remove exponentially events emission at processing queued msgs at the end epoch.

Improvements

• #701 Update upgrade name to v1rc8
• #687 Add details to btc-reorg runbook.
• #655 Add func ParseV0StakingTxWithoutTag to
  parse staking tx without verifying opreturn tag.
• #666 Upgrade to wasmvm v2.2.3.
• #668 Remove unused unsafe key gen functions
• #676 Bump IBC-go to v8.7.0
• #644 Add priority nonce mempool and transaction priority ante handler decorator
• #693 chore: use timeout from config in bbn client
• #660 add function to recover pub key from sig
• #625 add tx gas limit decorator and local mempool config

State breaking

• #697 Update BIP322 PoP and
  ECDSA Pop to sign bech32 encoded cosmos address
• #695 Improve checkpoint panicking behavior

v1.0.0-rc.6-fix

Testnet hot fix release

Babylon Testnet contained bug which lead to creating unbounded amount of events at the epoch boundary that could lead to node crashing with OOM error.

Changes

• #714 hot-fix: removed duplicated events EventHandleQueuedMsg at end of epoch for queued messages

Recovery procedure

Download network snapshot without faulty events link

Steps to recover:

1. Stop your babylond node
2. Update to the hotfixed babylond binary from this release tag. When building babylond binary, remember to use testnet env option i.e BABYLON_BUILD_OPTIONS="testnet" make install
3. Start your node from the provided snapshot. Make sure you backup your home directory first. You can extract the snapshot like this: tar -xf ./babylon_542160_pruned_bbn-test-5.tar -C ~/.babylond --overwrite

v1.0.0-rc.7

Info

This release is both state and api breaking, and will require coordinated upgrade on testnet

Update: This version won't be deployed on testnet

Changes

Improvements

• #648 Add query to get all parameters from x/btcstaking module.
• #544 Add bls-config to app.toml for custom bls key location.
• #558 Change BLS public key format from hex to base64 in bls_key.json.
• #466 Add e2e test to
• #519 Add missing data in InitGenesis and ExportGenesis in x/incentive module block bank send and still create BTC delegations
• #538 Upgrade to wasmd v0.54.x and wasmvm v2.2.x
• #527 Create BSL signer on start command with flags.
• #554 Improve vote extension logs
• #566 Remove float values in BeforeValidatorSlashed hook in x/epoching module
• #542 Add missing data in InitGenesis and ExportGenesis in x/incentive module (follow up of #519)
• #589 Rename btc_delegation stakeholder type to btc_staker in x/incentive module
• #590 Add DelegationRewards query in x/incentive module
• #633 Fix swagger

State Machine Breaking

• #518 Add check BTC reorg blocks higher than k deep
• #530 Add ConflictingCheckpointReceived flag in x/checkpointingmodule.
• #537 Add CommissionRates type to MsgCreateFinalityProvider and commission validation to EditFinalityProvider in x/btcstaking module
• #567 Add check for height overflow in CommitPubRandList in x/finality module
• #620 fix: Incorrect set of JailUntil after unjailing

Bug fixes

• #539 fix: add missing x/checkpointing hooks invocation
• #591 bump ibc to v8.6.1 that fixes security issue
• #579 Slashed FP gets activated in voting power distribution
  cache if an old BTC delegation receives inclusion proof
• #592 finality: avoid refunding finality signatures over forks
• #525 fix: add back NewIBCHeaderDecorator post handler
• #563 reject coinbase staking transactions
• #584 fix: Panic can be triggered in handling liveness
• #585 fix: Proposal vote extensions' byte limit
• #594 Refund tx to correct recipient
• #599 check staker signature in BTCUndelegate
• #631 Ignore expired events if delegation was never activated
• #629 Allow OP_RETURN as slashing output
• #597 fix: Expired and Unbonding delegation in the same BTC block could lead to a panic and chain halt
• #647 Ignore unbonding event if delegation did not have covenant quorum

v1.0.0-rc.6

Improvements

• #508 Move PoP constructor functiosn to datagen/
• #499 Add params-by-version CLI command
• #515 Add staker_addr to EventBTCDelegationCreated
• #458 Set CosmosProvider functions as public in babylonclient package

Bug fixes

• #509 crypto: fix ECDSA malleability
• #486 crypto: blinding base mult of nonce
• #443 Fix swagger generation for incentive missing v1 in path
• #505 Fix x/btcstaking delegation queries

v1.0.0-rc.5

Improvements

• #483 Upgrade wasmd and wasmvm to latest
  versions (related to security advisories CWA-2025-001 and CWA-2025-002)
• #464 Update security email. Fix site / repository refs
• #421 Add checks to public
  randomness commit at TestBTCRewardsDistribution.
• #445 Reject BTC headers
  forks starting with already known header
• #457 Remove staking msg
  server and update gentx to generate MsgWrappedCreateValidator
• #473 Fix checkpoint status transition
  from Finalized to Forgotten
• #457 Remove staking msg server and update gentx to generate
  MsgWrappedCreateValidator
• #476 Bump cometbft to v0.38.17
• #491 Allow slashing rate
  to have 4 decimal places
• #488 Fix duplicate BLS key registration in testnet command
• #493 Add v1rc5 testnet
  upgrade handler

v1.0.0-rc.4

Improvements

• #419 Add new modules to swagger config
• #429 chore: remove cosmos/relayer dependency

Bug fixes

• #353 Bump to SDK 0.50.11
• #404 Improve adaptor signature nonce generation to match reference implementation
• #413 Fix adaptor signature R verification
• #441 Fix fuzzing test for CreateBTCDelegationWithParamsFromBtcHeight

v1.0.0-rc.3

Bug fixes

• #374 Fix non-consecutive finalization of the block in TallyBlocks function
• #378 Fix give out rewards with gaps of unfinalized blocks
• #385 Fix epoching module ante handler to return from antehandler chain only in case of error