OPEN COMMUNICATION PROTOCOL

为自主身份构建的开放通信网络

面向构建通信应用的开发团队。为产品接入私聊、加密群组与公共频道,让用户以自己掌握的密钥控制账户身份。

自主身份隐私通信开放生态

Meshline Protocol 1.0 · 规范草案

01 · MESHLINE

让通信回到用户手中

从身份、消息到应用互通,Meshline 以公开协议连接用户、开发者与服务提供者。

自主身份

用自己的密钥掌控账户。以区块链地址作为长期身份,账户身份与所选择的归属中继相互独立。

隐私通信

私聊与群组采用端到端加密,只有通信参与者能够读取消息内容,中继无法解密。

开放生态

自由构建适合用户的应用。公开协议让独立开发的兼容客户端与中继遵循同一套规则互通。

02 · BUILD WITH MESHLINE

把交流,带进你的产品

从人与人的对话,到与 AI 智能体协作,用同一套通信能力,构建适合用户的体验。

01

AI 智能体

让 AI 成为你的联系人

为智能体构建独立通信身份,让用户加为好友,通过加密消息交代任务、交流进展并接收结果。

  • 独立身份
  • 双向通信
02

钱包应用

从账户,开始对话

在账户入口接入私聊与加密群组,让成员围绕已有身份交流。

  • 账户身份
  • 成员私聊
03

社区产品

让公告与讨论相连

通过公共频道发布消息,在加密群组中讨论,让成员继续一对一交流。

  • 公共频道
  • 加密群组
04

独立通信客户端

构建自己的聊天体验

基于公开协议设计界面、连接兼容中继,让通信融入你自己的应用。

  • 公开协议
  • 兼容实现

以上为可构建的场景示例。群组与频道需要中继提供相应托管能力。

03 · HOW IT WORKS

一条私聊消息,如何送达?

加密发生在设备上,中继负责找到收件位置并传递密文。沿着一条跨中继消息,了解它们如何协作。

中继 A 查询收件路由DHT · 只查路由,不传消息
  1. 01

    应用内 SDK

    发送设备

    加密并签名

    在本地加密正文,为接收设备封装内容密钥。

  2. 02

    中继网络

    归属中继 A

    查找路由并投递

    接受投递责任,解析收件路由,在期限内重试。

  3. 03

    中继网络

    归属中继 B

    验证并暂存密文

    接收直接投递的消息,按规则验证并有限期保存。

  4. 04

    应用内 SDK

    接收设备

    同步、验证与解密

    同步可读记录,验证签名,在本地解密消息。

实线:密文投递路径 · 虚线:路由查询

长期聊天历史保存在客户端。设备在中继保留期内上线后,可以补同步尚未读取的消息。

阅读消息投递与保留规则

04 · QUESTIONS, ANSWERED

了解你掌握的控制权

身份、内容与服务各有边界。接入之前,先了解这些关键区别。

01

身份由谁控制?

账户身份由持有账户密钥的用户控制。账户密钥授权设备,设备使用独立密钥处理日常通信;账户私钥不会发送给中继。消息、联系人和聊天历史保持在链下。

阅读完整规则
02

AI 智能体也能成为联系人吗?

可以通过 SDK 或 Meshline CLI 为智能体建立账户、管理好友关系,并收发端到端加密消息。CLI 提供 JSON 输出、非交互凭据和后台 daemon;meshline interactive 还可在一个前台进程中保持会话,通过标准输入接收命令,适合由智能体进程管理。接入方仍负责密钥保管、消息处理与持续运行。消息在智能体端解密后,交给模型的内容由应用决定;具体 AI 平台的接入仍需实现和验证。

阅读完整规则
03

中继能看到什么?

私聊与群组消息采用端到端加密,中继单独不能解密正文。中继仍会处理账户、路由和投递所需的信息;端到端加密并不等于完全匿名。公共频道中的内容是公开的。

阅读完整规则
04

离线时,如何收到新消息提醒?

应用可为设备配置推送网关。支持推送的中继会根据消息中的提醒请求和收件账户的在线状态,尝试向网关发送签名通知。通知不包含聊天正文;应用上线后仍通过正常同步读取、验证并解密消息。推送尽力发送,网关接受不代表设备收到。

阅读完整规则
05

更换中继后,身份和数据会怎样?

通过更新签名路由,可以更换归属中继并保持账户身份。旧消息时间线不会自动复制,联系人、聊天历史与群秘密的恢复依赖已有设备、可用材料或备份。频道与群组仍由各自的固定中继托管。

阅读完整规则
06

如何选择兼容的中继?

客户端通过链上 Registry 发现候选中继,验证成员状态、描述符签名和有效期,再选择服务端点。频道和群组属于可选托管能力,需要按应用需求确认。

阅读完整规则

05 · START BUILDING

从第一段代码开始

使用 .NET SDK 1.6.0 或 TypeScript SDK Alpha,为应用接入账户、加密消息、群组、频道与本地持久化。公开协议与 Registry 参考合约也支持独立构建兼容客户端和中继。

Meshline.Sdk 1.6.0 · .NET 10
dotnet add package Meshline.Sdk --version 1.6.0

在目标框架为 net10.0 的应用项目中运行安装命令。账户签名、中继注册表访问与本地秘密保护由应用提供。

选择适合你的接入方式

已发布

.NET SDK

为 .NET 10 应用接入账户与设备管理、端到端加密消息、群组、频道和本地持久化。

Alpha

TypeScript SDK

通过核心 SDK 与平台适配包,将通信能力接入 Node.js、浏览器或 Expo 应用。平台要求与验证范围见指南。

源码尚未公开

Meshline Relay

为兼容客户端提供消息投递与同步、频道和群组托管,以及面向应用推送网关的离线通知。

开发预览版

Meshline CLI

从终端管理账户和联系人、收发加密消息。通过 JSON 输出、交互会话和后台同步接入脚本与 AI 智能体。

Protocol 1.0 仍为规范草案。各组件的安装方式、平台要求与验证范围见开发者资源。

Meshline / START

开始使用 Meshline

使用 Meshline CLI 从终端开始通信,选择 .NET 或 TypeScript SDK 构建应用,或阅读协议规范实现兼容客户端与中继。