Skip to content

v0id-byte/v0idchain

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

352 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

v0idChain — 匿名网络 · 区块链 · 链上游戏

English | 中文

CI License: MIT Node PRs welcome GitHub stars

一个从零手搓的 TypeScript 项目,长出了三块能跑的东西:一个 Tor 式洋葱匿名网络(v0idnet)、它脚下的自建区块链($V0ID)、以及一个全链上的像素游戏。pnpm monorepo,tsx 直跑、无构建步——一整套系统可从头读到尾

诚实说在前:这是自建/学习级实现(不是经过审计的生产密码学)。匿名网络在设计上是真的、但规模小=匿名弱。各模块按真实成熟度诚实介绍。


🧅 v0idnet —— .v0id 洋葱匿名网络(主角)

→ 模块文档 docs/v0idnet/ · 架构与原理(含图)

类 Tor 的洋葱匿名网络:访客与服务器经 3 跳加密电路通信,.v0id 隐藏服务让收发双方互不知 IP。区块链当去中心化中继目录(回放链即得一致名单,替代 Tor 目录权威)。

  • 浏览 / 托管 .v0id 隐藏服务 · 跑中继 · Mixnet(opt-in)· 质押激励层(已建,height 16000 激活)
  • 下载 v0id 浏览器(签名公证 macOS app):browser-v0.2.6 · Win/Linux 敬请期待
  • 线上网络:种子 mc.void1211.com:6001 + 5 中继(AWS ×3 + RackNerd ×2),真 3 跳电路已验证

⛓ v0idChain —— $V0ID 区块链(底座)

→ 模块文档 docs/blockchain/ · 开节点 · 完整教程

手写区块 / 哈希 / PoW 挖矿(自适应难度 + 比特币式重定向 + 最大工作量链)/ ed25519 签名 / WebSocket P2P。币靠挖矿产生,转账付手续费(gas)给矿工。v0idnet 与游戏都跑在它上面。

  • 转账 · 链上消息(烧币进虚空)· 全网唯一昵称 · 端到端加密私信 · 红包 · 集市
  • 一切社交/游戏/匿名功能都用 memo 约定叠在链上,大多不改共识

✅经认证的公共节点:节点列表

🤔想看示范网址?

http://n7gflua3d4zzwkmzzmwvonjtht7g34krrujzzn7w5nruu2q4cf7ipoab.v0id/

🎮 链上游戏 —— 像素社交世界 game.void1211.com 即可开玩!

→ 模块文档 docs/game/

一个全链上的像素社交世界:收集崽/NFT、种植、钓鱼、挖矿采集,喂养一个虚空图鉴收藏 meta。完全建在区块链的 memo 约定之上(不改共识)。


快速上手

corepack pnpm install                 # Node ≥ 22.13,仓库自带 pnpm
# 跑一个节点 + 挖矿(详见各模块文档)
corepack pnpm exec tsx packages/cli/src/index.ts start --mine --peers ws://mc.void1211.com:6001

# 或用 Docker 一条命令起节点接入实网:
docker build -t v0idchain . && docker run --rm v0idchain

仓库结构

目录 内容
packages/core 链 + 洋葱协议 + 游戏逻辑(onion* hs* mixnet / pets farm fishing mine)
packages/node P2P + 本地 API + 中继子系统(relay/*)
packages/cli v0id 命令行守护进程
packages/game-server · game-web · web 游戏服务/前端 · web 钱包
clients/desktop v0id 浏览器(Electron)
docs/{v0idnet,blockchain,game}/ 三大模块文档

参与贡献

想加入?先看 ROADMAP.md——它讲项目方向 + 代币价值主线($V0ID = 让开放匿名网络不靠监控就能抵御滥用/女巫/审查的经济层)+ 新人任务。开发环境、跑测试、模块地图见 CONTRIBUTING.md不懂共识也能贡献:文档、i18n、测试、Docker、像素美术都欢迎。参与请遵守行为准则

⚠️ 免责声明

v0idChain 是实验性、教学性测试网:代币无货币价值、非投资标的;匿名网是研究级实现(非审计生产密码学,小规模 = 弱匿名);用户自负本地合规责任;项目不托管、不背书、不促成任何非法内容。完整声明见 DISCLAIMER.md

诚实边界与署名

匿名集小 = 弱匿名;不防全局被动对手 / 应用层去匿名;激励 v1 中心化测量。各模块文档有详细的诚实边界。第三方代码许可与署名见 THIRD-PARTY-NOTICES.md;v0idnet 思想借鉴 Tor / Nym / Orchid / Lokinet(见各文件头与 ARCHITECTURE §9)。

About

⛓ v0idChain — From-scratch TypeScript blockchain powering v0idnet (onion routing anonymous network) + fully on-chain pixel social game | Adaptive PoW, ed25519, WebSocket P2P, memo-based game logic | Educational $V0ID project with live network · 从零手写 TypeScript 区块链驱动的匿名网络(v0idnet)+ 全链上像素社交游戏 | 自适应 PoW + ed25519 + P2P + memo 逻辑 | 教学向 $V0ID · 真实运行中

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors