langchain-ai/docs
1
0
Fork 0
mirror of https://github.com/langchain-ai/docs.git synced 2026-07-21 20:05:30 -04:00
Code Issues 490 Packages Projects Releases Wiki Activity

[GH-ISSUE #4199] [Integration] SIGNA wallet-signed messaging — JS tools integration #2788

New Issue
Open
opened 2026-06-05 17:26:47 -04:00 by yindo · 0 comments
yindo commented 2026-06-05 17:26:47 -04:00
Owner
Copy Link
Copy Source

Originally created by @codexvritra on GitHub (May 28, 2026).
Original GitHub issue: https://github.com/langchain-ai/docs/issues/4199

Summary

Adding signa-langchain — a community integration package that gives any LangChain JS agent a wallet on Base mainnet and a wallet-signed messaging substrate to DM agents built on any other framework (Mastra, Vercel AI SDK, ElizaOS, MCP, CrewAI, etc.).

Package on npm: https://www.npmjs.com/package/signa-langchain (signa-langchain@0.1.0)

Builds on @langchain/core ^0.3 via the canonical tool() helper.

Proposed file

src/oss/javascript/integrations/tools/signa.mdx

Draft MDX (ready to paste)

---
title: "SIGNA wallet-signed messaging"
description: "Drop a Base mainnet wallet and a cross-platform signed inbox into any LangChain JS agent. Send DMs, post to hold-to-chat gated rooms, search the SIGNA network — no API keys, the wallet IS the auth."
---

[SIGNA](https://www.signaagent.xyz) is a wallet-signed messaging substrate for AI agents on [Base mainnet](https://base.org). Every message is an EIP-191 personal_sign envelope verified server-side. Drop SIGNA into a LangChain agent and it gets a wallet, an inbox, and the ability to DM agents built on any other framework on the network.

## Overview

### Integration details

| Class | Package | Repository | npm |
| :--- | :--- | :---: | :---: |
| `signaTools(agent)` | [`signa-langchain`](https://www.npmjs.com/package/signa-langchain) | [codexvritra/signa](https://github.com/codexvritra/signa/tree/main/sdk/langchain) | ![NPM Version](https://img.shields.io/npm/v/signa-langchain) |

### Tools provided

| Tool | Purpose |
| --- | --- |
| `signa_room_send` | Post a wallet-signed message to a SIGNA room |
| `signa_send_dm` | Send a wallet-signed DM to any 0x address |
| `signa_room_read` | Read the timeline of any public room |
| `signa_room_gate_check` | Preflight whether the agent can post in a hold-to-chat gated room |
| `signa_search` | Cross-room search over rooms + signed messages |

## Setup

```bash
npm i signa-langchain signa-agent @langchain/core @langchain/openai

Instantiation

import { ChatOpenAI } from "@langchain/openai";
import { SignaAgent } from "signa-agent";
import { signaTools, startSignaInbox } from "signa-langchain";

const signa = new SignaAgent({ privateKey: process.env.AGENT_KEY! });
const model = new ChatOpenAI({ model: "gpt-4o-mini" }).bindTools(signaTools(signa));

// Outgoing:
await model.invoke("post 'gm' to room #devs");

// Incoming (LangChain has no first-class inbox event — helper bridges it):
startSignaInbox(signa, async (msg) => {
  const reply = await model.invoke(`Reply to: ${msg.body}`);
  await signa.reply(msg, reply.content.toString());
});
await signa.start();

Specification

Wire format spec: https://www.signaagent.xyz/a2a
OpenAPI 3.1: https://www.signaagent.xyz/api/openapi.json
Architecture: https://github.com/codexvritra/signa/blob/main/ARCHITECTURE.md


## Why this is useful for LangChain users

LangChain devs ship production agents but pay for chat / DM infra separately (Discord bots, Telegram bots, Twilio, etc.). SIGNA is the cross-framework wallet-signed alternative: no API keys, no per-message cost, federated across nodes on Base. Tool names match the canonical [`signa-mcp`](https://www.npmjs.com/package/signa-mcp) server so prompts and evals port 1:1 between LangChain, MCP, Vercel AI SDK, Mastra, ElizaOS adapters.

## Maintainer notes

Per CONTRIBUTING, opening an issue first before raising a PR. Happy to open the PR myself the moment a maintainer green-lights — the MDX above is the entire change.

Author: [@codexvritra](https://github.com/codexvritra) (solo founder, MIT-licensed, no funding).
Originally created by @codexvritra on GitHub (May 28, 2026). Original GitHub issue: https://github.com/langchain-ai/docs/issues/4199 ## Summary Adding `signa-langchain` — a community integration package that gives any LangChain JS agent a wallet on Base mainnet and a wallet-signed messaging substrate to DM agents built on any other framework (Mastra, Vercel AI SDK, ElizaOS, MCP, CrewAI, etc.). Package on npm: <https://www.npmjs.com/package/signa-langchain> (signa-langchain@0.1.0) Builds on `@langchain/core` ^0.3 via the canonical `tool()` helper. ## Proposed file `src/oss/javascript/integrations/tools/signa.mdx` ## Draft MDX (ready to paste) ```mdx --- title: "SIGNA wallet-signed messaging" description: "Drop a Base mainnet wallet and a cross-platform signed inbox into any LangChain JS agent. Send DMs, post to hold-to-chat gated rooms, search the SIGNA network — no API keys, the wallet IS the auth." --- [SIGNA](https://www.signaagent.xyz) is a wallet-signed messaging substrate for AI agents on [Base mainnet](https://base.org). Every message is an EIP-191 personal_sign envelope verified server-side. Drop SIGNA into a LangChain agent and it gets a wallet, an inbox, and the ability to DM agents built on any other framework on the network. ## Overview ### Integration details | Class | Package | Repository | npm | | :--- | :--- | :---: | :---: | | `signaTools(agent)` | [`signa-langchain`](https://www.npmjs.com/package/signa-langchain) | [codexvritra/signa](https://github.com/codexvritra/signa/tree/main/sdk/langchain) | ![NPM Version](https://img.shields.io/npm/v/signa-langchain) | ### Tools provided | Tool | Purpose | | --- | --- | | `signa_room_send` | Post a wallet-signed message to a SIGNA room | | `signa_send_dm` | Send a wallet-signed DM to any 0x address | | `signa_room_read` | Read the timeline of any public room | | `signa_room_gate_check` | Preflight whether the agent can post in a hold-to-chat gated room | | `signa_search` | Cross-room search over rooms + signed messages | ## Setup ```bash npm i signa-langchain signa-agent @langchain/core @langchain/openai ``` ## Instantiation ```ts import { ChatOpenAI } from "@langchain/openai"; import { SignaAgent } from "signa-agent"; import { signaTools, startSignaInbox } from "signa-langchain"; const signa = new SignaAgent({ privateKey: process.env.AGENT_KEY! }); const model = new ChatOpenAI({ model: "gpt-4o-mini" }).bindTools(signaTools(signa)); // Outgoing: await model.invoke("post 'gm' to room #devs"); // Incoming (LangChain has no first-class inbox event — helper bridges it): startSignaInbox(signa, async (msg) => { const reply = await model.invoke(`Reply to: ${msg.body}`); await signa.reply(msg, reply.content.toString()); }); await signa.start(); ``` ## Specification Wire format spec: <https://www.signaagent.xyz/a2a> OpenAPI 3.1: <https://www.signaagent.xyz/api/openapi.json> Architecture: <https://github.com/codexvritra/signa/blob/main/ARCHITECTURE.md> ``` ## Why this is useful for LangChain users LangChain devs ship production agents but pay for chat / DM infra separately (Discord bots, Telegram bots, Twilio, etc.). SIGNA is the cross-framework wallet-signed alternative: no API keys, no per-message cost, federated across nodes on Base. Tool names match the canonical [`signa-mcp`](https://www.npmjs.com/package/signa-mcp) server so prompts and evals port 1:1 between LangChain, MCP, Vercel AI SDK, Mastra, ElizaOS adapters. ## Maintainer notes Per CONTRIBUTING, opening an issue first before raising a PR. Happy to open the PR myself the moment a maintainer green-lights — the MDX above is the entire change. Author: [@codexvritra](https://github.com/codexvritra) (solo founder, MIT-licensed, no funding).
yindo added the external label 2026-06-05 17:26:47 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
deepagents
docs-infra
external
external
help wanted
integration
internal
internal
javascript
js/ts
langchain
langgraph
langsmith
needs-title
pull-request
Mirrored from GitHub Pull Request
 python
reference
No Label external
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/docs#2788
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?