v0.15.1

This is a hotfix release. Please upgrade if you're running Pathfinder 0.15.0.

Huge thanks to @xJonathanLEI for fixing the JSON-RPC 0.7 issue introduced in 0.15.0.

Fixed

• starknet_getBlockWithReceipts returns transaction_hash within the transaction object making the response not strictly spec compliant. Fixed on the JSON-RPC 0.8 interface.
• JSON-RPC 0.7 methods returning block headers are including the l2_gas property.

Changed

• Pathfinder is now compiled with arithmetic overflow checks enabled in release mode to mitigate potential issues.

v0.14.5

This is a hotfix release. Please upgrade if you're running Pathfinder <= 0.14.4.

Fixed

• Pathfinder is now compiled with arithmetic overflow checks enabled in release mode to mitigate potential issues.

v0.15.0

This is a major release of Pathfinder with significant changes:

• Significant improvement in sync performance (making re-sync or catching up significantly faster).
• Pathfinder now requires a Websocket connection to an Ethereum node (wss:// URL).
• JSON-RPC 0.4.0 and 0.5.0 API support has been removed.
• Preliminary support for the JSON-RPC 0.8.0-rc1 API version has been added. Due to some missing under-the-hood changes not all features are currently supported (for example, L2 gas related fields have invalid values but are present in responses).

Upgrading to 0.15.0 from a previous release will perform a quick database migration. Reverting to Pathfinder <0.15.0 will require a backup of the database before the migration has been completed.

Huge thanks to first-time contributors @odesenfans, @apoorvsadana, @whichqua and @mcdee.

Added

• Pathfinder now fetches data concurrently from the feeder gateway when catching up. The --gateway.fetch-concurrency CLI option can be used to limit how many blocks are fetched concurrently (the default is 8).
• --disable-version-update-check CLI option has been added to disable the periodic checking for a new version.
• Add pathfinder_getClassProof endpoint to retrieve the Merkle proof of any class hash in the class trie.
• add process_start_time_seconds metric showing the unix timestamp when the process started.
• --log-output-json CLI option has been added to output the Pathfinder log in line-delimited JSON.
• Preliminary support has been added for the new JSON-RPC 0.8.0-rc1 specification.

Changed

• Ethereum RPC API now requires Websocket endpoints (prev. HTTP). If an HTTP url is provided instead, Pathfinder will attempt to connect vía Websocket protocol at that same url.
• JSON-RPC API version 0.4 and 0.5 support have been removed.
• JSON-RPC API version 0.7 is now served by default on the / path.

Fixed

• starknet_getBlockWithTxs works with empty blocks`

v0.14.4

This is a hotfix release addressing an issue that prevents Pathfinder from syncing Sepolia testnet past block 218483.

❗ ❗ Please upgrade to this release if you're running Pathfinder with the Sepolia testnet. ❗ ❗

Fixed

• Pathfinder stops syncing Sepolia testnet at block 218484 because of a block hash mismatch.

v0.14.3

This is a hotfix release addressing an issue that could cause potential Merkle tree corruption during L2 reorgs.

❗ ❗ Please upgrade to this release if you're running Pathfinder in pruned mode. ❗ ❗

Fixed

• Pathfinder sometimes corrupts its Merkle trie storage during reorgs, leading to later failures with errors like “Node X at height Y is missing” or “Stored node’s hash is missing.

v0.14.2

This is a hotfix release fixing some JSON-RPC API issues and a configuration issue.

Huge thanks to @lambda-0x for reporting and fixing the starknet_getEvents inconsistencies.

Fixed

• Pathfinder sometimes returns an INVALID_CONTINUATION_TOKEN error when requesting events from the pending block and providing a continuation token.
• starknet_getEvents incorrectly returns pending events if from_block is greater than latest_block_number + 1.
• starknet_getEvents incorrectly does not return pending events if from_block is pending and to_block is missing.

Added

• --sync.l1-poll-interval CLI option has been added to set the poll interval for L1 state. Defaults to 30s.
• Support for Starknet 0.13.2.1.

v0.14.1

This is a hotfix release fixing some JSON-RPC API issues and a configuration issue.

Fixed

• Pathfinder does not properly limit the number of concurrent executors when using the --rpc.execution-concurrency CLI option.
• Pathfinder returns non-conforming STRUCT_ABI_ENTRY objects in response to starknet_getClass requests.
• Pathfinder returns starknet_getStateUpdate responses that are non-conformant with the specification if there are replaced classes in the response.

v0.14.0

This release of Pathfinder adds support for Starknet 0.13.2.

⚠️ You have to upgrade to this release before Starknet 0.13.2 is rolled out on testnet and mainnet, otherwise syncing new (Starknet 0.13.2) blocks will just stop. ⚠️

Added

• Support for Starknet v0.13.2.
• Pathfinder now creates a new directory if the database path specified does not exist.
• Pathfinder now has a CLI option (--rpc.custom-versioned-constants-json-path) to allow loading a custom versioned constants JSON file. When specified the contents of the file is then used instead of the latest constants built into the blockifier crate during execution of Cairo code.

Fixed

• Pathfinder exits with an error when detecting a one-block reorg if --storage.state-tries is set to 0.
• Pathfinder returns an internal error for starknet_getTransactionReceipt requests where steps would be zero in COMPUTATION_RESOURCES.

v0.13.2

This is a hotfix release fixing some JSON-RPC API issues.

Fixed

• starknet_getTransactionReceipt responses are missing the payload property in MSG_TO_L1 objects on the JSON-RPC 0.7 interface.
• starknet_traceTransaction and starknet_traceBlockTransactions returns L2 to L1 messages from inner calls duplicated.

v0.13.1

This release fixes serialization problems with response objects of starknet_getTransactionReceipt calls.

---

Fixed

• starknet_getTransactionReceipt responses are not compliant with the JSON-RPC specification:
  • L1 handler receipts throw an internal error
  • execution_status and revert_reason properties are missing