SynthLaunch

Agent-native token launch and monetization protocol on X Layer and BSC

SynthLaunch is an agent-native token launch and monetization protocol that gives AI agents a full onchain stack: a soulbound identity, a dedicated treasury, a fee-routing custody, an evolvable NFT body, and a chat terminal backed by OKX Onchain OS.

Built for the OKX Build X Hackathon — X Layer Arena, SynthLaunch focuses on a single thesis:

AI agents should not just talk. They should own assets, earn revenue, and participate in onchain economies.

🔗 Live Links


🌐 Website	https://synthlaunch.fun
🛠 Source	https://github.com/V-SK/synthlaunch
🐦 X / Twitter	@synth_fun
🏁 Hackathon	OKX Build X Hackathon — X Layer Arena
🧭 Primary chain	X Layer (196)
🧭 Secondary chain	BSC (56)

🎯 What SynthLaunch Does

SynthLaunch turns an AI agent into a first-class onchain economic actor by stacking four primitives:

SynthID — soulbound ERC-721 identity for an agent (name, platform, avatar, description). ERC-8004 compatible agent URI.
SynthLaunchCustody — per-agent treasury that collects a share of every token trade and lets only the agent's bound wallet claim it.
NFAv2 (Non-Fungible Agent) — BAP-578 style NFT body with balance, XP, and a whitelisted logic address so the agent can execute onchain actions safely.
AI Terminal (/ai) — an on-site chat interface for the agent backed by OKX Onchain OS skills: search tokens, read balances, quote swaps, execute swaps, all from the same wallet that owns the agent.

Put together, an agent becomes an Agentic Wallet: an identity with a treasury, a body, and the ability to act onchain through Onchain OS.

🤖 Agentic Wallet — how it works

The hackathon requires an "Agentic Wallet as the project's main onchain identity". In SynthLaunch this is not a single contract — it's a composition designed so that identity, treasury, body, and execution are separated but linked:

                ┌──────────────────────────────────────────┐
                │            USER WALLET                   │
                │  (connected via wagmi + MetaMask / OKX)  │
                └───────────────┬──────────────────────────┘
                                │
          ┌─────────────────────┼──────────────────────────┐
          │                     │                          │
          ▼                     ▼                          ▼
  ┌───────────────┐    ┌────────────────┐      ┌───────────────────┐
  │   SynthID     │    │     NFAv2      │      │  SynthLaunchCustody│
  │ (soulbound)   │◄───┤ (NFT body +    │◄─────┤ (per-agent treasury│
  │ ERC-8004 URI  │    │  XP / logic)   │      │  signature-bound)  │
  └──────┬────────┘    └───────┬────────┘      └─────────┬──────────┘
         │                     │                         │
         │  agent identity     │  agent actions          │  agent revenue
         │                     │                         │
         ▼                     ▼                         ▼
  ┌──────────────────────────────────────────────────────────────┐
  │                    AI TERMINAL  ( /ai )                       │
  │   Backed by OKX Onchain OS skills:                            │
  │     - token search  - balances  - total value                 │
  │     - quote         - swap aggregator                         │
  └──────────────────────────────────────────────────────────────┘

Binding: An agent's owner calls SynthLaunchCustody.bindWallet(agentName, wallet, nonce, signature). The signature is verified against a protocol signer, which pins the wallet to the agent name. Only that wallet can claim(token) the fees collected for that agent. This wallet is the Agentic Wallet.

Multi-agent relationship: One user can own many agents. Each agent has:

exactly one SynthID (soulbound, cannot be moved)
optionally a NFAv2 body (with a whitelisted logic contract, see AgentLogic / AgentLogicPro)
exactly one bound wallet in SynthLaunchCustody (resettable by owner via signature)

Agents are first-class and independent. A user's dashboard simply aggregates agents they own.

🧭 Why X Layer

We chose X Layer as our primary hackathon submission chain because SynthLaunch is fundamentally about high-frequency onchain interaction for AI-native products:

AI agents generate lots of small transactions — token launches, tax claims, treasury moves, swap actions. X Layer's low-cost EVM environment makes these economic instead of toy.
OKX Onchain OS lives natively on X Layer — the same tab that holds the agent's chat terminal can introspect balances, search tokens, and execute swaps through Onchain OS DEX aggregator without leaving the app.
Composable with the OKX wallet + OKB ecosystem — users already in the OKX environment can launch an agent, bind a wallet, and start earning in a few clicks.

The repository supports BSC as a secondary chain for continuity with SynthLaunch's existing user base, but the primary hackathon submission path is X Layer.

🧠 OKX Onchain OS Integration

SynthLaunch uses five Onchain OS core skills, wired end-to-end from a user-facing /ai chat terminal to signed onchain execution.

Skill	OKX DEX endpoint	Where it lives in code	User-facing surface
Token Search	`/api/v6/dex/market/token/search`	`src/lib/okx.ts` `okxTokenSearch()`	`/ai` — "price of X", "search Y"
Balances	`/api/v6/dex/balance/all-token-balances-by-address`	`okxBalances()`	`/ai` — "what's in my wallet?"
Total Value	`/api/v6/dex/balance/total-value-by-address`	`okxTotalValue()`	`/ai` — portfolio summary
Quote	`/api/v6/dex/aggregator/quote`	`okxQuote()`	`/ai` — "how much Y for 1 X?"
Swap Aggregator	`/api/v6/dex/aggregator/swap`	`okxSwap()`	`/ai` — "swap 1 OKB for USDC" → user signs → broadcast

The full flow — intent detection, skill invocation, and on-screen rendering — lives in:

src/app/api/ai/chat/route.ts — LLM intent → OKX skill → tool result
src/components/ai/AiTerminalPage.tsx — chat UI
src/components/ai/AiToolCard.tsx — renders each OKX tool result
src/app/api/okx/* — thin REST wrappers for each skill

Swap execution is non-custodial: the aggregator returns an unsigned tx, the user's wallet signs it, and the frontend broadcasts via viem. SynthLaunch never touches the private key.

📦 Smart Contracts

X Layer (primary — 196)

All contracts below were deployed and verified on OKLink as part of this hackathon submission.

Contract	Address	Purpose
SynthLaunchCustody	`0xb381e840AAB505132506781eAFD3c38398B58462`	Agent treasury + fee routing + signature-bound claim
SynthID	`0xE7369f4bA311f59C7476e4A0279d42F767cddd20`	Soulbound ERC-721 agent identity (ERC-8004 URI)
NFAv2	`0x68FF6877A17e12Ccbb19beaADb8785CE4E4b949E`	Non-Fungible Agent body with logic allowlist
Flap Portal	`0xb30D8c4216E1f21F27444D2FfAee3ad577808678`	Token launch entrypoint (ecosystem)

Deployment receipts and constructor args are committed in deployments/xlayer.json.

BSC (secondary — 56)

Contract	Address	Purpose
SynthLaunchCustody v11	`0x3Fa33A0fb85f11A901e3616E10876d10018f43B7`	Fee custody with 48h Timelock
SynthTimelock	`0x13024d9173b9E7D58C9e0cF5Fcc9438F990ab47D`	Timelock controller
SynthID	`0x68a515a18a3f6644f29f352d21fc32d9c6ce05fb`	Soulbound agent identity
NFAv2	`0x2b703D4dC84ACB24a0A3F34CBF259D5Cb2B62b19`	Non-Fungible Agent body

🧱 Architecture

┌─────────────────────────────────────────────────────────────┐
│                    User / AI Agent                          │
└────────────────────────┬────────────────────────────────────┘
                         │
          ┌──────────────▼──────────────┐
          │     Next.js 14 Frontend      │
          │  (chain selector: 56 / 196)  │
          └──────────────┬──────────────┘
                         │
     ┌───────────────────┼──────────────────┐
     │                   │                  │
     ▼                   ▼                  ▼
┌──────────┐   ┌────────────────┐   ┌────────────────┐
│  API     │   │ Onchain OS     │   │  wagmi + viem  │
│  Routes  │   │ Skills         │   │  direct calls  │
│ (Next.js)│   │ (src/lib/okx)  │   │                │
└────┬─────┘   └───────┬────────┘   └───────┬────────┘
     │                 │                    │
     │                 ▼                    │
     │         ┌────────────────┐           │
     │         │   OKX DEX API  │           │
     │         │  (Onchain OS)  │           │
     │         └────────────────┘           │
     │                                      │
     ▼                                      ▼
┌─────────────┐                 ┌──────────────────────┐
│  Supabase   │                 │  X Layer / BSC RPC   │
│  (index +   │                 │  Custody / SynthID / │
│   sessions) │                 │  NFAv2 / Flap        │
└─────────────┘                 └──────────────────────┘

Tech stack:

Frontend: Next.js 14, React 18, TypeScript, Tailwind CSS
Web3: wagmi v2, viem
Contracts: Solidity 0.8.20, Hardhat, OpenZeppelin v5
Data: Supabase (Postgres)
Infra: Vercel (frontend), BSC + X Layer (contracts)

🛣️ Core User Flow

User lands on synthlaunch.fun and connects wallet (OKX Wallet / MetaMask).
User switches chain to X Layer in the UI chain selector.
User mints a SynthID for their agent (soulbound identity).
User launches a token via the Flap Portal, routing trade tax to SynthLaunchCustody.
User binds a claim wallet to the agent via bindWallet(signature).
User mints an NFAv2 body for the agent and attaches a whitelisted logic.
User opens the AI Terminal at /ai and interacts with their agent. The terminal uses OKX Onchain OS skills to check balances, search tokens, quote and execute swaps.
Trade fees accumulate in Custody. The bound wallet calls claim(token) to withdraw the agent's share.

🚀 Quick Start

git clone https://github.com/V-SK/synthlaunch.git
cd synthlaunch
npm install
cp .env.example .env.local
# fill in the values (see .env.example for the list)
npm run dev

Open http://localhost:3000 and switch the chain selector to X Layer.

Contract development

# Compile
npx hardhat compile

# Deploy to X Layer (Custody + SynthID + NFAv2)
TS_NODE_PROJECT=tsconfig.hardhat.json \
  npx hardhat run scripts/deploy-xlayer.ts --network xlayer

# Result is written to deployments/xlayer.json

Environment required for X Layer deploy:

EVA_PRIVATE_KEY — deployer private key (funded with OKB)
Optional: SIGNER_ADDRESS, OPERATOR_ADDRESS, PLATFORM_FEE_RATE, NFA_TREASURY

👩‍⚖️ Judge Quick Evaluation

If you are reviewing this project for the hackathon, here is the fastest path to verify everything:

Open the live app → https://synthlaunch.fun and switch the chain selector to X Layer.
Open the AI Terminal → https://synthlaunch.fun/ai — this is the Onchain OS surface.
Type a few prompts in the terminal:
- balance → exercises okxBalances() + okxTotalValue()
- price of USDC → exercises okxTokenSearch()
- swap 0.01 OKB to USDC → exercises okxQuote() + okxSwap(), returns an unsigned tx for your wallet to sign
Verify contracts on OKLink:
- Custody
- SynthID
- NFAv2
Read the Onchain OS glue code in src/lib/okx.ts and src/app/api/ai/chat/route.ts.
Read the multi-chain config in src/lib/contracts.ts (see CHAIN_CONFIG[196]).
Read the deployment receipts in deployments/xlayer.json.

Total time: around 5 minutes.

🧩 Repository Layout

contracts/           Solidity (Custody, SynthID, NFAv2, Flap helpers, …)
deployments/         Deployment receipts per chain (xlayer.json)
docs/
  hackathon/         Internal planning docs (TASK-*, audit, timelock plan)
  audits/            Audit package and checklist
scripts/
  deploy-xlayer.ts   One-shot X Layer deployment
  debug/             Ad-hoc chain query scripts
  ops/               Ops scripts (twitter bot runner, etc.)
src/
  app/               Next.js App Router pages + API routes
    ai/              AI terminal page
    api/
      ai/chat        Intent detection + OKX skill dispatch
      okx/           REST wrappers for OKX Onchain OS skills
      launch/        Chain-aware token launch endpoint
  components/
    ai/              AI terminal UI (split into ChatPane/Sidebar/StatusBar/ToolCard)
  lib/
    okx.ts           OKX Onchain OS client (signed HMAC)
    contracts.ts     Multi-chain contract config (BSC + X Layer)
    wagmi.ts         wagmi chain registration
supabase/migrations/ Postgres schema
test/                Contract tests (hardhat)

🔐 Security Notes

All fund-handling contracts use OpenZeppelin ReentrancyGuard.
renounceOwnership is disabled on SynthLaunchCustody.
The X Layer Custody is signer-bound: a wallet can only claim after presenting a valid EIP-191 signature from the protocol signer.
The BSC Custody is additionally protected by a 48-hour Timelock on all owner operations.
NFAv2 uses a logicAddress allowlist — arbitrary contracts cannot be attached as agent logic.
OKX API secrets are server-side only (src/lib/okx.ts), never sent to the browser.
No private keys are committed; all deploy scripts read from .env.local.

👤 Team

Soren Lin — sole builder

GitHub: @V-SK
X: @synth_fun

🛠️ What We Built During The Hackathon

This is the delta we added to turn SynthLaunch into a stronger X Layer submission:

Deployed the full SynthLaunch stack to X Layer (Custody, SynthID, NFAv2), all verified on OKLink. See deployments/xlayer.json.
Rebuilt the AI terminal around OKX Onchain OS skills: split AiTerminalPage into focused components (AiChatPane, AiSidebar, AiStatusBar, AiToolCard), wired intent detection in /api/ai/chat to the five OKX skills.
Multi-chain config: extended CHAIN_CONFIG to carry chain-specific Flap / Custody / token implementations for both BSC (56) and X Layer (196).
Repository hardening: moved internal docs into docs/hackathon/, audit materials into docs/audits/, one-shot debug scripts into scripts/debug/, and removed committed build artifacts.
Rewrote this README around the four judging criteria (Onchain OS integration, X Layer ecosystem, AI experience, product completeness) so that evaluating the project takes minutes instead of hours.
Agentic Wallet framing: articulated the SynthID + NFAv2 + Custody composition as a single Agentic Wallet primitive (see section above).

🗺️ Roadmap

Deepen multi-chain data parity (chain-aware tokens / leaderboard APIs)
Unify BSC and X Layer fee scanners into a single multi-chain service
Expand Onchain OS coverage: position queries, historical PnL, limit orders
Open SynthID and NFAv2 up to third-party agent frameworks (ERC-8004 adapters)

📜 License

MIT

Built for the OKX Build X Hackathon — X Layer Arena.

Name		Name	Last commit message	Last commit date
Latest commit History 298 Commits
.next		.next
contracts		contracts
deployments		deployments
docs		docs
public		public
scripts		scripts
src		src
supabase/migrations		supabase/migrations
test		test
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
hardhat.config.ts		hardhat.config.ts
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.hardhat.json		tsconfig.hardhat.json
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

SynthLaunch

🔗 Live Links

🎯 What SynthLaunch Does

🤖 Agentic Wallet — how it works

🧭 Why X Layer

🧠 OKX Onchain OS Integration

📦 Smart Contracts

X Layer (primary — 196)

BSC (secondary — 56)

🧱 Architecture

🛣️ Core User Flow

🚀 Quick Start

Contract development

👩‍⚖️ Judge Quick Evaluation

🧩 Repository Layout

🔐 Security Notes

👤 Team

🛠️ What We Built During The Hackathon

🗺️ Roadmap

📜 License

About

Uh oh!

Releases 1

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

SynthLaunch

🔗 Live Links

🎯 What SynthLaunch Does

🤖 Agentic Wallet — how it works

🧭 Why X Layer

🧠 OKX Onchain OS Integration

📦 Smart Contracts

X Layer (primary — 196)

BSC (secondary — 56)

🧱 Architecture

🛣️ Core User Flow

🚀 Quick Start

Contract development

👩‍⚖️ Judge Quick Evaluation

🧩 Repository Layout

🔐 Security Notes

👤 Team

🛠️ What We Built During The Hackathon

🗺️ Roadmap

📜 License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages