본문으로 건너뛰기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

3. Hadrian에서의 첫 번째 컨트랙트

Hadrian에 지갑을 연결하고 자금을 충전한 뒤, Hardhat으로 컨트랙트를 배포하고, 해당 트랜잭션이 정산된 Solana 트랜잭션까지 추적해 보세요.

Hadrian, 로마의 공개 테스트넷에 작은 Solidity 컨트랙트를 배포합니다. 배포는 일반적인 Hardhat 방식입니다. 새로운 점은 가스를 USDC로 지불하고, 탐색기가 당신이 한 작업의 Solana 쪽으로 연결해 준다는 것입니다.

배울 내용

  • Hadrian에 지갑과 Hardhat을 연결하는 방법.

  • 가스가 USDC인 이유와 지갑이 이를 받는 방법.

  • Rome에 대한 쓰기가 Ethereum 관행보다 더 많은 가스를 쓰는 이유.

  • Via 탐색기에서 트랜잭션을 읽고, 이를 정산한 Solana 트랜잭션까지 추적하는 방법.

  • 소스 검증을 해서 탐색기에 표시되게 하는 방법.

시작하기 전에

당신은 이미 레슨 2를 읽었습니다. 이 컨트랙트가 어떤 첫 단계의 시작인지 보여 줍니다. 다음을 준비하세요:

  • Node.js는 빠른 시작 가 지정한 버전으로.

  • MetaMask가 설치되어 있습니다.

  • 새 계정이나 일회용 키. 개인 키를 셸로 내보내므로, 실제 자금이 들어 있는 키는 사용하지 마세요.

  • Solana에서 자금을 넣는 경우에만 Devnet으로 설정된 Solana 지갑.

경로

1단계. 지갑에 Hadrian 추가하기

Hadrian은 표준 EVM 네트워크입니다. 이름, RPC URL, 체인 ID, 통화 기호, 탐색기 URL을 수동으로 넣어 MetaMask에 추가합니다. 모든 값은 다음의 표에서 가져오세요. 퀵스타트, 1단계. 값은 Hadrian에도 있습니다. 통화 기호를 USDC.

Hardhat에도 동일한 체인 ID와 RPC URL이 필요합니다. 3단계에서 그 값을 설정 파일에 넣습니다.

2단계. 지갑에 자금 넣기

Hadrian의 가스는 USDC이며, Circle의 Solana Devnet USDC를 기반으로 합니다. SOL은 가스 토큰이 아닙니다. Rome faucet는 없습니다. 다른 곳에서 테스트용 USDC를 받아 Rome Bridge로 가져와야 합니다. 브리지를 통해 도착한 입금은 기본적으로 가스로 들어갑니다. 브리지 페이지의 수신 옵션은 가스로 두세요.

두 가지 출처가 있습니다:

  • Solana Devnet에서. Circle faucet에서 Devnet USDC를 받고, Solana 수수료를 위한 소량의 Devnet SOL도 받으세요. USDC는 Solana 경로로 브리지하고, 수신자로 EVM 주소를 넣으세요. 브리지는 Hadrian에서 클레임 트랜잭션에 EVM 지갑 서명을 요구하며, 그러면 USDC가 가스로 바뀝니다.

  • EVM 테스트넷에서. Ethereum Sepolia에서 테스트용 USDC를 민트한 다음 브리지로 가져오세요. 소스 쪽 트랜잭션 비용을 내기 위해 소량의 Sepolia ETH가 필요합니다.

단계와 faucet 링크는 퀵스타트, 2단계, Hadrian에서 지갑에 자금 넣기 그리고 파우셋에 있습니다. 브리지 자체는 Rome Bridge.

얼마나 넣어야 할까요? Quickstart에는 최소 금액과 여유 있는 금액이 제시됩니다. 시작하기 전에 읽어 보세요.

계속하기 전에 MetaMask의 잔액을 확인하세요. 0으로 보이면 전송이 아직 끝나지 않은 것입니다. 브리지 페이지에는 각 단계와 예상 시간이 표시됩니다.

3단계. Hardhat 프로젝트 만들기

TypeScript와 viem 템플릿으로 Hardhat 3 프로젝트를 만드세요. 그런 다음 hadrian 항목을 네트워크 에 추가하고, Hadrian 페이지의 체인 ID와 RPC URL을 넣으세요. 개인 키는 환경 변수에서 가져오거나 Hardhat의 암호화된 키 저장소에서 가져옵니다. 일회용 키를 넘어서는 용도라면 키 저장소를 사용하는 편이 좋습니다.

정확한 명령과 설정은 Quickstart의 3단계 그리고 4단계. Solidity 계약 배포 에 전체 설정 파일이 나오고, Foundry에서도 같은 흐름이 있습니다..

4단계. 컨트랙트 작성 및 배포

Quickstart 컨트랙트는 HelloRome, 의도적으로 단순합니다. 인사말을 저장하고, greet()호출 수를 세고, 이벤트를 발생시킵니다. 그 안에는 Rome에만 해당하는 내용이 없습니다.

이 단계의 핵심은 다음과 같습니다: HelloRome 수정 없이 배포됩니다. 다른 컨트랙트를 포팅하기 전에 알려진 제한 사항 에서 지원되지 않는 opcode와 가스 차이를 확인하세요. 그런 다음 작성하고, 배포 스크립트를 다음 대상으로 실행하세요: hadrian. 스크립트는 배포하고, greet() 를 한 번 호출한 뒤, 카운터와 인사말을 다시 읽습니다. 둘 다 Quickstart에서 복사하세요, 5단계 그리고 6단계.

성공하면 컨트랙트 주소와 1이라는 카운터를 얻게 됩니다.

5단계. 비용이 무엇이었는지 이해하기

배포에는 같은 컨트랙트가 Ethereum에서 쓰는 것보다 훨씬 더 많은 가스가 들었습니다. Rome에서 쓰기 작업의 가스 대부분은 Solana 계정을 생성하는 데 사용됩니다. 배포된 컨트랙트는 코드와 저장용 새 계정을 만듭니다. 한 번도 사용된 적 없는 수신자에게 전송할 때도 그렇고, 새 토큰 계정을 만들 때도 그렇습니다.

그에 따라 두 가지 규칙이 있습니다:

  • 도구가 가스를 다음을 사용해 추정하도록 두세요 eth_estimateGas. Hardhat도 forge create 그리고 cast send 그렇게 하세요. forge script 가 필요합니다 --skip-simulation 같은 일을 하도록.

  • 21,000을 절대 하드코딩하지 마세요. 배포나 한 번도 사용한 적 없는 주소로의 전송처럼 계정을 생성하는 쓰기 작업은 그 정도 한도에서는 실패합니다.

Rome은 트랜잭션이 실제로 사용하는 가스만 청구하므로, 높은 추정치는 추가 비용이 들지 않습니다. 도구가 더하는 여유분은 유지하세요. Solana 프로그램으로의 호출은 추정치가 낮게 나올 수 있습니다. JSON-RPC 지원 실제 쓰기 작업에 대한 측정 수치가 있습니다.

6단계. 탐색기에서 읽기

Hadrian용 Via 탐색기를 열어 컨트랙트 주소를 조회하세요. 해당 페이지는 생성 트랜잭션으로 연결해 주고, 다음 항목을 나열합니다: greet() 트랜잭션들 중 호출이 있습니다. 탐색기 링크는 Hadrian.

Via는 일반적인 EVM 보기를 보여 줍니다: 블록, 보낸 사람, 사용한 가스, 이벤트 로그. 'Settled in' 행에는 당신의 트랜잭션을 정산한 Solana 트랜잭션의 서명이 들어 있습니다. 해당 링크를 여세요. Solana 탐색기는 그 트랜잭션의 instruction, 접근한 program, 소비한 compute units를 보여 줍니다. Via Explorer 는 Via가 무엇을 더 보여 주는지 설명합니다.

컴퓨트 유닛은 거기서 읽으세요. 다음에서가 아니라 gasUsed. gasUsed 는 Solana 컴퓨트를 정확히 반영하는 척도가 아닙니다.

7단계. 소스 검증하기

검증을 하면 소스와 ABI가 공개되고, 탐색기에는 그다음 '소스 검증됨' 배지가 표시됩니다. Rome은 호스팅된 Sourcify 서비스를 운영하므로, 표준 Hardhat 및 Foundry 검증 흐름이 동작합니다. Rome의 검증기와 체인 ID를 지정하면 됩니다.

엔드포인트는 검증기 엔드포인트 아래에 있으며, 설정과 명령은 Hardhat 섹션에 있습니다. Hadrian에는 테스트넷 검증기를 사용하세요. 메인넷 검증기는 다른 URL이며, 이는 레슨 11에서 중요합니다.

자신을 점검해 보세요

결과는 다음과 같습니다: Hadrian 탐색기에서 컨트랙트를 열고 이 세 가지를 모두 확인하세요.

  • 배포 트랜잭션과, 그 'Settled in' Solana 서명, 그리고 Solana 탐색기에서 볼 수 있는 그 Solana 트랜잭션의 instruction.

  • 두 번째 트랜잭션, 즉 greet() 호출 트랜잭션에는 컨트랙트 주소에서 나온 이벤트 로그가 하나 있습니다. 그 로그는 Greeted 이벤트입니다. 첫 번째 topic은 다음의 해시입니다 Greeted(address,uint256).

  • 컨트랙트에 표시된 '소스 검증됨' 배지.

막히면, 흔한 오류는 빠른 시작에 있습니다. 보통은 자금 부족, 이는 지갑에 가스 한도와 가스 가격을 곱한 값만큼의 USDC가 충분하지 않다는 뜻입니다.

그런 다음 다음 질문에 답하세요.

  1. 첫 배포가 Ethereum보다 왜 가스가 훨씬 더 많이 들까요?

  2. 트랜잭션의 Solana compute units는 어디서 읽습니까: gasUsed아니면 Via가 연결해 주는 Solana 트랜잭션에서 읽습니까?

  3. 사용한 테스트넷 USDC에 실제 가치가 있나요?

정답
  1. 가스 대부분은 Solana 계정을 생성하는 데 쓰입니다: 컨트랙트, 그 저장소, 그리고 새 토큰 계정들입니다.

  2. Solana 트랜잭션입니다. Via는 'Settled in' 행에서 이를 연결하고, Solana 탐색기는 그 compute units를 보여 줍니다. gasUsed 는 정확한 대리 지표가 아닙니다.

  3. 아니요. Hadrian은 Solana Devnet에서 정산되므로, 그 USDC와 SOL은 실제 돈이 아닙니다.

다음

Arena에 앱을 등록하세요 그리고 이 Hadrian 컨트랙트를 연결하세요. 앱은 Building으로 이동합니다.

4. Rome이 코드를 실행하는 방식

마지막 업데이트

도움이 되었나요?