1. Summary
Fiber Link is an open-source payment layer that enables instant, low-fee tipping and micropayments inside communities (starting with a Discourse plugin).
It is built on CKB Fiber Network (payment channel network), but abstracts away the operational complexity for community members by providing an always-online “hub” node + lightweight account/ledger service.
Core deliverable: a Discourse plugin that adds a “Tip” button to posts/replies and a simple creator dashboard for balances and withdrawals.
2. Problem Statement
Online communities produce valuable content but often rely on:
- Ads and sponsorships (misaligned incentives)
- Traditional payment processors (high fees, geo restrictions)
- L1 on-chain transfers (poor UX for small payments; confirmations; fees; key management)
CKB Fiber supports ultra-low-cost, fast payments, but a typical receiver needs to be online and/or operate a Fiber node for best UX.
For most creators and community members, that operational requirement blocks adoption.
3. Proposed Solution
Fiber Link provides a pragmatic “pay layer” for communities:
3.1 Components
- Fiber Link Hub Node (FNN)
- Always-online Fiber node with enough liquidity to receive tips.
- Supports at least CKB and one stablecoin UDT (e.g., USDI).
- Fiber Link Service (Backend API + Ledger)
- Creates invoices per tip request.
- Subscribes to invoice/payment state changes and credits recipients.
- Maintains an internal ledger per user.
- Provides withdrawal workflow (see §3.3).
- Discourse Plugin
- Adds “Tip” button to posts/replies.
- Shows invoice string/QR for payment.
- Shows tip success and creator balances.
- Creator withdrawal UI (threshold-based).
3.2 User Flow: Tip a Post
- User clicks Tip on a Discourse post/reply.
- Plugin calls Fiber Link Service:
POST /tips(app_id, post_id, recipient_id, asset, amount). - Service requests invoice from the Hub FNN (e.g.,
new_invoice). - Plugin displays:
- invoice string
- QR code
- User pays the invoice using any Fiber-compatible wallet/node.
- Service detects invoice settlement and credits the recipient’s internal balance.
3.3 Withdrawal / Off-ramp
Because most creators will not run a Fiber node, MVP withdrawals will be:
- On-chain UDT transfer to a creator-supplied CKB address (same address format can receive UDTs).
- Optional: configurable withdrawal threshold (to reduce on-chain fees and operational overhead).
Custody note: This MVP is a custodial/hosted hub model (similar to hosted Lightning wallets). Custody risk is reduced by:
- enforceable withdrawal threshold / frequent settlement
- operational limits (e.g., per-user and per-community maximum balance)
- strong key management practices
4. Deliverables
Code (Open Source)
fiber-link-servicerepository (backend + docs)fiber-link-discourse-pluginrepository (plugin + docs)
Deployment
- Docker Compose reference deployment:
- FNN
- service
- Postgres
Documentation
- Admin installation guide
- Security & operational guide (key management, backups, monitoring)
- API documentation
Demo
- Public demo Discourse instance (testnet) showing end-to-end tipping
5. Milestones & Timeline (8 weeks)
Milestone 1 (Weeks 1–2): Technical Design + Fiber Integration Prototype
- Architecture & threat model
- Stand up Hub FNN on testnet
- Backend skeleton + DB schema
- Create invoices and verify settlement using Fiber node interfaces
- Minimal demo (CLI or simple web page) showing invoice → payment → ledger credit
Acceptance criteria: public repo, documented setup, and demo video or live testnet demo.
Milestone 2 (Weeks 3–5): Discourse Plugin + End-to-End Tipping
- Discourse plugin UI (Tip button + modal)
- Backend endpoints for Discourse integration
- Payment state subscription/polling integration
- Recipient dashboard showing balance and tip history
Acceptance criteria: tipping flow working on a testnet Discourse demo.
Milestone 3 (Weeks 6–8): Withdrawals + Mainnet Readiness
- Creator withdrawal workflow
- Admin controls (asset config, thresholds, limits)
- Production hardening:
- monitoring
- rate limiting
- backups
- documentation polish
- Mainnet deployment checklist
Acceptance criteria: mainnet-ready release, full docs, and demo instance.
6. Budget Request
Requested Amount
- USD-equivalent: $20,000, 100% settled in CKB
Cost Breakdown (USD)
| Category | Estimate | Notes |
|---|---|---|
| Engineering (backend + Discourse plugin + Fiber integration) | $14,000 | |
| QA/Test (unit + e2e + testnet/mainnet smoke tests) | $1,600 | |
| DevOps/Deployment (Docker, CI, monitoring) | $1,350 | |
| Docs & PM (spec, README, admin guide, weekly updates) | $875 | |
| Infrastructure (2 months) | $600 | VPS, monitoring, backups |
| Contingency (approx. 8%) | $1,575 | API changes, bugfix buffer |
| Total | $20,000 |
Proposed Payout Schedule (aligned to milestones)
| Milestone | % | USD-equiv |
|---|---|---|
| Milestone 1 completion | 20% | $4,000 |
| Milestone 2 completion | 40% | $8,000 |
| Milestone 3 completion | 40% | $8,000 |
| Total | 100% | $20,000 |
7. Public Progress Updates
- Weekly status updates in the forum thread
- Repo commits and release tags
- Demo deployment updates
8. Team & Contacts
- Applicant: CHEN YU
- Contact: Discord
9. Acknowledgements
We appreciate the Spark Program Committee for reviewing our early draft and sharing helpful suggestions. Our initial intent was to apply to the Spark Program, but with the Committee’s encouragement we are pursuing a larger grant so the project can be delivered with the necessary engineering, security hardening, and operational support.
中文介绍
1. 项目概述（Summary）
Fiber Link 是一个开源的支付层，旨在为社区内部（首期以 Discourse 插件形式）提供即时、低手续费的打赏与微支付能力。
该方案构建在 CKB Fiber Network（支付通道网络）之上，但通过引入常在线的 Hub 节点以及轻量级账户/账本服务，对社区成员屏蔽了底层运维复杂性。
核心交付物：
一个 Discourse 插件，为帖子与回复提供 “Tip（打赏）” 按钮，并配套一个简洁的创作者余额与提现管理面板。
2. 问题背景（Problem Statement）
当前在线社区在内容变现方面，主要依赖以下方式：
- 广告与赞助（激励机制与内容质量不完全一致）
- 传统支付服务（手续费高、地域限制明显）
- L1 链上转账（小额支付体验差，需要确认时间，手续费与密钥管理成本高）
CKB Fiber 天然支持低成本、快速支付，但在现有模型下，接收方通常需要保持在线，或自行运行 Fiber 节点，才能获得较好的用户体验。
对于大多数内容创作者和普通社区成员而言，这一运维门槛直接阻碍了 Fiber 支付能力的实际落地与规模化采用。
3. 解决方案（Proposed Solution）
Fiber Link 为社区场景提供了一套务实可行的“支付层”设计。
3.1 系统组件
- Fiber Link Hub Node（FNN）
- 一个始终在线的 Fiber 节点，具备充足流动性以接收打赏支付
- 至少支持 CKB 以及 一种稳定币 UDT（例如 USDI）
- Fiber Link Service（后端 API + 内部账本）
- 为每一次打赏请求生成支付发票（invoice）
- 订阅并监听发票 / 支付状态变更，并为收款方记账
- 为每个用户维护独立的内部账本
- 提供完整的提现流程（详见 §3.3）
- Discourse 插件
- 为帖子与回复增加 “Tip” 按钮
- 展示发票字符串与二维码
- 显示打赏成功状态及创作者余额
- 提供创作者提现界面（支持阈值控制）
3.2 用户流程：打赏一条帖子
- 用户在 Discourse 帖子或回复上点击 Tip
- 插件调用 Fiber Link Service：POST /tips (app_id, post_id, recipient_id, asset, amount)
- 服务端向 Hub FNN 请求生成发票（如 new_invoice）
- 插件向用户展示：
- 发票字符串
- 对应的二维码
- 用户使用任意兼容 Fiber 的钱包或节点完成支付
- 服务端检测到发票结算完成后，为收款方增加内部余额
3.3 提现 / 出金（Withdrawal / Off-ramp）
考虑到大多数创作者不会自行运行 Fiber 节点，MVP 阶段的提现方式设计为：
- 链上 UDT 转账 至创作者提供的 CKB 地址（同一地址格式即可接收 UDT）
- 可配置的提现阈值（用于减少链上手续费及运维开销）
托管说明：
该 MVP 采用托管式 Hub 模型（类似托管型 Lightning 钱包）。托管风险将通过以下方式进行控制与缓解：
- 强制提现阈值 / 高频结算策略
- 单用户与单社区的余额上限控制
- 严格的密钥管理与运维安全实践
4. 项目交付物（Deliverables）
代码（开源）
- fiber-link-service 仓库（后端服务 + 文档）
- fiber-link-discourse-plugin 仓库（插件 + 文档）
部署
- Docker Compose 参考部署方案，包含：
- FNN
- Fiber Link Service
- Postgres
文档
- 管理员安装指南
- 安全与运维指南（密钥管理、备份、监控）
- API 文档
演示
- 一个公开的测试网 Discourse Demo，完整展示端到端打赏流程
5. 里程碑与时间计划（8 周）
里程碑 1（第 1–2 周）：技术设计 + Fiber 集成原型
- 架构设计与威胁模型分析
- 在测试网上部署 Hub FNN
- 后端服务骨架与数据库 Schema
- 基于 Fiber 节点接口完成发票创建与结算验证
- 最小化 Demo（CLI 或简易 Web 页面），演示 invoice → 支付 → 记账流程
验收标准：
公开代码仓库、完整部署文档，以及 Demo 视频或可访问的测试网实例。
里程碑 2（第 3–5 周）：Discourse 插件 + 端到端打赏
- Discourse 插件 UI（Tip 按钮与弹窗）
- Discourse 对接所需的后端接口
- 支付状态订阅 / 轮询机制
- 创作者余额与打赏历史展示面板
验收标准：
在测试网 Discourse Demo 中完成完整打赏流程。
里程碑 3（第 6–8 周）：提现功能 + 主网就绪
- 创作者提现流程
- 管理员配置能力（资产、阈值、限额）
- 生产环境加固：
- 监控
- 限流
- 备份
- 文档完善
- 主网上线检查清单
验收标准：
主网可部署版本、完整文档，以及可运行的演示实例。
6. 预算申请（Budget Request）
申请金额
- 等值美元： $20,000
- 结算方式： 100% 以 CKB 支付
成本拆分（USD）
| 分类 | 预算 | 说明 |
|---|---|---|
| 工程开发（后端 + 插件 + Fiber 集成） | $14,000 | |
| 测试与 QA（单测、E2E、测试网/主网验证） | $1,600 | |
| DevOps / 部署（Docker、CI、监控） | $1,350 | |
| 文档与项目管理 | $875 | |
| 基础设施（2 个月） | $600 | VPS、监控、备份 |
| 预备金（约 8%） | $1,575 | API 变动、Bug 修复 |
| 合计 | $20,000 |
付款计划（与里程碑绑定）
| 里程碑 | 比例 | 等值 USD |
|---|---|---|
| 里程碑 1 完成 | 20% | $4,000 |
| 里程碑 2 完成 | 40% | $8,000 |
| 里程碑 3 完成 | 40% | $8,000 |
| 总计 | 100% | $20,000 |
7. 公开进度更新（Public Progress）
- 每周在论坛帖子中发布进度更新
- 代码仓库提交记录与 Release Tag
- Demo 部署状态更新
8. 团队与联系方式（Team & Contacts）
- 申请人：CHEN YU
- 联系方式：Discord
9. 致谢（Acknowledgements）
感谢 Spark Program Committee 对我们早期方案的审阅与建设性建议。
项目最初仅计划申请 Spark Program，在委员会的鼓励与指导下，我们决定申请更大规模的 Grant，以确保项目在工程实现、安全加固与运维支持层面能够达到可长期运行的标准。
