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

# 컨트랙트를 Solana 사용자에게 공개하기

Rome(Hadrian 테스트넷, Rubicon 메인넷)에 Solidity 계약을 배포하고 Solana 지갑에 개방하세요 — 계약에 필요한 것, Solana 지갑 사용자가 어떻게 호출하는지, 각 네트워크의 주소, 그리고 출시 체

하나의 배포, 두 종류의 사용자. Rome의 계약은 EVM 키를 가진 MetaMask 사용자와 Solana 키를 가진 Solana 지갑 사용자(예: Solflare)에 의해 접근됩니다 — 같은 주소, 같은 상태. 이 페이지는 배포부터 끝까지의 경로입니다: 배포하고, 계약을 Solana에 맞게 준비하고, 앱에 Solana 레인을 연결하고, 메인넷에 출시하세요.

## 1. 원하는 네트워크에 배포하기

Rome 체인은 표준 EVM 대상입니다: Hardhat, Foundry, viem 및 ethers는 변경 없이 동작합니다(전체 안내는 [Solidity 계약 배포](https://docs.rome.builders/ko/developer-guides/deploy-solidity.md)).

| 네트워크                                                                   | 체인 ID    | RPC                                         | 탐색기                                                                                   | 가스 토큰    | 가스를 얻는 방법                                                                                                                                                                 |
| ---------------------------------------------------------------------- | -------- | ------------------------------------------- | ------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**Rubicon**](https://docs.rome.builders/ko/networks/rubicon.md) (메인넷) | `7531`   | `https://rubicon.mainnet.romeprotocol.xyz/` | [via-rubicon.mainnet.romeprotocol.xyz](https://via-rubicon.mainnet.romeprotocol.xyz/) | USDC     | Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad 또는 OP(CCTP)에서, 또는 Solana에서 다음을 통해 USDC를 브리지하세요 [Rome Bridge](https://bridge-api.mainnet.romeprotocol.xyz/); 가스로 도착합니다 |
| **Hadrian** (테스트넷)                                                     | `200010` | `https://hadrian.testnet.romeprotocol.xyz/` | [via-hadrian.testnet.romeprotocol.xyz](https://via-hadrian.testnet.romeprotocol.xyz/) | 테스트 USDC | 테스트넷에서 테스트 USDC를 브리지하세요 ([파우셋](https://docs.rome.builders/ko/resources/faucets.md)) 또는 Solana devnet 지갑에서 다음에서 래핑하세요 [Rome App](https://app.devnet.romeprotocol.xyz)      |

가스는 EVM 측에서 18자리 소수점을 가진 USDC입니다. Rubicon이나 Hadrian에는 Rome faucet가 없습니다. 쓰기 작업은 Ethereum의 직관보다 더 많은 가스를 소모합니다. 비용의 대부분이 Solana 계정을 생성하는 데 들기 때문입니다: 한 번도 사용되지 않은 수신자, 새 토큰 계정, 배포된 계약. 다음을 사용하세요 `eth_estimateGas`, 표준 도구가 수행하듯이 21,000을 하드코딩하지 마세요. Hadrian에서 측정한 결과, 10바이트 계약을 배포하는 데 1,147,921 가스가 예상되고 실제로 사용되었으며, 한 번도 사용되지 않은 주소로의 네이티브 전송은 1,086,961이었고, 기존 주소로의 전송은 21,000이었습니다. Rome은 실제로 사용된 가스만 청구하며, 이 측정에서는 추정치를 초과한 적이 없었습니다. 첫 배포 전에 몇 USDC를 충전하세요. 이후 탐색기에서 소스를 검증하세요 ([계약 검증](https://docs.rome.builders/ko/developer-guides/verify-contracts.md)메인넷 검증기는 `https://verify.mainnet.romeprotocol.xyz`).

Hadrian에서 개발한 뒤, 체인 ID와 메인넷 래퍼 주소만 바꿔 동일한 아티팩트를 Rubicon에 다시 배포하세요. 계약 내용은 네트워크 간에 변하지 않습니다. Rubicon은 v0.3.0부터 공개 레지스트리에 있지만 `create-rome-app` 그리고 `rome-cli` 여전히 registry v0.2.0에 고정되어 있어 Rubicon 항목이 없으므로 이를 대상으로 지정할 수 없습니다. 그런 도구의 경우, 다음에서 값을 수동으로 채우세요 [Rubicon](https://docs.rome.builders/ko/networks/rubicon.md). Rubicon의 가스는 Hadrian의 가스 가격의 약 10배에 해당하는 실제 USDC이므로, 그곳에서의 배포는 실제 비용이 듭니다.

## 2. 계약을 Solana에 맞게 만드는 요소

Solana 사용자의 EVM 식별자는 그들의 **합성 주소**, `keccak256(solana_pubkey)[12:]`: 일반적인 `msg.sender`, 일반적인 nonce를 가진 것입니다. 대부분의 계약은 전혀 변경할 필요가 없습니다. 중요한 세 가지는 다음과 같습니다:

* **가치는 ERC-20으로 받으세요, 다음이 아니라 `msg.value`.** Solana 사용자의 자금은 지갑에 있는 SPL 토큰이며, EVM 측에서는 토큰의 래퍼로 보입니다(`wUSDC`, `wETH`, `wSOL`). 합성 계정은 유휴 상태에서는 아무것도 보유하지 않으며 사용자의 자산은 래퍼 형태로 도착하므로, 다음으로 끌어오고 `transferFrom` 을 `approve` 다음으로 반환하세요 `transfer`. 각 사용자는 첫 번째 pull 전에 래퍼에 SPL 위임 권한을 한 번 부여합니다 ([일회성: 래퍼에 권한을 부여](https://docs.rome.builders/ko/developer-guides/dual-lane-app.md#one-time-grant-the-wrapper)). `payable` 진입점은 합성 계정에 네이티브 가스가 제공된 후에만 작동합니다(릴레이 경로의 `rome_composeExternalDepositV1`그리고 fund-and-sweep 모델은 그렇게 하지 않습니다. 기존 ERC-20 금고, AMM 또는 대출 시장은 이미 올바른 형태를 갖추고 있습니다.
* **공식 래퍼를 사용하세요.** 각 체인에는 mint당 하나의 래퍼가 있으며, 주소는 다음에 있습니다 [Contract Addresses](https://docs.rome.builders/ko/reference/contract-addresses.md) (Hadrian의 것은 공개 [registry](https://github.com/rome-protocol/rome-registry)). 생성자에서는 해당 주소를 사용하세요; 직접 배포하지 마세요.
* **지갑이 서명하는 원자적 예산에 맞추세요.** Solana 지갑은 하나의 Solana 트랜잭션에 서명하므로, Solana 레인 호출은 그 안에 맞아야 합니다: 약 140만 compute unit, 64개 계정, 4KB ([제약 사항](https://docs.rome.builders/ko/core-concepts/constraints.md)). Hadrian에서 측정한 결과: 전송, 승인, Aave 공급은 들어갑니다; Uniswap V3 스왑은 여유가 거의 없이 들어갑니다(약 124만 CU); Aave 차입은 들어가지 않으며 다음 섹션의 릴레이 경로를 탑니다. Solana 영수증의 다음 항목으로 측정하세요 `computeUnitsConsumed`, 트랜잭션을 다음과 함께 요청하면서 `maxSupportedTransactionVersion: 1` (Rome 레그는 v1 트랜잭션입니다; 이것이 없으면 RPC가 요청을 거부합니다).

필요하지 않은 것: Solana 프로그램, 브리지, 두 번째 배포, 또는 Rome 전용 Solidity. 계약이 precompile을 통해 Solana 프로그램도 호출한다면, 다음을 보세요 [EVM에서 Solana 호출](https://docs.rome.builders/ko/developer-guides/call-solana-from-evm.md).

## 3. Solana 지갑이 이를 호출하게 하기

앱의 EVM 경로는 변경되지 않습니다(MetaMask + `submitRomeTx`, 또는 일반 viem/ethers).

**Solana 경로에는 두 가지 형태가 있습니다.** [`@rome-protocol/sdk`](https://github.com/rome-protocol/rome-sdk-ts) (`submitRomeTxV1`SDK 레인 — 호출당 하나의 Solana v1 트랜잭션.`Rome 승인` 한 줄에, `0x` 그리고 다음 줄에 EVM 트랜잭션 해시), 이를 체인이 Ed25519 프로그램을 통해 확인한 뒤 트랜잭션을 서명합니다. 앱은 서명된 트랜잭션을 Solana RPC로 보냅니다; 호출은 EVM 트랜잭션 해시와 그 영수증을 반환합니다. 지갑이 트랜잭션에 서명하기 전에 SDK가 이를 검사합니다: payer가 유일한 서명자이고, Rome 프로그램과 Ed25519 검증기만 실행되며, Rome instruction은 사용자가 승인한 호출과 정확히 일치하고, 우선 수수료는 없습니다. 그 외의 것은 모두 거부됩니다.

호출이 하나의 트랜잭션에 들어가지 않으면, composer가 이를 거부하고 SDK가 같은 권한 서명으로 프록시에 넘겨 릴레이하게 하므로, 사용자는 여전히 하나의 권한 부여 프롬프트만 보게 됩니다. 그 결과에는 `route: "relay"`. 릴레이된 호출과 긴 호출에 대한 규칙은 다음에 있습니다 [릴레이된 호출과 긴 호출](https://docs.rome.builders/ko/developer-guides/call-evm-from-solana.md#relayed-calls-and-long-calls). 릴레이된 호출은 체인의 네이티브 가스로 지불되므로, 합성 계정에 가스 잔액이 필요합니다: `fundSyntheticGas(deps, amountWei)` 지갑의 토큰 계정에서 체인의 가스 토큰(Hadrian과 Rubicon의 USDC)을 합성 계정으로 옮기며, 지갑이 서명한 하나의 v1 트랜잭션으로 처리합니다.

fund 레그(`buildFundLeg`)과 sweep 전에 지갑 토큰 계정을 생성하는 것은 일반적인 Solana instruction입니다; `submitSolanaInstructionsV1` 같은 지갑 서명자가 서명한 v1 트랜잭션으로도 보냅니다. 프록시는 관여하지 않습니다. sweep 자체 호출(`buildSweepLeg`, `HelperProgram.transfer_spl`)은 다음을 통해 진행됩니다 `submitRomeTxV1` 다른 것들과 마찬가지로, 그리고 프록시는 토큰 계정을 찾습니다. `submitRomeTxV1` 스스로 새 합성 계정의 계정을 생성하지 않습니다: 첫 번째 가치 이동 호출 전에 다음을 확인하세요 `isSyntheticProvisioned(...)` 그리고 false이면 다음을 제출하세요 `buildCreatePdaCall(synthetic)` 을 통해 `submitRomeTxV1` 한 번만. 코드가 포함된 전체 입금 및 출금 안내는 다음에 있습니다 [듀얼 레인 앱 빌드](https://docs.rome.builders/ko/developer-guides/dual-lane-app.md); 작동 방식은 다음에 있습니다 [Solana에서 EVM 호출](https://docs.rome.builders/ko/developer-guides/call-evm-from-solana.md). 이전의 `submitRomeTxSolanaLane`; 클라이언트에서 레거시 Solana 트랜잭션을 구성하며, 여전히 SDK에 이전 경로로 남아 있습니다.

**각 `의존성이` 값이 어디서 오는지.** SDK의 `의존성이` 객체에는 5개의 필수 필드가 있습니다(그 밖의 것들, 예를 들어 `fetchImpl` 와 timeout은 선택 사항입니다). 4개는 체인에서, 1개는 지갑에서 옵니다:

| `의존성이` 필드   | 출처                                                                       | 레지스트리 가져오기(`@rome-protocol/registry` v0.2.0)                                  |
| ----------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------- |
| `proxyUrl`  | 체인의 RPC URL                                                              | `getChain(chainId).rpcUrl`                                                    |
| `chainId`   | 체인 ID                                                                    | `getChain(chainId).chainId`                                                   |
| `programId` | 체인이 실행하는 Rome 프로그램 ID                                                    | `getChain(chainId).romeEvmProgramId`                                          |
| `연결`        | 체인 클러스터용 Solana RPC로, 서명된 트랜잭션이 전송됩니다(Hadrian은 devnet, Rubicon은 mainnet) | `getChain(chainId).solana.rpc` (Hadrian용 공개 devnet URL); 메인넷에서는 자체 RPC를 사용하세요 |
| `signer`    | 지갑의 `LaneSigner`, 또는 `Keypair` 스크립트에서                                    | 없음                                                                            |

레그 빌더는 다음에 없는 값을 사용합니다 `의존성이`. 그들의 `mint` (라고 불리는 `usdcMint` 안내에서는) 가스 토큰의 Solana mint이며, 다음에서 가져옵니다 `getTokens(chainId)` (다음 항목이 있는 엔트리 `kind: "gas"`, 필드 `mintId`). wUSDC 래퍼 주소는 레그 빌더 입력이 아닙니다; ERC-20 호출에 사용하며, 다음 항목이 있는 엔트리입니다 `kind: "spl_wrapper"` 및 symbol `wUSDC` (필드 `address`). 레지스트리는 Hadrian과 v0.3.0부터의 Rubicon을 포함합니다. 대신 Rubicon 값을 수동으로 채우려면: `proxyUrl` `https://rubicon.mainnet.romeprotocol.xyz/`, `chainId` `7531`, `programId` `RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX`, `mint` `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`, 다음 섹션의 표에 있는 래퍼, 그리고 다음을 위한 Solana mainnet RPC `연결`. [Rubicon](https://docs.rome.builders/ko/networks/rubicon.md) 에 전체 목록이 있습니다.

**프록시의 external-V1 엔드포인트 — SDK 없이 사용하는 동일한 레인.** SDK는 atomic compose, relay, gas deposit을 감쌉니다(`fundSyntheticGas`). 원시 RPC 메서드는 SDK를 사용하지 않는 클라이언트를 위해 남아 있으며, SDK가 감싸지 않는 iterative compose를 포함합니다. 지갑은 호출에 대해 하나의 Ed25519 메시지에 서명합니다(가독 가능한 형식 `Rome 승인\n0x<hash>` 또는 원시 해시)이며, 프록시는 지갑이 서명할 Solana 트랜잭션(들)을 구성하거나(`rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1` + `rome_submitSignedV1Plan`) 또는 하나의 지갑 서명으로 전체 실행을 자체적으로 수행합니다(`rome_relayUnsignedV1`, 다음을 거친 후 `rome_composeExternalDepositV1` (SDK의 `fundSyntheticGas`) 합성 계정의 가스 잔액을 충전합니다; 릴레이된 호출은 여기서 지출되므로, 부족해지면 충전하세요). [JSON-RPC 지원](https://docs.rome.builders/ko/reference/json-rpc.md)메서드 형태는 다음에 있습니다 [Solana에서 EVM 호출](https://docs.rome.builders/ko/developer-guides/call-evm-from-solana.md#the-external-v1-endpoints); 승인 규칙은 다음에 있습니다

. 반복적인 것은 무엇이든 relay를 사용하고, 들어가는 것은 모두 SDK 레인을 사용하세요.

## 4. 네트워크별 래퍼 주소

| 네트워크             | `wUSDC` 래퍼                                   | 기타 래퍼                                                                                                    |
| ---------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Rubicon (7531)   | `0x0952d233b0c254cd375f3bfb3e5869c1a906f9b3` | `wETH` `0x01e8b3573da1d4b7b4b1ce0932cf07c8af0c92e9`, `wSOL` `0xc4e29e0f726a906e93277cbbc37bf27a9848a113` |
| Hadrian (200010) | `0xbce339ba4c3a8de3bb8af1c5539e6ac11da3112d` | `wETH` `0x02aeace038269f9961c93d04dcacd6fb3adfa55f`, `wSOL` `0x39f36444fcb79b3e691544aee2a832ebef54ca9f` |

네이티브 가스 토큰은 다음으로 표시됩니다 `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` 토큰 목록에서; 이는 ERC-20 계약이 아닙니다. 래퍼는 18이 아니라 SPL mint의 소수 자릿수를 따릅니다: wUSDC 6, wETH 8, wSOL 9.

## 5. 출시 체크리스트

1. Hadrian에 배포됨; EVM 경로는 MetaMask에서 작동합니다.
2. 가치를 이동하는 모든 진입점은 ERC-20 기반이며 체인의 공식 래퍼를 가리킵니다.
3. v1 트랜잭션에 서명하는 Solana 지갑(Solflare는 현재 devnet에서 가능하고, Phantom은 아직 불가)은 Hadrian에서 전체 왕복을 완료합니다: 합성 계정을 프로비저닝(`create_pda`한 번) → fund 레그 → grant → approve → call → sweep 레그를 SDK 레인을 사용해 진행합니다; 호출이 반복적이면 relay 경로를 사용합니다.
4. 각 Solana 레인 호출의 `computeUnitsConsumed` 는 Solana 영수증에서 읽히며 원자적 예산 내에 있어야 하고, 아니면 호출은 relay를 통해 라우팅됩니다.
5. 래퍼 grant는 두 레인 모두에서 앱의 첫 입금 흐름에 포함됩니다: `isEnabled(user)` 이 확인되고 `approve_spl` 가 false일 때 한 번 전송됩니다([일회성: 래퍼에 권한을 부여](https://docs.rome.builders/ko/developer-guides/dual-lane-app.md#one-time-grant-the-wrapper)).
6. 소스가 탐색기에서 검증됩니다.
7. 메인넷 래퍼 주소로 Rubicon에 다시 배포됨. 그 `의존성이` 값은 레지스트리(v0.3.0 이상)에서 가져오거나 다음에서 수동으로 가져옵니다 [Rubicon](https://docs.rome.builders/ko/networks/rubicon.md). 같은 왕복을 실제 자금으로 한 번 실행하며, 메인넷에서 v1 트랜잭션에 서명하는지 확인한 지갑을 사용합니다.

## 다음 단계

* [듀얼 레인 앱 빌드](https://docs.rome.builders/ko/developer-guides/dual-lane-app.md) — 금고 예제, 단계별로, 두 지갑 모두
* [Solana에서 EVM 호출](https://docs.rome.builders/ko/developer-guides/call-evm-from-solana.md) — 합성 주소, 계정 발견, external-V1 엔드포인트
* [Solidity 계약 배포](https://docs.rome.builders/ko/developer-guides/deploy-solidity.md) · [계약 검증](https://docs.rome.builders/ko/developer-guides/verify-contracts.md) · [Contract Addresses](https://docs.rome.builders/ko/reference/contract-addresses.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/developer-guides/open-to-solana-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.
