Перейти к основному содержимому
ИНТЕГРАЦИИ

Подключите Blockchain0x к вашему стеку агентов.

Реальный код для каждого популярного фреймворка агентов. Отгруженный пакет, где он существует, короткий рецепт SDK, где его нет.

Выберите свой фреймворк. Где мы поставляем пакет, вы его устанавливаете; в противном случае вы оборачиваете наш SDK в родной инструмент этого фреймворка. В любом случае это тонкий слой над одним HTTP API, и вы можете пропустить это и вызвать API напрямую.

Каждая карточка открывает углубленное изучение: установка или рецепт, работающий пример агента, обработка webhook и распространенные ошибки. Три поставляются как реальные пакеты сегодня - blockchain0x-langchain и blockchain0x-crewai на PyPI, и @blockchain0x/mcp на npm. Остальные семь - это короткие рецепты по тому же SDK. Никакого вымышленного пакета.

ПОДДЕРЖИВАЕМЫЕ ФРЕЙМВОРКИ

Десять фреймворков. Три пакета, семь рецептов, одно API.

LangChain logo

LangChain

Пакет PyPI

Набор инструментов Python из пакета blockchain0x-langchain; агенты TypeScript оборачивают клиент x402

Читать руководство
CrewAI logo

CrewAI

Пакет PyPI

Набор инструментов Python от blockchain0x-crewai, такой же фабричный шаблон, как у LangChain

Читать руководство
AutoGen logo

AutoGen

Рецепт SDK

Рецепт: обернуть SDK в инструмент функции AutoGen

Читать руководство
LlamaIndex logo

LlamaIndex

Рецепт SDK

Рецепт: обернуть клиента в LlamaIndex FunctionTool

Читать руководство
OpenAI Agents SDK logo

OpenAI Agents SDK

Рецепт SDK

Рецепт: обернуть клиента в инструмент функции OpenAI Agents SDK

Читать руководство
Pydantic AI logo

Pydantic AI

Рецепт SDK

Рецепт: зарегистрировать инструмент Pydantic AI, который вызывает клиента

Читать руководство
LangGraph logo

LangGraph

Рецепт SDK

Рецепт: узел LangGraph, который вызывает клиента x402

Читать руководство
S

Semantic Kernel

Рецепт SDK

Рецепт: KernelFunction, оборачивающий SDK; нет адаптера NuGet или Java

Читать руководство
A

Agno

Рецепт SDK

Рецепт: набор инструментов Agno, оборачивающий клиент Python

Читать руководство
MCP servers logo

MCP servers

npm пакет

Инструменты для кошелька для любого клиента MCP через сервер @blockchain0x/mcp

Читать руководство
A

Agent Skill

Agent Skill

One installable Agent Skill that teaches any AI agent the whole wallet integration surface; portable or via the Claude Code plugin marketplace

Читать руководство
ЧТО ВКЛЮЧАЕТ КАЖДАЯ ИНТЕГРАЦИЯ

Последовательная структура во всех фреймворках.

  • Команда установки пакета или рецепт, если пакета нет
  • Код, который можно скопировать и запустить, а не псевдокод
  • Краткий ответ на вопрос 'как добавить платежи в моего агента на {framework}'
  • FAQ entries with HowTo/FAQ schema для AI search engines
  • Ссылка на соответствующую посадочную страницу long-tail
  • Ссылка на страницу с тарифами
АРХИТЕКТУРА

Каждая интеграция является тонкой оберткой над одним и тем же API.

Интеграции Blockchain0x - это не 10 отдельных продуктов. Это 10 различных эргономичных поверхностей на основе одного HTTP API. API является источником правды; обертки фреймов существуют, чтобы сэкономить ваше время.

Диаграмма архитектуры SDK: обертки фреймворка, вызывающие единый HTTP API Blockchain0x

Каждый обертка переводит из "способа, которым ваш фреймворк определяет инструмент" в "HTTP-вызов к нашему API". Это вся работа. Python адаптеры открывают create_blockchain0x_toolset(client), который передает LangChain или CrewAI готовый набор инструментов. Фреймворк без поставленного адаптера оборачивает createX402Client(...) (Node) или клиент blockchain0x (Python) в родной инструмент этого фреймворка. Один и тот же API в любом случае.

Это важно по нескольким причинам. Во-первых, вы можете комбинировать: агент производства LangChain и экспериментальный агент CrewAI могут оба нацеливаться на один и тот же кошелек агента Blockchain0x без конфликтов. Во-вторых, вы не привязаны к выбору фреймворка через нас; смена фреймворков не требует изменений в вашем кошельке, ваших политиках расходов или вашей публичной странице. В-третьих, когда мы выпускаем новую конечную точку или новое событие вебхука, обертки фреймворка открывают это в своем следующем релизе; основной API является контрактом.

ПРОПУСТИТЬ SDK

Вы можете интегрировать без нашего SDK, нашей обертки или интеграции с нашим фреймворком.

API Blockchain0x - это простой JSON по HTTPS с аутентификацией по токену. Любой HTTP-клиент на любом языке может его вызвать. Официальные SDK и обертки фреймов - это удобные слои; сырой API документирован, стабилен и намеренно достаточно мал, чтобы ручное написание против него было разумным.

CURL - НЕТ SDK
curl -X POST https://api.blockchain0x.com/v1/payments \
  -H "Authorization: Bearer $BLOCKCHAIN0X_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId":   "<your-agent-id>",
    "to":        "0xRecipientAddress",
    "amountWei": "100000",
    "metadata":  { "reason": "Custom market analysis" }
  }'

Когда пропуск SDK имеет смысл

  • Вы находитесь на языке, который мы не поддерживаем. Go, Rust, Elixir, Ruby, PHP, Java - все они могут вызывать наш API нативно с помощью своих стандартных HTTP-библиотек. Специальные инструменты не требуются.
  • Вы на краю. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - среды, где вы предпочли бы не включать дополнительную зависимость. Сырой API работает там без изменений.
  • Вы хотите видеть точно то, что передается. Для отладки, проверки безопасности или изучения протокола, необработанная форма HTTP яснее, чем чтение исходного кода SDK.
  • У вас есть собственный уровень HTTP с повторными попытками, логированием, телеметрией. Подключение другого SDK с его собственным поведением повторных попыток конфликтует с вашей существующей инфраструктурой. Вызов сырого API как просто еще одного HTTP-эндпоинта вписывается аккуратно.

Полная документация API на docs.blockchain0x.com включает спецификацию OpenAPI, поэтому вы также можете сгенерировать своего собственного клиента на любом языке, который имеет инструмент генерации кода OpenAPI.

ВЫБОР ФРЕЙМВОРКА

Когда каждый фреймворк является правильным инструментом.

Если вы еще не выбрали фреймворк для агента, вот как мы видим компромиссы. Ни один из этих выборов не является неправильным; правильный зависит от того, что делает ваш агент и кто его поддерживает.

ФреймворкЛучший когдаИзбегайте, когда
LangChainСуществующая codebase на LangChain, сложные tool chains, широкое использование в экосистемеВы хотите минимальные зависимости; LangChain требует много
LangGraphМногошаговые stateful workflow, durable execution, human-in-the-loopПростые линейные цепочки; накладные расходы графа потеряны
CrewAIПаттерны совместной работы нескольких агентов (researcher + writer + reviewer)Циклы с одним агентом; CrewAI создан для команд
AutoGenМногоагентные conversation, паттерны group chat, инструменты MicrosoftПроизводственный высокопроизводительный; AutoGen оптимизирует для исследований
LlamaIndexАгенты с упором на RAG, документальный Q&A как основная возможностьЧистые агенты по использованию инструментов; сильные стороны LlamaIndex не используются
OpenAI Agents SDKТолько OpenAI-stacks, нужен самый чистый API для использования toolsМногопровайдерные стеки; OpenAI SDK ориентирован на OpenAI
Pydantic AIСтрогая типизация всех входов и выходов агента, Python-firstСтэки с приоритетом TypeScript; нативная типизация Python является ценностью
Semantic KernelСуществующая codebase на .NET / C# / Java, enterprise-Microsoft средаКоманды только на Python; вы платите за неиспользуемую интеграцию с MS
AgnoНативный для Python, легкий, нужен минимальный overhead абстракцийВам нужны сторонние интеграции экосистемы LangChain
MCP middlewareВы запускаете MCP server и хотите, чтобы клиенты платили за каждый вызовВы не запускаете сервер MCP (это паттерн на стороне сервера)

Два практических совета. Если вы начинаете с нуля и хотите минимизировать кривую обучения, LangChain или OpenAI Agents SDK являются наиболее безопасными вариантами по умолчанию. Если у вас уже есть фреймворк, наша интеграция для него работает нормально; не переключайтесь на другие фреймворки только для использования Blockchain0x.

ГЛУБОКИЕ РУКОВОДСТВА

Конкретные сценарии получают свою собственную страницу.

Помимо страниц интеграции, специфичных для фреймворка, мы публикуем длинные руководства по более узким вопросам: "как добавить оплату в многошаговый рабочий процесс LangGraph", "как позволить моему серверу MCP взимать плату за инструмент", "как заблокировать API, похожее на Stripe, за оплатой USDC". Они находятся по адресу /lp/{slug} и намеренно не находятся в основном навигационном меню. Их находят через поиск; каждая ссылается на соответствующую страницу интеграции.

Где их найти

Первая партия длинных руководств поставляется вместе со страницами интеграционной структуры. До тех пор наиболее конкретное контент, специфичный для сценариев, находится в документации на docs.blockchain0x.com в разделе "Руководства". Каждая страница /lp/ включает рабочий код, который вы можете запустить, и прямой CTA для обновления соответствующего агента до Pro.

ЧАСТО ЗАДАВАЕМЫЕ

Пять вопросов об интеграции, на которые стоит ответить.

Если SDK является необязательным, зачем он вообще существует?

Три причины. Во-первых, эргономика: SDK автоматически генерирует ключи идемпотентности, типизирует каждый запрос и ответ и объединяет проверку подписи вебхука, чтобы вам не пришлось писать этот код самостоятельно. Во-вторых, защита от дрейфа: когда мы добавляем конечную точку или изменяем поле, следующее обновление SDK открывает его; пользователи сырого HTTP должны читать журнал изменений. В-третьих, инструментирование: SDK автоматически создает структурированные журналы и метрики в формате, совместимом с общими стековыми системами наблюдаемости. Ничто из этого не является обязательным, но они экономят 30-90 минут времени интеграции. Если вы предпочитаете видеть сырую форму API, пропустите SDK и используйте curl или любой HTTP-клиент.

Я использую фреймворк, который вы не перечисляете. Могу ли я все еще интегрироваться?

Да. Каждая интеграция основана на одном и том же небольшом REST API: агенты, платежи, запросы на оплату, транзакции, вебхуки, а также разрешения на расходы только для чтения. Аутентификация осуществляется с помощью токена доступа, вебхуки подписаны с помощью HMAC-SHA256. Если вы можете говорить на HTTP, вы можете интегрироваться из любого фреймворка, включая те, у которых нет поставляемой обертки - вы просто оборачиваете наш SDK в инструмент этого фреймворка. Страницы фреймворков существуют для удобства, а не для ограничения доступа. Хотите официальный адаптер для вашего фреймворка? Сообщите нам через документацию, и мы оценим это в зависимости от спроса.

Может ли один агент обслуживаться несколькими интеграциями фреймворка одновременно?

Да. У одного агента есть один адрес кошелька, один набор API-ключей, одна политика расходов и одна публичная страница. Разные части вашего стека могут вызывать наш API через различные интеграции фреймворка: агент LangChain в производстве, эксперимент CrewAI, промежуточное ПО сервера MCP, все платят одному и тому же агенту или все взимают плату через одного и того же агента. Граница фреймворка находится на вашей стороне; мы просто видим аутентифицированные API-запросы и подписки на вебхуки.

Стоят ли интеграции с фреймворками дополнительно?

Нет. Поставляемые адаптеры - blockchain0x-langchain и blockchain0x-crewai на PyPI, а также сервер @blockchain0x/mcp на npm - бесплатны, как и SDK. Для каждого другого фреймворка нет дополнительного пакета для покупки: вы оборачиваете SDK самостоятельно за несколько строк. Ваши расходы - это подписка на агента плюс транзакционные сборы, которые вы бы заплатили в любом случае. Установка пакета LangChain стоит столько же, сколько вызов API с помощью curl. Пакет экономит время, он не ограничивает функции.

Как быстро вы обновляете интеграции, когда фреймворки выпускают критические изменения?

Для поставленных адаптеров (blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp) мы отслеживаем фреймворки, которые люди действительно используют, и обновляем их, когда выходит новая основная версия; мы на раннем этапе и пока не обещаем фиксированный SLA. Минорные версии обычно не требуют изменений, потому что адаптеры оборачивают стабильные интерфейсы. Рецептурные фреймворки едва ли меняются здесь: они вызывают SDK напрямую, поэтому обновление фреймворка редко затрагивает нашу поверхность. Если разрушительное изменение делает адаптер небезопасным, мы указываем это на соответствующей странице /integrations/ перед тем, как прекратить поддержку.

Подключите его, начните получать оплату.

Бесплатно для начала. Пять минут до вашего первого запроса на оплату.