wallet-evidence

A read-only Solana transaction evidence CLI. Fetch a transaction through one public RPC and get an evidence summary — slot, block time, execution error, parsed instructions, fee, and a response hash. No keys, no signing.

What it is

wallet-evidence is a command-line tool that pulls a Solana transaction through one configured public RPC and produces an evidence report. It is a single-RPC evidence viewer, not a wallet, not a signing tool, and not an asset-protection product. (It supports Solana only — it does not query EVM chains.)

The problem it solves

When you need to pull every detail of a Solana transaction for an investigation without a paid indexer, wallet-evidence gives you a self-contained, re-checkable report from one public RPC. It records exactly where the evidence came from, so the report stays honest about its own source.

Why UNKNOWN matters

Observed in the wild: the same transaction signature can be visible on one public RPC and not found on another, because indexing lag differs per provider. wallet-evidence never equates "the RPC cannot see it" with "the transaction does not exist." It returns UNKNOWN with the RPC host recorded, so the report stays honest about what was and was not observed.

When to use it

• You want Solana transaction evidence from one RPC without running your own indexer.
• You want to verify on-chain facts (slot, block time, execution error, instructions, fee) with no keys.
• You need a SHA-256 of the raw RPC response to re-check later.

When NOT to use it

• You need independent consensus across multiple RPCs — this is a single-RPC view.
• You want to submit, simulate, or sign transactions — it takes no keys and submits nothing.
• You want a wallet-security or asset-protection product — it is an evidence reporter, not a guard.
• You are on an EVM chain — wallet-evidence is Solana-only.

Installation

npm install -g wallet-evidence     # or run without installing:
npx wallet-evidence inspect <signature> --rpc=https://api.mainnet-beta.solana.com --json

Real command

npx wallet-evidence inspect <transaction-signature> --rpc=https://api.mainnet-beta.solana.com --json

Report contents

• RPC host, slot, block time
• transaction execution error (meta.err)
• parsed instructions (including SPL transfers), instruction count
• fee
• SHA-256 hash of the raw RPC response (re-checkable)
• status: OK / FAILED_TX / UNKNOWN

Example output

Representative report shape from the tool's documented fields. Real Devnet transaction lookups have verified slot/transfer data stability; a specific public signature is not reproduced here.

{
  "rpcHost": "api.mainnet-beta.solana.com",
  "signature": "(transaction signature)",
  "slot": 123456789,
  "blockTime": 1760000000,
  "executionError": null,
  "instructions": [ "(parsed instruction)", "(SPL transfer)" ],
  "instructionCount": 2,
  "fee": 5000,
  "responseSha256": "(computed at runtime)",
  "status": "OK"
}

What it does NOT check

• Single-RPC view — not independent consensus across providers.
• No keys accepted, no transactions submitted, no simulation.
• Not a wallet-security or asset-protection product.
• It does not support EVM chains — Solana only.

Limitations

• Evidence depends entirely on the single RPC you point it at; an RPC that has not indexed a transaction yields UNKNOWN, not a negative conclusion.
• Experimental (0.1.0): local JSON-RPC fixture tests pass; real Devnet transaction lookups verified slot/transfer data stability.

Status

Experimental (0.1.0). Local JSON-RPC fixture tests pass; real Devnet transaction lookups verified slot/transfer data stability.

npm

Package: wallet-evidence — published by npm user eidonze, version 0.1.0, MIT.

GitHub

Source: xka0085-byte/wallet-evidence — issues and the full README live there.

Related tools

• crosschain-incident — the suite's cross-chain incident normalizer; both verify event/chain facts but on different layers (Solana tx vs cross-chain message status).
• mcpdoctor — the suite's MCP/x402 endpoint inspector.
• ReceiptRail — anchors delivery receipts on Solana; wallet-evidence can report the transaction that settled an x402 payment.

Part of the Agent / Chain Evidence Tools suite · MIT · Node ≥ 18 · read-only, Solana-only, no keys