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

10. Diğer zincirlerden kullanıcıları ve fonları getirin

Köprü, API'si ve CLI'si ile kullanıcıları ve fonlarını diğer zincirlerden ve Solana'dan Rome uygulamanıza getirin ve uygulamanızın ekranını canlı tutun.

Uygulamanız her iki cüzdan türü için de çalışır. Şimdi insanların bir yere ulaşma yoluna ihtiyacı var. Çoğu USDC’lerini başka bir zincirde ya da Solana üzerinde tutuyor ve önce Rome’u öğrenmek zorunda kalmamalılar. Bu ders, desteklenen bir zincirden USDC getirmek, transferi takip etmek ve kullanıcıların fonları geri çekmesine izin vermek için Rome Bridge API’yi kullanır; uygulamanız ise güncel kalır. 2. Neler oluşturabilirsiniz Bunun nereye uyduğunu gösterir.

Neler öğreneceksiniz

  • Başka bir zincirdeki bir kullanıcının evinden ayrılmadan Rome uygulamanıza nasıl ulaştığını.

  • Bir kullanıcının USDC’sinin bir EVM zincirinden ve Solana’dan Rome’a nasıl ulaştığını.

  • Bir transferin neden gas olarak ya da wUSDC olarak ulaştığı ve hangisinin seçileceği.

  • Gelen bir transferin dört adımı.

  • Rome’dan ayrılmanın neden ulaşmaktan daha fazla adımı olduğu.

  • Uygulamanızda canlı durumu nasıl göstereceğiniz ve explorer’da bir transferi nasıl kontrol edeceğiniz.

Başlamadan önce

  • Tamamla 9. Çift şeritli bir uygulama oluşturun. Vault’a veya kullanıcıların ulaşmasını istediğiniz herhangi bir uygulamaya ihtiyacınız var.

  • Rome CLI’nin kurulu olduğundan emin olun (Rome CLI + MCP).

  • Bir kaynak zincirde test USDC’ye ve o zincirin ücretleri için yerel tokenine sahip olun, Faucets.

Ders

1. İki yolun nasıl işlediğini anlayın

Rome Bridge ile kullanıcılarınız iki yerden birinden gelir. Bir EVM zinciri, USDC’yi Circle’ın CCTP’si üzerinden gönderir. Bir Solana cüzdanı ise SOL veya USDC’yi düz SPL transferleriyle gönderir. Her iki durumda da köprü zincir üstündedir ve kullanıcının kendi imzası altında kesinleşir. Zincir dışı Bridge API rotayı fiyatlandırır, kaynak işlemi doğrular ve uzlaşma ücretini sponsorlar. Hiçbir fon veya anahtar tutmaz; bu yüzden yalnızca kullanıcının zaten imzaladığı şeyi tetikleyebilir.

Desteklenen zincirler ve varlıklar testnet ile mainnet arasında farklılık gösterir; bu yüzden varsaymak yerine listeleri okuyun. Bunlar Rome Köprüsü üzerinde ve canlı liste API’nin /v1/routes uç noktasıdır. Bir kullanıcının ana zincirinden uygulamanıza ulaşma modeli Ana zincirden.

2. Gas mı wUSDC mi kararlaştırın

Köprü üzerinden gelen USDC varsayılan olarak gas olarak ulaşır. Gas, MetaMask kullanıcısının ücret ödemek için kullandığı şeydir. Vault’unuzun aldığı token wUSDC’dir. Bunlar aynı USDC’nin iki biçimidir ve kullanıcı birini diğerine dönüştürebilir.

Niyeti alıntıda belirleyin. wUSDC alan bir uygulama, örneğin vault’unuz, kullanıcıların wUSDC olarak gelmesini ister. Gas olarak gelen bir kullanıcı, 9. dersteki gibi önce bunun bir kısmını sarar. Tekrar ayrılmayı planlayan bir kullanıcı wUSDC’ye ihtiyaç duyar; çünkü çıkış köprülemesi wUSDC’yi yakar, gas’ı değil. Kullanıcılar wUSDC olarak gelebilir ya da daha sonra gas’ın bir kısmını ile sarabilir. withdraw_to_ata.

3. Gelen transferi çalıştırın

Gelen bir transfer dört adım alır. SDK’nın /bridge alt yolu API çağrılarını şu şekilde sarar: requestQuote, registerTransfer, getTransfer ve reportStep. Onun registerTransfer (v0.4.0) hâlâ tüm teklifi gönderir; ancak canlı API bunu reddeder, bu yüzden Rome CLI’nin yaptığı gibi quoteId ile kendiniz kaydedin.

  1. Rotayı fiyatlandırın. Kaynak zinciri, varlığı, miktarı, göndericiyi ve alıcıyı gönderin. Zincirler CAIP-2 kimlikleri olarak, miktarlar ise dize biçiminde temel birim tamsayıları olarak gönderilir.

  2. Kullanıcı, ilk adımın işlemlerini döndükleri sırayla ve tam olarak döndürüldükleri şekilde imzalar. Bir CCTP transferinde bu, USDC onayı ve yakımdır. Gas rotasında kullanıcı ayrıca, yakım karmasını doldurduktan sonra, bir EIP-712 uzlaşma yetkilendirmesini de imzalar.

  3. Transferi kaydedin. Alıntının quoteId ve yakım hash’ini şu olarak gönderin: step1TxHash ile POST /v1/transfers alıntıdan itibaren 15 dakika içinde. Gas rotasında uzlaşma imzasını şu olarak ekleyin: userSettleSig. API, işlemin saklanan alıntıyla eşleştiğini kontrol eder ve bir transfer kimliği döndürür.

  4. Transferi şu olana kadar yoklayın: sonuç şudur tamamlandı, ve şunları işleyin: başarısız ve süresi doldu. Tamamlanmış bir transfer bir bozulma notu içerebilir; bu yüzden gas veya wUSDC’nin ulaştığını kullanıcıya söylemeden önce bunu kontrol edin.

Solana varışları aynı yapıyı farklı adımlarla takip eder. Kullanıcı, Rome hesabına bir SPL transferi gönderir. Gas niyetiyle, gas tokeni USDC olan bir zincirdeki USDC’nin, sarmalayıcıyı gaza dönüştürmek için kullanıcıdan bir işlem daha gerektirir. Alıntı, bir rotanın ihtiyaç duyduğu tüm imzaları listeler. İstek ve yanıt yapıları: Ana zincirden.

4. Önce CLI’den çalıştırın

Herhangi bir köprü kodu yazmadan önce, akışı CLI ile çalıştırın. rome fund USDC’yi gas olarak içeri getirir, rome bridge gas veya sarıcı niyetini alır ve rome verify --path from-home tam bir gidiş-dönüşü kanıtlar: içeri köprüle, Rome’da işlem yap, dışarı köprüle. Bu size entegrasyonunuzla karşılaştırabileceğiniz çalışan bir referans verir. Komutlar ve bayraklar: Rome CLI + MCP.

5. Çıkış yolunu yönetin

Dışarı köprüleme, gelen akışın tersine çevrilmiş hâli değildir. CCTP üzerinden USDC için kullanıcı iki adım imzalar. 1. adım, iki Rome işlemidir: köprü sözleşmesinin bu yakımın tam miktarını hareket ettirmesine izin veren bir yetki verme işlemi, ardından yakım. Transferi yakım hash’i ile kaydedin. 2. adım, talep etme işlemidir. Transferin 2. adımı hazırolarak okunduğunda, mesajı ve attestation’ı taşır ve kullanıcı bunlarla birlikte hedef zincirde receiveMessage çağırır. Talepte hiçbir şey sponsorlanmaz, bu yüzden kullanıcının orada gaza ihtiyacı vardır. Talep hash’ini API’ye bildirin (reportStep SDK’da). Çağrılar ve yapılar: Varlıkları geri çekin.

Bir Solana adresine çekimin talep adımı yoktur. USDC için bu, kullanıcının Solana hesabına çeken tek bir Rome işlemidir.

Yetki verme işlemi uygulamanız için önemlidir. Bir token hesabının yalnızca bir vekili vardır; bu nedenle köprü yetkisi, kullanıcı sarıcıya yeniden yetki verene kadar sarıcı yetkisinin yerini alır. Sonraki yatırmadan önce isEnabled olup olmadığını kontrol edin; 9. dersin öğrettiği gibi.

6. Uygulamanızı canlı tutun

Rome uç noktaları eth_subscribe desteği sunar newHeads ve logs için, HTTPS RPC ile aynı host üzerinde. ethers ile, provider.on("block") ve contract.on(event) her yerde olduğu gibi çalışır. viem ile, webSocket aktarımı Rome’un sayısal abonelik kimliklerini düşürür; bu yüzden poll: true ile watchBlocks ve watchEvent ile geçin veya anlık güncellemeler için ethers kullanın. newPendingTransactions hiç yayınlanmaz, çünkü Rome’un herkese açık mempool’u yoktur. Kod: WebSocket Abonelikleri.

Geçmişi okurken her eth_getLogs çağrısını blok aralığıyla sınırlandırın. Rome’un RPC’si yaklaşık 12.000 bloktan daha geniş bir aralığı reddeder. Solana’ya dokunan bir işlem için Via’daki "Settled in" satırı, onu kesinleştiren Solana işlemini bağlantı olarak verir ve Solana explorer’ı talimatlarını ve compute unit’lerini gösterir. Bu, transferinin nerede olduğunu soran bir kullanıcıya cevap verme yoludur. Bakın Via ve JSON-RPC Desteği.

Solgate: Solana varlıkları ve AggLayer EVM zincirleri

Testnet’te, Solgate Solana varlıklarını iki yönde de AggLayer EVM zincirlerine bağlar. SPL token kaydı izinsizdir. USDC, CCTP kullanır.

Yukarıdaki adımlar Rome Bridge API’yi kullanır. Genel bakış için One market bölümüne bakın.

Kendinizi test edin

Bir gerçek transferi tamamlayın ve gözlemleyin.

  1. Yeni bir Hadrian cüzdanını biraz gas USDC ile fonlayın, ardından daha fazla USDC’yi rome bridge ve sarıcı niyeti ile getirin. Onaylar, vault çağrıları ve çıkış yakımı için yeterli gas bırakın.

  2. Cüzdanın Hadrian üzerindeki wUSDC bakiyesini, örneğin rome call ile sarıcının balanceOf değerinde okuyun. Sarıcı niyetiyle, varış köprünün Solana işlemi olur (Circle’ın receive message işlemi); Rome işlemi olmaz, bu yüzden Hadrian explorer’da bir varış işlemi beklemeyin.

  3. Transferi API üzerinden tekrarlayın: alıntı yapın, imzalayın, kaydedin, sonra şunu yoklayın: GET /v1/transfers/{id} şu olana kadar sonuç okunur tamamlandı.

  4. Çalıştırın rome verify hadrian --path from-home ile --from (kaynak zinciriniz) ve --amount (0.2 gibi küçük bir miktar), ardından sonucu okuyun. Yaklaşık 20 dakika sürer.

Sonra şunları yanıtlayın:

  • Bir çıkış USDC yakımı hangi bakiyeden harcar ve bir kullanıcı bunu nasıl elde eder?

  • Hedef zincirdeki talebin ücretini kim öder?

Cevaplar
  • wUSDC. Gas olarak gelen USDC farklı bir bakiyedir. Kullanıcı wUSDC’yi sarıcı niyetiyle ya da gas’ın bir kısmını ile sararak elde eder. withdraw_to_ata.

  • Kullanıcı. Talep hedef zincirde bir işlemdir, bu yüzden kullanıcının orada gaza ihtiyacı vardır.

Sonraki

11. Rubicon’a gönderin

Son güncelleme

Bu yararlı oldu mu?