freeport-nostr

Freeport

基于 Nostr 的去中心化 P2P 市场。用户向特定主题的市场广播交易意向；个人 Agent 会发现相应的意向并自动协商。最终交易由用户确认。没有中央运营方，也没有撮合服务端——中继只是简单的发布/订阅，所有逻辑都在客户端运行。

• 应用： https://freeport.network（Web/PWA） · iOS · Android · 桌面版 — Mac/Windows/Linux · 离线 HTML
• 白皮书： PDF
• 自托管： packages/freeport-self-hosted （docker compose up -d），或者通过任意桌面安装运行 freeport --serve，为你的网络托管应用。
• 开发者： CONTRIBUTING.md — 仓库布局、技术栈决策、快速入门、CLI。

演示（2 分钟）

https://github.com/user-attachments/assets/506c82ac-c5eb-415d-b981-ba14c4f165bc

也可在落地页观看。

Freeport 为何存在

• 这是一个研究项目。 纯 P2P 基础设施能走多远？买家、卖家、乘客和司机通过 Nostr 相遇，并通过 Lightning 或现金结算。任何中间环节都不需要许可就能存在。
• 这是一项论点。 带有声誉系统的 P2P 市场行之有效。当人们拥有自己的声誉时，市场便能自我调节。
• 这是制衡力量。 无需支付费用、无需向任何人负责的退出途径，限制了大型平台变得多么贪婪。
• 这很有趣。 开放协议、Claude Code 作为结对编程伙伴，不需要投资者演示文稿。
• 没人能从中获利——包括我。 没有运营方，不抽成。这是一个协议，而不是平台。你可以运行它，也可以分叉它。
• 这里没人会保护你——这正是设计初衷，也是你要付出的代价。 没有支持热线、没有退款，也没有中央权威。你的判断优先，同时还有无需运营方管理、可自愿选择的保障措施：声誉系统（karma、共同签署的收据、信任网络）、托管交易的仲裁（examples/arbitrator）、身份验证（examples/id-verification），以及根据声誉定价的保险（examples/insurance-store）。你可以自行选择使用多少保障措施。

当前可用功能

• 随处可用：iOS + Android 应用商店、Web/PWA、macOS/Windows/Linux 桌面安装程序（支持自更新），还有单文件离线副本：整个应用打包在一个 HTML 文件中，可从 file:// 运行，无需安装，也无需服务端。
• 钱包（实验性）：内置自托管 Bitcoin Lightning + 稳定币（USDT/USDB）钱包（Breez SDK/Spark）。密钥源自你的 Nostr 密钥，一份备份即可覆盖身份和资金。支持 Lightning 地址（[email protected]）、链上交易、扫描 QR 码、本地货币余额，以及已确认交易的一键支付 / 扫码支付。如果你更喜欢，也可以通过 NWC 接入自己的钱包。Spark 是一个尚处早期、尽量减少信任依赖的 L2，请将其视为日常消费钱包。
• 声誉：由同伴评分的 karma、共同签名的交易收据、已完成交易计数，以及信任网络加权。Sybil 抵御机制仍在探索中——请谨慎对待没有历史记录的身份。
• 聊天：基于邀请的 1:1 加密聊天，不限于交易场景——支持 QR 码 / 链接邀请、回复、表情回应、阅后即焚消息、送达 / 已读回执、语音消息、位置共享、聊天内搜索和 Lightning 支付。更新后的客户端之间会升级为 NIP-17 gift wrap，因此中继甚至无法看到谁在和谁交谈。
• 通话（实验性）：聊天中的点对点语音 / 视频通话（WebRTC、端到端加密、通过加密私信传递信令——无需通话服务端），Web 端支持屏幕共享。可选 TURN 回退方案。
• Zaps 和商店：在帖子上使用 NIP-57 进行 zap 打赏（可验证收据），以及 NIP-15 店面——持久化的卖家商品列表，并通过对话式“联系卖家”完成结账。
• 无需托管方的托管交易：已确认交易采用 HODL-invoice 条件支付——买家持有原像，卖家只能在放款时结算，未放款的资金会自动退款。Lightning 协议负责强制执行锁定；期间无人经手资金。
• 迷你应用（实验性）：第三方 Web 应用可在 Freeport 内运行，使用你的可移植身份（NIP-07）和钱包（WebLN + Spark/稳定币）——通过权限防火墙进行沙盒隔离，每项敏感操作都需要你批准（架构和威胁模型）。专门的 应用 标签页提供启动器——采用主屏幕风格的网格（可通过 URL 或 QR 码添加任意应用，拖动即可重新排列），钱包是第一个磁贴；你的应用及其授权会随账户备份迁移。只需一个 <script> 标签，页面也能在 Web 上运行。 迷你应用示例：
  • examples/esim-store — eSIM 商店，支持 Spark/稳定币结账，现已上线： apps.freeport.network/esim-store
  • examples/insurance-store — 根据源自 npub 的声誉承保旅行保险报价，并提供可下载的 PDF 证书，现已上线： apps.freeport.network/insurance-store
  • examples/id-verification — 付费身份 / 驾照验证服务：提交文件、预约视频通话，并获取可分享至个人资料的验证链接，现已上线： apps.freeport.network/id-verification
  • examples/arbitrator — 去中心化争议仲裁：仲裁员作为条件密钥参与托管交易，证据加密（NIP-44），仅在实际提出争议时收取费用——仲裁员的 npub karma 就是其资质证明，现已上线： apps.freeport.network/arbitrator
• 设备端 AI（实验性）：用任意语言描述你的需求，它就会起草帖子；收到的聊天消息会自动翻译。所有处理都在你的设备上完成（Apple Intelligence / Android ML Kit + Gemini Nano / Chrome 内置 AI）——你的文字永远不会离开设备。
• 通知和 Telegram：不读取内容的推送通知，以及 Telegram 桥接——在群组中接收市场动态、一键广播自然发布的帖子、接收个人提醒。
• 支持 56 种语言、完整 RTL 支持、聊天内翻译。

非目标（v1）

托管（支付始终是自托管的钱包到钱包转账；即使是托管交易，也只是将信任降至最低的 HODL 发票，绝不会持有余额）、争议解决、审核和反女巫攻击——这些都被有意推迟。

捐赠

BTC：bc1ps44wjx3wpu4s0xj746gz2lu45nspsm9059d3ym8xz0nrhu4psyasdgwwhx

许可证与分叉

MIT（LICENSE）。Freeport 的设计初衷就是供人分叉：任何社区都可以通过更改配置而非架构，搭建自己的市场——使用自己的名称、城市、垂直领域、中继和服务。FORKING.md 列出了所有特定于部署的值；CONTRIBUTING.md 介绍了开发环境设置和代码风格。