Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/BitVMBridge/BBN/001-understanding-bbn.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,11 +40,11 @@ A key example is the **BitVM Coordinator**, a protocol contract that plays a cru

A primary function of the BitVM Coordinator is to manage the **attesting committee** for each new BitVM smart contract. This committee is a group of nodes that pre-signs the transaction graph. The Coordinator streamlines this process by:

1. **Electing the Pre-Signing Committee:** For each new contract, the Coordinator selects committee members from a pool of trusted and eligible candidates.
1. **Electing the Attesting Committee:** For each new contract, the Coordinator selects committee members from a pool of trusted and eligible candidates.
2. **Implementing Incentives:** To ensure liveness and discourage malicious behavior, the Coordinator manages an incentive structure. Honest committee members are rewarded for their participation, while malicious actors are penalized through slashing.
3. **Coordinating Signatures:** Once the committee is formed, the Coordinator orchestrates the signing process to ensure all members contribute their signatures in a timely and coordinated manner.

To leverage this functionality, applications must run an **attester node**. For example, a BitVM bridge requires its attester node to verify the format of each transaction in the graph, sign it, and submit the signature to the Coordinator.
To leverage this functionality, applications must run their own **attester node**. For example, a BitVM bridge requires its attester node to verify the format of each transaction in the graph, sign it, and submit the signature to the Coordinator.

### Watcher Coordination

Expand Down
8 changes: 4 additions & 4 deletions docs/BitVMBridge/BBN/002-joining-bbn.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@ If you’re interested in getting involved, feel free to contact us via email at
The BitVM Bridge Broker role can appeal to various entities for different purposes. Below are some examples of how participants might engage as Brokers:

- Type 1: Providing Liquidity Services to End Users
You might operate as a Broker to generate revenue by servicing the peg-out requests of end-users and charging transaction fees.
You might operate as a Broker to generate revenue by servicing the peg-out requests of end-users and charging transaction fees.
- Type 2: Supporting Your Business Operations
You might operate as a Broker if you run a business (such as DeFi protocols or other services) that integrates YBTC (a highly secure bridged BTC asset) and you require the BitVM Bridge to balance your BTC/YBTC positions. The flexible peg-out feature of the Bitlayer BitVM Bridge allows participants with such needs to achieve this cost-effectively.
You might operate as a Broker if you run a business (such as DeFi protocols or other services) that integrates YBTC and you require the BitVM Bridge to balance your BTC/YBTC positions. The flexible peg-out feature of the Bitlayer BitVM Bridge allows participants with such needs to achieve this cost-effectively.

Regardless of the specific motivation, all prospective Brokers must meet the following requirements:

Expand All @@ -31,13 +31,13 @@ Regardless of the specific motivation, all prospective Brokers must meet the fol

2. Long-Term Collateral:

All brokers are required to provide long-term liquidity as collateral. A minimum of 0.5 BTC is necessary to participate in a single bridge instance.
All brokers are required to provide long-term liquidity as collateral. A certain amount (denoted as `minimum_collateral_per_reclaim`) of BTC is necessary to participate in a single bridge instance.

Note: This collateral will be refunded once the corresponding bridge funds are reclaimed. The duration for this refund depends on the timing of user requests and the reclaim process.

3. Short-Term Liquidity (Especially for User-Facing Services):

Brokers, particularly those aiming to provide liquidity services to end-users (as in Example 1), will need readily available short-term liquidity to front peg-out requests. A minimum of 2 BTC is recommended for this purpose.
Brokers, particularly those aiming to provide liquidity services to end-users (as in Type 1), will need readily available short-term liquidity to front peg-out requests. A minimum of 2 BTC is recommended for this purpose.

Note: This liquidity will be reclaimed from the BitVM smart contract after the broker has fronted the peg-out request. The typical duration for this reclaim is the challenge window, which is generally one week.

Expand Down
2 changes: 1 addition & 1 deletion docs/BitVMBridge/BBN/003-bbn-governance.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The governance of the BitVM Bridge Network will be centered around the **Bitlaye

**Key Features:**

- **Governance Platform:** The core governance smart contracts will be deployed on the **Bitlayer Network** (the L2 scaling solution for Bitcoin). You can find more information about Bitlayer Network at [https://www.bitlayer.org/](https://www.bitlayer.org/).
- **Governance Platform:** The core governance smart contracts will be deployed on the **Bitlayer Network**. You can find more information about Bitlayer Network at [https://www.bitlayer.org/](https://www.bitlayer.org/).
- **Membership:** Any individual or entity holding a specified minimum amount of BTR tokens will be eligible to participate as a governance member. The exact threshold will be defined in the forthcoming governance framework.
- **Proposal Submission:** Any eligible governance member can create new proposals and initiate the voting process.
- **Discussion Forum:** A dedicated governance forum (currently under construction) will serve as the primary platform for discussing proposals, debating ideas, and fostering community consensus before formal voting.
Expand Down
7 changes: 4 additions & 3 deletions docs/BitVMBridge/Concepts/098-roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: roadmap

# Roadmap

![Roadmap](/img/BitvmBridge/introduction/roadmap1.png)
![Roadmap](/img/BitvmBridge/introduction/roadmap.png)

## **DEC.2024**

Expand All @@ -19,8 +19,9 @@ slug: roadmap

## **July 2025**

- Mainnet Beta Launch
- Mainnet Beta Launch (Ethereum)

## **H2. 2025**

- Support for Additional Chains
- Mainnet Launch (SUI)
- Support more Blockchains
28 changes: 0 additions & 28 deletions docs/BitVMBridge/DevGuides/001-introduction-ybtc.md

This file was deleted.

20 changes: 0 additions & 20 deletions docs/BitVMBridge/DevGuides/002-build-with-ybtc.md

This file was deleted.

6 changes: 0 additions & 6 deletions docs/BitVMBridge/DevGuides/_category_.json

This file was deleted.

Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ slug: integrating-target-chain

## Introduction to Bitlayer's BitVM Bridge

Bitlayer's BitVM Bridge is a cutting-edge solution designed to facilitate the movement of Bitcoin assets to a diverse array of blockchain ecosystems. This interoperability unlocks a multitude of decentralized finance (DeFi) and yielding opportunities for Bitcoin holders. The bridge supports a multi-chain architecture, encompassing both Layer 1 (L1) blockchains such as Ethereum, Cardano, Sui, Plume, Sonic SVM, and Solana, as well as Layer 2 (L2) solutions including Bitlayer Network, Base, Arbitrum, and Starknet, among others.
Bitlayer's BitVM Bridge is a cutting-edge solution designed to facilitate the movement of Bitcoin assets to a diverse array of blockchain ecosystems. This interoperability unlocks a multitude of decentralized finance (DeFi) and yielding opportunities for Bitcoin holders. The bridge supports a multi-chain architecture, encompassing both Layer 1 (L1) blockchains such as Ethereum, Cardano, Sui, Plume, Sonic, and Solana, as well as Layer 2 (L2) solutions including Bitlayer Network, Base, Arbitrum, and Starknet, among others.

The core strength of the BitVM Bridge lies in its extensible design, which simplifies the process of integrating new target chains. This document provides a comprehensive guide for developers from the Bitlayer community who wish to extend the bridge's capabilities by adding support for a new target blockchain.

Expand Down
11 changes: 5 additions & 6 deletions docs/YBTCFamily/YBTC.B/_category_.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
{
"label": "YBTC.B",
"position": 10,
"link": null,
"collapsed": false

}
"label": "YBTC.B",
"position": 10,
"link": null,
"collapsed": false
}
6 changes: 6 additions & 0 deletions docs/YBTCFamily/YBTC/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"label": "YBTC",
"position": 11,
"link": null,
"collapsed": false
}
40 changes: 40 additions & 0 deletions docs/YBTCFamily/YBTC/introducing-ybtc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
sidebar_position: 1
---

# Introducing YBTC

YBTC is a trust-minimized bridged Bitcoin engineered for maximum security, serving as the core asset in Bitlayer's Bitcoin DeFi roadmap.

- **Trust-Minimized Minting**: YBTC can only be minted through the official [Bitlayer BitVM Bridge](https://bitvmbridge.bitlayer.org/home). This bridge is built on the BitVM2 paradigm, inheriting its trust-minimized properties.
- **Native Multi-Chain Asset**: Leveraging the bridge's advanced architecture, YBTC is designed as a multi-chain asset. Support begins with Ethereum and will expand to other blockchains, including:
- **Layer 1s**: Cardano, Sui, Plume, Sonic, Solana, and more.
- **Layer 2s**: Bitlayer Network, Base, Arbitrum, Starknet, and others.
- **DeFi Ready**: As an ERC-20 compliant token, YBTC integrates seamlessly into the vast ecosystem of decentralized applications (DeFi).

![YBTC](/img/BitvmBridge/introduction/yield.png)

## The Security of YBTC

YBTC’s design establishes it as one of the most secure bridged Bitcoin assets available. Its integrity is not based on trusting a centralized custodian but on a verifiable, trust-minimized system.

The underlying BTC is locked in a BitVM-style smart contract on the Bitcoin network. The rules for withdrawal are predefined within a pre-signed transaction graph, making the process transparent and predictable. This system is secured by a set of attesters, and thanks to the cryptographic design, collusion to steal the locked BTC is prevented as long as at least one attester remains honest.

This robust mechanism maintains a **strict 1:1 peg with BTC**. A unit of BTC can only be withdrawn from the smart contract after a corresponding YBTC token has been burned on its respective chain, guaranteeing that every YBTC in circulation is fully backed.

## YBTC for Users

Bitlayer and its partners are building a robust, YBTC-centric yield market. YBTC holders can participate in a variety of DeFi applications to generate returns on their Bitcoin:

- **Lending**: Use YBTC as collateral in lending protocols to borrow assets or earn interest.
- **Decentralized Exchanges (DEXs)**: Provide liquidity or trade YBTC efficiently across decentralized markets.
- **Staking**: Stake YBTC in supported protocols to earn rewards and contribute to network security.

## YBTC for Applications

YBTC offers significant advantages for developers and protocols building on-chain applications:

1. **Reliable BTC Liquidity**: For applications that require dependable BTC liquidity without the counterparty risk or potential for de-pegging, YBTC is the ideal choice.
2. **Multi-Chain Access**: By integrating YBTC, applications—especially those operating across multiple chains—can seamlessly tap into deep, multi-chain BTC liquidity from a single, secure asset.

For more information or to connect with our team, join the official Bitlayer Telegram channel: [https://t.me/bitlayerofficial](https://t.me/bitlayerofficial)
2 changes: 1 addition & 1 deletion docs/YBTCFamily/bl_btc_overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ sidebar_label: Bitlayer Native BTC

# Bitlayer Native BTC Asset: Overview & Technical Characteristics

**Bitlayer Native BTC** is a natively integrated, Bitcoin-pegged asset that exists directly at the protocol level within the Bitlayer Layer 2 blockchain. Unlike traditional ERC-20-style wrapped tokens, this asset is implemented as a first-class system currency—akin to ETH on Ethereum or BTC on the Bitcoin mainnet.
**Bitlayer Native BTC** is a natively integrated, Bitcoin-pegged asset that exists directly at the protocol level within the Bitlayer Network. Unlike traditional ERC-20-style wrapped tokens, this asset is implemented as a first-class system currency—akin to ETH on Ethereum or BTC on the Bitcoin mainnet.

It serves two primary purposes:

Expand Down
10 changes: 10 additions & 0 deletions docs/YBTCFamily/ybtc_family.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
sidebar_position: 1
sidebar_label: YBTC Family
---

# The YBTC Family

- **Bitlayer Native BTC**: The native, Bitcoin-pegged asset for Bitlayer Network V1. It is integrated directly at the protocol level, functioning as a first-class system currency similar to ETH on Ethereum or BTC on the Bitcoin mainnet, rather than as a traditional ERC-20-style token.
- **YBTC.B**: A wrapped token representation of Bitlayer Native BTC.
- **YBTC**: A next-generation, trust-minimized Bitcoin-pegged asset. Positioned as the future of Bitcoin within the DeFi ecosystem, YBTC is slated to become the native currency for the upcoming Bitlayer Network V2 and V3 upgrades.
Binary file modified static/img/BitvmBridge/introduction/roadmap.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed static/img/BitvmBridge/introduction/roadmap1.png
Binary file not shown.
Binary file removed static/img/BitvmBridge/introduction/yield1.png
Binary file not shown.
Loading