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.

fix(onchain): verify Solana transaction versions

nirholas935f8bede678
diff --git a/api/agents/onchain/[action].js b/api/agents/onchain/[action].js
index 760bf9464..ad8a4e12c 100644
--- a/api/agents/onchain/[action].js
+++ b/api/agents/onchain/[action].js
@@ -494,7 +494,7 @@ async function verifyEvm({ chainId, txHash, expectedContract, expectedOwner }) {
return { blockNumber: receipt.blockNumber };
}
-async function verifySolana({ cluster, txSig, expectedAsset, expectedOwner }) {
+async function verifySolana({ cluster, txSig, expectedAsset, expectedOwner, expectedVersion = 0 }) {
const rpc =
cluster === 'devnet'
? process.env.SOLANA_RPC_URL_DEVNET || 'https://api.devnet.solana.com'
@@ -524,15 +524,23 @@ async function verifySolana({ cluster, txSig, expectedAsset, expectedOwner }) {
e.status = 422;
throw e;
}
+ if (tx.version !== expectedVersion) {
+ const e = new Error(`Transaction version ${String(tx.version)} does not match prepared v${expectedVersion}.`);
+ e.code = 'tx_wrong_version';
+ e.status = 422;
+ throw e;
+ }
- const accountKeys = tx.transaction.message.accountKeys.map((k) => k.pubkey?.toString());
- if (expectedAsset && !accountKeys.includes(expectedAsset)) {
- const e = new Error('Asset pubkey not found in transaction.');
+ const accountKeys = tx.transaction.message.accountKeys;
+ const assetKey = accountKeys.find((key) => key.pubkey?.toString() === expectedAsset);
+ if (expectedAsset && (!assetKey || !assetKey.signer)) {
+ const e = new Error('Asset pubkey is not a transaction signer.');
e.code = 'asset_not_in_tx';
e.status = 422;
throw e;
}
- if (!accountKeys.includes(expectedOwner)) {
+ const ownerKey = accountKeys.find((key) => key.pubkey?.toString() === expectedOwner);
+ if (!ownerKey?.signer) {
const e = new Error('Wallet address not in transaction signers.');
e.code = 'wrong_signer';
e.status = 422;
@@ -584,6 +592,7 @@ async function handleConfirm(req, res) {
txSig: body.tx_hash,
expectedAsset: p.asset_pubkey,
expectedOwner: body.wallet_address,
+ expectedVersion: p.transaction_version || 0,
});
} else {
return error(res, 400, 'validation_error', `unknown chain family: ${p.chain_family}`);
@@ -610,7 +619,9 @@ async function handleConfirm(req, res) {
wallet: body.wallet_address,
metadata_uri: prep.metadata_uri,
confirmed_at: new Date().toISOString(),
- ...(p.chain_family === 'solana' ? { cluster: p.cluster } : {}),
+ ...(p.chain_family === 'solana'
+ ? { cluster: p.cluster, transaction_version: p.transaction_version || 0 }
+ : {}),
};
// For Solana, also surface the flat fields the edit + attestation paths key on
diff --git a/src/onchain/README.md b/src/onchain/README.md
index 670b300a9..2d15d4871 100644
--- a/src/onchain/README.md
+++ b/src/onchain/README.md
@@ -95,7 +95,7 @@ Request shape (prep):
}
```
-Response (prep): `{ prepId, chain, metadataUri, cid, contractAddress | { assetPubkey, txBase64, cluster } }`
+Response (prep): `{ prepId, chain, metadataUri, cid, contractAddress | { assetPubkey, txBase64, cluster, transactionVersion } }`
Request shape (confirm):
@@ -120,6 +120,7 @@ Confirm writes a single canonical block to `agent_identities.meta.onchain`:
"contract_or_mint": "0x8004...",
"wallet": "0x...",
"metadata_uri": "ipfs://...",
+ "transaction_version": 1,
"confirmed_at": "2026-..."
}
}
diff --git a/src/onchain/deploy-button.js b/src/onchain/deploy-button.js
index 21931acf1..2fa8d144d 100644
--- a/src/onchain/deploy-button.js
+++ b/src/onchain/deploy-button.js
@@ -141,7 +141,12 @@ export class OnchainDeployButton {
if (onchain) {
const entry = entryByCaip2(this._registry, onchain.chain);
if (entry) {
- this._renderSuccessChip(entry, onchain.tx_hash, onchain.contract_or_mint);
+ this._renderSuccessChip(
+ entry,
+ onchain.tx_hash,
+ onchain.contract_or_mint,
+ onchain.transaction_version,
+ );
return;
}
}
@@ -224,14 +229,15 @@ export class OnchainDeployButton {
.addEventListener('click', () => this._renderDeployButton());
}
- _renderSuccessChip(entry, txHash, contractOrMint) {
+ _renderSuccessChip(entry, txHash, contractOrMint, transactionVersion = null) {
// Prefer the tx explorer link — it survives across chains and works for
// both EVM (tx hash) and Solana (signature).
const url = entry.explorerTx(txHash);
+ const versionLabel = entry.ref.family === 'solana' && transactionVersion === 1 ? ' v1' : '';
this._root.innerHTML = `
<a class="deploy-chip deploy-chip--success" href="${_esc(url)}" target="_blank" rel="noopener noreferrer"
aria-label="View on ${_esc(entry.name)} explorer">
- &#x2B22; On-chain on ${_esc(entry.name)} &middot; view on explorer
+ &#x2B22; On-chain on ${_esc(entry.name)}${versionLabel} &middot; view on explorer
</a>
`;
}
diff --git a/src/onchain/deploy.js b/src/onchain/deploy.js
index 467a29d3a..9b1ffef0d 100644
--- a/src/onchain/deploy.js
+++ b/src/onchain/deploy.js
@@ -79,7 +79,7 @@ function clearPrepCache(agentId, ref, transactionVersion = 0) {
* @param {{ id: string, name: string, [k: string]: any }} opts.agent
* @param {import('./chain-ref.js').ChainRef} opts.ref
* @param {(step: 'connect'|'prep'|'sign'|'confirm'|'save', detail?: object) => void} [opts.onProgress]
- * @returns {Promise<{ ref: import('./chain-ref.js').ChainRef, txHash: string, onchainId: string|null, contractOrMint: string|null, agent: object }>}
+ * @returns {Promise<{ ref: import('./chain-ref.js').ChainRef, txHash: string, onchainId: string|null, contractOrMint: string|null, transactionVersion: number|null, agent: object }>}
*/
export async function deployAgent({ agent, ref, onProgress = () => {} }) {
if (!agent?.id) throw new Error('agent.id is required');
@@ -140,6 +140,7 @@ export async function deployAgent({ agent, ref, onProgress = () => {} }) {
txHash: sig.txHash,
onchainId: sig.onchainId,
contractOrMint: prep.contractAddress || prep.assetPubkey || null,
+ transactionVersion: ref.family === 'solana' ? transactionVersion : null,
agent: result.agent,
};
}