贡献写在链上，换谁管理都还在
大多数社区都有自己的积分，但缺少一份可靠的记录账本：换了负责人、换了系统，记录就找不到了；人离开社区，很多东西也带不走。数字身份把每一份贡献持续记录在链上，社区怎么变，记录都还在。
Semi · 完整介绍
让每一份付出
都被看见
乡建数字身份（Semi）
一个给乡村建设参与者使用的个人数字身份账户。用手机号或邮箱就能登录，不用懂技术；做饭、除草、画墙、写代码，每一份为社区出的力，都以“社区积分”和链上备注被公开、可信地记录下来。
开源 · GitHub
Safe + ERC-4337 智能账户
手续费平台代付
OAuth 2.0 统一登录
导读
五分钟了解 Semi 为什么做、是什么、能做什么、怎么做到。
一本社区护照 + 一本贡献记录本
护照证明“你是这个社区的一员”，记录本记下“你为社区做过什么”。背后是区块链，但使用者完全不需要懂区块链——就像用电不需要懂发电原理。它从南塘长出来，但不只属于南塘。
六个已经实现的能力
- 手机号或邮箱 + 验证码登录，首次设置 6 位支付码
- 发放社区积分时附一句备注，积分与备注同笔上链
- 社区徽章：颁发、待接收、确认后铸造
- 公共账户多人共同确认，达到门槛才生效
- 社区可一键部署属于自己的 ERC-20 积分
- 一个身份登录 Bai 等多个社区应用
复杂留给系统，简单留给用户
Nuxt/Vue 前端、Rails/PostgreSQL 后端、独立的链上核心模块；每个账户是一个 Safe 智能账户（ERC-4337），手续费由平台代付；贡献备注通过 RemarkLogicV1 合约写入链上；OAuth 2.0 让其他社区应用共用同一身份。
任何村庄都可以自己部署
前后端都提供 Docker 镜像构建文件，支持 PostgreSQL、短信与邮件服务配置；目前已支持 Optimism、Arbitrum One、以太坊主网与 Sepolia 四条链。代码公开在 GitHub，欢迎查看、使用和参与改进。
七个章节，从村子讲到合约
从南塘的“萝卜白菜规则”讲起，到问题、产品能力、登录与账户、手续费代付、链上备注、徽章、多人确认、统一登录、四条链与自行部署，适合想深入了解或参与共建的读者。
阅读完整版
选择中文或英文 PDF，下载后可离线阅读、转发或打印。
Semi · Full Introduction
Every contribution
deserves to be seen
Rural Co-construction Digital Identity (Semi)
A personal digital identity account for everyone building rural communities. Sign up with a phone number or email — no blockchain knowledge required. Cooking, weeding, painting walls, writing code: every contribution is recorded publicly and verifiably as community points and an on-chain remark.
Open source · GitHub
Safe + ERC-4337 smart account
Sponsored gas fees
OAuth 2.0 single sign-on
Overview
Five minutes on why Semi exists, what it is, what it does, and how it works.
Much of the work goes unremembered
Cooking a meal for everyone, weeding in the sun, organizing an event, sorting documents, leading an online class — warm and important work that traditional ledgers have no place for, so it survives only in personal favors. Records also get lost when people or systems change, and as people come and go, a community loses its shared yardstick.
A community passport plus a contribution ledger
The passport proves “you belong here”; the ledger records “what you have done for the community.” Blockchain sits underneath, but users never need to understand it — just as we use electricity without understanding generation. It grew out of Nantang, but it does not belong to Nantang alone — we hope it can benefit every community.
Six capabilities already built
- Phone or email + verification code; set a 6-digit payment code
- Community points with a remark, written on-chain in the same operation
- Community badges: issue, pending acceptance, mint on confirmation
- Shared accounts confirmed by multiple members above a threshold
- Communities can deploy their own ERC-20 points in one click
- One identity signs in to Bai and other community apps
Complexity for the system, simplicity for people
A Nuxt/Vue frontend, a Rails/PostgreSQL backend, and a standalone on-chain core. Every account is a Safe smart account (ERC-4337) with platform-sponsored gas. Remarks are written through the RemarkLogicV1 contract, and OAuth 2.0 lets other community apps share the same identity.
Any village can self-host
Both frontend and backend ship Docker build files and support PostgreSQL plus SMS and email providers. Four chains are supported: Optimism, Arbitrum One, Ethereum mainnet, and Sepolia. The code is public on GitHub — explore, use, and improve it.
Seven chapters, from a village to a contract
It starts with Nantang’s Radish & Cabbage Rules and moves through the problems, product capabilities, login and accounts, sponsored fees, on-chain remarks, badges, multi-signature confirmation, single sign-on, four chains, and self-hosting.
Read the full document
Choose the Chinese or English PDF to read offline, share, or print.