Sofia

Transform your browsing into certified knowledge on the blockchain.

Sofia is a Chrome extension that tracks your browsing, lets you certify URLs with intentions, and stores them as verifiable claims on the Intuition knowledge graph. Earn XP, spend Gold, complete quests, and build your on-chain browsing profile.

Table of Contents

• How It Works
• Architecture Overview
• Extension
  • Pages & Navigation
  • Browsing Tracking
  • Echoes & Groups
  • Certifications
  • Level System
  • Dual Currency: XP & Gold
  • Quest System
  • Discovery & Interest
  • Social Features
  • Authentication & Identity
  • OAuth Integrations
  • Blockchain Integration
• Sofia-Mastra (AI Backend)
• Intuition MCP Server
• Quick Start
• Environment Variables
• Tech Stack

How It Works

┌─────────────────────────────────────────────────────────────────────────────┐
│                              USER FLOW                                      │
└─────────────────────────────────────────────────────────────────────────────┘

    ┌──────────┐         ┌──────────┐         ┌──────────┐         ┌──────────┐
    │  Browse  │────────▶│  Echoes  │────────▶│  Certify │────────▶│  On-Chain│
    │   Web    │         │  (Group) │         │(Intention)│         │ (Store)  │
    └──────────┘         └──────────┘         └──────────┘         └──────────┘
         │                    │                    │                    │
         ▼                    ▼                    ▼                    ▼
    URLs tracked by      URLs grouped by      User certifies       Triple stored:
    content script       domain in Echoes     with intention       I [visits_for] [page]
                                                                        │
    ┌───────────────────────────────────────────────────────────────────┘
    │
    ▼
    ┌──────────┐         ┌──────────┐         ┌──────────┐
    │ Level Up │────────▶│  XP &    │────────▶│ Interest │
    │ (Gold)   │         │  Quests  │         │(Analysis)│
    └──────────┘         └──────────┘         └──────────┘
         │                    │                    │
         ▼                    ▼                    ▼
    Spend Gold to        Complete quests     AI analyzes your
    level up domains     to earn XP and      certifications to
    and generate AI      unlock badges       build your interest
    predicates                               profile

Architecture Overview

┌───────────────────────────────────────────────────────────────────┐
│                        Chrome Extension (Plasmo)                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────────┐ │
│  │ Side     │  │ Content  │  │Background│  │ Wallet Bridge    │ │
│  │ Panel UI │  │ Scripts  │  │ Worker   │  │ (EIP-1193)       │ │
│  │ (React)  │  │(tracking)│  │(services)│  │                  │ │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────────┬─────────┘ │
└───────┼──────────────┼─────────────┼─────────────────┼───────────┘
        │              │             │                 │
        │    Chrome Messages         │                 │
        │              │             │                 │
   ┌────▼──────────────▼─────────────▼──┐    ┌────────▼─────────┐
   │        Chrome Storage              │    │  External Wallet  │
   │  (session + local + IndexedDB)     │    │  (MetaMask, etc.) │
   └────────────────────────────────────┘    └──────────────────┘
                    │
        ┌───────────┴───────────┐
        ▼                       ▼
 ┌──────────────┐     ┌─────────────────┐
 │ Sofia-Mastra │     │   Intuition     │
 │ (AI Agents)  │     │   Blockchain    │
 │ Port 4111    │     │ (MultiVault +   │
 │              │     │  Fee Proxy)     │
 └──────┬───────┘     └─────────────────┘
        │
 ┌──────▼───────┐
 │ Intuition    │
 │ MCP Server   │
 │ Port 3001    │
 └──────────────┘

Project Structure

core/
├── extension/              # Chrome extension (Plasmo + React)
│   ├── sidepanel.tsx       # Root entry point (side panel UI)
│   ├── background/         # Service worker, message handlers, OAuth
│   ├── contents/           # Content scripts (tracking, wallet bridge)
│   ├── components/         # React components (pages, tabs, UI, modals)
│   ├── hooks/              # React hooks
│   ├── lib/                # Services, config, clients, database, utils
│   ├── types/              # TypeScript type definitions
│   ├── ABI/                # Smart contract ABIs
│   └── packages/graphql/   # Local GraphQL package
├── sofia-mastra/           # AI agents backend (Mastra + GaiaNet)
└── intuition-mcp-server/   # MCP server for Intuition knowledge graph

Extension

Pages & Navigation

The extension runs as a Chrome side panel with a bottom navigation dock.

Navigation: RouterProvider context manages page state, history stack, and user profile data passing.

1. Browsing Tracking

URLs are captured by the tracking.ts content script injected on all pages.

Flow:

Web Page Visit
  → Content script waits 3s (MIN_TIME_BEFORE_TRACK)
  → Extracts: URL, title, meta tags, OG data
  → Sends TRACK_URL message to background
  → SessionTracker buffers visits (threshold: 5 URLs or 30 min)
  → Flushes to GroupManager → IndexedDB (INTENTION_GROUPS store)
  → UI updates via useIntentionGroups hook

Tracked data: URL, title, duration (via visibility/unload events), keywords, description, OG type.

SPA support: Polls location.href every 1s to detect client-side navigation.

Excluded: chrome://, chrome-extension://, auth pages, URLs > 200 chars.

2. Echoes & Groups

Visited URLs are automatically grouped by domain into Echoes (intention groups), displayed as a bento grid.

Domain normalization: Strips www., m., open., app., mobile., web. prefixes.

Each group card shows:

• Domain name + favicon + level badge
• Current AI-generated predicate (after first level-up)
• URL count, on-chain certification count, total attention time
• Progress bar toward next level
• Certification breakdown dots (colored by intention type)

Sorting options: Level, URL count, A-Z, Recent.

Dual data source: Groups merge local IndexedDB data with on-chain certifications fetched via GraphQL. "Virtual groups" are created for domains that only exist on-chain.

Group Detail View: Clicking a card opens a detailed view with:

• Full URL list with certification badges
• Filter by intention type (Work/Learning/Fun/Inspiration/Buying)
• Certify individual URLs with intention/trust/distrust pills (adds to cart)
• In-cart pills show colored selected state matching each certification type
• Level-up button (when progress = 100%)
• Identity hero section ("I [predicate] [domain]") with Amplify option

3. Certifications - Declare Intent

Certify any URL with one of 5 intentions, or express trust/distrust:

On-chain structure: Each certification creates a blockchain triple on Intuition:

[I] ── visits_for_work ──▶ [Page URL atom]

Flow: User clicks intention or trust/distrust → Item added to Cart → User reviews cart → Batch submit → WeightModal confirms deposit → All triples created in batch → Batch Rewards shown sequentially (discovery tier + Gold earned + Share on X).

Cart System: All certifications (intentions + trust + distrust) are queued in a persistent cart (IndexedDB-backed) before submission. The cart persists across tab navigation. A floating action button (Sofia icon) shows the cart item count.

Click intention/trust/distrust pill
  → Item added to Cart (IndexedDB)
  → CartFAB shows count badge
  → Open CartDrawer to review items
  → "Submit All" → WeightModal (deposit amount + fees)
  → Batch transaction via SofiaFeeProxy
  → BatchRewardModal: sequential reward claiming
    → Per-page discovery tier (Pioneer/Explorer/Contributor)
    → Gold animation overlay (video)
    → Share on X (OG image via sofia-og.vercel.app)
    → Continue to next reward

WeightModal is the unified transaction confirmation UI across all flows (certify, vote, follow, trust/distrust, quest claim). It displays:

• Intention badge (colored tag with intention type)
• Deposit amount selection (0.01, 0.5, 1, 5, 10 TRUST + custom)
• Beta Season Pool slider (split deposit between signal vault and shared pool)
• Fee breakdown grouped by source: Sofia fees + Intuition protocol fees

4. Level System

Domains level up based on on-chain certified URL count:

Level-up flow:

1. Reach required certification count (progress bar = 100%)
2. Click "Level Up" → Gold is spent
3. AI (PredicateAgent) generates a semantic predicate for the domain based on certification breakdown
4. Group identity updates: "I [new predicate] [domain]"
5. Predicate history is tracked for each level

5. Dual Currency: XP & Gold

Sofia uses two separate currencies:

XP

• Earned exclusively by claiming quest badges (on-chain triples)
• totalXP = sum of all claimed quest XP rewards
• Level formula: Level N requires 100 × N XP (Level 2 = 100, Level 3 = 300, Level 4 = 600...)
• Managed by XPService + useQuestSystem hook

Gold

• 3 components: totalGold = discoveryGold + voteGold - spentGold
• Discovery Gold: Earned from being early to certify pages (Pioneer +50, Explorer +20, Contributor +10)
• Vote Gold: +5 per vote, capped at 10 Gold/day
• Spent Gold: Deducted when leveling up domains
• Managed by GoldService + useGoldSystem hook
• Real-time updates via chrome.storage.onChanged listener

6. Quest System

Complete actions to earn XP and unlock achievement badges:

Quest states: locked → active → claimable_xp → completed

Claiming: Creates an on-chain triple [wallet] [has_tag] [quest_title], making the badge permanent and public.

7. Discovery & Interest

Discovery Stats

Track your certification discovery status per page:

Interest - Interest Analysis

AI analyzes your on-chain certifications to build your interest profile:

1. SkillsAnalysisAgent groups your domains into interest categories
2. Maps domains to interests (GitHub → Software Development, Figma → UI/UX Design, etc.)
3. Each interest gets a confidence score and level based on certification volume
4. Interests are stored as triplets in the knowledge graph

8. Social Features

Follow

• Creates on-chain triple: I → TRUSTS → [user_account]
• Optional TRUST stake amount
• Displayed in Following/Followers panels

Trust

• Deposit TRUST tokens on user atoms
• Creates or stakes on existing trust triples
• Trust circle visible in profile Community tab

Lists / Curator

• Create bookmark lists of triplets
• Curated on-chain lists queryable via has_tag predicate
• Displayed with market cap and position count

Beta Season Pool

A shared staking vault where a percentage of each deposit is automatically allocated:

• Default split: 20% of deposit goes to the Beta Season Pool, 80% to signal vault
• Adjustable: Users can set 0–50% via a slider in WeightModal
• Stats card on the Profile Stats tab shows: My Stake, P&L (profit/loss), total stakers
• On-chain vault: Linear bonding curve (curveId=1), tracked via GlobalStakeService
• Minimum deposit: 0.01 TRUST — below this, pool contribution is skipped

9. Authentication & Identity

Wallet Connection (Privy)

• External auth page at https://doc.sofia.intuition.box/auth (HTTPS required for Privy)
• Wallet address stored in chrome.storage.session (clears on browser restart)
• Supports MetaMask, Rabby, Coinbase, and other EIP-1193 wallets
• Wallet bridge via content scripts relays requests between extension and web page

Identity Resolution

4-tier fallback system (useIdentityResolution hook):

1. GraphQL — Intuition account data (label, image)
2. ENS Reverse Lookup — Wallet → .eth name
3. ENS Avatar — Avatar from ENS profile
4. Discord Fallback — Discord display name + avatar

Cached locally with 1-hour TTL. Invalidated when Discord profile changes.

10. OAuth Integrations

Connect 5 social platforms for social proof and triplet extraction:

Verification requirements:

• Discord: Email must be verified
• Twitter: Must be verified (blue checkmark)
• Others: No verification needed

Social Verification (Golden Border):
When all 5 platforms are connected, a bot verifier creates an on-chain proof triple:
[wallet] [socials_platform] [verified] — granting the user a golden border on their avatar.

Triplet extraction: OAuth data is converted to semantic triplets (e.g., [I] [follow] [YouTube Channel Name]) and stored in IndexedDB intention groups.

11. Blockchain Integration

Intuition Protocol

• Atoms: IPFS-backed data entities (URLs, intentions, users)
• Triples: Relationships (subject, predicate, object) where each is a vault ID
• Vaults: Market pools with bonding curves for deposits/shares

Sofia Fee Proxy Contract

All transactions go through the Sofia Fee Proxy, which collects fees before forwarding to MultiVault:

User Transaction
       │
       ▼
┌──────────────────────────────────────────┐
│       Sofia Fee Proxy Contract           │
│  0x26F81d723Ad1648194FAA4b7E235105Fd1212c6c  │
│  Fixed Fee:      depositFixedFee         │
│  Percentage Fee: depositPercentageFee    │
└──────────────────────────────────────────┘
       │
       ▼
┌──────────────────────────────────────┐
│       Intuition MultiVault           │
│  0x6E35cF57A41fA15eA0EaE9C33e751b01A784Fe7e  │
│  • createAtoms (URLs, intentions)    │
│  • createTriples (certifications)    │
│  • deposit / redeem                  │
└──────────────────────────────────────┘

Fee Proxy Contract: Sofia-Fee-Proxy-Contract

Fee Transparency

Before confirming, WeightModal shows a real-time cost breakdown:

• Deposit — user-selected amount, split into Signal + Beta Season Pool
• Fees — total, with sub-items: Sofia fee (fixed + 5%) and Intuition fee (creation only, zero for existing triples)
• Total — deposit + all fees
• Fee params are read from on-chain contracts via BlockchainService and cached in memory

Transaction Flow

1. Simulation: publicClient.simulateContract() — dry run before paying gas
2. Submission: walletClient.writeContract() — actual transaction via wallet (2-3 wallet confirmations per certification)
3. Confirmation: publicClient.waitForTransactionReceipt() — wait for block inclusion
4. Error recovery: Graceful fallback for existing atoms/triples (deposit instead of create)

Networks

GraphQL Client

• Rate limiting: 150ms between requests
• Exponential backoff on 429 (1s, 2s, 4s)
• 30-second TTL cache with auto-cleanup
• Pagination support (100 items/page, max 100 pages)

Sofia-Mastra (AI Backend)

AI agent orchestration backend built with Mastra and GaiaNet LLM (Qwen2.5-14B).

Agents

Workflows

Extension ↔ Mastra Communication

Extension Background (mastraClient.ts)
  │
  ├─ POST /api/agents/{name}/generate    → Agent responses
  └─ POST /api/workflows/{name}/start-async → Workflow results

Intuition MCP Server

Model Context Protocol server providing tools to query the Intuition knowledge graph.

MCP Tools

Server Setup

• Transports: HTTP (Express, port 3001), SSE, Stdio
• GraphQL backend: Intuition's Hasura endpoint
• Session management: 5-min timeout, 30-min max age
• Health check: GET /health

Quick Start

Prerequisites

• Node.js >= 22.13.0
• Bun (runtime + package manager)
• Chrome browser

Installation & Development

Terminal 1 - MCP Server:

cd intuition-mcp-server
bun install
bun run start:http
# → http://localhost:3001

Terminal 2 - Mastra Backend:

cd sofia-mastra
bun install
bun run dev
# → http://localhost:4111

Terminal 3 - Extension:

cd extension
bun install
bun run build  # Production (.env.production) → mainnet

Load the extension from build/chrome-mv3-prod/ in Chrome.

Environment Variables

Extension (.env.development)

PLASMO_PUBLIC_MASTRA_URL=http://localhost:4111
PLASMO_PUBLIC_NETWORK=testnet
PLASMO_PUBLIC_PRIVY_APP_ID=your-privy-app-id
PLASMO_PUBLIC_PRIVY_CLIENT_ID=your-privy-client-id

Sofia-Mastra (.env)

# GaiaNet LLM
GAIANET_NODE_URL=https://your-node.gaia.domains/
GAIANET_MODEL=Qwen2.5-14B-Instruct-Q5_K_M
GAIANET_EMBEDDING_MODEL=Nomic-embed-text-v1.5
GAIANET_EMBEDDING_URL=https://your-node.gaia.domains/v1/embeddings

# Database
DATABASE_URL=file:./data/mastra.db

# MCP Server
MCP_SERVER_URL=http://127.0.0.1:3001/sse

Tech Stack

Extension Internals

Storage Layers

Resources

• Mastra Documentation
• Model Context Protocol
• Intuition Protocol
• GaiaNet
• Plasmo Framework

License

MIT

Sofia v0.5.1 BETA - Built with Mastra, GaiaNet & Intuition