Skip to content

Commit 428b49c

Browse files
laviniat1996laviniat1996
committed
fix linting
1 parent abe0e08 commit 428b49c

File tree

1 file changed

+96
-96
lines changed

1 file changed

+96
-96
lines changed

‎ecosystem/api/toncenter/v2-errors.mdx‎

Lines changed: 96 additions & 96 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,16 @@ title: "API v2 error codes"
44

55
## Overview
66

7-
| Status | Meaning |
8-
|--------|---------|
9-
| 404 | Data not found |
10-
| 405 | Wrong HTTP method (use GET or POST) |
11-
| 409 | Resource exists but wrong type |
12-
| 422 | Invalid request parameters |
13-
| 429 | Rate limit exceeded |
14-
| 500 | Server-side failure |
15-
| 504 | Timeout waiting for liteserver |
16-
| 542 | Liteserver-specific error or unsupported stack type |
7+
| Status | Meaning |
8+
| ------ | --------------------------------------------------- |
9+
| 404 | Data not found |
10+
| 405 | Wrong HTTP method (use GET or POST) |
11+
| 409 | Resource exists but wrong type |
12+
| 422 | Invalid request parameters |
13+
| 429 | Rate limit exceeded |
14+
| 500 | Server-side failure |
15+
| 504 | Timeout waiting for liteserver |
16+
| 542 | Liteserver-specific error or unsupported stack type |
1717

1818
---
1919

@@ -23,66 +23,66 @@ title: "API v2 error codes"
2323

2424
**Endpoint:** `/api/v2/sendBoc`, `/api/v2/sendBocReturnHash`
2525

26-
| Status | Error | Fix |
27-
|--------|-------|-----|
28-
| 422 | `empty boc` | Include a non-empty `boc` field in request body |
29-
| 429 | `Ratelimit exceeded` | Back off and retry |
30-
| 500 | `Exit code <N> != 0` | Transaction simulation failed, check your BOC |
31-
| 504 | `LITE_SERVER_NETWORK timeout...` | Liteserver didn't respond in time, retry |
26+
| Status | Error | Fix |
27+
| ------ | -------------------------------- | ----------------------------------------------- |
28+
| 422 | `empty boc` | Include a non-empty `boc` field in request body |
29+
| 429 | `Ratelimit exceeded` | Back off and retry |
30+
| 500 | `Exit code <N> != 0` | Transaction simulation failed, check your BOC |
31+
| 504 | `LITE_SERVER_NETWORK timeout...` | Liteserver didn't respond in time, retry |
3232

3333
---
3434

3535
### Querying transactions
3636

3737
**Endpoints:** `/api/v2/getTransactions`, `/api/v2/tryLocateTx`, `/api/v2/tryLocateResultTx`, `/api/v2/tryLocateSourceTx`
3838

39-
| Status | Error | Fix |
40-
|--------|-------|-----|
41-
| 404 | `transaction not found` | No matching transaction exists for that source/destination/lt |
42-
| 422 | `failed to parse address` | Address format is invalid |
43-
| 422 | `failed to parse hash` | Hash format is invalid |
44-
| 422 | `failed to parse lt` / `failed to parse created_lt` | Not a valid 64-bit integer |
45-
| 422 | `lt should be non-negative` / `created_lt should be non-negative` | Value can't be negative |
46-
| 422 | `lt and hash should be used together` | Provide both or neither |
47-
| 422 | `empty source address` / `empty destination address` | Required parameter is missing |
48-
| 422 | `limit should be positive` | Must be ≥ 1 |
49-
| 422 | `limit should be less or equal 1000` | Max is 1000 |
39+
| Status | Error | Fix |
40+
| ------ | ----------------------------------------------------------------- | ------------------------------------------------------------- |
41+
| 404 | `transaction not found` | No matching transaction exists for that source/destination/lt |
42+
| 422 | `failed to parse address` | Address format is invalid |
43+
| 422 | `failed to parse hash` | Hash format is invalid |
44+
| 422 | `failed to parse lt` / `failed to parse created_lt` | Not a valid 64-bit integer |
45+
| 422 | `lt should be non-negative` / `created_lt should be non-negative` | Value can't be negative |
46+
| 422 | `lt and hash should be used together` | Provide both or neither |
47+
| 422 | `empty source address` / `empty destination address` | Required parameter is missing |
48+
| 422 | `limit should be positive` | Must be ≥ 1 |
49+
| 422 | `limit should be less or equal 1000` | Max is 1000 |
5050

5151
---
5252

5353
### Querying addresses & balances
5454

5555
**Endpoint:** `/api/v2/getAddressBalance`
5656

57-
| Status | Error | Fix |
58-
|--------|-------|-----|
59-
| 422 | `empty address` | Include the `address` parameter |
60-
| 422 | `failed to parse seqno` | Not a valid integer |
61-
| 422 | `seqno should be positive` | Must be ≥ 1 |
57+
| Status | Error | Fix |
58+
| ------ | -------------------------- | ------------------------------- |
59+
| 422 | `empty address` | Include the `address` parameter |
60+
| 422 | `failed to parse seqno` | Not a valid integer |
61+
| 422 | `seqno should be positive` | Must be ≥ 1 |
6262

6363
---
6464

6565
### Querying blocks
6666

6767
**Endpoints:** `/api/v2/getBlockHeader`, `/api/v2/getBlockTransactionsExt`, `/api/v2/getShardBlockProof`, `/api/v2/lookupBlock`
6868

69-
| Status | Error | Fix |
70-
|--------|-------|-----|
71-
| 422 | `workchain required` | Include `workchain` parameter |
72-
| 422 | `shard required` | Include `shard` parameter |
73-
| 422 | `seqno required` | Include `seqno` parameter |
74-
| 422 | `failed to parse workchain` | Not a valid integer |
75-
| 422 | `failed to parse shard` | Not a valid shard identifier |
76-
| 422 | `failed to parse root_hash` | Not a valid 256-bit hash |
77-
| 422 | `failed to parse seqno` | Not a valid integer |
78-
| 422 | `seqno should be positive` | Must be ≥ 1 |
79-
| 422 | `from_seqno should be non-negative` | Can't be negative |
80-
| 422 | `exactly one of seqno, lt, unixtime should be specified` | Provide exactly one selector |
81-
| 422 | `lt should be non-negative` / `unixtime should be non-negative` | Can't be negative |
82-
| 422 | `after_lt and after_hash should be used together` | Provide both or neither |
83-
| 422 | `after_lt should be non-negative` | Can't be negative |
84-
| 422 | `count should be positive` | Must be ≥ 1 |
85-
| 422 | `count should be less or equal 10000` | Max is 10,000 |
69+
| Status | Error | Fix |
70+
| ------ | --------------------------------------------------------------- | ----------------------------- |
71+
| 422 | `workchain required` | Include `workchain` parameter |
72+
| 422 | `shard required` | Include `shard` parameter |
73+
| 422 | `seqno required` | Include `seqno` parameter |
74+
| 422 | `failed to parse workchain` | Not a valid integer |
75+
| 422 | `failed to parse shard` | Not a valid shard identifier |
76+
| 422 | `failed to parse root_hash` | Not a valid 256-bit hash |
77+
| 422 | `failed to parse seqno` | Not a valid integer |
78+
| 422 | `seqno should be positive` | Must be ≥ 1 |
79+
| 422 | `from_seqno should be non-negative` | Can't be negative |
80+
| 422 | `exactly one of seqno, lt, unixtime should be specified` | Provide exactly one selector |
81+
| 422 | `lt should be non-negative` / `unixtime should be non-negative` | Can't be negative |
82+
| 422 | `after_lt and after_hash should be used together` | Provide both or neither |
83+
| 422 | `after_lt should be non-negative` | Can't be negative |
84+
| 422 | `count should be positive` | Must be ≥ 1 |
85+
| 422 | `count should be less or equal 10000` | Max is 10,000 |
8686

8787
---
8888

@@ -92,36 +92,36 @@ title: "API v2 error codes"
9292

9393
#### Request validation (422)
9494

95-
| Error | Fix |
96-
|-------|-----|
97-
| `Stack should be array` / `Invalid stack format: array expected` | `stack` must be a JSON array |
98-
| `Invalid stack entry format: array of exact 2 elements expected` | Each entry needs `[type, value]` |
99-
| `Invalid stack entry format: invalid type <type>` | Use valid types: `num`, `cell`, `slice`, etc. |
100-
| `Invalid stack entry format: base64 string expected` | Cell/slice values must be base64 |
101-
| `Invalid tvm.Cell, base64 string expected` / `Invalid tvm.Slice, base64 string expected` | Use base64 encoding |
102-
| `Invalid cell, object with field bytes expected` / `Invalid slice, object with field bytes expected` | Object must have `bytes` field |
103-
| `Empty tvm.Cell` / `Empty tvm.Slice` / `Empty cell` / `Empty slice` | Value can't be empty |
104-
| `Invalid tvm.List, valid tvm_stackEntryList expected` | Malformed list entry |
105-
| `Invalid tvm.Tuple, valid tvm_stackEntryTuple expected` | Malformed tuple entry |
106-
| `Expected string as first element in stack entry` | First element must be type tag string |
107-
| `Wrong type of number in stack entry` | Number format is wrong |
95+
| Error | Fix |
96+
| ---------------------------------------------------------------------------------------------------- | --------------------------------------------- |
97+
| `Stack should be array` / `Invalid stack format: array expected` | `stack` must be a JSON array |
98+
| `Invalid stack entry format: array of exact 2 elements expected` | Each entry needs `[type, value]` |
99+
| `Invalid stack entry format: invalid type <type>` | Use valid types: `num`, `cell`, `slice`, etc. |
100+
| `Invalid stack entry format: base64 string expected` | Cell/slice values must be base64 |
101+
| `Invalid tvm.Cell, base64 string expected` / `Invalid tvm.Slice, base64 string expected` | Use base64 encoding |
102+
| `Invalid cell, object with field bytes expected` / `Invalid slice, object with field bytes expected` | Object must have `bytes` field |
103+
| `Empty tvm.Cell` / `Empty tvm.Slice` / `Empty cell` / `Empty slice` | Value can't be empty |
104+
| `Invalid tvm.List, valid tvm_stackEntryList expected` | Malformed list entry |
105+
| `Invalid tvm.Tuple, valid tvm_stackEntryTuple expected` | Malformed tuple entry |
106+
| `Expected string as first element in stack entry` | First element must be type tag string |
107+
| `Wrong type of number in stack entry` | Number format is wrong |
108108

109109
#### Execution errors (500)
110110

111-
| Error | Meaning |
112-
|-------|---------|
113-
| `Exit code <N> != 0` | Get method returned non-zero exit code |
114-
| `Stack size <N> < 5` | Contract returned fewer values than expected |
115-
| `Failed to parse int: <value>` | Couldn't parse numeric result |
116-
| `stackEntryNumber expected` / `stackEntryNumber expected at 0 position` | Expected number, got something else |
117-
| `stackEntryCell expected at <N> position` | Expected cell at that stack position |
118-
| `stackEntryCell or stackEntrySlice expected` | Expected cell or slice, got something else |
119-
| `addr_ext is not supported` / `addr_var is not supported` / `anycast is not supported` | Address type not supported by converter |
111+
| Error | Meaning |
112+
| -------------------------------------------------------------------------------------- | -------------------------------------------- |
113+
| `Exit code <N> != 0` | Get method returned non-zero exit code |
114+
| `Stack size <N> < 5` | Contract returned fewer values than expected |
115+
| `Failed to parse int: <value>` | Couldn't parse numeric result |
116+
| `stackEntryNumber expected` / `stackEntryNumber expected at 0 position` | Expected number, got something else |
117+
| `stackEntryCell expected at <N> position` | Expected cell at that stack position |
118+
| `stackEntryCell or stackEntrySlice expected` | Expected cell or slice, got something else |
119+
| `addr_ext is not supported` / `addr_var is not supported` / `anycast is not supported` | Address type not supported by converter |
120120

121121
#### Unsupported types (542)
122122

123-
| Error | Meaning |
124-
|-------|---------|
123+
| Error | Meaning |
124+
| -------------------------------------- | ----------------------------------- |
125125
| `Unsupported stack entry type: <type>` | Server can't decode this stack type |
126126

127127
---
@@ -132,54 +132,54 @@ title: "API v2 error codes"
132132

133133
Same stack/cell/slice validation as get methods (422), plus:
134134

135-
| Status | Error | Meaning |
136-
|--------|-------|---------|
137-
| 500 | `Exit code <N> != 0` | Simulation failed |
138-
| 500 | `addr_ext is not supported` / `addr_var is not supported` / `anycast is not supported` | Unsupported address type |
135+
| Status | Error | Meaning |
136+
| ------ | -------------------------------------------------------------------------------------- | ------------------------ |
137+
| 500 | `Exit code <N> != 0` | Simulation failed |
138+
| 500 | `addr_ext is not supported` / `addr_var is not supported` / `anycast is not supported` | Unsupported address type |
139139

140140
---
141141

142142
### Token & NFT data
143143

144144
**Endpoint:** `/api/v2/getTokenData`
145145

146-
| Status | Error | Meaning |
147-
|--------|-------|---------|
148-
| 409 | `Smart contract <address> is not Jetton or NFT` | Contract doesn't implement Jetton/NFT interface |
149-
| 500 | `Failed to unpack token data` | Couldn't decode metadata cell |
150-
| 500 | `Invalid uri` / `missing uri field in offchain data` | Metadata URI is missing or malformed |
151-
| 500 | `failed to serialize TokenData` | Internal serialization error |
152-
| 500 | `Exit code <N> != 0` | Get method failed |
153-
| 500 | `Stack size <N> < 5` | Not enough return values |
146+
| Status | Error | Meaning |
147+
| ------ | ---------------------------------------------------- | ----------------------------------------------- |
148+
| 409 | `Smart contract <address> is not Jetton or NFT` | Contract doesn't implement Jetton/NFT interface |
149+
| 500 | `Failed to unpack token data` | Couldn't decode metadata cell |
150+
| 500 | `Invalid uri` / `missing uri field in offchain data` | Metadata URI is missing or malformed |
151+
| 500 | `failed to serialize TokenData` | Internal serialization error |
152+
| 500 | `Exit code <N> != 0` | Get method failed |
153+
| 500 | `Stack size <N> < 5` | Not enough return values |
154154

155155
---
156156

157157
### Config parameters
158158

159159
**Endpoint:** `/api/v2/getConfigParam`
160160

161-
| Status | Error | Fix |
162-
|--------|-------|-----|
163-
| 422 | `failed to parse config_id` / `failed to parse param` | Not a valid integer |
164-
| 422 | `only one of config_id or param should be specified` | Use one or the other, not both |
165-
| 422 | `param should be non-negative` | Can't be negative |
161+
| Status | Error | Fix |
162+
| ------ | ----------------------------------------------------- | ------------------------------ |
163+
| 422 | `failed to parse config_id` / `failed to parse param` | Not a valid integer |
164+
| 422 | `only one of config_id or param should be specified` | Use one or the other, not both |
165+
| 422 | `param should be non-negative` | Can't be negative |
166166

167167
---
168168

169169
### Libraries
170170

171171
**Endpoint:** `/api/v2/getLibraries`
172172

173-
| Status | Error | Fix |
174-
|--------|-------|-----|
175-
| 422 | `failed to parse libraries` | Must be a valid JSON array of library IDs |
173+
| Status | Error | Fix |
174+
| ------ | --------------------------- | ----------------------------------------- |
175+
| 422 | `failed to parse libraries` | Must be a valid JSON array of library IDs |
176176

177177
---
178178

179179
### JSON-RPC
180180

181181
**Endpoint:** `/api/v2/jsonRPC`
182182

183-
| Status | Error | Fix |
184-
|--------|-------|-----|
185-
| 422 | `params must contain an object` | `params` must be a single JSON object, not an array |
183+
| Status | Error | Fix |
184+
| ------ | ------------------------------- | --------------------------------------------------- |
185+
| 422 | `params must contain an object` | `params` must be a single JSON object, not an array |

0 commit comments

Comments
 (0)