Подготовьте атрибуцию Builder Code для депозитов USDCtoFiat.
Это инструкция по настройке, а не утверждение, что у USDCtoFiat уже есть выданный Builder Code. Используйте ее, когда ваше Base-приложение готово атрибутировать onchain-транзакции депозитов, созданные через @usdctofiat/offramp.
Последовательность атрибуции
- 1Разверните Base Mini App на стабильном HTTPS-источнике.
- 2Зарегистрируйте и проверьте приложение на Base.dev.
- 3Скопируйте настоящий Builder Code из настроек Base.dev.
- 4Создайте ERC-8021 dataSuffix из этого кода с ox/erc8021.
- 5Добавьте dataSuffix к клиенту Viem или Wagmi, который отправляет транзакцию депозита.
- 6Создайте небольшой депозит USDCtoFiat и проверьте атрибуцию до запуска кампании.
Куда это относится
| Поверхность | Путь атрибуции |
|---|---|
| Base App | Документация Base говорит, что зарегистрированные приложения могут получать автоматическую атрибуцию активности внутри Base App. |
| Веб-приложение | Добавьте dataSuffix в клиент транзакций, чтобы браузерное использование вне Base App атрибутировалось. |
| SDK USDCtoFiat | SDK подписывает через wallet client, который вы передаете, поэтому suffix относится к этому wallet-client пути. |
| Контракты | Изменение контрактов не нужно; данные ERC-8021 suffix добавляются к calldata и индексируются offchain. |
Заметки по реализации
- Используйте viem 2.45.0 или новее для пути из документации Base; это приложение уже использует более новую версию viem.
- Не допускайте placeholder Builder Codes в продакшен. Подключайте настоящее значение только после выдачи Base.dev.
- Для Viem добавьте dataSuffix при создании wallet client.
- Для Wagmi настройте dataSuffix на уровне клиента, чтобы sends и batch calls наследовали его.
- Для Privy или smart-wallet flows используйте wallet/provider путь, который реально отправляет user operation или transaction.
Проверка
| Проверка | Условие успеха |
|---|---|
| Base.dev | Счетчики onchain-транзакций увеличиваются для Builder Code приложения. |
| Блок-эксплорер | Ввод транзакции заканчивается маркером ERC-8021 suffix и декодируется в ожидаемый код. |
| Результат USDCtoFiat | Созданный депозит возвращает depositId и txHash, затем появляется в deposits(address). |
| Peerlytics | Жизненный цикл депозита и intent можно проверить после того, как индексирование догонит. |
Keep exploring
Common questions
Можно ли добавить placeholder Builder Code сейчас?
Нет. Держите интеграцию готовой, но не публикуйте placeholder attribution. Зарегистрируйтесь на Base.dev, получите настоящий код, затем добавьте его в wallet-client путь.
Нужна ли @usdctofiat/offramp отдельная опция Builder Code?
Не для обычного пути приложения. SDK использует Viem WalletClient, который вы передаете, поэтому атрибуцию нужно прикрепить к этому клиенту или wallet/provider слою, который отправляет транзакцию.
Меняет ли ERC-8021 контракты ZKP2P?
Нет. Документация Base описывает Builder Codes как calldata suffix attribution. Контракты выполняются обычно; атрибуцию читают offchain indexers после попадания транзакции.