Merge pull request #118 from bitlayer-org/feature/2025-05-21-update-bitvm-faq

Feature/2025 05 21 update bitvm faq

Author: web3baseai

docs/BitVMBridge/BitVMNet.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 8
+sidebar_position: 999
 ---
 
 # BitVMNet

docs/BitVMBridge/FAQ.md

@@ -4,6 +4,13 @@ sidebar_position: 1002
 
 # FAQ
 
+
+## Q: What is BitVM Bridge?
+A: The BitVM Bridge provides the foundational framework for seamless interaction between users and two smart contracts—one on Bitcoin and the other on a target chain. It enables a trust-minimized bridging mechanism that ensures the secure and efficient transfer of Bitcoin (BTC) across blockchain ecosystems, while preserving the integrity of the underlying assets.
+
+## Q: How does the BitVM Bridge work?
+Bitcoin is locked in a smart contract on the Bitcoin network (Bridge Contract A), which triggers the minting of Peg-BTC on the Ethereum chain. When a user wants to withdraw, the Peg-BTC is burned and liquidity is provided by a broker. The entire process relies on a fraud-proof mechanism to ensure the security and validity of transactions. <a href='https://blog.bitlayer.org/introducing_bitvm_bridge/' target='_blank'>Learn more.</a>
+
 ## Q: What are the differences between BitVM Bridge and other bridges?
 
 A: The most important difference between the BitVM Bridge and many other bridges lies in its **security level**. In the BitVM Bridge, **bridge funds** are locked within a **BitVM smart contract**, rather than in an address controlled by centralized entities or a multisignature (multisig) arrangement managed by a small group of people. This security model is reinforced by the principle of **1-of-N security** (also known as **existential honesty**): as long as at least one participant acts honestly, it is not possible for others to collude and steal the bridge funds from the BitVM smart contract.
@@ -34,6 +41,20 @@ Bitlayer's BitVM Bridge product suite offers two options:
 
 Users can choose the bridge that best suits their specific requirements, preferences for security models, and transaction characteristics.
 
+
+## Q: What is a Peg-BTC(YBTC)?
+A: Peg-BTC(YBTC) is a programmable Bitcoin asset that can be securely transferred across multiple blockchains via the BitVM Bridge, offering greater flexibility and utility. It can be used in decentralized lending, exchanges, staking, and other applications, enabling Bitcoin holders to fully leverage their assets in a multi-chain ecosystem. Chains and project teams can also customize the name of their Peg-BTC asset based on specific needs.
+
+## Q: How can I obtain Peg-BTC(YBTC) assets?
+A: Institutional users can mint Peg-BTC(YBTC) through <a href='https://bitvmbridge.bitlayer.org/testnet/bridge-pro/mint' target='_blank' >Bridge Pro</a>, with the minting process typically taking 1-2 hours to ensure the security and integrity of the transaction.
+
+Retail users can quickly bridge Peg-BTC(YBTC) across multiple chains using the <a href='https://bitvmbridge.bitlayer.org/testnet/bridge' target='_blank' >Bridge</a>.
+
+## Q: How can I earn profits through Peg-BTC(YBTC) assets?
+A: Users holding Peg-BTC(YBTC) assets can participate in lending, liquidity mining, and other activities on decentralized finance (DeFi) platforms on the target blockchain to earn profits. The specific returns depend on the platforms and strategies used.
+
+
+
 ## Q: Why do we have amount constraints for peg-in and peg-out in Bridge Pro?
 
 A: Amount constraints for peg-in and peg-out operations in Bridge Pro are in place primarily due to the **static nature of the BitVM protocol**. The BitVM smart contract for each bridge instance is established with its specific operational parameters (like exact peg-out amounts) pre-signed before it is deployed on the Bitcoin network. This "pre-signed" nature means these core parameters cannot be changed once the contract is active. Here's a breakdown:
@@ -60,3 +81,9 @@ Flexible peg-out solves this by allowing Brokers to:
 - Initiate the reclaim process to convert their YBTC to BTC directly from the bridge's Bitcoin collateral **without needing to first pay themselves from their separate L1 Bitcoin holdings**.
 
 This streamlined approach saves Brokers from needing to use their own L1 Bitcoin for the initial step of their own peg-out, preserving their short-term liquidity and simplifying the overall process.
+
+## Q: I am an institution (public chain, project team). How can I provide liquidity through a partnership with BitVM Bridge?
+A: Peg-BTC uses an innovative model to bring Bitcoin into the multi-chain ecosystem, offering stronger liquidity and accessibility for DeFi, gaming, and other sectors. With BitVM Bridge’s multi-chain capabilities, project teams can easily integrate BTC assets and accelerate Bitcoin’s application in the Web3 space. <a href='https://docs.bitlayer.org/docs/BitVMBridge/join-network' target='_blank' >Application Entrance</a> for Cooperation.
+
+## Q: I am a developer. How can I receive technical support for BitVM Bridge in the BitVM field?
+A: The Bitlayer research team is actively involved in building the BitVM ecosystem. Developers can gain in-depth technical guidance and resources by engaging with the team, participating in community events, and more. [Join the community](https://t.me/bitlayer_developers) — or feel free to reach out to us via email at [build@bitlayer.org](mailto:build@bitlayer.org).

docs/BitVMBridge/join-network.md

@@ -6,6 +6,7 @@ sidebar_label: Joining the BitVM Bridge Network (BBN)
 # Joining the BitVM Bridge Network (BBN)
 
 This document outlines how interested parties can participate in the BitVM Bridge Network (BBN) as Brokers, Attesters, or Watchers.
+If you’re interested in getting involved, feel free to contact us via email at [build@bitlayer.org](mailto:build@bitlayer.org).
 
 ## Brokers