İçeriğe geç
For the complete documentation index, see llms.txt. This page is also available as Markdown.

EVM'den Solana'yı çağırma

Rome'un CPI'si ve yardımcı precompile'ları aracılığıyla Solidity'den Solana programlarını çağırın.

Rome'un ön-derlemeleri Solidity sözleşmelerinin Solana programlarını doğrudan çağırmasına izin verir. Bu kılavuz mekanikleri kapsar.

Ön koşullar

Her arayüzü kendi ön-derleme adresine bağlayın:

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 ön-derlemesi

CpiProgram (0xFF…08) CPI'yi (invoke / invoke_signed) ve çapraz durum okuma kısayollarını (account_info, account_data_at, account_u64_at, account_lamports, pdas_batch_derive):

// Bir Solana programını çağırın
CpiProgram.invoke(programId, accounts, instructionData);

// PDA imzasıyla çağırın: sözleşmenizin dış yetki PDA'sı imzalar, ayrıca bir
// `salts` içindeki her giriş için tuzlanmış alt-PDA (Rome ["EXTERNAL_AUTHORITY", contract, salt] türetir)
CpiProgram.invoke_signed(programId, accounts, data, salts);

Lamport transfer etme

Basit lamport ve SPL transferleri için HelperProgram ön-derlemesini kullanın — elle oluşturulmuş CPI gerekmez. Ona çağrı yapan bir sözleşme, kendisinin: aşağıdaki transferler sözleşmenin kendi lamport ve token'larını taşır (dış yetki PDA'sı imzalar), kullanıcınınkileri değil. Bir sözleşmenin kullanıcının SPL token'larını kontrol ettiği bir token hesabına çekmesi ve bunların kimin olduğunu bilmesi için kullanıcı bir SPL delege etme izni verir. Bir ERC-20 transfer veya transferFrom bir sözleşmeye verildiğinde yalnızca sarmalayıcının emanet defterini kredilendirir ve sözleşmeye harcayabileceği bir token hesabı sağlamaz — bkz. Bir Solana programını entegre edin.

transfer_spl birden çok aşırı yüklemeye sahiptir ( transferFrom akışları için interface.sol. Önbelleğe alınmış hatta, bunun yerine ISplCached (0xff…05) / IAssociatedSplCached (0xff…06) kullanın — bir sözleşme tek bir hattı tutarlı şekilde kullanır ve yalnızca eski hat invoke özel bir programı (bkz. Bir Solana programını entegre edin).

Hesap verilerini okuma

CpiProgram okuma kısayolları aracılığıyla herhangi bir Solana hesabının verisini okuyun:

PDA türetme

System ön-derlemesi aracılığıyla Solidity'den Program Türetilmiş Adresleri bulun:

Base58 dönüşümü

Arasında dönüştürün bytes32 ve base58 (Solana'nın adres formatı):

Özel Solana programlarını çağırma

Herhangi bir Solana programını çağırmak için, hesap listesini ve talimat verisini kendiniz oluşturun:

Temel Kısıtlamalar

  1. Tüm hesaplar önceden beyan edilmelidir. Solana işlemi, CPI'ın dokunacağı her hesabı içermelidir — CPI içinde dinamik hesap keşfi mümkün değildir.

  2. CPI derinlik sınırı: 4 seviye. Rome EVM → hedefiniz → hedefin çağrısı → bir tane daha. Çağrı derinliğinizi planlayın.

  3. Solana pubkey'leri bytes32, 20 baytlık Ethereum adresleri değildir.

  4. Talimat verisi ham baytlardır hedef programın beklediği formatta (genellikle Borsh, little-endian).

Sırada Ne Var

  • Gerçek bir uygulamada görün — cardo ara sözleşme olmadan, doğrudan kullanıcının cüzdanından ön-derlemeye CPI çağrıları gönderir; rome-dex (çift hatlı AMM) aynı şeyi yapar ve ayrıca emanetsiz bir yönlendirici sözleşmeye sahiptir; aerarium Solidity'den Solana programlarını çağırmayan bir borç verme uygulamasıdır.

  • Bir Solana programını entegre edin — kullanıcının Solana kimliği, onun adına imzalaması, tek hat kuralı ve diğer taraftaki gerçek bir program için hesap sağlama

  • Precompile referansı — her ön-derleme üzerindeki her seçici

  • Solana'dan EVM'yi çağırma — bunun tersi: EVM sözleşmelerini bir Solana cüzdanından çalıştırın

  • Token Birlikte Çalışabilirliği — ERC-20 ve SPL token'larının birlikte nasıl çalıştığı

  • Kısıtlar — CPI derinliği ve diğer sınırlar

Son güncelleme

Bu yararlı oldu mu?