> 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/08-open-your-solana-program-to-evm-users.md).

# 8. Solana 프로그램을 EVM 사용자에게 열어보세요

MetaMask 사용자가 이미 Solana에서 실행 중인 프로그램을 얇은 Solidity 컨트랙트와 CPI 프리컴파일을 통해 호출하게 하세요. 포팅 없이 상태의 두 번째 복사본도 필요 없습니다.

당신에게는 제대로 작동하는 Solana 프로그램이 있다. 그 사용자는 Solana 지갑을 보유하고 있다. Rome은 두 번째 사용자층도 이 프로그램에 접근할 수 있게 해준다. MetaMask 같은 EVM 지갑을 가진 사람들도, 프로그램을 Solidity로 다시 작성하지 않고 접근할 수 있다.

## 배울 내용

* 왜 Solana 프로그램을 EVM 사용자에게 열어야 하는지, 그리고 무엇을 그대로 유지하는지.
* EVM 호출이 당신의 프로그램에 도달하는 방식: 얇은 Solidity 컨트랙트와 CPI 프리컴파일.
* 당신의 프로그램이 서명자와 계정으로 보는 것.
* EVM 사용자의 토큰이 당신의 프로그램에 도달하고 다시 돌아오는 방식.
* 설계 시 고려해야 할 한계: 하나의 트랙, 하나의 원자적 트랜잭션, 계정 한도.

## 사용 사례

이 강의는 다음의 사용 사례를 다룬다 [무엇을 만들 수 있는지](https://docs.rome.builders/ko/rome/02-what-you-can-build.md): 더 많은 사용자를 원하는 기존 Solana 애플리케이션이다. 대출 시장, AMM, 금고, 예측 시장 또는 프라이버시 프로그램 모두 해당된다.

EVM 사용자층은 크고 이미 지갑, 도구, 습관을 갖추고 있다. 프로그램을 Solidity로 포팅하면 두 개의 코드베이스를 유지해야 하고 상태도 분리된다. Rome에서는 하나의 프로그램과 하나의 상태만 유지한다. EVM 사용자는 작은 Solidity 컨트랙트를 통해 접근하고, Solana 사용자는 계속 네이티브로 호출한다. 둘은 같은 계정과 같은 유동성을 두고 거래한다. [핵심을 선택하세요](https://docs.rome.builders/ko/core-concepts/choose-your-core.md) 이 형태를 (b), 즉 얇은 CPI 라우터를 둔 네이티브 Solana 코어라고 부른다.

[rome-dex](https://github.com/rome-protocol/rome-dex) 기준 예시: 그 앞에 EVM 라우터가 있는 네이티브 Solana 풀.

## 시작하기 전에

* 마치기 [7. EVM 앱을 Solana 지갑에 개방하기](https://docs.rome.builders/ko/rome/07-open-to-solana-wallets.md), 반대쪽에서 본 같은 아이디어.
* 알아두기 [5. Solidity에서 Solana 호출하기](https://docs.rome.builders/ko/rome/05-call-solana-from-solidity.md) 그리고 [6. 양쪽의 토큰](https://docs.rome.builders/ko/rome/06-tokens-on-both-sides.md). 이 강의는 이를 한데 모은다.
* 당신의 프로그램을 Solana devnet에 배포해 두세요. Hadrian은 그곳에서 정산되므로, 프로그램이 해당 클러스터에 존재해야 합니다. 다음을 보세요 [Hadrian](https://docs.rome.builders/ko/networks/hadrian.md).

## 요약한 흐름

### 1단계: 프로그램 앞에 얇은 컨트랙트 하나를 둔다

이 컨트랙트는 어댑터다. 비즈니스 로직은 담지 않는다. 호출자를 확인하고, 당신의 인스트럭션을 구성한 뒤, CPI 프리컴파일을 호출한다 `invoke_signed`. 나머지는 모두 당신의 Solana 프로그램에 남는다. 호출 메커니즘은 다음에 있다 [EVM에서 Solana 호출](https://docs.rome.builders/ko/developer-guides/call-solana-from-evm.md#calling-custom-solana-programs), 그리고 인터페이스는 `contracts/interface.sol` 공개된 [rome-solidity](https://github.com/rome-protocol/rome-solidity) 저장소에서 다룹니다.

당신의 어댑터에는 사용자의 포지션을 보관하는 세 가지 방법이 있다. 이 가이드는 이를 다음에서 비교한다 [사용자 포지션을 보관하는 세 가지 방법](https://docs.rome.builders/pages/059b03f494e36e3c2923aca0e51d7e6fd10b3744#id-2.-three-ways-to-hold-a-users-position):

| 형태               | 무엇인지                                  | 적합한 경우                         |
| ---------------- | ------------------------------------- | ------------------------------ |
| 어댑터 컨트랙트         | 사용자의 토큰을 끌어와, 자기 자신으로서 당신의 프로그램을 호출한다 | 입금 기능이 있는 프로그램을 위한 재사용 가능한 전면부 |
| 사용자가 프리컴파일을 호출한다 | 사용자 자신의 권한이 서명하며, 컨트랙트는 없다            | 일회성 승인과 단순한 프로그램               |
| 수탁 없는 라우터        | 토큰을 보유하지 않고, 사용자의 위임을 사용해 지출한다        | 스왑 및 기타 일회성 작업                 |

금고나 대출 프로그램에는 어댑터를, 스왑에는 라우터를 선택하라.

### 2단계: 프로그램이 누구를 보는지 알아두기

모든 EVM 주소에는 Solana 신원이 있다. 즉, Rome 프로그램 아래에서 파생된 external-authority PDA이다. 컨트랙트가 프리컴파일을 호출하면 Rome은 그 컨트랙트의 권한으로 서명한다. 당신의 프로그램은 서명자로 표시된 32바이트 공개키를 본다. 20바이트 EVM 주소는 절대 보지 못하고, 사용자도 절대 보지 못한다.

따라서 사용자가 서명자는 아니다. 사용자를 구분하려면 어댑터가 인스트럭션 데이터에 사용자별 값을 전달하거나, Rome에 사용자의 주소에서 파생된 솔트가 들어간 sub-PDA로도 서명해 달라고 요청한다. 그러면 당신의 프로그램은 sub-PDA마다 하나의 포지션을 유지한다. 서명자 규칙은 다음에 있다 [모든 EVM 주소에는 하나의 Solana 신원이 있다](https://docs.rome.builders/pages/059b03f494e36e3c2923aca0e51d7e6fd10b3744#id-1.-every-evm-address-has-one-solana-identity).

어떤 권한이 서명하든 그에 따라 동작하도록 프로그램을 작성하라. 그러면 Solana 지갑과 어댑터 모두를 동일하게 지원할 수 있다.

### 3단계: 사용자의 토큰을 이동시키기

Rome에서는 사용자의 USDC가, 6강에서 보았듯이, 양쪽에서 본 하나의 SPL 토큰이다. 사용자의 잔액은 그 권한이 소유한 토큰 계정에 있다. 어댑터가 이를 쓰게 하려면, 사용자는 입금 전에 어댑터에 SPL 위임을 부여한다. 어댑터는 토큰을 자신이 소유한 토큰 계정으로 끌어온 뒤, 당신의 프로그램을 호출한다. 반대로 나갈 때는 당신의 프로그램이 사용자의 토큰 계정으로 직접 지불하고, 사용자는 그것을 즉시 ERC-20 잔액으로 본다.

여기서 중요한 함정이 두 가지 있다:

* ERC-20은 `transferFrom` 컨트랙트로 보내면 래퍼의 에스크로 원장에만 적립된다. 컨트랙트는 지출에 사용할 토큰 계정을 받지 못한다. 래퍼가 아니라 위임을 사용하라.
* 토큰 계정에는 하나의 대리인만 있을 수 있다. 당신의 승인은 래퍼의 승인을 대체하고, 사용자가 다시 래퍼에 승인할 때까지 일반적인 토큰 전송은 중단된다. 다음을 확인하라 `isEnabled` 당신의 흐름 후에.

전체 순서는 다음에 있다 [토큰 유입, 토큰 유출](https://docs.rome.builders/pages/059b03f494e36e3c2923aca0e51d7e6fd10b3744#id-3.-tokens-in-tokens-out).

### 4단계: 한계 안에 머물기

* **하나의 트랙.** 커스텀 프로그램 호출은 legacy-track CPI이다. 트랜잭션은 이를 cached-track 호출과 섞을 수 없으므로, 그 트랜잭션에서 cached 래퍼를 제외하라.
* **원자적으로만.** legacy-track CPI는 반복적 트랜잭션에서 실행될 수 없다. 전체 호출은 하나의 Solana 트랜잭션에 들어가야 하며, 약 140만 compute unit, 64개 주소, 4KB 안에 맞아야 한다. 당신의 프로그램은 그 compute 예산을 Rome 프로그램과 공유한다.
* **계정은 미리 준비.** Rome은 호출을 에뮬레이션하고, 건드리는 모든 계정을 Solana 트랜잭션에 넣는다. 각 계정은 어댑터가 가진 입력으로부터 도출 가능해야 한다. 새 계정도 여전히 명시되어야 한다.
* **얕은 깊이.** 당신의 프로그램은 Rome보다 한 단계 아래에서 실행된다. 당신이 호출하는 모든 프로그램은 또 다른 단계를 사용한다.
* **렌트는 사용자의 몫이다.** 당신의 인스트럭션이 생성하는 계정 비용은 사용자의 가스로 지불된다.

각 작업은 하나의 토큰 이동과 당신의 프로그램으로의 하나의 CPI로 제한하라. 그보다 큰 작업은 두 개의 사용자 트랜잭션으로 나누라. 한 표에 정리된 한계는 다음에 있다 [제약 사항](https://docs.rome.builders/ko/core-concepts/constraints.md).

## 작동 예시

당신의 프로그램이 금고라고 하자. Solana 사용자는 USDC를 입금하고 나중에 인출한다. 당신은 MetaMask 사용자도 똑같이 하기를 원한다.

1. 당신은 프로그램 ID와 USDC 민트 주소를 아는 어댑터를 배포한다. 생성자에서는 자체 Solana 신원을 만들고 그에 대한 토큰 계정도 만든다.
2. MetaMask 사용자는 자신의 USDC에 대해 어댑터에 SPL 위임을 부여하는 트랜잭션 하나를 보낸다.
3. 사용자는 다음을 호출한다 `예치`. 어댑터는 USDC를 자신의 토큰 계정으로 끌어온 뒤, 자기 자신의 권한과 해당 사용자를 위한 솔트가 들어간 sub-PDA를 서명자로 하여 당신의 프로그램을 호출한다.
4. 당신의 프로그램은 USDC를 자신의 금고로 옮기고, 그 포지션을 sub-PDA 아래에 기록한다.
5. 어댑터의 승인이 래퍼의 승인을 대체했으므로, 당신의 앱은 다음을 읽는다 `isEnabled` 사용자에 대한 래퍼에서. 그러고 나서 반환한다 `false`, 그리고 사용자는 다음을 보낸다 `approve_spl` 래퍼에 대해 다시. 다음 입금에는 어댑터에 대한 새 승인이 필요하다.
6. 사용자는 다음을 호출한다 `withdraw`. 어댑터는 당신의 프로그램이 금고에서 바로 사용자의 토큰 계정으로 지급하도록 한다. 잔액은 MetaMask에 ERC-20 토큰으로 표시된다.

Solana 사용자는 어댑터를 전혀 거치지 않는다. 그들은 금고를 직접 호출하고 같은 총액을 본다. 대응하는 Solidity 스케치는 다음에 있다 [Solidity로 작성한 입금과 인출](https://docs.rome.builders/pages/059b03f494e36e3c2923aca0e51d7e6fd10b3744#id-7.-a-deposit-and-a-withdraw-in-solidity).

먼저 Hadrian에서 테스트하라. `eth_call` 그리고 `eth_estimateGas` 프록시가 전송에 사용하는 것과 같은 에뮬레이션을 실행하므로, 그곳에서 실패한 CPI는 같은 이유로 온체인에서도 실패하며, revert에는 당신의 프로그램 오류가 담긴다. 전송 후에는 다음으로 트랜잭션의 Solana 측을 읽어라 `rome_solanaTxForEvmTx`. 다음을 보세요 [테스트](https://docs.rome.builders/pages/059b03f494e36e3c2923aca0e51d7e6fd10b3744#id-8.-testing).

## 자신을 점검해 보세요

자신의 작은 프로그램이나 rome-dex의 프로그램을 가져와, 코드 없이 다음을 적어라:

1. 어댑터가 호출할 때 당신의 프로그램이 보는 서명자.
2. 하나의 입금이 지정하는 계정들.
3. 그 입금에서의 토큰 이동과 CPI의 수.

그런 다음 Hadrian에 어댑터를 배포하고, 사용자의 토큰 계정에 자금을 넣고, SPL 승인을 어댑터에 보내고, 다음을 통해 입금을 실행하라 `eth_estimateGas` 사용자의 주소를 다음으로 하여 `에서`. 예상 실행은 성공해야 한다. 실패하면 revert 데이터가 Solana 오류를 알려준다.

<details>

<summary>1. MetaMask 사용자가 당신의 어댑터를 통해 입금한다. 누가 당신의 프로그램에 서명하는가?</summary>

어댑터의 external-authority PDA와, 어댑터가 나열한 어떤 솔트가 들어간 sub-PDA든지이다. 사용자가 아니다. 사용자의 권한은 그들이 부여한 SPL 위임에서 온다.

</details>

<details>

<summary>2. 왜 래퍼의 것으로 사용자의 USDC를 끌어오지 않는가? <code>transferFrom</code>?</summary>

토큰은 래퍼의 에스크로 계정에 들어가고 그 원장에 기록될 것이다. 어댑터는 당신의 프로그램에 넘길 자기 자신의 토큰 계정을 갖지 못한다.

</details>

<details>

<summary>3. 당신의 입금이 커져서 CPI를 열 번 만들고 Rome이 이를 반복적으로 실행하면 어떻게 되는가?</summary>

실패한다. legacy-track CPI는 반복적 트랜잭션에서 거부된다. 작업을 하나의 토큰 이동과 하나의 CPI로 줄이거나, 두 개의 트랜잭션으로 나누어라.

</details>

## 다음

[9. 이중 레인 앱 만들기](https://docs.rome.builders/ko/rome/09-build-a-dual-lane-app.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/08-open-your-solana-program-to-evm-users.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.
