> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/ja/rome-academy/03-first-contract-on-hadrian.md).

# 3. Hadrian での最初のコントラクト

ウォレットを Hadrian に接続し、資金を入れ、Hardhat でコントラクトをデプロイし、トランザクションが決済された Solana のトランザクションまで追跡します。

ローマの公開テストネットであるHadrianに、小さなSolidityコントラクトをデプロイします。デプロイ自体は通常のHardhatです。新しい点は、ガス料金をUSDCで支払うことと、エクスプローラーがあなたの処理のSolana側へリンクしてくれることです。

## 学べること

* HadrianでウォレットとHardhatを設定する方法。
* なぜガスがUSDCなのか、そしてウォレットがそれをどう受け取るのか。
* なぜRomeでの書き込みは、Ethereumの感覚より多くのガスを消費するのか。
* Viaエクスプローラーで自分のトランザクションを読む方法と、それを決済したSolanaトランザクションまでたどる方法。
* エクスプローラーに表示されるようにソースを検証する方法。

## 始める前に

あなたはすでに [レッスン2](https://docs.rome.builders/ja/rome-academy/02-what-you-can-build.md)を読みました。これは、このコントラクトが何の第一歩であるかを示しています。次のものを用意してください：

* 次のバージョンのNode.js： [クイックスタート](https://docs.rome.builders/ja/hajimeni-1/quickstart.md) で一覧化されています。
* MetaMaskがインストールされていること。
* 新しいアカウント、または使い捨ての鍵。秘密鍵をシェルにエクスポートするので、実資金を持つ鍵は使わないでください。
* Solanaから資金を入れる場合のみ、Devnetに設定されたSolanaウォレット。

## パス

### 手順1. ウォレットにHadrianを追加する

Hadrianは標準的なEVMネットワークです。名前、RPC URL、チェーンID、通貨シンボル、エクスプローラーURLを手動で指定してMetaMaskに追加します。すべての値は次の表から取得してください： [クイックスタート、手順1](https://docs.rome.builders/pages/f4ed8c5804258b88593215fb2fe998bc3d0e90de#id-1.-add-hadrian-to-metamask)。値は次のページにもあります： [Hadrian](https://docs.rome.builders/ja/nettowku/hadrian.md)。通貨シンボルを次に設定してください： `USDC`.

Hardhatにも同じチェーンIDとRPC URLが必要です。手順3で設定ファイルに入れます。

### 手順2. ウォレットに資金を入れる

HadrianのガスはUSDCで、CircleのSolana Devnet USDCに裏付けられています。SOLはガストークンではありません。Romeのfaucetはありません。テスト用USDCを別の場所で入手し、Rome Bridgeで持ち込みます。ブリッジ経由で届く入金は、既定ではガスとして着金します。ブリッジページの受取先はgasのままにしてください。

入手元は2つあります：

* **Solana Devnetから。** Circle faucetからdevnet USDCを受け取り、Solana手数料用に少量のdevnet SOLも用意してください。USDCはSolanaルートでブリッジし、受取人にはEVMアドレスを指定します。ブリッジはEVMウォレットにHadrian上でクレーム用トランザクションへの署名を求め、それによってUSDCがガスに変わります。
* **EVMテストネットから。** Ethereum SepoliaでテストUSDCをミントし、それをブリッジします。送信元側のトランザクション費用として少量のSepolia ETHが必要です。

手順とfaucetリンクは次にあります： [クイックスタート、手順2](https://docs.rome.builders/pages/f4ed8c5804258b88593215fb2fe998bc3d0e90de#id-2.-fund-your-wallet), [Hadrian上のウォレットに資金を入れる](https://docs.rome.builders/ja/nettowku/hadrian.md#fund-a-wallet) および [ファウセット](https://docs.rome.builders/ja/rissu/faucets.md)。ブリッジ自体は次にあります： [Rome Bridge](https://docs.rome.builders/ja/romenoapuri/bridge-api.md).

どれくらい資金を入れるべきか？クイックスタートには最低額と余裕のある額が書かれています。始める前に読んでください。

次へ進む前にMetaMaskで残高を確認してください。ゼロと表示されるなら、転送はまだ完了していません。ブリッジページには各手順と目安時間が表示されます。

### 手順3. Hardhatプロジェクトを作成する

TypeScriptとviemテンプレートでHardhat 3プロジェクトを作成します。次に `hadrian` のエントリを `networks` に、HadrianページのチェーンIDとRPC URLで追加します。秘密鍵は環境変数か、Hardhatの暗号化キーストアから取得します。使い捨て鍵以外ならキーストアを推奨します。

正確なコマンドと設定はクイックスタートの [手順3](https://docs.rome.builders/pages/f4ed8c5804258b88593215fb2fe998bc3d0e90de#id-3.-create-a-hardhat-project) および [手順4](https://docs.rome.builders/pages/f4ed8c5804258b88593215fb2fe998bc3d0e90de#id-4.-configure-hardhat-for-rome). [Solidity コントラクトをデプロイする](https://docs.rome.builders/ja/gaido/deploy-solidity.md#hardhat) に完全な設定ファイルが示されており、 [Foundryでの同じ流れ](https://docs.rome.builders/ja/gaido/deploy-solidity.md#foundry).

### 手順4. コントラクトを書いてデプロイする

クイックスタートのコントラクト `HelloRome`は、あえてシンプルにしてあります。あいさつ文を保存し、 `greet()`への呼び出し回数を数え、イベントを発行します。ローマ固有の要素はありません。

それがこの手順の狙いです： `HelloRome` 変更なしでデプロイできます。別のコントラクトを移植する前に、 [既知の制限](https://docs.rome.builders/ja/sekyuriti/known-limitations.md) で未対応のオペコードとガス差を確認してください。コントラクトを書き、それからデプロイスクリプトを次に対して実行します： `hadrian`。このスクリプトはデプロイし、呼び出します `greet()` を一度だけ行い、カウンタとあいさつ文を読み戻します。両方をクイックスタートの [手順5](https://docs.rome.builders/pages/f4ed8c5804258b88593215fb2fe998bc3d0e90de#id-5.-write-a-contract) および [手順6](https://docs.rome.builders/pages/f4ed8c5804258b88593215fb2fe998bc3d0e90de#id-6.-deploy).

成功すると、コントラクトアドレスとカウンタ1が得られます。

### 手順5. 何にコストがかかったのかを理解する

デプロイには、同じコントラクトをEthereumに置く場合よりずっと多くのガスが使われました。Romeでの書き込みガスの大半は、Solanaアカウントの作成費用です。デプロイされたコントラクトは、コードとストレージ用に新しいアカウントを作成します。まだ使われたことのない受取人への送金でも同様で、新しいトークンアカウントでも同じです。

そこから2つのルールが導かれます：

* ツールにガスを見積もらせるには `eth_estimateGas`。Hardhat、 `forge create` および `cast send` 実行します。 `forge script` には必要です `--skip-simulation` 同じことをするために。
* 21,000をハードコードしないでください。デプロイや未使用アドレスへの送金のようにアカウントを作成する書き込みは、その低い上限では失敗します。

Romeはトランザクションが実際に使ったガスだけを請求するので、見積もりが高くても追加費用はかかりません。ツールが加える余裕は残してください。Solanaプログラムへの呼び出しでは、見積もりが低めに出ることがあります。 [JSON-RPCサポート](https://docs.rome.builders/ja/rifarensu/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) は、実際の書き込みに関する測定値を示しています。

### 手順6. エクスプローラーで確認する

HadrianのViaエクスプローラーを開き、コントラクトアドレスを検索してください。そのページには作成トランザクションへのリンクがあり、 `greet()` そのトランザクション一覧の中に呼び出しが表示されます。エクスプローラーへのリンクは次にあります： [Hadrian](https://docs.rome.builders/ja/nettowku/hadrian.md).

Viaは通常のEVM表示、つまりブロック、送信者、使用ガス、イベントログを表示します。"Settled in" 行には、あなたのトランザクションを決済したSolanaトランザクションの署名があります。そのリンクを開いてください。Solanaエクスプローラーには、そのトランザクションの命令、関与したプログラム、消費したcompute unitが表示されます。 [Via Explorer](https://docs.rome.builders/ja/romenoapuri/via.md) には、Viaがほかに何を表示するかが説明されています。

compute unitはそこで読み取り、次のものからは読まないでください： `gasUsed`。Romeでは、 `gasUsed` はSolanaのcomputeを正確に示すものではありません。

### 手順7. ソースを検証する

検証するとソースとABIが公開され、エクスプローラーに"Source verified"バッジが表示されます。Romeはホスト型のSourcifyサービスを運用しているので、標準のHardhatとFoundryの検証フローが使えます。Romeの検証サービスを指定し、チェーンIDを渡してください。

エンドポイントは次にあります： [検証器エンドポイント](https://docs.rome.builders/ja/gaido/verify-contracts.md#verifier-endpoint)。設定とコマンドは次の [Hardhat](https://docs.rome.builders/ja/gaido/verify-contracts.md#hardhat) セクションにあります。Hadrianにはテストネット用の検証サービスを使ってください。メインネット用の検証サービスは別URLで、レッスン11で重要になります。

## 確認しよう

成果物：Hadrianエクスプローラーでコントラクトを開き、次の3つすべてを確認します。

* デプロイトランザクション。"Settled in" のSolana署名と、そのSolanaトランザクションの命令がSolanaエクスプローラーに表示されます。
* 2つ目のトランザクション、つまり `greet()` 呼び出し。コントラクトアドレスからのイベントログが1つあります。そのログは `Greeted` イベントです。最初のトピックは次のハッシュです： `Greeted(address,uint256)`.
* コントラクト上の"Source verified"バッジ。

行き詰まった場合、よくあるエラーは次にあります： [クイックスタート](https://docs.rome.builders/ja/hajimeni-1/quickstart.md#common-errors)。よくあるのは `資金不足`で、ウォレットのUSDC残高がガス上限×ガス価格に対して不足していることを意味します。

では、次に答えてください。

1. 初回デプロイのガス代は、なぜEthereumよりずっと高いのですか？
2. トランザクションのSolana compute unitはどこで読み取りますか： `gasUsed`それとも、ViaがリンクするSolanaトランザクションですか？
3. あなたが使ったテストネットUSDCには価値がありますか？

<details>

<summary>解答</summary>

1. ガスの大半はSolanaアカウントの作成に使われます。コントラクト、そのストレージ、そして新しいトークンアカウントです。
2. Solanaトランザクションです。Viaは"Settled in"行からそれにリンクしており、Solanaエクスプローラーがそのcompute unitを表示します。 `gasUsed` は正確な代替指標ではありません。
3. いいえ。HadrianはSolana Devnetで決済されるため、そのUSDCとSOLは実際のお金ではありません。

</details>

## 次へ

[Arenaにアプリを登録する](https://arena.mainnet.romeprotocol.xyz/apps/new) そしてこのHadrianコントラクトをそれにリンクします。アプリはBuildingへ移動します。

[4. Romeがコードをどう実行するか](https://docs.rome.builders/ja/rome-academy/04-how-rome-runs-your-code.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/ja/rome-academy/03-first-contract-on-hadrian.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
