컨트랙트를 Solana 사용자에게 공개하기
Rome(Hadrian 테스트넷, Rubicon 메인넷)에 Solidity 계약을 배포하고 Solana 지갑에 개방하세요 — 계약에 필요한 것, Solana 지갑 사용자가 어떻게 호출하는지, 각 네트워크의 주소, 그리고 출시 체
하나의 배포, 두 종류의 사용자. Rome의 계약은 EVM 키를 가진 MetaMask 사용자와 Solana 키를 가진 Solana 지갑 사용자(예: Solflare)에 의해 접근됩니다 — 같은 주소, 같은 상태. 이 페이지는 배포부터 끝까지의 경로입니다: 배포하고, 계약을 Solana에 맞게 준비하고, 앱에 Solana 레인을 연결하고, 메인넷에 출시하세요.
1. 원하는 네트워크에 배포하기
Rome 체인은 표준 EVM 대상입니다: Hardhat, Foundry, viem 및 ethers는 변경 없이 동작합니다(전체 안내는 Solidity 계약 배포).
Rubicon (메인넷)
7531
https://rubicon.mainnet.romeprotocol.xyz/
USDC
Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad 또는 OP(CCTP)에서, 또는 Solana에서 다음을 통해 USDC를 브리지하세요 Rome Bridge; 가스로 도착합니다
Hadrian (테스트넷)
200010
https://hadrian.testnet.romeprotocol.xyz/
테스트 USDC
가스는 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://verify.mainnet.romeprotocol.xyz).
Hadrian에서 개발한 뒤, 체인 ID와 메인넷 래퍼 주소만 바꿔 동일한 아티팩트를 Rubicon에 다시 배포하세요. 계약 내용은 네트워크 간에 변하지 않습니다. Rubicon은 v0.3.0부터 공개 레지스트리에 있지만 create-rome-app 그리고 rome-cli 여전히 registry v0.2.0에 고정되어 있어 Rubicon 항목이 없으므로 이를 대상으로 지정할 수 없습니다. 그런 도구의 경우, 다음에서 값을 수동으로 채우세요 Rubicon. 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 위임 권한을 한 번 부여합니다 (일회성: 래퍼에 권한을 부여).payable진입점은 합성 계정에 네이티브 가스가 제공된 후에만 작동합니다(릴레이 경로의rome_composeExternalDepositV1그리고 fund-and-sweep 모델은 그렇게 하지 않습니다. 기존 ERC-20 금고, AMM 또는 대출 시장은 이미 올바른 형태를 갖추고 있습니다.공식 래퍼를 사용하세요. 각 체인에는 mint당 하나의 래퍼가 있으며, 주소는 다음에 있습니다 Contract Addresses (Hadrian의 것은 공개 registry). 생성자에서는 해당 주소를 사용하세요; 직접 배포하지 마세요.
지갑이 서명하는 원자적 예산에 맞추세요. Solana 지갑은 하나의 Solana 트랜잭션에 서명하므로, Solana 레인 호출은 그 안에 맞아야 합니다: 약 140만 compute unit, 64개 계정, 4KB (제약 사항). Hadrian에서 측정한 결과: 전송, 승인, Aave 공급은 들어갑니다; Uniswap V3 스왑은 여유가 거의 없이 들어갑니다(약 124만 CU); Aave 차입은 들어가지 않으며 다음 섹션의 릴레이 경로를 탑니다. Solana 영수증의 다음 항목으로 측정하세요
computeUnitsConsumed, 트랜잭션을 다음과 함께 요청하면서maxSupportedTransactionVersion: 1(Rome 레그는 v1 트랜잭션입니다; 이것이 없으면 RPC가 요청을 거부합니다).
필요하지 않은 것: Solana 프로그램, 브리지, 두 번째 배포, 또는 Rome 전용 Solidity. 계약이 precompile을 통해 Solana 프로그램도 호출한다면, 다음을 보세요 EVM에서 Solana 호출.
3. Solana 지갑이 이를 호출하게 하기
앱의 EVM 경로는 변경되지 않습니다(MetaMask + submitRomeTx, 또는 일반 viem/ethers).
Solana 경로에는 두 가지 형태가 있습니다. @rome-protocol/sdk (submitRomeTxV1SDK 레인 — 호출당 하나의 Solana v1 트랜잭션.Rome 승인 한 줄에, 0x 그리고 다음 줄에 EVM 트랜잭션 해시), 이를 체인이 Ed25519 프로그램을 통해 확인한 뒤 트랜잭션을 서명합니다. 앱은 서명된 트랜잭션을 Solana RPC로 보냅니다; 호출은 EVM 트랜잭션 해시와 그 영수증을 반환합니다. 지갑이 트랜잭션에 서명하기 전에 SDK가 이를 검사합니다: payer가 유일한 서명자이고, Rome 프로그램과 Ed25519 검증기만 실행되며, Rome instruction은 사용자가 승인한 호출과 정확히 일치하고, 우선 수수료는 없습니다. 그 외의 것은 모두 거부됩니다.
호출이 하나의 트랜잭션에 들어가지 않으면, composer가 이를 거부하고 SDK가 같은 권한 서명으로 프록시에 넘겨 릴레이하게 하므로, 사용자는 여전히 하나의 권한 부여 프롬프트만 보게 됩니다. 그 결과에는 route: "relay". 릴레이된 호출과 긴 호출에 대한 규칙은 다음에 있습니다 릴레이된 호출과 긴 호출. 릴레이된 호출은 체인의 네이티브 가스로 지불되므로, 합성 계정에 가스 잔액이 필요합니다: 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 한 번만. 코드가 포함된 전체 입금 및 출금 안내는 다음에 있습니다 듀얼 레인 앱 빌드; 작동 방식은 다음에 있습니다 Solana에서 EVM 호출. 이전의 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 에 전체 목록이 있습니다.
프록시의 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 지원메서드 형태는 다음에 있습니다 Solana에서 EVM 호출; 승인 규칙은 다음에 있습니다
. 반복적인 것은 무엇이든 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. 출시 체크리스트
Hadrian에 배포됨; EVM 경로는 MetaMask에서 작동합니다.
가치를 이동하는 모든 진입점은 ERC-20 기반이며 체인의 공식 래퍼를 가리킵니다.
v1 트랜잭션에 서명하는 Solana 지갑(Solflare는 현재 devnet에서 가능하고, Phantom은 아직 불가)은 Hadrian에서 전체 왕복을 완료합니다: 합성 계정을 프로비저닝(
create_pda한 번) → fund 레그 → grant → approve → call → sweep 레그를 SDK 레인을 사용해 진행합니다; 호출이 반복적이면 relay 경로를 사용합니다.각 Solana 레인 호출의
computeUnitsConsumed는 Solana 영수증에서 읽히며 원자적 예산 내에 있어야 하고, 아니면 호출은 relay를 통해 라우팅됩니다.래퍼 grant는 두 레인 모두에서 앱의 첫 입금 흐름에 포함됩니다:
isEnabled(user)이 확인되고approve_spl가 false일 때 한 번 전송됩니다(일회성: 래퍼에 권한을 부여).소스가 탐색기에서 검증됩니다.
메인넷 래퍼 주소로 Rubicon에 다시 배포됨. 그
의존성이값은 레지스트리(v0.3.0 이상)에서 가져오거나 다음에서 수동으로 가져옵니다 Rubicon. 같은 왕복을 실제 자금으로 한 번 실행하며, 메인넷에서 v1 트랜잭션에 서명하는지 확인한 지갑을 사용합니다.
다음 단계
듀얼 레인 앱 빌드 — 금고 예제, 단계별로, 두 지갑 모두
Solana에서 EVM 호출 — 합성 주소, 계정 발견, external-V1 엔드포인트
마지막 업데이트
도움이 되었나요?