AST node metadata (referenced declarations)

[0xalpharush]

Version Information

• vyper Version (output of vyper --version): 0.3.7
• OS: osx/linux/win
• Python Version (output of python --version):

What's your issue about?

Vyper AST nodes should add additional metata data indicating which declaration a given use references. This is useful for name resolution and would make it easier to create something like a Vyper LSP. While Vyper prevents many instances of shadowing that would make name resolution ambiguous, this additional info would further disambiguate issues outlined like those in #3582 and #3581.

Further, all ids of contracts and other declaration AST nodes must be unique for the entire compilation unit i.e. all contract ids, function defs, struct defs, etc should be unique.

How can it be fixed?

Add reference declaration field to each use of identifiers (Name AST nodes).