Developer · Base
Siapkan atribusi Builder Code untuk deposit USDCtoFiat.
Ini panduan setup, bukan klaim bahwa USDCtoFiat sudah memiliki Builder Code yang diterbitkan. Gunakan saat aplikasi Base Anda siap mengatribusi transaksi deposit onchain yang dibuat melalui @usdctofiat/offramp.
01
Urutan atribusi
- 1Deploy Base Mini App ke origin HTTPS yang stabil.
- 2Daftarkan dan verifikasi aplikasi di Base.dev.
- 3Salin Builder Code asli dari pengaturan Base.dev.
- 4Buat dataSuffix ERC-8021 dari kode itu dengan ox/erc8021.
- 5Lampirkan dataSuffix ke klien Viem atau Wagmi yang mengirim transaksi deposit.
- 6Buat deposit USDCtoFiat kecil dan verifikasi atribusi sebelum meluncurkan kampanye.
02
Tempatnya
| Surface | Jalur atribusi |
|---|---|
| Base App | Dokumentasi Base menyebut aplikasi terdaftar bisa menerima atribusi otomatis untuk aktivitas di dalam Base App. |
| Aplikasi web | Tambahkan dataSuffix ke klien transaksi agar penggunaan browser di luar Base App teratribusi. |
| SDK USDCtoFiat | SDK menandatangani dengan wallet client yang Anda berikan, jadi suffix berada di jalur wallet-client itu. |
| Kontrak | Tidak perlu perubahan kontrak; data suffix ERC-8021 ditambahkan ke calldata dan diindeks offchain. |
03
Catatan implementasi
- Gunakan viem 2.45.0 atau lebih baru untuk jalur dokumentasi Base; app ini sudah memakai versi viem yang lebih baru.
- Jangan gunakan Builder Codes placeholder di produksi. Hubungkan nilai asli hanya setelah Base.dev menerbitkannya.
- Untuk Viem, tambahkan dataSuffix saat wallet client dibuat.
- Untuk Wagmi, konfigurasikan dataSuffix di level klien agar send dan batch calls mewarisinya.
- Untuk Privy atau smart-wallet flow, gunakan jalur wallet/provider yang benar-benar mengirim user operation atau transaksi.
04
Verifikasi
| Pemeriksaan | Syarat lolos |
|---|---|
| Base.dev | Jumlah transaksi onchain bertambah untuk Builder Code aplikasi. |
| Block explorer | Input transaksi berakhir dengan marker suffix ERC-8021 dan ter-decode ke kode yang diharapkan. |
| Hasil USDCtoFiat | Deposit yang dibuat mengembalikan depositId dan txHash, lalu muncul di deposits(address). |
| Peerlytics | Siklus hidup deposit dan intent dapat diperiksa setelah indexing mengejar. |
Keep exploring
Common questions
Bisakah saya menambahkan Builder Code placeholder sekarang?
Tidak. Siapkan integrasinya, tetapi jangan kirim atribusi placeholder. Daftar di Base.dev, dapatkan kode asli, lalu tambahkan ke jalur wallet-client.
Apakah @usdctofiat/offramp perlu opsi Builder Code terpisah?
Tidak untuk jalur app normal. SDK memakai Viem WalletClient yang Anda berikan, jadi atribusi harus ditempelkan ke client itu atau lapisan wallet/provider yang mengirim transaksi.
Apakah ERC-8021 mengubah kontrak ZKP2P?
Tidak. Dokumentasi Base menjelaskan Builder Codes sebagai atribusi suffix calldata. Kontrak berjalan normal; atribusi dibaca oleh indexer offchain setelah transaksi masuk.