> 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/id/rome-academy/03-first-contract-on-hadrian.md).

# 3. Kontrak pertama Anda di Hadrian

Hubungkan dompet ke Hadrian, danai dompet itu, deploy kontrak dengan Hardhat, lalu ikuti transaksi Anda hingga ke transaksi Solana yang menyelesaikannya.

Anda men-deploy kontrak Solidity kecil ke Hadrian, testnet publik Rome. Deploy-nya biasa, seperti Hardhat. Yang baru adalah Anda membayar gas dengan USDC, dan explorer mengarahkan Anda ke sisi Solana dari apa yang Anda lakukan.

## Apa yang akan Anda pelajari

* Cara mengarahkan wallet dan Hardhat ke Hadrian.
* Mengapa gas berupa USDC, dan bagaimana sebuah wallet mendapatkannya.
* Mengapa sebuah write di Rome memakan gas lebih banyak daripada yang biasa Anda kira dari kebiasaan Ethereum.
* Cara membaca transaksi Anda di explorer Via, dan menelusurinya ke transaksi Solana yang menyelesaikannya.
* Cara memverifikasi source Anda agar explorer menampilkannya.

## Sebelum Anda mulai

Anda telah membaca [pelajaran 2](https://docs.rome.builders/id/rome-academy/02-what-you-can-build.md), yang menunjukkan kontrak ini merupakan langkah pertama menuju apa. Siapkan ini:

* Node.js pada versi yang [Quickstart](https://docs.rome.builders/id/memulai-1/quickstart.md) mencantumkan.
* MetaMask terpasang.
* Akun baru, atau kunci sekali pakai. Anda mengekspor private key-nya ke shell Anda, jadi jangan gunakan kunci yang menyimpan dana sungguhan.
* Wallet Solana yang disetel ke Devnet, hanya jika Anda mendanai dari Solana.

## Jalur

### Langkah 1. Tambahkan Hadrian ke wallet Anda

Hadrian adalah jaringan EVM standar. Anda menambahkannya ke MetaMask secara manual dengan nama, URL RPC, chain id, simbol mata uang, dan URL explorer. Ambil setiap nilai dari tabel di [Quickstart, langkah 1](https://docs.rome.builders/pages/7e76e600c8c1b4f41b9c12c1915ec0a91a01e0e4#id-1.-add-hadrian-to-metamask). Nilai-nilainya juga ada di [Hadrian](https://docs.rome.builders/id/jaringan/hadrian.md). Setel simbol mata uang menjadi `USDC`.

Hardhat memerlukan chain id dan URL RPC yang sama. Anda memasukkannya ke konfigurasi pada langkah 3.

### Langkah 2. Danai wallet

Gas di Hadrian adalah USDC, yang didukung oleh USDC Solana Devnet dari Circle. SOL bukan token gas. Tidak ada faucet Rome. Anda mendapatkan USDC uji dari tempat lain dan membawanya masuk dengan Rome Bridge. Deposit yang datang melalui bridge akan masuk sebagai gas secara default. Biarkan pilihan receive pada halaman bridge tetap di gas.

Ada dua sumber:

* **Dari Solana Devnet.** Ambil USDC devnet dari faucet Circle dan sedikit SOL devnet untuk biaya Solana. Bridge USDC melalui rute Solana-nya, dan masukkan alamat EVM Anda sebagai penerima. Bridge meminta wallet EVM Anda menandatangani transaksi klaim di Hadrian, dan itu mengubah USDC menjadi gas.
* **Dari testnet EVM.** Mint USDC uji di Ethereum Sepolia, lalu bridge ke sini. Anda memerlukan sedikit ETH Sepolia untuk membayar transaksi di sisi sumber.

Langkah-langkah dan tautan faucet ada di [Quickstart, langkah 2](https://docs.rome.builders/pages/7e76e600c8c1b4f41b9c12c1915ec0a91a01e0e4#id-2.-fund-your-wallet), [Danai wallet di Hadrian](https://docs.rome.builders/id/jaringan/hadrian.md#fund-a-wallet) dan [Faucets](https://docs.rome.builders/id/sumber-daya/faucets.md). Bridge itu sendiri ada di [Rome Bridge](https://docs.rome.builders/id/aplikasi-di-rome/bridge-api.md).

Berapa banyak yang harus didanai? Quickstart memberi jumlah minimum dan jumlah yang nyaman. Baca itu sebelum Anda mulai.

Periksa saldo di MetaMask sebelum melanjutkan. Jika menunjukkan nol, transfer belum selesai. Halaman bridge menampilkan setiap langkah dan waktu yang diharapkan.

### Langkah 3. Buat proyek Hardhat

Buat proyek Hardhat 3 dengan template TypeScript dan viem. Lalu tambahkan sebuah `hadrian` entri di bawah `networks` dengan chain id dan URL RPC dari halaman Hadrian. Private key diambil dari variabel lingkungan atau dari keystore terenkripsi Hardhat. Lebih baik gunakan keystore untuk apa pun selain kunci sekali pakai.

Perintah dan konfigurasi yang tepat ada di Quickstart, [langkah 3](https://docs.rome.builders/pages/7e76e600c8c1b4f41b9c12c1915ec0a91a01e0e4#id-3.-create-a-hardhat-project) dan [langkah 4](https://docs.rome.builders/pages/7e76e600c8c1b4f41b9c12c1915ec0a91a01e0e4#id-4.-configure-hardhat-for-rome). [Deploy Solidity Contracts](https://docs.rome.builders/id/panduan-pengembang/deploy-solidity.md#hardhat) menunjukkan file konfigurasi lengkap, dan [alur yang sama di Foundry](https://docs.rome.builders/id/panduan-pengembang/deploy-solidity.md#foundry).

### Langkah 4. Tulis dan deploy kontraknya

Kontrak Quickstart, `HelloRome`, sengaja dibuat sederhana. Kontrak ini menyimpan salam, menghitung pemanggilan `greet()`, dan mengeluarkan event. Tidak ada di dalamnya yang khusus untuk Rome.

Itulah tujuan langkah ini: `HelloRome` dideploy tanpa perubahan. Sebelum Anda mem-port kontrak lain, periksa [Keterbatasan yang diketahui](https://docs.rome.builders/id/keamanan/known-limitations.md) untuk opcode yang tidak didukung dan perbedaan gas. Tulis, lalu jalankan skrip deploy terhadap `hadrian`. Skrip tersebut men-deploy, memanggil `greet()` sekali, dan membaca kembali counter serta salamnya. Salin keduanya dari Quickstart, [langkah 5](https://docs.rome.builders/pages/7e76e600c8c1b4f41b9c12c1915ec0a91a01e0e4#id-5.-write-a-contract) dan [langkah 6](https://docs.rome.builders/pages/7e76e600c8c1b4f41b9c12c1915ec0a91a01e0e4#id-6.-deploy).

Jika berhasil, Anda mendapatkan alamat kontrak dan counter bernilai 1.

### Langkah 5. Pahami biayanya

Deploy tersebut memakai gas jauh lebih banyak daripada kontrak yang sama di Ethereum. Sebagian besar gas dari sebuah write di Rome dibayar untuk membuat akun Solana. Kontrak yang dideploy membuat akun baru untuk kode dan storage-nya. Begitu juga transfer ke penerima yang belum pernah digunakan, dan juga akun token baru.

Dua aturan berikutnya:

* Biarkan tooling Anda memperkirakan gas dengan `eth_estimateGas`. Hardhat, `forge create` dan `cast send` melakukannya. `forge script` memerlukan `--skip-simulation` untuk melakukan hal yang sama.
* Jangan pernah hardcode 21.000. Sebuah write yang membuat akun, seperti deploy atau transfer ke alamat yang belum pernah digunakan, akan gagal dengan batas serendah itu.

Rome menagih gas yang benar-benar digunakan transaksi, jadi estimasi tinggi tidak merugikan Anda. Pertahankan margin yang ditambahkan tooling Anda: untuk pemanggilan ke program Solana, estimasinya bisa jadi terlalu rendah. [Dukungan JSON-RPC](https://docs.rome.builders/id/referensi/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) memiliki angka terukur untuk write sungguhan.

### Langkah 6. Baca di explorer

Buka explorer Via untuk Hadrian dan cari alamat kontrak Anda. Halamannya menautkan transaksi pembuatan dan mencantumkan `greet()` pemanggilan di antara transaksinya. Tautan explorer ada di [Hadrian](https://docs.rome.builders/id/jaringan/hadrian.md).

Via menampilkan tampilan EVM biasa: blok, pengirim, gas yang dipakai, log event. Baris "Settled in" berisi signature transaksi Solana yang menyelesaikan transaksi Anda. Buka tautan itu. Explorer Solana menampilkan instruksi transaksi tersebut, program yang disentuhnya, dan compute unit yang dikonsumsinya. [Via Explorer](https://docs.rome.builders/id/aplikasi-di-rome/via.md) menjelaskan apa lagi yang ditampilkan Via.

Baca compute unit di sana, bukan dari `gasUsed`. Di Rome, `gasUsed` bukan ukuran yang akurat untuk compute Solana.

### Langkah 7. Verifikasi source

Verifikasi memublikasikan source dan ABI Anda, lalu explorer menampilkan lencana "Source verified". Rome menjalankan layanan Sourcify yang di-host, jadi alur verifikasi standar Hardhat dan Foundry berfungsi. Anda mengarahkannya ke verifier Rome dan memberikan chain id.

Endpoint ada di bawah [Endpoint verifier](https://docs.rome.builders/id/panduan-pengembang/verify-contracts.md#verifier-endpoint), dan konfigurasi serta perintahnya ada di [Hardhat](https://docs.rome.builders/id/panduan-pengembang/verify-contracts.md#hardhat) bagian tersebut. Gunakan verifier testnet untuk Hadrian. Verifier mainnet adalah URL berbeda, yang penting dalam pelajaran 11.

## Uji diri Anda

Hasil Anda: buka kontrak Anda di explorer Hadrian dan lihat ketiganya.

* Transaksi deploy Anda, beserta signature Solana pada "Settled in", dan instruksi transaksi Solana itu di explorer Solana.
* Transaksi kedua, yaitu `greet()` call, dengan satu log event dari alamat kontrak Anda. Log itu adalah `Greeted` event; topik pertamanya adalah hash dari `Greeted(address,uint256)`.
* Lencana "Source verified" pada kontrak.

Jika Anda buntu, kesalahan umum ada di [Quickstart](https://docs.rome.builders/id/memulai-1/quickstart.md#common-errors). Yang paling umum adalah `dana tidak cukup`, yang berarti wallet menyimpan USDC terlalu sedikit untuk gas limit dikali gas price.

Lalu jawab ini.

1. Mengapa deploy pertama jauh lebih mahal dalam gas daripada di Ethereum?
2. Di mana Anda membaca compute unit Solana suatu transaksi: `gasUsed`, atau transaksi Solana yang ditautkan Via?
3. Apakah USDC testnet yang Anda gunakan bernilai apa pun?

<details>

<summary>Jawaban</summary>

1. Sebagian besar gas dibayar untuk membuat akun Solana: kontrak, storage-nya, dan akun token baru apa pun.
2. Transaksi Solana. Via menautkannya dari baris "Settled in", dan explorer Solana menampilkan compute unit-nya. `gasUsed` bukan proksi yang akurat.
3. Tidak. Hadrian diselesaikan di Solana Devnet, jadi USDC dan SOL-nya bukan uang sungguhan.

</details>

## Berikutnya

[Daftarkan aplikasi Anda di Arena](https://arena.mainnet.romeprotocol.xyz/apps/new) dan tautkan kontrak Hadrian ini ke sana. Aplikasi berpindah ke Building.

[4. Bagaimana Rome menjalankan kode Anda](https://docs.rome.builders/id/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/id/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.
