Developer · Base

Verifikasi atribusi Builder Code untuk deposit USDCtoFiat.

Kode yang telah diterbitkan diterapkan pada calldata transaksi aplikasi produksi. Gunakan panduan ini untuk mengetahui jalur mana yang mengelola sufiks dan apa yang harus diverifikasi setelah transaksi.

01

Urutan atribusi

  1. 01Deploy Base Mini App ke origin HTTPS yang stabil.
  2. 02Daftarkan dan verifikasi aplikasi di Base.dev.
  3. 03Salin Builder Code asli dari pengaturan Base.dev.
  4. 04Buat dataSuffix ERC-8021 dari kode itu dengan ox/erc8021.
  5. 05Untuk jalur transaksi langsung yang Anda kelola, tambahkan satu dataSuffix yang telah dinormalisasi setelah menghapus sufiks yang ada.
  6. 06Buat deposit USDCtoFiat kecil dan verifikasi atribusi sebelum meluncurkan kampanye.
02

Tempatnya

SurfaceJalur atribusi
Base AppDokumentasi Base menyebut aplikasi terdaftar bisa menerima atribusi otomatis untuk aktivitas di dalam Base App.
Aplikasi webAdaptor web USDCtoFiat mengganti sufiks yang ada dan menambahkan kode produksi.
SDK USDCtoFiatSDK menyediakan perujuk galleonlabs miliknya sendiri. Jangan menambahkan sufiks tingkat klien kedua; kode integrator terpisah tidak didukung oleh API SDK saat ini.
KontrakTidak 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.
  • Adaptor produksi USDCtoFiat dikonfigurasi dengan Builder Code yang telah diterbitkan. Atribusi yang berhasil tetap perlu diverifikasi pada tingkat transaksi.
  • Untuk transaksi langsung melalui Viem atau Wagmi yang Anda kelola, buat satu dataSuffix dari semua kode yang dimaksud.
  • Jangan menggabungkan sufiks ERC-8021 yang terpisah. Urai dan ganti, atau gabungkan kode menjadi satu sufiks sebelum menandatangani.
  • SDK @usdctofiat/offramp sudah menyediakan atribusi Galleon Labs. SDK ini tidak menyediakan opsi penggabungan Builder Code terpisah.
04

Verifikasi

PemeriksaanSyarat lolos
Base.devJumlah transaksi onchain bertambah untuk Builder Code aplikasi.
Block explorerInput transaksi berakhir dengan marker suffix ERC-8021 dan ter-decode ke kode yang diharapkan.
Hasil USDCtoFiatDeposit yang dibuat mengembalikan depositId dan txHash, lalu muncul di deposits(address).
PeerlyticsSiklus hidup deposit dan intent dapat diperiksa setelah indexing mengejar.

Pertanyaan umum

Apakah USDCtoFiat sudah memakai Builder Code yang diterbitkan?

Ya. Adaptor produksi menambahkan Builder Code yang telah diterbitkan ke calldata deposit onchain. Verifikasikan atribusi yang berhasil di Base.dev atau penjelajah blok setelah transaksi nyata.

Apakah @usdctofiat/offramp perlu opsi Builder Code terpisah?

Tidak. SDK sudah menyediakan perujuk galleonlabs dan saat ini tidak menyediakan jalur penggabungan yang didukung untuk Builder Code terpisah. Jangan tambahkan sufiks tingkat klien kedua.

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.