roadmap

Roadmap

What hashspan will trace next, and what it already does. There are no dates: an item ships with the first release after its pull request is merged.

Next 7

More send paths. Not tied to a version: each ships with the first release after its pull request is merged.

Trace viem deployContract
viem
#36 · good first issue →
Trace viem sendRawTransaction
viem
#33 · good first issue →
Trace viem sendCalls
viem
roadmap.md →
viem transport wrapper
viem
JSON-RPC spans.
roadmap.md →
CDP smart account user operations
cdp
ERC-4337, through the CDP SDK.
roadmap.md →
Metrics
core
Transaction fee and confirmation latency histograms.
roadmap.md →
Base Sepolia run of the example
example
Run the example agent on a public testnet, not just a local chain.
roadmap.md →

A stable API before 1.0. All three decisions are accepted; two shipped in 0.4.

Core API boundary
core
Only createTxTracker() produces trackers and handles; handle methods take an options object. Shipped in 0.4.
ADR 0014 →
Send span as the active context
core
Wallet, RPC and HTTP spans nest under the send span. Shipped in 0.4.
ADR 0015 →
Status from chain data only
semconv
A wait that gives up is error.type timeout. The status value timeout is deprecated in 0.4 and no longer recorded from the next minor release (done on main).
ADR 0016 →

Bigger pieces, after the send paths above.

Blockchain semantic conventions for OpenTelemetry
semconv
An upstream proposal based on the draft span and attribute names.
Semconv feedback →
ERC-4337 user operations
core
roadmap.md →
ethers v6 adapter
adapter
roadmap.md →
Non-EVM chains
core
roadmap.md →

Released in 0.1 to 0.4.

send and confirm spans
core
Linked by transaction hash, with agent identity from Baggage and privacy modes.
ADR 0002 →
viem adapter
viem
Hooks for sendTransaction, writeContract and waitForTransactionReceipt.
package →
Background confirmation and watch()
viem
Confirms transactions without an explicit wait, including ones sent by a wallet API.
roadmap.md →
One confirm span per transaction
core
ADR 0007 →
Replaced transactions
core
Receipts are attributed to the transaction that was mined.
ADR 0008 →
Revert reason decoding
viem
Mined reverts are replayed and decoded.
ADR 0005 →
Privacy controls
core
Error messages and call arguments are opt-in; addresses can be hashed or dropped.
ADR 0006 →
Telemetry off the call path
core
Chain id resolution never delays a send.
ADR 0009 →
flush() before shutdown
core
ADR 0010 →
x402 payments
x402
A payment span per paid request; with a reader, the settling transaction gets a confirm span linked to it.
ADR 0013 →
Coinbase CDP server accounts
cdp
ADR 0012 →
Example agent and make demo
example
An AI SDK agent on a local chain, no API key needed.
example →
npm releases with provenance
release
releases →