주 콘텐츠로 건너뛰기
통합

Blockchain0x를 에이전트 스택에 연결하세요.

모든 인기 있는 에이전트 프레임워크에 대한 실제 코드. 존재하는 경우 배송된 패키지, 존재하지 않는 경우 짧은 SDK 레시피.

프레임워크를 선택하세요. 우리가 패키지를 발송하는 곳에서는 설치합니다; 그렇지 않으면 해당 프레임워크의 기본 도구에 우리의 SDK를 감쌉니다. 어느 쪽이든 하나의 HTTP API 위에 얇은 레이어가 있으며, 이를 건너뛰고 API를 직접 호출할 수 있습니다.

각 카드는 심층 분석을 엽니다: 설치 또는 레시피, 작동하는 에이전트 예제, 웹후크 처리 및 일반적인 함정. 오늘날 세 가지는 실제 패키지로 제공됩니다 - blockchain0x-langchain 및 blockchain0x-crewai는 PyPI에, @blockchain0x/mcp는 npm에 있습니다. 나머지 일곱은 동일한 SDK에 대한 짧은 레시피입니다. 발명된 패키지는 없습니다.

모든 통합에 포함된 것

모든 프레임워크에서 일관된 형태.

  • 패키지 설치 명령 또는 패키지가 없을 때의 레시피
  • 실행 가능한 복붙 코드, pseudocode 아님
  • '내 {framework} agent에 결제를 어떻게 추가하나요'에 대한 짧은 답변
  • AI 검색 엔진용 HowTo/FAQ schema를 갖춘 FAQ 항목
  • 해당 롱테일 랜딩 페이지로 연결되는 링크
  • 요금 페이지로 연결되는 링크
아키텍처

모든 통합은 동일한 API 위에 얇은 래퍼입니다.

Blockchain0x 통합은 10개의 별도 제품이 아닙니다. 단일 HTTP API 위에 있는 10개의 서로 다른 인체공학적 표면입니다. API는 진실의 출처이며, 프레임워크 래퍼는 시간을 절약하기 위해 존재합니다.

SDK 아키텍처 다이어그램: 단일 Blockchain0x HTTP API를 호출하는 프레임워크 래퍼

각 래퍼는 "프레임워크가 도구를 정의하는 방식"을 "우리 API에 대한 HTTP 호출"로 변환합니다. 그것이 전체 작업입니다. Python 어댑터는 create_blockchain0x_toolset(client)를 노출하여 LangChain 또는 CrewAI에 준비된 도구 세트를 제공합니다. 제공된 어댑터가 없는 프레임워크는 createX402Client(...)(Node) 또는 blockchain0x 클라이언트(Python)를 해당 프레임워크의 네이티브 도구로 래핑합니다. 두 경우 모두 동일한 API입니다.

이것은 몇 가지 이유로 중요합니다. 첫째, 혼합하여 사용할 수 있습니다: LangChain 프로덕션 에이전트와 CrewAI 실험 에이전트가 동일한 Blockchain0x 에이전트 지갑을 충돌 없이 타겟팅할 수 있습니다. 둘째, 우리는 귀하를 특정 프레임워크 선택에 묶어두지 않습니다; 프레임워크를 전환하는 데 귀하의 지갑, 지출 정책 또는 공개 페이지에 대한 변경이 필요하지 않습니다. 셋째, 새로운 엔드포인트나 새로운 웹훅 이벤트를 배포할 때, 프레임워크 래퍼가 다음 릴리스에서 이를 노출합니다; 기본 API가 계약입니다.

SDK 건너뛰기

우리의 SDK, 래퍼 또는 프레임워크 통합 없이도 통합할 수 있습니다.

Blockchain0x API는 베어러 토큰 인증을 사용하는 HTTPS를 통한 일반 JSON입니다. 어떤 언어의 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 - 이 모든 언어는 표준 HTTP 라이브러리를 사용하여 우리의 API를 네이티브로 호출할 수 있습니다. 특별한 도구는 필요하지 않습니다.
  • 귀하는 경계에 있습니다. Cloudflare Workers, Vercel Edge Functions, Deno Deploy - 추가 종속성을 번들로 묶고 싶지 않은 환경입니다. 원시 API는 변경 없이 작동합니다.
  • 귀하는 정확히 무엇이 전송되고 있는지 보고 싶습니다. 디버깅, 보안 검토 또는 프로토콜 학습을 위해, 원시 HTTP 형태가 SDK 소스를 읽는 것보다 더 명확합니다.
  • 귀하는 재시도, 로깅, 텔레메트리가 있는 자체 HTTP 레이어를 가지고 있습니다. 자신의 재시도 동작을 가진 다른 SDK를 도입하는 것은 기존 인프라와 충돌합니다. 원시 API를 단순한 HTTP 엔드포인트로 호출하는 것이 깔끔하게 통합됩니다.

docs.blockchain0x.com의 전체 API 참조에는 OpenAPI 사양이 포함되어 있으므로 OpenAPI 코드 생성 도구가 있는 모든 언어로 자체 클라이언트를 생성할 수 있습니다.

프레임워크 선택

각 프레임워크가 올바른 도구일 때.

아직 에이전트 프레임워크를 선택하지 않았다면, 여기에 우리가 보는 장단점이 있습니다. 이 중 어느 것도 잘못된 선택은 아니며, 올바른 선택은 귀하의 에이전트가 하는 일과 누가 유지 관리하는지에 따라 다릅니다.

프레임워크최고일 때다음과 같은 경우 피하십시오
LangChain기존 LangChain 코드베이스, 복잡한 tool chain, 광범위한 생태계 사용귀하는 최소한의 종속성을 원합니다; LangChain은 많은 것을 끌어옵니다.
LangGraph상태를 유지하는 다단계 워크플로, durable execution, human-in-the-loop단순 선형 체인; 그래프 오버헤드는 낭비됩니다.
CrewAI멀티 agent 협업 패턴 (researcher + writer + reviewer)단일 에이전트 루프; CrewAI는 팀을 위해 구축되었습니다.
AutoGen멀티 agent 대화, group chat 패턴, Microsoft 툴링생산 고속 처리; AutoGen은 연구를 최적화합니다.
LlamaIndexRAG 중심 에이전트, 문서 Q&A가 핵심 기능순수 도구 사용 에이전트; LlamaIndex의 강점이 활용되지 않음
OpenAI Agents SDKOpenAI 전용 스택, 가장 깔끔한 tool-use API를 원함다중 공급자 스택; OpenAI SDK는 OpenAI 중심입니다.
Pydantic AI모든 에이전트 입력/출력에 대한 강력한 typing, Python 우선TypeScript 우선 스택; Python 네이티브 타이핑이 가치입니다.
Semantic Kernel기존 .NET / C# / Java 코드베이스, 엔터프라이즈 Microsoft 환경Python 전용 팀; 사용하지 않는 MS 통합에 대해 비용을 지불하고 있습니다.
AgnoPython 네이티브, 경량, 최소한의 추상화 오버헤드 선호귀하는 LangChain 생태계의 서드파티 통합이 필요합니다.
MCP middlewareMCP server를 운영 중이며 클라이언트가 호출당 결제하기를 원합니다귀하는 MCP 서버를 실행하고 있지 않습니다(서버 측 패턴입니다)

두 가지 실용적인 조언. 처음 시작하고 가능한 한 작은 학습 곡선을 원한다면 LangChain 또는 OpenAI Agents SDK가 가장 안전한 기본값입니다. 이미 프레임워크가 있다면, 우리의 통합이 잘 작동합니다; Blockchain0x를 사용하기 위해 프레임워크를 전환하지 마십시오.

심층 가이드

특정 시나리오는 전용 페이지를 가집니다.

프레임워크별 통합 페이지를 넘어, 우리는 더 좁은 질문에 대한 긴 꼬리 가이드를 게시합니다: "LangGraph 다단계 워크플로에 결제를 추가하는 방법", "내 MCP 서버가 도구별로 요금을 청구하도록 하는 방법", "USDC 결제 뒤에 Stripe와 유사한 API를 차단하는 방법". 이들은 /lp/{slug}에 있으며, 의도적으로 주요 내비게이션에는 포함되지 않습니다. 검색을 통해 발견되며, 각 링크는 관련 통합 페이지로 돌아갑니다.

그들을 찾는 곳

첫 번째 긴 꼬리 가이드 배치는 통합 프레임워크 페이지와 함께 제공됩니다. 그때까지 가장 구체적인 시나리오별 콘텐츠는 docs.blockchain0x.com의 "가이드" 아래에 있습니다. 각 /lp/ 페이지에는 실행할 수 있는 작동 코드와 관련 에이전트를 Pro로 업그레이드하는 직접 CTA가 포함되어 있습니다.

자주 묻는 질문

대답할 가치가 있는 다섯 가지 통합 질문.

SDK가 선택 사항이라면, 왜 존재하나요?

세 가지 이유가 있습니다. 첫째, 인체 공학: SDK는 자동으로 아이도포턴시 키를 생성하고, 모든 요청 및 응답의 유형을 지정하며, 웹훅 서명 검증을 번들로 묶어 사용자가 직접 코드를 작성하지 않도록 합니다. 둘째, 드리프트 보호: 엔드포인트를 추가하거나 필드를 변경할 때 다음 SDK 릴리스가 이를 노출합니다. 원시 HTTP 사용자는 변경 로그를 읽어야 합니다. 셋째, 계측: SDK는 일반적인 관측 스택과 호환되는 형식으로 구조화된 로그 및 메트릭을 자동으로 생성합니다. 이들 중 어느 것도 필수적이지 않지만, 통합 시간 30-90분을 절약할 수 있습니다. API의 원시 형태를 보고 싶다면 SDK를 건너뛰고 curl 또는 다른 HTTP 클라이언트를 사용하십시오.

귀하가 나열하지 않은 프레임워크를 사용하고 있습니다. 여전히 통합할 수 있나요?

네. 모든 통합은 동일한 작은 REST API에 위치합니다: 에이전트, 결제, 결제 요청, 거래, 웹훅, 그리고 읽기 전용 지출 권한. 인증은 베어러 토큰이며, 웹훅은 HMAC-SHA256으로 서명됩니다. HTTP를 사용할 수 있다면, 어떤 프레임워크에서도 통합할 수 있습니다. 배포된 래퍼가 없는 프레임워크에서도 마찬가지입니다 - 해당 프레임워크의 도구로 우리의 SDK를 감싸면 됩니다. 프레임워크 페이지는 편의를 위해 존재하며, 게이트키핑을 위한 것이 아닙니다. 귀하의 프레임워크에 대한 공식 어댑터가 필요하십니까? 문서를 통해 알려주시면 수요에 따라 고려하겠습니다.

하나의 에이전트가 여러 프레임워크 통합에 의해 동시에 제공될 수 있나요?

네. 단일 에이전트는 하나의 지갑 주소, 하나의 API 키 세트, 하나의 지출 정책 및 하나의 공개 페이지를 가집니다. 스택의 서로 다른 부분이 다양한 프레임워크 통합을 통해 API를 호출할 수 있습니다: 프로덕션의 LangChain 에이전트, CrewAI 실험, MCP 서버 미들웨어, 모두 동일한 에이전트에 비용을 지불하거나 모두 동일한 에이전트를 통해 청구합니다. 프레임워크 경계는 귀하 쪽에 있으며, 우리는 인증된 API 요청과 웹훅 구독만을 봅니다.

프레임워크 통합에 추가 비용이 발생합니까?

아니요. 발송된 어댑터 - PyPI의 blockchain0x-langchain 및 blockchain0x-crewai, npm의 @blockchain0x/mcp 서버 - 는 무료이며, SDK도 무료입니다. 다른 모든 프레임워크에 대해 추가 패키지를 구매할 필요는 없습니다: 몇 줄로 SDK를 직접 감쌀 수 있습니다. 귀하의 비용은 에이전트당 구독료와 거래 수수료입니다. LangChain 패키지를 설치하는 비용은 curl로 API를 호출하는 것과 동일합니다. 이 패키지는 시간을 절약하지만 기능을 제한하지는 않습니다.

프레임워크가 중단된 변경사항을 배포할 때 통합을 얼마나 빨리 업데이트하나요?

배송된 어댑터(blockchain0x-langchain, blockchain0x-crewai, @blockchain0x/mcp)에 대해 사람들이 실제로 사용하는 프레임워크를 추적하고 주요 버전이 출시될 때 업데이트합니다; 우리는 초기 단계이며 아직 고정된 SLA를 약속하지 않습니다. 마이너 버전은 일반적으로 변경이 필요하지 않습니다. 어댑터가 안정적인 인터페이스를 감싸기 때문입니다. 레시피 기반 프레임워크는 거의 이동하지 않습니다: SDK를 직접 호출하므로 프레임워크 버전 업그레이드는 우리의 표면에 거의 영향을 미치지 않습니다. 파괴적인 변경으로 어댑터가 안전하지 않게 되면 지원을 철회하기 전에 해당 /integrations/ 페이지에 이를 기록합니다.

연결하고, 지급을 시작하세요.

시작은 무료입니다. 첫 번째 결제 요청까지 5분 소요됩니다.