KiteID

At a Glance

Bir Bakışta

The Problem

Problem

Every mature chain eventually needs a naming primitive. Ethereum has ENS, Solana has SNS — both emerged years into each chain's life, and both created outsized value by turning raw addresses (0x3bE2…82b0eCa) into human- readable identity (alice.eth). Kite AI — an Avalanche L1 subnet purpose-built for AI agents, native x402 payments and Kite Passport identity — is still early, fast, and dirt-cheap on gas. It is also nameless.

Her olgunlaşan zincir er ya da geç bir isim primitifine ihtiyaç duyuyor. Ethereum'un ENS'i, Solana'nın SNS'i var — ikisi de zincirlerinin ömrünün içinde ortaya çıktı ve ham adresi (0x3bE2…82b0eCa) okunabilir kimliğe (alice.eth) çevirerek devasa değer yarattı. Kite AI — AI ajanları için tasarlanmış bir Avalanche L1 subnet'i, native x402 ödeme ve Kite Passport kimlik primitifi ile — henüz erken, hızlı ve gas'i çok ucuz. Aynı zamanda isimsiz.

KiteID fills that gap. V1 is the naming layer — commit-reveal registration, Dutch-auction premium for expired names, full ENS-style resolution. V2 extends it into the real prize: a delegable identity layer for AI agents, integrating Kite Passport and x402 so that an agent doesn't just have a wallet, it has a name, a verifiable delegation chain, and an on-chain reputation surface.

KiteID bu boşluğu dolduruyor. V1 isimlendirme katmanı — commit-reveal kayıt, süresi bitmiş isimler için Dutch-auction premium, tam ENS tarzı çözümleme. V2 ise asıl ödüle uzanıyor: AI ajanları için delege edilebilir kimlik katmanı; Kite Passport ve x402 entegrasyonuyla bir ajan sadece bir cüzdana değil, bir isme, doğrulanabilir delegasyon zincirine ve on-chain reputasyon yüzeyine sahip oluyor.

My Role — Solo, End-to-End

Rolüm — Tek Başıma, Baştan Sona

Founder, sole architect, sole engineer. No co-founders, no contractors. Every ADR, every commit, every deploy is mine:

Kurucu, tek mimar, tek mühendis. Ortak yok, freelancer yok. Her ADR, her commit, her deploy benim:

• Product & strategy: thesis, scoping (V1 naming → V2 agent identity), KITE-denominated pricing model, revenue split (60 % Ops / 25 % Reserve / 10 % Ecosystem / 5 % Buyback), and phase gating.
• Architecture: 8 ADRs (stack decision, contracts, frontend, backend/indexing, monorepo, security, tokenomics, self-hosted infrastructure) and 17 research documents — written before any code.
• Smart contracts: Six contracts, ENS-inspired but rewritten for Kite — UUPS-upgradeable Controller, immutable Registry and BaseRegistrar, Linear Premium Dutch-auction price oracle, Resolver, Reverse Registrar. Solidity 0.8.34, OpenZeppelin 5.5, Solady. Foundry fuzz + invariant suite. Slither + Aderyn + Halmos in CI.
• Frontend: Next.js 16 (Turbopack) + React 19, Tailwind v4 with @theme tokens, shadcn/ui, Motion v12, RHF+Zod, TanStack Query v5, Zustand. Parchment Identity design system from scratch. Playwright E2E + Vitest. Biome v2.3.
• Web3 integration: Viem + Wagmi v3.6 + RainbowKit + SIWE via Better Auth. Full commit-reveal UX with 60-second client-side countdown, excess-refund handling, reverse-record opt-in.
• Backend: Hono on Node, self-hosted PostgreSQL 17 + PgBouncer pool, Drizzle ORM, Dragonfly (Redis-compat). Separate ponder_index schema for the indexer, role-based grants (app / ponder / backup).
• Indexing: Ponder v0.16 self-hosted on the same VPS, shares Postgres with the app, real-time event ingestion from the testnet contracts.
• Infrastructure: Hetzner CAX21 ARM VPS + Dokploy PaaS + Cloudflare Tunnel (origin IP hidden) + Cloudflare Access SSH. No Vercel, no Neon, no paid managed services.
• DevOps: Turborepo + pnpm workspaces, multi-arch Docker builds (amd64 + arm64) via buildx → GHCR → Dokploy webhook, ubuntu-24.04-arm GitHub runners for native ARM speed.
• Security & ops: CodeQL + Semgrep + Trivy + gitleaks in CI, branch protection, dependabot, CrowdSec IPS + Cloudflare bouncer, AIDE + osquery + auditd on the host, WAL-G + pgBackRest backup pipeline to R2 (RPO 15 min, RTO < 30 min).

• Ürün & strateji: tez, scope'lama (V1 naming → V2 ajan kimliği), KITE-cinsinden fiyatlama modeli, gelir dağılımı (%60 Operasyon / %25 Rezerv / %10 Ekosistem / %5 Buyback), ve faz kapıları.
• Mimari: 8 ADR (stack kararı, kontratlar, frontend, backend/indexing, monorepo, güvenlik, tokenomics, self-hosted altyapı) ve 17 araştırma dokümanı — herhangi bir kod yazılmadan önce.
• Akıllı kontratlar: Altı kontrat, ENS'ten ilham almış ama Kite için yeniden yazıldı — UUPS upgradeable Controller, immutable Registry ve BaseRegistrar, Linear Premium Dutch-auction price oracle, Resolver, Reverse Registrar. Solidity 0.8.34, OpenZeppelin 5.5, Solady. Foundry fuzz + invariant paketi. CI'da Slither + Aderyn + Halmos.
• Frontend: Next.js 16 (Turbopack) + React 19, @theme token'lı Tailwind v4, shadcn/ui, Motion v12, RHF+Zod, TanStack Query v5, Zustand. Sıfırdan Parchment Identity tasarım sistemi. Playwright E2E + Vitest. Biome v2.3.
• Web3 entegrasyonu: Viem + Wagmi v3.6 + RainbowKit + Better Auth üzerinden SIWE. Tam commit- reveal UX — 60 saniyelik client-side geri sayım, fazla ödemeyi iade, reverse-record opt-in.
• Backend: Node üzerinde Hono, self-hosted PostgreSQL 17 + PgBouncer havuzu, Drizzle ORM, Dragonfly (Redis-uyumlu). İndexer için ayrı ponder_index şeması, rol-bazlı yetkiler (app / ponder / backup).
• İndeksleme: Aynı VPS üzerinde self-hosted Ponder v0.16, uygulamayla Postgres paylaşıyor, testnet kontratlarından gerçek zamanlı event alımı.
• Altyapı: Hetzner CAX21 ARM VPS + Dokploy PaaS + Cloudflare Tunnel (origin IP gizli) + Cloudflare Access SSH. Vercel yok, Neon yok, ücretli managed servis yok.
• DevOps: Turborepo + pnpm workspaces, buildx ile multi-arch Docker build'ler (amd64 + arm64) → GHCR → Dokploy webhook, native ARM hızı için ubuntu-24.04-arm GitHub runner'lar.
• Güvenlik & ops: CI'da CodeQL + Semgrep + Trivy + gitleaks, branch protection, dependabot, CrowdSec IPS + Cloudflare bouncer, host üzerinde AIDE + osquery + auditd, R2'ye WAL-G + pgBackRest yedekleme hattı (RPO 15 dk, RTO < 30 dk).

Smart Contract Architecture

Akıllı Kontrat Mimarisi

The contract layer is ENS-inspired but pruned and re-tuned for Kite. No NameWrapper in V1 (complexity reserved for V2), no multi-TLD: just .kite. The split between the upgradeable Controller and the immutable core follows a hard invariant — ownership logic never migrates in place.

Kontrat katmanı ENS'ten ilham almış ama Kite için budanmış ve yeniden ayarlanmış. V1'de NameWrapper yok (karmaşıklık V2'ye saklanıyor), çoklu TLD yok: sadece .kite. Upgradeable Controller ile immutable çekirdek arasındaki ayrım sert bir invariant'a dayanıyor — sahiplik mantığı yerinde migrate olmaz.

• KiteRegistry (immutable) — node → owner / resolver / TTL, the single source of truth.
• KiteBaseRegistrar (immutable, ERC-721) — owns the .kite node, mints name NFTs, enforces 90-day grace period and expiry.
• KiteController (UUPS upgradeable) — commit-reveal registration, price quoting, withdrawals, reserved-name gating. The only upgradeable contract in the system.
• KiteResolver — IAddrResolver, INameResolver, ITextResolver, IContentHashResolver, IMulticallable. Clear-on-transfer via version bumps.
• LinearPremiumPriceOracle — tiered base pricing (640 / 160 / 5 KITE per year for 3 / 4 / 5+ char names) plus a 14-day exponential Dutch-auction premium on expired names.
• KiteReverseRegistrar — lets an address set a primary .kite name, deterministic reverse-node derivation.

• KiteRegistry (immutable) — node → owner / resolver / TTL, tek hakikat kaynağı.
• KiteBaseRegistrar (immutable, ERC-721) — .kite node'un sahibi, isim NFT'lerini mint'ler, 90 günlük grace period ve expiry'yi zorlar.
• KiteController (UUPS upgradeable) — commit-reveal kayıt, fiyat sorgusu, withdraw'lar, reserved-name gate'i. Sistemdeki tek upgradeable kontrat.
• KiteResolver — IAddrResolver, INameResolver, ITextResolver, IContentHashResolver, IMulticallable. Transfer'da version bump ile temizlenir.
• LinearPremiumPriceOracle — kademeli taban fiyat (3 / 4 / 5+ karakter için yıllık 640 / 160 / 5 KITE) artı süresi bitmiş isimlerde 14 günlük üstel Dutch-auction premium.
• KiteReverseRegistrar — bir adrese birincil .kite ismi atamayı sağlar, deterministic reverse-node türetimi.

All six contracts are verified on testnet.kitescan.ai. Deploy block: 20858663. Ten reserved names (admin, kite, kiteid, …) were set on-chain via per-name cast send calls to work around a Kite RPC quirk (the non-standard feePayer receipt field breaks Foundry's default deserializer — the TX succeeds with status 0x1, Foundry just can't parse the receipt).

Altı kontratın hepsi testnet.kitescan.ai'de doğrulandı. Deploy block: 20858663. On rezerv isim (admin, kite, kiteid, …) Kite RPC'nin bir tuhaflığı etrafından dolanmak için isim başına cast send ile on-chain olarak set edildi (standart dışı feePayer receipt alanı Foundry'nin varsayılan deserializer'ını kırıyor — TX 0x1 status ile başarılı oluyor, Foundry sadece receipt'i parse edemiyor).

The Full Stack

Tam Stack

Contracts

Kontratlar

Foundry v1.0+ · Solidity 0.8.34+ · OpenZeppelin Contracts 5.5 · Solady · Soldeer for deps · Slither + Aderyn + Halmos for static analysis and symbolic execution.

Foundry v1.0+ · Solidity 0.8.34+ · OpenZeppelin Contracts 5.5 · Solady · bağımlılıklar için Soldeer · statik analiz ve sembolik yürütme için Slither + Aderyn + Halmos.

Frontend

Frontend

Next.js 16.2 (Turbopack) · React 19 · TypeScript 6.0 · Tailwind v4 with @theme tokens · shadcn/ui · Motion v12 · React Hook Form + Zod · TanStack Query v5 · Zustand · Vitest + Playwright · Biome v2.3.

Next.js 16.2 (Turbopack) · React 19 · TypeScript 6.0 · @theme token'lı Tailwind v4 · shadcn/ui · Motion v12 · React Hook Form + Zod · TanStack Query v5 · Zustand · Vitest + Playwright · Biome v2.3.

Web3

Web3

Viem (not ethers) · Wagmi v3.6+ · RainbowKit as primary connector · SIWE via Better Auth with custom Kite-chain message verification.

Viem (ethers değil) · Wagmi v3.6+ · birincil connector olarak RainbowKit · Kite zinciri için özel mesaj doğrulamalı, Better Auth üstünden SIWE.

Monorepo

Monorepo

Turborepo 2.x (Vercel free cache) · pnpm workspaces · Biome v2.3 · tsdown · Changesets · lefthook. Apps: web, indexer, workers, docs. Packages: contracts, contracts-abi, sdk, ui, api, db, brand, utils.

Turborepo 2.x (Vercel free cache) · pnpm workspaces · Biome v2.3 · tsdown · Changesets · lefthook. App'ler: web, indexer, workers, docs. Paketler: contracts, contracts-abi, sdk, ui, api, db, brand, utils.

Backend · Self-hosted

Backend · Self-hosted

Hono on Node · PostgreSQL 17 + PgBouncer (transaction pool) · Drizzle ORM · Dragonfly (Redis-compatible) · Better Auth + SIWE · self-hosted Inngest · Cloudflare R2 · Resend.

Node üzerinde Hono · PostgreSQL 17 + PgBouncer (transaction havuzu) · Drizzle ORM · Dragonfly (Redis-uyumlu) · Better Auth + SIWE · self-hosted Inngest · Cloudflare R2 · Resend.

Indexing

İndeksleme

Ponder v0.16 · deployed via Dokploy on the same CAX21 · shared Postgres with ponder_index schema · real-time event indexing from the six testnet contracts.

Ponder v0.16 · aynı CAX21'de Dokploy üzerinden deploy · ponder_index şemasıyla paylaşılan Postgres · altı testnet kontratından gerçek zamanlı event indekslemesi.

Infrastructure

Altyapı

Hetzner CAX21 — 4 vCPU, 8 GB RAM, 80 GB SSD, ARM Ampere Altra, $9.49/mo · Debian 12 arm64 · LUKS · unattended-upgrades · Dokploy PaaS (Docker Swarm + Traefik + GitHub webhooks) · Cloudflare Tunnel (origin IP never exposed) · SSH via Cloudflare Access — no open port 22 to the internet.

Hetzner CAX21 — 4 vCPU, 8 GB RAM, 80 GB SSD, ARM Ampere Altra, aylık 9,49 $ · Debian 12 arm64 · LUKS · unattended- upgrades · Dokploy PaaS (Docker Swarm + Traefik + GitHub webhook'ları) · Cloudflare Tunnel (origin IP asla ifşa edilmiyor) · Cloudflare Access üstünden SSH — internete açık port 22 yok.

Observability

Gözlemlenebilirlik

GlitchTip (Sentry-SDK compatible) · OpenPanel (cookieless analytics) · Uptime Kuma (internal) · BetterStack (external) · Beszel (container metrics) · Dozzle (live logs) · Kener (status.kiteid.xyz) · Tenderly (contracts).

GlitchTip (Sentry-SDK uyumlu) · OpenPanel (cookiesiz analitik) · Uptime Kuma (iç) · BetterStack (dış) · Beszel (container metrikleri) · Dozzle (canlı log) · Kener (status.kiteid.xyz) · Tenderly (kontratlar).

DevOps

DevOps

GitHub Actions reusable workflows · ubuntu-24.04-arm runners (free on public repos) · multi-arch Docker builds (amd64 + arm64) via buildx → GHCR → Dokploy webhook · CodeQL + Semgrep + Trivy + gitleaks · Slither + Aderyn in CI · Halmos pre-audit · CrowdSec IPS + Cloudflare bouncer · AIDE + osquery + auditd host hardening · WAL-G + pgBackRest to R2 — RPO 15 min, RTO < 30 min.

GitHub Actions reusable workflow'lar · ubuntu-24.04-arm runner'lar (public repo'da ücretsiz) · buildx ile multi-arch Docker build (amd64 + arm64) → GHCR → Dokploy webhook · CodeQL + Semgrep + Trivy + gitleaks · CI'da Slither + Aderyn · pre-audit Halmos · CrowdSec IPS + Cloudflare bouncer · AIDE + osquery + auditd host sertleştirme · R2'ye WAL-G + pgBackRest — RPO 15 dk, RTO < 30 dk.

Tokenomics & Pricing

Tokenomics & Fiyatlama

All pricing is denominated in KITE — the chain's native token — not in USD. Tier structure:

Tüm fiyatlama USD yerine zincirin yerel token'ı olan KITE cinsinden. Kademe yapısı:

• 1–2 chars: reserved for V2 DAO auctions.
• 3 chars: 640 KITE / year.
• 4 chars: 160 KITE / year.
• 5+ chars: 5 KITE / year.
• Expired premium: 14-day exponential Dutch-auction decay on top of base price (vs ENS's 21 days).
• Grace period: 90 days after expiry before a name can be re-registered.

• 1–2 karakter: V2 DAO açık artırmaları için saklandı.
• 3 karakter: yıllık 640 KITE.
• 4 karakter: yıllık 160 KITE.
• 5+ karakter: yıllık 5 KITE.
• Süresi bitmiş premium: taban fiyatın üstüne 14 günlük üstel Dutch-auction düşüşü (ENS'in 21 gününe karşılık).
• Grace period: süre bitiminden sonra ismin yeniden kaydedilebilmesi için 90 gün.

Revenue split: 60 % operations · 25 % reserve · 10 % ecosystem grants · 5 % buyback (V1.5 onwards).

Gelir dağılımı: %60 operasyon · %25 rezerv · %10 ekosistem hibeleri · %5 buyback (V1.5'ten itibaren).

Engineering Discipline

Mühendislik Disiplini

Research-first before architecture, architecture-first before code. Each phase has a written exit gate.

Mimariden önce araştırma, koddan önce mimari. Her fazın yazılı bir çıkış kapısı var.

Links

Bağlantılar

• kiteid.xyz — Live landing
• GitHub: KiteID/kiteid (monorepo)
• GitHub Organization: KiteID
• Verified Controller on Blockscout
• Kite AI Testnet Explorer