Não existe um pacote específico para LangGraph, e você não precisa de um. Um node simples no seu chama o cliente real , um suspende o grafo até o webhook de pagamento chegar, e o handler o retoma com os próprios + do LangGraph. Os pagamentos são liquidados na Base.

Instale LangGraph e o SDK principal. Nenhum pacote extra.

Node 18+ e @langchain/langgraph 0.2+ mais o cliente real @blockchain0x/node. Não há adapter de LangGraph para adicionar em nenhuma das linguagens - usuários de LangGraph em Python instalam langgraph e o cliente Python do blockchain0x e escrevem a mesma receita, com interrupt() e Command(resume=...) no lado 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 é uma chave sk_test_ de testnet ou sk_live_ de mainnet do seu painel; o cliente a lê do ambiente. BLOCKCHAIN0X_WEBHOOK_SECRET (retornado uma única vez quando você cria ou rota um webhook) é necessário no processo que trata webhooks. Se o seu grafo roda em um processo e o handler em outro, ambos precisam do mesmo checkpointer (por exemplo, um Postgres compartilhado) para que o handler possa localizar a thread suspensa.

Verifique o webhook, depois retome o thread.

O manipulador verifica a assinatura com webhooks.verify do SDK Node, procura a thread LangGraph suspensa em seu próprio mapeamento, define settled com graph.updateState e chama graph.invoke(null, config) para continuar a partir da interrupção. Nenhum helper especial - essas são as próprias APIs do 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 faz HMAC-SHA256 em tempo constante sobre o corpo raw e retorna uma união discriminada - ramifique em result.ok, sem try/catch. Mapeie result.eventId para a thread que você suspendeu, então graph.updateState + graph.invoke(null, config) retoma do ponto de verificação persistido e a execução do gráfico entrega. Os eventos enviados são payment.received, payment.sent, wallet.deployed e webhook.test.

Cinco armadilhas específicas do LangGraph a evitar.

O modelo de execução durável do LangGraph é poderoso, mas tem suas próprias armadilhas em torno de pontos de verificação, interrupções e atualizações de estado.