Nhà phát triển · Base
Chuẩn bị attribution Builder Code cho deposit USDCtoFiat.
Đây là hướng dẫn thiết lập, không phải tuyên bố rằng USDCtoFiat đã có Builder Code được cấp. Dùng khi app Base của bạn sẵn sàng attribution các giao dịch deposit onchain tạo qua @usdctofiat/offramp.
01
Trình tự attribution
- 1Deploy Base Mini App lên origin HTTPS ổn định.
- 2Đăng ký và xác minh app trên Base.dev.
- 3Sao chép Builder Code thật từ cài đặt Base.dev.
- 4Tạo ERC-8021 dataSuffix từ mã đó bằng ox/erc8021.
- 5Gắn dataSuffix vào client Viem hoặc Wagmi gửi giao dịch deposit.
- 6Tạo một deposit USDCtoFiat nhỏ và xác minh attribution trước khi chạy campaign.
02
Nó thuộc về đâu
| Bề mặt | Đường dẫn attribution |
|---|---|
| Base App | Tài liệu Base nói app đã đăng ký có thể nhận attribution tự động cho hoạt động trong Base App. |
| App web | Thêm dataSuffix vào transaction client để attribution hoạt động trình duyệt ngoài Base App. |
| SDK USDCtoFiat | SDK ký bằng wallet client bạn truyền vào, vì vậy suffix thuộc về đường dẫn wallet-client đó. |
| Hợp đồng | Không cần đổi contract; dữ liệu suffix ERC-8021 được gắn vào calldata và index offchain. |
03
Ghi chú triển khai
- Dùng viem 2.45.0 hoặc mới hơn cho đường dẫn tài liệu Base; app này đã chạy phiên bản viem mới hơn.
- Không đưa Builder Codes placeholder vào production. Chỉ wire giá trị thật sau khi Base.dev cấp.
- Với Viem, thêm dataSuffix khi tạo wallet client.
- Với Wagmi, cấu hình dataSuffix ở cấp client để send và batch calls kế thừa nó.
- Với Privy hoặc smart-wallet flows, dùng đường dẫn wallet/provider thực sự submit user operation hoặc transaction.
04
Xác minh
| Kiểm tra | Điều kiện đạt |
|---|---|
| Base.dev | Số lượng giao dịch onchain tăng cho Builder Code của app. |
| Block explorer | Input giao dịch kết thúc bằng marker suffix ERC-8021 và decode ra mã kỳ vọng. |
| Kết quả USDCtoFiat | Deposit được tạo trả về depositId và txHash, rồi xuất hiện trong deposits(address). |
| Peerlytics | Có thể inspect lifecycle của deposit và intent sau khi indexing bắt kịp. |
Keep exploring
Common questions
Tôi có thể thêm Builder Code placeholder bây giờ không?
Không. Giữ integration sẵn sàng, nhưng đừng ship attribution placeholder. Đăng ký trên Base.dev, lấy mã thật, rồi thêm vào đường dẫn wallet-client.
@usdctofiat/offramp có cần option Builder Code riêng không?
Không cần cho đường dẫn app thông thường. SDK dùng Viem WalletClient bạn truyền vào, nên attribution nên gắn vào client đó hoặc lớp wallet/provider gửi giao dịch.
ERC-8021 có thay đổi contract ZKP2P không?
Không. Tài liệu Base mô tả Builder Codes là attribution bằng calldata suffix. Contract chạy bình thường; attribution được offchain indexers đọc sau khi giao dịch landed.