Geliştiriciler · Base
USDCtoFiat depozitoları için Builder Code atfını hazırlayın.
Bu bir kurulum rehberidir; USDCtoFiat için verilmiş bir Builder Code olduğu iddiası değildir. Base uygulamanız @usdctofiat/offramp ile oluşturulan onchain depozito işlemlerini atfetmeye hazır olduğunda kullanın.
01
Atıf sırası
- 1Base Mini App i stabil bir HTTPS origin e dağıtın.
- 2Uygulamayı Base.dev de kaydedin ve doğrulayın.
- 3Gerçek Builder Code u Base.dev ayarlarından kopyalayın.
- 4Bu koddan ox/erc8021 ile ERC-8021 dataSuffix üretin.
- 5dataSuffix i depozito işlemini gönderen Viem veya Wagmi istemcisine ekleyin.
- 6Kampanya başlatmadan önce küçük bir USDCtoFiat depozitosu oluşturup atfı doğrulayın.
02
Nereye ait
| Yüzey | Atıf yolu |
|---|---|
| Base App | Base dokümanları, kayıtlı uygulamaların Base App içindeki etkinlik için otomatik atıf alabileceğini söyler. |
| Web uygulaması | Base App dışındaki tarayıcı kullanımının atfedilmesi için işlem istemcisine dataSuffix ekleyin. |
| USDCtoFiat SDK | SDK, verdiğiniz wallet client ile imzalar; bu yüzden suffix o wallet-client yoluna aittir. |
| Sözleşmeler | Sözleşme değişikliği gerekmez; ERC-8021 suffix verisi calldata ya eklenir ve offchain indekslenir. |
03
Uygulama notları
- Base dokümanları yolu için viem 2.45.0 veya yenisini kullanın; bu uygulama zaten daha yeni bir viem sürümü kullanıyor.
- Placeholder Builder Codes u prodüksiyondan uzak tutun. Gerçek değeri yalnızca Base.dev verdikten sonra bağlayın.
- Viem için wallet client oluşturulurken dataSuffix ekleyin.
- Wagmi için dataSuffix i client seviyesinde yapılandırın ki sends ve batch calls bunu miras alsın.
- Privy veya smart-wallet akışları için user operation veya transaction ı gerçekten gönderen wallet/provider yolunu kullanın.
04
Doğrulama
| Kontrol | Geçme koşulu |
|---|---|
| Base.dev | Uygulamanın Builder Code u için onchain işlem sayıları artar. |
| Blok gezgini | İşlem girdisi ERC-8021 suffix işaretiyle biter ve beklenen koda decode edilir. |
| USDCtoFiat sonucu | Oluşturulan depozito depositId ve txHash döndürür, sonra deposits(address) içinde görünür. |
| Peerlytics | İndeksleme yetiştikten sonra depozito ve intent yaşam döngüsü incelenebilir. |
Keep exploring
Common questions
Şimdi placeholder Builder Code ekleyebilir miyim?
Hayır. Entegrasyonu hazır tutun ama placeholder attribution yayınlamayın. Base.dev de kayıt olun, gerçek kodu alın, sonra wallet-client yoluna ekleyin.
@usdctofiat/offramp ayrı bir Builder Code seçeneğine ihtiyaç duyar mı?
Normal uygulama yolu için hayır. SDK verdiğiniz Viem WalletClient i kullanır; bu yüzden atıf o client a veya işlemi gönderen wallet/provider katmanına eklenmelidir.
ERC-8021 ZKP2P sözleşmelerini değiştirir mi?
Hayır. Base dokümanları Builder Codes u calldata suffix attribution olarak tanımlar. Sözleşmeler normal çalışır; attribution işlem indikten sonra offchain indexers tarafından okunur.