Libre Chain Docs
WebsiteAppWalletCreate Account
  • The Libre Platform
    • Libre is a Decentralized Lending Marketplace
    • Borrow
    • Lend
    • Run A Libre Node
    • Validators
    • The Smart Contract Platform
      • Building Smart Contracts on Libre
      • Libre Developer Tools
      • Libre Testnet
      • API Docs
  • DeFi on Libre DEX
    • DeFi
    • libreDEX
    • Ordinals
    • Building on Libre
      • How to add a trading pair
  • BitcoinFi on Libre
    • Glossary
  • The LIBRE Reward Coin
    • A reward system for validators and stakers
    • Supply
    • Mint Rush
    • Spindrop
      • How to Claim the LIBRE Spindrop
      • Eligibility Requirements for the LIBRE Spindrop
  • ACCOUNTS AND WALLETS
    • LIBRE Account Names
      • Cryptographic Keys
    • Creating Multiple Accounts
    • Bitcoin Libre Wallet
    • Anchor Wallet
      • Creating a Libre MainNet Account in Anchor
      • Creating a Libre Testnet Account in Anchor
      • Getting Testnet LIBRE Coins
    • Ledger Hardware Wallet
  • EARN
    • Staking
    • Mining
    • Referrals
    • Become a Validator
    • DAO Tax
    • Libre Lightning Provider
  • Governance
    • Voting Power
    • Validator Election
    • Libre DAO
    • Libre Governance Docs
      • Libre Blockchain Operating Agreement (LBOA)
      • Block Producer Agreement
      • Block Producer Minimum Requirements
    • Libre Mainnet Multisig Gov
      • Oct 2024
      • July 2023
      • June 2023
      • April 2023
      • March 2023
      • February 2023
      • December 2022
  • Technical Details
    • Libre Core Constants
    • Mint Rush Details
    • Staking Details
    • Verifying Code Updates
      • Deployed Smart Contract Versions
  • Cross-Chain Interoperability
    • Cross-Chain Overview
    • Bridge Comparison
    • Libre CrossLink Bridge
      • Technical Whitepaper
      • Bitcoin to Libre (Peg-In Process)
      • Libre to Bitcoin (Peg Out)
    • Bitcoin Lightning Network
    • USDT / Ethereum
    • Legacy pNetwork
    • Bitcoin Audit
Powered by GitBook
On this page

Was this helpful?

Edit on GitLab
  1. Cross-Chain Interoperability
  2. Libre CrossLink Bridge

Bitcoin to Libre (Peg-In Process)

Libre Crosslink’s peg-in process allows users to securely bridge Bitcoin onto the Libre blockchain, converting Bitcoin into pegged BTC tokens that can be used within the Libre ecosystem.

Here’s a step-by-step breakdown:

1. Account Creation on Libre

First, you need to create an account on the Libre blockchain. This account will be linked to any Bitcoin addresses you generate through the peg-in process.

2. Requesting a Bitcoin Address from x.libre

To begin, request a Bitcoin address by interacting with the x.libre bridge contract. This address will be generated in the bc1q... format (Bech32) and will be linked to your Libre account for the peg-in process.

3. Smart Contract Entry (pending scope)

Your request is recorded in the x.libre smart contract, where it is marked with the status "pending". This contract table is monitored by the MPC nodes.

4. MPC Nodes Monitor and Generate Key Shards

MPC nodes detect the request and initiate the process of generating shards of the Bitcoin private key using the TSS protocol. Each node computes part of the private key independently.

5. Signing and Address Generation

Once the required number of nodes collaborate and sign using their key shards, the Bitcoin address (bc1q...) is generated. The smart contract status is updated to "completed".

6. Bitcoin Address Displayed in the UI

The newly generated Bitcoin address is shown in your Libre account’s UI. You can now send Bitcoin to this address.

7. MPC Nodes Monitor for Incoming Bitcoin

MPC nodes, each running a Bitcoin full node, monitor the Bitcoin blockchain for transactions sent to the bc1q... address. When Bitcoin is received, the nodes independently confirm the transaction.

8. Associating the Transaction with Your Libre Account

The x.libre contract tracks which Libre account is linked to each Bitcoin address, ensuring that the received Bitcoin is tied to the correct user.

9. Partial Signing to Issue BTC on Libre

Once Bitcoin is received, the MPC nodes generate a partially signed Bitcoin transaction (PSBT) to mint an equivalent amount of pegged BTC on the Libre blockchain.

10. Broadcast and BTC Issuance on Libre

Once enough nodes sign the PSBT to meet the required threshold, the transaction is broadcast on the Libre blockchain, and the pegged BTC tokens are issued to your Libre account. The Bitcoin you sent is now represented as BTC on Libre, ready for use.

PreviousTechnical WhitepaperNextLibre to Bitcoin (Peg Out)

Last updated 1 month ago

Was this helpful?