solidity README

The project's README from github.com/argotorg/solidity. As one markdown file: README.md.

The Solidity Contract-Oriented Programming Language

Matrix Chat Gitter Chat Solidity Forum X Follow Mastodon Follow

You can talk to us on Gitter and Matrix, tweet at us on X (previously 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 Developer's 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.

solidity (argotorg/solidity)

Searching Database…

25.8K ·GitHub
Solidity
What is this?Solidity is a statically-typed, contract-oriented language for implementing smart contracts on Ethereum — programs that run on the Ethereum Virtual Machine inside a peer-to-peer network where nobody has special authority over execution.
So is this repo the language itself, the compiler, or both?Both: Solidity is a statically-typed curly-braces language, and this repository builds its compiler, written in C++, which targets the Ethereum Virtual Machine. IDEs like Remix are separate tools.
How do I write and run my first contract?Start in Remix, a browser-based IDE — zero local install — and work through the example contracts the README links to.
And if I want to compile contracts on my own machine?Then you need the Solidity compiler. The README leaves build and install instructions to the documentation; the codebase is native C++, so expect a real toolchain build.
Is the language stable, or will updates break my contracts?It moves fast: breaking changes, new features and bug fixes land regularly, signalled by the 0.x version numbers. When deploying, use the latest released version.
What do people actually build with it?Smart contracts on Ethereum — tokens of value, ownership, voting, and other logic whose execution no single party controls.
How permissive is the license?GNU GPL v3.0 — a strong copyleft — with some bundled third-party code under its own terms. The language and compiler are free and open source.
What should my first contract be?The README links four worked examples: Voting, Blind Auction, Safe remote purchase, and Micropayment Channel. It also notes that a Hello World is of even less use in Solidity than in other languages.
Is Solidity still actively developed?Yes — the README states it is still under development, and current feature and bug priorities for forthcoming releases are tracked in the projects section. Contributions follow the Developer's Guide.
What are similar projects?go-ethereum, foundry, union, openzeppelin-contracts, shardeum, hashsigs-solidity, truffle, nuvex-services
Which topics is it in?evm, solidity, language, ethereum, decentralized, cryptocurrency, p2p, web3, programming-language, blockchain, compiler, cpp
Creator
argotorg
Size
84.8 MB
Stars
25.8K
Updated
CommitOct 15Releasev0.8.37Sep 10
Age
11y
Commits · 90 Days