starknet-specs release v0.10.1

[github-actions]

A new version of starknet-specs has been released.

Release: v0.10.1
Tag: v0.10.1
Published: 2026-03-13T08:13:33Z
Current Katana spec version: 0.9.0

Release Notes

PRs: #373, #351

---

New Features

Proof & Proof Facts Support

• BROADCASTED_INVOKE_TXN now extends INVOKE_TXN_V3 with an optional proof field — a base64-encoded string of big-endian packed u32 values.
• INVOKE_TXN_V3 responses now include a proof_facts field (array of FELT). An empty array is returned when no proof facts exist.
• New TXN_RESPONSE_FLAG enum (INCLUDE_PROOF_FACTS) controls whether proof_facts is included in transaction responses.
• New response_flags parameter added to:
  • starknet_getBlockWithTxs
  • starknet_getBlockWithTxHashes
  • starknet_getTransactionByHash
  • starknet_getTransactionByBlockIdAndIndex
• New INVALID_PROOF error (code 69) added to starknet_addInvokeTransaction.
• WebSocket: New SUBSCRIPTION_TAG enum (INCLUDE_PROOF_FACTS) and new tags parameter on starknet_subscribeNewHeads for proof facts in subscription responses.

Initial Reads / State Witness

• New RETURN_INITIAL_READS simulation flag for starknet_simulateTransactions. When set, the response changes from a plain array to an object containing simulated_transactions and initial_reads. The array format is preserved when the flag is absent (backwards compatible with v0.10.0).
• New trace_flags parameter on starknet_traceBlockTransactions with RETURN_INITIAL_READS support. Same response shape — array by default, object with traces + initial_reads when the flag is set.
• New INITIAL_READS schema representing a complete state witness for re-execution, containing:
  • storage — (contract_address, key) → value
  • nonces — contract_address → nonce
  • class_hashes — contract_address → class_hash
  • declared_contracts — class_hash → is_declared
• New TRACE_FLAG enum type.

Storage: Last Update Block Number

• starknet_getStorageAt now accepts a response_flags parameter with the INCLUDE_LAST_UPDATE_BLOCK flag.
• New STORAGE_RESPONSE_FLAG and STORAGE_RESULT schemas. When the flag is set, the response returns an object with value (FELT) and last_update_block (BLOCK_NUMBER) instead of a plain FELT.

State Update Filtering by Contract Address

• starknet_getStateUpdate now accepts an optional contract_addresses parameter. When provided, only state diffs related to the specified addresses are returned. Class declarations are unaffected by this filter.

Event Address Filter: Array Support

• starknet_getEvents (PR chore: rename katana-rpc crate to katana-rpc-server #351): The address filter in EVENT_FILTER now accepts either a single ADDRESS or an array of ADDRESS values.
• starknet_subscribeEvents: The from_address parameter similarly now accepts a single address or an array of addresses.

---

Fixes

• Typo: "synching" → "syncing" in the starknet_syncing method summary.

---

Affected Files

File	Changes
starknet_api_openrpc.json	Response flags, proof facts, storage result, event filter, state update filter
starknet_trace_api_openrpc.json	Initial reads, trace flags, simulation flags
starknet_write_api.json	INVALID_PROOF error
starknet_ws_api.json	Subscription tags, event address array filter
starknet_executables.json	Version bump only
starknet_metadata.json	Version bump only
package.json	Version bump only
package-lock.json	Version bump only

Full Changelog: starkware-libs/starknet-specs@v0.10.0...v0.10.1

---

OpenRPC Spec Diff: v0.9.0 → v0.10.1

Read API (starknet_api_openrpc.json)

Method	Status	Details
starknet_estimateFee	Changed	Error added: CONTRACT_NOT_FOUND
starknet_estimateMessageFee	Changed	Error added: CONTRACT_NOT_FOUND
starknet_getBlockWithReceipts	Changed	Parameter response_flags added (required: False)
starknet_getBlockWithTxs	Changed	Parameter response_flags added (required: False)
starknet_getStateUpdate	Changed	Parameter contract_addresses added (required: False)
starknet_getStorageAt	Changed	Parameter response_flags added (required: False); Return type changed
starknet_getStorageProof	Changed	Parameter contracts_storage_keys: schema changed
starknet_getTransactionByBlockIdAndIndex	Changed	Parameter response_flags added (required: False)
starknet_getTransactionByHash	Changed	Parameter response_flags added (required: False)

Write API (starknet_write_api.json)

Method	Status	Details
starknet_addInvokeTransaction	Changed	Error added: INVALID_PROOF

Trace API (starknet_trace_api_openrpc.json)

Method	Status	Details
starknet_simulateTransactions	Changed	Return type changed
starknet_traceBlockTransactions	Changed	Parameter trace_flags added (required: False); Return type changed

Summary

	Added	Removed	Changed
Read API	0	0	9
Write API	0	0	1
Trace API	0	0	2
Total	0	0	12

---

Action Items

• Review the API changes above
• Update RPC_SPEC_VERSION in crates/rpc/rpc-api/src/starknet.rs
• Implement new methods (if any)
• Update changed method signatures (if any)
• Remove deprecated methods (if any)
• Update RPC type definitions in crates/rpc/rpc-types/
• Add/update tests for changed endpoints