> 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/core-concepts/execution-model.md).

# 실행 모델

Rome EVM이 Solana에서 Ethereum 트랜잭션을 처리하는 방식 — 프록시 에뮬레이션, 원자적(VmAt) 모드와 반복적(VmIt) 모드, 그리고 전체 트랜잭션 수명주기.

Rome EVM은 Solana 온체인 프로그램 내부에서 Solidity 바이트코드를 실행합니다. 이 페이지에서는 EVM 트랜잭션이 어떻게 처리되는지 설명합니다.

## 트랜잭션 수명 주기

```
1. 사용자가 EVM 트랜잭션에 서명함 (MetaMask / ethers.js)
                    ↓
2. Rome Proxy가 eth_sendRawTransaction을 통해 수신
                    ↓
3. Proxy가 오프체인에서 트랜잭션을 에뮬레이션함 (Mollusk SVM 에뮬레이터)
   → 가스 추정, 원자성 확인, 필요한 계정 식별
                    ↓
4. Proxy가 EVM tx를 Solana instruction(s)으로 래핑
   → tx가 하나의 Solana tx에 들어가면 → 원자적 (VmAt)
   → tx가 CU 예산을 초과하면 → 반복형 (VmIt)
                    ↓
5. Solana 검증자가 instruction(s)을 실행
   → Rome EVM 프로그램이 EVM 바이트코드를 해석
   → 다른 Solana 프로그램으로의 CPI 호출(있는 경우)
                    ↓
6. 상태 변경이 Solana 계정에 커밋됨
                    ↓
7. Hercules가 이벤트를 인덱싱함 → EVM 블록 생성
```

## 원자적 실행 (VmAt)

기본 모드입니다. 전체 EVM 트랜잭션이 하나의 Solana 트랜잭션 내에서 실행됩니다.

**상태 머신:** `Lock → Init → Execute → Commit → GasTransfer → Exit`

**속성:**

* 전부 아니면 전무 실행 — 어떤 단계라도 실패하면 전체 트랜잭션이 되돌려집니다
* Solana 트랜잭션당 약 1.4M compute units 사용 가능
* 전송, 간단한 컨트랙트 호출, 스왑, 대부분의 DeFi 작업에 적합
* 1초 미만의 최종성 (Solana 블록 시간)

**사용 시점:** 에뮬레이터가 트랜잭션이 단일 Solana 트랜잭션의 compute budget 안에 들어간다고 판단하면 자동으로 선택됩니다.

## 반복형 실행 (VmIt)

단일 트랜잭션의 예산을 초과하는 계산 집약적 작업을 위한 모드입니다. EVM 실행은 여러 Solana 트랜잭션에 걸쳐 분할됩니다.

**작동 방식:**

1. 각 단계(Solana 트랜잭션)는 실행되며 **자신의 compute budget에 들어가는 만큼의 EVM opcode를** 실행합니다 — 고정 개수가 아닌 적응형 단계 크기입니다
2. 각 단계 후 VM 상태는 (Borsh 형식으로) 다음에 직렬화됩니다. `StateHolder` 계정
3. 다음 단계는 상태를 역직렬화하고 실행을 계속합니다
4. 관련 계정들은 다음 동안 TTL로 잠깁니다 **3-4초** 다단계 실행 중 세션은 최대 **160단계**그 이후에는 다음 단계가 세션의 잠금을 해제하고 아무것도 커밋하지 않은 채 종료합니다

**상태 머신:** `FromStateHolder → Lock → Init → Execute → Serialize → NextIteration → ... → Completed`

**계정 잠금:**

* 하나의 **배타적 잠금** 각 관리 계정(잔액 및 저장소 계정)당 하나씩 — 한 번에 하나의 반복형 세션만 계정을 보유할 수 있으며, 잠긴 계정에 쓰는 원자적 트랜잭션은 `AccountLocked` 으로 거부되고, 잠금이 만료될 때까지 대기한 뒤 클라이언트가 다시 전송합니다
* **TTL:** 3초이며, 각 단계마다 갱신됩니다(세션이 28개 초과 계정을 건드리면 4초)
* **Legacy-track CPI는 거부됩니다** 반복형 트랜잭션 내부에서 (`CpiProhibitedInIterativeTx`); cached-track 효과는 스테이징되었다가 শেষে 커밋됩니다

**사용 시점:** 대규모 컨트랙트 배포, 깊은 호출 스택, 약 1.4M CU를 초과하는 모든 작업. BN254 pairing check 하나만으로는 필요하지 않습니다; 참조: [컴퓨트 예산](https://docs.rome.builders/ko/core-concepts/compute-budget.md).

## 에뮬레이션

트랜잭션을 Solana에 제출하기 전에 Proxy는 다음을 사용해 오프체인에서 에뮬레이션합니다. **Mollusk SVM 에뮬레이터**. 이것은:

1. 가스 소비를 추정하고
2. 원자 모드 또는 반복 모드가 필요한지 결정하며
3. 트랜잭션이 접근할 모든 Solana 계정을 식별하고
4. 트랜잭션이 온체인에서 실패하지 않을지 검증합니다

에뮬레이터는 온체인 프로그램과 동일한 EVM 로직을 실행합니다 —  `entrypoint!` 매크로는 프로그램과 에뮬레이터 코드베이스 모두에서 동일한 dispatch table을 보장합니다.

**Mollusk SVM** 은 에뮬레이션 중 임의의 Solana BPF 프로그램도 실행할 수 있으므로 `eth_call` 그리고 `eth_estimateGas` SPL Token, Jupiter, Kamino 등으로의 CPI 호출을 올바르게 처리할 수 있습니다.

## 계정 매핑

모든 Ethereum 주소는 Solana PDA에 매핑됩니다:

```
Ethereum 주소 (H160, 20바이트)
    ↓
PDA = findProgramAddress(
    [chain_id, "ACCOUN_SEED", H160, bump],
    ROME_EVM_PROGRAM_ID
)
    ↓
Solana 계정 (Pubkey, 32바이트)
```

**온체인에 저장되는 계정 유형:**

| 유형          | 시드                                           | 목적                       |
| ----------- | -------------------------------------------- | ------------------------ |
| 잔액          | `[chain, "ACCOUN_SEED", H160, bump]`         | Nonce, 잔액, 컨트랙트 코드       |
| 저장소         | `[chain, "STORAGE", H160, slot_index, bump]` | 컨트랙트 저장소(계정당 256 슬롯)     |
| TxHolder    | `[signer, "TX_HOLDER_SEED", index, bump]`    | 스테이징된 트랜잭션 데이터(최대 80 KB) |
| StateHolder | `[signer, "STATE_HOLDER_SEED", index, bump]` | 반복 사이의 직렬화된 VM 상태        |

## 홀더 계정

Rome은 Solana **v1 트랜잭션을 전송하며**, 이는 4 KB(4,096바이트)와 64개 주소로 제한됩니다. EVM 트랜잭션 — 특히 컨트랙트 배포 — 은 훨씬 더 클 수 있습니다.

**분할 메커니즘:**

1. SDK는 RLP 인코딩된 트랜잭션을 여러 청크로 분할합니다
2. 각 청크는 다음을 통해 `TxHolder` 계정에 기록됩니다 `TransmitTx` instruction
3. 모든 청크가 스테이징되면 `DoTxHolder` instruction이 전체 트랜잭션을 조립하고 실행합니다
4. 최대 홀더 크기: **80 KB** TxHolder당

이것은 개발자에게 완전히 투명합니다 — Rome SDK가 분할과 재조립을 자동으로 처리합니다.

## 지원되는 트랜잭션 유형

| 유형               | EIP      | 설명                                                                                                                                                                          |
| ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 레거시              | —        | 전통적인 Ethereum 트랜잭션                                                                                                                                                          |
| Access List      | EIP-2930 | 최적화된 상태 접근 패턴                                                                                                                                                               |
| 다이내믹 수수료         | EIP-1559 | 기본 수수료 + 우선 수수료                                                                                                                                                             |
| 서명되지 않은 EIP-1559 | —        | 하나의 `0x02`형식의 본문으로, secp256k1 서명은 없고 대신 Solana 지갑의 Ed25519 서명으로 승인됩니다(솔라나 레인; 참조 [Solana에서 EVM 호출](https://docs.rome.builders/ko/developer-guides/call-evm-from-solana.md)) |
| 입금               | 유형 0x7E  | 예치 트랜잭션, 예: 브리지 인바운드 정산                                                                                                                                                     |

## 저널링된 상태

Rome EVM은 실행 중 상태 변경을 관리하기 위해 저널링된 상태 모델을 사용합니다:

* 모든 변경(Nonce, 잔액, 저장소, 코드)은 다음에 추적됩니다. `저널`
* 중첩된 CALL/CREATE 작업은 스냅샷 프레임을 푸시합니다
* 되돌리기 시: 저널 항목이 스냅샷으로 롤백됩니다
* 성공 시: 변경 사항이 Solana 계정에 커밋됩니다
* 비-EVM CPI instruction은 즉시 실행됩니다(Solana 자체의 원자성 보장이 정확성을 보장합니다)

## 다음은 무엇인가

* [컴퓨트 예산](https://docs.rome.builders/ko/core-concepts/compute-budget.md) — CU 비용 및 최적화 전략
* [제약 사항](https://docs.rome.builders/ko/core-concepts/constraints.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/core-concepts/execution-model.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.
