Operational Diagnostics, Live RPC Inspector & Transaction Failure Resolver for Stellar Soroban Smart Contracts
-E2984B?style=flat-square){kind=icon}
Soroban smart contract developers on Stellar frequently encounter cryptic WASM execution traps, VM budget overruns, state archival expirations, and simulation failures.
TrapTrace is an end-to-end developer tooling platform designed to inspect, simulate, decode, and resolve Soroban transaction errors on-chain. Rather than just offering static documentation, TrapTrace provides an active 4-tier operational diagnostic ecosystem:
┌────────────────────────────────────────────────────────────────────────┐
│ TRAPTRACE ECOSYSTEM │
├────────────────────────────┬───────────────────────────────────────────┤
│ 🛠️ traptrace-cli │ Operational Python CLI suite (v0.3.0): │
│ (Developer Terminal) │ • Live JSON-RPC 2.0 multi-network client │
│ │ • Multi-tx batch inspector (JSON datasets)│
│ │ • Pre-flight simulation & TUI gas gauges │
│ │ • Contract auth tree hierarchy validator │
│ │ • Static contract AST linter & gas meter │
│ │ • Automated Rust code fix generator │
│ │ • Storage & state TTL expiration auditor │
├────────────────────────────┼───────────────────────────────────────────┤
│ 🌐 soroban-error-explorer │ Live Web Diagnostics Studio (Vercel): │
│ (Browser Studio) │ • Real-time Stellar Testnet connectivity │
│ │ • Multi-transaction batch diagnostics │
│ │ • Auth hierarchy & signature validator │
│ │ • Contract WASM ABI & spec inspector │
│ │ • Smart contract linter & gas profiler │
│ │ • Rust test suite reproduction generator │
│ │ • Automated 35-entry verified catalog │
├────────────────────────────┼───────────────────────────────────────────┤
│ 📦 @traptrace/sdk │ TypeScript & JavaScript Client SDK: │
│ (Developer Library) │ • Offline bundled error catalog (35 rules)│
│ │ • Diagnostic string parser & auto-fix │
│ │ • Invocation auth validator & TTL health │
│ │ • Soroban code linter & test generator │
├────────────────────────────┼───────────────────────────────────────────┤
│ 📖 soroban-error-index │ Schema-validated Error Knowledge Base: │
│ (Diagnostic Database) │ • 35 testnet-verified catalog entries │
│ │ • Automated testnet verification harness │
│ │ • Strict JSON Schema CI validation │
│ │ • Offline HTML documentation manual │
└────────────────────────────┴───────────────────────────────────────────┘
| Repository | Description | Key Technologies |
|---|---|---|
🛠️ soroban-error-cli |
Operational CLI suite providing traptrace inspect, batch-inspect, simulate, auth-check, lint, profile, generate-test, and storage. |
Python 3, JSON-RPC 2.0, XDR Decoder, Pytest |
🌐 soroban-error-explorer |
Web application & Live Diagnostics Studio deployed at traptrace-explorer.vercel.app. | React 18, Vite 5, Lucide, Stellar Testnet RPC |
📦 traptrace-sdk |
Client library for dApps, wallets, and IDE tooling to decode errors and profile transactions. | JavaScript, TypeScript (.d.ts), Node:test |
📖 soroban-error-index |
Foundational catalog containing 35 testnet-verified error reproduction steps and remedies. | Markdown, YAML Frontmatter, JSON Schema, Testnet Logs |
pip install traptrace-clitraptrace inspect <TX_HASH> --network testnettraptrace lint contract/src/lib.rstraptrace fix arith-error
TrapTrace is an open-source public good for the Stellar Soroban ecosystem.
