Skip to content

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.

20.7 KB
Raw Blame
/**
 * Agent Wallet hub — the single product home for an agent's self-custodied
 * Solana wallet. Tabbed: Balance · Deposit · Trade · Snipe · Pay · Withdraw · Give.
 *
 * This file owns the shell: layout, the agent header (name + wallet-readiness),
 * the network selector, the accessible tab strip, and the shared context handed
 * to every tab. The tabs themselves live in ./tabs/*.js and self-register via
 * ./registry.js — adding a tab is a new file + one import below, never an edit
 * to a shared list.
 *
 * Balance, Deposit, Trade, Snipe, Pay, Withdraw, and Give are all fully built —
 * each is its own tab file under ./tabs/, registered via ./registry.js, so the
 * shell never hardcodes a tab list and a surface is a single-file change.
 *
 * Reachable from the agent profile and the create-agent success screen as
 * `/agents/:id/wallet` (or `?id=`). Owner sees management tabs; a visitor gets a
 * read-only view (Balance + Deposit only).
 */

import { getVisibleTabs } from './registry.js';

// Tab modules — importing each one runs its registerWalletTab() side effect.
// To add a tab later: drop a file in ./tabs/ and add one import line here.
import './tabs/balance.js';
import './tabs/activate.js';
import './tabs/portfolio.js';
import './tabs/pulse.js';
import './tabs/reputation.js';
import './tabs/deposit.js';
import './tabs/trade.js';
import './tabs/copilot.js';
import './tabs/snipe.js';
import './tabs/orders.js';
import './tabs/earn.js';
import './tabs/autopilot.js';
import './tabs/credits.js';
import './tabs/intents.js';
import './tabs/signals.js';
import './tabs/pay.js';
import './tabs/vanity.js';
import './tabs/policy.js';
import './tabs/delegation.js';
import './tabs/allowance.js';
import './tabs/burner.js';
import './tabs/withdraw.js';
import './tabs/whitelist.js';
import './tabs/give.js';
import './tabs/access.js';
import './tabs/recovery.js';
import './tabs/guard.js';
import './tabs/proof.js';

import { escapeHtml, shortAddress, copyToClipboard, toast } from './util.js';

const STYLE_ID = 'agent-wallet-hub-style';
const STYLE = `
.awh { --awh-gap: var(--space-4, 16px); display: flex; flex-direction: column; gap: var(--awh-gap); max-width: 760px; margin: 0 auto; }
.awh-header { display: flex; align-items: center; gap: var(--space-3, 12px); flex-wrap: wrap; }
.awh-avatar { width: 44px; height: 44px; border-radius: var(--radius-md, 10px); object-fit: cover; background: var(--surface-2, rgba(255,255,255,.05)); border: 1px solid var(--stroke, rgba(255,255,255,.08)); flex: none; }
.awh-id { display: flex; flex-direction: column; gap: 2px; min-width: 0; }
.awh-name { font-family: var(--font-display, system-ui); font-size: var(--text-lg, 1.236rem); font-weight: 600; color: var(--ink-bright, #fff); margin: 0; line-height: 1.2; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 46vw; }
.awh-sub { font-size: var(--text-sm, .764rem); color: var(--ink-dim, #888); display: flex; align-items: center; gap: var(--space-2, 8px); flex-wrap: wrap; }
.awh-sub a { color: inherit; text-decoration: none; border-bottom: 1px dotted currentColor; }
.awh-sub a:hover { color: var(--ink, #e8e8e8); }
.awh-ready { display: inline-flex; align-items: center; gap: 5px; font-size: var(--text-2xs, .6875rem); font-weight: 600; padding: 2px 8px; border-radius: var(--radius-pill, 999px); border: 1px solid transparent; }
.awh-ready::before { content: ''; width: 7px; height: 7px; border-radius: 50%; flex: none; }
.awh-ready[data-state="ready"] { color: var(--success, #4ade80); background: color-mix(in srgb, var(--success, #4ade80) 14%, transparent); border-color: color-mix(in srgb, var(--success, #4ade80) 35%, transparent); }
.awh-ready[data-state="ready"]::before { background: var(--success, #4ade80); box-shadow: 0 0 6px color-mix(in srgb, var(--success,#4ade80) 60%, transparent); }
.awh-ready[data-state="preparing"] { color: var(--warn, #fbbf24); background: color-mix(in srgb, var(--warn, #fbbf24) 12%, transparent); border-color: color-mix(in srgb, var(--warn, #fbbf24) 32%, transparent); }
.awh-ready[data-state="preparing"]::before { background: var(--warn, #fbbf24); animation: awh-pulse 1.3s ease-in-out infinite; }
.awh-net { margin-left: auto; display: inline-flex; align-items: center; gap: 6px; font-size: var(--text-sm, .764rem); color: var(--ink-dim, #888); }
.awh-net select { font: inherit; color: var(--ink, #e8e8e8); background: var(--surface-1, rgba(255,255,255,.03)); border: 1px solid var(--stroke, rgba(255,255,255,.08)); border-radius: var(--radius-sm, 6px); padding: 4px 8px; cursor: pointer; }
.awh-net select:focus-visible { outline: var(--focus-ring-width, 2px) solid var(--focus-ring-color, #fff); outline-offset: var(--focus-ring-offset, 2px); }

.awh-tabs { display: flex; gap: 2px; overflow-x: auto; scrollbar-width: thin; border-bottom: 1px solid var(--stroke, rgba(255,255,255,.08)); padding-bottom: 0; -webkit-overflow-scrolling: touch; }
.awh-tab { appearance: none; font: inherit; font-size: var(--text-md, .8125rem); font-weight: 500; color: var(--ink-dim, #888); background: transparent; border: none; border-bottom: 2px solid transparent; padding: 10px 14px; cursor: pointer; white-space: nowrap; transition: color var(--duration-fast, 140ms) var(--ease-standard, ease), border-color var(--duration-fast, 140ms) var(--ease-standard, ease), background var(--duration-fast, 140ms) var(--ease-standard, ease); border-radius: var(--radius-sm, 6px) var(--radius-sm, 6px) 0 0; }
.awh-tab:hover { color: var(--ink, #e8e8e8); background: var(--surface-1, rgba(255,255,255,.03)); }
.awh-tab:active { color: var(--ink-bright, #fff); background: var(--surface-2, rgba(255,255,255,.05)); }
.awh-tab[aria-selected="true"] { color: var(--ink-bright, #fff); border-bottom-color: var(--accent, #fff); }
.awh-tab:focus-visible { outline: var(--focus-ring-width, 2px) solid var(--focus-ring-color, #fff); outline-offset: -2px; }

.awh-panel { animation: awh-fade var(--duration-base, 220ms) var(--ease-out, ease); }
.awh-panel[hidden] { display: none; }

/* Shared card + control vocabulary for tabs to reuse. */
.awh-card { border: 1px solid var(--stroke, rgba(255,255,255,.08)); border-radius: var(--radius-lg, 14px); background: var(--surface-1, rgba(255,255,255,.03)); padding: var(--space-4, 16px) var(--space-5, 20px); }
.awh-card + .awh-card { margin-top: var(--awh-gap); }
.awh-card-h { font-size: var(--text-2xs, .6875rem); text-transform: uppercase; letter-spacing: .06em; color: var(--ink-dim, #888); margin: 0 0 var(--space-3, 12px); display: flex; align-items: center; gap: 8px; }
.awh-btn { appearance: none; font: inherit; font-size: var(--text-md, .8125rem); color: var(--ink, #e8e8e8); background: var(--surface-2, rgba(255,255,255,.05)); border: 1px solid var(--stroke, rgba(255,255,255,.08)); border-radius: var(--radius-md, 10px); padding: 8px 14px; cursor: pointer; transition: background var(--duration-fast,140ms), border-color var(--duration-fast,140ms), transform var(--duration-instant,80ms); }
.awh-btn:hover:not(:disabled) { background: var(--surface-3, rgba(255,255,255,.08)); border-color: var(--stroke-strong, rgba(255,255,255,.14)); }
.awh-btn:active:not(:disabled) { transform: translateY(1px); }
.awh-btn:focus-visible { outline: var(--focus-ring-width,2px) solid var(--focus-ring-color,#fff); outline-offset: var(--focus-ring-offset,2px); }
.awh-btn:disabled { opacity: var(--disabled-opacity, .4); cursor: var(--disabled-cursor, not-allowed); }
.awh-btn--primary { background: var(--accent, #fff); color: #0a0a0a; border-color: var(--accent, #fff); font-weight: 600; }
.awh-btn--primary:hover:not(:disabled) { background: color-mix(in srgb, var(--accent,#fff) 88%, #000); }
.awh-btn--danger { background: color-mix(in srgb, var(--danger,#ef4444) 14%, transparent); color: var(--danger,#ef4444); border-color: color-mix(in srgb, var(--danger,#ef4444) 40%, transparent); font-weight: 600; }
.awh-btn--danger:hover:not(:disabled) { background: color-mix(in srgb, var(--danger,#ef4444) 22%, transparent); border-color: color-mix(in srgb, var(--danger,#ef4444) 60%, transparent); }
.awh-freeze-card { margin-bottom: var(--space-3,12px); }
.awh-freeze-card.is-frozen { border-color: color-mix(in srgb, var(--danger,#ef4444) 45%, transparent); background: color-mix(in srgb, var(--danger,#ef4444) 8%, transparent); }
.awh-freeze-row { display: flex; align-items: center; gap: var(--space-3,12px); justify-content: space-between; flex-wrap: wrap; }
.awh-freeze-copy { display: flex; flex-direction: column; gap: 2px; min-width: 0; }
.awh-freeze-copy strong { font-size: var(--text-md,.8125rem); color: var(--ink-bright,#fff); }
.awh-freeze-copy span { font-size: var(--text-sm,.764rem); color: var(--ink-dim,#888); line-height: 1.45; }
.awh-freeze-row .awh-btn { flex: 0 0 auto; }
.awh-warn-irrev { margin-top: var(--space-3,12px); padding: 9px 12px; border-radius: var(--radius-md,10px); font-size: var(--text-sm,.764rem); line-height: 1.45; color: var(--warn,#fbbf24); background: color-mix(in srgb, var(--warn,#fbbf24) 9%, transparent); border: 1px solid color-mix(in srgb, var(--warn,#fbbf24) 28%, transparent); }
.awh-dest-tag { display: inline-block; margin-left: 8px; font-size: var(--text-2xs,.6875rem); font-weight: 600; padding: 2px 8px; border-radius: var(--radius-pill,999px); white-space: nowrap; }
.awh-dest-tag.ok { color: var(--ok,#34d399); background: color-mix(in srgb, var(--ok,#34d399) 14%, transparent); border: 1px solid color-mix(in srgb, var(--ok,#34d399) 34%, transparent); }
.awh-dest-tag.warn { color: var(--danger,#ef4444); background: color-mix(in srgb, var(--danger,#ef4444) 12%, transparent); border: 1px solid color-mix(in srgb, var(--danger,#ef4444) 34%, transparent); }
.awh-mono { font-family: var(--font-mono, ui-monospace, monospace); }
.awh-empty { color: var(--ink-dim, #888); font-size: var(--text-sm, .764rem); padding: var(--space-3,12px) 0; }
/* Tab mount-failure fallback — a designed, recoverable error state (never a dead end). */
.awh-tab-error { border-color: color-mix(in srgb, var(--danger,#ef4444) 34%, transparent); background: color-mix(in srgb, var(--danger,#ef4444) 7%, transparent); }
.awh-tab-error-h { display: flex; align-items: center; gap: 8px; margin: 0 0 6px; font-size: var(--text-md,.8125rem); font-weight: 600; color: var(--ink-bright,#fff); }
.awh-tab-error-h::before { content: ''; width: 8px; height: 8px; border-radius: 50%; flex: none; background: var(--danger,#ef4444); box-shadow: 0 0 6px color-mix(in srgb, var(--danger,#ef4444) 55%, transparent); }
.awh-tab-error p.awh-empty { margin: 0 0 var(--space-3,12px); padding: 0; line-height: 1.5; }
/* Shared address-row + explorer-link primitives. Defined at the hub level (not in
 * a single tab's lazily-injected sheet) so every tab that reuses them — balance,
 * pay, trade — is styled regardless of which tab mounts first. */
.awh-bal-addr { display: flex; align-items: center; gap: var(--space-2,8px); margin-top: var(--space-4,16px); flex-wrap: wrap; }
.awh-bal-addr .awh-mono { font-size: var(--text-sm,.764rem); color: var(--ink,#e8e8e8); background: var(--surface-2, rgba(255,255,255,.05)); padding: 6px 9px; border-radius: var(--radius-sm,6px); border: 1px solid var(--stroke, rgba(255,255,255,.08)); }
.awh-bal-mini { padding: 6px 10px; font-size: var(--text-sm,.764rem); text-decoration: none; }
.awh-act-sig { color: var(--ink,#e8e8e8); text-decoration: none; }
.awh-act-sig:hover { text-decoration: underline; }

.awh-toast { position: fixed; left: 50%; bottom: 24px; transform: translateX(-50%) translateY(8px); background: var(--bg-1, #1a1a1a); color: var(--ink-bright,#fff); border: 1px solid var(--stroke-strong, rgba(255,255,255,.14)); border-radius: var(--radius-md,10px); padding: 10px 16px; font-size: var(--text-md,.8125rem); box-shadow: var(--shadow-3, 0 8px 32px rgba(0,0,0,.5)); opacity: 0; pointer-events: none; transition: opacity var(--duration-base,220ms), transform var(--duration-base,220ms); z-index: 9999; }
.awh-toast[data-show="true"] { opacity: 1; transform: translateX(-50%) translateY(0); }

@keyframes awh-fade { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: none; } }
@keyframes awh-pulse { 0%,100% { opacity: 1; } 50% { opacity: .35; } }
@media (prefers-reduced-motion: reduce) { .awh-panel, .awh-ready[data-state="preparing"]::before, .awh-toast { animation: none; transition: none; } }

@media (max-width: 520px) {
	.awh-name { max-width: 60vw; }
	.awh-net { margin-left: 0; flex-basis: 100%; }
	.awh-tab { padding: 10px 11px; font-size: var(--text-sm,.764rem); }
}
`;

function injectStyle() {
	if (typeof document === 'undefined' || document.getElementById(STYLE_ID)) return;
	const tag = document.createElement('style');
	tag.id = STYLE_ID;
	tag.textContent = STYLE;
	document.head.appendChild(tag);
}

/**
 * Mount the Agent Wallet hub into a container.
 *
 * @param {object} opts
 * @param {HTMLElement} opts.mount        — container element
 * @param {object} opts.agent             — agent record (id, name, avatar_*, walletReady, solana_address, is_owner)
 * @param {string} [opts.initialTab]      — tab id to open first (defaults to URL hash or 'balance')
 * @param {(net: string) => void} [opts.onNetworkChange]
 * @returns {{ destroy: () => void, refresh: () => void, openTab: (id: string) => void }}
 */
export function mountAgentWalletHub({ mount, agent, initialTab, onNetworkChange } = {}) {
	if (!mount || !agent?.id) {
		throw new Error('mountAgentWalletHub requires { mount, agent.id }');
	}
	injectStyle();

	const isOwner = !!(agent.is_owner ?? agent.isOwner);
	let network = 'mainnet';
	const networkListeners = new Set();
	if (typeof onNetworkChange === 'function') networkListeners.add(onNetworkChange);

	// Shared context handed to every tab — the only surface tabs depend on.
	const ctx = {
		agentId: agent.id,
		agent,
		isOwner,
		get network() {
			return network;
		},
		getNetwork: () => network,
		onNetworkChange: (fn) => {
			if (typeof fn === 'function') networkListeners.add(fn);
			return () => networkListeners.delete(fn);
		},
		// Lets a tab hand off to another (e.g. Trade → Deposit on insufficient funds).
		openTab: (id) => openTab(id),
		escapeHtml,
		shortAddress,
		copyToClipboard,
		toast,
	};

	const tabs = getVisibleTabs(isOwner);
	const validIds = new Set(tabs.map((t) => t.id));
	const hashTab = (location.hash || '').replace(/^#/, '');
	let activeId =
		(initialTab && validIds.has(initialTab) && initialTab) ||
		(validIds.has(hashTab) && hashTab) ||
		(tabs[0]?.id ?? null);

	const ready = !!(agent.walletReady ?? agent.wallet_ready);
	const profileUrl = agent.home_url || `/agents/${agent.id}`;

	mount.innerHTML = `
		<section class="awh" aria-label="Agent wallet">
			<div class="awh-header">
				${
					agent.avatar_thumbnail_url || agent.avatar_model_url
						? `<img class="awh-avatar" src="${escapeHtml(agent.avatar_thumbnail_url || '')}" alt="" loading="lazy" data-fallback="remove" />`
						: '<div class="awh-avatar" aria-hidden="true"></div>'
				}
				<div class="awh-id">
					<h1 class="awh-name" title="${escapeHtml(agent.name || 'Agent')}">${escapeHtml(agent.name || 'Agent')} wallet</h1>
					<div class="awh-sub">
						<span class="awh-ready" data-state="${ready ? 'ready' : 'preparing'}" role="status">
							${ready ? 'Wallet ready' : 'Preparing wallet…'}
						</span>
						<a href="${escapeHtml(profileUrl)}">View agent profile</a>
					</div>
				</div>
				<label class="awh-net">
					Network
					<select data-awh="network" aria-label="Solana network">
						<option value="mainnet">Mainnet</option>
						<option value="devnet">Devnet</option>
					</select>
				</label>
			</div>

			<div class="awh-tabs" role="tablist" aria-label="Wallet sections">
				${tabs
					.map(
						(t) => `
					<button class="awh-tab" role="tab" type="button"
						id="awh-tab-${escapeHtml(t.id)}"
						data-awh-tab="${escapeHtml(t.id)}"
						aria-controls="awh-panel-${escapeHtml(t.id)}"
						aria-selected="${t.id === activeId ? 'true' : 'false'}"
						tabindex="${t.id === activeId ? '0' : '-1'}">${escapeHtml(t.label)}</button>`,
					)
					.join('')}
			</div>

			${tabs
				.map(
					(t) => `
				<div class="awh-panel" role="tabpanel"
					id="awh-panel-${escapeHtml(t.id)}"
					aria-labelledby="awh-tab-${escapeHtml(t.id)}"
					data-awh-panel="${escapeHtml(t.id)}"
					${t.id === activeId ? '' : 'hidden'}></div>`,
				)
				.join('')}
		</section>
	`;

	const netSelect = mount.querySelector('[data-awh="network"]');
	const tabButtons = [...mount.querySelectorAll('[data-awh-tab]')];
	const panelFor = (id) => mount.querySelector(`[data-awh-panel="${CSS.escape(id)}"]`);

	// Panels are created once and shown/hidden via [hidden], so the awh-fade
	// animation only fires on first paint. Replay it on each tab switch so a
	// section enters with intent — honouring prefers-reduced-motion live.
	const reduceMotionMq =
		typeof matchMedia === 'function' ? matchMedia('(prefers-reduced-motion: reduce)') : null;
	function playPanelIn(panel) {
		if (!panel || reduceMotionMq?.matches) return;
		panel.style.animation = 'none';
		void panel.offsetWidth; // force reflow so the re-added animation restarts
		panel.style.animation = '';
	}

	// Lazy-mount each tab on first activation; keep the instance so onShow/onHide
	// and destroy can fire. A tab mount that throws degrades to an inline error
	// rather than breaking the whole hub.
	const instances = new Map();
	function ensureMounted(id) {
		if (instances.has(id)) return instances.get(id);
		const panel = panelFor(id);
		const def = tabs.find((t) => t.id === id);
		if (!panel || !def) return null;
		let inst = null;
		try {
			inst = def.mount({ panel, ctx }) || {};
		} catch (err) {
			console.error(`[agent-wallet-hub] tab "${id}" failed to mount`, err);
			const label = def.label || 'this section';
			panel.innerHTML = `
				<div class="awh-card awh-tab-error" role="alert">
					<p class="awh-tab-error-h">Couldn't load ${escapeHtml(label)}</p>
					<p class="awh-empty">Something went wrong opening this section. It's usually temporary — try again, and if it keeps failing, reload the page.</p>
					<button class="awh-btn awh-btn--primary" type="button" data-awh-retry="${escapeHtml(id)}">Retry</button>
				</div>`;
			panel.querySelector('[data-awh-retry]')?.addEventListener('click', () => {
				instances.delete(id);
				ensureMounted(id);
				const fresh = instances.get(id);
				fresh?.onShow?.();
				// Move focus into the freshly-mounted content so keyboard/AT users
				// aren't stranded on a button that just replaced itself.
				const target =
					panel.querySelector(
						'button:not([data-awh-retry]), a[href], input, select, textarea, [tabindex]:not([tabindex="-1"])',
					) || panel.querySelector('[data-awh-retry]');
				target?.focus?.();
			});
			inst = {};
		}
		instances.set(id, inst);
		return inst;
	}

	function openTab(id) {
		if (!validIds.has(id) || id === activeId) {
			// still ensure the requested (or current) tab is mounted + shown
			if (validIds.has(id)) {
				ensureMounted(id)?.onShow?.();
			}
			return;
		}
		const prev = activeId;
		activeId = id;
		for (const btn of tabButtons) {
			const on = btn.dataset.awhTab === id;
			btn.setAttribute('aria-selected', on ? 'true' : 'false');
			btn.tabIndex = on ? 0 : -1;
		}
		for (const t of tabs) {
			const panel = panelFor(t.id);
			if (panel) panel.hidden = t.id !== id;
		}
		if (prev && instances.has(prev)) instances.get(prev)?.onHide?.();
		ensureMounted(id)?.onShow?.();
		playPanelIn(panelFor(id));
		try {
			history.replaceState(null, '', `#${id}`);
		} catch {
			/* hash update best-effort */
		}
	}

	// Tab strip interactions: click + full roving-tabindex keyboard nav.
	for (const btn of tabButtons) {
		btn.addEventListener('click', () => openTab(btn.dataset.awhTab));
	}
	mount.querySelector('.awh-tabs')?.addEventListener('keydown', (e) => {
		const idx = tabButtons.findIndex((b) => b.dataset.awhTab === activeId);
		if (idx < 0) return;
		let next = -1;
		if (e.key === 'ArrowRight') next = (idx + 1) % tabButtons.length;
		else if (e.key === 'ArrowLeft') next = (idx - 1 + tabButtons.length) % tabButtons.length;
		else if (e.key === 'Home') next = 0;
		else if (e.key === 'End') next = tabButtons.length - 1;
		if (next < 0) return;
		e.preventDefault();
		const btn = tabButtons[next];
		openTab(btn.dataset.awhTab);
		btn.focus();
	});

	netSelect?.addEventListener('change', () => {
		network = netSelect.value === 'devnet' ? 'devnet' : 'mainnet';
		for (const fn of networkListeners) {
			try {
				fn(network);
			} catch (err) {
				console.error('[agent-wallet-hub] network listener failed', err);
			}
		}
	});

	// Mount + show the initial tab.
	if (activeId) ensureMounted(activeId)?.onShow?.();

	function destroy() {
		for (const inst of instances.values()) {
			try {
				inst?.destroy?.();
			} catch {
				/* tab teardown best-effort */
			}
		}
		instances.clear();
		networkListeners.clear();
		mount.innerHTML = '';
	}

	return {
		destroy,
		openTab,
		refresh: () => instances.get(activeId)?.onShow?.(),
	};
}