x402 (скоро)

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

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

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-запрос.

Материалы