add content

Author: Petrica-B

docs/node-operators/app/index.md

@@ -1,7 +1,7 @@
 ---
-title: Getting Started with the Node Operators App
+title: Getting started with the node operators app
 sidebar_position: 1
-description: Intro to the Node Operators App
+description: Intro to the node operators app
 ---
 
 # Getting Started with the Node Operators App

docs/node-operators/app/linking-unlinking-your-edge-node.md

@@ -1,5 +1,5 @@
 ---
-title: Linking/Unlinking your Edge Node
+title: Linking/unlinking your edge node
 sidebar_position: 4
 description: Learn how to link or unlink your license to your Edge Node
 ---
@@ -11,6 +11,7 @@ description: Learn how to link or unlink your license to your Edge Node
 - What must be ready before linking
 - Why a linked license is required for network participation
 - How to link a license to your node ETH address in the app
+- How to change the linked node ETH address in the app
 - How to unlink a node from a license in the app
 
 ---
@@ -55,22 +56,29 @@ you provided. ![Linked License](../img/10.jpg)
 
 ## Unlink your node from your license
 
-1. Open `app.ratio1.ai` and connect the wallet that owns your license.
-2. Go to **Licenses & Nodes** and find a license that already has a linked node.
-3. Open the license menu and select **Unlink**.
-4. Confirm unlinking.
-5. Sign the transaction in your wallet.
+1. Open the license menu and select **Unlink**.
+2. Confirm unlinking.
+3. Sign the transaction in your wallet.
 
 After confirmation, the node is unlinked from that license.
 
+## Change node
+
+1. Open the license menu and select **Change node**.
+2. Fill in the new node ETH address.
+3. Confirm the change.
+4. Sign the transaction in your wallet.
+
+After confirmation, the license is linked to the new node.
+![Unlink node/Change node](../img/11.jpg)
+
 :::note Cooldown after unlinking 
-Once a node is unlinked, a **24-hour cooldown**
+Once a node is unlinked or chaned with another one, a **24-hour cooldown**
 period applies before another node can be linked to that license. 
 :::
 
 :::warning Claim rewards first 
-Claim your rewards before you unlink a node or
-change to another node. 
+Claim your rewards before you unlink or change a node.
 :::
 
 ---

docs/node-operators/app/rewards-understanding-and-claiming.md

@@ -1,20 +1,85 @@
 ---
-title: Rewards Understanding and Claiming
+title: Rewards understanding and claiming
 sidebar_position: 5
-description: how rewards work on Ratio1
+description: Overview of reward types and how to earn and claim them on Ratio1
 ---
 
 # Rewards Understanding and Claiming
 
 ## What this covers
 
-- Core concepts and definitions for this topic.
-- Practical guidance and recommended next steps.
+- The two reward types for node operators: **PoA** and **PoAI**
+- How rewards are allocated every epoch (**24 hours**)
+- How oracle verification and reward claiming work in practice
 
-## Notable date
+---
+
+## Reward model overview
+
+To earn rewards, your node must be linked to a valid Node Deed license and
+actively participate in the protocol.
+
+In Ratio1, rewards are allocated by epoch:
+
+- **1 epoch = 24 hours**
+- Both **Proof of Availability (PoA)** and **Proof of AI (PoAI)** are allocated
+  each epoch based on oracle-verified node activity
+
+---
+
+## Reward types
+
+### Proof of Availability (PoA)
+
+**PoA** represents capped protocol rewards for node availability and uptime.
+
+- It rewards operators for keeping nodes online and reachable
+- Allocation is epoch-based (every 24 hours)
+- Rewards depend on verified availability during that epoch
+- PoA rewards are minted at the time of claiming
+
+### Proof of AI (PoAI)
+
+**PoAI** represents rewards from compute jobs executed on your node.
 
-- TBD (add a source link).
+- It rewards operators for real workload execution
+- Allocation is epoch-based (every 24 hours)
+- Rewards depend on verified job execution in that epoch
+- PoAI rewards are paid by Cloud Service Providers (CSPs) through escrow smart
+  contracts funded when jobs are deployed
 
-## Next steps
+---
+
+## How epoch allocation works
+
+1. Your node reports uptime and executes jobs during the epoch.
+2. Oracles verify node availability and job execution data.
+3. Oracles allocate PoA and PoAI rewards for that epoch.
+4. PoA becomes claimable and is minted when claimed; PoAI is paid from
+   CSP-funded escrow contracts based on verified execution.
+
+In short: oracles are the verification layer that confirms real node
+contribution before rewards are allocated.
+
+---
+
+## Claim your rewards
+
+1. Open `app.ratio1.ai` and connect the wallet that owns the license.
+2. Go to **Licenses & Nodes**.
+3. Select the eligible linked license(s).
+4. Click **Claim rewards** under PoA & PoAI. Alternatively, you can claim PoA
+   and PoAI rewards from all your running nodes using the top dashboard on the
+   Licenses & Nodes page.
+   ![Claim node rewards](../img/12.jpg)
+   ![Claim all rewards](../img/13.jpg)
+5. Confirm and sign the transaction in your wallet.
+
+After confirmation, claimed rewards are minted (PoA)/transferred (PoAI) to
+your wallet according to protocol rules.
+
+---
+
+## Notable date
 
-- Back to [Getting Started with the main Dashboard](../).
+- Reviewed on **February 18, 2026**.

docs/node-operators/app/selling-buying-or-transferring-a-license.md

@@ -0,0 +1,75 @@
+---
+title: Selling, buying, or transferring a license
+sidebar_position: 6
+description: Learn who can sell, buy, or transfer licenses and how the process works
+---
+
+# Selling, buying, or transferring a license
+
+## What this covers
+
+- Who can sell, buy, or transfer a license
+- The two transfer methods (direct transfer or NFT marketplace sale)
+- What the current owner must do before transfer
+- What the new owner must complete before using the license
+
+---
+
+## Who can sell, buy, or transfer
+
+- Any current license owner can transfer or sell their license.
+- Any user can receive or buy a license.
+- Ownership transfer is allowed both directly and via decentralized NFT
+  marketplaces.
+
+---
+
+## How transfers work
+
+Licenses can change ownership in two ways:
+
+- Directly wallet-to-wallet
+- Through decentralized NFT trading platforms (for example,
+  [OpenSea](https://opensea.io/collection/ratio1ai))
+
+In both cases, the onchain owner changes to the receiving wallet.
+
+---
+
+## Before selling or transferring (current owner checklist)
+
+Before you send a license or list it for sale:
+
+1. Claim all pending rewards.
+2. Unlink the node from the license.
+
+:::warning Important
+Always claim rewards and unlink the node before transferring ownership or listing the license on a decentralized NFT marketplace. If you don’t, the transfer transaction will fail. The listing for sale may succeed, but the purchase will not go through.
+:::
+
+---
+
+## After buying or receiving (new owner checklist)
+
+Buying or receiving a license does not automatically activate it for protocol
+use.
+
+The new owner must still:
+
+- Be eligible under Ratio1 compliance rules
+- Complete and pass KYC/KYB
+
+Only after eligibility checks and KYC/KYB can the new owner link the license to
+a node and use it in the Ratio1 protocol.
+
+---
+
+## Key rule to remember
+
+Ownership transfer is permissionless, but protocol usage is compliance-gated.
+
+---
+
+## Notable date
+
+- Reviewed on **February 18, 2026**.

docs/node-operators/app/selling-or-transferring-your-license.md

@@ -5,13 +5,14 @@ Source of truth for scope: `todo/README.md`
 
 ## Sections to Write/Prepare
 
-- [ ] `1.` Ratio1 Docs - welcome message
-- [ ] `3.` For Node Operators - introduction to node operation
-- [ ] `3.1.` Getting Started with the main Dashboard - intro to the dashboard
-- [ ] `3.1.1.` Buying your first Ratio1 license - purchasing and activating a license
-- [ ] `3.1.2.` Linking your Edge Node - connecting your license with your nodes
-- [ ] `3.1.3.` Rewards Understanding and Claiming - how rewards work on Ratio1
-- [ ] `3.1.4.` Selling or transferring your license - transferring ownership of your license
+- [x] `1.` Ratio1 Docs - Welcome message
+- [x] `3.` For Node Operators - Introduction to node operation
+- [x] `3.1.` Getting Started with the Node Operators App - Intro to the Node Operators App
+- [x] `3.1.1.` Email registration & KYC/KYB - Getting your wallet verified
+- [x] `3.1.2.` Buying your first Ratio1 license - Purchasing a Node Deed license
+- [x] `3.1.3.` Linking/Unlinking your Edge Node - Learn how to link or unlink your license to your Edge Node
+- [x] `3.1.4.` Rewards Understanding and Claiming - Overview of reward types and how to earn and claim them on Ratio1.
+- [x] `3.1.5.` Selling, buying, or transferring a license - transferring ownership of your license
 - [ ] `4.` For CSPs - introduction to CSP operation
 - [ ] `4.1.` Getting Started with Ratio1 for CSPs - why and intro to the requirements
 - [ ] `4.1.1.` Becoming a CSP - steps to become a CSP on Ratio1