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
feat(onchain): add Solana transaction v1 deploy flow
nirholase51da5436ba4
diff --git a/api/_lib/solana/transaction-v1.js b/api/_lib/solana/transaction-v1.jsindex 08fe68238..8079f9476 100644--- a/api/_lib/solana/transaction-v1.js+++ b/api/_lib/solana/transaction-v1.js@@ -1,3 +1,13 @@+/**+ * Solana transaction-v1 builder bridge.+ *+ * Metaplex Umi exposes the instructions and signers needed to create a Core+ * asset, but its transaction factory currently emits v0. This module converts+ * those Umi-shaped instructions to @solana/kit and compiles the v1 envelope.+ * The server-owned asset/collection keys sign here; the owner's wallet slot is+ * intentionally left empty for Wallet Standard to sign in the browser.+ */+import {COMPUTE_BUDGET_PROGRAM_ADDRESS,ComputeBudgetInstruction,@@ -9,17 +19,110 @@ import {MAX_COMPUTE_UNIT_LIMIT,} from '@solana-program/compute-budget';import {+ AccountRole,+ address,+ appendTransactionMessageInstructions,+ assertIsTransactionWithinSizeLimit,+ blockhash,+ compileTransaction,+ createTransactionMessage,decompileTransactionMessage,getBase64Encoder,getCompiledTransactionMessageDecoder,getTransactionDecoder,+ getTransactionEncoder,+ pipe,+ setTransactionMessageConfig,+ setTransactionMessageFeePayer,+ setTransactionMessageLifetimeUsingBlockhash,} from '@solana/kit';export const TX_V1_FEATURE_ADDRESS = 'txv1aq4pp281K9um3tnPgkfX8UqtFT6wcVW3hNezGLL';export const LEGACY_TRANSACTION_LIMIT = 1_232;export const V1_TRANSACTION_LIMIT = 4_096;+export const SOLANA_TRANSACTION_V1 = 1;const DEFAULT_COMPUTE_UNITS_PER_INSTRUCTION = 200_000;+// V1 has no implicit compute/data limits. These conservative limits cover a+// Metaplex Core create while bounding the resources a prepared tx may consume.+export const AGENT_DEPLOY_V1_CONFIG = Object.freeze({+ computeUnitLimit: 500_000,+ loadedAccountsDataSizeLimit: 8 * 1024 * 1024,+ priorityFeeLamports: 5_000n,+});++const COMPUTE_BUDGET_PROGRAM = 'ComputeBudget111111111111111111111111111111';++function accountRole(meta) {+ if (meta.isSigner) {+ return meta.isWritable ? AccountRole.WRITABLE_SIGNER : AccountRole.READONLY_SIGNER;+ }+ return meta.isWritable ? AccountRole.WRITABLE : AccountRole.READONLY;+}++export function toKitInstruction(instruction) {+ if (String(instruction.programId) === COMPUTE_BUDGET_PROGRAM) {+ throw new Error('v1 resource limits must use transactionConfig, not ComputeBudget instructions');+ }+ return {+ programAddress: address(String(instruction.programId)),+ accounts: instruction.keys.map((meta) => ({+ address: address(String(meta.pubkey)),+ role: accountRole(meta),+ })),+ data: instruction.data,+ };+}++/**+ * Build a partially signed v1 transaction from Umi instructions/signers.+ * @param {object} input+ * @param {Array<object>} input.instructions Umi-shaped instructions.+ * @param {Array<{publicKey: string, signMessage(bytes: Uint8Array): Promise<Uint8Array>}>} input.signers+ * @param {string} input.feePayer Owner wallet; deliberately not server-signed.+ * @param {{blockhash: string, lastValidBlockHeight: number|bigint}} input.lifetime+ * @param {object} [input.config]+ */+export async function buildPartiallySignedV1Transaction({+ instructions,+ signers = [],+ feePayer,+ lifetime,+ config = AGENT_DEPLOY_V1_CONFIG,+}) {+ const message = pipe(+ createTransactionMessage({ version: SOLANA_TRANSACTION_V1 }),+ (m) => setTransactionMessageFeePayer(address(feePayer), m),+ (m) =>+ setTransactionMessageLifetimeUsingBlockhash(+ {+ blockhash: blockhash(lifetime.blockhash),+ lastValidBlockHeight: BigInt(lifetime.lastValidBlockHeight),+ },+ m,+ ),+ (m) => appendTransactionMessageInstructions(instructions.map(toKitInstruction), m),+ (m) => setTransactionMessageConfig(config, m),+ );++ const transaction = compileTransaction(message);+ const signatures = { ...transaction.signatures };+ for (const signer of signers) {+ const signerAddress = String(signer.publicKey);+ // The wallet fee payer is represented by Umi's noop signer. Keep its+ // signature null so the browser wallet can fill it.+ if (signerAddress === feePayer || signatures[signerAddress] === undefined) continue;+ signatures[signerAddress] = await signer.signMessage(transaction.messageBytes);+ }++ const partiallySigned = Object.freeze({+ ...transaction,+ signatures: Object.freeze(signatures),+ });+ assertIsTransactionWithinSizeLimit(partiallySigned);+ return getTransactionEncoder().encode(partiallySigned);+}+function asSafeNumber(value) {if (value === undefined || value === null) return null;const n = Number(value);@@ -128,10 +231,7 @@ function sponsorAssessment(version, budget) {return { verdict: safeToCosign ? 'caps-explicit' : 'limits-missing', safeToCosign, notes };}-/**- * Decode a signed Solana wire transaction without contacting an RPC.- * Returns one stable, JSON-safe shape for legacy, V0, and V1.- */+/** Decode a signed Solana wire transaction into one JSON-safe shape. */export function inspectWireTransaction(base64Transaction) {const value = String(base64Transaction || '').trim();if (!value || value.length > 12_000 || !/^[A-Za-z0-9+/]+={0,2}$/.test(value)) {diff --git a/api/agents/onchain/[action].js b/api/agents/onchain/[action].jsindex 6f45079c0..760bf9464 100644--- a/api/agents/onchain/[action].js+++ b/api/agents/onchain/[action].js@@ -40,6 +40,10 @@ import {loadCollectionAuthorityKeypair,collectionAuthoritySigner,} from '../../_lib/solana-collection.js';+import {+ buildPartiallySignedV1Transaction,+ SOLANA_TRANSACTION_V1,+} from '../../_lib/solana/transaction-v1.js';import { pinToIPFS, ipfsPinningConfigured } from '../../_lib/ipfs-pin.js';export default wrap(async (req, res) => {@@ -93,6 +97,9 @@ const prepBodySchema = z.object({.array(z.string().regex(/^[a-z0-9-]{1,40}$/i)).max(16).optional(),+ // Solana v1 is opt-in because older wallets may only sign legacy/v0. The+ // client selects it only after reading the wallet-standard capability.+ transaction_version: z.union([z.literal(0), z.literal(1)]).optional(),});// Pin a manifest. Try the IPFS provider chain first (Pinata, then web3.storage,@@ -159,7 +166,7 @@ const SOLANA_PUBLIC_RPC = {devnet: 'https://api.devnet.solana.com',};-async function buildSolanaTx({ rpc, network, walletAddress, name, metadataUri, attributes, collectionAddr }) {+async function buildSolanaTx({ rpc, network, walletAddress, name, metadataUri, attributes, collectionAddr, transactionVersion = 0 }) {// Build through the multi-endpoint failover Connection rather than handing// umi a bare URL. umi's createUmi accepts a web3.js Connection directly, so// every RPC the build needs — chiefly getLatestBlockhash — rotates across the@@ -197,8 +204,18 @@ async function buildSolanaTx({ rpc, network, walletAddress, name, metadataUri, acreateArgs.authority = collectionAuthoritySigner(umi);}const builder = create(umi, createArgs);+ if (transactionVersion === SOLANA_TRANSACTION_V1) {+ const lifetime = await connection.getLatestBlockhash('confirmed');+ const txBytes = await buildPartiallySignedV1Transaction({+ instructions: builder.getInstructions(),+ signers: builder.getSigners(umi),+ feePayer: walletAddress,+ lifetime,+ });+ return { assetSigner, txBytes, transactionVersion: SOLANA_TRANSACTION_V1 };+ }const tx = await builder.buildAndSign(umi);- return { assetSigner, txBytes: umi.transactions.serialize(tx) };+ return { assetSigner, txBytes: umi.transactions.serialize(tx), transactionVersion: 0 };}function isRpcAuthError(err) {@@ -220,7 +237,7 @@ function isRpcMalformed(err) {return /StructError|failed to get recent blockhash|failed to get info about account|Unexpected (token|end of JSON)|invalid json response/i.test(msg);}-async function prepSolana({ cluster, metadataUri, walletAddress, name, attributes }) {+async function prepSolana({ cluster, metadataUri, walletAddress, name, attributes, transactionVersion = 0 }) {const configuredRpc =cluster === 'devnet'? process.env.SOLANA_RPC_URL_DEVNET || SOLANA_PUBLIC_RPC.devnet@@ -253,6 +270,7 @@ async function prepSolana({ cluster, metadataUri, walletAddress, name, attributemetadataUri,attributes,collectionAddr,+ transactionVersion,}));} catch (err) {if (isRpcRateLimited(err)) {@@ -289,6 +307,7 @@ async function prepSolana({ cluster, metadataUri, walletAddress, name, attributetxBase64: Buffer.from(txBytes).toString('base64'),metadataUri,collection: collectionAddr || null,+ transactionVersion,};}@@ -358,6 +377,7 @@ async function handlePrep(req, res) {walletAddress: body.wallet_address,name: body.name,attributes,+ transactionVersion: body.transaction_version || 0,});}} catch (e) {@@ -403,7 +423,12 @@ async function handlePrep(req, res) {skills: body.skills || [],...(chain.family === 'evm'? { contract_address: familyPrep.contractAddress }- : { asset_pubkey: familyPrep.assetPubkey, cluster: chain.cluster, collection: familyPrep.collection }),+ : {+ asset_pubkey: familyPrep.assetPubkey,+ cluster: chain.cluster,+ collection: familyPrep.collection,+ transaction_version: familyPrep.transactionVersion,+ }),})}::jsonb,${expiresAt})@@ -420,6 +445,7 @@ async function handlePrep(req, res) {assetPubkey: familyPrep.assetPubkey,txBase64: familyPrep.txBase64,cluster: chain.cluster,+ transactionVersion: familyPrep.transactionVersion,}),expiresAt: expiresAt.toISOString(),});diff --git a/package-lock.json b/package-lock.jsonindex 8e14f8e04..0b2922284 100644--- a/package-lock.json+++ b/package-lock.json@@ -148,6 +148,7 @@"@upstash/ratelimit": "^2.0.5","@upstash/redis": "^1.38.0","@vercel/og": "^0.11.1",+ "@wallet-standard/app": "^1.1.1","@walletconnect/ethereum-provider": "^2.24.0","@x402/axios": "^2.14.0","@x402/core": "^2.14.0",@@ -19839,20 +19840,24 @@}},"node_modules/@wallet-standard/app": {- "version": "1.1.0",+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/@wallet-standard/app/-/app-1.1.1.tgz",+ "integrity": "sha512-WDGwoByhP5gwHH01r5EaLgQdLVkACPCdOMQhmhn8rsm10h/siSgTorShzBxrn0ExSPof+Lu+C3TfgqBrPa1xoQ==","license": "Apache-2.0","dependencies": {- "@wallet-standard/base": "^1.1.0"+ "@wallet-standard/base": "^1.1.1"},"engines": {- "node": ">=16"+ "node": ">=22"}},"node_modules/@wallet-standard/base": {- "version": "1.1.0",+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/@wallet-standard/base/-/base-1.1.1.tgz",+ "integrity": "sha512-gggIHTtxicF9XFMQ12DkfS6NAG92Ak795JeSA7f2whAQ6Y3AkMWWuCMxSZXG2NIPN42kEaZSNVjqMsJRaJRxMQ==","license": "Apache-2.0","engines": {- "node": ">=16"+ "node": ">=22"}},"node_modules/@wallet-standard/core": {diff --git a/package.json b/package.jsonindex a15b7a714..a7f1db67f 100644--- a/package.json+++ b/package.json@@ -560,6 +560,7 @@"@upstash/ratelimit": "^2.0.5","@upstash/redis": "^1.38.0","@vercel/og": "^0.11.1",+ "@wallet-standard/app": "^1.1.1","@walletconnect/ethereum-provider": "^2.24.0","@x402/axios": "^2.14.0","@x402/core": "^2.14.0",diff --git a/public/onchain/index.html b/public/onchain/index.htmlnew file mode 100644index 000000000..8696c646a--- /dev/null+++ b/public/onchain/index.html@@ -0,0 +1,95 @@+<!doctype html>+<html lang="en">+<head>+ <meta charset="utf-8">+ <meta name="viewport" content="width=device-width, initial-scale=1">+ <meta name="description" content="Open files and messages stored in Solana transaction memos.">+ <title>Onchain viewer · three.ws</title>+ <style>+ :root { color-scheme: dark; font-family: Inter, ui-sans-serif, system-ui, sans-serif; background: #080a10; color: #f6f7fb; }+ * { box-sizing: border-box; }+ body { margin: 0; min-height: 100vh; background: radial-gradient(circle at 20% 0%, #1b2743 0, transparent 35rem), #080a10; }+ main { width: min(760px, calc(100% - 32px)); margin: 0 auto; padding: 64px 0; }+ a { color: #9cc8ff; } h1 { margin: 0 0 10px; font-size: clamp(2rem, 7vw, 3.5rem); letter-spacing: -.055em; }+ .lede { color: #b9c1d1; line-height: 1.55; margin: 0 0 30px; max-width: 54ch; }+ form, .card { background: #10141fdd; border: 1px solid #2a3346; border-radius: 18px; padding: 18px; box-shadow: 0 22px 70px #0006; }+ form { display: flex; gap: 10px; } input { min-width: 0; flex: 1; color: #f6f7fb; background: #080b12; border: 1px solid #34405a; border-radius: 10px; padding: 13px; font: inherit; }+ button { cursor: pointer; border: 0; border-radius: 10px; padding: 13px 17px; color: #06111e; background: #9cc8ff; font: 700 .95rem/1 inherit; } button.secondary { color: #dce7fb; background: #26334b; }+ #status { min-height: 1.5em; margin: 18px 2px; color: #b9c1d1; } .error { color: #ffb4b4 !important; }+ .card { display: none; } .card.visible { display: block; } .meta { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 12px; margin-bottom: 18px; } .meta div { color: #aeb8ca; font-size: .86rem; } .meta strong { display: block; color: #fff; overflow-wrap: anywhere; font-size: .95rem; margin-top: 3px; }+ .preview { display: grid; place-items: center; min-height: 180px; background: repeating-conic-gradient(#151b28 0 25%, #111722 0 50%) 50% / 22px 22px; border-radius: 12px; overflow: hidden; } .preview img { display: block; max-width: 100%; max-height: 520px; image-rendering: auto; }+ pre { overflow: auto; max-height: 360px; padding: 16px; background: #080b12; border-radius: 12px; white-space: pre-wrap; overflow-wrap: anywhere; } .actions { display: flex; gap: 10px; flex-wrap: wrap; margin-top: 16px; } .fine { font-size: .86rem; color: #aeb8ca; line-height: 1.5; }+ @media (max-width: 540px) { main { padding-top: 36px; } form { flex-direction: column; } .meta { grid-template-columns: 1fr; } }+ </style>+</head>+<body>+ <main>+ <h1>Onchain viewer</h1>+ <p class="lede">Paste a Solana transaction. If it contains a file or message in a Memo, we’ll show it here without copying an inscrutable data URI.</p>+ <form id="lookup">+ <input id="transaction" aria-label="Solana transaction signature or Solscan link" placeholder="Transaction signature or Solscan link" autocomplete="off" spellcheck="false">+ <button>Open</button>+ </form>+ <p id="status" role="status">Enter a transaction to begin.</p>+ <section class="card" id="result" aria-live="polite">+ <div class="meta" id="meta"></div>+ <div class="preview" id="preview"></div>+ <div class="actions" id="actions"></div>+ <p class="fine">This viewer reads public, signed transaction data directly from Solana. Treat unfamiliar files with the same care you would any internet download.</p>+ </section>+ </main>+ <script>+ const RPC = 'https://api.mainnet-beta.solana.com';+ const memoProgram = 'Memo4c2pN8afCj432Lb7RMVKi9PbQnnW7ewFFaV3oAH';+ const $ = (id) => document.getElementById(id);+ const signatureFrom = (value) => {+ const trimmed = value.trim();+ const match = trimmed.match(/(?:solscan\.io\/tx\/)?([1-9A-HJ-NP-Za-km-z]{80,100})/);+ return match ? match[1] : '';+ };+ const setStatus = (message, error = false) => { $('status').textContent = message; $('status').className = error ? 'error' : ''; };+ const escape = (value) => String(value).replace(/[&<>"']/g, (c) => ({ '&':'&', '<':'<', '>':'>', '"':'"', "'":''' })[c]);+ const formatTime = (seconds) => seconds ? new Intl.DateTimeFormat(undefined, { dateStyle: 'medium', timeStyle: 'short' }).format(new Date(seconds * 1000)) : 'Unavailable';+ function dataUriDetails(value) {+ const match = value.match(/^data:([a-z]+\/[a-z0-9+.-]+);base64,([a-z0-9+/=\s]+)$/i);+ if (!match) return null;+ const mime = match[1].toLowerCase();+ // Raster formats only: the data is displayed, never executed as a document.+ if (!['image/png', 'image/jpeg', 'image/gif', 'image/webp'].includes(mime)) return { unsupported: mime };+ try { return { mime, bytes: atob(match[2].replace(/\s/g, '')).length, uri: value }; } catch { return null; }+ }+ function render(signature, transaction, memo) {+ const detail = dataUriDetails(memo);+ $('result').classList.add('visible');+ const payer = transaction.transaction.message.accountKeys.find((key) => key.signer)?.pubkey || 'Unavailable';+ $('meta').innerHTML = `<div>Format<strong>${detail?.mime || (detail?.unsupported ? detail.unsupported + ' (not previewed)' : 'Text memo')}</strong></div><div>Written<strong>${formatTime(transaction.blockTime)}</strong></div><div>Signed by<strong>${escape(payer)}</strong></div><div>Transaction<strong><a target="_blank" rel="noopener" href="https://solscan.io/tx/${encodeURIComponent(signature)}">View on Solscan</a></strong></div>`;+ const preview = $('preview'); const actions = $('actions'); preview.replaceChildren(); actions.replaceChildren();+ if (detail?.uri) {+ const image = new Image(); image.src = detail.uri; image.alt = `Onchain ${detail.mime} (${detail.bytes.toLocaleString()} bytes)`; preview.append(image);+ const download = document.createElement('a'); download.href = detail.uri; download.download = `solana-memo-${signature.slice(0, 8)}.${detail.mime.split('/')[1]}`; download.textContent = 'Download file'; download.style.cssText = 'display:inline-block;padding:13px 17px;border-radius:10px;text-decoration:none;background:#26334b;color:#dce7fb'; actions.append(download);+ setStatus(`Found a ${detail.mime} image (${detail.bytes.toLocaleString()} bytes).`);+ } else {+ const text = document.createElement('pre'); text.textContent = memo; preview.append(text);+ const copy = document.createElement('button'); copy.type = 'button'; copy.className = 'secondary'; copy.textContent = 'Copy memo'; copy.onclick = async () => { await navigator.clipboard.writeText(memo); copy.textContent = 'Copied'; }; actions.append(copy);+ setStatus(detail?.unsupported ? `Found a ${detail.unsupported} payload. This viewer does not preview that format yet.` : 'Found a text memo.');+ }+ }+ async function lookup(event) {+ event?.preventDefault(); const signature = signatureFrom($('transaction').value);+ $('result').classList.remove('visible');+ if (!signature) return setStatus('Enter a valid Solana transaction signature or Solscan transaction link.', true);+ history.replaceState({}, '', `?tx=${encodeURIComponent(signature)}`); setStatus('Reading the signed transaction…');+ try {+ const response = await fetch(RPC, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'getTransaction', params: [signature, { encoding: 'jsonParsed', maxSupportedTransactionVersion: 1 }] }) });+ const payload = await response.json(); if (payload.error) throw new Error(payload.error.message); if (!payload.result) throw new Error('Transaction was not found on the Solana mainnet.');+ const instruction = payload.result.transaction.message.instructions.find((item) => item.programId === memoProgram && typeof item.parsed === 'string');+ if (!instruction) throw new Error('No readable Memo was found in this transaction.');+ render(signature, payload.result, instruction.parsed);+ } catch (error) { setStatus(error.message || 'Could not read that transaction.', true); }+ }+ $('lookup').addEventListener('submit', lookup);+ const initial = new URLSearchParams(location.search).get('tx');+ if (initial) { $('transaction').value = initial; lookup(); }+ </script>+</body>+</html>diff --git a/src/onchain/README.md b/src/onchain/README.mdindex 3da305087..670b300a9 100644--- a/src/onchain/README.md+++ b/src/onchain/README.md@@ -59,6 +59,19 @@ const result = await deployAgent({// → { ref, txHash, onchainId, contractOrMint, agent }```+### Solana transaction v1++Solana deploys negotiate the transaction format after wallet connection. When+the matching Wallet Standard account advertises transaction version `1`, prep+returns a v1 Metaplex Core mint with explicit `transactionConfig` caps and the+wallet signs its raw bytes through `solana:signTransaction`. Wallets without v1+support continue through the existing v0 path automatically.++The v1 deploy config is intentionally explicit because v1 compute-unit and+loaded-account-data limits otherwise resolve to zero. Server-side asset and+collection signatures are applied before the prepared transaction is returned;+the connected owner wallet supplies the remaining fee-payer signature.+## API surface (server)Two endpoints — replace the four legacy ones:diff --git a/src/onchain/adapters/solana.js b/src/onchain/adapters/solana.jsindex ae23ce555..6fdfdacbc 100644--- a/src/onchain/adapters/solana.js+++ b/src/onchain/adapters/solana.js@@ -13,6 +13,7 @@*/import { Connection, Transaction, VersionedTransaction } from '@solana/web3.js';+import { getWallets } from '@wallet-standard/app';import { solana } from '../chain-ref.js';// Route through our same-origin proxy. The public mainnet RPC returns 403 to@@ -62,11 +63,30 @@ function decodeTx(b64) {}}+function fromBase64(b64) {+ const bin = atob(b64);+ const bytes = new Uint8Array(bin.length);+ for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);+ return bytes;+}++/** Find the Wallet Standard account that owns an address and advertises v1. */+export function findV1WalletStandardSigner(wallets, address) {+ for (const wallet of wallets || []) {+ const feature = wallet?.features?.['solana:signTransaction'];+ if (!feature?.supportedTransactionVersions?.includes(1)) continue;+ const account = wallet.accounts?.find((candidate) => candidate.address === address);+ if (account) return { wallet, account, feature };+ }+ return null;+}+/** @implements {import('./base.js').WalletAdapter} */export class SolanaAdapter {#provider = null;#address = null;#preferred;+ #v1Signer = null;constructor({ preferredWallet = null } = {}) {this.#preferred = preferredWallet;@@ -76,6 +96,10 @@ export class SolanaAdapter {return 'solana';}+ get supportedTransactionVersions() {+ return this.#v1Signer ? [0, 1] : [0];+ }+isAvailable() {return !!detect(this.#preferred);}@@ -113,6 +137,7 @@ export class SolanaAdapter {}this.#address = (resp?.publicKey || provider.publicKey)?.toString();if (!this.#address) throw new Error('Could not read Solana wallet address.');+ this.#v1Signer = findV1WalletStandardSigner(getWallets().get(), this.#address);if (ensureLinked) {await this.#ensureLinkedViaSiws(cluster);@@ -133,15 +158,31 @@ export class SolanaAdapter {if (!this.#provider) throw new Error('Wallet not connected');if (!prep.txBase64) throw new Error('Solana prep missing txBase64');- const tx = decodeTx(prep.txBase64);const conn = new Connection(RPC[ref.cluster], 'confirmed');// Always go through signTransaction + our own Connection so we control// which cluster the tx lands on. Avoids the silent mismatch where// Phantom is set to mainnet but the user picked devnet (or vice versa).- let signed;+ let raw;try {- signed = await this.#provider.signTransaction(tx);+ if (prep.transactionVersion === 1) {+ if (!this.#v1Signer) {+ const err = new Error('This wallet does not advertise Solana transaction v1 signing.');+ err.code = 'TX_VERSION_UNSUPPORTED';+ throw err;+ }+ const [result] = await this.#v1Signer.feature.signTransaction({+ account: this.#v1Signer.account,+ transaction: fromBase64(prep.txBase64),+ options: { preflightCommitment: 'confirmed' },+ });+ if (!result?.signedTransaction) throw new Error('Wallet returned no signed v1 transaction.');+ raw = result.signedTransaction;+ } else {+ const tx = decodeTx(prep.txBase64);+ const signed = await this.#provider.signTransaction(tx);+ raw = signed.serialize();+ }} catch (e) {if (e?.code === 4001 || /reject/i.test(e?.message || '')) {const err = new Error('Signature cancelled.');@@ -151,7 +192,6 @@ export class SolanaAdapter {throw e;}- const raw = signed.serialize();const signature = await conn.sendRawTransaction(raw, {skipPreflight: false,preflightCommitment: 'confirmed',diff --git a/src/onchain/deploy.js b/src/onchain/deploy.jsindex 2aa4ffa83..467a29d3a 100644--- a/src/onchain/deploy.js+++ b/src/onchain/deploy.js@@ -17,12 +17,12 @@ import { toCaip2 } from './chain-ref.js';const PREP_CACHE_TTL_MS = 50 * 60 * 1000; // server keeps prep 60m-function prepCacheKey(agentId, ref) {- return `3dagent:onchain-prep:${agentId}:${toCaip2(ref)}`;+function prepCacheKey(agentId, ref, transactionVersion = 0) {+ return `3dagent:onchain-prep:${agentId}:${toCaip2(ref)}:tx${transactionVersion}`;}-async function getOrCreatePrep(agent, ref, walletAddress) {- const key = prepCacheKey(agent.id, ref);+async function getOrCreatePrep(agent, ref, walletAddress, transactionVersion = 0) {+ const key = prepCacheKey(agent.id, ref, transactionVersion);try {const raw = localStorage.getItem(key);if (raw) {@@ -41,6 +41,7 @@ async function getOrCreatePrep(agent, ref, walletAddress) {description: agent.description || '',avatar_id: agent.avatarId || agent.avatar_id || null,skills: Array.isArray(agent.skills) && agent.skills.length ? agent.skills : undefined,+ ...(ref.family === 'solana' ? { transaction_version: transactionVersion } : {}),};const resp = await fetch('/api/agents/onchain/prep', {method: 'POST',@@ -65,9 +66,9 @@ async function getOrCreatePrep(agent, ref, walletAddress) {return cached;}-function clearPrepCache(agentId, ref) {+function clearPrepCache(agentId, ref, transactionVersion = 0) {try {- localStorage.removeItem(prepCacheKey(agentId, ref));+ localStorage.removeItem(prepCacheKey(agentId, ref, transactionVersion));} catch {/* ignore */}@@ -96,13 +97,15 @@ export async function deployAgent({ agent, ref, onProgress = () => {} }) {ensureLinked: true,cluster: ref.family === 'solana' ? ref.cluster : undefined,});+ const transactionVersion =+ ref.family === 'solana' && adapter.supportedTransactionVersions?.includes(1) ? 1 : 0;if (ref.family === 'evm' && walletRef.family === 'evm' && walletRef.chainId !== ref.chainId) {await adapter.switchTo(ref);}onProgress('prep');- const prep = await getOrCreatePrep(agent, ref, address);+ const prep = await getOrCreatePrep(agent, ref, address, transactionVersion);onProgress('sign');const sig = await adapter.signAndSend(prep, ref);@@ -130,7 +133,7 @@ export async function deployAgent({ agent, ref, onProgress = () => {} }) {const result = await confirmResp.json();onProgress('save');- clearPrepCache(agent.id, ref);+ clearPrepCache(agent.id, ref, transactionVersion);return {ref,diff --git a/tests/src/onchain.test.js b/tests/src/onchain.test.jsindex db96c6953..20f22a148 100644--- a/tests/src/onchain.test.js+++ b/tests/src/onchain.test.js@@ -104,6 +104,30 @@ describe('chain-ref', () => {});describe('adapter factory', () => {+ it('selects only a matching Wallet Standard account that advertises V1', async () => {+ const { findV1WalletStandardSigner } = await import('../../src/onchain/adapters/solana.js');+ const signTransaction = async () => [];+ const account = { address: 'AgentOwner111', chains: [], features: [] };+ const wallet = {+ accounts: [account],+ features: {+ 'solana:signTransaction': {+ supportedTransactionVersions: ['legacy', 0, 1],+ signTransaction,+ },+ },+ };++ expect(findV1WalletStandardSigner([wallet], account.address)).toEqual({+ wallet,+ account,+ feature: wallet.features['solana:signTransaction'],+ });+ expect(findV1WalletStandardSigner([wallet], 'AnotherOwner')).toBeNull();+ wallet.features['solana:signTransaction'].supportedTransactionVersions = ['legacy', 0];+ expect(findV1WalletStandardSigner([wallet], account.address)).toBeNull();+ });+it('returns the correct family adapter and caches', async () => {const { getAdapter, _resetAdapters } = await import('../../src/onchain/adapters/index.js');_resetAdapters();diff --git a/tests/transaction-v1.test.js b/tests/transaction-v1.test.jsindex 7f08671c0..8b1c75e0f 100644--- a/tests/transaction-v1.test.js+++ b/tests/transaction-v1.test.js@@ -1,8 +1,11 @@import { describe, it, expect } from 'vitest';import { Keypair, SystemProgram, Transaction } from '@solana/web3.js';+import nacl from 'tweetnacl';import {+ AGENT_DEPLOY_V1_CONFIG,LEGACY_TRANSACTION_LIMIT,V1_TRANSACTION_LIMIT,+ buildPartiallySignedV1Transaction,decodeFeatureActivationSlot,inspectWireTransaction,} from '../api/_lib/solana/transaction-v1.js';@@ -41,6 +44,50 @@ describe('Solana transaction V1 inspector', () => {expect(V1_TRANSACTION_LIMIT).toBe(4_096);});+ it('builds a partially signed V1 deploy with explicit resource caps', async () => {+ const owner = Keypair.generate();+ const asset = Keypair.generate();+ const instruction = SystemProgram.createAccount({+ fromPubkey: owner.publicKey,+ newAccountPubkey: asset.publicKey,+ lamports: 1,+ space: 0,+ programId: SystemProgram.programId,+ });+ const wire = await buildPartiallySignedV1Transaction({+ feePayer: owner.publicKey.toBase58(),+ lifetime: {+ blockhash: Keypair.generate().publicKey.toBase58(),+ lastValidBlockHeight: 123n,+ },+ instructions: [{+ programId: instruction.programId.toBase58(),+ keys: instruction.keys.map((key) => ({+ pubkey: key.pubkey.toBase58(),+ isSigner: key.isSigner,+ isWritable: key.isWritable,+ })),+ data: instruction.data,+ }],+ signers: [{+ publicKey: asset.publicKey.toBase58(),+ signMessage: async (message) => nacl.sign.detached(message, asset.secretKey),+ }],+ });++ expect(wire[0]).toBe(0x81);+ const inspected = inspectWireTransaction(Buffer.from(wire).toString('base64'));+ expect(inspected.version).toBe(1);+ expect(inspected.limitBytes).toBe(V1_TRANSACTION_LIMIT);+ expect(inspected.budget).toMatchObject({+ source: 'transaction-config',+ computeUnitLimit: AGENT_DEPLOY_V1_CONFIG.computeUnitLimit,+ loadedAccountsDataSizeLimit: AGENT_DEPLOY_V1_CONFIG.loadedAccountsDataSizeLimit,+ priorityFeeLamports: Number(AGENT_DEPLOY_V1_CONFIG.priorityFeeLamports),+ });+ expect(inspected.sponsor).toMatchObject({ verdict: 'caps-explicit', safeToCosign: true });+ });+it('rejects malformed wire input without contacting an RPC', () => {expect(() => inspectWireTransaction('not base64!')).toThrow(/base64-encoded/);expect(() => inspectWireTransaction(Buffer.from('not a transaction').toString('base64'))).toThrow(/valid signed/);diff --git a/workers/agent-sniper/radar-detect.js b/workers/agent-sniper/radar-detect.jsindex 103a74778..8e7d9481c 100644--- a/workers/agent-sniper/radar-detect.js+++ b/workers/agent-sniper/radar-detect.js@@ -76,7 +76,7 @@ export async function walletHistoryCount(address, { endpoint, freshMax = 12 } =export async function fetchTransaction(signature, { endpoint }) {return rpc(endpoint, 'getTransaction', [signature,- { encoding: 'jsonParsed', maxSupportedTransactionVersion: 0, commitment: 'confirmed' },+ { encoding: 'jsonParsed', maxSupportedTransactionVersion: 1, commitment: 'confirmed' },]);}diff --git a/workers/agent-sniper/reconcile.js b/workers/agent-sniper/reconcile.jsindex b87935e90..758ec93d1 100644--- a/workers/agent-sniper/reconcile.js+++ b/workers/agent-sniper/reconcile.js@@ -144,7 +144,7 @@ export async function reconcileVanishedBag({ ctx, position, reason }) {for (const s of sigs || []) {if (s.err || s.signature === position.buy_sig) continue;const tx = await ctx.connection.getParsedTransaction(s.signature, {- maxSupportedTransactionVersion: 0,+ maxSupportedTransactionVersion: 1,});if (!tx || tx.meta?.err) continue;const pre = (tx.meta?.preTokenBalances || []).find(