> 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/06-tokens-on-both-sides.md).

# 6. 양쪽의 토큰

하나의 SPL 토큰이 EVM 지갑에서는 ERC-20 래퍼로, Solana 지갑에서는 토큰 계정으로 보이는 방식과, 컨트랙트가 이를 이동할 수 있게 하는 1회성 승인에 대해 알아봅니다.

토큰은 다음의 모든 사용 사례의 기반입니다 [2. 구축할 수 있는 것](https://docs.rome.builders/ko/rome/02-what-you-can-build.md): 풀, 볼트, 대출 시장은 모두 Solana 지갑이 보유한 것과 동일한 자산을 이동합니다. SPL 래퍼는 SPL 민트를 ERC-20 인터페이스로 제공합니다. 지갑이 보유한 토큰의 경우 래퍼는 지갑의 Rome 파생 토큰 계정에서 잔액을 읽으므로 Solana와 Solidity에서 동일한 잔액을 확인할 수 있습니다. 이 강의에서는 작동 방식과 컨트랙트가 사용자의 토큰을 이동하기 전에 모든 사용자가 한 번 부여해야 하는 권한을 설명합니다.

## 배울 내용

* SPL 래퍼가 ERC-20 메서드를 통해 지갑의 Solana 토큰 잔액을 제공하는 방법.
* 팩토리와 래퍼의 역할, 그리고 사용할 래퍼.
* 컨트랙트가 보유한 토큰과 지갑이 보유한 토큰의 차이.
* 일회성 `approve_spl` 권한 부여, 확인 방법 및 권한이 해제되는 경우.

## 시작하기 전에

* 완료 [5. Solidity에서 Solana 호출하기](https://docs.rome.builders/ko/rome/05-call-solana-from-solidity.md). 외부 권한 PDA와 Helper 프리컴파일의 개념을 알아야 합니다.
* 자금이 들어 있는 Hadrian 지갑과 배포된 컨트랙트가 있어야 합니다. 정식 래퍼 주소는 체인의 레지스트리에서 확인할 수 있습니다. `tokens.json` 에 있습니다. 레지스트리에서 `kind: "spl_wrapper"` 이고 심볼이 `wUSDC`. [인 항목을 찾으세요.](https://docs.rome.builders/ko/networks/hadrian.md) Hadrian에서 체인의 레지스트리 폴더로 연결되는 링크를 제공합니다.
* 강의 5에서 `createMyAta` 로 생성한 USDC 토큰 계정. 권한을 부여하려면 이 계정이 존재해야 합니다.

## 하나의 잔액, 두 가지 보기

모든 EVM 주소에는 Solana에 외부 권한 PDA가 있으며, 이 PDA가 해당 주소의 토큰 계정을 소유합니다. ERC-20 래퍼의 `balanceOf` 는 지갑의 토큰 계정을 직접 읽습니다. `totalSupply` 는 민트를 읽습니다.

Rome 내부에서는 지갑의 SPL 토큰과 ERC-20 래퍼가 동일한 토큰 계정을 읽습니다. USDC를 보유한 Solana 지갑과 USDC를 보유한 EVM 주소는 모두 같은 민트를 보유하며, 같은 풀 계정에서 거래됩니다. 이것이 Rome에서 유동성이 한곳에 유지되는 방식입니다. 그림과 자세한 내용은 [토큰 상호 운용성](https://docs.rome.builders/ko/core-concepts/token-interop.md#the-shared-state-model).

## 지갑과 컨트랙트는 서로 다른 방식으로 토큰을 보유합니다

공유 잔액은 지갑에 적용됩니다. 컨트랙트는 다릅니다. 컨트랙트는 아래에 설명된 일회성 권한을 사용자를 대신해 부여할 수 없으므로, 일반 래퍼는 컨트랙트의 토큰을 에스크로 토큰 계정에 보관하고 각 컨트랙트가 소유한 토큰을 장부에 기록합니다. Hooked Token-2022 래퍼는 장부를 사용하지 않고 컨트랙트 자체의 토큰 계정을 사용합니다.

다음 두 가지 사항을 알 수 있습니다.

* 같은 민트를 사용하는 두 래퍼는 지갑 잔액을 동일하게 표시합니다. 하지만 각 래퍼가 자체 장부를 유지하므로 컨트랙트 잔액은 서로 다를 수 있습니다.
* 풀, 볼트, 대출 시장에는 각 체인에서 각 민트에 대해 레지스트리에 지정된 정식 래퍼를 사용하세요. 이름만 보고 선택하지 마세요.

래퍼를 통한 컨트랙트로의 전송은 해당 장부에 잔액을 적립합니다. 그렇다고 컨트랙트가 사용할 수 있는 토큰 계정이 생기는 것은 아닙니다. 컨트랙트가 Solana에서 동작해야 하는 흐름에는 [Solana 프로그램 통합하기](https://docs.rome.builders/pages/059b03f494e36e3c2923aca0e51d7e6fd10b3744#id-3.-tokens-in-tokens-out).

## 팩토리와 래퍼

`ERC20SPLFactory` 는 SPL 민트용 래퍼를 배포합니다. 각 팩토리에서는 민트마다 래퍼 하나만 배포할 수 있습니다. 래퍼는 완전한 ERC-20 인터페이스를 제공합니다.

* `balanceOf` 와 `totalSupply` 는 Solana 상태를 읽습니다.
* `transfer` 와 `transferFrom` 는 Solana에서 토큰을 이동합니다.
* `approve` 및 `allowance` 토큰 계정에는 그런 개념이 없으므로 일반 ERC-20 allowance는 EVM 스토리지에 유지하세요.

래퍼를 배포하는 경우는 드뭅니다. Rome과 레지스트리에 USDC, ETH, SOL의 표준 래퍼가 이미 있습니다. 새 민트를 가져오는 경우에만 래퍼를 배포하면 됩니다. 두 팩토리 호출은 [팩토리](https://docs.rome.builders/ko/core-concepts/token-interop.md#the-factory)에 있습니다. 팩토리는 Token-2022 민트도 처리하지만, 확장 기능에 따라 통합 방식이 달라집니다. 훅이 적용된 래퍼에서는 일반적인 `transfer` 및 `transferFrom`호출이 되돌려지고, 전송 수수료가 있는 민트는 보낸 수량보다 적은 수량을 전달할 수 있습니다. 볼트에서 사용하기 전에 [Token-2022 민트](https://docs.rome.builders/ko/core-concepts/token-interop.md#token-2022-mints) 를 읽어보세요.

수량은 `uint64`에 들어맞아야 합니다. SPL 수량이 이 타입을 사용하며 래퍼는 이보다 큰 값을 거부하기 때문입니다. 가스 토큰은 별도의 소수 자릿수를 사용하고, 네이티브 가스 잔액은 18자리 소수 자릿수를 사용합니다. 둘 사이의 변환은 정확해야 합니다. Hadrian과 Rubicon의 가스 토큰은 USDC입니다.

## 일회성 승인

래퍼는 사용자의 토큰 계정에서 SPL 위임자로 동작해 사용자의 토큰을 옮깁니다. 래퍼가 토큰을 옮기려면 토큰 계정에 해당 위임자가 지정되어 있어야 합니다. 사용자는 최대 수량을 지정해 래퍼마다 한 번씩 호출하면 됩니다.

`approve_spl(wrapper, type(uint64).max, mint)` 를 Helper 프리컴파일에서 호출합니다.

실제로 중요한 세부 사항은 네 가지입니다.

* **사용자가 직접 보냅니다.** 승인은 사용자의 계정으로 서명해 Helper 프리컴파일에 직접 전송해야 합니다. 사용자를 대신해 컨트랙트에서 보낼 수는 없습니다. 프런트엔드에 "활성화" 단계를 추가하세요.
* **모든 사용자에게 적용됩니다.** MetaMask 지갑과 Solana 지갑의 합성 주소 모두 토큰을 옮기려는 각 래퍼에 대해 승인을 받아야 합니다.
* **먼저 확인하세요.** 래퍼의 `isEnabled(user)` 는 `true` 가 반환되면 승인이 완료된 것입니다. 이를 당연하다고 가정하지 말고 전송 전에 확인하세요.
* **최대 수량으로 승인하세요.** `isEnabled` 는 `true` 승인 한도의 일부라도 남아 있으면 계속 반환됩니다. 한도를 설정해 승인하면 한도가 얼마 남지 않았을 때 일반 전송이 실패하며, 앱은 사용자에게 다시 승인해 달라고 요청해야 하는 시점을 알 수 없습니다.

전달할 민트는 래퍼의 `mint_id()` 입니다. 두 지갑 유형을 모두 지원하는 프런트엔드 구현 예시는 [일회성 승인: 래퍼 승인하기](https://docs.rome.builders/ko/developer-guides/dual-lane-app.md#one-time-grant-the-wrapper).

### 문제가 발생하는 이유

토큰 계정에는 위임자가 하나만 있을 수 있습니다. 사용자가 브리지나 라우터를 승인하면 해당 승인이 래퍼에 대한 승인을 대체하고, 그 사용자의 래퍼는 작동을 멈춥니다. 이때 SPL 오류 `0x4`(소유자 불일치)와 함께 호출이 되돌려집니다. 다시 래퍼를 승인하면 해결됩니다. 따라서 가입 시 한 번만 확인하지 말고, 래퍼에 의존하는 작업을 시작하기 전에 `isEnabled` 를 확인하세요.

새 팩토리 버전이 나오면 새 래퍼가 생기며, 각 지갑은 같은 방식으로 새 래퍼를 승인해야 합니다.

## 토큰 옮기기

래퍼 잔액이 이미 SPL 잔액이므로 Solana로 토큰을 옮기는 작업은 SPL 전송입니다.

* EVM 지갑에서 다른 Solana 지갑으로 전송하려면: `transfer_spl` 지갑에서 Helper 프리컴파일로 직접 전송하거나, `RomeBridgeWithdraw.bridgeOutToSolana`, 이 메서드도 브리지 컨트랙트에 대한 권한 부여가 필요합니다. 두 방법 모두 수신자의 토큰 계정이 존재해야 합니다.
* 트랜잭션에 서명한 지갑으로 전송하려면: `transfer_spl_to_signer`. 이 방법으로 사용자의 지갑에 도달하는 것은 지갑 서명 Solana 경로에서뿐입니다. MetaMask를 사용하면 서명자는 Rome의 프록시 페이어이므로 나머지 두 방법을 사용하세요.
* 가스 토큰의 경우, `withdraw_to_ata` 와 `deposit_from_ata` 를 사용해 네이티브 가스와 토큰 계정의 토큰 간에 변환합니다.

Solgate는 메인넷과 테스트넷에서 양방향으로 Solana 자산을 AggLayer EVM 체인에 연결합니다. 테스트넷에서는 누구나 SPL 토큰을 등록할 수 있습니다. USDC는 CCTP를 사용합니다. [레슨 10](https://docs.rome.builders/ko/rome/10-from-other-chains.md) 에서는 인바운드 흐름과 브리지로 돌아갑니다. 메서드 목록은 [입금 및 출금](https://docs.rome.builders/ko/core-concepts/token-interop.md#deposit-and-withdraw).

## 직접 확인하기

Hadrian에서 앞서 자금을 충전한 지갑으로 다음을 수행합니다.

1. 레지스트리에서 정식 wUSDC 래퍼를 찾아 해당 주소의 `isEnabled` 값을 읽습니다.
2. USDC 토큰 계정이 있는지 확인합니다. `createMyAta` 호출로 레슨 5에서 이 계정을 만들었습니다. 건너뛰었다면 `withdraw_to_ata`를 사용해 가스를 조금 wUSDC로 래핑하세요. 방법은 [MetaMask에서 동일한 앱 사용](https://docs.rome.builders/ko/developer-guides/dual-lane-app.md#the-same-app-from-metamask).
3. 만약 `isEnabled` 값이 `false`라면 Helper 프리컴파일에 `approve_spl` 권한을 부여하는 트랜잭션을 전송합니다. 위에 링크된 듀얼 경로 가이드의 코드를 사용하세요.
4. 다시 `isEnabled` 값을 읽습니다. 이제 `true`.
5. 이어야 합니다. 권한 부여 트랜잭션은 [익스플로러에서 확인](https://docs.rome.builders/ko/rome-1/via.md)에서 찾으세요. SPL Token `ApproveChecked` 명령을 확인합니다.

<details>

<summary>1. 동일한 민트를 사용하는 두 래퍼에서 지갑 잔액이 같게 표시되는 이유는 무엇인가요?</summary>

두 래퍼 모두 Solana의 지갑 토큰 계정을 읽습니다. 래퍼는 SPL 토큰을 보여 주는 뷰이지 별도의 원장이 아닙니다. 컨트랙트가 보유한 잔액만 래퍼별로 추적됩니다.

</details>

<details>

<summary>2. 사용자가 볼트에 자산을 공급한 뒤 자체 <code>approve_spl</code>권한 부여를 요청하는 라우터를 사용합니다. 그러면 다음 <code>transferFrom</code> 호출이 SPL 오류 0x4와 함께 되돌려집니다. 이유는 무엇인가요?</summary>

토큰 계정에는 위임자가 하나만 있을 수 있습니다. 라우터에 권한을 부여하면 래퍼에 부여했던 권한이 대체됩니다. 사용자가 래퍼에 다시 권한을 부여해야 하며, 앱에서는 `isEnabled` 이체 전에.

</details>

<details>

<summary>3. 새 유동성 풀에는 어떤 풀 래퍼를 사용하나요?</summary>

해당 체인의 해당 민트에 대해 레지스트리가 지정한 표준 래퍼를 사용합니다. 래퍼마다 컨트랙트가 보유한 잔액이 다릅니다.

</details>

## 다음

[7. EVM 앱을 Solana 지갑에 연결하기](https://docs.rome.builders/ko/rome/07-open-to-solana-wallets.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/06-tokens-on-both-sides.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.
