> 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/developer-guides/call-evm-from-solana.md).

# Solana에서 EVM 호출

Solana 지갑이 Ethereum 키 없이 Rome에서 EVM 계약을 구동하게 하세요. 지갑이 서명하고, 그 트랜잭션은 Solana로 전송됩니다.

의 반대 [EVM에서 Solana 호출](https://docs.rome.builders/ko/developer-guides/call-solana-from-evm.md): 솔라나 지갑(예: Solflare)이 Rome의 어떤 EVM 계약이든 직접 호출하며, **이더리움 키 없이**. 이것이 [Aerarium](https://docs.rome.builders/ko/rome-1/apps.md) 솔라나 네이티브 사용자가 EVM 사용자와 같은 계약을 공유할 수 있게 합니다.

한 번의 호출 방식은 SDK의 `submitRomeTxV1`, 프록시가 호출을 위해 하나의 Solana v1 트랜잭션을 구성하게 합니다. 이 페이지는 그 메커니즘을 설명합니다.

## 합성 주소

솔라나 지갑의 EVM 식별자는 그 지갑의 **합성 주소** — 다음의 마지막 20바이트: `keccak256` 32바이트 솔라나 공개키의:

```
synthetic_evm_address = keccak256(solana_pubkey)[12:]
```

이것은 `msg.sender` 지갑이 계약을 호출할 때의 식별자이며, 그 nonce와 저장소가 존재하는 안정적인 식별자입니다. 이 파생 방식은 프로토콜에 고정되어 있으므로, 지갑은 항상 같은 주소로 매핑됩니다.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // 0x… 20바이트
```

## 합성은 통과용일 뿐입니다 — 정지 상태에서는 토큰을 보유하지 않습니다

솔라나 네이티브 사용자의 사용 가능한 잔액은 그들의 **Solana 지갑** (SPL 토큰으로), EVM 측에서는 토큰의 **ERC20SPL 래퍼** (예: `wUSDC`). 합성은 정지 상태에서 아무것도 보유하지 않으므로, 가치가 *을 통해* 그것을 거칩니다 — 모든 단계는 솔라나 지갑 서명으로 이루어집니다:

1. **프로비저닝(한 번).** 새로 생성된 합성의 외부 인증 PDA는 다음 때까지 존재하지 않습니다: `create_pda` 실행됩니다 — 그리고 아래의 전송은 그 PDA로 서명됩니다. `submitRomeTxSolanaLane` 첫 사용 시 자동으로 프로비저닝합니다(또는 `provisionSynthetic` 를 호출해 명시적인 "활성화" 단계를 수행하세요; 다음으로 확인: `isSyntheticProvisioned`).  `submitRomeTxV1`와 함께, 확인하고 `isSyntheticProvisioned` 제출하세요 `buildCreatePdaCall` 한 번 거쳐서.
2. **자금 이동 단계(지갑 → 합성).** 지갑의 ATA에서 합성의 ATA로 토큰을 이동하세요 — `ActivateAta` 단계이며, 다음에 의해 구성됩니다: `buildFundLeg`. `wrapper.balanceOf(synthetic)` 가 그 잔액을 읽으므로, 합성은 이를 일반 ERC-20(`transfer` / `transferFrom`) — **가 아니라** 네이티브 `msg.value`, 합성이 보유하지 않는 것처럼.
3. **호출(들)(`DoTxUnsigned`).** 합성이 EVM 트랜잭션(들)을 실행합니다 — 예: `approve` 그 다음 금고에 `예치` 을 통해 끌어오는 `transferFrom`.
4. **정리 단계(합성 → 지갑).** 출금 / 차입 / 청구 후 토큰이 합성에 들어오면, `buildSweepLeg` 이를 사용자의 지갑 ATA로 다시 밀어 넣습니다(`HelperProgram.transfer_spl`), 따라서 합성의 순잔액은 0이 됩니다.

다음 섹션에서는 이전의 `submitRomeTxSolanaLane` 이 클라이언트 측에서 구성하는지 설명합니다. `submitRomeTxV1` 는 대신 프록시가 v1 트랜잭션을 구성하게 하며, 코드에는 계정 탐색, ComputeBudget, 또는 treasure wallet이 없습니다; 다음을 보세요 [external-V1 엔드포인트](#the-external-v1-endpoints) 아래.

## 호출이 구성되는 방식

`submitRomeTxSolanaLane` 가 이 모든 것을 처리합니다. 메커니즘은 다음과 같습니다:

1. **서명되지 않은 EIP-1559 트랜잭션을 구성합니다** 와 `에서` = 합성 주소 — secp256k1 서명 없음.
2. **계정 탐색** — 호출: [`rome_emulateCallAccounts`](https://docs.rome.builders/ko/reference/json-rpc.md) 호출의 `에서`, `를`, `데이터`, **그리고 `값`** (호출이 payable일 때). 전달하는 것은 `값` 중요합니다: 프록시는 *실제* 호출을 에뮬레이션하므로, 값에 의존하는 저장소 쓰기 — 예를 들어 새 mapping 슬롯 — 가 할당되고 그 Solana 계정이 반환됩니다. 이를 생략하면 해당 계정이 없어서 트랜잭션이 다음 오류로 실패합니다: *"instruction modified data of a read-only account."*
3. **Solana 트랜잭션을 조립합니다:** 두 개의 **ComputeBudget** 지시문(Rome의 EVM은 상향된 CU 한도 ≈1.35M와 큰 힙 프레임 ≈250 KB가 필요하며 — Solana 기본값으로는 실패합니다) + **`DoTxUnsigned`** 지시문(서명되지 않은 RLP + 발견된 계정들) + 체인별 **트레저 지갑** (실행이 여기에 소액 수수료를 지불합니다; 탐색에서는 이를 생략하므로 SDK가 덧붙입니다).
4. **지갑이 서명하고 제출합니다.** 위의 **솔라나 지갑이 Solana 트랜잭션(Ed25519)에 서명하고 이를 Solana RPC로 전송합니다 — 프록시로 보내는 것이 아닙니다.** Solana 런타임이 서명을 검증합니다; 온체인에서는 프로그램이 `msg.sender` 그 서명자로부터 이를 파생합니다. 권한은 이더리움 서명이 아니라 Solana 서명입니다. (프록시는 2단계의 에뮬레이션/탐색에만 사용됩니다.)

사용자의 PDA(`["EXTERNAL_AUTHORITY", synthetic_address]`)이 토큰 계정을 소유하고 사용자를 대신해 SPL CPI에 서명합니다 — 따라서 솔라나 사용자는 공급, 차입, 스왑, LP를 전부 자신의 솔라나 지갑에서 수행할 수 있습니다.

## external-V1 엔드포인트는

`submitRomeTxV1` 한 번의 호출 방식입니다: 프록시에 구성된 v1 트랜잭션을 요청하고, 이를 검증한 뒤, 지갑이 서명하게 하고 Solana RPC로 전송하며, 호출이 맞지 않을 때는 프록시를 통해 릴레이합니다. 프록시는 RPC 메서드와 같은 경로를 제공하므로 어떤 클라이언트도 SDK 없이 사용할 수 있습니다(전체 목록은 [JSON-RPC 지원](https://docs.rome.builders/ko/reference/json-rpc.md)):

* `rome_composeUnsignedAtomicV1(rlp, pubkey, signature)` — 하나의 Solana v1 트랜잭션; 지갑이 서명하고 앱이 이를 Solana RPC로 브로드캐스트합니다. 호출이 하나의 원자적 트랜잭션에 맞지 않으면 거부됩니다.
* `rome_composeUnsignedIterativeV1(rlp, pubkey, signature)` — 실행의 모든 단계(맞으면 원자적, 아니면 반복 단계); 지갑이 각각에 서명하고, `rome_submitSignedV1Plan` 이를 브로드캐스트합니다. 긴 계획의 한계는 [릴레이된 호출과 긴 호출](#relayed-calls-and-long-calls).
* `rome_relayUnsignedV1(rlp, pubkey, signature)` — 지갑 서명 한 번으로, 프록시의 payer가 각 단계를 진행하고 EVM 트랜잭션 해시를 반환합니다; 합성이 Rome 가스를 지불하므로, 한 번 충전하세요: `rome_composeExternalDepositV1`.

**승인 서명입니다.** `rlp` 는 순수한 9필드 서명 없는 EIP-1559 본문입니다. 지갑은 자신의 Ed25519 키로, 다음 중 하나에 서명합니다: 원시 32바이트 `keccak256(0x02 ‖ rlp)` 또는 읽을 수 있는 메시지

```
Rome authorization
0x<해당 해시의 소문자 16진수 64자>
```

둘 다 허용됩니다; 읽을 수 있는 형식은 지갑이 `signMessage` 프롬프트에서 명확하게 표시합니다. 프로그램은 실행하는 본문에서 해시를 다시 계산하고, 서명된 메시지가 정확히 두 형식 중 하나여야 하므로, 한 본문에 대한 서명이 다른 본문을 승인할 수 없으며, 본문의 nonce가 재생 공격을 방지합니다.

## 릴레이된 호출과 긴 호출

어떤 호출은 하나의 Solana 트랜잭션에 맞지 않습니다. 이 섹션에서는 그럴 때 무엇이 일어나는지와 어떤 제한이 적용되는지 다룹니다.

### 원자적 컴포저가 거부할 때

`rome_composeUnsignedAtomicV1` 는 하나의 원자적 트랜잭션에 맞지 않는 호출을 거부합니다. `submitRomeTxV1` 그 다음 같은 **동일한** 승인 서명으로 프록시를 통해 호출을 릴레이하므로, 지갑에 다시 묻지 않습니다. 결과에는 `route: "relay"` 그리고 Solana `서명이 없으며`. `relayOnRefusal: false` 를 사용하면 거부를 오류로 받게 되며, 또는 `relayV1` 을 직접 호출해 의도적으로 릴레이할 수 있습니다.

릴레이된 호출에 대해 알아둘 세 가지:

* **합성이 가스를 지불합니다.** 릴레이 경로에서는 프록시가 Solana 트랜잭션을 제출하고 수수료를 지불하며, 호출 비용은 체인의 네이티브 가스 토큰으로 합성의 잔액에서 차감됩니다. 잔액은 최소 `gasLimit × maxFeePerGas`. `fundSyntheticGas(deps, amountWei)` 체인의 가스 토큰에 대한 지갑 자체 토큰 계정(Hadrian과 Rubicon에서는 USDC)에서 이를 보충합니다; 지갑은 평범한 v1 트랜잭션 하나에 서명하며, Solana 수수료를 위해 약간의 SOL이 필요합니다. `amountWei` 는 체인의 18소수 wei 단위이며 10^12의 배수여야 하고, 그렇지 않으면 프록시가 거부합니다. SDK 없이도, `rome_composeExternalDepositV1` 동일한 트랜잭션을 구성합니다.
* **revert는 예외를 발생시키지 않습니다.** EVM 측에서 revert되는 릴레이 호출은 정상적으로 해결되며, `receipt.status === "0x0"`. `receipt?.status === "0x1"` 를 호출 완료로 간주하기 전에 확인하세요. `receipt` 가 `null` 가 제때 나타나지 않으면.
* **`relayOnRefusal: false` 는 잠금이 아니라 SDK에서 내리는 선택입니다.** 프록시는 이미 해당 페이로드에 대한 승인 서명을 보유하고 있으며, 다음까지 어느 경로로든 실행할 수 있습니다: `gasLimit × maxFeePerGas`.

```javascript
const res = await submitRomeTxV1(deps, { to, data, value });
if (res.route === "relay" && res.receipt?.status !== "0x1") {
  // revert된 릴레이 호출은 정상적으로 해결되며, 예외를 던지지 않습니다
}
```

### 긴 호출

하나 이상의 트랜잭션이 필요한 호출은 반복 세션으로 실행됩니다: 프로그램은 각 Solana 트랜잭션에 들어가는 만큼의 EVM 단계를 실행하고 그 사이에 상태를 저장합니다. Solana 지갑에서 이를 구동하는 두 가지 방법:

* **릴레이합니다.** `rome_relayUnsignedV1` 는 지갑 서명 한 번만 받고, 프록시의 payer가 모든 단계를 보냅니다. 합성이 앞서 설명한 대로 가스를 지불합니다.
* **각 단계를 직접 서명합니다.** `rome_composeUnsignedIterativeV1` 는 각 단계를 빈 서명 슬롯과 함께 반환하고, 지갑이 각각에 서명하며, `rome_submitSignedV1Plan` 이를 순서대로 브로드캐스트합니다. 각 단계는 지갑이 서명해야 하는 별도의 Solana 트랜잭션이므로, 한 번에 한 트랜잭션씩 서명하는 지갑은 승인 서명 외에도 각 단계마다 한 번씩 프롬프트를 받습니다. 지갑은 매 단계마다 Solana 수수료를 지불합니다.

제한 사항:

| 한도                                      | 값            | 출처                                                                                 |
| --------------------------------------- | ------------ | ---------------------------------------------------------------------------------- |
| 한 번의 트랜잭션당 `rome_submitSignedV1Plan` 호출 | 64           | 프록시는 더 긴 계획을 거부합니다                                                                 |
| 반복 컴포저가 계획할 단계 수                        | 128          | Rust Rome SDK의 반복 컴포저에 있는 상한으로, 계획의 범위도 제한합니다 `rome_composeUnsignedIterativeV1` 반환 |
| 한 세션의 반복 횟수                             | 160          | Rome EVM 프로그램; 이를 넘으면 세션은 재개를 멈추고, 계정 잠금을 해제하고 종료됩니다                               |
| Solana 트랜잭션 크기 및 계정                     | 4 KB, 주소 64개 | 모든 단계는 Solana v1 트랜잭션입니다                                                           |

대부분의 실제 호출은 이 상한보다 훨씬 적은 단계로 완료됩니다. 지갑 서명 계획에서 64트랜잭션 제한이 가장 먼저 맞닥뜨리는 한계입니다. 그보다 더 많은 단계가 필요한 호출은 다음을 통해 브로드캐스트할 수 없습니다: `rome_submitSignedV1Plan`.

긴 호출은 legacy-track CPI를 수행할 수 없습니다. legacy precompile(`0xff…08`, `0xff…09` 그리고 `0x42…16`)에서의 상태 변경 호출은 반복 세션에서 다음과 함께 거부됩니다: `CpiProhibitedInIterativeTx`. Solana 상태 읽기와 cached-track precompile(`0xff…04`, `0xff…05`, `0xff…06`, `0xff…0b`)는 작동합니다. legacy-track CPI를 수행하는 호출은 어느 경로로 보내든 하나의 원자적 트랜잭션에 맞아야 합니다. 다음을 보세요: [제약 사항](https://docs.rome.builders/ko/core-concepts/constraints.md) 그리고 [컴퓨트 예산](https://docs.rome.builders/ko/core-concepts/compute-budget.md).

## 참조 구현

* **Aerarium** — Solana 지갑에서 다음을 통해 Compound v3(공급 / 차입)를 구동합니다: `DoTxUnsigned`. 이것은 위에서 설명한 이전 legacy-transaction 경로의 참조이며, 다음의 참조는 아닙니다: `submitRomeTxV1`.
* **Rome DEX** 는 이 페이지의 예시가 아닙니다: Solana 측은 지갑이 직접 서명하는 네이티브 Solana 프로그램이며, EVM 측은 같은 풀을 공유합니다.

Aerarium은 두 번째 지갑이 필요 없습니다 — 합성 주소가 하나의 Solana 키를 1급 EVM 계정으로 만듭니다. v1 패턴은 다음을 따르세요: [듀얼 레인 앱 빌드](https://docs.rome.builders/ko/developer-guides/dual-lane-app.md).

## 다음은 무엇인가

* [EVM에서 Solana 호출](https://docs.rome.builders/ko/developer-guides/call-solana-from-evm.md) — 반대 방향, CPI를 통해
* [토큰 상호운용성](https://docs.rome.builders/ko/core-concepts/token-interop.md) — EVM과 Solana 간에 잔액이 어떻게 공유되는지


---

# 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/developer-guides/call-evm-from-solana.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.
