Merge pull request #660 from lukso-network/addConcepts

docs/faq/onboarding/tools-and-services.md

@@ -29,14 +29,6 @@ If you want to experiment with the Universal Profile Extension and its interacti
 
 Yes. You can use the in-browser [inspection tool](https://erc725-inspect.lukso.tech/).
 
-## What is a transaction relay service?
-
-A transaction relay service, often referred to as a relayer, is a solution designed to **improve the blockchain user experience** by addressing the issue of gas fees - the costs users pay when executing transactions on a blockchain.
-
-Typically, users must have the blockchain's native token to pay these gas fees. However, a relayer works around this problem. Users can **send their signed transactions** to the relayer. The relayer will then **execute the transaction on their behalf and cover the associated gas cost.**
-
-Payment to the relayer can be handled in different ways. One option is an on-chain payment where the fees are deducted directly from an on-chain balance. Alternatively, users can set up an off-chain agreement with the relayer service via a subscription that gives them a monthly allowance for relayed transactions. This flexibility allows users to **choose the method that best suits their needs**.
-
 ## What is social recovery?
 
 For conventional Ethereum accounts, also known as Externally Owned Accounts (EOAs), losing your private key can be disastrous as it's the sole means of accessing your account. If it's lost, access to the account and all its associated assets is also lost.

docs/faq/onboarding/universal-profiles.md

@@ -5,13 +5,9 @@ sidebar_position: 1
 
 # Universal Profiles
 
-## What is a Universal Profile?
-
-Universal Profiles are **fundamentally new accounts based on smart contracts**, acting as the **center for all your blockchain interactions**. They are generic for various use cases, such as regular wallets, and can interact directly with on-chain applications. However, they also feature permission and asset management, updatable profile information, and let you interact as one persona through different controller keys. With their feature-rich functionality, they can tackle a new wave of blockchain adoption.
-
 ## Is there a Universal Profile Explorer?
 
-Yes, you can find our Universal Profile Explorer at [universalprofile.cloud](https://universalprofile.cloud/). The explorer is currently only showing profiles and assets of the initial L14 Testnet. We will also add the explorer page to our Testnet and Mainnet within the migration process.
+Yes, you can find the Universal Profile Explorer at [universalprofile.cloud](https://universalprofile.cloud/).
 
 ## Why did LUKSO not launch Universal Profiles on Ethereum?
 

docs/learn/concepts.md

@@ -0,0 +1,26 @@
+---
+sidebar_label: '📑 Concepts & Glossary'
+sidebar_position: 2
+---
+
+# Concepts & Glossary
+
+## Universal Profile (UP)
+
+A Universal Profile (UP) is a smart contract-based account that acts as the center for all your blockchain interactions. UPs are generic for various use cases, such as regular wallets, and can interact directly with onchain applications. Additionally, they also feature permission and asset management, updatable profile information, and let you interact as one persona through different controller keys.
+
+## Controller
+
+In the [LSP6 Key Manager](../standards/universal-profile/lsp6-key-manager.md), the term _"controller"_ refers to a permissioned address. These addresses have permissions that allow them to perform certain actions on the [LSP0ERC725Account](../standards/universal-profile/lsp0-erc725account.md) linked with the Key Manager (e.g., setting data or transferring LYX from the account).
+
+The controllers can be Externally Owned Accounts (EOA) or smart contracts. The Key Manager will allow or restrict access based on the permissions set for the calling address.
+A controller can interact directly with the Key Manager, or it can sign messages that can then be executed by other parties (such as users or transaction relay services).
+
+## Transaction Relay Service
+
+A transaction relay service, often referred to as a relayer, is a solution designed to improve the blockchain user experience by addressing the issue of gas fees - the costs users pay when executing transactions on a blockchain.
+
+Typically, users must have the blockchain's native token to pay these gas fees. However, a relayer works around this problem. Users can send their signed transactions to the relayer. The relayer will then execute the transaction on their behalf and cover the associated gas cost.
+Payment to the relayer can be handled in different ways. One option is an onchain payment where the fees are deducted directly from an onchain balance. Alternatively, users can set up an offchain agreement with the relayer service via a subscription model that gives them a monthly allowance for relayed transactions. This flexibility allows users to choose the method that best suits their needs.
+
+Currently, on LUKSO there is a Transaction Relay Service that subsidizes early users' gas fees. In the future, various relay services will be offered by multiple third parties, evolving into a competitive relay ecosystem with various business models.

docs/learn/introduction.md

@@ -1,4 +1,9 @@
-# Basics
+---
+sidebar_label: 'Introduction'
+sidebar_position: 1
+---
+
+# Introduction
 
 ## What is LUKSO?
 

sidebars.js

@@ -13,6 +13,7 @@ module.exports = {
   networksSidebar: [{ type: 'autogenerated', dirName: 'networks' }],
   standardsSidebar: [{ type: 'autogenerated', dirName: 'standards' }],
   guidesSidebar: [{ type: 'autogenerated', dirName: 'guides' }],
+  learnSidebar: [{ type: 'autogenerated', dirName: 'learn' }],
   contractsSidebar: [
     'contracts/introduction',
     'contracts/getting-started',