Skip to content

Commit

Permalink
Bitcoin bridge update (#17)
Browse files Browse the repository at this point in the history
* docs: apply formatting updates
# Documentation Pull Request Template

## Description

This pull request updates the Bitcoin bridge documentation to improve clarity, accuracy, and completeness. The main changes are:

1. Update time-lock to 1 week based on current DRT implementation
2. Add information on current operator fee and mining fees
3. Ensure proper nesting in points of deposit process
4. Minor improvements to the withdrawal process description for better clarity.

These updates aim to provide more accurate and up-to-date information about the Bitcoin bridge operations, enhancing user understanding and reducing potential misinterpretations.

---

## Type of Change

- [ ] New Document
- [x] Update to Existing Document
- [ ] Bug Fix
- [ ] Question/clarification
- [ ] Other (please describe):

---

## Related Issues

Fixes #[issue number related to documentation update, if any]

---

## Checklist

- [x] I have reviewed the existing documentation to avoid duplication.
- [x] The new or updated document includes clear and concise information.
- [ ] All relevant sections (e.g., introduction, usage examples, references)
      are included.
- [x] The document follows the project's style guide and formatting rules.
- [ ] I have included any necessary references or external resources.
- [x] Spellcheck and grammar check have been performed.
- [x] (For updates) I have verified that the changes reflect the current state
      of the project.

---

## Additional Information

The updates to the time-lock period and fee information reflect the current implementation of the Bitcoin bridge. The restructuring of certain sections aims to improve readability and reduce potential misunderstandings.

---

## Reviewer Checklist

- [ ] The purpose and scope of the document are clear.
- [ ] The document is easy to understand and follow.
- [ ] There are no typos or grammatical errors.
- [ ] All necessary sections are included and well-structured.
- [ ] The document is consistent with the project's style guide.
- [ ] Any referenced links or resources are valid and appropriate.

* fix formatting issue

* fix CI checks

* update recovery time period, create nesting for subpoints

* fix subpoint nesting

* fix sub-point list type, typos

* update the tokenized representation of strata BTC to S-BTC

* fix

* Apply suggestions from code review

---------

Co-authored-by: sudikshyapant <sudikshya@alpenlabs.com>
Co-authored-by: Jose Storopoli <jose@storopoli.io>
  • Loading branch information
3 people authored Oct 9, 2024
1 parent 17049b3 commit 2244de5
Showing 1 changed file with 7 additions and 6 deletions.
13 changes: 7 additions & 6 deletions docs/technical/bitcoin-bridge.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ it is broadcast to bitcoin for confirmation.

Deposits and withdrawals are allowed in a denomination of $D$ BTC where
$D = 10 \ \text{BTC}$ is a value predefined by the bridge federation.

The operator fee is set at 5% of the bridge denomination.
The minimum relay fee for transactions is 10 satoshis per vByte.

Expand Down Expand Up @@ -72,7 +73,7 @@ who sends 10[^fees] BTC to a P2TR address, where:
1. "Take back" path,
which allows the user to take back their funds if the bridge fails to
move funds from the Deposit Request Transaction (DRT)
into the bridge address within a 1-week period,
into the bridge address within approximately 8.5 hours,
i.e. it is time-locked and the user can spend it by providing a signature.

This transaction has some metadata attached to it, in the form of an `OP_RETURN`
Expand Down Expand Up @@ -126,11 +127,11 @@ sequenceDiagram
The user requests a withdrawal on Strata and an operator is assigned to
fulfill the request on bitcoin:

1. The user initiates a withdrawal request, in response to which the corresponding
amount of Strata BTC is burned.
1. After the burn is confirmed, the assigned operator creates and signs
Withdrawal Transaction (WT) on the bitcoin blockchain where they spend 10 BTC
from the bridge address' UTXO set,
1. The user initiates a withdrawal request, in response to which
the corresponding amount of strata BTC or `S-BTC` is burned from Strata.
1. After the burn is confirmed, the assigned operator creates
and signs a Withdrawal Transaction (WT) on the Bitcoin blockchain
where they spend 10 BTC from the bridge address' UTXO set,
while subtracting the operator's fee (5% of the bridge denomination)
and the mining fee (minimum 10 satoshis per vByte),
and requests the other $N-1$ operators to sign
Expand Down

0 comments on commit 2244de5

Please sign in to comment.