Ваш агент может оплачивать API с платной подпиской, данные и инструменты MCP в USDC через x402. Вот как MetaMask Agent Wallet проверяет, одобряет и подписывает каждый платеж.
- MetaMask
- Почему агенты платят за каждый вызов вместо хранения ключей API
- Анатомия интерфейса x402
- 1. Пополните баланс USDC в сети, которую запрашивает сервис
- 2. Проверьте предложение перед оплатой
- 3. Установите подтверждение для каждого платежа по умолчанию
- 4. Узнайте, что проверяет Режим защиты (Guard Mode) при оплате через x402
- 5. Выберите один вариант, если сервер предлагает несколько
- 6. Убедитесь, что предложение может быть подписано Agent Wallet
- 7. Не повторяйте платеж вслепую
- 8. Оплачивайте также инструменты MCP и эндпоинты POST
- Что покупают агенты через x402
- Чего Agent Wallet не делает для x402
Когда API, лента данных или инструмент MCP отвечают вашему агенту ошибкой 402 Payment Required, MetaMask Agent Wallet может оплатить ее в USDC без какой-либо регистрации или использования ключа API. Агент считывает предложение сервера, показывает вам актив, сумму, сеть и получателя, а после вашего одобрения подписывает разовую авторизацию платежа. Закрытый ключ остается в кошельке. Запрос на подпись также проходит проверку на угрозы со стороны сервиса кошелька.
Отказ от ответственности: Данное руководство носит исключительно образовательный характер. Оно не является финансовой рекомендацией, предложением услуг или материалом для аудитории Великобритании. Криптоплатежи, совершаемые ИИ-агентами, связаны с рисками и подходят не всем пользователям.
Это операционное руководство по оплате через x402 с помощью Agent Wallet. О том, что такое x402, как работает рукопожатие 402 и кто управляет протоколом, читайте в разделе что такое x402. Разработчики, внедряющие платежи x402 на основе делегирования в свои приложения, должны начать с Smart Accounts Kit x402 guides. Если Agent Wallet еще не настроен, начните с руководства по быстрому старту.
Почему агенты платят за каждый вызов вместо хранения ключей API
Платный API обычно означает создание аккаунта и долгосрочного ключа API. Для ИИ-агента этот ключ должен храниться там, где агент может его прочитать, что делает его уязвимой целью. В исследовании, опубликованном 5 февраля 2026 года, компания Snyk просканировала 3 984 навыка на маркетплейсе ClawHub и found 283 skills (about 7.1%), которые передавали ключи API, пароли или номера карт через контекстное окно модели или в файлы памяти в виде простого текста, откуда их можно извлечь с помощью инъекции промпта.
x402 устраняет постоянный секрет. Агент платит за каждый запрос подписанной авторизацией на точную сумму для конкретного получателя, действительной в течение короткого окна времени. В случае с Agent Wallet эта подпись поступает от сервиса кошелька через mm wallet sign-typed-data, поэтому агент никогда не работает с закрытым ключом или ключом API. Каждая авторизация содержит случайный одноразовый номер (nonce), поэтому ее нельзя обработать дважды. Более подробный обзор того, что x402 меняет в сфере коммерции для агентов, включая агентов, которые продают услуги другим агентам, появится в следующей статье.
Анатомия интерфейса x402
Поддержка x402 поставляется в виде вспомогательного скрипта Python внутри навыка metamask-agent-wallet, а не в качестве подкоманды mm. Ваш агент вызывает его, когда запрос возвращает код 402. Обычно вы просто просите об этом простым языком («Получи премиальные данные по этому URL и оплати, если вернется 402»), и агент выполняет эти шаги за вас.
Шаг
Команда (выполняется агентом)
Что она делает
Тратит средства
Проверить HTTP 402
x402_pay.py inspect
Считывает предложение сервера: актив, сумму, сеть, получателя, ресурс
Оплатить HTTP 402
x402_pay.py pay --confirm
Подписывает авторизацию, повторяет запрос, возвращает хэш расчета и ответ
Да
Проверить платный инструмент MCP
x402_pay.py mcp-inspect --challenge
Считывает платежный запрос, возвращенный платным инструментом MCP
Подписать для платного инструмента MCP
x402_pay.py mcp-sign --challenge --confirm
Подписывает авторизацию и выдает полезную нагрузку для повторного вызова инструмента
Да
Выбрать между предложениями
--asset или --network
Выбирает один вариант, когда сервер предлагает несколько
н/д
Оплатить эндпоинт, отличный от GET
--method POST --data ''
Повторяет тот же запрос с прикрепленным платежом
н/д
Полная справочная информация содержится в x402 payments guide и в x402 reference навыка.
Учитывая этот рабочий процесс, вот 9 советов по проведению платежей x402 через Agent Wallet.
1. Пополните баланс USDC в сети, которую запрашивает сервис
Сервер сам определяет, какие активы и сети он принимает. Агент может оплатить только тот вариант, который предлагает сервер.
Agent Wallet оплачивает только предложения EVM в сетях, которые перечислены в mm chains list. Балансы ведутся отдельно для каждой цепи, поэтому USDC в Ethereum не покроет предложение в Base. Если у вас есть средства в USDC в другой сети, вы также можете попросить агента перевести средства в нужную сеть. Сам платеж представляет собой не требующую газа авторизацию вне блокчейна. Фасилитатор сервиса производит расчеты в блокчейне, поэтому вашему кошельку не нужны нативные токены для покрытия сетевых комиссий за платеж.
2. Проверьте предложение перед оплатой
inspect считывает ошибку 402 без подписания или списания средств. Команда возвращает актив, удобочитаемую сумму, сеть, получателя payTo и ресурс. Навык указывает агенту показать вам эти детали и дождаться вашего одобрения перед запуском pay, а pay отказывается работать без флага --confirm.
Перед подписанием чего-либо выполняется несколько проверок. URL-адрес ресурса должен начинаться с https://. Скрипт не следует за редиректами, поэтому перенаправление между хостами не может перенаправить платеж на сервер, который вы не выбирали. Сумма должна быть положительным целым числом в наименьших единицах токена, а получатель и актив должны быть действительными адресами. В рамках конкретной схемы подписанная сумма равна предложенной. Это не лимит, до которого сервер может производить списания.
3. Установите подтверждение для каждого платежа по умолчанию
Навык Agent Wallet может давать агенту указание по умолчанию согласовывать с вами актив, сумму, сеть, получателя и ресурс перед каждым платежом x402. Подтверждение происходит в вашем диалоге с агентом. Оно отличается от 2FA, которую сервис кошелька запускает только тогда, когда запрос помечен как подозрительный или выходит за рамки вашей политики.
Это подходит для агента, который покупает исследовательский отчет, несколько запросов данных или подарочную карту в течение сеанса. Это плохо подходит для цикла, который вызывает платный эндпоинт каждые несколько секунд, поскольку каждый вызов ожидает вашего ответа. Многоэтапная покупка, предполагающая списания на нескольких шагах, будет запрашивать подтверждение на каждом из них.
4. Узнайте, что проверяет Режим защиты (Guard Mode) при оплате через x402
В режиме серверного кошелька каждый запрос на подпись отправляется в сервис кошелька, который выполняет сканирование на наличие угроз перед подписанием. Помеченный запрос приостанавливается в статусе AWAITING_MFA до тех пор, пока вы его не одобряете. Авторизации x402 имеют короткое окно действия, установленное сервером. Если Режим защиты приостанавливает подпись для 2FA, и вы одобряете ее после закрытия этого окна, срок действия авторизации истекает без использования. Попросите агента повторно запустить pay, что позволит получить свежий ответ 402 и подписать новые значения. Одобрения приходят туда, куда настроен метод входа: ссылка электронной почты для входа через Google или почту, либо меню уведомлений в MetaMask Mobile для входа по QR-коду.
Лимит исходящих переводов за скользящие 24 часа здесь работает иначе. Политика исходящих переводов отслеживает токен-переводы, свапы и депозиты, и по состоянию на 27 октября 2026 года в ней указано, что подписи (например, Permit2) не учитываются при расчете исходящих средств. Авторизация x402 является подписью, поэтому 24-часовой лимит не является надежным ограничением для трат по x402. Этап подтверждения зависит от того, следует ли агент навыку, а жестким потолком выступает баланс токенов в кошельке для оплаты. Один из способов ограничить риски — завести отдельный кошелек, пополняемый только для платных вызовов API. Команды mm wallet create и mm wallet select управляют несколькими кошельками.
5. Выберите один вариант, если сервер предлагает несколько
Когда статус 402 указывает одну и ту же схему для нескольких поддерживаемых сетей или активов, скрипт останавливается с ошибкой «несколько подходящих вариантов» вместо того, чтобы выбирать за вас. С этим может столкнуться сервис, принимающий USDC как в сети Base, так и в Monad. Перезапустите команду с флагом --network (например, eip155:8453 для Base) или --asset с указанием контракта токена. Сообщите агенту, в какую сеть вы внесли средства, и он сможет передать нужный флаг с первой попытки.
6. Проверьте, что предложение поддерживается для подписи Agent Wallet
Вспомогательный инструмент подписывает точную схему с помощью EIP-3009 transferWithAuthorization в сетях EVM для протокола x402 версий 1 и 2. Он возвращает понятную ошибку и ничего не подписывает, если обнаруживает:
Предложение
Причина отклонения
Метод перевода только для активов Permit2
Инструмент подписывает только EIP-3009
Схемы upto или другие
Поддерживаются только точные значения (exact)
Solana или другие не-EVM сети
Только EVM-сети из списка цепочек mm
Отсутствует доменное имя и версия EIP-712
Инструмент не будет угадывать домен подписи
Ответ 402, не являющийся стандартным запросом x402
Схемы «сначала оплата — затем отправка хэша» не являются x402
Если сервис предлагает и Permit2, и EIP-3009 для одного и того же актива, используется вариант EIP-3009. На странице устранения неполадок перечислены все ошибки.
7. Не повторяйте платеж вслепую
Скрипт не хранит историю прошлых платежей. Нонс (nonce) EIP-3009 предотвращает повторное проведение одной и той же подписанной авторизации, но каждый новый платежный прогон создает новый платеж. Если команда pay возвращает сообщение «платеж не принят», проверьте результат взаиморасчетов и не истекло ли окно авторизации, прежде чем пытаться снова. Второй запуск для того же ресурса означает вторую плату, и предписывает вызывающим сторонам защищаться от повторных вызовов.
8. Оплачивайте также MCP-инструменты и POST-эндпоинты
Протокол x402 не ограничивается GET-запросами. Передайте флаги --method и --data, и вспомогательный инструмент повторит тот же тело запроса с прикрепленным платежом, благодаря чему платный POST (например, эндпоинт генерации ответов ИИ-чата) работает как платная загрузка.
Платные MCP-инструменты используют транспорт MCP из x402 v2. Неоплаченный вызов инструмента возвращает ошибку, содержащую платежный запрос. Агент запускает mcp-inspect, показывает вам предложение, запускает mcp-sign --confirm после вашего одобрения и повторяет вызов инструмента с подписанным полезным грузом в _meta["x402/payment"]. Скрипт подписывает данные, но не поддерживает протокол MCP, поэтому повторную попытку выполняет собственная сессия MCP агента. Если повторный запрос возвращает новый запрос на оплату, платеж не прошел, и агент сообщает об этом вам вместо того, чтобы подписывать заново.
Что агенты покупают через x402
Одно из применений — платные данные: торговый агент может получить сигналы или провести исследование перед совершением действия, а затем передать управление свапам или бессрочным фьючерсам для исполнения. Несколько сервисов, принимающих x402, с деталями из их собственной документации по состоянию на 27 октября 2026 года:
Сервис
Что может купить агент
Ценообразование x402
Платежные сети
Ончейн-аналитика: профили кошельков, скринеры токенов, потоки Smart Money
$0.01 за вызов (базовый), $0.05 (премиум и Smart Money)
USDC в Base, Monad (только x402 v2)
Рыночные данные, сетевые метрики, фандрейзинг, новости, сигналы, разлоки токенов, Messari AI
$0.00–$1.00 за запрос в зависимости от эндпоинта
USDC в Base
Подарочные карты, пополнение мобильного счета и eSIM в более чем 180 странах
Цена продукта
USDC через x402 и другие методы
Каждый сервис устанавливает собственный формат предложений, поэтому попросите агента сначала запустить осмотр (inspect), чтобы подтвердить, что предложение может быть подписано Agent Wallet (совет 6). Эндпоинты Nansen x402, например, принимают POST-запросы и поддерживают только x402 v2. Пример запроса: «Получи чистые потоки Smart Money от Nansen для Ethereum. Если вернется 402, покажи мне стоимость и оплати после моего подтверждения». Для поиска дополнительных сервисов x402 используйте , который представляет собой проводник по экосистеме x402.
Чего Agent Wallet не делает для x402
- Не ограничивает траты по x402 с помощью лимита исходящих переводов. Политика исходящих переводов пока исключает подписи из 24-часового расчета.
Не ограничивает траты по x402 с помощью лимита исходящих переводов. Политика исходящих переводов пока исключает подписи из 24-часового расчета.
- Не подписывает каждое предложение x402. Предложения только для Permit2, с лимитом upto и для не-EVM сетей отклоняются.
Не подписывает каждое предложение x402. Предложения только для Permit2, с лимитом upto и для не-EVM сетей отклоняются.
- Не дедуплицирует платежи. Реестра платежей пока нет. Повторный запуск оплаты приводит к повторному списанию средств.
Не дедуплицирует платежи. Реестра платежей пока нет. Повторный запуск оплаты приводит к повторному списанию средств.
- Не продает через x402. Вспомогательный инструмент работает только на стороне покупателя. Размещение платного эндпоинта для других агентов требует отдельной настройки.
Не продает через x402. Вспомогательный инструмент работает только на стороне покупателя. Размещение платного эндпоинта для других агентов требует отдельной настройки.
- Не запускается как команда mm. Это скрипт на Python 3 в составе навыка. Он всегда выводит JSON, поэтому флаги --toon и --format не применяются.
Не запускается как команда mm. Это скрипт на Python 3 в составе навыка. Он всегда выводит JSON, поэтому флаги --toon и --format не применяются.
Часто задаваемые вопросы по x402 и MetaMask Agent Wallet
- Да. При установленном навыке metamask-agent-wallet и доступном Python 3 агент обнаруживает ошибку 402, показывает вам предложение и подписывает платежную авторизацию EIP-3009 с помощью команды mm wallet sign-typed-data после вашего одобрения. Это работает как для HTTP-эндпоинтов, так и для платных MCP-инструментов.
Да. При установленном навыке metamask-agent-wallet и доступном Python 3 агент обнаруживает ошибку 402, показывает вам предложение и подписывает платежную авторизацию EIP-3009 с помощью команды mm wallet sign-typed-data после вашего одобрения. Это работает как для HTTP-эндпоинтов, так и для платных MCP-инструментов.
- Не для самого платежа. Кошелек подписывает оффчейн-авторизацию, а фасилитатор сервиса отправляет ончейн-расчет. Вам потребуется достаточное количество запрашиваемого токена (обычно USDC) в той сети, которую запрашивает сервис.
Не для самого платежа. Кошелек подписывает оффчейн-авторизацию, а фасилитатор сервиса отправляет ончейн-расчет. Вам потребуется достаточное количество запрашиваемого токена (обычно USDC) в той сети, которую запрашивает сервис.
- По состоянию на 27 октября 2026 года политика исходящих переводов гласит, что подписи, такие как Permit2, не включаются в расчет исходящих средств, а авторизация x402 является подписью. Сервис кошелька по-прежнему выполняет сканирование на угрозы для запроса на подпись, а навык заставляет агента запрашивать ваше подтверждение для каждого платежа.
По состоянию на 27 октября 2026 года политика исходящих переводов гласит, что подписи, такие как Permit2, не включаются в расчет исходящих средств, а авторизация x402 является подписью. Сервис кошелька по-прежнему выполняет сканирование на угрозы для запроса на подпись, а навык заставляет агента запрашивать ваше подтверждение для каждого платежа.
- Настроить Agent Wallet таким образом возможно. По умолчанию навык инструктирует агента получать ваше подтверждение для каждого платежа x402.
Agent Wallet можно настроить таким образом. По умолчанию навык инструктирует агента запрашивать ваше подтверждение для каждого платежа x402.
- Если срок действия авторизации истек в ожидании 2FA, перезапустите pay для подписания свежих значений. Если сервер отклонил платеж, проверьте вывод расчетов перед повторной попыткой, так как каждый запуск pay представляет собой новый платеж.
Если срок действия авторизации истек в ожидании 2FA, перезапустите pay для подписания свежих значений. Если сервер отклонил платеж, проверьте вывод расчетов перед повторной попыткой, так как каждый запуск pay представляет собой новый платеж.
- Agent Wallet предназначен для запущенного вами ИИ-агента, который платит из собственного кошелька с помощью интерфейса командной строки mm и навыка. Smart Accounts Kit создан для разработчиков, внедряющих платежи x402 в собственные приложения с использованием делегирований ERC-7710, включая регулярные бюджеты.
Agent Wallet предназначен для запущенного вами ИИ-агента, который платит из собственного кошелька с помощью интерфейса командной строки mm и навыка. Smart Accounts Kit создан для разработчиков, внедряющих платежи x402 в собственные приложения с использованием делегирований ERC-7710, включая регулярные бюджеты.
Автор этой статьи:
- MetaMaskMetaMask, ранее Consensys Software Inc, — крупнейшая в мире платформа для самостоятельного хранения финансовых средств, предоставляющая людям единое пространство для хранения, трат, сбережений и приумножения денег как в криптовалюте, так и в традиционных активах. Компания создает потребительскую платформу, объединяющую платежи, сбережения, инвестиции и цифровые активы в единый бесшовный опыт. Выросший из самого популярного в мире кошелька с самостоятельным хранением, MetaMask дает пользователям прямой контроль над их деньгами и активами примерно в 190 странах. MetaMask играет фундаментальную роль в росте Ethereum с 2016 года. Сегодня MetaMask находится в центре блокчейн-экономики, создавая операционную систему для Open Money и предоставляя людям полный контроль над их финансовой жизнью.Читать все статьи
MetaMask, ранее Consensys Software Inc, — крупнейшая в мире платформа для самостоятельного хранения финансовых средств, предоставляющая людям единое пространство для хранения, трат, сбережений и приумножения денег как в криптовалюте, так и в традиционных активах. Компания создает потребительскую платформу, объединяющую платежи, сбережения, инвестиции и цифровые активы в единый бесшовный опыт. Выросший из самого популярного в мире кошелька с самостоятельным хранением, MetaMask дает пользователям прямой контроль над их деньгами и активами примерно в 190 странах. MetaMask играет фундаментальную роль в росте Ethereum с 2016 года. Сегодня MetaMask находится в центре блокчейн-экономики, создавая операционную систему для Open Money и предоставляя людям полный контроль над их финансовой жизнью.
- РУКОВОДСТВАЧто такое виртуальная машина Ethereum?EVM — это программное обеспечение, которое запускает каждый нод Ethereum для выполнения смарт-контрактов. Узнайте, как она работает, для чего нужен газ и почему один адрес 0x работает в разных сетях, совместимых с EVM.
Что такое виртуальная машина Ethereum?
EVM — это программное обеспечение, которое запускает каждый нод Ethereum для выполнения смарт-контрактов. Узнайте, как она работает, для чего нужен газ и почему один адрес 0x работает в разных сетях, совместимых с EVM.
- РУКОВОДСТВАПонимание типов ордеров: рыночный, лимитный, стоп-лосс и тейк-профитРыночные ордера влекут за собой проскальзывание. Лимитные ордера рискуют остаться неисполненными. Стоп-лоссы могут срабатывать на временных теневых свечах. Каждый тип ордера имеет механический компромисс — вот как они работают.
Понимание типов ордеров: рыночный, лимитный, стоп-лосс и тейк-профит
Рыночные ордера влекут за собой проскальзывание. Лимитные ордера рискуют остаться неисполненными. Стоп-лоссы могут срабатывать на временных теневых свечах. Каждый тип ордера имеет механический компромисс — вот как они работают.
- РУКОВОДСТВАПопулярные криптовалюты в 2026 годуОзнакомьтесь с ведущими криптовалютами 2026 года по рыночной капитализации, объему торгов и использованию: USDT, BTC, ETH, USDC, XRP, SOL, BNB, TRX и другие.
Популярные криптовалюты в 2026 году
Ознакомьтесь с ведущими криптовалютами 2026 года по рыночной капитализации, объему торгов и использованию: USDT, BTC, ETH, USDC, XRP, SOL, BNB, TRX и другие.
