> 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/ko/rome/04-how-rome-runs-your-code.md).

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

Rome 트랜잭션이 Solana 트랜잭션으로 바뀌는 방식, 대부분의 호출이 원자적으로 실행되는 이유, 그리고 호출이 너무 클 때 무엇이 달라지는지 알아봅니다.

Solidity 코드는 그대로 실행됩니다. 달라지는 것은 실행되는 장소입니다. Solana 프로그램 내부에서, Solana의 제한 아래 실행됩니다. 이 레슨에서는 호출 비용을 예측하고 언제 실패하는지 알기 위해 필요한 그림을 제공합니다.

## 배울 내용

* 트랜잭션이 지갑에서 Solana 검증자로 갔다가 다시 EVM 영수증으로 돌아오는 경로.
* 원자적 실행과 반복 실행의 차이, 그리고 왜 원자적 실행이 필요한지.
* 어떤 Solana 제한이 Solidity에 영향을 미치는지: 계산량, 크기, 계정 수, 잠금.
* 호출의 실제 비용을 측정하는 방법.

## 시작하기 전에

* 마치기 [3. Hadrian에서의 첫 컨트랙트](https://docs.rome.builders/ko/rome/03-first-contract-on-hadrian.md). 배포된 계약과 그 계약에 보낸 트랜잭션 하나가 필요합니다.
* 그 트랜잭션 해시를 준비해 두세요. 이 레슨의 마지막에 탐색기에서 열게 됩니다.

## 하나의 트랜잭션 경로

일반적인 EVM 트랜잭션에 서명하고 `eth_sendRawTransaction`를 사용해 Rome 프록시에 보냅니다. 프록시는 아직 이를 전달하지 않습니다. 먼저 동일한 EVM 로직을 온체인 프로그램과 같은 방식으로 실행하는 에뮬레이터에서 호출을 오프체인으로 실행합니다. 에뮬레이션은 프록시에 세 가지를 알려 줍니다. 호출에 필요한 가스량, 호출이 접근하는 Solana 계정, 그리고 호출이 하나의 Solana 트랜잭션에 들어가는지 여부입니다.

그다음 프록시는 호출을 Solana 지시문으로 감싸 전송합니다. 일반적인 Solana 프로그램인 Rome EVM 프로그램이 여러분의 바이트코드를 해석합니다. 상태 변경은 Solana 계정에 기록됩니다. 인덱서는 결과를 읽어 도구가 기대하는 EVM 블록과 영수증을 생성합니다.

모든 EVM 주소는 Rome 프로그램이 소유한 Solana 계정에 매핑됩니다. 계약의 잔액, 논스, 코드, 저장소는 모두 Solana 계정입니다. 그래서 프록시는 전송하기 전에 계정 목록을 알아야 합니다. Solana는 모든 계정을 미리 지정해야 하기 때문입니다.

전체 수명 주기는 다음에서 읽어보세요 [실행 모델](https://docs.rome.builders/ko/core-concepts/execution-model.md).

## 원자적 실행 우선

대부분의 호출은 하나의 Solana 트랜잭션에서 실행됩니다. Rome은 이를 원자적 실행(VmAt)이라고 부릅니다. 이는 전부 아니면 전무입니다. 어떤 단계라도 실패하면 전체 호출이 되돌려집니다. 전송, 스왑, 그리고 대부분의 DeFi 호출은 들어맞습니다. 하지만 그렇지 않은 것도 있습니다. Hadrian에서의 Aave 대출은 하나 이상의 Solana 트랜잭션이 필요했습니다.

하나의 원자적 호출에는 약 140만 compute unit의 예산이 있습니다. 이 제한들은 모든 호출을 좌우합니다:

| 한도    | 여러분에게 의미하는 바                                                                        |
| ----- | ----------------------------------------------------------------------------------- |
| 계산량   | EVM 작업과 호출하는 모든 프로그램이 함께 쓰는 약 140만 CU                                               |
| 계정    | Rome의 자체 계정과 여러분의 CPI가 접근하는 모든 것을 포함해 64개 주소                                        |
| 크기    | Solana 트랜잭션당 4KB; 대형 배포와 같은 더 큰 EVM 페이로드는 holder 계정을 통해 단계적으로 처리되며 SDK가 이를 대신 처리합니다 |
| 계약 크기 | Ethereum과 마찬가지로 24KB                                                                |

값이 포함된 전체 목록은 [제약 사항](https://docs.rome.builders/ko/core-concepts/constraints.md).

## 호출이 너무 클 때의 반복 실행

에뮬레이터가 호출이 들어가지 않는다고 판단하면, Rome은 이를 반복적으로 실행합니다(VmIt). 호출은 여러 leg로 잘립니다. 각 leg는 독립적인 Solana 트랜잭션이며, 계산 예산이 허용하는 만큼의 opcode를 실행합니다. leg 사이에는 VM 상태가 holder 계정에 저장되고 다음 leg가 이를 이어받습니다.

반복 실행은 동작하지만 대가가 있습니다:

* 세션은 160개 leg 이후 종료됩니다. 그 이후에는 잠금을 해제하고 아무 것도 커밋하지 않습니다.
* 세션은 잔액 및 저장소 계정을 몇 초 동안 잠그며, 각 leg마다 갱신됩니다. 잠긴 계정에 대한 원자적 쓰기는 다음과 함께 거부됩니다 `AccountLocked`이고, 클라이언트가 다시 전송합니다.
* 레거시 경로에서 Solana CPI를 수행하는 호출(레슨 5의 `` `CpiProgram` `` 그리고 `` `HelperProgram` `` 호출)은 아예 반복 실행될 수 없습니다. 반드시 원자적으로 들어맞아야 합니다.
* Solana 경로에서는 자신의 leg에 서명하는 지갑이 leg마다 사용자에게 한 번씩 프롬프트를 띄웁니다.

따라서 설계 원칙은 이렇습니다: 각 사용자 작업이 하나의 원자적 트랜잭션에 들어가도록 구성하세요. 흐름이 더 크다면 반복 모드에 기대기보다 두 개의 사용자 작업으로 나누세요. 레슨 5에서는 Solana 프로그램을 호출할 때 이 부분으로 다시 돌아옵니다.

## 지불하는 비용

Rome은 호출 비용을 Solana lamport 단위로 계산합니다: 서명 수수료, 정액 통행료, 그리고 호출이 생성하는 모든 계정의 rent입니다. 가스 1단위는 비용 1 lamport를 의미합니다. 가스 가격은 이를 체인의 가스 토큰으로 변환하며, Hadrian과 Rubicon에서는 USDC입니다.

rent는 사람들이 놀라는 부분입니다. 한 번도 사용된 적 없는 주소로의 첫 전송은 계정을 생성하므로, 반복 전송보다 훨씬 더 비쌉니다. 첫 접촉에서는 높은 가스를, 이후에는 일반적인 가스를 예상하세요. 계산 예시는 [Rome에서 Solana와 EVM이 만나는 방식](https://docs.rome.builders/ko/core-concepts/how-solana-and-evm-meet.md#gas-and-rent).

## 추측하지 말고 측정하세요

EVM의 `gasUsed` 는 Solana compute를 충실하게 대변하지 않습니다. Rome에서는 가스 1단위가 비용 1 lamport이므로 `eth_estimateGas` 는 가스 한도를 정해 주지만 compute unit에 대해서는 아무 것도 알려 주지 않습니다. compute는 Solana 쪽에서 확인하세요. Via는 "Settled in" 행에서 해당 Solana 트랜잭션으로 연결해 주며, Solana 탐색기는 그 compute unit을 보여 줍니다. 코드에서는 EVM 해시 뒤에 있는 Solana 서명을 다음으로 가져오세요 `rome_solanaTxForEvmTx`를 사용해 각각을 Solana의 `getTransaction` 그리고 `maxSupportedTransactionVersion: 1`로 가져오고, `computeUnitsConsumed`를 읽으세요. 반복 호출은 leg마다 하나의 트랜잭션을 갖습니다. [계산 예산](https://docs.rome.builders/ko/core-concepts/compute-budget.md) 은 작업당 일반적인 비용과 이를 줄이는 저렴한 습관들을 다룹니다: 프로그램 ID용 상수, 캐시된 PDA 도출, 더 적은 계정.

Ethereum과 다른 두 가지 동작이 있으며, 지금 알아둘 가치가 있습니다:

* Rome에는 opcode별 가스 미터가 없습니다. \`CALL\`에 전달하는 가스는 강제되지 않으며 2300가스 스티펜드도 없습니다. `CALL` 은 적용되지 않습니다. 재진입에 대해서는 명시적으로 방어하세요.
* `block.number` 는 Solana 슬롯이고 `block.timestamp` 는 Solana 시계입니다.

## 자신을 점검해 보세요

레슨 3에서의 트랜잭션을 Hadrian 탐색기에서 여세요. 다음에서 네트워크 링크를 찾으세요 [Hadrian](https://docs.rome.builders/ko/networks/hadrian.md) 그리고 다음에서 탐색기 노트를 찾으세요 [Via 탐색기](https://docs.rome.builders/ko/rome-1/via.md).

두 가지를 관찰하세요:

1. 당신의 호출을 정산한 Solana 트랜잭션, "Settled in" 행에서.
2. 그것이 소비한 compute unit, Solana 탐색기에서.

그 숫자를 140만 예산과 비교해 보세요. 단순한 호출은 그중 작은 부분만 사용합니다.

그런 다음 답하세요:

<details>

<summary>1. 왜 프록시는 호출을 보내기 전에 에뮬레이션하나요?</summary>

Solana는 모든 계정을 사전에 지정해야 하고, 프록시는 호출이 하나의 트랜잭션에 들어가는지 알아야 합니다. 에뮬레이션은 접근된 계정을 찾고, 가스를 추정하고, 원자적 실행인지 반복 실행인지 결정합니다.

</details>

<details>

<summary>2. 호출이 레거시 경로 CPI(`CpiProgram` 및 `HelperProgram` 호출, 레슨 5)을 만들고 140만 CU를 초과하면 어떻게 되나요?</summary>

실행할 수 없습니다. 레거시 경로 CPI는 반복 트랜잭션 안에서 거부되므로, 호출은 하나의 원자적 트랜잭션에 들어가야 합니다. 작업을 더 작은 사용자 작업으로 나누세요.

</details>

<details>

<summary>3. 새 주소로의 첫 전송은 왜 비싼가요?</summary>

Rome이 이를 위해 Solana 계정을 생성하고, 그 계정들의 rent는 송신자에게 가스 হিসেবে 청구됩니다.

</details>

## 다음

[5. Solidity에서 Solana 호출하기](https://docs.rome.builders/ko/rome/05-call-solana-from-solidity.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/ko/rome/04-how-rome-runs-your-code.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.
