Solidityコンパイラのインストール
バージョニング
Solidityのバージョンは セマンティックバージョニング に従っています。 さらに、メジャーリリース0(つまり0.x.y)のパッチレベルのリリースには、破壊的な変更が含まれません。 つまり、バージョン0.x.yでコンパイルされたコードは、0.x.z(z > y)でコンパイルされることが期待できます。
リリースに加え、 nightly development builds を提供することで、開発者が簡単に次期機能を試し、早期にフィードバックを提供できるようにしています。 ただし、ナイトリービルドは通常非常に安定していますが、開発ブランチからの最先端のコードを含んでおり、常に動作することを保証するものではないことに注意してください。 私たちの最善の努力にもかかわらず、文書化されていない、あるいは破壊的変更が含まれている可能性があり、実際のリリースの一部にはなりません。 また、本番環境での使用は想定していません。
コントラクトをデプロイする場合は、Solidityの最新リリースバージョンを使用する必要があります。 これは、新しい機能やバグ修正だけでなく、破壊的な変更が定期的に導入されるからです。 現在、0.xのバージョン番号を使用していますが、これは この速いペースでの変更を示すため です。
Remix
小規模なコントラクトやSolidityを短期間で習得するにはRemixをお勧めします。
Remixにオンラインでアクセスする 場合、何もインストールする必要はありません。 インターネットに接続せずに使用したい場合は、https://github.com/ethereum/remix-live/tree/gh-pages#readme に行き、そのページの指示に従ってください。 Remixは、複数のSolidityバージョンをインストールせずにnightlyビルドをテストするのに便利なオプションでもあります。
このページの他のオプションでは、お使いのコンピュータにコマンドラインのSolidityコンパイラソフトウェアをインストールする方法について説明しています。 大規模なコントラクトに取り組む場合や、より多くのコンパイルオプションを必要とする場合は、コマンドラインコンパイラを選択してください。
npm / Node.js
solcjs プログラムは、Solidityのコンパイラである solcjs
をインストールするための便利でポータブルな方法として使用します。
solcjs プログラムは、このページの下の方で説明されているコンパイラへのアクセス方法よりも機能が少なくなっています。
コマンドラインコンパイラの使い方 のドキュメントでは、フル機能のコンパイラである solc
を使用していることを前提としています。
solcjs
の使い方は、独自の リポジトリ の中で説明されています。
注: solc-jsプロジェクトは、Emscriptenを使用してC++ solc から派生しており、両者は同じコンパイラのソースコードを使用しています。 solc-js はJavaScriptプロジェクト(Remixなど)で直接使用できます。 使用方法はsolc-jsのリポジトリを参照してください。
npm install -g solc
注釈
コマンドラインの実行ファイルの名前は solcjs
です。
solcjs
のコマンドラインオプションは solc
と互換性がなく、 solc
の動作を想定したツール( geth
など)は solcjs
では動作しません。
Docker
SolidityのビルドのDockerイメージは、 ethereum
オーガナイゼーションの solc
イメージを使って利用できます。
最新のリリースバージョンには stable
タグを、developブランチの不安定な可能性のある変更には nightly
タグを使用してください。
Dockerイメージはコンパイラ実行ファイルを実行するので、すべてのコンパイラ引数を渡すことができます。
例えば、以下のコマンドは、ステーブル版の solc
イメージ(まだ持っていない場合)を取り出し、 --help
引数を渡して新しいコンテナで実行します。
docker run ethereum/solc:stable --help
タグには、0.5.4リリースのように、リリースのビルドバージョンを指定することもできます。
docker run ethereum/solc:0.5.4 --help
ホストマシンでSolidityのファイルをコンパイルするためにDockerイメージを使用するには、入出力用のローカルフォルダーをマウントし、コンパイルするコントラクトを指定します。 例えば、以下のようになります。
docker run -v /local/path:/sources ethereum/solc:stable -o /sources/output --abi --bin /sources/Contract.sol
また、標準のJSONインターフェースを使用することもできます(コンパイラとツールを使用する場合は、このインターフェースを使用することをお勧めします)。 このインターフェースを使用する場合、JSON入力が自己完結している限り、ディレクトリをマウントする必要はありません(つまり、importコールバックによって読み込まれる 必要がある外部ファイルを参照しない)。
docker run ethereum/solc:stable --standard-json < input.json > output.json
Linuxパッケージ
solidity/releases ではSolidityのバイナリパッケージが用意されています。
また、Ubuntu用のPPAも用意しているので、以下のコマンドで最新のステーブル版を入手できます。
sudo add-apt-repository ppa:ethereum/ethereum
sudo apt-get update
sudo apt-get install solc
nightlyバージョンは、以下のコマンドでインストールできます。
sudo add-apt-repository ppa:ethereum/ethereum
sudo add-apt-repository ppa:ethereum/ethereum-dev
sudo apt-get update
sudo apt-get install solc
さらに、一部のLinuxディストリビューションでは、独自のパッケージが提供されています。 これらのパッケージは私たちが直接メンテナンスしているわけではありませんが、基本的にそれぞれのパッケージメンテナによって最新に保たれています。
例えば、Arch Linuxでは、最新の開発版のパッケージがAURパッケージとして用意されています。 solidity と solidity-bin です。
注釈
AUR パッケージはユーザーが作成したコンテンツであり、非公式パッケージです。 使用するときは注意してください。
snapパッケージ もありますが、 現在メンテナンスされていません 。 サポートされているLinuxディストリビューション すべてでインストール可能です。 最新の安定版のsolcをインストールするには:
sudo snap install solc
最新のデベロップメント版Solidityを最新の変更点でテストすることに協力したい方は、以下をご利用ください。
sudo snap install solc --edge
注釈
solc
スナップはstrict confinementを使用します。
これはスナップパッケージにとって最も安全なモードですが、 /home
と /media
ディレクトリ内のファイルにしかアクセスできないなどの制限があります。
詳細については、 Demystifying Snap Confinement を参照してください。
macOSパッケージ
私たちは、SolidityコンパイラをHomebrewを通じて、build-from-sourceバージョンとして配布しています。 ビルド済みのボトルは現在サポートされていません。
brew update
brew upgrade
brew tap ethereum/ethereum
brew install solidity
最新の0.4.x / 0.5.xバージョンのSolidityをインストールするには、それぞれ brew install solidity@4
と brew install solidity@5
を使用することもできます。
Solidityの特定のバージョンが必要な場合は、Githubから直接Homebrew式をインストールできます。
solidity.rb commits on Github を見てください。
欲しいバージョンのコミットハッシュをコピーして、自分のマシンでチェックしてみましょう。
git clone https://github.com/ethereum/homebrew-ethereum.git
cd homebrew-ethereum
git checkout <your-hash-goes-here>
brew
を使ってインストールします。
brew unlink solidity
# eg. Install 0.4.8
brew install solidity.rb
静的バイナリ
solc-bin では、サポートしているすべてのプラットフォーム用の過去および現在のコンパイラバージョンの静的ビルドを含むリポジトリを管理しています。 ここにはnightlyビルドも置かれています。
リポジトリは、エンドユーザーがすぐに使えるバイナリを素早く簡単に入手できるだけでなく、サードパーティのツールとの親和性も考慮しています。
コンテンツは https://binaries.soliditylang.org にミラーリングされ、認証やレート制限、gitを使用する必要なく、HTTPSで簡単にダウンロードできます。
コンテンツは、正しい Content-Type ヘッダと寛大なCORS設定で提供され、ブラウザ上で動作するツールで直接読み込めるようになっています。
バイナリは、インストールや解凍の必要がありません(ただし、必要なDLLがバンドルされた古いWindowsビルドは例外です)。
私たちは、高いレベルの後方互換性を確保するよう努めています。 一度追加されたファイルは、古い場所でシンボリックリンクやリダイレクトを提供することなく削除または移動されることはありません。 また、ファイルはその場で変更されることはなく、常にオリジナルのチェックサムと一致していなければなりません。 唯一の例外は、壊れたファイルや使用できないファイルで、そのままにしておくと害になる可能性があるものです。
ファイルは HTTP と HTTPS の両方で提供されます。ファイルリストを安全な方法(git、HTTPS、IPFS、またはローカルにキャッシュ)で取得し、バイナリをダウンロードした後にバイナリのハッシュを検証する限り、バイナリ自体にHTTPSを使用する必要はありません。
同じバイナリは、ほとんどの場合、 Solidity release page on Github で入手できます。
異なる点は、Githubのリリースページにある古いリリースを一般的には更新しないことです。
つまり、命名規則が変わっても名前を変えないし、リリース時にサポートされていなかったプラットフォーム用のビルドも追加しません。
これは solc-bin
でのみ起こります。
solc-bin
リポジトリには、複数のトップレベルのディレクトリがあり、それぞれが1つのプラットフォームを表しています。
それぞれのディレクトリには、利用可能なバイナリの一覧を示す list.json
ファイルが含まれています。
例えば、 emscripten-wasm32/list.json
にはバージョン0.7.4についての以下の情報があります。
{
"path": "solc-emscripten-wasm32-v0.7.4+commit.3f05b770.js",
"version": "0.7.4",
"build": "commit.3f05b770",
"longVersion": "0.7.4+commit.3f05b770",
"keccak256": "0x300330ecd127756b824aa13e843cb1f43c473cb22eaf3750d5fb9c99279af8c3",
"sha256": "0x2b55ed5fec4d9625b6c7b3ab1abd2b7fb7dd2a9c68543bf0323db2c7e2d55af2",
"urls": [
"bzzr://16c5f09109c793db99fe35f037c6092b061bd39260ee7a677c8a97f18c955ab1",
"dweb:/ipfs/QmTLs5MuLEWXQkths41HiACoXDiH8zxyqBHGFDRSzVE5CS"
]
}
これは次のことを意味します。
同じディレクトリに solc-emscripten-wasm32-v0.7.4+commit.3f05b770.js という名前でバイナリが置かれています。 このファイルはシンボリックリンクになっている可能性があるので、git を使ってダウンロードしていない場合やファイルシステムがシンボリックリンクをサポートしていない場合は、自分で解決する必要があります。
このバイナリは https://binaries.soliditylang.org/emscripten-wasm32/solc-emscripten-wasm32-v0.7.4+commit.3f05b770.js にもミラーされています。 この場合、git は必要ありません。シンボリックリンクは透過的に解決され、ファイルのコピーを提供するか HTTP リダイレクトを返します。
このファイルはIPFSの QmTLs5MuLEWXQkths41HiACoXDiH8zxyqBHGFDRSzVE5CS でも公開されています。
このファイルは、将来はSwarmの 16c5f09109c793db99fe35f037c6092b061bd39260ee7a677c8a97f18c955ab1 で公開されるかもしれません。
keccak256ハッシュを
0x300330ecd127756b824aa13e843cb1f43c473cb22eaf3750d5fb9c99279af8c3
と比較することで、バイナリの完全性を確認できます。 ハッシュは、 sha3sum が提供するkeccak256sum
ユーティリティーを使ってコマンドラインで計算するか、JavaScriptで keccak256() function from ethereumjs-util を使って計算できます。また、sha256ハッシュを
0x2b55ed5fec4d9625b6c7b3ab1abd2b7fb7dd2a9c68543bf0323db2c7e2d55af2
と比較することで、バイナリの完全性を確認できます。
警告
強い後方互換性の要求により、リポジトリにはいくつかのレガシー要素が含まれていますが、新しいツールを書く際にはそれらを使用しないようにしてください。
最高のパフォーマンスを求めるのであれば、
bin/
ではなくemscripten-wasm32/
(emscripten-asmjs/
へのフォールバック機能あり)を使用してください。バージョン0.6.1まではasm.jsのバイナリのみを提供していました。 0.6.2からは、パフォーマンスが大幅に向上した WebAssembly builds に切り替えました。古いバージョンを wasm 用に作り直しましたが、オリジナルの asm.js ファイルはbin/
に残っています。 新しいファイルは、名前の衝突を避けるために別のディレクトリに置く必要がありました。wasmとasm.jsのどちらのバイナリをダウンロードしているかを確認したい場合は、
bin/
とwasm/
ディレクトリではなく、emscripten-asmjs/
とemscripten-wasm32/
を使用してください。list.js
とlist.txt
の代わりにlist.json
を使用します。JSONリスト形式には、旧来のものからすべての情報が含まれています。https://solc-bin.ethereum.org の代わりに https://binaries.soliditylang.org を使用してください。物事をシンプルにするために、コンパイラに関連するほとんどすべてのものを新しい
soliditylang.org
ドメインの下に移動しましたが、これはsolc-bin
にも当てはまります。新しいドメインを推奨しますが、古いドメインも完全にサポートされており、同じ場所を指すことが保証されています。
警告
バイナリは https://ethereum.github.io/solc-bin/ にもありますが、このページはバージョン0.7.2のリリース直後に更新が停止しており、プラットフォームを問わず、新しいリリースやnightlyビルドを受け取ることはなく、また、非emscripten のビルドを含む新しいディレクトリ構造にも対応していません。
使用している場合は、ドロップインで置き換え可能な https://binaries.soliditylang.org に切り替えてください。
これにより、基盤となるホスティングの変更を透明性のある方法で行い、混乱を最小限に抑えることができます。
私たちがコントロールできない ethereum.github.io
ドメインとは異なり、 binaries.soliditylang.org
は長期的に機能し、同じURL構造を維持することが保証されています。
ソースからのビルド
前提知識 - 全オペレーティングシステム共通
以下は、Solidityのすべてのビルドに依存しています。
ソフトウェア |
ノート |
---|---|
CMake (Windowsではバージョン3.21.3+、その他では3.13+) |
クロスプラットフォームのビルドファイルジェネレーター。 |
Boost (Windowsではバージョン1.77、その他では1.65+) |
C++ライブラリ。 |
ソースコードを取得するためのコマンドラインツール。 |
|
z3 (バージョン4.8.16+, オプション) |
SMTチェッカーと併用する場合。 |
cvc4 (オプション) |
SMTチェッカーと併用する場合。 |
注釈
Solidityのバージョンが0.5.10以前の場合、Boostのバージョン1.70以上に対して正しくリンクできないことがあります。
これを回避するには、cmakeコマンドを実行してSolidityを設定する前に、一時的に <Boost install path>/lib/cmake/Boost-1.70.0
の名前を変更することが考えられます。
0.5.10以降、Boost 1.70以上とのリンクは手動での操作なしに動作します。
注釈
デフォルトのビルド構成では、特定のZ3バージョン(コードが最後に更新された時点での最新のもの)が必要です。
Z3のリリース間に導入された変更により、わずかに異なる(ただし有効な)結果が返されることがよくあります。
私たちのSMTテストはこれらの違いを考慮しておらず、書かれたバージョンとは異なるバージョンで失敗する可能性があります。
これは、異なるバージョンを使用したビルドが欠陥であることを意味するものではありません。
CMakeに -DSTRICT_Z3_VERSION=OFF
オプションを渡しておけば、上の表にある要件を満たす任意のバージョンでビルドできます。
ただし、この場合、SMT テストをスキップするために scripts/tests.sh
に --no-smt
オプションを渡すことを忘れないでください。
注釈
デフォルトでは、ビルドは pedantic mode で実行され、余分な警告を有効にし、すべての警告をエラーとして扱うようにコンパイラに指示します。
これにより、開発者は警告が発生したときに修正することを余儀なくされ、「後で修正する」ことが蓄積されることがありません。
もしあなたがリリースビルドを作ることにしか興味がなく、そのような警告に対処するためにソースコードを修正するつもりがないのであれば、CMakeに -DPEDANTIC=OFF
オプションを渡してこのモードを無効にすることが可能です。
この方法は一般的な使用では推奨されませんが、私たちがテストしていないツールチェーンを使用する場合や、古いバージョンを新しいツールでビルドしようとする場合には必要かもしれません。
もしこのような警告に遭遇したら、 それらを報告すること を検討してください。
最小コンパイラバージョン
以下のC++コンパイラとその最小バージョンでSolidityのコードベースを構築できます。
前提知識 - macOS
macOSでビルドする場合は、最新版の Xcodeがインストールされていること を確認してください。 Xcodeを初めてインストールする場合や、新しいバージョンをインストールしたばかりの場合は、コマンドラインでのビルドを行う前にライセンスに同意する必要があります。
sudo xcodebuild -license accept
私たちのOS Xのビルドスクリプトは、外部の依存関係をインストールするために Homebrew パッケージマネージャーを使用しています。 もし、最初からやり直したいと思ったときのために、 Homebrewのアンインストール の方法を紹介します。
前提知識 - Windows
SolidityのWindowsビルドには、以下の依存関係をインストールする必要があります。
Software |
Notes |
---|---|
C++コンパイラ |
|
Visual Studio 2019 (Optional) |
C++コンパイラと開発環境 |
Boost (version 1.77) |
C++ライブラリ |
すでに1つのIDEを持っていて、コンパイラとライブラリだけが必要な場合は、Visual Studio 2019 Build Toolsをインストールできます。
Visual Studio 2019は、IDEと必要なコンパイラとライブラリの両方を提供します。 そのため、IDEを持っておらず、Solidityを開発したい場合は、すべてのセットアップを簡単に行うことができるVisual Studio 2019を選択するとよいでしょう。
ここでは、「Visual Studio 2019 Build Tools」または「Visual Studio 2019」にインストールされるべきコンポーネントのリストを示します。
Visual Studio C++のコア関数
VC++ 2019 v141ツールセット(x86,x64)
Windows Universal CRT SDK
Windows 8.1 SDK
C++/CLIのサポート
必要な外部依存パッケージをすべてインストールするためのヘルパースクリプトを用意しています。
scripts\install_deps.ps1
これにより、 boost
と cmake
が deps
サブディレクトリにインストールされます。
リポジトリのクローン
ソースコードをクローンするには、以下のコマンドを実行します。
git clone --recursive https://github.com/ethereum/solidity.git
cd solidity
もしSolidityの開発に協力したいのであれば、Solidityをフォークして、自分の個人的なフォークをセカンドリモートとして追加してください。
git remote add personal git@github.com:[username]/solidity.git
注釈
この方法では、プレリリースビルドの結果、そのようなコンパイラで生成された各バイトコードにフラグが設定されるなどの問題が発生します。 リリースされたSolidityコンパイラを再構築したい場合は、githubのリリースページにあるソースtarballを使用してください。
https://github.com/ethereum/solidity/releases/download/v0.X.Y/solidity_0.X.Y.tar.gz
(GitHubで提供されている「ソースコード」ではありません)。
コマンドラインビルド
ビルドする前に、必ず外部依存関係(上記参照)をインストールしてください。
Solidityプロジェクトでは、CMakeを使ってビルドの設定を行います。 繰り返しのビルドを高速化するために、 ccache をインストールするとよいでしょう。 CMakeはそれを自動的にピックアップします。 Solidityのビルドは、Linux、macOS、その他のUnicesでもよく似ています。
mkdir build
cd build
cmake .. && make
あるいはLinuxやmacOSではもっと簡単に実行できます:
#note: this will install binaries solc and soltest at usr/local/bin
./scripts/build.sh
警告
BSDビルドは動作するはずですが、Solidityチームではテストしていません。
そして、Windows用のビルドは、以下のコマンドを実行します:
mkdir build
cd build
cmake -G "Visual Studio 16 2019" ..
scripts\install_deps.ps1
がインストールしたバージョンのブーストを使用したい場合は、 cmake
の呼び出しの引数として -DBoost_DIR="deps\boost\lib\cmake\Boost-*"
と -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreaded
を追加で渡す必要があります。
これにより、そのビルドディレクトリに solidity.sln が作成されるはずです。 そのファイルをダブルクリックすると、Visual Studioが起動します。 Release 構成での構築をお勧めしますが、その他の構成でも動作します。
あるいは、次のようにコマンドラインでWindows用にビルドすることもできます。
cmake --build . --config Release
CMakeオプション
もし、CMakeのオプションに興味があれば、 cmake .. -LH
を実行してください。
SMTソルバー
SolidityはSMTソルバーに対してビルドでき、システムで見つかった場合、デフォルトでそうします。
それぞれのソルバーは cmake
オプションで無効にできます。
注: 場合によっては、ビルドに失敗したときの回避策としても有効です。
ビルドフォルダ内では、デフォルトで有効になっているので、無効にできます。
# disables only Z3 SMT Solver.
cmake .. -DUSE_Z3=OFF
# disables only CVC4 SMT Solver.
cmake .. -DUSE_CVC4=OFF
# disables both Z3 and CVC4
cmake .. -DUSE_CVC4=OFF -DUSE_Z3=OFF
バージョン文字列の詳細
Solidityバージョンの文字列は、4つの部分で構成されています。
バージョン番号
プレリリースのタグ。通常は
develop.YYYY.MM.DD
またはnightly.YYYY.MM.DD
に設定されています。コミット。フォーマットは
commit.GITHASH
です。プラットフォーム。任意の数の項目を持ち、プラットフォームとコンパイラに関する詳細を含むます。
ローカルに変更があった場合、そのコミットは .mod
でポストフィックスされます。
これらのパーツはSemVerの要求に応じて組み合わせられます。 SolidityのプレリリースタグはSemVerのプレリリースに相当し、Solidityのコミットとプラットフォームを組み合わせてSemverのビルドメタデータを構成します。
リリース例: 0.4.8+commit.60cc1668.Emscripten.clang
。
プレリリースの例: 0.4.9-nightly.2017.1.17+commit.6ecb4aa3.Emscripten.clang
。
バージョニングについての重要な情報
リリースが行われた後、パッチレベルの変更のみが続くと想定されるため、パッチのバージョンレベルをバンプさせています。
変更がマージされたときには、SemVerと変更の重要度に応じてバージョンを上げる必要があります。
最後に、リリースは常に現在のnightlyビルドのバージョンで作成されますが、 prerelease
指定子はありません。
例:
0.4.0のリリースを行います。
nightlyビルドのバージョンが今後0.4.1になります。
非破壊的な変更があった場合 --> バージョンの変更なし。
破壊的な変更があった場合 --> バージョンは0.5.0にバンプされます。
0.5.0のリリースを行います。
この動作は version pragma と相性が良いです。