Solidity, the Smart Contract Programming Language
Go to file
Kaan Uzdoğan 1a23b7a60a Update metadata docs
Squashed into single commit

Squashed commits:
Sort metadata JSON, add errors to devdoc & userdoc

Sorts the example metadata in the alphabetical order,
as this is the way output by the compiler.

Add playground.sourcify.dev link

Update metadata documentation content

Fix trailing whitespaces

Add new line after code-block

Fix unexpected indentation

Fix unexpected unindent

Fix unexpected unindent - 2

Suggestions from code review: wording, punctuation

Co-authored-by: Nikola Matić <nikola.matic@ethereum.org>
Fix missing trailing commas

Co-authored-by: Nikola Matić <nikola.matic@ethereum.org>
Order yul settings, fix trailing commas

Explicitly state appended to the runtime bytecode

Break down metadata content into two points

Remove trailing whitespace
2023-03-31 15:27:57 +03:00
.circleci Migrate from gitter to matrix api 2023-03-08 08:54:50 +01:00
.github Run triage action on all new issues 2023-02-21 22:04:41 +01:00
cmake Improve comment on CMP0115 2022-08-31 12:12:15 +03:00
docs Update metadata docs 2023-03-31 15:27:57 +03:00
libevmasm Do not duplicate subassemblies. 2023-02-20 22:20:45 +01:00
liblangutil Initialize vars before use 2023-02-24 12:06:01 +01:00
libsmtutil Fixes handling bitwise operators for z3 model checker 2023-02-08 18:37:17 +01:00
libsolc Add std:: qualifier to move() calls 2022-08-30 11:12:15 +02:00
libsolidity Report safe properties in BMC and CHC 2023-03-09 14:59:32 +01:00
libsolutil libsolutil: Add missing include 2023-02-04 16:22:18 +01:00
libyul Introduce helpers for VariableOffset. 2023-02-09 16:44:36 +01:00
scripts Report safe properties in BMC and CHC 2023-03-09 14:59:32 +01:00
snap Snap: update z3 2021-10-06 18:00:07 -06:00
solc Report safe properties in BMC and CHC 2023-03-09 14:59:32 +01:00
test Report safe properties in BMC and CHC 2023-03-09 14:59:32 +01:00
tools Remove solidity-upgrade 2023-01-17 07:59:43 -07:00
.clang-format Improved .clang_format file. 2020-03-22 22:23:29 +01:00
.dockerignore adds .dockerignore file 2018-06-26 12:21:04 +02:00
.editorconfig .editorconfig: Indentation rules for .yul 2020-11-10 23:31:05 +01:00
.gitattributes Create .gitattributes 2018-02-20 18:41:02 -05:00
.gitignore External tests maintenance 2022-12-16 11:34:00 +01:00
Changelog.md Report safe properties in BMC and CHC 2023-03-09 14:59:32 +01:00
CMakeLists.txt Set version to 0.8.20 2023-02-22 19:41:03 +01:00
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md 2022-11-09 14:55:59 +01:00
codecov.yml Fix patch coverage settings 2019-02-20 16:09:00 +01:00
CODING_STYLE.md Use std:: prefix with std::forward() as well to satisfy Clang 2023-03-06 18:20:49 +01:00
CONTRIBUTING.md Replace links to readthedocs.io with ones using the new domain 2020-11-18 15:20:34 +01:00
LICENSE.txt Align license to those in file headers. 2016-06-08 22:57:30 +02:00
README.md Update README maintainers 2022-11-08 16:30:00 +01:00
ReleaseChecklist.md ReleaseChecklist: Add more detail to the PPA steps 2023-02-14 14:43:32 +01:00
ReviewChecklist.md Use std:: prefix with std::forward() as well to satisfy Clang 2023-03-06 18:20:49 +01:00
SECURITY.md Replace links to readthedocs.io with ones using the new domain 2020-11-18 15:20:34 +01:00

The Solidity Contract-Oriented Programming Language

Matrix Chat Gitter Chat Solidity Forum Twitter Follow Mastodon Follow

You can talk to us on Gitter and Matrix, tweet at us on Twitter or create a new topic in the Solidity forum. Questions, feedback, and suggestions are welcome!

Solidity is a statically typed, contract-oriented, high-level language for implementing smart contracts on the Ethereum platform.

For a good overview and starting point, please check out the official Solidity Language Portal.

Table of Contents

Background

Solidity is a statically-typed curly-braces programming language designed for developing smart contracts that run on the Ethereum Virtual Machine. Smart contracts are programs that are executed inside a peer-to-peer network where nobody has special authority over the execution, and thus they allow anyone to implement tokens of value, ownership, voting, and other kinds of logic.

When deploying contracts, you should use the latest released version of Solidity. This is because breaking changes, as well as new features and bug fixes, are introduced regularly. We currently use a 0.x version number to indicate this fast pace of change.

Build and Install

Instructions about how to build and install the Solidity compiler can be found in the Solidity documentation.

Example

A "Hello World" program in Solidity is of even less use than in other languages, but still:

// SPDX-License-Identifier: MIT
pragma solidity >=0.6.0 <0.9.0;

contract HelloWorld {
    function helloWorld() external pure returns (string memory) {
        return "Hello, World!";
    }
}

To get started with Solidity, you can use Remix, which is a browser-based IDE. Here are some example contracts:

  1. Voting
  2. Blind Auction
  3. Safe remote purchase
  4. Micropayment Channel

Documentation

The Solidity documentation is hosted using Read the Docs.

Development

Solidity is still under development. Contributions are always welcome! Please follow the Developers Guide if you want to help.

You can find our current feature and bug priorities for forthcoming releases in the projects section.

Maintainers

The Solidity programming language and compiler are open-source community projects governed by a core team. The core team is sponsored by the Ethereum Foundation.

License

Solidity is licensed under GNU General Public License v3.0.

Some third-party code has its own licensing terms.

Security

The security policy may be found here.