solang 0.2.1

Solang Solidity Compiler
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
{
    "fileTypes": [
        "sol"
    ],
    "name": "Solidity",
    "patterns": [
        {
            "include": "#natspec"
        },
        {
            "include": "#comment"
        },
        {
            "include": "#operator"
        },
        {
            "include": "#control"
        },
        {
            "include": "#constant"
        },
        {
            "include": "#number"
        },
        {
            "include": "#string"
        },
        {
            "include": "#type"
        },
        {
            "include": "#global"
        },
        {
            "include": "#declaration"
        },
        {
            "include": "#function-call"
        },
        {
            "include": "#assembly"
        },
        {
            "include": "#punctuation"
        }
    ],
    "repository": {
        "natspec": {
            "patterns": [
                {
                    "begin": "/\\*\\*",
                    "end": "\\*/",
                    "name": "comment.block.documentation.solidity",
                    "patterns": [
                        {
                            "include": "#natspec-tags"
                        }
                    ]
                },
                {
                    "begin": "///",
                    "end": "$",
                    "name": "comment.block.documentation.solidity",
                    "patterns": [
                        {
                            "include": "#natspec-tags"
                        }
                    ]
                }
            ]
        },
        "natspec-tags": {
            "patterns": [
                {
                    "include": "#natspec-tag-title"
                },
                {
                    "include": "#natspec-tag-author"
                },
                {
                    "include": "#natspec-tag-notice"
                },
                {
                    "include": "#natspec-tag-dev"
                },
                {
                    "include": "#natspec-tag-param"
                },
                {
                    "include": "#natspec-tag-return"
                }
            ]
        },
        "natspec-tag-title": {
            "match": "(@title)\\b",
            "name": "storage.type.title.natspec"
        },
        "natspec-tag-author": {
            "match": "(@author)\\b",
            "name": "storage.type.author.natspec"
        },
        "natspec-tag-notice": {
            "match": "(@notice)\\b",
            "name": "storage.type.dev.natspec"
        },
        "natspec-tag-dev": {
            "match": "(@dev)\\b",
            "name": "storage.type.dev.natspec"
        },
        "natspec-tag-param": {
            "match": "(@param)(\\s+([A-Za-z_]\\w*))?\\b",
            "captures": {
                "1": {
                    "name": "storage.type.param.natspec"
                },
                "3": {
                    "name": "variable.other.natspec"
                }
            }
        },
        "natspec-tag-return": {
            "match": "(@return)\\b",
            "name": "storage.type.return.natspec"
        },
        "comment": {
            "patterns": [
                {
                    "include": "#comment-line"
                },
                {
                    "include": "#comment-block"
                }
            ]
        },
        "comment-line": {
            "match": "(?<!tp:)//.*?$",
            "name": "comment.line.solidity"
        },
        "comment-block": {
            "begin": "/\\*",
            "end": "\\*/",
            "name": "comment.block.solidity"
        },
        "operator": {
            "patterns": [
                {
                    "include": "#operator-logic"
                },
                {
                    "include": "#operator-mapping"
                },
                {
                    "include": "#operator-arithmetic"
                },
                {
                    "include": "#operator-binary"
                },
                {
                    "include": "#operator-assignment"
                }
            ]
        },
        "operator-logic": {
            "match": "(==|<(?!<)|<=|>(?!>)|>=|\\&\\&|\\|\\||\\:(?!=)|\\?)",
            "name": "keyword.operator.logic.solidity"
        },
        "operator-mapping": {
            "match": "(=>)",
            "name": "keyword.operator.mapping.solidity"
        },
        "operator-arithmetic": {
            "match": "(\\+|\\-|\\/|\\*)",
            "name": "keyword.operator.arithmetic.solidity"
        },
        "operator-binary": {
            "match": "(\\^|\\&|\\||<<|>>)",
            "name": "keyword.operator.binary.solidity"
        },
        "operator-assignment": {
            "match": "(\\:?=)",
            "name": "keyword.operator.assignment.solidity"
        },
        "control": {
            "patterns": [
                {
                    "include": "#control-flow"
                },
                {
                    "include": "#control-using"
                },
                {
                    "include": "#control-import"
                },
                {
                    "include": "#control-pragma"
                },
                {
                    "include": "#control-underscore"
                },
                {
                    "include": "#control-other"
                }
            ]
        },
        "control-flow": {
            "match": "\\b(if|else|for|while|do|break|continue|throw|returns?)\\b",
            "name": "keyword.control.flow.solidity"
        },
        "control-using": {
            "match": "\\b(using)\\b",
            "name": "keyword.control.using.solidity"
        },
        "control-import": {
            "match": "\\b(import)\\b",
            "name": "keyword.control.import.solidity"
        },
        "control-pragma": {
            "match": "\\b(pragma)(?:\\s+([A-Za-z_]\\w+)\\s+([^\\s]+))?\\b",
            "captures": {
                "1": {
                    "name": "keyword.control.pragma.solidity"
                },
                "2": {
                    "name": "entity.name.tag.pragma.solidity"
                },
                "3": {
                    "name": "constant.other.pragma.solidity"
                }
            }
        },
        "control-underscore": {
            "match": "\\b(_)\\b",
            "name": "constant.other.underscore.solidity"
        },
        "control-other": {
            "match": "\\b(new|delete|emit)\\b",
            "name": "keyword.control.solidity"
        },
        "constant": {
            "patterns": [
                {
                    "include": "#constant-boolean"
                },
                {
                    "include": "#constant-time"
                },
                {
                    "include": "#constant-currency"
                }
            ]
        },
        "constant-boolean": {
            "match": "\\b(true|false)\\b",
            "name": "constant.language.boolean.solidity"
        },
        "constant-time": {
            "match": "\\b(seconds|minutes|hours|days|weeks|years)\\b",
            "name": "constant.language.time.solidity"
        },
        "constant-currency": {
            "match": "\\b(ether|wei)\\b",
            "name": "constant.language.currency.solidity"
        },
        "number": {
            "patterns": [
                {
                    "include": "#number-decimal"
                },
                {
                    "include": "#number-hex"
                }
            ]
        },
        "number-decimal": {
            "match": "\\b(\\d+(\\.\\d+)?)\\b",
            "name": "constant.numeric.decimal.solidity"
        },
        "number-hex": {
            "match": "\\b(0[xX][a-fA-F0-9]+)\\b",
            "name": "constant.numeric.hexadecimal.solidity"
        },
        "string": {
            "patterns": [
                {
                    "match": "\\\".*?\\\"",
                    "name": "string.quoted.double.solidity"
                },
                {
                    "match": "\\'.*?\\'",
                    "name": "string.quoted.single.solidity"
                }
            ]
        },
        "type": {
            "patterns": [
                {
                    "include": "#type-primitive"
                }
            ]
        },
        "type-primitive": {
            "match": "\\b(address|string\\d*|bytes\\d*|int\\d*|uint\\d*|bool|hash\\d*)\\b",
            "name": "support.type.primitive.solidity"
        },
        "global": {
            "patterns": [
                {
                    "include": "#global-variables"
                },
                {
                    "include": "#global-functions"
                }
            ]
        },
        "global-variables": {
            "patterns": [
                {
                    "match": "\\b(msg|block|tx|now)\\b",
                    "name": "variable.language.transaction.solidity"
                },
                {
                    "match": "\\b(this)\\b",
                    "name": "variable.language.this.solidity"
                },
                {
                    "match": "\\b(super)\\b",
                    "name": "variable.language.super.solidity"
                }
            ]
        },
        "global-functions": {
            "patterns": [
                {
                    "match": "\\b(require|assert|revert)\\b",
                    "name": "keyword.control.exceptions.solidity"
                },
                {
                    "match": "\\b(selfdestruct|suicide)\\b",
                    "name": "keyword.control.contract.solidity"
                },
                {
                    "match": "\\b(addmod|mulmod|keccak256|sha256|sha3|ripemd160|ecrecover)\\b",
                    "name": "support.function.math.solidity"
                },
                {
                    "match": "\\b(blockhash|gasleft)\\b",
                    "name": "variable.language.transaction.solidity"
                }
            ]
        },
        "declaration": {
            "patterns": [
                {
                    "include": "#declaration-contract"
                },
                {
                    "include": "#declaration-interface"
                },
                {
                    "include": "#declaration-library"
                },
                {
                    "include": "#declaration-struct"
                },
                {
                    "include": "#declaration-event"
                },
                {
                    "include": "#declaration-enum"
                },
                {
                    "include": "#declaration-function"
                },
                {
                    "include": "#declaration-constructor"
                },
                {
                    "include": "#declaration-modifier"
                },
                {
                    "include": "#declaration-mapping"
                }
            ]
        },
        "declaration-contract": {
            "patterns": [
                {
                    "match": "\\b(contract)(\\s+([A-Za-z_]\\w*))?\\b",
                    "captures": {
                        "1": {
                            "name": "storage.type.contract.solidity"
                        },
                        "3": {
                            "name": "entity.name.type.contract.solidity"
                        }
                    }
                },
                {
                    "match": "\\b(is)\\b",
                    "name": "storage.modifier.is.solidity"
                }
            ]
        },
        "declaration-interface": {
            "match": "\\b(interface)(\\s+([A-Za-z_]\\w*))?\\b",
            "captures": {
                "1": {
                    "name": "storage.type.interface.solidity"
                },
                "3": {
                    "name": "entity.name.type.interface.solidity"
                }
            }
        },
        "declaration-library": {
            "match": "\\b(library)(\\s+([A-Za-z_]\\w*))?\\b",
            "captures": {
                "1": {
                    "name": "storage.type.library.solidity"
                },
                "3": {
                    "name": "entity.name.type.library.solidity"
                }
            }
        },
        "declaration-struct": {
            "match": "\\b(struct)(\\s+([A-Za-z_]\\w*))?\\b",
            "captures": {
                "1": {
                    "name": "storage.type.struct.solidity"
                },
                "3": {
                    "name": "entity.name.type.struct.solidity"
                }
            }
        },
        "declaration-event": {
            "match": "\\b(event)(\\s+([A-Za-z_]\\w*))?\\b",
            "captures": {
                "1": {
                    "name": "storage.type.event.solidity"
                },
                "3": {
                    "name": "entity.name.type.event.solidity"
                }
            }
        },
        "declaration-constructor": {
            "match": "\\b(constructor)\\b",
            "captures": {
                "1": {
                    "name": "storage.type.constructor.solidity"
                }
            }
        },
        "declaration-enum": {
            "match": "\\b(enum)(\\s+([A-Za-z_]\\w*))?\\b",
            "captures": {
                "1": {
                    "name": "storage.type.enum.solidity"
                },
                "3": {
                    "name": "entity.name.type.enum.solidity"
                }
            }
        },
        "declaration-function": {
            "patterns": [
                {
                    "match": "\\b(function)\\s+([A-Za-z_]\\w*)\\b",
                    "captures": {
                        "1": {
                            "name": "storage.type.function.solidity"
                        },
                        "2": {
                            "name": "entity.name.function.solidity"
                        }
                    }
                },
                {
                    "match": "\\b(private|public|internal|external|constant|pure|view|payable|nonpayable|inherited|indexed|storage|memory|virtual|override)\\b",
                    "name": "storage.type.mofifier.solidity"
                }
            ]
        },
        "declaration-modifier": {
            "match": "\\b(modifier)(\\s+([A-Za-z_]\\w*))?\\b",
            "captures": {
                "1": {
                    "name": "storage.type.modifier.solidity"
                },
                "3": {
                    "name": "entity.name.function.solidity"
                }
            }
        },
        "declaration-mapping": {
            "match": "\\b(mapping)\\b",
            "name": "storage.type.mapping.solidity"
        },
        "function-call": {
            "match": "\\b([A-Za-z_]\\w*)\\s*\\(",
            "captures": {
                "1": {
                    "name": "entity.name.function.solidity"
                }
            }
        },
        "assembly": {
            "patterns": [
                {
                    "match": "\\b(assembly)\\b",
                    "name": "keyword.control.assembly.solidity"
                },
                {
                    "match": "\\b(let)\\b",
                    "name": "storage.type.assembly.solidity"
                }
            ]
        },
        "punctuation": {
            "patterns": [
                {
                    "match": ";",
                    "name": "punctuation.terminator.statement.solidity"
                },
                {
                    "match": "\\.",
                    "name": "punctuation.accessor.solidity"
                },
                {
                    "match": ",",
                    "name": "punctuation.separator.solidity"
                }
            ]
        }
    },
    "scopeName": "source.solidity",
    "uuid": "123"
}