{"componentChunkName":"component---src-templates-post-template-js","path":"/posts/crypto/solidity-notes","result":{"data":{"markdownRemark":{"id":"8fd8dcb8-d9b3-512c-b2bd-09894d782585","html":"

Solidity 101 Notes

\n
    \n
  1. A ‘^’ symbol prefixed to x.y.z in the pragma indicates that the source file may be compiled only from versions starting with x.y.z until x.(y+1).z. For e.g., “pragma solidity ^0.8.3;” indicates that source file may be compiled with compiler version starting from 0.8.3 until any 0.8.z but not 0.9.z. This is known as a “floating pragma.”
    2. \n
  2. NatSpec Comments: NatSpec stands for “Ethereum Natural Language Specification Format.” These are written with a triple slash (///) or a double asterisk block(/** … */) directly above function declarations or statements to generate documentation in JSON format for developers and end-users. It is recommended that Solidity contracts are fully annotated using NatSpec for all public interfaces (everything in the ABI). These comments contain different types of tags:
    3. \n
\n

@title: A title that should describe the contract/interface

\n

@author: The name of the author (for contract, interface)

\n

@notice: Explain to an end user what this does (for contract, interface, function, public state variable, event)

\n

@dev: Explain to a developer any extra details (for contract, interface, function, state variable, event)

\n

@param: Documents a parameter (just like in doxygen) and must be followed by parameter name (for function, event)

\n

@return: Documents the return variables of a contract’s function (function, public state variable)

\n

@inheritdoc: Copies all missing tags from the base function and must be followed by the contract name (for function, public state variable)

\n

@custom…: Custom tag, semantics is application-defined (for everywhere)

","fields":{"slug":"/posts/crypto/solidity-notes","tagSlugs":["/tag/notes/","/tag/solidity/"]},"frontmatter":{"date":"2021-12-30T23:46:37.121Z","description":"Things I didn't know","tags":["Notes","Solidity"],"title":"Random Solidity Notes"}}},"pageContext":{"slug":"/posts/crypto/solidity-notes"}},"staticQueryHashes":["251939775","401334301","825871152"]}