Solidity, the Smart Contract Programming Language
Go to file
Doggo b787c32233 Update receive function documentation
The receive function documentation is slightly inaccurate currently, as a contract can still receive Ether through payable functions even if no receive or payable fallback function is present.
2022-11-08 15:59:09 +01:00
.circleci Merge pull request #13068 from ethereum/circleci-review-fixes 2022-11-02 17:30:09 +01:00
.github Properly query team members 2022-11-03 09:53:39 -03:00
cmake Improve comment on CMP0115 2022-08-31 12:12:15 +03:00
docs Update receive function documentation 2022-11-08 15:59:09 +01:00
libevmasm Merge pull request #13283 from ethereum/yulDebugger 2022-11-01 14:04:56 +01:00
liblangutil Merge pull request #13587 from ethereum/forward-declare-enum 2022-10-20 14:40:22 +02:00
libsmtutil Update CVC4::BitVector ctor call 2022-09-26 23:03:42 +02:00
libsolc Add std:: qualifier to move() calls 2022-08-30 11:12:15 +02:00
libsolidity UsingForDirective: Rename m_functions to m_functionsOrLibrary 2022-11-07 23:58:19 +01:00
libsolutil De-macro helpers. 2022-11-01 12:49:22 +01:00
libyul [libevmasm] Add Assembly::OptimiserSettings::translateSettings. 2022-10-26 14:11:59 +02:00
scripts CI: Switch from deprecated circleci/buildpack-deps image to cimg/base 2022-10-26 18:22:03 +02:00
snap Snap: update z3 2021-10-06 18:00:07 -06:00
solc [solc] Exit code 2 for exceptions. 2022-11-01 12:56:05 +01:00
test Minor test naming/style corrections 2022-11-07 23:16:02 +01:00
tools [solc] Exit code 2 for exceptions. 2022-11-01 12:56:05 +01: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 Little enhancements to the ppa release script 2022-08-11 18:36:07 +02:00
Changelog.md [solc] Exit code 2 for exceptions. 2022-11-01 12:56:05 +01:00
CMakeLists.txt Set version to 0.8.18 2022-09-08 17:59:54 +02:00
CODE_OF_CONDUCT.md Rename CONDUCT.md to CODE_OF_CONDUCT.md so that Github picks it up 2018-08-01 22:38:58 +01:00
codecov.yml Fix patch coverage settings 2019-02-20 16:09:00 +01:00
CODING_STYLE.md Fix: minor typo 2022-10-10 08:33:44 +02: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 using 'Read the Docs' should be apt 2022-10-27 17:09:37 +05:30
ReleaseChecklist.md Fix grammar mistake 2022-11-02 21:00:12 +01:00
ReviewChecklist.md adding a point about expectations to checklist 2022-10-26 15:14:05 +05: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

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.