For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
info@patternautomation.com
ДокументацияБаза знанийЖурнал измененийСправочник API
ДокументацияБаза знанийЖурнал измененийСправочник API
  • Начало работы
    • Добро пожаловать
    • Введение
    • Быстрый старт
  • Основные понятия
    • Ящики (инбоксы)
    • Сообщения
    • Цепочки (треды)
    • Черновики
    • Метки
    • Списки
    • Вложения
    • Pods
    • Разрешения
  • Интеграции
    • Онбординг агента
    • Skills
    • MCP
    • CLI
    • Google ADK
    • OpenClaw
    • Replit
    • x402
    • MPP
    • Интеграция с LiveKit Agents
  • Руководства
    • Отправка и получение почты
    • IMAP и SMTP
    • Мультитенантность
  • Вебхуки
    • Обзор вебхуков
    • События вебхуков
    • Настройка вебхуков
    • Проверка вебхуков
  • WebSockets
    • WebSockets
    • WebSockets — быстрый старт
  • Лучшие практики
    • Доставляемость почты
    • Идемпотентные запросы
  • Примеры
    • Событийно-ориентированный агент
    • Агент автоответа
    • Агент умной разметки
    • Sales-агент на WebSocket
    • Живые почтовые агенты
  • Ресурсы
    • Часто задаваемые вопросы
    • Извлечение ответов (Talon)
    • Сообщество
    • Поддержка
info@patternautomation.com
LogoLogo
On this page
  • Начало работы
  • X Layer
  • Базовые URL
  • Требования
  • Установка зависимостей
  • Быстрый старт
  • Как это устроено
  • Материалы
Интеграции

x402 (скоро)

Оплата за использование Agent Inbox через протокол x402

Was this page helpful?
Edit this page
Previous

MPP (скоро)

Оплата за использование Agent Inbox через Machine Payments Protocol от Stripe

Next
Built with

Начало работы

x402 — открытый платёжный протокол для оплаты прямо поверх HTTP. Подключив x402 к Agent Inbox, агенты могут оплачивать API без ручного управления ключами или подписками.

X Layer

На X Layer агенты оплачивают использование API по HTTP через x402. X Layer — сеть Ethereum L2 на Polygon CDK с высокой пропускной способностью и низкими комиссиями.

Базовые URL

Для аутентификации через x402 вместо API-ключа используйте перечисленные ниже базовые URL. Они заменяют стандартные URL Agent Inbox и ведут трафик через платёжный слой x402.

ПротоколURL
HTTPx402.api.agentinbox.space
WebSocketx402.ws.agentinbox.space

Требования

  • Криптокошелёк с USDC (EVM на Base или кошелёк Solana)
  • Установленный Node.js

Установка зависимостей

$npm install agentinbox @x402/fetch @x402/evm viem

Быстрый старт

1import { privateKeyToAccount } from "viem/accounts";
2import { x402Client } from "@x402/fetch";
3import { ExactEvmScheme } from "@x402/evm/exact/client";
4
5import { AgentinboxClient } from "agentinbox";
6
7
8// setup x402 client
9
10const PRIVATE_KEY = "0x...";
11
12const signer = privateKeyToAccount(PRIVATE_KEY);
13
14const x402 = new x402Client();
15x402.register("eip155:*", new ExactEvmScheme(signer));
16
17
18// setup Agent Inbox client
19
20export const client = new AgentinboxClient({ x402 });
21
22
23// create inbox
24
25const inboxRes = await client.inboxes.create({
26 username: `x402-${Date.now()}`,
27});
28console.log("Created inbox: ", inboxRes.inboxId);
29
30
31// subscribe to inbox
32
33const socket = await client.websockets.connect();
34console.log("Connected to websocket");
35
36socket.on("message", async (event) => {
37 if (event.type === "subscribed") {
38 console.log("Subscribed to", event.inboxIds);
39 } else if (event.type === "event" && event.eventType === "message.received") {
40 console.log("Received message from: ", event.message.from);
41 }
42});
43
44socket.sendSubscribe({
45 type: "subscribe",
46 inboxIds: [inboxRes.inboxId],
47});

Как это устроено

Если передать клиент x402 в AgentinboxClient, SDK сам ведёт переговоры об оплате для каждого запроса. При ответе 402 Payment Required клиент x402 подписывает платёж кошельком и повторяет запрос уже с платежом.

Агент получает полный API Agent Inbox (ящики, сообщения, треды, вложения) без традиционного API-ключа. Оплата — за каждый HTTP-запрос.

Материалы

  • Документация x402
  • Справочник API Agent Inbox
  • Обзор WebSockets