> 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/rifarensu/precompiles.md).

# Precompileリファレンス

RomeのSolana相互運用precompileの各メソッド — アドレス、Solidityシグネチャ、セレクタ、そして読み取り・呼び出し・CPIの準備のどれを行うか。

Romeのオンチェーンプログラムが各precompileにディスパッチするセレクタ。セレクタ = `keccak256(signature)[:4]`; 以下の各行はそれに対して検証されています。Solidityインターフェースは次にあります [`rome-solidity/contracts/interface.sol`](https://github.com/rome-protocol/rome-solidity/blob/master/contracts/interface.sol).

**まず最初に Dispatch 列を読んでください。** これは、そのメソッドがSolana状態に対して何をするかを示します:

| ディスパッチ              | 何が起こるか                                                                                                                           | 実際のSolana CPI | 反復実行で許可                  |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------------ |
| `Invoke` / `合成`     | 1つ以上のCPI。seedが適用される場合は、呼び出し元の external-authority PDA として署名されます。 **レガシー** 系では即時に実行されます。 **cached** 系ではステージされ、トランザクション末尾でコミットされます。 | はい            | レガシー: **いいえ**. キャッシュ: はい |
| `EthCall`           | 純粋な計算、またはRome自身の状態の読み取り                                                                                                          | いいえ           | はい                       |
| `CrossStateEthCall` | シミュレーションで事前読み込みされた、別のSolanaアカウントのバイト列の読み取り。CPIなし、副作用なし。                                                                          | いいえ           | はい                       |
| `Precompiled`       | 決定論的暗号処理（Ethereum標準のprecompile）                                                                                                  | いいえ           | はい                       |

コントラクトは **1つの系**：レガシーprecompile（`0xff…07`, `0xff…08`, `0xff…09`, `0x42…16`）またはキャッシュ済みのもの（`0xff…04`, `0xff…05`, `0xff…06`, `0xff…0b`）を使用します。両方の変更系呼び出しを1つのトランザクションで混在させると実行時に拒否されます。読み取りは引き続き許可されますが、1つ例外があります。cached系のinvokeが一度発火すると、その後のそのトランザクション中のlegacy系読み取りは拒否されます。参照 [Solana プログラムを統合する](https://docs.rome.builders/ja/gaido/integrate-solana-program.md).

**誰が支払うか。** Solanaの手数料支払者が、legacy系CPIが消費するあらゆるlamport（rent、送金、 `swap_gas_to_lamports`）を前払いします。プログラムは各CPIの前後で支払者残高を測定し、純支出をガス価格でユーザーにガス代として請求し、CPIが返却したlamportは払い戻します。

**誰が署名するか。** precompileを呼び出すコントラクトは自分自身として振る舞います。署名者はコントラクトの external-authority PDA（`["EXTERNAL_AUTHORITY", contract]`）です。ユーザー自身のPDAが署名するのは、ユーザーがprecompileアドレスへ直接送るトランザクションだけです。 `DELEGATECALL` / `CALLCODE`では、変更系セレクタは以下を除き拒否されます `create_ata*`, `create_pda*`, `swap_gas_to_lamports`, `init_spl_mint` および `create_and_init_mint` on HelperProgram, `create_ata*` on ASplCached, and `invoke` / `invoke_signed` on CpiProgram. 何も署名しないからではなく、次の理由で免除されます: `create_and_init_mint` 依然として外側の呼び出し元のPDAでmintのrentを支払って署名し、権限がそのPDAであるmintだけを作成でき、 `invoke` / `invoke_signed` bare authority（`DelegatecallOwnerAuthority`）を拒否し、salt付きPDAの名前空間を実行中コントラクトのアドレスで分けます。

すべてのメソッドは non-payable（`msg.value > 0` でリバートします `TransferProhibited`）を除き `withdrawal(bytes32)`。とマークされたメソッドは *単一状態のみ* は op-geth-stack チェーンでは拒否されます。CPIはSolanaの手数料支払者（通常のSystem transfer instructionの内部を除く）またはRomeプログラムを指定できず、Romeプログラムを呼び出すこともできません。

## SystemCached (`0xff00000000000000000000000000000000000004`)

PDA作成 + system-program操作（allocate、assign、lamport transfer）をオーバーレイへステージします。legacy のキャッシュ版 `System @ 0xff..07`の変更系セレクタ（legacy System は純粋な読み取りセレクタを保持します）。

| Solidity signature                   | セレクタ         | ディスパッチ   | 説明                                      |
| ------------------------------------ | ------------ | -------- | --------------------------------------- |
| `create_pda()`                       | `0xe0402a8d` | `Invoke` | 呼び出し元の `external_auth` PDA、rent免除、データなし |
| `create_pda(uint64)`                 | `0x4ceab657` | `Invoke` | 同じです。ただし、rentを超えるlamportsを資金提供者が指定します   |
| `create_pda(uint64,bytes32)`         | `0x48e2bb86` | `Invoke` | lamports付きのsalt由来PDA                    |
| `create_pda(bytes32,uint64,bytes32)` | `0xcc258bbf` | `Invoke` | 所有者指定、サイズN、salt由来                       |
| `allocate(uint64,bytes32)`           | `0x93225c9f` | `Invoke` | salt由来PDA上にNバイトを割り当て                    |
| `assign(bytes32,bytes32)`            | `0x8ac00bdc` | `Invoke` | salt由来PDAを新しい所有者に割り当てる                  |
| `transfer(address,uint64)`           | `0x5d359fbd` | `Invoke` | EVMアドレス由来PDAへのlamport送金                 |
| `transfer(bytes32,uint64)`           | `0xfd54d1ea` | `Invoke` | 生のSolana pubkeyへのlamport送金              |
| `transfer(bytes32,uint64,bytes32)`   | `0x875abfc0` | `Invoke` | 生のpubkeyへのlamport送金、送信元はsalt由来          |

## SplCached (`0xff00000000000000000000000000000000000005`)

SPL Token / Token-2022 の転送 + ATA初期化 + クロス状態のアカウント読み取りを、オーバーレイへステージします。

| Solidity signature                              | セレクタ         | ディスパッチ              | 説明                                                                                                                                                                                                                                |
| ----------------------------------------------- | ------------ | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `transfer(address,uint256)`                     | `0xa9059cbb` | `Invoke`            | 呼び出し元が所有者としてのSPL転送。EVMアドレス由来PDAのATA、現在のrollup mint                                                                                                                                                                                |
| `transfer(bytes32,uint256)`                     | `0x6a467394` | `Invoke`            | 同じですが、受取人は生のSolana pubkeyです                                                                                                                                                                                                       |
| `transfer(address,uint256,bytes32)`             | `0x57cfeeee` | `Invoke`            | 明示的mint版、EVMアドレス宛て                                                                                                                                                                                                                |
| `transfer(bytes32,uint256,bytes32)`             | `0x7db527f9` | `Invoke`            | 明示的mint版、生のpubkey宛て                                                                                                                                                                                                               |
| `transferFrom(address,address,uint256,bytes32)` | `0x401e3367` | `Invoke`            | デリゲート元バリアント — authority = `external_auth(caller)`、ATA所有者、または十分な残高を持つデリゲートとして受け入れられます。使用先 `SPL_ERC20_cached.transferFrom` およびルーター駆動フロー                                                                                             |
| `approve(address,uint256,bytes32)`              | `0x8180f2fc` | `Invoke`            | EVM-spender approve — owner = `external_auth(caller)`、delegate = `external_auth(spender_addr)`。使用先 `SPL_ERC20_cached.approve`                                                                                                     |
| `mint(address,uint256,bytes32)`                 | `0x1e458bee` | `Invoke`            | 呼び出し元PDAがmint authorityとして署名します。SPLランタイムは caller-PDA == オンチェーンmint authority を強制します。使用先 `SPL_ERC20_cached.mint_to` および inbound bridge の決済                                                                                         |
| `init(bytes32,bytes32,bytes32)`                 | `0x0b0ad508` | `Invoke`            | `InitializeAccount3` ix (ata, mint, owner)                                                                                                                                                                                        |
| `account(address)`                              | `0x73b9aa91` | `CrossStateEthCall` | EVMアドレスのPDA由来ATA（現在のrollup mint）のSPLアカウント状態を読み取ります                                                                                                                                                                                |
| `account(bytes32)`                              | `0x882358ae` | `CrossStateEthCall` | 生のATA pubkeyのSPLアカウント状態を読み取ります                                                                                                                                                                                                    |
| `account(address,bytes32)`                      | `0xf9827227` | `CrossStateEthCall` | と同じです `account(address)` ただし、明示的なmintを指定します。                                                                                                                                                                                      |
| `mint_info(bytes32)`                            | `0xe24bf5d4` | `CrossStateEthCall` | mintの情報。オーバーレイ対応: token program、decimals、 **有効化された** hook program（存在しない場合は0 *または* でinert）、現行エポックの手数料bps、および拡張の有無ビットマップ。 `HelperProgram.mint_info` — 1つの機能、2つのディスパッチ先。cached系コントラクトは、cached invoke が一度発火すると legacy の読み取りを使えないためです。 |

## ASplCached (`0xff00000000000000000000000000000000000006`)

Associated Token Account の作成。冪等。

| Solidity signature            | セレクタ         | ディスパッチ   | 説明                                 |
| ----------------------------- | ------------ | -------- | ---------------------------------- |
| `create_ata()`                | `0xb6d336ed` | `Invoke` | 呼び出し元PDA × 現在のrollup mint の冪等ATA作成 |
| `create_ata(bytes32)`         | `0x81972e35` | `Invoke` | 呼び出し元PDA × 明示的mint の冪等ATA作成        |
| `create_ata(address)`         | `0x5a7c3259` | `Invoke` | EVMアドレス由来PDA × 現在のmint の冪等ATA作成    |
| `create_ata(address,bytes32)` | `0x3de2251a` | `Invoke` | EVMアドレス × 明示的mint の冪等ATA作成         |

## WithdrawCached (`0xff0000000000000000000000000000000000000b`)

ガストークンのwithdrawルート（ネイティブgas → SPLラッパー、ネイティブgas → SOL、ネイティブgas → 呼び出し元PDA）をステージします。legacy のキャッシュ版 `Withdraw @ 0x42..16`.

| Solidity signature            | セレクタ         | ディスパッチ | 説明                                                                                                                                                                                                                                                                                     |
| ----------------------------- | ------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `withdrawal(bytes32) payable` | `0x4d8b0ea4` | `合成`   | バーン `msg.value` Rome gas をバーンし、Solanaの system-account 受取人へ送金                                                                                                                                                                                                                           |
| `withdraw_to_pda(uint256)`    | `0x7f3124a0` | `合成`   | wei をバーンし、lamportsを呼び出し元の `EXTERNAL_AUTHORITY` PDA に入金します。単一状態のみ。                                                                                                                                                                                                                      |
| `withdraw_to_ata(uint256)`    | `0x8059abc0` | `合成`   | wei をバーンし、SPLラッパーを呼び出し元PDA所有のATAに入金します。単一状態のみ。gas-wrapper bridge の wrap 側です。                                                                                                                                                                                                           |
| `deposit(uint256)`            | `0xb6b55f25` | `合成`   | withdrawal `の逆` — Solana側では呼び出し元PDA所有ATAからチェーンの sol\_wallet ATA へのSPL転送； **mint** `wei` EVM側では呼び出し元にネイティブgasとして付与します。純粋なmint（ `Withdraw::ADDRESS` — チェーンのSPLウォレットが経済的な裏付けであり、precompileアドレスではありません）。単一状態のみ。gas-wrapper bridge の unwrap 側。 `HelperProgram.deposit_from_ata` の意味論と一致します。 |

## System (`0xff00000000000000000000000000000000000007`)

PDA導出 + base58変換 + identity系ユーティリティ。純粋な読み取り用precompile — すべてのメソッドは `EthCall` （Solana側副作用なし）です。

| Solidity signature                                | セレクタ         | ディスパッチ    | 説明                                                               |
| ------------------------------------------------- | ------------ | --------- | ---------------------------------------------------------------- |
| `find_program_address(bytes32,(bytes)[])`         | `0x27e3edda` | `EthCall` | Solana `find_program_address` syscall 経由の `(pda, bump)`          |
| `create_program_address(bytes32,(bytes)[],uint8)` | `0xb99f29e1` | `EthCall` | 既知の bump を用いた定数時間PDA導出                                           |
| `rome_evm_program_id()`                           | `0xb76fd45b` | `EthCall` | このRome EVMプログラムの Solana program ID を返します                         |
| `program_id()`                                    | `0x77764881` | `EthCall` | Romeの System Program ID（このprecompileの識別子）を返します                   |
| `mint_id()`                                       | `0xe132a122` | `EthCall` | チェーンの gas-token SPL mint pubkey を返します（`OwnerInfo.chain_mint_id`) |
| `operator()`                                      | `0x570ca735` | `EthCall` | 外側のRomeトランザクションの Solana 署名者を返します                                 |
| `bytes32_to_base58(bytes32)`                      | `0xfa2b1a5f` | `EthCall` | Pubkeyバイト列 → base58文字列                                           |
| `base58_to_bytes32(bytes)`                        | `0x5df01b72` | `EthCall` | base58文字列 → pubkeyバイト列                                           |

## CpiProgram (`0xff00000000000000000000000000000000000008`)

**二用途のprecompile。** 以下の7つのセレクタのうち、 **2つは実際のSolana CPIを実行し** (`invoke`, `invoke_signed` — 次のようにディスパッチされます `Invoke`と **5つは純粋なクロス状態読み取りです** (`account_info`, `account_data_at`, `account_u64_at`, `account_lamports`, `pdas_batch_derive` — 次のようにディスパッチされます `CrossStateEthCall`、syscallなし、 `found_cpi` フラグが設定されます）。歴史的に「CPI shortcut selectors」という語は、以前のCPIベース読み取りをCU節約のために置き換える読み取りセレクタを指していました — それ自体は **CPIではありません**。完全な挙動一覧は、この節の冒頭にある曖昧さ回避表を参照してください。

| Solidity signature                                             | セレクタ         | ディスパッチ              | 説明                                                                                                                                                                 |
| -------------------------------------------------------------- | ------------ | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `invoke(bytes32,(bytes32,bool,bool)[],bytes)`                  | `0x7480cb86` | `Invoke`            | として署名されたCPI `EXTERNAL_AUTHORITY(caller)` そのアカウントが signer として列挙されている場合（DELEGATECALL 下では拒否されます）；salt付きサブPDAなし。呼び出し元は target program + account metas + ix data を渡します  |
| `invoke_signed(bytes32,(bytes32,bool,bool)[],bytes,bytes32[])` | `0xb94f3733` | `Invoke`            | として署名されたCPI `EXTERNAL_AUTHORITY(caller)` 直接CALLではそうなります；saltはPDAごとのseedに付加されます。DELEGATECALLではbareな呼び出し元権限は拒否され、salt付きseedには実行中コントラクトのアドレスが含まれます — 下の導出ノートを参照してください |
| `account_info(bytes32)`                                        | `0xc13465d9` | `CrossStateEthCall` | Solanaアカウントの完全な状態（lamports/owner/flags/data）を読み取ります                                                                                                                |
| `account_data_at(bytes32,uint16,uint16)`                       | `0x593762e8` | `CrossStateEthCall` | 任意のSolanaアカウントのデータバッファの一部を読み取ります                                                                                                                                   |
| `account_u64_at(bytes32,uint16)`                               | `0xb317d4c1` | `CrossStateEthCall` | 既知オフセットでの型付きu64 LE読み取り — ABI往復を節約します                                                                                                                               |
| `account_lamports(bytes32)`                                    | `0xde79ed54` | `CrossStateEthCall` | lamportsのみのプローブ — data取得を省略します                                                                                                                                     |
| `pdas_batch_derive(bytes[][],bytes32)`                         | `0x944336f8` | `CrossStateEthCall` | 1回のディスパッチで、1つのプログラムに対するN個の独立したPDA                                                                                                                                  |

## HelperProgram (`0xff00000000000000000000000000000000000009`)

Romeのユーザー向けヘルパー。ATA/PDA作成、呼び出し元PDAが署名するSPLの転送/approve/mint、gas↔lamports変換、ATA入金、およびSPL\_ERC20向け読み取り（ `EXTERNAL_AUTHORITY` PDA、gas↔lamports変換、ATA入金、およびSPL\_ERC20向け読み取り（`user_balance` / `allowance_of`）。すべてのメソッドは `not_payable`。変更は `Invoke` （単一CPI）を通じます。例外は `deposit_from_ata` (`合成`（単一状態のみ）、3つの読み取り専用 `pda`/`ata` クエリ（`EthCall`）、および2つのクロス状態SPL\_ERC20読み取り（`CrossStateEthCall` — Solanaアカウント取得1回）。

| Solidity signature                                               | セレクタ         | ディスパッチ              | 説明                                                                                                                                                                                                                                                                                                                                             |
| ---------------------------------------------------------------- | ------------ | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_ata(address)`                                            | `0x5a7c3259` | `Invoke`            | チェーンの gas mint の下で EVMユーザー用ATAを作成                                                                                                                                                                                                                                                                                                              |
| `create_ata(address,bytes32)`                                    | `0x3de2251a` | `Invoke`            | 任意のmintの下で EVMユーザー用ATAを作成                                                                                                                                                                                                                                                                                                                      |
| `create_ata_for_key(bytes32,bytes32)`                            | `0xd258a69d` | `Invoke`            | 任意の生のSolana pubkey を所有者とする冪等ATA作成（ `external_auth`）。rentはオペレータが支払います。使用先 `SPL_ERC20.bridgeOutToSolana` / `ensureRecipientAta` / `create_token_account` raw pubkey受取人フロー                                                                                                                                                                        |
| `create_pda(address)`                                            | `0xff3556ca` | `Invoke`            | ユーザーの作成 `EXTERNAL_AUTHORITY` PDA（レンタル免除）                                                                                                                                                                                                                                                                                                       |
| `create_pda(address,uint64)`                                     | `0x58e88298` | `Invoke`            | 同じだが、〜で資金供給された `lamports` レント下限を超える                                                                                                                                                                                                                                                                                                            |
| `swap_gas_to_lamports(uint64)`                                   | `0x6e3f24e0` | `Invoke`            | 呼び出し元のPDAに〜を付与 `n` トランザクションのSolana手数料支払者からのlamports。呼び出し元はそれらをRome gasで支払う（いかなるレガシーCPI内での支払者のlamport支出もトランザクション手数料に加算される）                                                                                                                                                                                                                      |
| `transfer_lamports(address,uint64)`                              | `0x5fe71665` | `Invoke`            | 呼び出し元のPDAから別のEVMユーザーのPDAへlamportsを移動                                                                                                                                                                                                                                                                                                           |
| `transfer_spl(address,uint64)`                                   | `0xb12be5ba` | `Invoke`            | 呼び出し元PDAのATAから宛先ユーザーのATAへchain-gas SPLを送信                                                                                                                                                                                                                                                                                                      |
| `transfer_spl(bytes32,uint64)`                                   | `0xba3a5eac` | `Invoke`            | 呼び出し元PDAのATAから明示的なATAへchain-gas SPLを送信                                                                                                                                                                                                                                                                                                         |
| `transfer_spl(address,uint64,bytes32)`                           | `0x53b505e0` | `Invoke`            | 呼び出し元PDAのATAから宛先ユーザーのATAへ任意mintのSPLを送信                                                                                                                                                                                                                                                                                                         |
| `transfer_spl(bytes32,uint64,bytes32)`                           | `0xb6977879` | `Invoke`            | 呼び出し元PDAのATAから明示的なATAへ任意mintのSPLを送信                                                                                                                                                                                                                                                                                                            |
| `transfer_spl(bytes32,bytes32,uint64,bytes32)`                   | `0x766b362a` | `Invoke`            | デリゲート版 — 呼び出し元が指定 `src_ata` （PDA所有であるか、PDAが十分な `委任量`)                                                                                                                                                                                                                                                                                          |
| `transfer_spl(address,address,uint64,bytes32)`                   | `0xe479df56` | `Invoke`            | アドレスキー付きデリゲート版 — 2つのATAを内部でEVMアドレスから導出する。〜として署名する `external_auth(caller)`; SPL TokenはPDAを所有者またはデリゲートとして受け入れる。〜で使用 `SPL_ERC20.transferFrom`                                                                                                                                                                                                     |
| `transfer_spl_to_signer(uint64,bytes32)`                         | `0x46efa679` | `Invoke`            | Solanaネイティブの出口処理。〜を送信 `量` の `mint` 呼び出し元PDAのATAから〜へ **外側のSolana署名者の** そのmint用のATA（ウォレット署名のSolana経路ではユーザー自身のウォレットのみ。MetaMaskから、またはリレー経由では、署名者はRomeの代理支払者になる。EVMアドレス変換はない）。承認は不要 — 呼び出し元PDAが送信元ATAを所有する。これと組み合わせるのは `ActivateAta` （スロット18）エンドツーエンドのSolanaキーのみのEVM利用向け。現在のv1経路と、旧来のレガシー `DoTxUnsigned` （スロット17）経路の両方でウォレットがSolanaトランザクションに署名するため。 |
| `approve_spl(address,uint64,bytes32)`                            | `0xabf6f675` | `Invoke`            | 所有者としてのCaller-PDAが設定する `delegate_pda(spender)` 所有者ATA上でSPL経由で `approve_checked`。使用先 `SPL_ERC20.approve`                                                                                                                                                                                                                                        |
| `approve_spl_raw_delegate(bytes32,bytes32,uint64,bytes32,uint8)` | `0x7881d453` | `Invoke`            | SPL `approve_checked` 呼び出し元指定の生の公開鍵デリゲートを使用（例: Wormhole `authority_signer` PDA、EVMアドレス相当なし）。呼び出し元が渡す `decimals` オンチェーンのmint読み取りを省略するため（約30〜50K CU節約）。ハードコードされた `spl_program = SPL Token`。使用先 `RomeBridgeWithdraw.approveBurnETH`                                                                                                               |
| `mint_spl(address,uint64,bytes32)`                               | `0xd795522b` | `Invoke`            | mint権限としてのCaller-PDAが、SPL経由で宛先ユーザーのATAにmintする `mint_to_checked`。SPLランタイムが権限一致を強制する。〜で使用 `SPL_ERC20.mint_to`                                                                                                                                                                                                                                    |
| `create_mint_account(bytes32)`                                   | `0xe97d3291` | `Invoke`            | System CreateAccountでsalt由来のPDAを割り当てる（`external_auth_with_salt(caller, salt)`）で、space=82、SPL Token所有。資金提供者 = 呼び出し元のexternal\_auth PDA。2つのPDA署名者。〜で使用 `ERC20SPLFactory.create_token_mint`                                                                                                                                                       |
| `init_spl_mint(bytes32,uint8,bytes32,bool,bytes32)`              | `0x4f75e987` | `Invoke`            | SPL Token `InitializeMint2` 事前割り当て済みmintに対して。PDA署名者は不要（mint\_authority/freeze\_authorityはデータとして保存され、ランタイム署名者ではない）。〜で使用 `ERC20SPLFactory.init_token_mint`                                                                                                                                                                                       |
| `create_and_init_mint(uint8,bytes32,bool,bytes32,bytes32)`       | `0x20972d0f` | `合成`                | 統合版: System CreateAccount + SPL InitializeMint2を1回のディスパッチで実行。個別に行う場合と比べてRome DoTxエンベロープを1つ節約 `create_mint_account` + `init_spl_mint` 呼び出し                                                                                                                                                                                                      |
| `deposit_from_ata(uint256)`                                      | `0x4479b709` | `合成`                | 呼び出し元のATAからSPLをRomeネイティブgasへ引き出す。 **単一ステートのみ** — op-gethチェーンでは拒否される                                                                                                                                                                                                                                                                            |
| `pda(address)`                                                   | `0x8854a299` | `EthCall`           | ユーザーの〜を導出 `EXTERNAL_AUTHORITY` PDA — 読み取り専用                                                                                                                                                                                                                                                                                                    |
| `pda_with_salt(address,bytes32)`                                 | `0x5c6d04b3` | `EthCall`           | salt由来の `EXTERNAL_AUTHORITY` 単一ディスパッチでPDAを生成。Solidity側の2回呼び出しを集約 `rome_evm_program_id() + find_program_address()` 構成。〜で使用 `RomeEVMAccount.pda_with_salt`, `RomeBridgeWithdraw.{burnUSDC,burnETH}`                                                                                                                                              |
| `ata(address)`                                                   | `0x31db4f82` | `EthCall`           | 導出 `getATA(user_pda, chain_mint_id)` — EXT\_AUTH + ATAを組み合わせる — 読み取り専用                                                                                                                                                                                                                                                                         |
| `ata(address,bytes32)`                                           | `0xfeb1c647` | `EthCall`           | 明示的なmint付きでも同様 — 読み取り専用                                                                                                                                                                                                                                                                                                                        |
| `user_balance(address,bytes32)`                                  | `0xdd0119c8` | `CrossStateEthCall` | ユーザーATAを読み取る `量` （SPL TokenAccountのオフセット64）。ATAが存在しない場合は0を返す（新規チェーンの確認）。v1の3回のディスパッチを集約。〜で使用 `SPL_ERC20.balanceOf`                                                                                                                                                                                                                             |
| `mint_info(bytes32)`                                             | `0xe24bf5d4` | `CrossStateEthCall` | レガシー経路の呼び出し元向けのmint情報: token program、decimals、 **有効化された** hook program（存在しない場合は0 *または* 不活性）、現在エポックの手数料bps、拡張存在ビットマップ。〜にもミラーされる `SplCached` 同じセレクタで。 `feeBps` は **述語** — 手数料が設定されていることを示すだけで、オペランドではない。実際の手数料は〜で上限が決まるため `maximum_fee` これは意図的に持たない。                                                                                             |
| `allowance_of(address,address,bytes32)`                          | `0xed72dbc8` | `CrossStateEthCall` | 所有者ATAのdelegated\_amountを読み取る **デリゲート一致チェック** — オンチェーンのデリゲートが〜でない限り0を返す `external_auth(spender)`。ERC-20として意味的に正しい（必須要件）。〜で使用 `SPL_ERC20.allowance`                                                                                                                                                                                             |

## Withdraw (`0x4200000000000000000000000000000000000016`)

Rome → Solanaネイティブgas引き出し。

| Solidity signature         | セレクタ         | ディスパッチ           | 説明                                                                                      |
| -------------------------- | ------------ | ---------------- | --------------------------------------------------------------------------------------- |
| `withdrawal(bytes32)`      | `0x4d8b0ea4` | `合成` (`payable`) | バーン `msg.value` Rome gas。Solanaのシステムアカウントへmint+transferする `を`。唯一のpayable precompileメソッド |
| `withdraw_to_pda(uint256)` | `0x7f3124a0` | `合成`             | gasをburnし、呼び出し元の `EXTERNAL_AUTHORITY` PDA。 **単一ステートのみ**                                 |
| `withdraw_to_ata(uint256)` | `0x8059abc0` | `合成`             | gasをburnし、〜に入金 `getATA(caller_pda, chain_mint_id)`. **単一ステートのみ**                        |


---

# 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/rifarensu/precompiles.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.
