The Solidity Contract-Oriented Programming Language

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.

Building on MacOS

You likely need to install Xcode. If you don't want to install Xcode you can try xcode-select --install

Install dependencies:

brew install cmake boost ccache

Accept Xcode license without launching GUI:

sudo xcodebuild -license accept

Clone and navigate to SolidityX directory:

git clone https://github.com/dominant-strategies/SolidityX.git && cd SolidityX

Run build script:

# note: this will install binaries solc and soltest at usr/local/bin
./scripts/build.sh

Running:

solc --pretty-json --bin --asm test.sol

Building on Ubuntu 22.04

Update and upgrade:

sudo apt update && sudo apt upgrade -y

Install dependencies:

sudo apt install build-essential cmake libboost-all-dev

Clone and navigate to SolidityX directory:

git clone https://github.com/dominant-strategies/SolidityX.git && cd SolidityX

Create and navigate to build directory:

mkdir build && cd build

Build and install:

cmake .. && make

Table of Contents

• Background
• Build and Install
• Example
• Documentation
• Development
• Maintainers
• License
• Security

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:

pragma solidity >=0.6.0 <0.9.0;
contract ETX {
    constructor() public payable {
        bool result;
        assembly {
            result := etx(
                0,                                          // temp variable, can be anything (unused)
                0x5A457339697CB56E5a9BfA5267eA80d2c6375d98, // address to send to
                500000000000000000,                         // amount to send in wei
                100000,                                     // gas limit (entire gas limit will be consumed and sent to destination)
                1,                                          // miner tip in wei
                1,                                          // base fee in wei
                0,                                          // input offset in memory
                0,                                          // input size in memory
                0,                                          // accesslist offset in memory
                0                                           // accesslist size in memory
            )
        }
        // do something with the result
    }
}

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.