babylonlabs-io · web3jenks · Jul 24, 2025 · Jul 10, 2025 · Jul 10, 2025 · Jul 11, 2025
diff --git a/docs/developers/bsns/_category_.json → docs/bsns/_category_.json b/docs/developers/bsns/_category_.json → docs/bsns/_category_.json
@@ -1,6 +1,6 @@
 {
   "position": 2,
   "label": "Bitcoin Supercharged Networks",
-  "collapsible": true,
+  "collapsible": false,
   "collapsed": true
 }
diff --git a/docs/developers/bsns/bsns.mdx → docs/bsns/bsns.mdx b/docs/developers/bsns/bsns.mdx → docs/bsns/bsns.mdx
@@ -22,7 +22,7 @@ BTC-backed Finality Providers are held accountable, even
 when equivocating Finality Providers constitute a majority.
 
 <Link
-  to="/developers/bsns/cosmos_chains"
+  to="/bsns/cosmos_chains"
 >
     Cosmos Chain Integration Guide
 </Link>
@@ -51,7 +51,7 @@ The [Forkless Rollups with Bitcoin staking](https://babylonchain.io/blog/forkles
 blog post provides more details.
 
 <Link
-  to="/developers/bsns/op_stack_chains"
+  to="/bsns/op_stack_chains"
 >
     OP-stack L2 Chain Integration Guide
 </Link>
diff --git a/...lopers/bsns/cosmos_chains/_category_.json → docs/bsns/cosmos_chains/_category_.json b/...lopers/bsns/cosmos_chains/_category_.json → docs/bsns/cosmos_chains/_category_.json
diff --git a/...lopers/bsns/cosmos_chains/babylon_sdk.mdx → docs/bsns/cosmos_chains/babylon_sdk.mdx b/...lopers/bsns/cosmos_chains/babylon_sdk.mdx → docs/bsns/cosmos_chains/babylon_sdk.mdx
diff --git a/...pers/bsns/cosmos_chains/cosmos_chains.mdx → docs/bsns/cosmos_chains/cosmos_chains.mdx b/...pers/bsns/cosmos_chains/cosmos_chains.mdx → docs/bsns/cosmos_chains/cosmos_chains.mdx
@@ -18,8 +18,8 @@ for example, X→ Y means "Y queries data from X and the data flows from X to Y"
 <ThemedImage
   alt="Cosmos Chains Integrations Architecture"
   sources={{
-    light: useBaseUrl('/img/cosmos-integration.png'),
-    dark: useBaseUrl('/img/cosmos-integration.png'),
+    light: useBaseUrl('/img/developers/cosmos/bsn_architecture_cosmos.png'),
+    dark: useBaseUrl('/img/developers/cosmos/bsn_architecture_cosmos_dark.png'),
   }}
 />
 <br />

diff --git a/...os_chains/integrating_as_cosmos_chain.mdx → ...os_chains/integrating_as_cosmos_chain.mdx b/...os_chains/integrating_as_cosmos_chain.mdx → ...os_chains/integrating_as_cosmos_chain.mdx
diff --git a/...bsns/cosmos_chains/running_btc_staker.mdx → ...bsns/cosmos_chains/running_btc_staker.mdx b/...bsns/cosmos_chains/running_btc_staker.mdx → ...bsns/cosmos_chains/running_btc_staker.mdx
diff --git a/...smos_chains/running_finality_provider.mdx → ...smos_chains/running_finality_provider.mdx b/...smos_chains/running_finality_provider.mdx → ...smos_chains/running_finality_provider.mdx
diff --git a/.../bsns/op_stack_chains/op_stack_chains.mdx → .../bsns/op_stack_chains/op_stack_chains.mdx b/.../bsns/op_stack_chains/op_stack_chains.mdx → .../bsns/op_stack_chains/op_stack_chains.mdx
@@ -18,8 +18,8 @@ The design involves the following main components:
 <ThemedImage
   alt="Optimism L2 Integrations Architecture"
   sources={{
-    light: useBaseUrl('/img/op-stack-integration.png'),
-    dark: useBaseUrl('/img/op-stack-integration.png'),
+    light: useBaseUrl('/img/developers/op_stack/bsn_architecture_op.png'),
+    dark: useBaseUrl('/img/developers/op_stack/bsn_architecture_op_dark.png'),
   }}
 />
 <br />
@@ -94,4 +94,4 @@ 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 Edge devnet
 - 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/developers/babylon_genesis_chain/explorers/explorers.mdx b/docs/developers/babylon_genesis_chain/explorers/explorers.mdx
@@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem';
 
 # Chain Explorers
 
-## Babylon Genesis Mainnet
+### Babylon Genesis Mainnet
 
 Block scanners for Phase 2 Babylon Genesis Mainnet (`bbn-1`).
 
@@ -21,7 +21,7 @@ Block scanners for Phase 2 Babylon Genesis Mainnet (`bbn-1`).
 | [Xangle](https://babylon-explorer.xangle.io/mainnet/home) | `https://babylon-explorer.xangle.io/mainnet/home` |
 
 
-## Babylon Genesis Testnet 
+### Babylon Genesis Testnet 
 
 Block scanners for Phase 2 Babylon Genesis Testnet (`bbn-test-5`).
 
@@ -33,7 +33,7 @@ Block scanners for Phase 2 Babylon Genesis Testnet (`bbn-test-5`).
 | [Xangle](https://babylon-explorer.xangle.io/testnet/home) | `https://babylon-explorer.xangle.io/testnet/home` |
 
 
-## Babylon Genesis Devnet
+### Babylon Genesis Devnet
 
 | Service | URL |
 |---------|-----|

diff --git a/docs/developers/babylon_genesis_chain/node_information.mdx b/docs/developers/babylon_genesis_chain/node_information.mdx
@@ -7,7 +7,7 @@ sidebar_position: 1
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-## Nodes and Endpoints Information for Babylon Genesis Chain
+## Endpoints Information
 
 ### Babylon Genesis Mainnet
 

diff --git a/docs/developers/developers.mdx b/docs/developers/developers.mdx
@@ -24,6 +24,8 @@ offers unique opportunities in the shared-security space.
 - IBC-enabled communication
 - Native Bitcoin staking protocols
 
+Read more on [Bitcoin Supercharged Network](/bsns/).
+
 #### 2. Smart Contract Development
 **Utilize the extremely programmable Babylon Genesis**
 - Deploy CosmWasm smart contracts
@@ -34,6 +36,8 @@ offers unique opportunities in the shared-security space.
 - Rust-based smart contract development (CosmWasm)
 - Partner oracles that work with Babylon Genesis
 
+Read more on [dApp deployments](/developers/dapps/smart_contract_deployment).
+
 #### 3. Infrastructure and Tooling
 **Develop Critical Network Components**
 - Build monitoring and validation tools (e.g. via Vigilantes)
@@ -62,8 +66,8 @@ offers unique opportunities in the shared-security space.
 
 
 3. **Check out BSN reference implementations**
-   - [Babylon SDK](/developers/bsns/cosmos_chains/babylon_sdk)
-   - [BSN integrations guide](/developers/bsns/)
+   - [Babylon SDK](/bsns/cosmos_chains/babylon_sdk)
+   - [BSN integrations guide](/bsns/)
 
 ---
 

diff --git a/docs/developers/staking_backend/services/global_config.mdx b/docs/developers/staking_backend/services/global_config.mdx
diff --git a/docs/developers/staking_backend/staking_backend.mdx b/docs/developers/staking_backend/staking_backend.mdx
@@ -49,7 +49,7 @@ properly set up:
 - **RabbitMQ** - [Setup Guide](https://www.rabbitmq.com/download.html)  
   _Handles message queuing between system components_
 
-- **Global Configuration** - [Setup Guide](./services/global_config)  
+- **Global Configuration** - Setup guide will be available soon.  
   _Defines system-wide parameters for all services_
 
 {/* Database Migration (Optional) - Clone Phase-1 database snapshot, apply snapshot to new MongoDB clusters.

diff --git a/docs/guides/architecture/_category_.json b/docs/guides/architecture/_category_.json
@@ -1,7 +1,7 @@
 {
   "position": 2,
   "label": "Architecture",
-  "collapsible": true,
-  "collapsed": true,
+  "collapsible": false,
+  "collapsed": false,
   "className": "architecture_sidebar_header"
 }
diff --git a/docs/guides/governance/governance.mdx b/docs/guides/governance/governance.mdx
@@ -73,7 +73,6 @@ Babylon's governance supports several types of proposals:
 
 - **Text Proposals**: Proposals for signaling community sentiment or discussing ideas.
 - **Parameter Change Proposals**: Modify specific blockchain parameters without changing underlying code.
-- **Community Spend Proposals**: Request funds from the community pool for projects, initiatives, or development.
 - **Software Upgrade Proposals**: Coordinate chain-wide software upgrades with specific upgrade heights or times.
 
 Each type of proposal has two urgency levels: standard or expedited.

diff --git a/docs/guides/governance/submit_proposals/submit_proposals.mdx b/docs/guides/governance/submit_proposals/submit_proposals.mdx
@@ -8,7 +8,7 @@ keywords: [governance, proposals, submission, Babylon, Genesis]
 
 # Submit Proposals  
 
-This guide provides detailed instructions for preparing and submitting governance proposals in the Babylon Genesis ecosystem. Whether you're creating text proposals for signaling, parameter changes, community pool funding, or software upgrades, this guide will help you navigate the process with ease.  
+This guide provides detailed instructions for preparing and submitting governance proposals in the Babylon Genesis ecosystem. Whether you're creating text proposals for signaling, parameter changes, or software upgrades, this guide will help you navigate the process with ease.  
 
 ## Choose Proposal Types  
 

diff --git a/docs/guides/governance/submit_proposals/submit_via_web.mdx b/docs/guides/governance/submit_proposals/submit_via_web.mdx
@@ -26,7 +26,6 @@ Click on "New Proposal". Select the proposal type from the available options:
 - Text Proposal  
 - Parameter Change  
 - Software Upgrade  
-- Community Pool Spend  
 
 ### Step 3: Fill in Proposal Details  
 

diff --git a/docs/guides/overview/_category_.json b/docs/guides/overview/_category_.json
@@ -1,7 +1,7 @@
 {
   "position": 1,
   "label": "Overview",
-  "collapsible": true,
+  "collapsible": false,
   "collapsed": false,
   "className": "overview_sidebar_header",
   "link": {

diff --git a/docs/guides/overview/overview.mdx b/docs/guides/overview/overview.mdx
@@ -108,7 +108,7 @@ provide a comprehensive set of tools and documentation to help you get started.
 
 * [Babylon node](/operators/babylon_node/installation_guide)
 * [Babylon RPC](/api/babylon-gRPC/babylon-grpc-api-docs)
-* [Babylon SDK (Cosmos SDK reference smart contracts)](/developers/bsns/cosmos_chains/babylon_sdk)
+* [Babylon SDK (Cosmos SDK reference smart contracts)](/bsns/cosmos_chains/babylon_sdk)
 
 Interchain communication is handled through [IBC protocol](https://tutorials.cosmos.network/academy/3-ibc/).
 

diff --git a/docs/guides/overview/phases_of_the_launch/phase-3/phase-3.mdx b/docs/guides/overview/phases_of_the_launch/phase-3/phase-3.mdx
@@ -14,7 +14,7 @@ Sophisticated cross-chain communication and time synchronization are required fo
 
 The final phase establishes Babylon as a marketplace for shared security. Babylon Genesis will be the control plane to coordinate security arrangements between stakers and BSNs. 
 
-<a href="/developers/bsns"
+<a href="/bsns/"
 >
 Read more on BSNs
 </a>
diff --git a/docs/operators/babylon_node/babylon_cli/create_bls_key.mdx b/docs/operators/babylon_node/babylon_cli/create_bls_key.mdx
@@ -299,4 +299,16 @@ systemctl start babylond
 ### Node Operations
 - [`babylond start`](./start.mdx) - Start the validator node
 - [`babylond status`](./status.mdx) - Check validator status
+- [`babylond init`](./init.mdx) - Initialize node (required prerequisite)
+- [`babylond testnet`](./testnet.mdx) - Initialize testnet configuration
+- [`babylond gentx`](./gentx.mdx) - Generate validator genesis transaction
+- [`babylond add-genesis-account`](./add-genesis-account.mdx) - Add validator account to genesis
+
+### Key Management
+- [`babylond keys`](./keys.mdx) - Manage keyring keys
+- [`babylond comet show-validator`](./comet.mdx#show-validator) - Show validator public key
+
+### Node Operations
+- [`babylond start`](./start.mdx) - Start the validator node
+- [`babylond status`](./status.mdx) - Check validator status
 
diff --git a/docs/operators/babylon_node/babylon_cli/gen_tx.mdx b/docs/operators/babylon_node/babylon_cli/gen_tx.mdx
@@ -20,10 +20,10 @@ babylond gentx [key_name] [amount] [flags]
 
 Before using this command, ensure you have:
 
-- Initialized your Babylon node with [`babylond init`](./init.mdx)
-- Created validator keys with [`babylond keys add`](./keys.mdx)
-- Created BLS keys with [`babylond create-bls-key`](./create_bls_key.mdx)
-- Added your validator account to genesis with [`babylond add-genesis-account`](./add_genesis_account.mdx)
+- Initialized your Babylon node with [`babylond init`](./init.md)
+- Created validator keys with [`babylond keys add`](./keys.md)
+- Created BLS keys with [`babylond create-bls-key`](./create-bls-key.md)
+- Added your validator account to genesis with [`babylond add-genesis-account`](./add-genesis-account.md)
 
 ## Arguments
 

diff --git a/docs/operators/babylon_node/babylon_cli/generate_bls_pop.mdx b/docs/operators/babylon_node/babylon_cli/generate_bls_pop.mdx
@@ -23,8 +23,8 @@ Before using this command, ensure you have:
 - Initialized your Babylon node with [`babylond init`](./init.mdx)
 - Created BLS keys with [`babylond create-bls-key`](./create_bls_key.mdx)
 - Confirmed that both key files exist:
-  - `priv_validator_key.json` (contains Ed25519 keys)
-  - `bls_key.json` or BLS keys embedded in `priv_validator_key.json`
+- `priv_validator_key.json` (contains Ed25519 keys)
+- `bls_key.json` or BLS keys embedded in `priv_validator_key.json`
 
 ## Arguments
 

diff --git a/docs/operators/babylon_node/babylon_cli/keys.mdx b/docs/operators/babylon_node/babylon_cli/keys.mdx
@@ -686,4 +686,3 @@ echo "✅ Validator keys created and added to genesis"
 ### Address Operations
 - [`babylond debug addr`](./debug.mdx#addr) - Convert address formats
 - [`babylond debug pubkey`](./debug.mdx#pubkey) - Debug public key formats
-
diff --git a/docs/operators/babylon_node/babylon_cli/query.mdx b/docs/operators/babylon_node/babylon_cli/query.mdx
@@ -27,7 +27,7 @@ babylond query [module] [subcommand] [flags]
 | **auth** | Account authentication and management | accounts, account info, module accounts |
 | **bank** | Token balances and transfers | balances, total supply, denomination metadata |
 | **staking** | Validator bonding and delegations | validators, delegations, staking pool |
-| **distribution** | Staking reward distribution | rewards, commission, community pool |
+| **distribution** | Staking reward distribution | rewards, commission |
 | **gov** | Governance proposals and voting | proposals, votes, governance parameters |
 | **slashing** | Validator penalty tracking | signing info, slashing parameters |
Original file line number	Diff line number	Diff line change
Expand Up		@@ -686,4 +686,3 @@ echo "✅ Validator keys created and added to genesis"
		### Address Operations
		- [`babylond debug addr`](./debug.mdx#addr) - Convert address formats
		- [`babylond debug pubkey`](./debug.mdx#pubkey) - Debug public key formats