For the complete documentation index, see llms.txt. This page is also available as Markdown.

EVM에서 Solana 호출

Rome의 CPI와 헬퍼 프리컴파일을 통해 Solidity에서 Solana 프로그램을 호출하세요.

Rome의 프리컴파일을 사용하면 Solidity 계약이 Solana 프로그램을 직접 호출할 수 있습니다. 이 가이드에서는 그 메커니즘을 다룹니다.

필수 조건

각 인터페이스를 해당 프리컴파일 주소에 바인딩합니다:

import {ICrossProgramInvocation, ISystemProgram, IHelperProgram}
    from "@rome-protocol/rome-solidity/contracts/interface.sol";

ICrossProgramInvocation constant CpiProgram    = ICrossProgramInvocation(0xFF00000000000000000000000000000000000008);
ISystemProgram          constant SystemProgram = ISystemProgram(0xFF00000000000000000000000000000000000007);
IHelperProgram          constant Helper        = IHelperProgram(0xFF00000000000000000000000000000000000009);

CpiProgram 프리컴파일

`CpiProgram` (0xFF…08)는 CPI를 디스패치하고 (invoke / invoke_signed) 및 교차 상태 읽기 바로가기(account_info, account_data_at, account_u64_at, account_lamports, pdas_batch_derive):

// Solana 프로그램 호출
CpiProgram.invoke(programId, accounts, instructionData);

// PDA 서명으로 호출: 계약의 external-authority PDA가 서명하며, 추가로 하나
// `salts`의 각 항목마다 salted sub-PDA가 하나씩 생성됩니다(Rome는 ["EXTERNAL_AUTHORITY", contract, salt]를 파생합니다)
CpiProgram.invoke_signed(programId, accounts, data, salts);

Lamport 전송

단순한 lamport 및 SPL 전송에는 HelperProgram 프리컴파일을 사용하세요 — 직접 CPI를 구성할 필요가 없습니다. 이를 호출하는 계약은 다음과 같이 동작합니다 자체적으로: 아래 전송은 사용자의 것이 아니라 계약 자체의 lamport와 토큰(계약의 external-authority PDA가 서명함)을 이동합니다. 계약이 사용자의 SPL 토큰을 자신이 제어하는 토큰 계정으로 가져오고, 그것이 누구의 것인지 알기 위해서는 사용자가 SPL 위임을 부여합니다. ERC-20 transfer 또는 transferFrom 계약에 대한 전송은 래퍼의 에스크로 원장에만 적립되며, 계약에 지출할 토큰 계정을 제공하지 않습니다 — 참조 Solana 프로그램 통합.

transfer_spl 에는 여러 오버로드가 있습니다( transferFrom 의 대리자 변형 포함); 정확한 시그니처는 참조 의 CPI 프리컴파일. 캐시된 트랙에서는 다음을 사용하세요 ISplCached (0xff…05) / IAssociatedSplCached (0xff…06) 대신 — 계약은 하나의 트랙만 일관되게 사용하며, 레거시 트랙만 다음을 할 수 있습니다 invoke 사용자 지정 프로그램(참조 Solana 프로그램 통합).

계정 데이터 읽기

CpiProgram의 읽기 바로가기를 통해 어떤 Solana 계정의 데이터든 읽을 수 있습니다:

PDA 도출

System 프리컴파일을 통해 Solidity에서 Program Derived Address를 찾습니다:

Base58 변환

다음 사이를 변환합니다 bytes32 및 base58(Solana의 주소 형식):

사용자 정의 Solana 프로그램 호출

어떤 Solana 프로그램이든 호출하려면 계정 목록과 instruction data를 직접 구성하세요:

주요 제약

  1. 모든 계정은 미리 선언되어야 합니다. Solana 트랜잭션에는 CPI가 접근할 모든 계정이 포함되어야 합니다 — CPI 내부에서 동적으로 계정을 검색하는 것은 불가능합니다.

  2. CPI 깊이 제한: 4단계. Rome EVM → 대상 → 대상의 호출 → 한 번 더. 호출 깊이를 계획하세요.

  3. Solana pubkey는 bytes32, 20바이트 Ethereum 주소가 아닙니다.

  4. instruction data는 원시 바이트이며 대상 프로그램이 기대하는 형식(보통 Borsh, 리틀 엔디언)이어야 합니다.

다음은 무엇인가

  • 실제 앱에서 확인하세요 — cardo 어댑터 계약 없이 사용자의 지갑에서 바로 precompile로 CPI 호출을 보냅니다; rome-dex (dual-lane AMM)도 마찬가지이며, 수탁이 없는 라우터 계약도 있습니다; aerarium 는 Solidity에서 Solana 프로그램을 호출하지 않는 대출 앱입니다.

  • Solana 프로그램 통합 — 사용자의 Solana 신원, 그것으로 서명하는 방식, one-track 규칙, 그리고 반대편의 실제 프로그램을 위한 계정 프로비저닝

  • 사전 컴파일 참조 — 모든 precompile의 모든 selector

  • Solana에서 EVM 호출 — 반대 방향: Solana 지갑으로 EVM 계약을 구동하기

  • 토큰 상호운용성 — ERC-20과 SPL 토큰이 함께 작동하는 방식

  • 제약 사항 — CPI 깊이 및 기타 제한

마지막 업데이트

도움이 되었나요?