Специального пакета для LangGraph нет, и он вам не нужен. Обычный node в вашем вызывает реальный client , приостанавливает graph, пока не придет payment webhook, а обработчик возобновляет его с помощью собственных + LangGraph. Платежи завершаются в Base.

Установите LangGraph и основной SDK. Без дополнительных пакетов.

Node 18+ и @langchain/langgraph 0.2+ плюс реальный клиент @blockchain0x/node. Нет адаптера LangGraph для добавления в любом из языков - пользователи LangGraph на Python устанавливают langgraph и клиент blockchain0x на Python и пишут тот же рецепт, с interrupt() и Command(resume=...) на стороне Python.

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 - это ключ sk_test_ для testnet или sk_live_ для mainnet из вашего dashboard; client читает его из environment. BLOCKCHAIN0X_WEBHOOK_SECRET (выдается один раз при создании или ротации webhook) нужен в процессе, который обрабатывает webhook. Если ваш graph работает в одном процессе, а handler - в другом, обоим нужен один и тот же checkpointer (например, общий Postgres), чтобы handler мог найти приостановленный thread.

Проверьте вебхук, затем продолжите поток.

Обработчик проверяет подпись с помощью webhooks.verify из Node SDK, ищет приостановленный поток LangGraph в вашем собственном отображении, устанавливает settled с помощью graph.updateState и вызывает graph.invoke(null, config), чтобы продолжить с места прерывания. Никаких специальных помощников - это собственные API LangGraph.

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 мощная, но имеет свои собственные подводные камни вокруг контрольных точек, прерываний и обновлений состояния.