babylonlabs-io · kkkk666 · Apr 5, 2025 · Mar 26, 2025 · Mar 30, 2025 · Apr 1, 2025
diff --git a/docs/developers/bsns/cosmos_chains/step_by_step_guide.mdx b/docs/developers/bsns/cosmos_chains/step_by_step_guide.mdx
diff --git a/...rs/wallet_integration/babylon_wallet_integration/integration_recommendation.mdx b/...rs/wallet_integration/babylon_wallet_integration/integration_recommendation.mdx
@@ -0,0 +1,88 @@
+---
+sidebar_class_name: babylon_wallet_integration_sidebar
+sidebar_label: Integration Recommendation
+sidebar_position: 1
+---
+
+# Wallet Integration Recommendation  
+
+To provide the best experience for users here are some suggestions to wallet  
+developers:  
+
+1.  **Epochised Staking UI**:  
+
+    *   Show a clear indication that staking operations are queued for  
+        end-of-epoch execution  
+
+    *   Display estimated time until the end of current epoch  
+
+    *   Provide a way to view all pending staking operations  
+
+2.  **Fast Unbonding UI**:  
+
+    *   Accurately communicate the unbonding period  
+
+    *   Indicate that unbonding leverages Bitcoin security  
+
+    *   If possible, show progress of Bitcoin confirmations for unbonding  
+        requests  
+
+3.  **Slashing Warnings**:  
+
+    *   Include clear warnings about the slashing risk  
+
+    *   Highlight the importance of choosing reliable validators  
+
+
+## Implementation Best Practices  
+
+1.  **Proper Error Handling**:  
+
+    *   Handle epoch transition edge cases  
+
+    *   Manage potential failures due to users spending funds before epoch  
+        processing  
+
+2.  **Refresh Strategies**:  
+
+    *   Implement proper cache refreshing after expected epoch boundaries  
+
+    *   Update delegation status after expected unbonding completion times  
+
+3.  **Testing**:  
+
+    *   Test thoroughly against Babylon testnet before mainnet integration  
+
+    *   Verify all epoch-based operations complete as expected  
+
+4.  **User Communication**:  
+
+    *   Clearly explain the unique aspects of BABY staking (epochised staking,  
+        fast unbonding)  
+
+    *   Provide educational content about the relationship between Bitcoin  
+        security and BABY staking  
+
+
+## Common Integration Challenges  
+
+1.  **Epochised Staking Transition**:  
+
+    *   Users transferring funds after staking transaction but before epoch  
+        processing  
+
+    *   Solution: Clear warnings about not transferring funds until end of epoch  
+
+2.  **Fast Unbonding Expectations**:  
+
+    *   Managing user expectations around unbonding times, which depend on  
+        Bitcoin block times  
+
+    *   Solution: Provide estimated time ranges rather than exact times  
+
+3.  **Validator Selection**:  
+
+    *   Helping users choose reliable validators to minimize slashing risk  
+
+    *   Solution: Display validator uptime, commission rates, and voting power  
+
diff --git a/docs/guides/baby_stakers/_category_.json b/docs/guides/baby_stakers/_category_.json
@@ -0,0 +1,7 @@
+{
+    "position": 4.1,
+    "label": "BABY Stakers",
+    "collapsible": true, 
+    "collapsed": true,
+    "className": "baby_stakers_sidebar_header"
+  } 
diff --git a/docs/guides/baby_stakers/baby_stakers.mdx b/docs/guides/baby_stakers/baby_stakers.mdx
@@ -0,0 +1,107 @@
+---
+sidebar_class_name: baby_stakers_sidebar
+sidebar_label: BABY Stakers
+sidebar_position: 1
+---
+# Staking BABY on Babylon
+
+**BABY staking** is a native staking mechanism that secures the Babylon Genesis -
+the first Bitcoin Secured Network and a Proof of Stake chain. This allows token
+holders to delegate to a chain validator to accrue inflationary rewards
+proportional to their stake. Alongside BTC staking on Finality Providers of
+Babylon Genesis, it contributes to the chain’s security and decentralization.
+
+## Benefits of BABY Staking
+
+By staking BABY tokens, the delegator can:
+
+- **Earn rewards**: Receive a portion of the annual inflation allocated to BABY
+stakers.
+- **Secure the network**: Contribute to the Babylon Genesis chain's security
+and decentralization.
+- **Fast unbonding**: Access a significantly reduced unbonding period of
+approximately 2 days compared to the typical 21 days in most PoS chains.
+- **Governance participation**: BABY staking gives stakers voting power in the
+chain’s governance to help shape the future of the network.
+
+
+## The Staking Process
+
+When you have acquired BABY and decide to stake your BABY tokens, the general
+process is as follows:
+
+1. **Submission**: You send a BABY staking request through supported wallets.
+2. **Confirmation**: The system confirms it received your request.
+3. **Queuing**: Your request joins the queue, waiting for the current epoch to
+end.
+4. **Funds Status**: Important: Your funds remain available in your wallet
+until the epoch ends.
+
+*More on the staking mechanism can be found [here](/guides/baby_stakers/staking_mechanism).*
+
+## Slashing Conditions
+
+Like all staking operations, BABY staking carries certain risks that delegators
+should understand.
+
+- Staked validators can only be slashed for double signing, which means
+proposing two different blocks at the same height (considered a severe
+security violation).
+- When slashing occurs, 5% of the delegated tokens are slashed, while the
+remaining 95% are returned to the BABY delegator.
+
+Babylon implements several measures to protect BABY delegators:
+
+- **On-chain Records**: All slashing events are recorded on-chain and visible
+through explorers. Validator slashing history is publicly available to inform
+delegation decisions.
+- **Partial Slashing**: Calibrated slashing parameters in percentage help
+protect delegators from catastrophic loss.
+
+*More on the slashing conditions can be found [here](/guides/baby_stakers/staking_mechanism).*
+
+## Fast Unbonding
+
+Babylon Genesis employs the Bitcoin Timestamping protocol, which enables a
+fast unbonding process:
+
+### Unbonding Initiation:
+- Delegator submits an unbonding request transaction.
+- Request is queued for processing at the epoch boundary.
+- At epoch conclusion, the token delegation status changes to "unbonding".
+
+### Bitcoin Checkpoint Verification:
+- The protocol commits a cryptographic hash of the Babylon Genesis chain
+state to the Bitcoin blockchain.
+- The system monitors the Bitcoin chain for confirmation of the block that
+contains the checkpoint.
+- Required confirmation depth: 300 Bitcoin blocks (~2 days).
+
+### Token Release:
+- Once Bitcoin confirmations reach the required threshold, tokens are
+automatically released and returned to the delegator.
+- Released tokens become fully liquid and transferable; there are no more
+restrictions.
+
+*More on fast unbonding process [here](/guides/baby_stakers/staking_mechanism).*
+
+## Relationship with Bitcoin Staking
+
+BABY staking operates alongside Babylon's Bitcoin Staking Protocol. Both
+mechanisms contribute to securing the Babylon Genesis chain.Staking natively
+allows Babylon Genesis validators to validate chain information, while BTC
+staking allows Babylon Genesis Finality Providers to do the same.
+
+This dual-staking model is the foundation of Babylon’s Bitcoin Secured
+Network model, combining the robustness of Bitcoin with the efficiency of
+Proof of Stake consensus.
+
+Bitcoin staking delegators earn BABY rewards from a separate annual
+inflation figure. However, they do not participate in the governance of
+Babylon Genesis.
+
+*More information on governance can be found [here](/guides/governance/).*
+
+This overview provides the foundation for understanding BABY staking. The
+following sections will delve deeper into specific mechanisms, the unique fast
+unbonding process, and practical guides to getting started with BABY staking.
diff --git a/docs/guides/baby_stakers/baby_staking_tools.mdx b/docs/guides/baby_stakers/baby_staking_tools.mdx
@@ -0,0 +1,99 @@
+---
+sidebar_class_name: baby_staking_tools_sidebar
+sidebar_position: 3
+---
+
+# BABY Staking Tools
+
+There are a number of tools and services that will support Babylon BABY Staking.
+
+## Wallets
+A list of browser extension and mobile wallets that will support BABY Staking.
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import HardwareBadge from '@site/src/components/badge/hardware';
+
+<Tabs>
+  <TabItem value="extension" label="Extension Wallets" default>
+    | Wallet | BABY Address | BABY Staking | Staking Guides |
+    |--------|-------------|--------------|----------------|
+    | OKX | ✅ | ❌ | [Link](https://www.okx.com/en-sg/web3/defi) |
+    | Onekey <HardwareBadge>Hardware</HardwareBadge> | ✅ | ❌ | |
+    | Bitget | ✅ | ❌ | |
+    | Cactus | ✅ | ❌ | |
+    | Keystone <HardwareBadge>Hardware</HardwareBadge> | ✅ | ✅ | [Link](https://support.keyst.one/3rd-party-wallets/cosmos-wallets/keplr-extension) |
+    | Tomo | ✅ | ❌ | |
+    | Gate wallet | ✅ | ✅ | |
+    | Unisat Wallet | ✅ | ✅ | |
+    | Keplr | ✅ | ✅ | [Link](https://testnet.keplr.app/chains/babylon-phase-2-testnet) |
+    | Cosmostation | ✅ | ✅ | |
+    | Leap wallet | ✅ | ✅ | |
+    | Fordefi | ✅ | ✅ | |
+    | Ledger | ✅ | ✅ | Via Keplr |
+    | Xverse | ❌ | ❌ | |
+    | Imtoken | ✅ | ❌ | |
+    | Binance | ✅ | ❌ | |
+    | CoinEX | ✅ | ❌ | |
+    | Coldlar | ✅ | ❌ | |
+    | Ngrave | ✅ | ❌ | |
+  </TabItem>
+
+  <TabItem value="mobile" label="Mobile Wallets">
+    | Wallet | BABY Address | BABY Staking | Staking Guides |
+    |--------|-------------|--------------|----------------|
+    | OKX | ✅ | ❌ | [Link](https://www.okx.com/en-sg/web3/defi) |
+    | Onekey (Hardware) | ✅ | ❌ | |
+    | Bitget | ✅ | ❌ | |
+    | Tomo | ✅ | ❌ | |
+    | Gate wallet | ✅ | ✅ | |
+    | Unisat Wallet | ✅ | ✅ | |
+    | Keplr | ✅ | ✅ | [Link](https://testnet.keplr.app/chains/babylon-phase-2-testnet) |
+    | Cosmostation | ✅ | ✅ | |
+    | Leap wallet | ✅ | ✅ | |
+    | Imtoken | ✅ | ❌ | |
+    | Binance | ✅ | ❌ | |
+    | CoinEX | ✅ | ❌ | |
+  </TabItem>
+</Tabs>
+
+## Custody Services
+
+A list of custody services or platforms that will support BABY Staking.
+
+| Custody | BABY Staking |
+|---------|-------------|
+| Anchorage | ✅ |
+| Hex Trust | ✅ |
+| Cobo | ❌ |
+| Chainup | ❌ |
+| Ceffu | ✅ |
+| Amber | ✅ |
+| Coinbase | ❌ |
+| Bitgo | ❌ |
+
+## Exchange
+
+A list of crypto exchanges that will support BABY Staking.
+
+| Exchange | BABY Staking |
+|----------|-------------|
+| Binance | ✅ |
+| Bitrue | ✅ |
+| OKX | ✅ |
+| Gate | ❌ |
+| Bitget | ✅ |
+| Bybit | ❌ |
+| CoinEX | ✅ |
+| Kucoin | ❌ |
+| BingX | ❌ |
+
+
+Where:
+- ✅ - indicates the feature is supported.
+- ❌ - indicates the feature is not currently supported.
+- <HardwareBadge>Hardware</HardwareBadge> - indicates that the wallet is a hardware wallet.
+
+:::note
+The above list is not exhaustive and is subject to change. Please check the official documentation of the staking tools for the latest information.
+:::