Nhà phát triển · Base

Xác minh cơ chế ghi nhận Builder Code cho khoản nạp USDCtoFiat.

Mã đã được cấp được gắn vào calldata giao dịch của ứng dụng production. Hãy dùng hướng dẫn này để biết luồng nào quản lý hậu tố và cần xác minh điều gì sau giao dịch.

Bắt đầu từ template BaseMở luồng bán
01

Trình tự attribution

  1. 01Deploy Base Mini App lên origin HTTPS ổn định.
  2. 02Đăng ký và xác minh app trên Base.dev.
  3. 03Sao chép Builder Code thật từ cài đặt Base.dev.
  4. 04Tạo ERC-8021 dataSuffix từ mã đó bằng ox/erc8021.
  5. 05Với luồng giao dịch trực tiếp do bạn quản lý, hãy xóa mọi hậu tố hiện có rồi thêm một dataSuffix đã chuẩn hóa.
  6. 06Tạ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 AppTài liệu Base nói app đã đăng ký có thể nhận attribution tự động cho hoạt động trong Base App.
App webBộ điều hợp web USDCtoFiat thay thế mọi hậu tố hiện có và thêm các mã production.
SDK USDCtoFiatSDK cung cấp mã giới thiệu galleonlabs riêng. Không thêm hậu tố thứ hai ở phía máy khách; API SDK hiện tại không hỗ trợ mã riêng cho bên tích hợp.
Hợp đồngKhô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.
  • Bộ điều hợp production của USDCtoFiat đã được thiết lập với Builder Code được cấp. Vẫn cần xác minh cơ chế ghi nhận ở cấp độ giao dịch.
  • Với giao dịch Viem hoặc Wagmi trực tiếp do bạn quản lý, hãy tạo một dataSuffix từ tất cả mã cần dùng.
  • Không nối các hậu tố ERC-8021 độc lập. Trước khi ký, hãy phân tích rồi thay thế hoặc hợp nhất các mã thành một hậu tố.
  • SDK @usdctofiat/offramp đã cung cấp cơ chế ghi nhận Galleon Labs. SDK không cung cấp tùy chọn hợp nhất Builder Code riêng.
04

Xác minh

Kiểm traĐiều kiện đạt
Base.devSố lượng giao dịch onchain tăng cho Builder Code của app.
Block explorerInput giao dịch kết thúc bằng marker suffix ERC-8021 và decode ra mã kỳ vọng.
Kết quả USDCtoFiatDeposit được tạo trả về depositId và txHash, rồi xuất hiện trong deposits(address).
PeerlyticsCó thể inspect lifecycle của deposit và intent sau khi indexing bắt kịp.

Tiếp tục khám phá

Đường dốc SDKAPI PeerlyticsTrung tâm nhà phát triển

Câu hỏi thường gặp

USDCtoFiat đã dùng Builder Code được cấp chưa?

Có. Bộ điều hợp production thêm Builder Code đã được cấp vào calldata nạp tiền onchain. Sau một giao dịch thực, hãy xác minh cơ chế ghi nhận đã thành công trong Base.dev hoặc trình khám phá khối.

@usdctofiat/offramp có cần option Builder Code riêng không?

Không. SDK đã cung cấp mã giới thiệu galleonlabs và hiện không có luồng hợp nhất được hỗ trợ cho một Builder Code riêng. Không thêm hậu tố thứ hai ở phía máy khá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.