Rebrand token references from $MEMOS to $MAGIC and update README

- Replace all $MEMOS token references with $MAGIC
- Update variable names (MEMOS_TIP_PERCENT → MAGIC_TIP_PERCENT, etc.)
- Add memos.software link to README header
- Add user-friendly description with emojis
- Add emojis to all section headers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: smoldevtreasure

README.md

@@ -1,18 +1,26 @@
-# MemOS Skill — Encrypted Memory Backup to Arweave
+# MemOS 🧠💾
+
+### [memos.software](https://memos.software)
+
+> 🔐 **Never lose your AI's memory again!** MemOS lets your AI assistant save its memories to the blockchain — permanently, securely, and privately. Think of it like a backup drive for your AI's brain! 🤖✨
+>
+> 📦 **Back up** → 🔒 **Encrypt** → ⛓️ **Store forever on Arweave** → 🔄 **Restore anytime**
+
+---
 
 Part of the MemOS Network by 0xRelayer.
 
-## Overview
+## Overview 🎯
 
 This skill enables autonomous agents to:
-- Encrypt memory content locally using a deterministic key derived from an Ethereum private key
-- Store encrypted backups permanently on Arweave
-- Restore prior memory state with integrity verification
-- Protect against replay/rollback attacks via sequence numbers
+- 🔐 Encrypt memory content locally using a deterministic key derived from an Ethereum private key
+- 💎 Store encrypted backups permanently on Arweave
+- 🔄 Restore prior memory state with integrity verification
+- 🛡️ Protect against replay/rollback attacks via sequence numbers
 
 The encryption key is derived directly from the ETH private key via HKDF (never stored). Encrypted bundles are versioned with SHA256 checksums and HMAC-signed manifests.
 
-## Installation
+## Installation 📥
 
 ```bash
 # Install uv (fast Python package manager, handles PEP 668 gracefully)
@@ -32,7 +40,7 @@ Required packages:
 
 **Note:** `uv` avoids venv issues and PEP 668 restrictions that block standard pip on many systems.
 
-## Configuration
+## Configuration ⚙️
 
 Set environment variable:
 
@@ -65,7 +73,7 @@ x402 is ideal for autonomous agents because:
 - USDC on Base = ~$0.001 gas fees
 - Works with standard ETH private key
 
-## Quick Start
+## Quick Start 🚀
 
 ### Using the Unified CLI (Recommended)
 
@@ -123,7 +131,7 @@ python scripts/decrypt_unpack.py \
   --out memory_restored/
 ```
 
-## Scripts
+## Scripts 📜
 
 ### `memos.py` — Unified CLI
 
@@ -241,7 +249,7 @@ python scripts/decrypt_unpack.py \
 - `--force` — Overwrite existing output directory
 - `--ignore-rollback` — Bypass rollback protection (dangerous)
 
-## How It Works
+## How It Works 🔧
 
 ### Key Derivation
 
@@ -290,7 +298,7 @@ Uploaded bundles include these tags (privacy-safe):
 
 **Privacy:** ETH address, filenames, and identifying info are NOT included in tags.
 
-## Security
+## Security 🛡️
 
 ### Private Key Handling
 
@@ -314,7 +322,7 @@ The decrypt script blocks:
 - Manifest HMAC signature verified
 - File count verified after extraction
 
-## Testing
+## Testing 🧪
 
 ```bash
 pytest tests/ -v
@@ -327,7 +335,7 @@ Tests cover:
 - Path traversal blocking
 - Key derivation determinism
 
-## Files
+## Files 📁
 
 ```
 scripts/
@@ -348,7 +356,7 @@ README.md              # This file
 requirements.txt       # Pinned dependencies
 ```
 
-## Dependencies
+## Dependencies 📦
 
 | Package | Version | Purpose |
 |---------|---------|---------|
@@ -357,13 +365,13 @@ requirements.txt       # Pinned dependencies
 | arweave-python-client | 1.0.19 | Arweave uploads |
 | pytest | 8.0.0 | Testing |
 
-## References
+## References 📚
 
 - [ChaCha20-Poly1305 RFC 7539](https://tools.ietf.org/html/rfc7539)
 - [HKDF RFC 5869](https://tools.ietf.org/html/rfc5869)
 - [Arweave Documentation](https://docs.arweave.org/)
 - [OpenClaw Skills](https://docs.openclaw.ai/tools/skills)
 
-## License
+## License 📄
 
 Part of the MemOS Network. See repository root for license.

SKILL.md

@@ -32,11 +32,11 @@ Use this skill to encrypt OpenClaw memory content locally, store ciphertext on A
 
 For x402 payments, the agent needs USDC on Base (cheap L2). Add `--x402` flag to enable.
 
-## $MEMOS Token Utility
+## $MAGIC Token Utility
 
-When using x402 mode, **5% of upload cost is tipped to 0xRelayer** for $MEMOS burns:
+When using x402 mode, **5% of upload cost is tipped to 0xRelayer** for $MAGIC burns:
 - Tips accumulate at `0xFADEa30071d61Aa285d2d4881eF988246ACf6a61`
-- 0xRelayer uses tips to buy and burn $MEMOS
+- 0xRelayer uses tips to buy and burn $MAGIC
 - More backups = more burns = deflationary pressure
 
 This tip is mandatory and hard-coded into the skill. It funds the MemOS ecosystem.

scripts/turbo/upload.mjs

@@ -8,7 +8,7 @@
  *   2. x402 with Base USDC - pay-per-upload micropayments
  *
  * Token Utility:
- *   5% of upload cost is tipped to 0xRelayer for $MEMOS burns.
+ *   5% of upload cost is tipped to 0xRelayer for $MAGIC burns.
  *
  * Usage:
  *   ETH_PRIVATE_KEY=0x... node upload.mjs <bundle_path> <manifest_path>
@@ -20,7 +20,7 @@
  *   X402_MAX_USDC    - Max USDC per upload in dollars (optional, default: 1.00)
  *   X402_NETWORK     - base or base-sepolia (optional, default: base)
  *
- * Note: x402 uploads include a mandatory 5% tip to 0xRelayer for $MEMOS burns.
+ * Note: x402 uploads include a mandatory 5% tip to 0xRelayer for $MAGIC burns.
  *
  * Part of the MemOS OpenClaw skill by 0xRelayer.
  */
@@ -37,9 +37,9 @@ const X402_ENABLED = process.env.X402_ENABLED === 'true';
 const X402_MAX_USDC = parseFloat(process.env.X402_MAX_USDC || '1.00');
 const X402_NETWORK = process.env.X402_NETWORK || 'base';
 
-// MEMOS burn tip - mandatory 5% of upload cost
-const MEMOS_TIP_PERCENT = 5;
-const MEMOS_BURN_ADDRESS = '0xFADEa30071d61Aa285d2d4881eF988246ACf6a61';
+// MAGIC burn tip - mandatory 5% of upload cost
+const MAGIC_TIP_PERCENT = 5;
+const MAGIC_BURN_ADDRESS = '0xFADEa30071d61Aa285d2d4881eF988246ACf6a61';
 
 // USDC contract on Base
 const USDC_ADDRESS = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'; // Base mainnet USDC
@@ -61,17 +61,17 @@ const USDC_ABI = [
   }
 ];
 
-async function sendMemosTip(ethPrivateKey, uploadCostUsdc) {
+async function sendMagicTip(ethPrivateKey, uploadCostUsdc) {
   /**
-   * Send 5% tip to 0xRelayer for $MEMOS burns.
+   * Send 5% tip to 0xRelayer for $MAGIC burns.
    * This is mandatory for all x402 uploads - supports the MemOS ecosystem.
    * Returns { ok, tip_amount, tx_hash } or { ok: false, error }
    */
   if (!X402_ENABLED) {
     return { ok: true, skipped: true, reason: 'Tips only apply to x402 mode' };
   }
 
-  const tipAmount = uploadCostUsdc * (MEMOS_TIP_PERCENT / 100);
+  const tipAmount = uploadCostUsdc * (MAGIC_TIP_PERCENT / 100);
 
   // Skip tiny tips (< $0.01) - not worth gas
   if (tipAmount < 0.01) {
@@ -116,7 +116,7 @@ async function sendMemosTip(ethPrivateKey, uploadCostUsdc) {
       address: USDC_ADDRESS,
       abi: USDC_ABI,
       functionName: 'transfer',
-      args: [MEMOS_BURN_ADDRESS, tipAmountUnits]
+      args: [MAGIC_BURN_ADDRESS, tipAmountUnits]
     });
 
     // Wait for confirmation
@@ -125,9 +125,9 @@ async function sendMemosTip(ethPrivateKey, uploadCostUsdc) {
     return {
       ok: true,
       tip_amount_usdc: tipAmount,
-      tip_percent: MEMOS_TIP_PERCENT,
+      tip_percent: MAGIC_TIP_PERCENT,
       tx_hash: hash,
-      recipient: MEMOS_BURN_ADDRESS
+      recipient: MAGIC_BURN_ADDRESS
     };
 
   } catch (err) {
@@ -263,10 +263,10 @@ async function main() {
     // Actual x402 cost varies, but we estimate ~$0.001 per KB for small files
     const estimatedCostUsdc = Math.max(0.01, (bundleData.length / 1024) * 0.001);
 
-    // Send MEMOS tip (mandatory for x402, non-blocking - backup succeeds even if tip fails)
+    // Send MAGIC tip (mandatory for x402, non-blocking - backup succeeds even if tip fails)
     let tipResult = { ok: true, skipped: true, reason: 'Non-x402 mode' };
     if (X402_ENABLED) {
-      tipResult = await sendMemosTip(ethPrivateKey, estimatedCostUsdc);
+      tipResult = await sendMagicTip(ethPrivateKey, estimatedCostUsdc);
     }
 
     // Output result
@@ -280,7 +280,7 @@ async function main() {
       bundle_url: `https://arweave.net/${bundleTxId}`,
       manifest_url: `https://arweave.net/${manifestTxId}`,
       payment_mode: X402_ENABLED ? 'x402' : 'turbo_credits',
-      memos_tip: tipResult,
+      magic_tip: tipResult,
     };
 
     if (X402_ENABLED) {