Files
ark/website/docs/learn/boarding.md
João Bordalo a8f3039e69 Add gh/download links & Update roadmap (#109)
* 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
2024-03-05 14:06:31 +01:00

2.3 KiB

sidebar_position, title
sidebar_position title
2 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 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:
flowchart LR
  V["VTXO's timeout after 24 hrs"]
  Covenant --> V

Timeline of events

  1. Alice creates a Boarding transaction
  2. Alice adds any inputs she wants to cover the values the VTXO 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 with an output script with 2 spending paths:
      • (Alice + ASP)
      • (Alice after 24h)
  4. Alice notifies ASP about the Boarding transaction
  5. Alice has now a promise of a VTXO 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 to prevent double spending

Timeline of events

  1. Alice creates a Boarding transaction
  2. Alice adds any inputs she wants to cover the values the VTXO 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
  5. Alice can have this deposit to be accepted as if it were a normal VTXO born in an Ark Pool transaction