Reports

qn-guide-examples: what we found

AI/solana-mcp: getTransaction tool fails for version 1 transactions.

Public since 2026-10-30. GitHub issue quiknode-labs/qn-guide-examples/issues/479 was posted.

Code: quiknode-labs/qn-guide-examples, their default branch on 2026-10-30. Reported to them: quiknode-labs/qn-guide-examples/issues/479.

Status: Open: no fix merged yet

Findings

breaks accuracy

AI/solana-mcp: getTransaction tool fails for version 1 transactions

AI/solana-mcp/index.ts (line 217): the getTransaction tool asks for maxSupportedTransactionVersion: 0. For a version 1 signature the RPC returns error -32015, and the tool answers the agent with an error (under the label "Error while getting balance", line 276, which looks like a copy-paste slip) instead of the transaction.

Version 1 transactions are a large share of mainnet now (127 of 288 non-vote transactions, about 44%, in a block I sampled today), so this depends only on which wallet or SDK built the transaction.

  • AI/solana-mcp/index.ts:217
getTransaction(<v1 signature>, { maxSupportedTransactionVersion: 0 })  -> error -32015 "Transaction version (1) is not supported by the requesting client"
getTransaction(<v1 signature>, { maxSupportedTransactionVersion: 1 })  -> the transaction (version 1, meta present)

Fix: maxSupportedTransactionVersion: 1 (the json shape is the same). On @solana/kit ^2.x the TypeScript type only allows 0; current kit (8.x) allows 1, so it needs the bump too. Since people copy this example into their own MCP servers, it may be worth fixing here first.

What we measured

WhatResultHowChecked
Reported to themquiknode-labs/qn-guide-examples/issues/479, posted 2026-10-30https://github.com/quiknode-labs/qn-guide-examples/issues/479Oct 30, 2026, 3:08 PM UTC
StatusOpen: no fix merged yetGitHub issue quiknode-labs/qn-guide-examples#479Oct 31, 2026, 1:55 AM UTC

Tools run on this project

Check it yourself

Every Pulse tool, live on mainnet, starting with tx_version. Paste any signature from this report, or your own.

Toolbox

Pick any tool, change any input, run it on mainnet, and reopen any call to change it and run it again.

Ctrl ↵ runs the tool

25/25 free, then $0.01

Run when code can't find or read a transaction that is on chain, or before relying on code that reads other people's transactions. Read the docs

Response

Run the request to see the live response. The inputs are real mainnet data, so it works as it is.

Your calls 0

Calls you run appear here and stay in this browser. Open one to change its inputs and run it again.