mirror of
https://github.com/aljazceru/ark.git
synced 2025-12-17 04:04:21 +01:00
a8f3039e69
* adds homepage (wip) * fix footer links * update nomenclature link on blog post * small fixes and markdown format * link fix * make all docs links relative * fix vtxo links * fix errors with Safari * improves arm detection * fix bottom color * update roadmap * adds faucet instructions * change ark-cli instructions to accomodate PR 117 * instructions fixes to accomodate onboarding; ui improvements
53 lines
2.3 KiB
Markdown
53 lines
2.3 KiB
Markdown
---
|
|
sidebar_position: 2
|
|
title: 'Boarding the Ark'
|
|
---
|
|
|
|
### Overview
|
|
|
|
Alice wants to board the Ark of a well-known Ark service provider (ASP). It requires an on-chain transaction.
|
|
|
|
Depending on the type of [Boarding transaction](./nomenclature#boarding-transaction) chosen by the ASP, the timeline is different.
|
|
|
|
### 🧳 Boarding with Luggage
|
|
|
|
- Alice must be online **at least once every 4 weeks** to keep her funds safe
|
|
- If ASP is unresponsive, Alice can claim her funds back in **24 hours**
|
|
- Easier for the ASP since all VTXOs are born equal
|
|
- To unlock the boarding address Alice needs to make two transactions:
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
V["VTXO's timeout after 24 hrs"]
|
|
Covenant --> V
|
|
```
|
|
|
|
#### Timeline of events
|
|
|
|
1. Alice creates a [Boarding transaction](./nomenclature#with-luggage)
|
|
2. Alice adds any inputs she wants to cover the values the [VTXO](./nomenclature#vtxo-1) she will receive, plus on-chain fees
|
|
3. Alice adds an output with **2 spending paths**:
|
|
- This funds will belong to the ASP after 4 weeks:
|
|
- `(ASP after 4w)`
|
|
- A covenant output that forces coins to be spent by a [VTXO](./nomenclature#vtxo-1) with an output script with **2** spending paths:
|
|
- `(Alice + ASP)`
|
|
- `(Alice after 24h)`
|
|
4. Alice notifies ASP about the [Boarding transaction](./nomenclature#with-luggage)
|
|
5. Alice has now a promise of a [VTXO](./nomenclature#vtxo-1) enforced by a covenant
|
|
|
|
### 🎒 Boarding without Luggage
|
|
|
|
- Alice don't need to worry about being online to maintain access to her funds after boarding
|
|
- If ASP is unresponsive, Alice can claim her funds back in **1 year**
|
|
- ASP must be aware of the timeout on the [Boarding transaction](./nomenclature#without-luggage) to prevent double spending
|
|
|
|
#### Timeline of events
|
|
|
|
1. Alice creates a [Boarding transaction](./nomenclature#without-luggage)
|
|
2. Alice adds any inputs she wants to cover the values the [VTXO](./nomenclature#vtxo-1) she will receive, plus on-chain fees.
|
|
3. Alice adds an output with **2** spending paths:
|
|
- `(Alice + ASP)`
|
|
- `(Alice after 1y)`
|
|
4. Alice notifies ASP about the [Boarding transaction](./nomenclature#without-luggage)
|
|
5. Alice can have this deposit to be accepted as if it were a normal [VTXO](./nomenclature#vtxo-1) born in an Ark [Pool transaction](./nomenclature#pool-transaction-aka-ark-transaction)
|