Solidityでスマートコントラクトを書く際、最初につまずきやすいのが型システムと変数のスコープです。一般的なプログラミング言語と似た部分もありますが、ブロックチェーン上で動作するという特性から独自のルールが存在します。型の選択が誤っていると、ガスコストの無駄遣いや深刻なセキュリティ脆弱性につながることもあります。
本記事では、Solidityの値型・参照型・グローバル変数の違いから、mappingや配列の使い方、変数のスコープと可視性まで、実際のコード例を交えながら体系的に解説します。
文法の正確な理解はコントラクトの安全性と効率性に直結します。基礎を丁寧に押さえることが、後々の開発において大きな差を生みます。
Solidityの型システムの概要
静的型付けと強い型付け
Solidityは静的型付け言語であり、すべての変数は宣言時に型が決まります。コンパイル時に型チェックが行われるため、実行時の予期しない型エラーを防ぎやすいという利点があります。一方で型変換（キャスト）には明示的な記述が必要であり、暗黙の型変換はごく限られた安全なケースのみ許可されています。
また、Solidityはメモリ管理をストレージとメモリという2つの領域に分離しており、この概念を理解することがガスコスト最適化の鍵となります。状態変数はストレージ（永続領域）に保存され、関数の実行コストは状態変数への書き込み回数に大きく依存します。
値型と参照型の違い
Solidityの型は大きく「値型」と「参照型」に分かれます。値型は変数がデータそのものを保持し、代入時にコピーされます。参照型は変数がデータへの参照を保持し、代入時は参照先が共有されます（ただしstorage/memory/calldataのデータロケーションによって挙動が変わります）。
整数型（uint/int）・bool・address・bytesN（固定長）は値型に分類されます。string・bytes（可変長）・配列・structは参照型です。参照型の変数を関数の引数や戻り値に使う際は、データロケーション（memory/storage/calldata）を明示する必要があります。
整数型（uint・int）の詳細
uintとintのサイズと使い分け
Solidityの整数型はuint8からuint256、int8からint256まで8ビット刻みで用意されています。uint256はuintと同義であり、最もよく使われる型です。符号なし整数（uint）は0以上の値のみ、符号あり整数（int）は負の値も扱えます。
多くの場合はuint256を使えば問題ありませんが、構造体（struct）内では小さいサイズの型をまとめることでパッキング（1スロット32バイトへの圧縮）が効き、ストレージコストを削減できます。ただし、EVMの演算はすべて256ビット単位で行われるため、ローカル変数ではuint256以外の型を使ってもガス削減効果はほとんどありません。
算術演算とオーバーフロー対策
Solidity 0.8以降、整数演算はデフォルトでオーバーフロー・アンダーフローチェックが行われます。上限を超える演算はrevertされるため、意図しない値の循環を防げます。以前のバージョンで必須だったSafeMathライブラリは0.8以降では原則不要となりました。
ただし、uncheckedブロックを使うとチェックが省略されます。ガスコスト削減が目的の場合に限定的に使いますが、オーバーフローが起きないことを確実に証明できる場合のみ使用するべきです。不用意なuncheckedの使用はセキュリティリスクになります。
address型とETH送受信
address型の基礎
address型は20バイトのイーサリアムアドレスを表します。address payable型はETHの送受信が可能なアドレスであり、transfer/send/callメソッドが使えます。通常のaddress型はETHを受け取ることができないため、ETHの送受信が必要な場合はpayableへのキャストが必要です。
address型はmappingのキーとして頻繁に使われます（例：トークン残高の管理）。また、msg.senderはトランザクションの送信者アドレスを返すグローバル変数として、アクセス制御の基本的な仕組みに活用されます。
ETH送金の3つのメソッドとその違い
ETHの送金にはtransfer、send、callの3種類があります。transfer（2300ガス固定・失敗時にrevert）は最もシンプルですが、ガスの変動に脆弱なため現在はあまり推奨されていません。send（2300ガス固定・失敗時にfalseを返す）は戻り値のチェックが必要です。
現在の標準的な推奨はcall（ガス上限を指定可能）です。call{value: amount}(“”)という記法を使い、戻り値のboolを必ずチェックします。ただしcallを使うと再入攻撃のリスクが生じるため、Checks-Effects-Interactionsパターンを必ず守る必要があります。
mappingと配列と構造体
mappingの仕組みと活用例
mappingはキーと値を対応づけるハッシュテーブルです。宣言の形式はmapping(KeyType => ValueType)であり、キーには任意の値型またはbytes/stringを、値には任意の型を指定できます。ERC-20トークンの残高管理（mapping(address => uint256) balances）が最もよく見られる用例です。
mappingは存在しないキーへのアクセスがゼロ値を返す（エラーにならない）という特性があります。また、mappingは反復処理（ループ）ができないため、全キーを列挙したい場合は別途配列でキー一覧を管理する必要があります。ネストされたmapping（mapping(address => mapping(address => uint256))）もよく使われ、ERC-20のallowanceがその典型例です。
配列と構造体の使い方
Solidityの配列には固定長配列（uint256[5]）と動的配列（uint256[]）があります。動的配列はpush・popメソッドで要素を追加・削除できます。ただし、ストレージの動的配列に対するループ処理はガスコストが高くなるため、要素数が多い場合は注意が必要です。
structは複数のデータをひとまとめにできるカスタム型です。ERC-721のトークン情報管理やデポジット情報の記録など、関連するデータを束ねる際に使います。structのフィールドを小さい型でパッキングすることでストレージスロットを節約できますが、アクセス順序に注意が必要です（パッキングは同じスロット内に収まる場合のみ有効）。
変数のスコープと可視性
状態変数・ローカル変数・グローバル変数
Solidityの変数はスコープによって3種類に分類されます。状態変数（state variable）はコントラクトのストレージに永続保存され、コントラクト全体からアクセスできます。ローカル変数は関数内でのみ有効であり、メモリ（またはスタック）に一時的に保存されます。グローバル変数はSolidity自体が提供する特別な変数で、msg.sender・msg.value・block.timestamp・block.numberなどがあります。
状態変数への書き込みはトランザクション（ガスコスト大）が必要です。読み取りのみの場合はview修飾子を付けることで外部から無料で呼び出せます（ノードからのRPCコールの場合）。
可視性修飾子の使い分け
状態変数と関数それぞれに可視性修飾子を指定できます。状態変数にpublicを付けるとgetter関数が自動生成されます。privateは同コントラクト内のみ、internalはprivateに加えて派生コントラクトからもアクセス可能です。ただし、ブロックチェーン上のデータはprivateであっても誰でもストレージを読むことができるため、秘匿情報をオンチェーンに保存することは避けるべきです。
関数のexternalは外部からのみ呼び出し可能です。引数にcalldataを使えるためmemoryよりもガスが節約できます。大量のデータを受け取る関数にはexternalを検討するとよいでしょう。
データロケーション（storage・memory・calldata）
3つのデータロケーションの違い
Solidityには参照型変数のデータ保存場所を指定するデータロケーションという概念があります。storageはブロックチェーンに永続保存される領域でガスコストが最も高いです。memoryは関数実行中のみ存在する揮発性の領域です。calldataは読み取り専用の特殊な領域であり、関数の外部入力をコピーなしで参照できるためガス効率が高いです。
関数内でストレージの参照型変数を直接操作するとストレージ書き込みが発生します。一方、storage参照をローカル変数に代入するとpointerとして機能し、元のストレージが変更されます。意図せずストレージを書き換えることがないよう、データロケーションの挙動を正確に理解しておくことが重要です。
ガスコストとデータロケーションの最適化
ガスコスト最適化においてデータロケーションの選択は極めて重要です。不必要にメモリへのコピーを行うと余分なガスがかかります。特に大きな配列や文字列をmemoryとstorageの間でやり取りする際は意識が必要です。
関数の引数に参照型を使う場合、外部関数ではcalldataが最もガス効率が高く推奨されます。内部関数ではmemoryが使われます。読み取り専用でstorageにアクセスする場合はstorage参照を使うと、コピーのコストを省けます。
まとめ
本記事では、Solidityのデータ型・変数の種類・スコープ・データロケーションについて体系的に解説しました。型の選択やデータロケーションの理解はガスコストとセキュリティに直結します。uint256とuint8・uint128の使い分け、mapping・配列・構造体の特性、そしてstorage/memory/calldataの違いをしっかり把握することが、効率的で安全なコントラクト開発の基礎となります。
次のステップとして、実際にRemixやHardhatでコードを書き、ガスコストの違いを自分で確かめてみることをお勧めします。理論と実践を組み合わせることで理解が定着します。
よくある質問
privateな状態変数は本当に外部から読めないのですか？
Solidityのprivate修飾子はコード上のアクセスを制限するものであり、ブロックチェーン上のデータを暗号化するわけではありません。eth_getStorageAtなどのRPCメソッドを使えば誰でもストレージの値を直接読み取ることができます。秘密情報はオンチェーンに平文で保存するべきではありません。
mappingの全要素をループで取得することはできますか？
mappingはすべてのキーを列挙する仕組みを持っていないため、ループで全要素を取得することはできません。全キーを管理したい場合は、別途配列でキーのリストを保持し、ループ対象にする設計が必要です。ただし大量のキーを持つ配列のループはガスリミットに引っかかる可能性があるため注意が必要です。
uint256とuintは同じですか？
はい、Solidityではuintはuint256の省略形です。まったく同じ型として扱われます。コード内での一貫性のためにどちらかに統一することが推奨されており、多くのプロジェクトではuint256を明示的に使う慣例があります。
※本記事は情報提供を目的としており、投資を推奨するものではありません。暗号資産への投資は元本割れのリスクがあります。投資判断はご自身の責任で行ってください。
