NEAR Protocol 核心节点完全指南

§1 学习目标

完成本文档后，你将能够：

• ✅ 理解 NEAR Protocol 的核心定位与技术架构
• ✅ 掌握 nearcore 作为参考实现的角色与价值
• ✅ 理解 NEAR 的共识机制与分片设计
• ✅ 熟练构建和运行 nearcore 节点
• ✅ 掌握智能合约开发（Rust + TypeScript）
• ✅ 理解 NEAR 的生态工具链
• ✅ 参与网络验证（Validator）
• ✅ 为 NEAR 协议贡献代码

§2 项目概述

2.1 什么是 NEAR Protocol？

NEAR Protocol（官方仓库：near/nearcore）是 NEAR 协议的参考实现，是一个为服务器级应用和智能合约提供支持的区块链基础设施。

官方描述：

NEAR’s purpose is to enable community-driven innovation to benefit people around the world. NEAR provides a developer platform where developers and entrepreneurs can create apps that put users back in control of their data and assets, which is the foundation of “Open Web” movement. NEAR Protocol is an infrastructure for server-less applications and smart contracts powered by a blockchain. NEAR Protocol is built to deliver usability and scalability of modern PaaS like Firebase at fraction of the prices that blockchains like Ethereum charge.

NEAR 的核心价值主张：

2.2 核心数据

Stars:     2,600 (2.6k)
Forks:     767
Watchers:  76
贡献者:   253 人
提交数:   9,774 次（master 分支）
分支数:   589 个
标签数:   387 个
发布版本:  247 个
最新版本:  2.10.7 (2026-03-04)
许可证:   Apache-2.0 / MIT
主要语言: Rust 88.8%, Python 8.2%, TypeScript 1.7%

2.3 NEAR 生态工具链

2.4 相关资源

§3 技术架构深度解析

3.1 协议架构

NEAR Protocol 是一个分片区块链，采用以下核心技术：

共识机制

NEAR 使用 Proof of Stake (PoS) 共识，通过验证者（Validator）质押 NEAR 代币来保护网络安全。

分片设计

NEAR 采用 Nightshade 分片方案：

• 将区块链状态分割成多个分片
• 每个分片由一组验证者处理
• 跨分片交易通过 receipts 机制处理

账户模型

NEAR 使用 基于合约的账户模型：

• 账户 ID 类似域名（如 alice.near）
• 账户由合约代码和存储组成
• 支持密钥对和多重签名

3.2 核心组件

3.3 目录结构

nearcore 仓库的目录结构如下：

§4 构建与运行

4.1 环境要求

4.2 从源码构建

# 克隆仓库
git clone https://github.com/near/nearcore
cd nearcore

# 安装 Rust（如未安装）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 构建发布版本
cargo build --release

# 二进制文件位于 target/release/neard

4.3 使用 Docker 运行

# 下载最新镜像
docker pull nearprotocol/nearcore:latest

# 运行本地测试节点
docker run -p 3030:3030 \
  -v ~/.near:/root/.near \
  nearprotocol/nearcore \
  neard run

4.4 连接到 NEAR 网络

连接到主网

# 初始化配置
neard init --network-id mainnet

# 运行节点
neard run

连接到测试网

neard init --network-id testnet
neard run

连接到开发网

neard init --network-id localnet
neard run

§5 智能合约开发

5.1 Rust 智能合约

NEAR 提供 near-sdk-rs 用于编写 Rust 智能合约。

项目结构

# 创建新项目
cargo new my-contract --lib
cd my-contract

# 添加依赖
# 在 Cargo.toml 中添加
[dependencies]
near-sdk = "5.0"
near-sdk-ops = "5.0"

编写合约示例

use near_sdk::borsh::{BorshDeserialize, BorshSerialize};
use near_sdk::store::Map;
use near_sdk::{env, near_bindgen, AccountId};

#[near_bindgen]
#[derive(BorshDeserialize, BorshSerialize)]
pub struct Contract {
    pub messages: Map<String, String>,
}

impl Default for Contract {
    fn default() -> Self {
        Self {
            messages: Map::new(b"m"),
        }
    }
}

#[near_bindgen]
impl Contract {
    pub fn add_message(&mut self, key: String, value: String) {
        self.messages.insert(key, value);
    }

    pub fn get_message(&self, key: String) -> Option<String> {
        self.messages.get(&key).cloned()
    }
}

编译合约

cargo build --target wasm32-unknown-unknown --release
# 输出位于 target/wasm32-unknown-unknown/release/my_contract.wasm

5.2 JavaScript/TypeScript 智能合约

NEAR 提供 near-sdk-js 用于编写 JavaScript/TypeScript 智能合约。

安装

npm install near-sdk-js

编写合约示例

import { NearBindgen, call, view } from "near-sdk-js";

@NearBindgen({})
class Contract {
  constructor() {
    this.messages = {};
  }

  @call
  addMessage({ key, value }) {
    this.messages[key] = value;
    return { success: true };
  }

  @view
  getMessage({ key }) {
    return this.messages[key] || null;
  }
}

编译合约

npx near-sdk-js build ./contract.js
# 输出: ./contract.wasm

5.3 部署合约

# 部署 Rust 合约
near deploy <account-id> ./target/wasm32-unknown-unknown/release/my_contract.wasm

# 部署 JS 合约
near deploy <account-id> ./contract.wasm

§6 NEAR CLI 使用

6.1 安装

npm install -g near-cli

6.2 登录认证

# 生成钱包并登录
near login

# 或使用密钥文件
near generate-key <account-id>

6.3 常用命令

账户操作

# 创建子账户
near create-account <sub-account>.<parent-account> --masterAccount <parent-account>

# 查看账户信息
near state <account-id>

# 删除账户
near delete-account <account-id> <beneficiary-account>

代币操作

# 转账
near send <sender> <receiver> <amount>

# 查看余额
near balance <account-id>

合约交互

# 调用合约方法（变更状态）
near call <contract-id> <method-name> '{"arg1": "value1"}' --accountId <account-id>

# 查看合约数据（只读）
near view <contract-id> <method-name> '{"arg1": "value1"}'

智能合约操作

# 部署合约
near deploy <account-id> <wasm-file>

# 查看合约代码
near code <account-id>

§7 验证者（Validator）指南

7.1 成为验证者的要求

7.2 质押 NEAR

# 委托给验证者
near stake <account-id> <validator-id> <amount>

# 查看当前验证者
near validators current

# 查看即将到来的验证者
near validators next

7.3 运行验证者节点

# 初始化验证者节点
neard init --validator

# 配置验证者密钥
cp ~/.near/validator_key.json ~/.near/validator_key.json.bak

# 编辑验证者配置
vim ~/.near/config.json

# 启动验证者
neard run

§8 协议开发贡献

8.1 开发工作流

NEAR 使用以下开发流程：

# 1. Fork 仓库
# 访问 https://github.com/near/nearcore 点击 Fork

# 2. 克隆你的 fork
git clone https://github.com/<your-username>/nearcore
cd nearcore

# 3. 添加上游仓库
git remote add upstream https://github.com/near/nearcore.git

# 4. 创建特性分支
git checkout -b feature/my-feature

# 5. 进行更改并提交
git commit -m "feat: add my feature"

# 6. 推送分支
git push origin feature/my-feature

# 7. 在 GitHub 上创建 Pull Request

8.2 代码规范

NEAR 使用以下工具确保代码质量：

# 格式化代码
cargo fmt

# Lint 检查
cargo clippy --all --benches --tests --examples

# 运行测试
cargo test

# 审计依赖
cargo deny check

8.3 测试

NEAR 有多层测试：

# 单元测试
cargo test --lib

# 集成测试
cargo test --test integration_tests

# 夜间测试（需要特殊配置）
cargo test --nightly

8.4 提交规范

NEAR 使用 Conventional Commits 规范：

<type>(<scope>): <subject>

feat(chain): add new consensus algorithm
fix(runtime): resolve batch transaction issue
docs(docs): update API documentation

§9 常见问题

Q1：nearcore 和 NEAR Protocol 是什么关系？

nearcore 是 NEAR Protocol 的参考实现，是用 Rust 编写的全节点软件。它实现了 NEAR 协议的所有规范，任何人都可以用它来运行 NEAR 网络的节点。

Q2：NEAR 和 Ethereum 有什么区别？

Q3：如何选择 Rust 或 JavaScript 编写合约？

Q4：NEAR 的代币经济模型是什么？

NEAR 使用以下代币机制：

• 总供应量: 10 亿 NEAR
• ** staking**: 验证者通过质押获得奖励
• Gas: 交易和合约执行消耗 Gas
• 存储: 使用存储需质押代币

Q5：如何获取 NEAR 测试网代币？

访问 NEAR 水龙头获取测试网代币：

https://faucet.testnet.near.org/

Q6：NEAR 支持哪些钱包？

§10 总结

10.1 核心优势

10.2 适用场景

10.3 项目信息

• 最新版本：2.10.7 (2026-03-04)
• Stars：2.6k
• Forks：767
• 贡献者：253 人
• 许可证：Apache-2.0 / MIT

10.4 参与贡献

NEAR 是一个开源项目，欢迎贡献：

• 阅读 CONTRIBUTING.md
• 加入 Discord
• 参与技术讨论 Zulip
• 查看 规范库

文档版本 1.0 | 撰写日期：2026-03-31 | 基于 2.10.7 (2026-03-04) | Stars: 2.6k ⭐