Skip to content

Commit

Permalink
Update hybrid-custody/index.md w/ overview
Browse files Browse the repository at this point in the history
  • Loading branch information
sisyphusSmiling committed Mar 21, 2023
1 parent bcfc4fb commit f2876a2
Showing 1 changed file with 22 additions and 5 deletions.
27 changes: 22 additions & 5 deletions docs/content/hybrid-custody/index.md
@@ -1,11 +1,28 @@
---
title: Account Linking Overview
title: Hybrid Custody Overview
---

Account Linking on Flow enables developers to provide seamless onboarding and in-app experiences while simultaneously empowering users with real ownership and self-sovereignty.聽 With this model of [hybrid custody](https://forum.onflow.org/t/hybrid-custody/4016), developers can deliver the benefits of both app and self custody in a unified experience.
The Hybrid Custody model on Flow enables developers to provide seamless onboarding and in-app experiences while simultaneously empowering users with real ownership and self-sovereignty.聽 With this [new custodial model](https://forum.onflow.org/t/hybrid-custody/4016), developers can deliver the benefits of both app and self-custody in a unified experience.

Account Linking is a process by which an app on Flow establishes a parent-child relationship between an in-app custodial account (child) and a self-custody wallet (parent).聽 In this process, the child account opts into delegation of control to the parent account, enabling both accounts to control the digital items in the child account.
The full Hybrid Custody model is enabled by three core components:
- Walletless Onboarding - App managed account creation, funding, and custody
- Account Linking - App custodied accounts delegate access to wallet-authenticated users
- LinkedAccounts contract - A standard contract enabling users to view and manage their linked accounts

This shared control over the digital items in the in-app account enables users to establish real ownership of the items beyond the context of the app, where they can use their self-custody wallet to take the items to other apps in the ecosystem, such as a marketplace or a game.聽 Most importantly, users are able to do this without the need to transfer the digital items between the two accounts, making it seamless to continue using the original app while also using other apps.
### The Path to Hybrid Custody

With account linking, developers can build walletless onboarding experiences for new users that provide a clear path to self-custody.聽 Read our Walletless Onboarding guide for more details on how developers can use Account Linking to build these experiences on Flow.
1. The app creates, funds, and manages access to a Flow account initialized on user onboarding. This enables the app to abstract away the complexities of interacting with smart contract powered applications, and focus on creating slick user experiences behind familiar Web2 authentication and fiat denominated payments.
1. Once a user returns to the app with a self-custodial wallet, they can authenticate their wallet-managed account in the app, allowing the app to give the user's main account delegated access to the app managed account.
1. Upon linking, the user's main account - now the "parent" account - adds the app created account - now the "child" account - to a collection of all linked child accounts. At this point, Hybrid Custody is reached

### Why Care?

Hybrid Custody grants users full access to their linked child accounts without needing to interface with the child account's custodial app, **and** the custodial app can interact with the relevant assets in the child account on behalf of the user in a frictionless UX free from transaction prompts.

> All assets in the app account can now jump the walled garden to play in the rest of the Flow ecosystem.
This shared control over the digital items in the in-app account enables users to establish real ownership of the items beyond the context of the app, where they can use their self-custody wallet to take the items to other apps in the ecosystem, such as a marketplace or a game.

Most importantly, users are able to do this without the need to transfer the digital items between the two accounts, making it seamless to continue using the original app while also using other apps.

With account linking, developers can build walletless onboarding experiences for new users that provide a clear path to self-custody. Continue on to read our Walletless Onboarding guide for more details on how you can use Account Linking to build spectacular experiences on Flow.

0 comments on commit f2876a2

Please sign in to comment.