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
fix(wallet): stop showing a live, tradeable balance on a wallet production cannot sign for
nirholas9b409193e3c8
diff --git a/data/changelog.json b/data/changelog.jsonindex 4dbca3078..76f9eaed0 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,15 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-09-17",+ "title": "Agent wallets that cannot sign no longer look tradeable",+ "summary": "A small number of agent wallets hold a balance that three.ws cannot currently sign for. Their Portfolio tab used to show a live net worth with Trade buttons, and the Trade tab showed a working form, so the first sign of trouble was a failed withdrawal. Portfolio and Trade now say up front that trading and withdrawals are paused for that wallet, hide the actions that cannot work, and link straight to support. The explanation is also clearer: the balance has not moved, it is still on chain at the same address, and you should not create a replacement wallet while access is being restored.",+ "tags": [+ "fix"+ ],+ "link": "/agents"+ },{"date": "2026-09-17","title": "Ask your AI assistant to show the picture inside a Solana transaction",diff --git a/src/agent-wallet-hub/tabs/portfolio.js b/src/agent-wallet-hub/tabs/portfolio.jsindex 51bed5b30..5b1525649 100644--- a/src/agent-wallet-hub/tabs/portfolio.js+++ b/src/agent-wallet-hub/tabs/portfolio.js@@ -17,7 +17,7 @@*/import { registerWalletTab } from '../registry.js';-import { formatSol, formatUsd } from '../util.js';+import { formatSol, formatUsd, unsignableWalletCopy } from '../util.js';const PORT_STYLE_ID = 'awh-portfolio-style';const PORT_STYLE = `@@ -56,6 +56,11 @@ const PORT_STYLE = `.awh-paused:hover { background: color-mix(in srgb, var(--warn,#fbbf24) 20%, transparent); }.awh-paused:focus-visible { outline: var(--focus-ring-width,2px) solid var(--focus-ring-color,#fff); outline-offset: 2px; }+.awh-port-locked { border-color: color-mix(in srgb, var(--warn,#fbbf24) 35%, transparent); background: color-mix(in srgb, var(--warn,#fbbf24) 8%, var(--surface-1, rgba(255,255,255,.03))); }+.awh-port-locked strong { color: var(--warn,#fbbf24); }+.awh-port-locked p { margin: 6px 0 0; color: var(--ink-dim,#aaa); font-size: var(--text-sm,.764rem); line-height: 1.5; }+.awh-port-locked .row { display: flex; gap: 8px; flex-wrap: wrap; margin-top: 12px; }+.awh-port-locked a.awh-btn { text-decoration: none; }.awh-port-table { width: 100%; border-collapse: collapse; font-size: var(--text-sm,.764rem); }.awh-port-table th { text-align: right; font-weight: 500; color: var(--ink-dim,#888); font-size: var(--text-2xs,.6875rem); text-transform: uppercase; letter-spacing: .04em; padding: 0 0 8px; border-bottom: 1px solid var(--stroke, rgba(255,255,255,.08)); }.awh-port-table th:first-child { text-align: left; }@@ -214,6 +219,10 @@ registerWalletTab({live: false,streamDown: false, // SSE permanently closed → live updates pausedanimated: false, // entrance animation plays once, not on every live tick+ // null until the owner wallet read answers; false only on a definite+ // "production cannot sign for this address", which hides trade actions.+ signable: null,+ signableReason: null,};function pushSpark(usd) {@@ -262,6 +271,7 @@ registerWalletTab({}panel.innerHTML = `+ ${renderLocked()}${renderHeader(d)}${renderHoldings(d)}${renderAttribution(d)}@@ -274,6 +284,19 @@ registerWalletTab({wire();}+ // A balance that cannot be moved must never read as a live, tradeable one.+ function renderLocked() {+ if (state.signable !== false) return '';+ return `<div class="awh-card awh-port-locked" role="status">+ <strong>Trading and withdrawals are paused for this wallet.</strong>+ <p>${escapeHtml(unsignableWalletCopy(state.signableReason))}</p>+ <div class="row">+ <a class="awh-btn awh-port-trade" href="/support?topic=wallet-key&agent=${encodeURIComponent(ctx.agentId)}">Contact support</a>+ <button class="awh-btn awh-port-trade" type="button" data-go="withdraw">Details</button>+ </div>+ </div>`;+ }+function renderHeader(d) {const nw = d.net_worth || {};const realized = nw.realized_pnl_sol ?? 0;@@ -359,7 +382,7 @@ registerWalletTab({upnl = `<span class="${pnlClass(h.unrealized_sol)}">${escapeHtml(fmtSolSigned(h.unrealized_sol))}${pct}</span>`;}const warn = h.liquidity_warning ? `<span class="awh-port-warn" title="No live market price — value shown is unknown, never guessed.">illiquid</span>` : '';- const tradeBtn = h.isNative+ const tradeBtn = h.isNative || state.signable === false? '': `<button class="awh-btn awh-port-trade" type="button" data-trade="${escapeHtml(h.mint || '')}" aria-label="Trade ${sym}">Trade ↗</button>`;return `<tr>@@ -463,6 +486,7 @@ registerWalletTab({}function wire() {+ panel.querySelectorAll('[data-go]').forEach((b) => b.addEventListener('click', () => ctx.openTab(b.dataset.go)));panel.querySelector('[data-act="resume"]')?.addEventListener('click', () => {state.streamDown = false;render();@@ -490,7 +514,23 @@ registerWalletTab({return j.data;}+ async function loadSignable() {+ try {+ const r = await fetch(`/api/agents/${encodeURIComponent(ctx.agentId)}/solana?network=${encodeURIComponent(ctx.getNetwork())}`, { credentials: 'include' });+ if (!r.ok) return;+ const j = await r.json();+ const data = j?.data ?? j;+ if (destroyed || typeof data?.signable !== 'boolean') return;+ state.signable = data.signable;+ state.signableReason = data.signable ? null : (data.signable_reason || null);+ if (state.loaded) render();+ } catch {+ // Signability is advisory here; the withdraw and trade endpoints enforce it server-side.+ }+ }+async function reload() {+ loadSignable();state.loaded = false;state.error = null;render();diff --git a/src/agent-wallet-hub/tabs/trade.js b/src/agent-wallet-hub/tabs/trade.jsindex 27179d99f..22e210e75 100644--- a/src/agent-wallet-hub/tabs/trade.js+++ b/src/agent-wallet-hub/tabs/trade.js@@ -26,7 +26,7 @@ import {import { createSafetyPanel } from '../../shared/safety-panel.js';import { ensureRiskAck } from '../../shared/risk-ack.js';import { solToUsd } from '../../shared/usd-price.js';-import { formatSol, timeAgo, explorerTxUrl } from '../util.js';+import { formatSol, timeAgo, explorerTxUrl, unsignableWalletCopy } from '../util.js';const QUOTE_DEBOUNCE_MS = 450;const BUY_HEADROOM_SOL = 0.003; // keep fee+rent headroom out of "Max"@@ -246,8 +246,34 @@ registerWalletTab({historyError: null,historyLoaded: false,solPrice: null,+ signable: null, // false only on a definite "production cannot sign for this address"+ signableReason: null,};+ async function loadSignable() {+ if (!state.isOwner) return;+ try {+ const r = await fetch(`/api/agents/${encodeURIComponent(ctx.agentId)}/solana?network=${encodeURIComponent(ctx.getNetwork())}`, { credentials: 'include' });+ if (!r.ok) return;+ const j = await r.json();+ const data = j?.data ?? j;+ if (typeof data?.signable !== 'boolean') return;+ state.signable = data.signable;+ state.signableReason = data.signable ? null : (data.signable_reason || null);+ } catch {+ // Advisory only: the trade endpoint still refuses an unsignable wallet server-side.+ }+ }++ function lockedCardHtml() {+ return `<div class="awh-card">+ <div class="awh-tr-banner awh-tr-banner--warn" role="status">+ <span><strong>Trading is paused for this wallet.</strong> ${esc(unsignableWalletCopy(state.signableReason))}+ <a href="/support?topic=wallet-key&agent=${encodeURIComponent(ctx.agentId)}">Contact support</a></span>+ </div>+ </div>`;+ }+// ── data loads ────────────────────────────────────────────────────────async function loadHoldings() {try {@@ -444,7 +470,7 @@ registerWalletTab({}panel.innerHTML = `<div class="awh-tr">- ${state.isOwner ? tradeCardHtml() : visitorBannerHtml()}+ ${!state.isOwner ? visitorBannerHtml() : state.signable === false ? lockedCardHtml() : tradeCardHtml()}${holdingsCardHtml()}${historyCardHtml()}</div>`;@@ -935,7 +961,7 @@ registerWalletTab({if (firstShow) {firstShow = false;loadSolPrice();- await Promise.all([loadHoldings(), loadHistory()]);+ await Promise.all([loadHoldings(), loadHistory(), loadSignable()]);if (!destroyed) renderAll();}},diff --git a/src/agent-wallet-hub/tabs/withdraw.js b/src/agent-wallet-hub/tabs/withdraw.jsindex 0d95ccd8a..bc98a681b 100644--- a/src/agent-wallet-hub/tabs/withdraw.js+++ b/src/agent-wallet-hub/tabs/withdraw.js@@ -19,7 +19,7 @@*/import { registerWalletTab } from '../registry.js';-import { formatUsd, explorerTxUrl } from '../util.js';+import { formatUsd, explorerTxUrl, unsignableWalletCopy } from '../util.js';import { consumeCsrfToken } from '../../api.js';import { ensureRiskAck } from '../../shared/risk-ack.js';@@ -269,20 +269,17 @@ registerWalletTab({return `<div class="awh-card"><div class="awh-err" role="alert" style="margin-bottom:0;">- <strong>This wallet can no longer be signed for.</strong>+ <strong>Withdrawals from this wallet are paused.</strong><div class="why" style="text-transform:none; margin-top:6px; line-height:1.5;">- ${retired- ? 'It was created under an earlier encryption key that the platform no longer holds, so withdrawals and trades from this address cannot be authorised. The balance is real and still on chain, it simply cannot be moved from here. Retrying will not help.'- : 'The stored key for this address could not be read. Withdrawals are blocked until that is resolved so nothing is attempted against a wallet we cannot authorise.'}+ ${esc(unsignableWalletCopy(state.signableReason))}</div></div><p class="awh-note" style="margin-top:12px;">- Contact support with this agent id before provisioning a replacement wallet:- a new wallet gets a new address, and the balance at the old one stays where it is.+ Contact support with this agent id so we can tell you when access is restored.</p><div class="awh-chips" style="margin-top:12px;"><span class="awh-chip">Agent ${esc(String(ctx.agentId).slice(0, 8))}</span>- <span class="awh-chip">${retired ? 'key retired' : 'key unreadable'}</span>+ <span class="awh-chip">${retired ? 'key sealed' : 'key unreadable'}</span></div><div class="awh-actions"><a class="awh-btn" href="/support?topic=wallet-key&agent=${encodeURIComponent(ctx.agentId)}">Contact support</a>diff --git a/src/agent-wallet-hub/util.js b/src/agent-wallet-hub/util.jsindex 9ca9dd6f1..668f30831 100644--- a/src/agent-wallet-hub/util.js+++ b/src/agent-wallet-hub/util.js@@ -117,3 +117,15 @@ export function explorerTxUrl(sig, network) {? `https://explorer.solana.com/tx/${sig}?cluster=devnet`: `https://solscan.io/tx/${sig}`;}++// Plain-language explanation for a wallet whose stored key production cannot open+// (`signable: false` on GET /api/agents/:id/solana). Shared so the Portfolio and+// Withdraw tabs never tell the owner two different stories about the same balance.+// `key_retired` wallets were sealed by a non-production server under a key the+// production signer does not hold; docs/ops/stranded-wallets.md has the recovery path.+export function unsignableWalletCopy(reason) {+ if (reason === 'key_retired') {+ return 'Its signing key was sealed under an encryption key our production signer does not hold, so withdrawals and trades cannot be authorised yet. Your balance has not moved and is still on chain at this address. We are recovering access; do not create a replacement wallet, since a new wallet gets a new address.';+ }+ return 'The stored key for this address could not be read, so withdrawals and trades are paused. Nothing is attempted against a wallet we cannot authorise, and your balance has not moved.';+}