Vein — LiteForge Ecosystem Intelligence

Live on-chain intelligence for LiteForge. Every transaction. Every wallet. Every move.

Vein is a free, open-source ecosystem dashboard and intelligence API built on top of LiteForge — Litecoin's first EVM rollup powered by Arbitrum Orbit, BitcoinOS, and Espresso.

Live at: usevein.xyz

---

Features

Dashboard (/dashboard)

• Chain Health Score — composite 0–100 score across block time, gas price, utilization, tx activity, and uptime. Dynamic gauge with per-metric breakdown
• Live ecosystem stats — total transactions, unique addresses, avg block time, gas prices, network utilization
• Period activity — transaction counts across 24H, 7D, 30D, and all-time
• Method breakdown — swap, mint, deposit, transfer, bridge classification from live tx data
• zkLTC / wzkLTC panel — token supply, holder count, bridge interactions, recent transfers
• Top dApps — ranked by transaction count from verified contracts
• Live transaction feed — real-time tx stream with ArcSense-style polling, ArbOS filtered, 3s refresh
• Wallet lookup — search any address directly from the dashboard

Wallet Profiles (/wallet/[address])

• Total transactions, zkLTC balance, first seen, last active
• Activity breakdown by method type
• Top dApp and most used method
• Recent transaction history
• Shareable URL — usevein.xyz/wallet/0x...

Weekly Reports

• Auto-generated every 7 days after deployment via Vercel Cron
• Week-over-week deltas for all key metrics
• Auto-generated insight paragraph
• Browsable by week in the dashboard modal
• Downloadable as .txt file

Intelligence API

• Pay-per-query with 5 free queries per wallet
• 0.005 zkLTC per query after free tier
• 6 endpoints covering stats, activity, dApps, zkLTC, weekly reports, and payment confirmation

---

Tech Stack

Layer	Technology
Framework	Next.js 15 (App Router)
Styling	Tailwind CSS v4
Data	Blockscout REST API v2 — liteforge.explorer.caldera.xyz/api/v2
Database	Supabase (wallet query tracking, weekly reports)
Deployment	Vercel (with Cron Jobs)
Chain	LiteForge · Chain ID 4441

No AI API. No paid data providers. Pure on-chain data from the public Blockscout API.

---

API

Vein exposes a pay-per-query intelligence API. 5 free queries per wallet, then 0.005 zkLTC per query.

Payment destination: 0x1a870eA7c2AEC156ff84c83fa4fD30bf9D6be5fb

Endpoints

GET  /api/intelligence/stats?wallet=0xYOUR_WALLET
GET  /api/intelligence/activity?wallet=0xYOUR_WALLET&period=24h
GET  /api/intelligence/dapps?wallet=0xYOUR_WALLET
GET  /api/intelligence/zkltc?wallet=0xYOUR_WALLET
GET  /api/intelligence/report/weekly?wallet=0xYOUR_WALLET
POST /api/intelligence/confirm/:queryId

Example

const res = await fetch(
  'https://usevein.xyz/api/intelligence/stats' +
  '?wallet=0xYOUR_WALLET_ADDRESS'
)
const data = await res.json()
// → { totalTransactions, totalAddresses, avgBlockTimeMs, gasPrices, ... }

How to pay after free tier

1. Send 0.005 zkLTC to 0x1a870eA7c2AEC156ff84c83fa4fD30bf9D6be5fb on LiteForge
2. Copy your transaction hash from the LiteForge explorer
3. Call POST /api/intelligence/confirm/:queryId with { wallet, txId }
4. 1 credit added — next query served immediately
5. Pass ?wallet=0xYOURS on every request to track usage per wallet

---

Roadmap

Version	Feature	Status
v1.0	Dashboard, health score, wallet profiles, live feed, weekly reports, API	✅ Live
v1.1	Ecosystem growth chart	Planned
v1.2	Token explorer	Planned
v1.3	dApp detail pages	Planned
v1.4	Share card for X	Planned

---

Local Development

git clone https://github.com/2TheMoom/vein.git
cd vein
npm install
cp .env.example .env.local
# Fill in your Supabase keys in .env.local
npm run dev

Open http://localhost:3000

Environment Variables

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
CRON_SECRET=
NEXT_PUBLIC_PAYMENT_DESTINATION=0x1a870eA7c2AEC156ff84c83fa4fD30bf9D6be5fb

Supabase Setup

Run supabase/schema.sql in your Supabase SQL Editor to create the required tables:

• vein_queries — wallet query tracking and free tier enforcement
• vein_reports — auto-generated weekly reports
• vein_config — launch date and cron state

---

Project Structure

vein/
├── app/
│   ├── page.tsx                          # Landing page
│   ├── dashboard/page.tsx                # Main dashboard
│   ├── wallet/[address]/page.tsx         # Wallet profile pages
│   └── api/
│       ├── chain/route.ts                # Blockscout CORS proxy
│       ├── reports/route.ts              # Weekly reports listing
│       ├── cron/weekly-report/route.ts   # Auto-generate weekly report
│       └── intelligence/
│           ├── stats/route.ts
│           ├── activity/route.ts
│           ├── dapps/route.ts
│           ├── zkltc/route.ts
│           ├── report/weekly/route.ts
│           └── confirm/route.ts
├── components/
│   ├── Header.tsx
│   ├── HeroCards.tsx
│   ├── ChainStrip.tsx
│   ├── HealthScore.tsx
│   ├── LiveFeed.tsx
│   ├── WalletSearch.tsx
│   ├── WalletProfile.tsx
│   ├── WeeklyReportModal.tsx
│   ├── ApiAccessModal.tsx
│   ├── QueryPanel.tsx
│   └── Footer.tsx
├── lib/
│   ├── blockscout.ts
│   └── supabase.ts
├── types/index.ts
└── supabase/schema.sql

---

Deployment

Deployed on Vercel. The weekly report cron runs every Sunday at midnight UTC via Vercel Cron Jobs (vercel.json).

Add CRON_SECRET as an environment variable in Vercel to protect the cron endpoint.

---

About

Built by Abu Olumi as a contribution to the LiteForge/LitVM ecosystem.

Vein is submitted to the LitVM Builders Program as free, open ecosystem intelligence infrastructure — making LiteForge activity legible to builders, researchers, and the Litecoin community.

---

Data via Blockscout API · Not financial advice