LangGraph 전용 패키지는 없으며, 필요하지도 않습니다. 의 일반 노드가 실제 클라이언트를 호출하고, 가 payment webhook이 도착할 때까지 graph를 일시 중단한 뒤, handler가 LangGraph 자체의 + 로 다시 이어갑니다. 결제는 Base에서 정산됩니다.

LangGraph 및 핵심 SDK를 설치하세요. 추가 패키지 없음.

Node 18+ 및 @langchain/langgraph 0.2+와 실제 @blockchain0x/node 클라이언트. 두 언어 모두에 추가할 LangGraph 어댑터가 없습니다 - Python LangGraph 사용자는 langgraph와 blockchain0x Python 클라이언트를 설치하고 동일한 레시피를 작성하며, Python 측에서 interrupt() 및 Command(resume=...)를 사용합니다.

npm install @langchain/langgraph @blockchain0x/node

export BLOCKCHAIN0X_API_KEY=sk_test_...        # sk_test_ = Base Sepolia, sk_live_ = Base mainnet
export BLOCKCHAIN0X_WEBHOOK_SECRET=...          # for the webhook handler

BLOCKCHAIN0X_API_KEY는 dashboard의 sk_test_ testnet 또는 sk_live_ mainnet 키이며, client는 이를 environment에서 읽습니다. BLOCKCHAIN0X_WEBHOOK_SECRET (webhook을 생성하거나 회전할 때 한 번 반환됨)는 webhooks를 처리하는 process에서 필요합니다. graph가 한 process에서 실행되고 handler가 다른 process에서 실행된다면, handler가 suspended thread를 찾을 수 있도록 둘 다 동일한 checkpointer(예: shared Postgres)가 필요합니다.

웹훅을 검증한 후 스레드를 재개하십시오.

핸들러는 Node SDK의 webhooks.verify로 서명을 확인하고, 귀하의 매핑에서 중단된 LangGraph 스레드를 조회하며, graph.updateState로 settled를 설정하고, graph.invoke(null, config)를 호출하여 중단에서 계속합니다. 특별한 도우미는 없습니다 - 그것들은 LangGraph의 자체 API입니다.

import express from "express";
import { webhooks } from "@blockchain0x/node";
import { graph } from "./graph";

const app = express();
// Capture the RAW body. The HMAC is over the exact bytes on the wire.
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/payment", async (req, res) => {
  const result = webhooks.verify({
    headers: req.headers,
    rawBody: req.body, // Buffer, raw bytes
    secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
  });
  if (!result.ok) return res.status(400).json({ code: result.code });

  if (result.eventType === "payment.sent") {
    // You map the event to the suspended graph thread (your own store).
    const config = { configurable: { thread_id: threadFor(result.eventId) } };
    await graph.updateState(config, { settled: true });
    await graph.invoke(null, config); // resume from the interrupt
  }
  res.status(200).send("ok");
});

webhooks.verify는 원본 본문에 대해 상수 시간 내에 HMAC-SHA256을 수행하고 구별된 유니온을 반환합니다 - result.ok에서 분기하며, try/catch는 없습니다. result.eventId를 일시 중지한 스레드에 매핑한 후, graph.updateState + graph.invoke(null, config)가 지속된 체크포인트에서 재개되고 그래프가 배달을 실행합니다. 전송된 이벤트는 payment.received, payment.sent, wallet.deployed 및 webhook.test입니다.

LangGraph에 특화된 피해야 할 다섯 가지 함정.

LangGraph의 내구성 실행 모델은 강력하지만 체크포인트, 인터럽트 및 상태 업데이트와 관련하여 자체적인 위험 요소가 있습니다.