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

# 3. Hợp đồng đầu tiên của bạn trên Hadrian

Kết nối một ví với Hadrian, nạp tiền vào đó, triển khai một hợp đồng bằng Hardhat, và theo dõi giao dịch của bạn đến giao dịch Solana đã xác nhận nó.

Bạn triển khai một hợp đồng Solidity nhỏ lên Hadrian, public testnet của Rome. Việc triển khai là Hardhat thông thường. Điểm mới là bạn trả gas bằng USDC, và trình explorer dẫn bạn sang phía Solana của những gì bạn đã làm.

## Bạn sẽ học được gì

* Cách trỏ một ví và Hardhat tới Hadrian.
* Tại sao gas là USDC, và cách một ví nhận được nó.
* Tại sao một lần ghi trên Rome tốn gas nhiều hơn so với thói quen trên Ethereum gợi ý.
* Cách đọc giao dịch của bạn trên Via explorer, và theo nó tới giao dịch Solana đã quyết toán nó.
* Cách xác minh mã nguồn của bạn để explorer hiển thị nó.

## Trước khi bạn bắt đầu

Bạn đã đọc [bài học 2](https://docs.rome.builders/vi/rome-academy/02-what-you-can-build.md), bài này cho thấy hợp đồng này là bước đầu tiên hướng tới điều gì. Hãy chuẩn bị sẵn:

* Node.js ở phiên bản mà [Bắt đầu nhanh](https://docs.rome.builders/vi/bat-dau-1/quickstart.md) liệt kê.
* Đã cài MetaMask.
* Một tài khoản mới, hoặc một khóa dùng một lần. Bạn sẽ xuất khóa riêng của nó vào shell, vì vậy đừng dùng khóa đang giữ tiền thật.
* Một ví Solana đặt ở Devnet, chỉ khi bạn nạp từ Solana.

## Đường dẫn

### Bước 1. Thêm Hadrian vào ví của bạn

Hadrian là một mạng EVM tiêu chuẩn. Bạn thêm nó vào MetaMask thủ công với tên, URL RPC, chain id, ký hiệu tiền tệ và URL explorer. Lấy mọi giá trị từ bảng trong [Quickstart, bước 1](https://docs.rome.builders/pages/e8a6528397502fe89765b610eb57712fa58cad9e#id-1.-add-hadrian-to-metamask). Các giá trị cũng có trên [Hadrian](https://docs.rome.builders/vi/mang/hadrian.md). Đặt ký hiệu tiền tệ thành `USDC`.

Hardhat cần cùng chain id và URL RPC. Bạn sẽ đặt chúng trong cấu hình của nó ở bước 3.

### Bước 2. Nạp tiền cho ví

Gas trên Hadrian là USDC, được bảo chứng bởi USDC trên Solana Devnet của Circle. SOL không phải là token gas. Không có faucet của Rome. Bạn lấy USDC thử nghiệm ở nơi khác và đưa nó vào bằng Rome Bridge. Một khoản nạp đi qua bridge sẽ mặc định được nhận dưới dạng gas. Hãy để lựa chọn nhận trên trang bridge là gas.

Có hai nguồn:

* **Từ Solana Devnet.** Lấy USDC devnet từ faucet của Circle và một ít SOL devnet để trả phí Solana. Bridge USDC bằng đường dẫn Solana của nó, và cung cấp địa chỉ EVM của bạn làm người nhận. Bridge sẽ yêu cầu ví EVM của bạn ký một giao dịch xác nhận khiếu nại trên Hadrian, và điều đó biến USDC thành gas.
* **Từ một testnet EVM.** Mint USDC thử nghiệm trên Ethereum Sepolia, rồi bridge nó vào. Bạn cần một ít ETH trên Sepolia để trả phí cho giao dịch ở phía nguồn.

Các bước và liên kết faucet có trong [Quickstart, bước 2](https://docs.rome.builders/pages/e8a6528397502fe89765b610eb57712fa58cad9e#id-2.-fund-your-wallet), [Nạp một ví trên Hadrian](https://docs.rome.builders/vi/mang/hadrian.md#fund-a-wallet) và [Vòi cấp tiền](https://docs.rome.builders/vi/tai-nguyen/faucets.md). Bản thân bridge nằm trên [Cầu Rome](https://docs.rome.builders/vi/ung-dung-tren-rome/bridge-api.md).

Nạp bao nhiêu? Quickstart đưa ra mức tối thiểu và mức thoải mái. Hãy đọc trước khi bắt đầu.

Kiểm tra số dư trong MetaMask trước khi tiếp tục. Nếu nó hiển thị 0, việc chuyển tiền chưa hoàn tất. Trang bridge hiển thị từng bước và thời gian dự kiến.

### Bước 3. Tạo dự án Hardhat

Tạo một dự án Hardhat 3 với mẫu TypeScript và viem. Sau đó thêm một mục `hadrian` dưới `networks` với chain id và URL RPC từ trang Hadrian. Khóa riêng đến từ biến môi trường hoặc từ kho khóa được mã hóa của Hardhat. Hãy ưu tiên kho khóa cho mọi thứ ngoài một khóa dùng một lần.

Các lệnh chính xác và cấu hình nằm trong Quickstart, [bước 3](https://docs.rome.builders/pages/e8a6528397502fe89765b610eb57712fa58cad9e#id-3.-create-a-hardhat-project) và [bước 4](https://docs.rome.builders/pages/e8a6528397502fe89765b610eb57712fa58cad9e#id-4.-configure-hardhat-for-rome). [Triển khai Hợp đồng Solidity](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/deploy-solidity.md#hardhat) hiển thị toàn bộ tệp cấu hình, và [luồng tương tự trong Foundry](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/deploy-solidity.md#foundry).

### Bước 4. Viết và triển khai hợp đồng

Hợp đồng Quickstart, `HelloRome`, cố tình rất đơn giản. Nó lưu một lời chào, đếm số lần gọi `greet()`, và phát một sự kiện. Trong nó không có gì đặc thù cho Rome.

Đó là mục đích của bước này: `HelloRome` triển khai mà không cần thay đổi. Trước khi bạn chuyển một hợp đồng khác, hãy kiểm tra [Các hạn chế đã biết](https://docs.rome.builders/vi/bao-mat/known-limitations.md) để biết các opcode không được hỗ trợ và khác biệt về gas. Viết nó, rồi chạy script triển khai đối với `hadrian`. Script sẽ triển khai, gọi `greet()` một lần, và đọc lại counter cùng lời chào. Sao chép cả hai từ Quickstart, [bước 5](https://docs.rome.builders/pages/e8a6528397502fe89765b610eb57712fa58cad9e#id-5.-write-a-contract) và [bước 6](https://docs.rome.builders/pages/e8a6528397502fe89765b610eb57712fa58cad9e#id-6.-deploy).

Khi thành công, bạn sẽ có một địa chỉ hợp đồng và counter là 1.

### Bước 5. Hiểu chi phí của nó

Lần triển khai đã dùng nhiều gas hơn nhiều so với cùng hợp đồng đó trên Ethereum. Phần lớn gas của một thao tác ghi trên Rome được dùng để tạo các tài khoản Solana. Một hợp đồng đã triển khai tạo các tài khoản mới cho mã và bộ nhớ lưu trữ của nó. Một lần chuyển tới một người nhận chưa từng được dùng cũng vậy, và một token account mới cũng vậy.

Từ đó suy ra hai quy tắc:

* Hãy để công cụ của bạn ước tính gas bằng `eth_estimateGas`. Hardhat, `forge create` và `cast send` có thể. `forge script` cần `--skip-simulation` để làm điều tương tự.
* Đừng bao giờ hardcode 21.000. Một thao tác ghi tạo tài khoản, chẳng hạn như một lần triển khai hoặc chuyển tiền tới một địa chỉ chưa từng dùng, sẽ thất bại với giới hạn thấp như vậy.

Rome tính gas theo lượng mà giao dịch thực sự dùng, nên ước tính cao không làm bạn tốn thêm gì. Hãy giữ biên độ mà công cụ của bạn thêm vào: với một lệnh gọi vào chương trình Solana, ước tính có thể thấp đi. [Hỗ trợ JSON-RPC](https://docs.rome.builders/vi/tai-lieu-tham-khao/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) đã đo được các con số cho các thao tác ghi thực tế.

### Bước 6. Đọc nó trên explorer

Mở Via explorer cho Hadrian và tra cứu địa chỉ hợp đồng của bạn. Trang của nó liên kết giao dịch tạo ra và liệt kê `greet()` lệnh gọi trong số các giao dịch của nó. Liên kết explorer nằm trên [Hadrian](https://docs.rome.builders/vi/mang/hadrian.md).

Via hiển thị giao diện EVM quen thuộc: khối, người gửi, gas đã dùng, nhật ký sự kiện. Hàng "Settled in" của nó chứa chữ ký của giao dịch Solana đã quyết toán giao dịch của bạn. Mở liên kết đó. Explorer Solana hiển thị các chỉ thị của giao dịch đó, các chương trình nó đã chạm tới và số đơn vị compute nó đã tiêu thụ. [Via Explorer](https://docs.rome.builders/vi/ung-dung-tren-rome/via.md) giải thích Via còn hiển thị gì khác.

Đọc các đơn vị compute ở đó, không phải từ `gasUsed`. Trên Rome, `gasUsed` không phải là thước đo trung thực cho compute của Solana.

### Bước 7. Xác minh mã nguồn

Việc xác minh công bố mã nguồn và ABI của bạn, rồi explorer sẽ hiển thị huy hiệu "Source verified". Rome vận hành một dịch vụ Sourcify được lưu trữ, vì vậy các luồng xác minh chuẩn của Hardhat và Foundry đều hoạt động. Bạn trỏ chúng tới bộ xác minh của Rome và cung cấp chain id.

Các endpoint nằm dưới [Điểm cuối của trình xác minh](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/verify-contracts.md#verifier-endpoint), và cấu hình cùng lệnh ở trong phần [Hardhat](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/verify-contracts.md#hardhat) phần. Hãy dùng bộ xác minh testnet cho Hadrian. Bộ xác minh mainnet là một URL khác, điều này quan trọng trong bài học 11.

## Tự kiểm tra

Kết quả của bạn: mở hợp đồng của bạn trên explorer Hadrian và thấy cả ba điều này.

* Giao dịch triển khai của bạn, với chữ ký Solana "Settled in" của nó, và các chỉ thị của giao dịch Solana đó trên Solana explorer.
* Một giao dịch thứ hai, `greet()` lệnh gọi, với một nhật ký sự kiện từ địa chỉ hợp đồng của bạn. Nhật ký đó là sự kiện `Greeted` sự kiện; topic đầu tiên của nó là hash của `Greeted(address,uint256)`.
* Một huy hiệu "Source verified" trên hợp đồng.

Nếu bạn bị kẹt, các lỗi thường gặp nằm trong [Bắt đầu nhanh](https://docs.rome.builders/vi/bat-dau-1/quickstart.md#common-errors). Lỗi thường gặp nhất là `không đủ tiền`, nghĩa là ví đang giữ quá ít USDC so với gas limit nhân với gas price.

Rồi trả lời các câu hỏi này.

1. Tại sao một lần deploy đầu tiên lại đắt gas hơn nhiều so với trên Ethereum?
2. Bạn đọc đơn vị compute Solana của một giao dịch ở đâu: `gasUsed`, hay giao dịch Solana mà Via liên kết tới?
3. USDC testnet bạn đã dùng có giá trị gì không?

<details>

<summary>Đáp án</summary>

1. Phần lớn gas được trả cho việc tạo các tài khoản Solana: hợp đồng, bộ nhớ lưu trữ của nó, và mọi token account mới.
2. Giao dịch Solana. Via liên kết nó từ hàng "Settled in", và explorer Solana hiển thị các đơn vị compute của nó. `gasUsed` không phải là một đại diện trung thực.
3. Không. Hadrian quyết toán trên Solana Devnet, nên USDC và SOL của nó không phải tiền thật.

</details>

## Tiếp theo

[Đăng ký ứng dụng của bạn trong Arena](https://arena.mainnet.romeprotocol.xyz/apps/new) và liên kết hợp đồng Hadrian này với nó. Ứng dụng chuyển sang Building.

[4. Rome chạy mã của bạn như thế nào](https://docs.rome.builders/vi/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/vi/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.
