Skip to content

Commit ad45d11

Browse files
eitanm-starkwareeitanm-starkware
authored
Merge pull request #350 from starkware-libs/release/v0.10.0
Release/v0.10.0
2 parents 6485866 + 39553a2 commit ad45d11

9 files changed

+108
-23
lines changed

‎.github/pull_request_template.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,5 @@
77
- [ ] Validated the specification files - `npm run validate_all`
88
- [ ] Applied formatting - `npm run format`
99
- [ ] Performed code self-review
10-
- [ ] If making a new release, checked out [the guidelines](../api/release.md)
10+
- [ ] Checked if this PR resolves any [issues](https://github.com/starkware-libs/starknet-specs/issues)
11+
- [ ] If making a new release, check out [the guidelines](https://github.com/starkware-libs/starknet-specs/blob/master/api/release.md)

‎api/starknet_api_openrpc.json‎

Lines changed: 90 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"openrpc": "1.0.0-rc1",
33
"info": {
4-
"version": "0.9.0",
4+
"version": "0.10.0",
55
"title": "StarkNet Node API",
66
"license": {}
77
},
@@ -669,6 +669,9 @@
669669
}
670670
},
671671
"errors": [
672+
{
673+
"$ref": "#/components/errors/CONTRACT_NOT_FOUND"
674+
},
672675
{
673676
"$ref": "#/components/errors/TRANSACTION_EXECUTION_ERROR"
674677
},
@@ -708,6 +711,9 @@
708711
}
709712
},
710713
"errors": [
714+
{
715+
"$ref": "#/components/errors/CONTRACT_NOT_FOUND"
716+
},
711717
{
712718
"$ref": "#/components/errors/CONTRACT_ERROR"
713719
},
@@ -949,7 +955,7 @@
949955
"storage_keys": {
950956
"type": "array",
951957
"items": {
952-
"$ref": "#/components/schemas/FELT"
958+
"$ref": "#/components/schemas/STORAGE_KEY"
953959
}
954960
}
955961
},
@@ -1108,9 +1114,21 @@
11081114
"title": "Transaction hash",
11091115
"description": "The transaction that emitted the event",
11101116
"$ref": "#/components/schemas/TXN_HASH"
1117+
},
1118+
"transaction_index": {
1119+
"title": "Transaction index",
1120+
"description": "The index of the transaction in the block by which the event was emitted",
1121+
"type": "integer",
1122+
"minimum": 0
1123+
},
1124+
"event_index": {
1125+
"title": "Event index",
1126+
"description": "The index of the event in the transaction by which it was emitted",
1127+
"type": "integer",
1128+
"minimum": 0
11111129
}
11121130
},
1113-
"required": ["transaction_hash"]
1131+
"required": ["transaction_hash", "transaction_index", "event_index"]
11141132
}
11151133
]
11161134
},
@@ -1343,6 +1361,27 @@
13431361
}
13441362
}
13451363
},
1364+
"migrated_compiled_classes": {
1365+
"title": "Migrated compiled classes",
1366+
"type": "array",
1367+
"items": {
1368+
"title": "Migrated classes",
1369+
"type": "object",
1370+
"description": "The class hash and the new Blake-migrated compiled class hash",
1371+
"properties": {
1372+
"class_hash": {
1373+
"title": "Class hash",
1374+
"description": "The hash of the class",
1375+
"$ref": "#/components/schemas/FELT"
1376+
},
1377+
"compiled_class_hash": {
1378+
"title": "Compiled class hash",
1379+
"description": "The Blake-migrated Cairo assembly hash corresponding to the class",
1380+
"$ref": "#/components/schemas/FELT"
1381+
}
1382+
}
1383+
}
1384+
},
13461385
"deployed_contracts": {
13471386
"title": "Deployed contracts",
13481387
"type": "array",
@@ -1418,7 +1457,7 @@
14181457
"$ref": "#/components/schemas/STATE_DIFF"
14191458
}
14201459
},
1421-
"required": ["old_root", "state_diff"],
1460+
"required": ["state_diff"],
14221461
"additionalProperties": false
14231462
},
14241463
"STATE_UPDATE": {
@@ -1608,6 +1647,44 @@
16081647
"title": "Starknet version",
16091648
"description": "Semver of the current Starknet protocol",
16101649
"type": "string"
1650+
},
1651+
"event_commitment": {
1652+
"title": "Event commitment",
1653+
"description": "The root of Merkle Patricia trie for events in the block. For blocks where this data is not available (e.g., old blocks), use 0x0",
1654+
"$ref": "#/components/schemas/FELT"
1655+
},
1656+
"transaction_commitment": {
1657+
"title": "Transaction commitment",
1658+
"description": "The root of Merkle Patricia trie for transactions in the block. For blocks where this data is not available (e.g., old blocks), use 0x0",
1659+
"$ref": "#/components/schemas/FELT"
1660+
},
1661+
"receipt_commitment": {
1662+
"title": "Receipt commitment",
1663+
"description": "The root of Merkle Patricia trie for receipts in the block. For blocks where this data is not available (e.g., old blocks), use 0x0",
1664+
"$ref": "#/components/schemas/FELT"
1665+
},
1666+
"state_diff_commitment": {
1667+
"title": "State diff commitment",
1668+
"description": "The state diff commitment hash in the block. For blocks where this data is not available (e.g., old blocks), use 0x0",
1669+
"$ref": "#/components/schemas/FELT"
1670+
},
1671+
"event_count": {
1672+
"title": "Event count",
1673+
"description": "The number of events in the block",
1674+
"type": "integer",
1675+
"minimum": 0
1676+
},
1677+
"transaction_count": {
1678+
"title": "Transaction count",
1679+
"description": "The number of transactions in the block",
1680+
"type": "integer",
1681+
"minimum": 0
1682+
},
1683+
"state_diff_length": {
1684+
"title": "State diff length",
1685+
"description": "The length of the state diff in the block. For blocks where this data is not available (e.g., old blocks), compute from state diff if possible, otherwise use 0",
1686+
"type": "integer",
1687+
"minimum": 0
16111688
}
16121689
},
16131690
"required": [
@@ -1621,7 +1698,14 @@
16211698
"l2_gas_price",
16221699
"l1_data_gas_price",
16231700
"l1_da_mode",
1624-
"starknet_version"
1701+
"starknet_version",
1702+
"event_commitment",
1703+
"transaction_commitment",
1704+
"receipt_commitment",
1705+
"state_diff_commitment",
1706+
"event_count",
1707+
"transaction_count",
1708+
"state_diff_length"
16251709
]
16261710
},
16271711
"PRE_CONFIRMED_BLOCK_HEADER": {
@@ -3805,7 +3889,7 @@
38053889
},
38063890
"ENTRYPOINT_NOT_FOUND": {
38073891
"code": 21,
3808-
"message": "Requested entrypoint does not exist in the contract"
3892+
"message": "Requested entry point does not exist in the contract"
38093893
},
38103894
"BLOCK_NOT_FOUND": {
38113895
"code": 24,

‎api/starknet_executables.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"openrpc": "1.0.0",
33
"info": {
4-
"version": "0.9.0",
4+
"version": "0.10.0",
55
"title": "API for getting Starknet executables from nodes that store compiled artifacts",
66
"license": {}
77
},

‎api/starknet_metadata.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"openrpc": "1.0.0",
33
"info": {
4-
"version": "0.9.0",
4+
"version": "0.10.0",
55
"title": "Starknet ABI specs"
66
},
77
"methods": [],

‎api/starknet_trace_api_openrpc.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"openrpc": "1.0.0-rc1",
33
"info": {
4-
"version": "0.9.0",
4+
"version": "0.10.0",
55
"title": "StarkNet Trace API",
66
"license": {}
77
},

‎api/starknet_write_api.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"openrpc": "1.0.0-rc1",
33
"info": {
4-
"version": "0.9.0",
4+
"version": "0.10.0",
55
"title": "StarkNet Node Write API",
66
"license": {}
77
},

‎api/starknet_ws_api.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"openrpc": "1.3.2",
33
"info": {
4-
"version": "0.9.0",
4+
"version": "0.10.0",
55
"title": "StarkNet WebSocket RPC API",
66
"license": {}
77
},
@@ -338,7 +338,7 @@
338338
{
339339
"name": "starknet_subscriptionReorg",
340340
"description": "Notifies the subscriber of a reorganization of the chain",
341-
"summary": "Can be received from subscribing to newHeads, Events, TransactionStatus",
341+
"summary": "Can be received from subscribing to newHeads, Events, TransactionStatus, NewTransactionReceipts, NewTransactions",
342342
"params": [
343343
{
344344
"name": "subscription_id",

‎starknet_vs_ethereum_node_apis.md‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -50,17 +50,17 @@ We list below the methods in Ethereum's API and their corresponding StarkNet met
5050
| --------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- | --------- | --------------------------- |
5151
| eth_blockNumber | starknet_blockNumber | Will return only the block number |
5252
| eth_chainId | starknet_chainId | |
53-
| eth_getBlockByNumber | starknet_getBlockByNumber | <ul><li> Doesn’t have the include transactions input.</li><li> The result key is “result”.</li></ul> |
54-
| eth_getBlockTransactionCountByHash | starknet_getBlockTransactionCountByHash | <ul><li> Supports also “latest” block tag as input</li><li> The result is always an integer</li><li> The response key is “result”.</li><li> May return an error for invalid block hash.</li></ul> |
55-
| eth_getBlockTransactionCountByNumber | starknet_getBlockTransactionCountByNumber | <ul><li> Block number input is given as a decimal integer.</li><li> The result key is “result”.</li><li> May return an error for invalid block number.</li></ul> |
53+
| eth_getBlockByNumber | starknet_getBlockByNumber | <ul><li> Doesn’t have the include transactions input.</li><li> The result key is "result".</li></ul> |
54+
| eth_getBlockTransactionCountByHash | starknet_getBlockTransactionCountByHash | <ul><li> Supports also "latest" block tag as input</li><li> The result is always an integer</li><li> The response key is "result".</li><li> May return an error for invalid block hash.</li></ul> |
55+
| eth_getBlockTransactionCountByNumber | starknet_getBlockTransactionCountByNumber | <ul><li> Block number input is given as a decimal integer.</li><li> The result key is "result".</li><li> May return an error for invalid block number.</li></ul> |
5656
| eth_getTransactionByBlockHashAndIndex | starknet_getTransactionByBlockHashAndIndex | <li> The Index is given as a decimal integer. |
5757
| eth_getTransactionByBlockNumberAndIndex | starknet_getTransactionByBlockNumberAndIndex | <li> The index is given as a decimal integer. |
58-
| eth_pendingTransactions | starknet_pendingTransactions | <ul><li> The result key is “result”.</li><li> Will not return market fee parameters.</li></ul> |
59-
| eth_getBlockByHash | starknet_getBlockByHash | <ul><li> Doesn’t have the include transactions input.</li><li> The result key is “result”.</li></ul> |
58+
| eth_pendingTransactions | starknet_pendingTransactions | <ul><li> The result key is "result".</li><li> Will not return market fee parameters.</li></ul> |
59+
| eth_getBlockByHash | starknet_getBlockByHash | <ul><li> Doesn’t have the include transactions input.</li><li> The result key is "result".</li></ul> |
6060
| eth_protocolVersion | starknet_protocolVersion |
6161
| eth_syncing | starknet_syncing | <li> The result will not include known and pulled states |
62-
| eth_getStorageAt | starknet_getStorageAt | <ul><li> Accepts a block hash instead of a block number</li><li> The result key is “result”.</li><li> The result type is a field element.</li><li> Will return errors for invalid contract or storage keys.</li></ul> |
63-
| eth_getTransactionByHash | starknet_getTransactionByHash | <ul><li> Input key is “transaction_hash”.</li><li> The result key is “result”.</li><li> Will not return null.</li><li> Will return an error for an invalid transaction hash.</li></ul> |
64-
| eth_getTransactionReceipt | starknet_getTransactionReceipt | <ul><li> Input key is “transaction_hash”.</li><li> The result key is “result”.</li><li> Will not return null.</li><li> Will return an error for an invalid transaction hash.</li></ul> |
65-
| eth_getCode | starknet_getCode | <ul><li> The input key is “contract_address”.</li><li> Does not accept a block number.</li><li> Will return byte code (field elements) and ABI.</li><li> Will return an error for an invalid contract address.</li></ul> |
62+
| eth_getStorageAt | starknet_getStorageAt | <ul><li> Accepts a block hash instead of a block number</li><li> The result key is "result".</li><li> The result type is a field element.</li><li> Will return errors for invalid contract or storage keys.</li></ul> |
63+
| eth_getTransactionByHash | starknet_getTransactionByHash | <ul><li> Input key is "transaction_hash".</li><li> The result key is "result".</li><li> Will not return null.</li><li> Will return an error for an invalid transaction hash.</li></ul> |
64+
| eth_getTransactionReceipt | starknet_getTransactionReceipt | <ul><li> Input key is "transaction_hash".</li><li> The result key is "result".</li><li> Will not return null.</li><li> Will return an error for an invalid transaction hash.</li></ul> |
65+
| eth_getCode | starknet_getCode | <ul><li> The input key is "contract_address".</li><li> Does not accept a block number.</li><li> Will return byte code (field elements) and ABI.</li><li> Will return an error for an invalid contract address.</li></ul> |
6666
| eth_call | starknet_call | <ul><li> Input transaction is different.</li><li> Input block designated by hash.</li><li> Will return errors for invalid contract address | message selector | call data | or general error.</li></ul> |

‎wallet-api/wallet_rpc.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -646,7 +646,7 @@
646646
"calldata": {
647647
"type": "array",
648648
"title": "calldata",
649-
"description": "Calldata to be passed to the entrypoint",
649+
"description": "Calldata to be passed to the entry point",
650650
"items": {
651651
"$ref": "#/components/schemas/FELT"
652652
}

0 commit comments

Comments
 (0)