near-subaccount

⛓️ NEAR 区块链子账户管理专家

基于 NEAR CLI 的子账户管理工具,支持批量创建删除及代币分发,简化区块链账户运维流程。

收藏
6.7k
安装
2.3k
版本
v1.0.1
CLS 安全性认证2026-05-17
点击查看完整报告 >

使用说明

核心用法

NEAR Subaccount Manager 是一款基于 NEAR CLI 的命令行工具,专为简化 NEAR 区块链账户管理而设计。该技能提供四大核心功能:通过 near-subaccount create 创建子账户,仅需指定子账户名称和主账户即可快速生成形如 wallet.myaccount.near 的账户;使用 near-subaccount list 可批量检索并展示指定账户下的所有子账户;通过 near-subaccount delete 可清理不再需要的子账户;而 near-subaccount distribute 则支持从 JSON 文件读取子账户列表,实现 NEAR 代币的批量分发,默认每笔转账 0.1 NEAR,极大提升了资金分配效率。

显著优点

该工具的最大优势在于其操作的高效性和便捷性。对于需要管理大量测试账户或进行批量空投的开发者而言,手动创建和管理子账户极为繁琐,而此技能通过简单的命令行接口将复杂操作抽象化,显著降低了操作门槛。批量分发功能支持自定义转账金额,适合测试网环境下的多账户资金配置。此外,工具依赖官方 NEAR CLI,保证了与区块链交互的可靠性,且采用 MIT 开源协议,代码透明可审计,功能描述清晰准确。

潜在缺点与局限性

然而,该技能存在严重的安全隐患。安全检查发现其使用 child_process.exec 直接拼接用户输入到 shell 命令,存在明显的命令注入漏洞,恶意构造的账户名称可能执行任意系统命令。同时,工具缺乏必要的输入验证机制,未对 NEAR 账户名称格式进行校验,也未对 JSON 文件内容进行深度验证。更为严重的是,删除账户和资金转账等高危操作缺乏二次确认机制,一旦误操作将导致不可逆的资金损失。此外,工具网络配置硬编码为 testnet,切换主网需修改源码,且未声明 NEAR CLI 的版本要求,可能存在兼容性问题。

适合的目标群体

该技能主要适合以下用户群体:NEAR 区块链的个人开发者和测试人员,特别是需要在测试网环境下批量创建和管理子账户的用户;进行智能合约测试时需要大量测试账户的 QA 工程师;以及熟悉命令行操作、具备基本区块链知识的技术用户。对于生产环境中管理高价值主网账户的场景,强烈不建议使用当前版本,直至修复安全漏洞。

使用风险

使用该技能需警惕多重风险。资金风险方面,删除账户操作不可逆,虽然资金会转回主账户,但过程存在失误可能;批量转账若无确认机制容易造成误转。安全风险方面,命令注入漏洞可能导致系统被攻击者控制,特别是在处理不可信来源的账户名称时风险极高。操作风险方面,缺乏输入验证可能导致无效交易浪费 Gas 费,网络配置错误可能导致误操作主网资产。建议仅在隔离的测试环境中使用,并严格审查所有输入参数,避免使用特殊字符。

安全解读

核心功能

near-subaccount 是 NEAR 区块链生态的子账户管理工具,以命令行封装器形式提供四大核心能力:子账户创建、列表查询、账户删除,以及基于 JSON 配置的批量 NEAR 代币分发。其设计目标是为开发者提供比原生 NEAR CLI 更友好的交互体验,同时保留完整的链上操作能力。

显著优点

架构精简可靠:纯 Node.js 内置模块实现(child_processfsutil),零第三方依赖,依赖攻击面趋近于零。代码仅 174 行分布于 5 个文件,审计友好度高。

操作原子化:批量分发功能支持通过 JSON 文件定义目标子账户列表,单次执行多笔转账,大幅降低重复操作成本,适合空投、工资分发、多账户归集等场景。

透明可验证:所有区块链交互均通过本地 NEAR CLI 代理执行,不直接发起网络请求,用户可通过 NEAR CLI 日志完整审计每笔交易。

潜在局限与风险

代码执行依赖:核心功能依赖 child_process.exec 调用 NEAR CLI,虽参数经模板化处理,但仍存在理论上的命令注入边界。当前版本未对 subaccountName 等输入强制执行 NEAR 账户命名规范校验(仅允许小写、数字、连字符、下划线、点号)。

维护者单点:来源为 GitHub 个人账号(shaiss),无企业或基金会背书,长期维护可持续性需持续关注。

功能边界限制:本质为 CLI 包装层,不提供更高级的账户恢复、权限管理、多签等复杂功能,亦不支持非 NEAR 生态的区块链。

适合人群

  • NEAR 生态开发者,需批量管理测试网/主网子账户
  • 运营团队执行空投、奖励分发等批量转账场景
  • 希望以脚本化方式集成 NEAR 账户管理的 DevOps 工程师

常规风险

  • 操作不可逆:链上删除账户、转账均为最终性操作,误操作将导致资产永久损失
  • 私钥暴露:依赖 NEAR CLI 的配置文件存储私钥,需确保运行环境安全
  • gas 费波动:批量操作需预留充足 NEAR 余额以覆盖网络拥堵时的 gas 成本

near-subaccount 内容

scripts文件夹
手动下载zip · 3.4 kB
subaccount.jstext/javascript
请选择文件