v0.8.0-rc1

The latest release candidate for Starknet's JSON-RPC v0.8.0. This version is aimed to be supported by nodes after the Starknet upgrade to v0.13.4, although dapps can keep communicating with nodes over v0.7.0 (and above) of the specs. This version introduces various improvements, such as a websockets API, improved errors, and several methods that were requested by the community.

Note that v0.13.3 is the version in which the notion of l2_gas will be introduced. This version no longer speaks in terms of low-level resources such as Cairo steps or builtins.

What's Changed

• fix: schema conformance by @xJonathanLEI in #231
• Remove data gas from inner call resources by @ArielElp in #233
• Refactor storage proofs by @ArielElp in #232
• Typo and versioning fixes by @FabijanC in #234
• Fix bytecode_segment_lengths indentation; Fix Immediate title by @franciszekjob in #239
• fix: add l2_gas_price to PENDING_BLOCK_HEADER by @kkovaacs in #236
• Update starknet_api_openrpc.json small typo by @thiagodeev in #230
• Ws socket errors by @amanusk in #238
• Fix validation script after adding structured errors by @amanusk in #235
• Fix subscription reorg by @franciszekjob in #242
• Add l1_data_gas to the resource bounds mapping by @ArielElp in #228
• Fix typos in OpenRPC specifications by @kkovaacs in #244
• Fix starknet_executables api schema by @ArielElp in #247
• Rename block param of ws methods to block_id by @FabijanC in #246
• Fix keys ref in starknet_subscribeEvents by @franciszekjob in #243
• add call on pending error by @ArielElp in #249

New Contributors

• @franciszekjob made their first contribution in #239
• @kkovaacs made their first contribution in #236
• @thiagodeev made their first contribution in #230

Full Changelog: v0.8.0-rc0...v0.8.0-rc1

v0.8.0-rc0

The first release candidate for Starknet's JSON-RPC v0.8.0. This version is aimed to be supported by nodes after the Starknet upgrade to v0.13.3, although dapps can keep communicating with nodes over v0.7.0 (and above) of the specs. This version introduces various improvements, such as a websockets API, improved errors, and several methods that were requested by the community.

Note that v0.13.3 is the version where the notion of l2_gas will be introduced, so this version no longer speaks in terms of low-level resources such as Cairo steps or builtins.

Changelog

• Add wallet_rpc spec for wallet<>dapp communication by @amanusk in #203
• Add .editorconfig and format files by @amanusk in #212
• Add flat event field kind by @prxgr4mm3r in #215
• Refactor execution resources to (l1_gas, l2_gas, l1_data_gas) terms & delete raw resources #216
• Improve the INSUFFICIENT_MAX_FEE error on the write-api #217
• Add failure reason in getTransactionStatus #218
• Add structure to execution errors #219
• Add getMessageStatus endpoint to track l1->l2 messages #223
• Introduce a new websocket api specs with various subscriptions (headers/events/pending txs/tx status) by @amanusk in #211
• Add getStorageProof endpoint #227
• Add the starknet_getCompiledCasm endpoint for fetching compiled classes #221

New Contributors

• @prxgr4mm3r made their first contribution in #215

Full Changelog: v0.7.1...v0.8.0-rc0

v0.7.1

Minor fix adding the execution_resources property to l1_handler transaction traces. This is already the behavior of full nodes, so no changes are expected from the POV of dapps communicating with the json-rpc. Note that /v0_7 URLs will refer to the latest v0.7.x, that is, there is no need to refer to patch versions explicitly when interacting with Starknet nodes.

Changelog

• fix: add execution resources to l1 handler traces by @ArielElp in #201
• bump version to 0.7.1 by @ArielElp in #202

Full Changelog: v0.7.0...v0.7.1

v0.7.0

Starknet's JSON-RPC v0.7.0. This version captures the changes associated with Starknet v0.13.1, allowing nodes to externalize information related to EIP4844. Dapps that communicate with nodes over v0.6.0 of the specs will continue to work, but will not enjoy the lower fee estimates resulting by the introduction of blobdata.

Changelog

• Add EIP-4844 related fields by @ArielElp in #188, #193, #194
• Add data consumption to receipts and traces by @ArielElp in #187
• Add getBlockWithReceipts method by @ArielElp in #189, #191
• Spec organization: Introduce TXN_RECEIPT_WITH_BLOCK_INFO and remove the pending receipts objects by @ShahakShama in #195
• fix: change l1_handler version to enum by @ArielElp in #190
• fix: make revert_reason required in reverted transaction traces by @ShahakShama in #198
• fix: make revert_reason required in receipts of reverted transactions @ShahakShama in #197
• fix storage key pattern by @ShahakShama in #199
• add a comment explaining the execution_resources property name @ShahakShama in #200

Full Changelog: v0.6.0...v0.7.0

v0.7.0-rc2

Changelog

• Fix: add 4844-related fields to the pending block header by @ArielElp in #194
• Spec organization: Introduce TXN_RECEIPT_WITH_BLOCK_INFO and remove the pending receipts objects by @ShahakShama in #195

Full Changelog: v0.7.0-rc1...v0.7.0-rc2

v0.7.0-rc1

Changelog

• refactor BLOCK_BODY_WITH_RECEIPTS by @ArielElp in #191
• fix: make data_gas related fields required in the block header by @ArielElp in #193

Full Changelog: v0.7.0-rc0...v0.7.0-rc1

v0.7.0-rc0

The first release candidate for Starknet's JSON-RPC v0.7.0. This version is aimed to be supported by nodes after the Starknet upgrade to v0.13.1, although dapps can keep communicating with nodes over v0.6.0 of the specs.

Changelog

• Add data consumption to receipts and traces by @ArielElp in #187
• Add EIP-4844 related fields by @ArielElp in #188
• Add getBlockWithReceipts method by @ArielElp in #189
• fix: change l1_handler version to enum by @ArielElp in #190

Full Changelog: v0.6.0...v0.7.0-rc0

v0.6.0

Chanelog

• Change execution resource counters to integers by @OmriEshhar1 in #147
• Allow EMITTED_EVENT to contain events from the pending block by @ShahakShama in #151
• Disallow block_hash/block_number/new_root in the PENDING_BLOCK_HEADER schema by @OmriEshhar1 in #154
• Introduce v3 transactions by @ArielElp in #149
• Add state_diff to L1_HANDLER and DELEGATE call type by @ArielElp in #161
• Add resources to internal calls within a trace by @ArielElp in #160
• add stricter restrictions on v3 fields by @ArielElp in #169
• Make trace fields optional (as in 0.5.1) by @ArielElp in #172

• Refactor traceTransactions and estimateFee, and rename STRK to FRI by @ArielElp in #174
  • use the name fri for $10^{-18}$ strk
  • added TRANSACTION_EXECUTION_ERROR
  • added the SKIP_VALIDATE flag to starknet_estimateFee
  • clarified semantics of simulate and estimate: simulateTransactions should provide traces whenever possible and reply with TRANSACTION_EXECUTION_ERROR in cases of validation failure or internal error. estimateFee however is expected to fail with TRANSACTION_EXECUTION_ERROR when a transaction reverts, in order to avoid a scenario where transactions that are known to revert are sent to the network by mistake.

• Add units to FEE_ESTIMATE by @ArielElp in #175
• Mandatory simulation flags in starknet_estimateFee by @ArielElp in #177
• Add string data to VALIDATION_FAILURE by @ArielElp in #179

Bug fixes

• Fix bug where all the schemas are vaild in the oneOf in PENDING_DEPLOY_TXN_RECEIPT by @ShahakShama in #150
• Fix DECLARE_TXN_V1 version by @tabaktoni in #170
• Typo fix and added property to schema object by @marioiordanov in #173
• Import BROADCASTED_DECLARE_TXN in write api by @ShahakShama in #178
• Fix versions in spec files and package.json by @FabijanC in #183

New Contributors

• @tabaktoni made their first contribution in #170
• @marioiordanov made their first contribution in #173
• @FabijanC made their first contribution in #183

Full Changelog: v0.5.0...v0.6.0

v0.6.0-rc5

Changelog

• import BROADCASTED_DECLARE_TXN in write api by @ShahakShama in #178
• Add string data to VALIDATION_FAILURE by @ArielElp in #179

Full Changelog: v0.6.0-rc4...v0.6.0-rc5

v0.6.0-rc4

Changelog

• typo fix and added property to schema object by @marioiordanov in #173
• Mandatory simulation flags in starknet_estimateFee by @ArielElp in #177

New Contributors

• @marioiordanov made their first contribution in #173

Full Changelog: v0.6.0-rc3...v0.6.0-rc4