babylonlabs-io · web3jenks · Jun 12, 2025 · Apr 29, 2025 · Apr 30, 2025 · Apr 30, 2025
diff --git a/blog/2025/06-02-2025-welcome.mdx/06-02-2025-welcome.mdx b/blog/2025/06-02-2025-welcome.mdx/06-02-2025-welcome.mdx
@@ -0,0 +1,8 @@
+---
+title: Babylon Dev Blogs
+date: 2025-06-02
+---
+
+# Babylon Dev Blogs
+
+Welcome to Babylon deveveloper blogs. This is where you can find the latest news and technical updates from the Babylon Labs team.
diff --git a/docs/developers/bsns/cosmos_chains/cosmos_chains.mdx b/docs/developers/bsns/cosmos_chains/cosmos_chains.mdx
@@ -22,11 +22,13 @@ for example, X→ Y means "Y queries data from X and the data flows from X to Y"
     dark: useBaseUrl('/img/cosmos-integration.png'),
   }}
 />
+<br />
 
 The design involves the following main components:
 
-- **Finality Provider:** a daemon program that receives BTC stake and keeps submitting
-finality signatures over blocks to the BSN chain.
+### Finality Provider
+
+A daemon program that receives BTC stake and keeps submitting finality signatures over blocks to the BSN chain.
   - It connects to a BSN chain node to query block metadata.
   - It connects to the Babylon contracts on the BSN chain for querying voting
 power and submitting finality signatures.
@@ -38,8 +40,9 @@ Upon a new block in the BSN chain, it:
 voting power at this height.
   - If yes, sign and submit a finality signature to the Babylon contracts.
 
-- **Babylon Contracts:** a set of CosmWasm smart contracts that maintains IBC channels
-with Babylon and handles finality signatures submitted from Finality Providers
+### Babylon Contracts
+
+A set of CosmWasm smart contracts that maintains IBC channels with Babylon and handles finality signatures submitted from Finality Providers
   - It will be deployed on the BSN chain.
   - It establishes an IBC channel with Babylon. The IBC channel relays information
 about BTC light clients, BTC timestamps and BTC staking.
@@ -53,8 +56,9 @@ Upon a finality signature, the Babylon contracts verify it:
 packet to Babylon. Then Babylon emits an event so anyone can slash the Finality
 Provider and the BTC stake under it.
 
-- **Babylon-SDK:** a small Cosmos SDK module serving as a thin layer between Babylon
-contracts and Cosmos SDK level of the BSN chain.
+### Babylon-SDK
+
+A small Cosmos SDK module serving as a thin layer between Babylon contracts and Cosmos SDK level of the BSN chain.
   - It sends a sudo message to the Babylon contracts upon each `BeginBlock` , so that
 Babylon contracts can update voting power table and tally blocks.
   - It moves a part of the reward from the fee collector account to Babylon contracts,

diff --git a/docs/developers/bsns/op_stack_chains/op_stack_chains.mdx b/docs/developers/bsns/op_stack_chains/op_stack_chains.mdx
@@ -21,10 +21,12 @@ The design involves the following main components:
     light: useBaseUrl('/img/op-stack-integration.png'),
     dark: useBaseUrl('/img/op-stack-integration.png'),
   }}
-/>;
+/>
+<br />
 
-- **Finality Provider:** a daemon program that receives BTC stake and keeps
-submitting finality signatures over L2 blocks to the finality contract on Babylon.
+### Finality Provider
+
+A daemon program that receives BTC stake and keeps submitting finality signatures over L2 blocks to the finality contract on Babylon.
   - It connects to a Babylon node to query its voting power.
   - It connects to the finality contract via the Babylon node for submitting
 finality signatures.
@@ -35,7 +37,10 @@ Upon a new L2 block in the OP-stack chain, It:
   - Gets the L2 block metadata.
   - Queries Babylon Genesis to determine whether it has voting power at this L2 block height.
   - If yes, sign and submit a finality signature to the finality contract.
-- **Finality contract:** a CosmWasm smart contract that maintains all finality signatures submitted from OP-stack Finality Providers.
+
+### Finality Contract
+
+A CosmWasm smart contract that maintains all finality signatures submitted from OP-stack Finality Providers.
   - It will be deployed on Babylon Genesis.
   - It will query Babylon Genesis to determine the Finality Provider’s status and voting power.
 
@@ -44,7 +49,10 @@ Upon a finality signature, the finality contract verifies it and identifies equi
   - If invalid, reject.
   - If valid and non-conflicting with any existing ones, accept.
   - If valid but conflicting with an existing finality signature, it emits an event so anyone can slash the Finality Provider and the BTC stake under it.
-- **Finality gadget**: a daemon program that keeps tallying all finality signatures for L2 blocks and serves RPC to allow querying the BTC-voting quorum of those blocks.
+
+### Finality Gadget
+
+A daemon program that keeps tallying all finality signatures for L2 blocks and serves RPC to allow querying the BTC-voting quorum of those blocks.
   - It connects to a Babylon node for querying the voting power of Finality Providers.
   - It connects to the finality contract via the Babylon node for querying finality signatures.
   - It connects to an RPC of the OP stack chain to get L2 block metadata.
@@ -55,7 +63,10 @@ Upon a new L2 block in the OP-stack chain, it:
   - Queries Babylon to get all Finality Providers’ BTC delegations for this chain and use the L2 block’s timestamp to determine the voting power distribution among all its Finality Providers at the time of this block.
   - Tallies finality signatures and determines whether the L2 block receives a quorum.
   - If this L2 block receives a quorum and its parent block is also BTC staking-finalized, marks it as BTC staking-finalized and stores it in the finality gadget’s local database.
-- **OP node with finality gadget:** a modified OP node that enforces BTC-voting quorum before finalizing L2 blocks.
+
+### OP Node with Finality Gadget
+
+A modified OP node that enforces BTC-voting quorum before finalizing L2 blocks.
   - It connects to the finality gadget for querying consecutive BTC-voting quorums to determine the finalization status of the L2 blocks.
   - It notifies OP-geth about the L2 blocks’ finalization status to move the L2 finalized block head.
 
@@ -74,13 +85,13 @@ We have finished the reference implementation. The codebases include:
 - [btc-staker](https://github.com/babylonlabs-io/btc-staker/tree/base/consumer-chain-support): The BTC Staker program
 - [babylon-contract](https://github.com/babylonlabs-io/babylon-contract): The CosmWasm contracts, including the finality contract for OP-stack chains.
 - [finality-gadget](https://github.com/babylonlabs-io/finality-gadget): The finality gadget program. It can be used by OP node or user as an SDK or run as a standalone daemon program.
-- [optimism](https://github.com/babylonlabs-io/optimism/tree/feat/babylon-rfc): The fork of OP Stack codebase that installs finality-gadget.
+- [optimism](https://github.com/babylonlabs-io/op-finality-gadget): The fork of OP Stack codebase that installs finality-gadget.
 
 ## Local deployments
 
 We have developed local deployment scripts for the OP stack integration.
 
 - https://github.com/Snapchain/babylon-deployment for spinning up an OP stack chain integrating with Babylon Euphrates devnet
-- https://github.com/Snapchain/op-chain-deployment for spinning up the entire stack (OP stack chain + ETH L1 + Babylon + Bitcoin)
+- https://github.com/Snapchain/op-chain-deployment for spinning up the entire stack (OP stack chain + ETH L1 + Babylon Genesis + Bitcoin)
 
 ---
diff --git a/docs/guides/architecture/babylon_genesis_modules/btc_checkpointing.mdx b/docs/guides/architecture/babylon_genesis_modules/btc_checkpointing.mdx
@@ -12,9 +12,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/btccheckpoint/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/babylon_genesis_modules/btc_lightclient.mdx b/docs/guides/architecture/babylon_genesis_modules/btc_lightclient.mdx
@@ -12,9 +12,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/btclightclient/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/babylon_genesis_modules/btc_staking.mdx b/docs/guides/architecture/babylon_genesis_modules/btc_staking.mdx
@@ -12,9 +12,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/btcstaking/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/babylon_genesis_modules/checkpointing.mdx b/docs/guides/architecture/babylon_genesis_modules/checkpointing.mdx
@@ -12,9 +12,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/checkpointing/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/babylon_genesis_modules/epoching.mdx b/docs/guides/architecture/babylon_genesis_modules/epoching.mdx
@@ -12,9 +12,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/epoching/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/babylon_genesis_modules/finality.mdx b/docs/guides/architecture/babylon_genesis_modules/finality.mdx
@@ -12,9 +12,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/finality/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/btc_staking_program/btc_reorg_procedure.mdx b/docs/guides/architecture/btc_staking_program/btc_reorg_procedure.mdx
@@ -13,9 +13,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/btcstaking/docs/btc-reorg.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/btc_staking_program/finality_providers.mdx b/docs/guides/architecture/btc_staking_program/finality_providers.mdx
@@ -11,9 +11,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/finality-provider/refs/heads/main/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
diff --git a/docs/guides/architecture/consumer_zone_programs/babylon_contracts.mdx b/docs/guides/architecture/consumer_zone_programs/babylon_contracts.mdx
@@ -32,10 +32,7 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon-contract/refs/heads/main/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={true}
+  rawUrl={rawUrl}
   hideRelease={false}
 />
 
diff --git a/docs/guides/architecture/consumer_zone_programs/zone_concierge.mdx b/docs/guides/architecture/consumer_zone_programs/zone_concierge.mdx
@@ -12,9 +12,6 @@ import RemoteMD from '@site/src/components/RemoteMD';
 export const rawUrl="https://raw.githubusercontent.com/babylonlabs-io/babylon/refs/heads/main/x/zoneconcierge/README.md";
 
 <RemoteMD
-  networkVersions={{
-    mainnet: rawUrl
-  }}
-  hideEnv={false}
+  rawUrl={rawUrl}
   hideRelease={true}
 />
diff --git a/docs/guides/baby_stakers/baby_staking_cli.mdx b/docs/guides/baby_stakers/baby_staking_cli.mdx
@@ -1,6 +1,6 @@
 ---
 sidebar_class_name: baby_staking_cli_sidebar
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 # BABY Staking CLI Guide

diff --git a/docs/guides/baby_stakers/baby_staking_integration.mdx b/docs/guides/baby_stakers/baby_staking_integration.mdx
@@ -1,7 +1,7 @@
 ---
 title: BABY Staking Integration
 sidebar_label: BABY Staking Integration
-sidebar_position: 4
+sidebar_position: 6
 ---
 
 # BABY Staking Integration