Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
// /airdrops: airdrop eligibility checker for any Solana or Ethereum wallet.
//
// Data flow: address (form, ?address= deep link, recent chip) -> GET
// /api/crypto/airdrops (api/crypto/airdrops.js: wallet-activity scan +
// airdrop-eligibility scoring over data/airdrops.json) -> overview ring,
// measured-activity stat cards, filterable program cards with met/missing/
// manual checklists. With no address the page shows the tracked-program
// directory from the same endpoint. Shares the recent-wallet list with
// /portfolio (same localStorage key) so the two surfaces feel like one tool.
import { enterStagger } from './ui-juice.js';
import { formatUsd, timeAgo, escapeHtml } from './shared/coin-format.js';
import { createLogger } from './shared/log.js';
import { shortAddress } from './shared/address.js';
const log = createLogger('airdrops');
const $ = (id) => document.getElementById(id);
const RECENT_KEY = 'twx_portfolio_recent';
const RECENT_MAX = 5;
const EVM_RE = /^0x[0-9a-fA-F]{40}$/;
const SOLANA_RE = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
const state = {
address: '',
data: null,
filter: 'all',
loading: false,
};
function detectFamily(address) {
if (EVM_RE.test(address)) return 'evm';
if (SOLANA_RE.test(address)) return 'solana';
return null;
}
function shortAddr(a) { return shortAddress(a, 6, 4); }
/* ---------------- recents (shared with /portfolio) ---------------- */
function loadRecent() {
try {
const list = JSON.parse(localStorage.getItem(RECENT_KEY) || '[]');
return Array.isArray(list) ? list.filter((r) => r && detectFamily(r.address)) : [];
} catch {
return [];
}
}
function saveRecent(address) {
const chain = detectFamily(address) === 'evm' ? 'ethereum' : 'solana';
const list = loadRecent().filter((r) => r.address !== address);
list.unshift({ address, chain });
try {
localStorage.setItem(RECENT_KEY, JSON.stringify(list.slice(0, RECENT_MAX)));
} catch {
/* storage full or blocked: recents are a convenience, not state */
}
renderRecent();
}
function renderRecent() {
const list = loadRecent();
const wrap = $('ad-recent');
if (!list.length) {
wrap.hidden = true;
return;
}
wrap.hidden = false;
$('ad-recent-list').innerHTML = list
.map(
(r) =>
`<button type="button" class="ad-recent-chip" data-address="${escapeHtml(r.address)}" title="${escapeHtml(r.address)}">${escapeHtml(shortAddr(r.address))}</button>`,
)
.join(' ');
}
/* ---------------- view switching ---------------- */
function show(view) {
$('ad-directory').hidden = view !== 'directory';
$('ad-report').hidden = view !== 'report';
$('ad-loading').hidden = view !== 'loading';
$('ad-error').hidden = view !== 'error';
}
/* ---------------- directory (no-address state) ---------------- */
async function loadDirectory() {
show('loading');
try {
const res = await fetch('/api/crypto/airdrops', { headers: { accept: 'application/json' } });
const body = await res.json().catch(() => null);
if (!res.ok) return renderError(res.status, body);
const entries = Array.isArray(body?.registry) ? body.registry : [];
$('ad-dir-sub').textContent = entries.length
? `${entries.length} programs · registry updated ${body.updated}`
: `registry updated ${body.updated}`;
$('ad-dir-grid').innerHTML = entries.length
? entries.map((e) => directoryCard(e)).join('')
: `<p class="ad-empty"><b>No programs are being tracked right now.</b><br />
The registry is between updates. You can still scan a wallet: paste an address above and the
scan reports its measured on-chain activity, or open the
<a class="ad-card-src" href="/portfolio">wallet portfolio</a> for balances.</p>`;
show('directory');
enterStagger($('ad-dir-grid').children);
} catch (err) {
log.warn('directory load failed', err);
renderError(0, null);
}
}
function statusLabel(s) {
return s === 'confirmed' ? 'Confirmed' : s === 'upcoming' ? 'Upcoming' : 'Speculation';
}
function directoryCard(e) {
return `<article class="ad-card">
<div class="ad-card-top">
<span class="ad-card-name">${escapeHtml(e.name)}</span>
<span class="ad-card-chain">${escapeHtml(e.chain)}</span>
<span class="ad-status" data-s="${escapeHtml(e.status)}">${statusLabel(e.status)}</span>
</div>
<ul class="ad-crit">
${(e.criteria || []).map((c) => `<li><span class="u" aria-hidden="true">•</span><span class="txt">${escapeHtml(c.description)}</span></li>`).join('')}
</ul>
${e.note ? `<p class="ad-card-note">${escapeHtml(e.note)}</p>` : ''}
<div class="ad-card-foot">
<span class="ad-card-est">${e.estimatedValue ? `Est. ${escapeHtml(e.estimatedValue)}` : ''}</span>
<a class="ad-card-src" href="${escapeHtml(e.source)}" target="_blank" rel="noopener noreferrer nofollow">Site ↗</a>
</div>
</article>`;
}
/* ---------------- lookup ---------------- */
async function lookup(address, { push = true } = {}) {
if (state.loading) return;
state.loading = true;
state.address = address;
$('ad-address').value = address;
show('loading');
if (push) history.replaceState(null, '', `/airdrops?address=${encodeURIComponent(address)}`);
try {
const res = await fetch(`/api/crypto/airdrops?address=${encodeURIComponent(address)}`, {
headers: { accept: 'application/json' },
});
const body = await res.json().catch(() => null);
if (!res.ok) {
renderError(res.status, body);
return;
}
state.data = body;
saveRecent(address);
renderReport(body);
show('report');
} catch (err) {
log.warn('lookup failed', err);
renderError(0, null);
} finally {
state.loading = false;
}
}
function renderError(status, body) {
const title = $('ad-error-title');
const msg = $('ad-error-body');
if (status === 400) {
title.textContent = 'That address does not look right';
msg.textContent = body?.error?.message || body?.message || 'Check the address and try again.';
} else if (status === 429) {
title.textContent = 'Slow down a moment';
msg.textContent = 'Too many scans in a short burst. Wait a few seconds and retry.';
} else if (status === 503) {
title.textContent = 'Scan source unavailable';
msg.textContent = body?.error?.message || body?.message || 'The activity sources are unreachable right now. Retry shortly.';
} else {
title.textContent = 'Could not scan this wallet';
msg.textContent = 'The request failed before reaching the data sources. Check your connection and retry.';
}
show('error');
}
/* ---------------- report ---------------- */
function renderReport(d) {
const report = $('ad-report');
report.classList.remove('ad-enter');
void report.offsetWidth;
report.classList.add('ad-enter');
const addrEl = $('ad-addr');
addrEl.textContent = shortAddr(d.address);
addrEl.title = d.address;
$('ad-chain-tag').textContent = d.family === 'solana' ? 'solana' : 'evm';
$('ad-portfolio-link').href = `/portfolio?address=${encodeURIComponent(d.address)}`;
renderRing(d.summary);
const est = $('ad-est');
const estLabel = $('ad-est-label');
if (d.summary.estimatedValue) {
estLabel.textContent = `Estimated across ${d.summary.estimatedValue.entries} qualified program${d.summary.estimatedValue.entries === 1 ? '' : 's'} (public speculation, not a promise)`;
est.textContent = `${formatUsd(d.summary.estimatedValue.lo)} - ${formatUsd(d.summary.estimatedValue.hi)}`;
} else {
estLabel.textContent = 'Tracking';
est.textContent = `${d.summary.tracked} program${d.summary.tracked === 1 ? '' : 's'} on this chain family`;
}
$('ad-c-qualified').textContent = d.summary.qualified;
$('ad-c-progress').textContent = d.summary.in_progress;
$('ad-c-not').textContent = d.summary.not_eligible;
$('ad-c-tracked').textContent = d.summary.tracked;
renderActivity(d);
// setFilter, not renderCards: a new wallet resets the bucket to All, and the
// filter chips have to follow it or they claim a filter that is not applied.
setFilter('all');
renderOtherFamily(d);
$('ad-report-fineprint').textContent =
`Registry updated ${d.registryUpdated} · scanned ${timeAgo(d.ts) || 'just now'} · ` +
'Statuses and criteria are public reporting, not endorsements; estimated ranges are speculation, not promises. ' +
'Scores reflect only what an on-chain scan can measure; protocol-specific steps are listed as manual to-dos.';
}
function renderRing(summary) {
const svg = $('ad-ring');
const pct = summary.tracked > 0 ? summary.qualified / summary.tracked : 0;
const r = 52;
const c = 2 * Math.PI * r;
svg.innerHTML = `
<circle cx="60" cy="60" r="${r}" fill="none" stroke="var(--cv-surface-3, #1c1c21)" stroke-width="10"></circle>
<circle cx="60" cy="60" r="${r}" fill="none" stroke="var(--ad-q)" stroke-width="10" stroke-linecap="round"
stroke-dasharray="${(pct * c).toFixed(1)} ${c.toFixed(1)}" transform="rotate(-90 60 60)"></circle>`;
svg.setAttribute(
'aria-label',
`Qualified for ${summary.qualified} of ${summary.tracked} tracked airdrops`,
);
$('ad-ring-center').innerHTML = `<b>${summary.qualified}/${summary.tracked}</b><span>qualified</span>`;
}
function renderActivity(d) {
const a = d.activity;
const fmtN = (v) => (v == null ? null : Number(v).toLocaleString('en-US'));
const stats = [
['Transactions', fmtN(a.tx_count), a.capped ? 'minimum, scan capped' : null],
['Active days', fmtN(a.days_active), null],
['Wallet age', a.account_age_days == null ? null : `${fmtN(a.account_age_days)}d`, null],
['Last active', a.last_active_days == null ? null : a.last_active_days === 0 ? 'today' : `${fmtN(a.last_active_days)}d ago`, null],
['Tokens held', fmtN(a.unique_tokens), null],
['Chains active', fmtN(a.chains_active), Array.isArray(a.chains) && a.chains.length ? a.chains.join(', ') : null],
['Contract calls', fmtN(a.contract_interactions), null],
['Native volume', a.volume_usd == null ? null : formatUsd(a.volume_usd), null],
];
$('ad-stats').innerHTML = stats
.map(
([k, v, sub]) => `<div class="ad-stat">
<div class="k">${escapeHtml(k)}</div>
<div class="v${v == null ? ' na' : ''}">${v == null ? 'not measured' : escapeHtml(v)}</div>
${sub ? `<div class="k">${escapeHtml(sub)}</div>` : ''}
</div>`,
)
.join('');
$('ad-act-note').textContent = a.capped
? 'Scan hit its history cap; totals are honest minimums.'
: 'Fields a scan cannot measure are shown as such, never guessed.';
}
function eligLabel(e) {
return e === 'qualified' ? '✓ Qualified' : e === 'in_progress' ? 'In progress' : 'Not eligible';
}
function scoreColor(e) {
return e === 'qualified' ? 'var(--ad-q)' : e === 'in_progress' ? 'var(--ad-p)' : 'var(--ad-n)';
}
function renderCards() {
const d = state.data;
const list = state.filter === 'all'
? d.opportunities
: d.opportunities.filter((o) => o.eligibility === state.filter);
const grid = $('ad-grid');
if (!list.length) {
grid.innerHTML = d.opportunities.length
? `<p class="ad-empty">No programs scored <b>${escapeHtml(eligLabel(state.filter).replace('✓ ', ''))}</b> for this wallet.
<button type="button" data-clear-filter>Show all ${d.opportunities.length} programs</button></p>`
: `<p class="ad-empty"><b>No programs are tracked for this chain yet.</b><br />
Nothing in the registry targets ${escapeHtml(d.family === 'solana' ? 'Solana' : 'EVM')} wallets right now.
The measured activity above is still real, and the other chain family is listed below.</p>`;
return;
}
grid.innerHTML = list.map((o) => opportunityCard(o)).join('');
enterStagger(grid.children);
}
function setFilter(name) {
state.filter = name;
document.querySelectorAll('.ad-filter').forEach((b) => {
const on = b.dataset.filter === name;
b.classList.toggle('active', on);
b.setAttribute('aria-pressed', String(on));
});
if (state.data) renderCards();
}
function opportunityCard(o) {
const nextStep = o.missing.find((m) => !m.unknown)?.recommendation || o.missing[0]?.recommendation || null;
return `<article class="ad-card">
<div class="ad-card-top">
<span class="ad-card-name">${escapeHtml(o.name)}</span>
<span class="ad-card-chain">${escapeHtml(o.chain)}</span>
<span class="ad-status" data-s="${escapeHtml(o.status)}">${statusLabel(o.status)}</span>
</div>
<div class="ad-score-row">
<span class="ad-elig" data-e="${escapeHtml(o.eligibility)}">${eligLabel(o.eligibility)}</span>
<span class="ad-score-bar"><span style="--c:${scoreColor(o.eligibility)};width:${Math.max(o.score, 2)}%"></span></span>
<span class="ad-score-num">${o.score}%</span>
</div>
<ul class="ad-crit">
${o.met.map((c) => `<li class="done"><span class="m" aria-hidden="true">✓</span><span class="txt">${escapeHtml(c.description)}</span></li>`).join('')}
${o.missing.map((c) => `<li><span class="${c.unknown ? 'u' : 'x'}" aria-hidden="true">${c.unknown ? '?' : '✗'}</span><span class="txt">${escapeHtml(c.description)}${c.unknown ? ' (not measurable on-chain)' : ''}</span></li>`).join('')}
</ul>
${nextStep && o.eligibility !== 'qualified' ? `<p class="ad-next"><strong>Next:</strong> ${escapeHtml(nextStep)}</p>` : ''}
${o.manual.length ? `<p class="ad-manual"><b>Do this yourself:</b> ${o.manual.map((m) => escapeHtml(m.description)).join(' · ')}</p>` : ''}
${o.note ? `<p class="ad-card-note">${escapeHtml(o.note)}</p>` : ''}
<div class="ad-card-foot">
<span class="ad-card-est">${o.estimatedValue ? `Est. ${escapeHtml(o.estimatedValue)}` : ''}</span>
<a class="ad-card-src" href="${escapeHtml(o.source)}" target="_blank" rel="noopener noreferrer nofollow">Site ↗</a>
</div>
</article>`;
}
function renderOtherFamily(d) {
const wrap = $('ad-other');
if (!d.otherFamily.length) {
wrap.hidden = true;
return;
}
wrap.hidden = false;
const other = d.family === 'solana' ? 'an EVM' : 'a Solana';
$('ad-other-sub').textContent = `These programs live on the other chain family. Check them with ${other} wallet.`;
$('ad-other-grid').innerHTML = d.otherFamily.map((e) => directoryCard(e)).join('');
}
/* ---------------- wiring ---------------- */
function submit(raw) {
const address = raw.trim();
if (!address) {
$('ad-address').focus();
return;
}
if (!detectFamily(address)) {
renderError(400, { message: 'Not a valid Solana or Ethereum address.' });
return;
}
lookup(address);
}
async function copyWithFeedback(btn, text, doneLabel) {
const original = btn.textContent;
try {
await navigator.clipboard.writeText(text);
btn.textContent = doneLabel;
btn.classList.add('ad-chip-ok');
} catch {
btn.textContent = 'Copy failed';
}
setTimeout(() => {
btn.textContent = original;
btn.classList.remove('ad-chip-ok');
}, 1600);
}
function init() {
renderRecent();
$('ad-form').addEventListener('submit', (e) => {
e.preventDefault();
submit($('ad-address').value);
});
$('ad-recent').addEventListener('click', (e) => {
const chip = e.target.closest('.ad-recent-chip');
if (chip) lookup(chip.dataset.address);
});
$('ad-retry').addEventListener('click', () => {
// Prefer whatever is in the field: after a bad-address error the visitor
// fixes it there, and retrying the old address would ignore the fix.
const typed = $('ad-address').value.trim();
if (typed && detectFamily(typed)) lookup(typed);
else if (state.address) lookup(state.address);
else loadDirectory();
});
document.querySelectorAll('.ad-filter').forEach((btn) => {
btn.addEventListener('click', () => setFilter(btn.dataset.filter));
});
$('ad-grid').addEventListener('click', (e) => {
if (e.target.closest('[data-clear-filter]')) setFilter('all');
});
$('ad-copy-addr').addEventListener('click', () => {
if (state.data) copyWithFeedback($('ad-copy-addr'), state.data.address, 'Copied');
});
$('ad-share').addEventListener('click', () => {
copyWithFeedback($('ad-share'), location.href, 'Link copied');
});
// "/" focuses the address field, as the hint under the form promises. The
// preventDefault is what tells the site-wide Atlas palette to stand down:
// it also listens for "/" and opens the search dialog when no page claimed
// the key first. Modified presses and typing targets are left alone.
document.addEventListener('keydown', (e) => {
if (e.key !== '/' || e.metaKey || e.ctrlKey || e.altKey) return;
const target = e.target instanceof Element ? e.target : document.activeElement;
if (target?.isContentEditable) return;
if (/^(input|textarea|select)$/i.test(target?.tagName || '')) return;
e.preventDefault();
$('ad-address').focus();
});
const params = new URLSearchParams(location.search);
const address = (params.get('address') || '').trim();
if (address && detectFamily(address)) {
lookup(address, { push: false });
} else if (address) {
// A shared link with a broken address: keep what the visitor arrived with
// in the field and say why nothing was scanned, rather than silently
// dropping it and showing the directory as though no address was given.
$('ad-address').value = address;
renderError(400, {
message: 'The address in this link is not a valid Solana or Ethereum address. Fix it above and check again.',
});
} else {
loadDirectory();
}
}
init();