Token42

Decentralized AI Dating Platform on Polkadot

Verifiable Identity · Private AI Matching · Staked Connections

📖 Overview

Token42 is a next-generation dating platform that solves the "Trust Gap" in online dating. By combining Polkadot's verifiable identity infrastructure with AI-powered matching inside secure enclaves, Token42 ensures that every user is a real human, every match is privately computed, and every interaction is economically accountable.

The name represents the search for the ultimate connection in a verifiable, tokenized world.

🚀 Key Features

Feature	Description
🪪 Verifiable Identity	Connect with real humans verified via Polkadot's People Chain identity infrastructure.
🤖 Private AI Matching	Private personality analysis inside Phala Network's secure enclaves (TEE).
💰 Staked Messaging	Anti-spam protocol using rUSD staking to ensure high-value connections.
🏷️ Soulbound Profiles	Non-transferable digital identities on the Revive EVM (PolkaVM).
🛡️ AI Moderation Oracle	Automated harassment detection with on-chain slashing penalties

🏗️ Architecture

Token42 is built on a four-layer decentralized stack:

┌─────────────────────────────────────────────────────────────┐
│                       FRONTEND (React/Vite)                 │
│         Wallet Connection · Profile UI · Chat Interface     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌───────────────────┐    ┌─────────────────────────────┐   │
│  │    IDENTITY       │    │      INTELLIGENCE           │   │
│  │  People Chain     │    │  Phala Network TEE          │   │
│  │  (DID / Precomp.) │    │  Llama-3-8B Vectorization   │   │
│  │  0x...901         │    │  Cosine Similarity Matching │   │
│  └────────┬──────────┘    │  Match Intent Signing       │   │
│           │               └─────────────┬───────────────┘   │
│           ▼                             ▼                   │
│  ┌──────────────────────────────────────────────────────┐   │
│  │               LOGIC LAYER (Revive EVM)               │   │
│  │  Token42Profile.sol      Token42Messaging.sol        │   │
│  │  • Soulbound Tokens      • rUSD Staking              │   │
│  │  • Identity Checks       • Signature Verification    │   │
│  │  • CID Storage           • Slashing Oracle           │   │
│  └──────────────────────────────────────────────────────┘   │
│                             ▼                               │
│  ┌──────────────────────────────────────────────────────┐   │
│  │            STORAGE LAYER (IPFS / Pinata)             │   │
│  │  Encrypted bios · Profile media · Metadata CIDs      │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

🔄 XMTP V3 Messaging Flow (MLS)

Token42 uses XMTP V3 (MLS) for real-time, end-to-end encrypted messaging. Unlike legacy V2, V3 uses a "Group" architecture for all DMs, relying on a Welcome protocol and a local encrypted database (OPFS).

sequenceDiagram
    participant A as User A (Sender)
    participant N as XMTP Network (Nodes)
    participant B as User B (Receiver)
    participant DB as Local DB (OPFS)

    Note over A: 1. createDm(B_Addr)
    A->>N: Fetch B's Inbox ID
    A->>N: Publish MLS Welcome + Keys
    A->>N: Send Encrypted Message Packet
    
    Note over B: 2. Background sync()
    B->>N: Query for new Welcomes
    N-->>B: Return Welcome Packet
    Note over B: 3. Decrypt Welcome
    B->>DB: Store Group Keys

    Note over B: 4. Message stream()
    B->>N: Fetch Encrypted Packets
    N-->>B: Return Packets
    Note over B: 5. Decrypt Message (using keys from DB)
    B->>B: Resolve Sender Wallet Address
    Note over B: 6. Update UI

🧰 Technology Stack

Layer	Technology	Purpose
Smart Contracts	Solidity 0.8.28, Minimal impls (no OZ), Hardhat	Profile SBTs, staked messaging, slashing
Runtime	Polkadot Asset Hub (Revive EVM / PolkaVM)	EVM-compatible execution on Polkadot
Identity	Paseo People Chain, Identity Precompile (`0x...901`)	On-chain human verification (DID)
AI Engine	Phala Network TEE, Llama-3-8B	Private personality vectorization & matching
Storage	IPFS (Pinata)	Decentralized media & metadata hosting
Frontend	React 18, TypeScript, Vite, ethers.js	Mobile-responsive dApp interface
Wallets	SubWallet, Talisman, MetaMask	Transaction signing & identity proofs
Testing	Hardhat (npx hardhat test)	Contract unit & integration tests
Dev Env	DevContainers, Kitdot CLI	Zero-config development environment

📂 Project Structure

token42/
├── .devcontainer/               # DevContainer setup (Docker + VS Code)
│   ├── devcontainer.json
│   ├── Dockerfile
│   └── scripts/                 # Setup & initialization scripts
├── contracts/                   # Hardhat-compatible (Solidity ^0.8.28, no OZ)
│   ├── contracts/               # Source files
│   │   ├── Token42Profile.sol   # Minimal soulbound profile
│   │   ├── Token42Messaging.sol # Minimal staked messaging
│   │   ├── MockRUSD.sol         # Test mock ERC-20
│   │   └── MockIdentityPrecompile.sol
├── ignition/modules/            # Hardhat Ignition deployment
│   └── Token42Module.js
├── test/                        # Hardhat tests
│   ├── Token42Profile.test.js
│   └── Token42Messaging.test.js
├── agent/                       # Phala TEE AI Agent
│   └── src/index.ts             # Express server & AI logic
├── frontend/                    # React dApp (Vite)
├── guides/                      # Comprehensive Documentation
│   ├── AGENTS.md                # AI agent instructions
│   ├── AI_INTEGRATION_GUIDE.md  # Technical bridge between AI and contracts
│   ├── KITDOT_HACKATHON_GUIDE.md # Development guide
│   ├── LOCAL_INFERENCE.md       # Running Llama 3 locally via Ollama
│   ├── LOCAL_TESTING_GUIDE.md   # 2-User interaction walkthrough
│   └── UI_INTEGRATION_GUIDE.md  # Identity & Messaging UI requirements
├── hardhat.config.js            # Hardhat + PolkaVM config
├── .gitignore
└── README.md

🛠️ Onboarding & Installation

Prerequisites: Node.js 22+ and npm, Ollama (for local AI matching), or Docker for DevContainers.

Option A: DevContainer (RECOMMENDED)

Install Docker Desktop and the VS Code Dev Containers extension
Open this project in VS Code
Click "Reopen in Container" — all tools install automatically

Option B: Manual Setup

git clone https://github.com/GReturn/Project-Token42.git
cd Project-Token42

1. Smart Contracts

npm install
npx hardhat compile
npx hardhat test

2. AI Agent (Local Matching)

Ensure Ollama is running and you have pulled the model: ollama pull llama3.

cd agent
npm install
# Configure .env with your AGENT_PRIVATE_KEY
npx tsx src/index.ts

3. Frontend

cd frontend
npm install
npm run dev

🚀 Deployment Status (Paseo Asset Hub)

The contracts are live on the Paseo Asset Hub (Revive EVM):

Token42Profile: 0x9B9f7569A535Cd2B66EC9B2F5509F5e688Ba92B5
Token42Messaging: 0x8B8d13a7f678FA8f6793290Ee9e46302Be427453
Token42Escrow: 0xb6B64176CC8a8350AB84D466CD4bf111C3A6E7a5
MockRUSD: 0xFE4eae5d84412B70b1f04b3F78351a654D28Da25 (with faucet() function)

📖 Related Documentation

For deeper technical dives, see the following guides:

🧠 AI Integration Guide: How the AI Agent signs match intents for the blockchain.
💻 Local Inference Setup: Setting up Ollama and Llama 3 for private local matching.
👥 Local Testing Guide: Stepper-by-step walkthrough of a 2-user interaction.
🎨 UI Integration Guide: Handling identity verification and messaging errors in React.
🛠️ Hackathon Guide: Core development workflow and architecture.

⚠️ Hackathon Prototype Caveats

Important

This version of Token42 is a Hackathon Prototype. To facilitate the demonstration, the following elements are currently simplified or mocked:

Mock Data: The frontend initially populates some state with mock profile data to show the UI without waiting for IPFS/Contract indexing.
Identity Simulation: The People Chain identity check is simulated in the UI; in production, this calls the 0x...901 precompile via a staticcall.
Storage: Integration with Pinata (IPFS) is functional, but currently uses a public gateway for demonstration.
Slashing: The moderation /slash endpoint is exposed for developers but not yet triggered by an automated on-chain oracle.

🔄 User Flow

Connect Wallet  ──►  Verify Identity  ──►  Mint SBT Profile  ──►  AI Matching  ──►  Stake & Chat
     │                    │                      │                     │                  │
  SubWallet /         People Chain           Token42Profile       Phala TEE Agent    Token42Messaging
  Talisman            Precompile 0x901       (Soulbound)         Cosine Similarity   rUSD Lock/Claim

🌍 SDG Alignment

SDG	Impact
SDG 5 — Gender Equality	AI moderation + staking reduces harassment; economic penalties deter bad actors
SDG 16 — Peace, Justice & Strong Institutions	Sovereign decentralized identity; no central authority owns your data

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Token42

📖 Overview

🚀 Key Features

🏗️ Architecture

🔄 XMTP V3 Messaging Flow (MLS)

🧰 Technology Stack

📂 Project Structure

🛠️ Onboarding & Installation

Option A: DevContainer (RECOMMENDED)

Option B: Manual Setup

1. Smart Contracts

2. AI Agent (Local Matching)

3. Frontend

🚀 Deployment Status (Paseo Asset Hub)

📖 Related Documentation

⚠️ Hackathon Prototype Caveats

🔄 User Flow

🌍 SDG Alignment

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 156 Commits
.devcontainer		.devcontainer
agent		agent
contracts/contracts		contracts/contracts
frontend		frontend
guides		guides
ignition/modules		ignition/modules
scripts		scripts
test		test
.gitignore		.gitignore
NOTES.md		NOTES.md
README.md		README.md
audit_report.md		audit_report.md
check_selector.js		check_selector.js
deployed-addresses.json		deployed-addresses.json
hardhat.config.js		hardhat.config.js
package-lock.json		package-lock.json
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

Token42

📖 Overview

🚀 Key Features

🏗️ Architecture

🔄 XMTP V3 Messaging Flow (MLS)

🧰 Technology Stack

📂 Project Structure

🛠️ Onboarding & Installation

Option A: DevContainer (RECOMMENDED)

Option B: Manual Setup

1. Smart Contracts

2. AI Agent (Local Matching)

3. Frontend

🚀 Deployment Status (Paseo Asset Hub)

📖 Related Documentation

⚠️ Hackathon Prototype Caveats

🔄 User Flow

🌍 SDG Alignment

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages