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

# 6. 両側のトークン

1つの SPL トークンが、EVM ウォレットでは ERC-20 ラッパーとして、Solana ウォレットではトークンアカウントとしてどのように表示されるか、そしてコントラクトがそれを動かせるようにする一度きりの許可について。

トークンは、次のあらゆるユースケースの基盤です。 [2. 構築できるもの](https://docs.rome.builders/ja/rome-academy/02-what-you-can-build.md)。プール、Vault、レンディング市場はいずれも、Solanaウォレットが保有するものと同じ資産を動かします。SPLラッパーは、SPLミントをERC-20インターフェース経由で公開します。ウォレットが保有するトークンの場合、ラッパーはウォレットのRome由来トークンアカウントの残高を読み取るため、SolanaとSolidityの両方で同じ残高が確認できます。このレッスンでは、その仕組みと、コントラクトがユーザーのトークンを移動できるようにするために、すべてのユーザーが事前に一度だけ付与する必要がある権限について説明します。

## 学習内容

* SPLラッパーがERC-20メソッドを通じてウォレットのSolanaトークン残高を公開する仕組み。
* ファクトリーとラッパーの役割、および使用するラッパー。
* コントラクトが保有するトークンと、ウォレットが保有するトークンの違い。
* 一度だけ行う `approve_spl` 権限付与、その確認方法、および機能しなくなる原因。

## 始める前に

* 完了 [5. SolidityからSolanaを呼び出す](https://docs.rome.builders/ja/rome-academy/05-call-solana-from-solidity.md)。外部権限PDAとHelperプリコンパイルの概念を理解しておく必要があります。
* 資金を入金したHadrianウォレットと、デプロイ済みコントラクトを用意してください。標準ラッパーのアドレスは、チェーンの `tokens.json` レジストリ内にあります。次のエントリを探してください。 `kind: "spl_wrapper"` で、シンボルが `wUSDC`. [Hadrian](https://docs.rome.builders/ja/nettowku/hadrian.md) には、チェーンのレジストリフォルダーへのリンクがあります。
* レッスン5で `createMyAta` を使って作成したUSDCトークンアカウント。権限を付与するには、このアカウントが存在している必要があります。

## 1つの残高、2つの見方

すべてのEVMアドレスにはSolana上の外部権限PDAがあり、そのPDAがアドレスのトークンアカウントを所有します。ERC-20ラッパーの `balanceOf` は、ウォレットのトークンアカウントを直接読み取ります。 `totalSupply` はミントを読み取ります。

Romeでは、ウォレットのSPLトークンとそのERC-20ラッパーは、同じトークンアカウントを読み取ります。USDCを保有するSolanaウォレットとUSDCを保有するEVMアドレスは、どちらも同じミントを保有し、同じプールアカウントを使って取引します。これにより、Rome上の流動性が一か所に保たれます。図と詳細については、 [トークン相互運用](https://docs.rome.builders/ja/ji-ben-gai-nian/token-interop.md#the-shared-state-model).

## ウォレットとコントラクトでは、トークンの保有方法が異なる

残高が共有されるのはウォレットの場合です。コントラクトは異なります。コントラクトは、以下で説明する一度限りの権限付与をユーザーに代わって行えないため、通常のラッパーでは、コントラクトのトークンをエスクロー用トークンアカウントに保管し、各コントラクトの所有量を台帳で管理します。フック付きのToken-2022ラッパーは台帳を使わず、コントラクト自身のトークンアカウントを使用します。

ここから、次の2点が導かれます。

* 同じミントを扱う2つのラッパーは、ウォレットの残高を同じ値で表示します。一方、コントラクトの残高については、それぞれ独自の台帳を管理するため、表示が異なる場合があります。
* プール、Vault、レンディング市場では、各チェーン上の各ミントについて、レジストリで指定された標準ラッパーを使用してください。名前だけで選ばないでください。

ラッパー経由でコントラクトに送金すると、その台帳に計上されます。コントラクトが支出に使えるトークンアカウントが付与されるわけではありません。コントラクトがSolana上で処理を行う必要があるフローでは、 [Solanaプログラムを統合する](https://docs.rome.builders/pages/255da214a3fd6e485f7d0fc2c312ae2293d5dd29#id-3.-tokens-in-tokens-out).

## ファクトリーとラッパー

`ERC20SPLFactory` は、SPLミント用のラッパーをデプロイします。各ファクトリーで、1つのミントにつき1つのラッパーを作成できます。ラッパーは、完全なERC-20インターフェースを提供します。

* `balanceOf` と `totalSupply` はSolanaの状態を読み取ります。
* `transfer` と `transferFrom` はSolana上のトークンを移動します。
* `approve` および `allowance` 通常の ERC-20 allowance は EVM ストレージに保持します。トークンアカウントにはそのような仕組みがないためです。

ラッパーをデプロイすることはほとんどありません。USDC、ETH、SOL の標準ラッパーは、Rome とレジストリにすでに用意されています。新しい mint を追加するときだけ、ラッパーをデプロイします。2 つのファクトリー呼び出しは [ファクトリー](https://docs.rome.builders/ja/ji-ben-gai-nian/token-interop.md#the-factory)に記載されています。ファクトリーは Token-2022 の mint にも対応していますが、拡張機能によって連携方法が変わります。フック付きラッパーでは通常の `transfer` および `transferFrom`はリバートし、転送手数料付きの mint では送信した量より少ない量しか届かない場合があります。vault で使用する前に [Token-2022 の mint](https://docs.rome.builders/ja/ji-ben-gai-nian/token-interop.md#token-2022-mints) を確認してください。

数量は `uint64`に収まる必要があります。SPL の数量が uint64 であるため、ラッパーはそれを超える値を拒否します。ガストークンには独自の小数桁数があり、ネイティブのガス残高は 18 桁です。両者の変換は正確に行う必要があります。Hadrian と Rubicon のガストークンは USDC です。

## 一度だけ行う権限付与

ラッパーは、ユーザーのトークンアカウントの SPL delegate として、そのユーザーのトークンを移動します。ラッパーがトークンを移動するには、トークンアカウントで事前にその delegate を指定しておく必要があります。ユーザーはラッパーごとに一度、最大量を指定して次の呼び出しを行います。

`approve_spl(wrapper, type(uint64).max, mint)` を Helper プリコンパイルに対して実行します。

実際には、次の 4 点が重要です。

* **ユーザー自身が送信します。** この権限付与はユーザー自身のアカウントで署名し、Helper プリコンパイルに直接送信します。コントラクトがユーザーに代わって送信することはできません。フロントエンドに「有効化」ステップを設けてください。
* **すべてのユーザーに適用されます。** MetaMask ウォレットも Solana ウォレットの合成アドレスも、トークンを移動したいラッパーごとに権限付与が必要です。
* **事前に確認してください。** ラッパーの `isEnabled(user)` は、権限付与が済むと `true` を返します。転送前に、決めつけずにこの値を読み取ってください。
* **最大量を付与してください。** `isEnabled` は `true` のままですが、これは上限付きの権限付与に残量がある間だけです。上限付きの権限付与では残量が少なくなると通常の転送が失敗し、アプリは再度権限付与を求めるべきタイミングを把握できません。

渡す mint は `mint_id()` です。両方のウォレットタイプに対応するフロントエンドの実装例は、 [一度だけ行う操作：ラッパーに権限を付与する](https://docs.rome.builders/ja/gaido/dual-lane-app.md#one-time-grant-the-wrapper).

### 問題が起きる仕組み

トークンアカウントに設定できる delegate は 1 つだけです。ユーザーがブリッジやルーターに権限を付与すると、その権限がラッパーの権限に置き換わり、そのユーザーに対してラッパーが機能しなくなります。症状として、SPL エラー `0x4`（owner の不一致）でリバートします。ラッパーに権限を再度付与すれば解決します。そのため、登録時に一度だけ確認するのではなく、ラッパーに依存する処理を開始する前に `isEnabled` を確認してください。

ファクトリーの新バージョンでは新しいラッパーが作成されます。各ウォレットは同じ方法で新しいラッパーに権限を付与します。

## トークンの移動

ラッパーの残高はすでに SPL 残高であるため、Solana にトークンを移動する操作は SPL 転送です。

* EVM ウォレットから別の Solana ウォレットへ移動する場合： `transfer_spl` ウォレットから直接Helperプリコンパイルに送るか、 `RomeBridgeWithdraw.bridgeOutToSolana`を使います。こちらもブリッジコントラクトへの権限付与が必要です。どちらの場合も、受取人のトークンアカウントが存在している必要があります。
* トランザクションに署名したウォレットへ送る場合： `transfer_spl_to_signer`を使います。ユーザー自身のウォレットに届くのは、ウォレット署名のSolana経路を使った場合だけです。MetaMaskでは署名者がRomeのプロキシペイヤーになるため、他の2つを使ってください。
* ガストークンについては、 `withdraw_to_ata` と `deposit_from_ata` を使うと、ネイティブガスとトークンアカウント内のトークンを相互に変換できます。

Solgateは、メインネットとテストネットの両方で、SolanaアセットをAggLayer EVMチェーンに双方向で接続します。テストネットでは、SPLトークンの登録はパーミッションレスです。USDCにはCCTPを使用します。 [レッスン10](https://docs.rome.builders/ja/rome-academy/10-from-other-chains.md) ではインバウンドフローとブリッジに戻ります。メソッドの一覧は [入金と出金](https://docs.rome.builders/ja/ji-ben-gai-nian/token-interop.md#deposit-and-withdraw).

## 理解度を確認する

にあります。

1. Hadrianで、資金を入金したウォレットを使って、 `isEnabled` を読み取り、レジストリにあるcanonical wUSDCラッパーで自分のアドレスを確認します。
2. USDCのトークンアカウントが存在することを確認してください。レッスン5の `createMyAta` 呼び出しで作成されています。省略した場合は、 `withdraw_to_ata`を使って少量のガスをwUSDCにラップしてください。 [MetaMaskで同じアプリを使う](https://docs.rome.builders/ja/gaido/dual-lane-app.md#the-same-app-from-metamask).
3. isEnabled `が` false `の場合は、`Helperプリコンパイルに `approve_spl` 権限を付与するトランザクションを送信します。上記にリンクされたデュアルレーンガイドのコードを使ってください。
4. もう一度 `isEnabled` を読み取ります。今度は `true`.
5. になっているはずです。 [付与トランザクションを](https://docs.rome.builders/ja/romenoapuri/via.md)エクスプローラーで確認 `します。SPL Tokenの` ApproveChecked

<details>

<summary>命令を探してください。</summary>

1\. 1つのmintに対する2つのラッパーで、ウォレット残高が同じになるのはなぜですか？

</details>

<details>

<summary>どちらもSolana上のウォレットのトークンアカウントを読み取るためです。ラッパーはSPLトークンを表示するものであり、別個の台帳ではありません。ラッパーごとに追跡されるのは、コントラクトが保有する残高だけです。 <code>2. ユーザーがあなたのボールトに入金した後、独自の</code>を要求するルーターを使います。次の <code>approve_spl</code> がSPLエラー0x4でリバートするのはなぜですか？</summary>

トークンアカウントに設定できるデリゲートは1つだけです。ルーターへの権限付与によって、ラッパーへの権限付与が置き換えられました。ユーザーはラッパーに再度権限を付与する必要があり、アプリでは `isEnabled` 送金前に。

</details>

<details>

<summary>3. 新しい流動性プールにはどのプールラッパーを使用しますか？</summary>

そのチェーン上のそのミントに対してレジストリが指定する標準ラッパーです。コントラクトが保有する残高は、ラッパーによって異なります。

</details>

## 次へ

[7. EVMアプリをSolanaウォレットに接続する](https://docs.rome.builders/ja/rome-academy/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/ja/rome-academy/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.
