Разработчики · Base

Проверьте атрибуцию Builder Code для депозитов USDCtoFiat.

Выданный код добавляется в calldata транзакций рабочего приложения. В этом руководстве указано, какой путь управляет суффиксом и что нужно проверить после транзакции.

Начать с шаблона BaseОткрыть поток продажи
01

Последовательность атрибуции

  1. 01Разверните Base Mini App на стабильном HTTPS-источнике.
  2. 02Зарегистрируйте и проверьте приложение на Base.dev.
  3. 03Скопируйте настоящий Builder Code из настроек Base.dev.
  4. 04Создайте ERC-8021 dataSuffix из этого кода с ox/erc8021.
  5. 05Для прямого пути транзакции, которым вы управляете, удалите существующий суффикс и добавьте один нормализованный dataSuffix.
  6. 06Создайте небольшой депозит USDCtoFiat и проверьте атрибуцию до запуска кампании.
02

Куда это относится

ПоверхностьПуть атрибуции
Base AppДокументация Base говорит, что зарегистрированные приложения могут получать автоматическую атрибуцию активности внутри Base App.
Веб-приложениеВеб-адаптер USDCtoFiat заменяет существующий суффикс и добавляет рабочие коды.
SDK USDCtoFiatSDK добавляет собственный реферер galleonlabs. Не добавляйте второй суффикс на уровне клиента: текущий API SDK не поддерживает отдельные коды интеграторов.
КонтрактыИзменение контрактов не нужно; данные ERC-8021 suffix добавляются к calldata и индексируются offchain.
03

Заметки по реализации

  • Используйте viem 2.45.0 или новее для пути из документации Base; это приложение уже использует более новую версию viem.
  • Рабочий адаптер USDCtoFiat настроен с выданным Builder Code. Успешную атрибуцию всё равно необходимо проверять на уровне транзакции.
  • Для прямых транзакций через Viem или Wagmi, которыми вы управляете, создайте один dataSuffix из всех нужных кодов.
  • Не объединяйте независимые суффиксы ERC-8021 конкатенацией. Перед подписанием разберите и замените суффикс либо объедините коды в один суффикс.
  • SDK @usdctofiat/offramp уже добавляет атрибуцию Galleon Labs. В нём нет отдельной возможности объединения с Builder Code.
04

Проверка

ПроверкаУсловие успеха
Base.devСчетчики onchain-транзакций увеличиваются для Builder Code приложения.
Блок-эксплорерВвод транзакции заканчивается маркером ERC-8021 suffix и декодируется в ожидаемый код.
Результат USDCtoFiatСозданный депозит возвращает depositId и txHash, затем появляется в deposits(address).
PeerlyticsЖизненный цикл депозита и intent можно проверить после того, как индексирование догонит.

Продолжайте исследовать

Выезд SDKPeerlytics APIЦентр разработчиков

Общие вопросы

USDCtoFiat уже использует выданный Builder Code?

Да. Рабочий адаптер добавляет выданный Builder Code в calldata onchain-депозита. После реальной транзакции проверьте успешную атрибуцию в Base.dev или обозревателе блоков.

Нужна ли @usdctofiat/offramp отдельная опция Builder Code?

Нет. SDK уже добавляет реферер galleonlabs и сейчас не предоставляет поддерживаемого пути объединения с отдельным Builder Code. Не добавляйте второй суффикс на уровне клиента.

Меняет ли ERC-8021 контракты ZKP2P?

Нет. Документация Base описывает Builder Codes как calldata suffix attribution. Контракты выполняются обычно; атрибуцию читают offchain indexers после попадания транзакции.