You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
AI-powered P2P freelance marketplace on TON blockchain — non-custodial escrow, job parser from Telegram groups, GitHub verification, admin panel, and AI at every stage.
What is it
izEscrowAI is a decentralized P2P freelance exchange built as a Telegram bot + Mini App + Web platform. Create deals in chat, post offers via inline mode, auto-parse job postings from Telegram groups, verify skills through GitHub OAuth, and lock funds in a smart contract on TON. AI handles deal parsing, job classification, skill matching, proposal generation, risk scoring, and dispute mediation. Funds are held by the contract, not the bot — fully non-custodial.
How it works
Direct Deal (1-on-1)
flowchart TD
A["User writes to bot"] --> B["AI parses the deal"]
B --> C["Invite link sent to counterparty"]
C --> D{"Both confirm?"}
D -- Yes --> E["Smart contract deployed"]
D -- No --> X1["Cancelled"]
E --> F["Buyer deposits via TON Connect"]
F --> G["Seller delivers work"]
G --> H{"Buyer confirms?"}
H -- "Confirm" --> I["Funds to seller"]
H -- "Dispute" --> J["AI mediates fair split"]
H -- "7-day timeout" --> I
J --> K{"Both accept?"}
K -- Yes --> L["Split on-chain"]
K -- No --> M["Arbiter resolves"]
Loading
Marketplace (Inline Offers + Auction)
flowchart TD
A["Creator types @izEscrowAIBot in any chat"] --> B["AI parses the offer"]
B --> C["Offer posted inline with Apply button"]
C --> D["Freelancers bid via deep link"]
D --> E["Creator reviews bids + AI Risk Scores"]
E --> F["Creator selects a freelancer"]
F --> G["Deal created automatically"]
G --> H["Buyer deposits via Escrow"]
Loading
Job Parser (Auto-detect from Groups)
flowchart TD
A["Job posted in Telegram group"] --> B["Regex pre-filter RU/EN keywords"]
B --> C["AI classifies: job / not_job / spam"]
C -- job --> D["AI extracts: title, budget, skills, deadline"]
D --> E["Saved to DB, dedup by source+message"]
E --> F["Match executors by GitHub skills"]
F --> G["DM notifications to matched freelancers"]
G --> H["Freelancer responds with AI proposal"]
H --> I["Poster sees responses, creates escrow deal"]
Loading
Key Features
Core
Non-custodial escrow — funds held by smart contract, not the bot
Natural language parsing — create deals by chatting, not filling forms
AI dispute mediation — disputes analyzed with fair split proposals
Multi-currency deals — specify amounts in $, €, ₽ with auto-conversion to TON
1% on-chain platform fee — transparent fee deducted by the smart contract
TON Connect integration — pay directly from your wallet in Telegram
Marketplace
Public offers — post via inline mode in any Telegram chat or group
Auction / Bidding — freelancers compete with price bids, creator picks the best
Full-text search — PostgreSQL tsvector search across offers
Job Parser & Matching
Auto-detect jobs from groups — regex + AI pipeline parses job postings from monitored Telegram groups
Skill-based matching — match parsed jobs to freelancers by GitHub language overlap
AI proposal generation — generate personalized proposals based on GitHub profile + job requirements
Poster identification — link parsed jobs to their posters, notify when freelancers respond
Response flow — freelancers respond to jobs, posters review and create escrow deals directly
GitHub Verification
GitHub OAuth — verify developer identity through GitHub account linking
GitHub Score — automated scoring based on repos, stars, commits, languages, organizations
Trust Score boost — GitHub-verified users get higher trust, with green/red flag analysis
Skill extraction — auto-detect developer skills from GitHub language stats
AI Risk Assessment — analyzes user metrics and deal parameters, returns risk level + recommendations
Ban enforcement — banned users blocked at bot and API level
Web Platform
Landing page — public marketplace with live stats, talent grid, activity feed
Web auth — Telegram Login Widget for browser access
Responsive design — works in Telegram Mini App and standalone browser
Business Model
A transparent 1% fee is deducted on-chain by the smart contract when a deal completes (confirm, resolve, or timeout). The fee goes directly to the platform wallet — no off-chain billing, no hidden charges. On cancel, the buyer gets a full refund with zero fees.
Architecture
flowchart TD
Users["Telegram Users"] --> Bot
Users --> MiniApp
Users --> Web
subgraph Bot["izEscrowAI Bot (Railway)"]
AI["AI Engine — OpenRouter/Claude"]
DM["Deal Manager + Offer Auction"]
RM["Risk Manager — Trust Score"]
Parser["Job Parser — regex + AI classify + extract"]
Matcher["Skill Matcher — GitHub profile overlap"]
GH["GitHub OAuth — profile verification"]
BC["Blockchain — TON Client"]
API["REST API — Express (44 endpoints)"]
DB["Database — PostgreSQL + Drizzle ORM (13 tables)"]
end
MiniApp["Mini App — React + TON Connect (Vercel)"]
Web["Web Platform — React + Telegram Login (Vercel)"]
MiniApp --> API
Web --> API
BC --> TON["TON Blockchain — Escrow Contract"]
Parser --> DB
Matcher --> AI
GH --> GitHub["GitHub API"]
cd bot
cp .env.example .env # Fill in your keys
npm install
npx drizzle-kit push # Create tables
psql -d izescrow -f src/db/setup-search.sql # Full-text search
npm run dev
Mini App
cd mini-app
npm install
npm run dev
Smart Contract
Compile contracts/escrow.tolk using izTolkMcp or the Tolk compiler:
Viral Growth — every inline offer and parsed job invites new users into the ecosystem
Forking Guide
izEscrowAI uses a two-tier config pattern to separate public defaults from private customizations:
prompts.default.ts — committed, contains public default AI prompts and tool definitions
prompts.ts — gitignored, your private overrides (create by copying the default)
weights.default.ts — committed, contains public Trust Score formula weights
weights.ts — gitignored, your private weights
To customize: copy *.default.ts to *.ts in the same directory and edit. The loader picks up private files automatically.
License
AGPL-3.0 — If you run a modified version of this software as a service, you must release your source code under the same license. This protects the platform's AI prompts and scoring algorithms while keeping the code open source.
About
AI-powered escrow agent for safe P2P deals in Telegram, backed by TON blockchain smart contracts
