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
test(trader-card): pin the card projection the embed endpoint serves
nirholasf4fcfa7dec79
diff --git a/tests/trader-card.test.js b/tests/trader-card.test.jsnew file mode 100644index 000000000..63d393576--- /dev/null+++ b/tests/trader-card.test.js@@ -0,0 +1,163 @@+/**+ * The embeddable trader card: model, links and snippet.+ *+ * This card renders on other people's pages, so the things worth pinning are the+ * ones that would be invisible to us and wrong for them: the payload must stay+ * small, every link must be absolute (a relative href on a stranger's domain+ * goes to their site, not ours), a referral code must survive into every link,+ * the return multiple must come from the realized percentage rather than exit+ * over entry, and the snippet handed to a leader must be paste-ready with no+ * placeholder left in it.+ */++import { describe, it, expect } from 'vitest';+import { buildTraderCard, cardLinks, multipleFromPct } from '../api/_lib/trader-card.js';+import { embedSnippet } from '../src/shared/trader-embed.js';++const AGENT = '6287faf3-d41b-43cb-97bb-d305c1ac6e45';++/** A `getTraderStats` result, trimmed to what the card projection reads. */+function stats({ closed = [], open = [], verified = true, name = 'Crosshair' } = {}) {+ return {+ agent: { id: AGENT, name, image: null, is_public: true, wallet: 'W', copiers: 4 },+ network: 'mainnet',+ window: '30d',+ sol_usd: 100,+ metrics: {+ score: 61, verified, closed_count: closed.length, wins: 1, losses: 1, win_rate: 0.5,+ realized_pnl_lamports: '0', realized_pnl_sol: 1.234567891, realized_pnl_usd: 123.4567,+ roi_pct: 12.3, best_pnl_pct: 237.38, max_drawdown_pct: 9.1, open_count: open.length,+ last_active_at: '2026-09-09T12:00:00.000Z',+ },+ closed,+ open,+ oracle: { total: 99 },+ projection: { anything: true },+ };+}++const closedTrade = (i, pct) => ({+ id: `c${i}`, mint: `MINT${i}`, symbol: `SYM${i}`, name: `Coin ${i}`,+ entry_sol: 0.5, exit_sol: 0.6, pnl_sol: 0.1, pnl_pct: pct,+ exit_reason: 'take_profit', opened_at: '2026-09-09T10:00:00.000Z', closed_at: '2026-09-09T11:00:00.000Z',+ buy_url: 'https://solscan.io/tx/buy', sell_url: 'https://solscan.io/tx/sell', moonbag_held: false,+});++describe('multipleFromPct', () => {+ it('derives the multiple from the realized percentage, not exit over entry', () => {+ expect(multipleFromPct(0)).toBe(1);+ expect(multipleFromPct(620)).toBe(7.2);+ expect(multipleFromPct(-100)).toBe(0);+ });++ it('returns null rather than 1 when there is no percentage', () => {+ expect(multipleFromPct(null)).toBeNull();+ expect(multipleFromPct('nope')).toBeNull();+ });+});++describe('cardLinks', () => {+ it('is absolute on every link, because the card runs on someone else origin', () => {+ const l = cardLinks({ agentId: AGENT, mint: 'MINT1', size: 0.5 });+ for (const url of Object.values(l)) {+ if (url) expect(url.startsWith('https://three.ws')).toBe(true);+ }+ });++ it('carries a referral code into every link it makes', () => {+ const l = cardLinks({ agentId: AGENT, mint: 'MINT1', ref: 'abc_123' });+ expect(l.profile).toContain('ref=abc_123');+ expect(l.ghost_copy).toContain('ref=abc_123');+ expect(l.fork).toContain('ref=abc_123');+ expect(l.site).toContain('ref=abc_123');+ });++ it('has no fork link without a mint to fork', () => {+ expect(cardLinks({ agentId: AGENT }).fork).toBeNull();+ });++ it('points ghost-copy at this leader and this window', () => {+ expect(cardLinks({ agentId: AGENT, window: '7d' }).ghost_copy)+ .toBe(`https://three.ws/ghost-copy?leader=${AGENT}&window=7d`);+ });+});++describe('buildTraderCard', () => {+ it('caps the payload at a few trades however long the record is', () => {+ const many = Array.from({ length: 400 }, (_, i) => closedTrade(i, 10));+ const card = buildTraderCard(stats({ closed: many }));+ expect(card.recent).toHaveLength(3);+ expect(card.stats.closed).toBe(400);+ expect(JSON.stringify(card).length).toBeLessThan(4000);+ });++ it('drops the heavy sections the profile carries', () => {+ const card = buildTraderCard(stats({ closed: [closedTrade(1, 10)] }));+ expect(card.oracle).toBeUndefined();+ expect(card.projection).toBeUndefined();+ expect(card.closed).toBeUndefined();+ });++ it('gives every listed trade a fork link', () => {+ const card = buildTraderCard(stats({+ closed: [closedTrade(1, 10)],+ open: [{ id: 'o1', mint: 'OPEN1', symbol: 'OPN', entry_sol: 0.25, current_sol: 0.5, unrealized_pct: 100, opened_at: '2026-09-09T11:30:00.000Z', buy_url: null }],+ }));+ expect(card.recent[0].fork_url).toContain('fork=MINT1');+ expect(card.open[0].fork_url).toContain('fork=OPEN1');+ expect(card.open[0].fork_url).toContain('fork_size=0.25');+ });++ it('reports the record from the shared metrics rather than recomputing it', () => {+ const card = buildTraderCard(stats({ closed: [closedTrade(1, 10)] }));+ expect(card.stats.score).toBe(61);+ expect(card.stats.win_rate).toBe(0.5);+ expect(card.stats.realized_pnl_sol).toBe(1.234568);+ expect(card.agent.verified).toBe(true);+ expect(card.agent.copiers).toBe(4);+ });++ it('keeps an unmeasured number null instead of rendering it as zero', () => {+ const s = stats({ closed: [] });+ s.metrics.realized_pnl_usd = null;+ s.metrics.win_rate = null;+ const card = buildTraderCard(s);+ expect(card.stats.realized_pnl_usd).toBeNull();+ expect(card.stats.win_rate).toBeNull();+ expect(card.recent).toEqual([]);+ });++ it('returns null for a missing trader rather than an empty card', () => {+ expect(buildTraderCard(null)).toBeNull();+ expect(buildTraderCard({})).toBeNull();+ });+});++describe('embedSnippet', () => {+ it('is paste-ready with no placeholder left in it', () => {+ const out = embedSnippet({ agentId: AGENT });+ expect(out).toContain('src="https://three.ws/trader-card/element.js"');+ expect(out).toContain(`<trader-card agent="${AGENT}"></trader-card>`);+ expect(out).not.toMatch(/YOUR|<uuid>|\.\.\./);+ });++ it('writes only the attributes that are not already the default', () => {+ expect(embedSnippet({ agentId: AGENT, window: '30d' })).not.toContain('window=');+ expect(embedSnippet({ agentId: AGENT, window: 'all' })).toContain('window="all"');+ });++ it('carries a referral code and refuses one that is not a code', () => {+ expect(embedSnippet({ agentId: AGENT, ref: 'ab-1_2' })).toContain('ref="ab-1_2"');+ expect(embedSnippet({ agentId: AGENT, ref: '"onerror=alert(1)' })).not.toContain('ref=');+ });++ it('returns null rather than a snippet nobody should paste', () => {+ expect(embedSnippet({ agentId: 'not-a-uuid' })).toBeNull();+ expect(embedSnippet({})).toBeNull();+ });++ it('honours a self-hosted origin without doubling the slash', () => {+ expect(embedSnippet({ agentId: AGENT, origin: 'https://example.test/' }))+ .toContain('src="https://example.test/trader-card/element.js"');+ });+});