Подключите Blockchain0x к вашему стеку агентов.
Реальный код для каждого популярного фреймворка агентов. Отгруженный пакет, где он существует, короткий рецепт SDK, где его нет.
Выберите свой фреймворк. Где мы поставляем пакет, вы его устанавливаете; в противном случае вы оборачиваете наш SDK в родной инструмент этого фреймворка. В любом случае это тонкий слой над одним HTTP API, и вы можете пропустить это и вызвать API напрямую.
Каждая карточка открывает углубленное изучение: установка или рецепт, работающий пример агента, обработка webhook и распространенные ошибки. Три поставляются как реальные пакеты сегодня - blockchain0x-langchain и blockchain0x-crewai на PyPI, и @blockchain0x/mcp на npm. Остальные семь - это короткие рецепты по тому же SDK. Никакого вымышленного пакета.
Десять фреймворков. Три пакета, семь рецептов, одно API.
LangChain
Пакет PyPIНабор инструментов Python из пакета blockchain0x-langchain; агенты TypeScript оборачивают клиент x402
CrewAI
Пакет PyPIНабор инструментов Python от blockchain0x-crewai, такой же фабричный шаблон, как у LangChain
AutoGen
Рецепт SDKРецепт: обернуть SDK в инструмент функции AutoGen
LlamaIndex
Рецепт SDKРецепт: обернуть клиента в LlamaIndex FunctionTool
OpenAI Agents SDK
Рецепт SDKРецепт: обернуть клиента в инструмент функции OpenAI Agents SDK
Pydantic AI
Рецепт SDKРецепт: зарегистрировать инструмент Pydantic AI, который вызывает клиента
LangGraph
Рецепт SDKРецепт: узел LangGraph, который вызывает клиента x402
Semantic Kernel
Рецепт SDKРецепт: KernelFunction, оборачивающий SDK; нет адаптера NuGet или Java
Agno
Рецепт SDKРецепт: набор инструментов Agno, оборачивающий клиент Python
MCP servers
npm пакетИнструменты для кошелька для любого клиента MCP через сервер @blockchain0x/mcp
Agent Skill
Agent SkillOne 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 является источником правды; обертки фреймов существуют, чтобы сэкономить ваше время.
Каждый обертка переводит из "способа, которым ваш фреймворк определяет инструмент" в "HTTP-вызов к нашему API". Это вся работа. Python адаптеры открывают create_blockchain0x_toolset(client), который передает LangChain или CrewAI готовый набор инструментов. Фреймворк без поставленного адаптера оборачивает createX402Client(...) (Node) или клиент blockchain0x (Python) в родной инструмент этого фреймворка. Один и тот же API в любом случае.
Это важно по нескольким причинам. Во-первых, вы можете комбинировать: агент производства LangChain и экспериментальный агент CrewAI могут оба нацеливаться на один и тот же кошелек агента Blockchain0x без конфликтов. Во-вторых, вы не привязаны к выбору фреймворка через нас; смена фреймворков не требует изменений в вашем кошельке, ваших политиках расходов или вашей публичной странице. В-третьих, когда мы выпускаем новую конечную точку или новое событие вебхука, обертки фреймворка открывают это в своем следующем релизе; основной API является контрактом.
Вы можете интегрировать без нашего SDK, нашей обертки или интеграции с нашим фреймворком.
API Blockchain0x - это простой JSON по HTTPS с аутентификацией по токену. Любой HTTP-клиент на любом языке может его вызвать. Официальные SDK и обертки фреймов - это удобные слои; сырой API документирован, стабилен и намеренно достаточно мал, чтобы ручное написание против него было разумным.
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.