What it is
ccip.dev is an unofficial, community-run tracker of every mainnet Chainlink CCIP message since 2023-07-06. Messages come from Chainlink's public CCIP API and token values from DefiLlama prices. Every figure is explained in the methodology.
What you get
The site
A live dashboard, daily history, top lanes, tokens and senders, records, the Chainlink Reserve vault, a cinematic replay of the network and a monthly video.
Broadcasts to X and Telegram
Daily and weekly reports, records, milestones, moments, polls and the monthly video are posted as image cards to @ccipdev on X and the Telegram channel. Designs: broadcasts, moments, monthly video.
The Discord bot
Enlist for a permanent meme callsign on a pair of dog tags, and pull live CCIP intel as cards. Free, for any server, with no permissions. See ccip.dev/discord.
Commands: /enlist, /dogtag, /cciptoday, /ccipchain, /linkreserve, /cciprecords.
The free data API
The JSON behind every page is public at https://data.ccip.dev/v1/. Main files:
| File | What it holds |
|---|
status.json | freshness and coverage |
live.json, today.json | the live feed and today so far |
history.json | daily history |
reserve.json | the Chainlink Reserve |
chains.json, tokens.json | the chain and token registries |
replay.json | the data behind the replay |
- Fetch each file at most once a minute per file; requests are rate-limited per IP.
- Credit: Source: ccip.dev.
- How every number is measured: docs/methodology.md.
How it works
flowchart LR
API[Chainlink CCIP API<br/>DefiLlama prices] --> W
subgraph W[Data Worker · Cron Triggers]
direction TB
C1[every minute: ingest]
C2[every 5 min: prices]
C3[hourly · 00:07 and 06:00 UTC: finalize]
end
W --> D1[(D1)]
W --> R2[(R2)]
R2 --> JSON[data.ccip.dev/v1/*.json]
JSON --> S[Site Worker<br/>Astro + card renderer]
S --> Users([ccip.dev visitors])
W -- broadcasts --> TG[Telegram]
W -- broadcasts --> X[X]
S -- card images --> W
DW[Discord Worker] -- service binding --> S
DW --> MD1[(D1 + R2: Marines)]
JSON --> GH[GitHub Actions<br/>monthly video]
GH -- uploads the video --> R2
- Data Worker (
worker/): Cron Triggers ingest new messages every minute, refresh prices every five minutes, run hourly jobs and finalize each day at 00:07 UTC, with a late re-run at 06:00. It writes D1 and publishes the public JSON to R2.
- Public JSON (
data.ccip.dev): static files served from an R2 bucket, cached and rate-limited at the edge.
- Site Worker (
site/): the Astro site, plus the Worker that draws the share and broadcast cards with Satori and resvg.
- Broadcasts: after finalize, the data Worker plans posts, fetches each card from the site's
/og/ route and sends it to Telegram and X.
- Discord Worker (
discord/): answers the bot's slash commands and keeps Marines in its own D1 and R2. It gets its cards from the site through a service binding to the card entrypoint.
- Monthly video (GitHub Actions):
monthly-video records last month's replay headlessly on the 1st of each month and uploads the video to R2; the data Worker posts it.
The stack
TypeScript in a pnpm workspace. Cloudflare Workers with D1, R2 and Cron Triggers. Astro and React for the site, WebGL for the replay, Satori and resvg for cards. Vitest for tests.
Develop
pnpm install
pnpm test
pnpm typecheck
pnpm --filter @ccip-dev/site dev # the site, locally
pnpm --filter @ccip-dev/site build # a production build, with its checks
| Package | What it is |
|---|
packages/core | shared types and logic: metrics, broadcasts, LinkMarine cards |
worker | the data Worker: ingest, prices, finalize, broadcasts |
site | the Astro site and the card-rendering Worker |
discord | the Discord bot Worker |
scripts | maintenance and tooling: labels, backfill, canary, video |
Docs
License
The code is MIT, see LICENSE. The label data in labels/ (labels/projects/*.toml) is CC BY 4.0, see labels/LICENSE; attribute it as "ccip.dev" with a link to https://ccip.dev.
Disclaimer
Unofficial — not affiliated with Chainlink Labs.
