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.

feat(onchain): add Solana transaction v1 deploy flow

nirholase51da5436ba4
diff --git a/api/_lib/solana/transaction-v1.js b/api/_lib/solana/transaction-v1.js
index 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].js
index 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, a
createArgs.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, attribute
metadataUri,
attributes,
collectionAddr,
+ transactionVersion,
}));
} catch (err) {
if (isRpcRateLimited(err)) {
@@ -289,6 +307,7 @@ async function prepSolana({ cluster, metadataUri, walletAddress, name, attribute
txBase64: 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.json
index 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.json
index 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.html
new file mode 100644
index 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) => ({ '&':'&amp;', '<':'&lt;', '>':'&gt;', '"':'&quot;', "'":'&#39;' })[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.md
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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.js
index 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(