dolphinnet

README

Dolphinet

🚀 高性能、EVM兼容的区块链

快速开始 • 架构 • 文档 • 贡献 • 许可证

✨ 什么是 Dolphinet？

Dolphinet 是一个高性能区块链平台。它提供了完整的 Layer 1 解决方案，包括共识层、执行层、部署工具和跨链通信能力。

🌟 核心特性

• ⚡ 高性能: 基于 OP Stack 的优化架构，提供低延迟和高吞吐量
• 🔒 安全可靠: 继承以太坊的安全模型，支持跨链验证
• 🔧 EVM 兼容: 完全兼容以太坊虚拟机，支持现有的智能合约和工具
• 🌉 跨链互通: 内置跨链消息传递和资产桥接功能
• 🛠️ 开发者友好: 完整的开发工具链和部署自动化

🚀 快速开始

环境要求

• Go 1.22+
• Node.js 18+
• Docker & Docker Compose
• Foundry (可选，用于智能合约开发)

克隆仓库

git clone https://github.com/Dolphinet-labs/Dolphinet.git
cd dolphinnet

本地开发网络

# 安装依赖
go mod download

# 启动本地开发网络
just devnet-up

# 查看服务状态
docker ps

运行节点

# 构建 dn-node
just dn-node

# 运行节点（连接到测试网）
./bin/dn-node \
  --network=op-sepolia \
  --l1=ws://localhost:8546 \
  --l1.beacon=http://localhost:4000 \
  --l2=ws://localhost:9001 \
  --p2p.listen.tcp=9222 \
  --p2p.listen.udp=9222 \
  --rpc.port=7000

🏗️ 架构

Dolphinet 采用了模块化架构，由多个核心组件组成：

┌─────────────────────────────────────────────────────────────┐
│                          Dolphinet                          │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐            │
│  │ dn-deployer │ │  dn-program │ │  dn-service │            │
│  │ (部署工具)   │ │ (故障证明)   │ │ (公共服务)  │            │
│  └─────────────┘ └─────────────┘ └─────────────┘            │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐            │
│  │   dn-node   │ │dn-supervisor│ │   common    │            │
│  │ (共识层)     │ │ (跨链监督)   │ │ (共享库)    │            │
│  └─────────────┘ └─────────────┘ └─────────────┘            │
├─────────────────────────────────────────────────────────────┤
│                    OP Stack (op-geth)                       │
└─────────────────────────────────────────────────────────────┘

核心组件

组件	描述	主要功能
dn-node	共识层客户端	区块构建、验证和中继（Layer 1）
dn-service	公共服务库	共享的区块链服务功能
dn-deployer	部署工具	自动化Layer 1链部署和配置
dn-program	证明程序	链下计算和证明生成
dn-supervisor	跨链监督器	跨链安全验证和依赖管理
common	共享库	合约、类型和工具函数

📚 文档

• 📖 官方文档 - 完整的用户和开发者指南
• 🏗️ 架构文档 - 技术规范和设计文档
• 🔧 API 文档 - Go 包文档
• 📋 贡献指南 - 如何参与项目开发

快速链接

• 节点运行指南
• 部署教程
• 故障证明说明
• 安全审核报告

🧪 测试

# 运行单元测试
go test ./...

# 运行集成测试
just test-integration

# 运行端到端测试
just test-e2e

🤝 贡献

我们欢迎所有形式的贡献！请查看我们的 贡献指南 了解详细信息。

开发环境设置

# 安装开发依赖
just install-dev

# 运行代码检查
just lint

# 格式化代码
just fmt

寻找任务

• 🐛 好初学者问题
• 📝 文档改进
• 🔧 功能请求

🌐 社区

加入我们的社区，获取帮助和分享想法：

• 💬 Discord - 日常讨论和技术支持
• 📧 论坛 - 治理讨论和提案
• 🐦 Twitter - 最新动态和公告

🔒 安全

我们非常重视安全性。如果您发现安全漏洞，请勿在公开渠道报告。请按照我们的 安全政策 进行报告。

• 🐛 漏洞赏金 - 通过 Immunefi 报告漏洞
• 📋 安全审计 - 已完成的审计报告

📄 许可证

本项目采用 MIT 许可证。有关更多信息，请查看 LICENSE 文件。

---

由 Dolphinet Labs 构建

GitHub • 文档 • Discord • Twitter