企业官网建设流程全解析

手把手教你使用Indy CLI：管理DID、钱包与分布式账本的实用指南

【免费下载链接】indy-sdkindy-sdk项目地址: https://gitcode.com/gh_mirrors/in/indy-sdk

Indy CLI是Indy SDK中一款功能强大的命令行工具，专为管理分布式身份(DID)、加密钱包和分布式账本交互设计。本指南将带你快速掌握其核心功能，轻松上手区块链身份管理。

Indy CLI核心功能概览

Indy SDK采用模块化架构设计，Indy CLI作为用户交互层，提供了对底层区块链身份功能的便捷访问。其核心功能包括：

• 分布式身份(DID)全生命周期管理：创建、导入、旋转密钥和查询DID
• 加密钱包管理：创建、打开、关闭和备份安全钱包
• 分布式账本交互：提交交易、查询状态和管理网络节点

Indy SDK架构概览图，展示了Indy CLI在整个系统中的位置和交互关系

快速开始：安装与配置

环境准备

首先克隆Indy SDK仓库到本地：

git clone https://gitcode.com/gh_mirrors/in/indy-sdk

Indy CLI的源代码位于项目的cli目录下，主要实现文件包括：

• 命令定义：cli/src/commands/wallet.rs
• 主程序入口：cli/src/main.rs

编译与运行

使用Cargo编译Indy CLI：

cd indy-sdk/cli cargo build --release

编译完成后，可通过以下命令启动CLI：

./target/release/indy-cli

首次启动时，系统会自动创建默认配置文件，你也可以通过linux-sample-config.json自定义配置。

钱包管理：安全存储身份信息

钱包是存储DID、密钥和其他敏感信息的安全容器。Indy CLI提供了完整的钱包生命周期管理功能。

创建新钱包

使用wallet create命令创建新钱包：

wallet create my_wallet key=my_secure_password

命令参数说明：

• name：钱包唯一标识符（必填）
• key：用于密钥派生的密码（必填）
• key_derivation_method：密钥派生算法（可选，默认argon2m）
• storage_type：存储类型（可选，默认default）

打开与关闭钱包

创建钱包后，需要打开才能使用：

wallet open my_wallet key=my_secure_password

完成操作后，应及时关闭钱包以确保安全：

wallet close

钱包列表与状态

查看当前已附加的钱包：

wallet list

Indy CLI钱包管理示意图，展示了钱包创建、打开和管理的流程

高级功能：导出与导入

备份钱包数据：

wallet export export_path=/backup/my_wallet_backup export_key=backup_password

从备份恢复钱包：

wallet import restored_wallet key=new_secure_password export_path=/backup/my_wallet_backup export_key=backup_password

DID管理：创建与使用分布式身份

DID（去中心化标识符）是Indy生态系统的核心，Indy CLI提供了全面的DID管理命令。

创建新DID

在打开的钱包中创建新DID：

did new

系统会生成一个随机DID和对应的验证密钥。如果需要指定种子（用于重现相同的DID）：

did new seed=00000000000000000000000000000My1

设置活跃DID

将某个DID设为当前活跃状态：

did use <did_value>

列出所有DID

查看钱包中存储的所有DID：

did list

密钥旋转

定期旋转DID的验证密钥是良好的安全实践：

did rotate-key

如果需要指定新的种子：

did rotate-key seed=00000000000000000000000000000My2

分布式账本交互：上链与查询

Indy CLI允许你直接与分布式账本交互，管理DID文档和验证信息。

连接到账本池

首先需要连接到一个账本池：

pool connect test_pool

向账本提交DID

将创建的DID及其验证密钥提交到账本：

ledger nym did=<did_value> verkey=<verkey_value>

查询账本信息

查询指定DID的信息：

ledger get-nym did=<did_value>

实用技巧与最佳实践

1. 安全管理密钥

• 始终使用强密码，并定期更换
• 不要在命令行直接输入密码，使用交互式输入
• 定期备份钱包，确保备份安全存储

2. CLI历史记录

Indy CLI支持命令历史记录，使用上下箭头键可快速访问之前的命令。历史记录保存在：

~/.indy-cli/history

3. 错误处理

如果遇到操作失败，可通过以下方式排查：

• 检查钱包是否已打开：wallet list
• 确认当前活跃DID：did list
• 验证池连接状态：pool list

总结

Indy CLI是管理分布式身份的强大工具，通过直观的命令集简化了复杂的区块链身份操作。本文介绍了钱包管理、DID创建和账本交互的核心功能，帮助你快速上手Indy生态系统。

要深入了解更多高级功能，可参考项目官方文档：

• Indy CLI设计文档
• 钱包导出导入功能
• 支付功能使用指南

通过Indy CLI，你可以轻松构建安全、去中心化的身份应用，为你的项目提供强大的身份基础设施支持。

【免费下载链接】indy-sdkindy-sdk项目地址: https://gitcode.com/gh_mirrors/in/indy-sdk