19 releases

0.3.0 May 22, 2023
0.2.2 Feb 20, 2023
0.2.0 Dec 2, 2022
0.1.13 Sep 16, 2022
0.1.0 Jun 15, 2019

#1225 in Magic Beans

Download history 30/week @ 2023-02-07 64/week @ 2023-02-14 33/week @ 2023-02-21 8/week @ 2023-02-28 5/week @ 2023-03-07 1/week @ 2023-03-14 36/week @ 2023-03-21 10/week @ 2023-03-28 25/week @ 2023-04-04 10/week @ 2023-04-11 26/week @ 2023-04-18 4/week @ 2023-04-25 3/week @ 2023-05-02 40/week @ 2023-05-09 25/week @ 2023-05-16 16/week @ 2023-05-23

84 downloads per month


83K SLoC

Solang Logo

solang - Solidity Compiler for Solana and Substrate

Discord CI Documentation Status license LoC

Welcome to Solang, a new Solidity compiler written in rust which uses llvm as the compiler backend. Solang can compile Solidity for Solana and Substrate. Solang is source compatible with Solidity 0.8, with some caveats due to differences in the underlying blockchain.

Solang is under active development right now, and has extensive documentation.


Solang is available as a Brew cask for MacOS, with the following command:

brew install hyperledger/solang/solang

For other operating systems, please check the installation guide.

Simple examples

Build for Solana

Run the following command, selecting the flipper example available in Solang's repository:

solang compile --target solana examples/solana/flipper.sol

Alternatively if you want to use the solang container, run:

docker run --rm -it -v $(pwd):/sources ghcr.io/hyperledger/solang compile -v -o /sources --target solana /sources/solana/flipper.sol

This generates a file called flipper.json and flipper.so. In order to deploy the contract code to the account F1ipperKF9EfD821ZbbYjS319LXYiBmjhzkkf5a26rC, save the private key to the file flipper-keypair.json:

echo "[4,10,246,143,43,1,234,17,159,249,41,16,230,9,198,162,107,221,233,124,34,15,16,57,205,53,237,217,149,17,229,195,3,150,242,90,91,222,117,26,196,224,214,105,82,62,237,137,92,67,213,23,14,206,230,155,43,36,85,254,247,11,226,145]" > flipper-keypair.json

Now you can deploy the contract code using:

solana program deploy flipper.so

Now install @project-serum/anchor:

npm install @project-serum/anchor

Save the following to flipper.js:

const { readFileSync } = require('fs');
const anchor = require('@project-serum/anchor');

const IDL = JSON.parse(readFileSync('./flipper.json', 'utf8'));
const PROGRAM_SO = readFileSync('./flipper.so');

(async function () {
	const provider = anchor.AnchorProvider.env();

	const dataAccount = anchor.web3.Keypair.generate();

	const programId = new anchor.web3.PublicKey(IDL.metadata.address);

	const wallet = provider.wallet.publicKey;

	const program = new anchor.Program(IDL, programId, provider);

	await program.methods.new(wallet, true)
		.accounts({ dataAccount: dataAccount.publicKey })

	const val1 = await program.methods.get()
		.accounts({ dataAccount: dataAccount.publicKey })

	console.log(`state: ${val1}`);

	await program.methods.flip()
		.accounts({ dataAccount: dataAccount.publicKey })

	const val2 = await program.methods.get()
		.accounts({ dataAccount: dataAccount.publicKey })

	console.log(`state: ${val2}`);

And now run:

export ANCHOR_WALLET=$HOME/.config/solana/id.json
node flipper.js

Build for Substrate

Run the following command, selecting the flipper example available on Solang's repository:

solang compile --target substrate examples/substrate/flipper.sol

Alternatively if you want to use the solang container, run:

docker run --rm -it -v $(pwd):/sources ghcr.io/hyperledger/solang compile -v -o /sources --target substrate /sources/flipper.sol

You will have a file called flipper.contract. You can use this directly in the Contracts UI, as if your smart contract was written using ink!.

Tentative roadmap

Solang has a high level of compatibility with many blockchains. We are trying to ensure the compiler stays up to date with the newest Solidity syntax and features. In addition, we focus on bringing new performance optimizations and improve developer experience. Here is a brief description of what we envision for the next versions.


Feature Status
Improve management over optimization passes Not started
Adopt single static assignment for code generation Not started
Support openzeppelin on Substrate target Not started
Provide Solidity -> Substrate porting guide Not started
Call Solidity from Solana's Rust contracts Not started
Tooling for calls between ink! <> solidity In progress
Provide CLI for node interactions Not started


Apache 2.0


~580K SLoC