Tari命令行钱包最佳实践

翻译自官方链接

如果只是常规本地使用，可以只关注第2、3、4、8节。

在本指南中，我们将介绍让 Minotari 节点运行的基本知识，并解释安全运行 Minotari 进行交易所需的相关钱包的设置过程：

• 我们将教你如何建立你自己的Minotari节点
• 我们将介绍如何创建 Minotari 钱包作为资金存储，以及相应的设置供监控交易的只读钱包
• 我们将讨论如何监控区块链上的交易
• 我们将涵盖将资金存入钱包和从钱包中提取资金

本指南假设该节点只用作钱包，不会用作挖矿。

节点设置

为了接收 Tari，您需要有 Minotari 节点。虽然可以使用具有暴露给 Internet 的正确 gRPC 方法的公共节点，但建议您运行自己的节点。

运行多个节点作为备份以确保可用性也是值得的。

注意：对于所有连接到互联网的服务器，它们必须运行 Tor 客户端或配置其公共 IP 信息。关于这一点的文件可在这里和这里 。如果你运行在 Linux 上，Tari 应用程序有内置的 Tor 支持，所以可以忽略这一点。

第 1 节：创建 Minotari 节点并运行它

Minotari 节点是接收和监视事务所需的base layer节点。

注意：如果您使用的是公共 Minotari 节点，则可以跳过本节。请注意，您将需要有问题的公共节点的公钥和公共地址 ，以便正确地进行此交换指南。

1. 在这里下载已编译的二进制文件。如果你更喜欢从源代码编译，你需要按照这里的说明。
2. 使用此处的说明安装二进制文件。

注意：根据您的环境，安装文件的位置可能会发生变化。对于 Mac 和 Linux，您可能会在主目录的 .tari 文件夹中找到它。它可能是隐藏的，在这种情况下，您需要更改设置才能查看隐藏的文件。在 Windows 上，它将安装在您在安装过程中指定的位置。要让 Minotari 在特定位置创建文件夹，可以使用 --b path 命令。请注意，如果您不使用默认文件夹，则需要使用此命令。

安装后你将找到以下二进制文件。

• minotari_console_wallet
• minotari_merge_mining_proxy
• minotari_miner
• minotari_node
• randomx-benchmark
• randomx-codegen
• randomx-tests

进行交易所需的两个文件是 minotari_node 和 minotari_console_wallet

3. 启动节点（连续运行）：

minotari_node

如果一个节点尚未创建，它将通知您节点配置文件不存在。你也会被问到你是否想要进行挖矿。在这种情况下选择 n。

4. 接下来，系统将询问您是否希望创建节点标识。选择 y。这对于生成私钥/公钥对并让网络识别节点至关重要。

设置完成后，Minotari 基本节点启动。您将看到一个页面，其中列出了各种可用的命令模式（可通过 Ctrl+C 访问）命令。一些有用的是：

• watch status: 从命令模式返回到自动刷新状态
• version: 您正在运行的 Minotari Node 的版本
• whoami: 提供与节点相关的地址信息

5. 输入 whoami 然后按回车键。您将看到您的公钥、节点 ID、公共地址和 QR 码。您应该将此数据复制到文件或安全位置以供将来参考。

18:46 v1.0.0-pre.16 esmeralda State: Listening Tip: 3872 (Tue, 23 Jul 2024 14:27:53 +0000) Mempool: 0tx (0g, +/- 0blks) Connections: 0|0 Banned: 0 Messages (last 60s): 0 Rpc: 0/100 ️🔌
>> whoami
Public Key: 90f67a04edcb36261e6304ca213629d183c44e26bd47e38c253473f44d901733
Node ID: e8ed9a4fd38577b6b01e3b8e9d
Public Addresses: /onion3/f5qbkkfkoxowzvshe5mppzpgiiy76cwumpsacungeldoal6hehcgzfqd:18141
Features: PeerFeatures(MESSAGE_PROPAGATION | DHT_STORE_FORWARD)

6. 重新启动节点（Ctrl+C 两次退出，然后再次键入 minotari_node）。

第2节：创建钱包

在本节中，我们将创建用于接收资金的钱包地址。这个钱包将作为您的 Tari 币的主要存储库。

NB：这是这个过程中的关键一步。在安全环境中创建钱包并遵循说明对于保护此钱包并防止恶意行为者转移 Tari 非常重要。仔细阅读说明。如果对流程的任何部分有任何疑问，请联系 Tari 社区寻求澄清和帮助。

Minotari 钱包创建过程依赖于seed word phrase（种子短语）来生成相关的主密钥。这个种子短语也允许钱包的恢复。种子短语是从预定义的单词列表中生成的 24 个单词的短语，这些单词将在过程中显示。

建议：强烈建议在与任何其他设备或 Internet 断开连接的受信任计算机上执行此过程。在创建钱包以及注意和保护种子短语时应非常谨慎。

1. 首先，让我们创建一个文件夹来保存所有钱包数据。

mkdir tari_wallet_data
cd tari_wallet_data

注意事项：在钱包创建部分的多个位置，您将被引导复制或记录种子短语，密钥和其他信息。不要将这些文件存储在上面创建的文件夹中，因为您需要在后面的步骤中永久删除此文件夹。

2. 现在开始运行钱包，确保指定 --base-path 字段以保留上述文件夹中的所有数据，以便以后可以删除它。

minotari_console_wallet --base-path ~/tari_wallet_data

3. 你会看到一个菜单。本指南假设您是第一次设置 Minotari，请选择 1

Console Wallet

1. Create a new wallet.
2. Recover wallet from seed words or hardware device.
3. Create a read-only wallet using a view key.
>>

4. 你会被问到你是否想要挖矿。选择 n

Node config does not exist.
Would you like to mine (Y/n)?
NOTE: this will enable additional gRPC methods that could be used to monitor and submit blocks from this node.

5. 系统会询问您是否希望使用已连接的硬件钱包。在这里按 n。

Would you like to use a connected hardware wallet? (Supported types: Ledger) (Y/n)

6. 接下来，系统将要求您输入密码。您需要保存此密码以备将来使用。现在输入这个密码，然后再确认一次。在这样做的时候要小心。我们建议遵循最佳实践来生成强密码。

注意：您键入密码时不会看到命令行中的密码。

7. 下一步至关重要。确保没有信息泄漏，并且种子短语仅对您自己和/或受信任方可见。 输入密码后，您将看到您的种子单词。仔细记下种子词，把它们写下来，并确保它们是安全的。确保您有适当的，同样的安全备份。只有在输入 confirm 并按下 Enter 键后，您才能继续进行下一步。

=========================
       IMPORTANT!        
=========================
These are your wallet seed words.
They can be used to recover your wallet and funds.
WRITE THEM DOWN OR COPY THEM NOW. THIS IS YOUR ONLY CHANCE TO DO SO.

=========================
<...............seed words will be presented here.............>
=========================

I confirm that I will never see these seed words again.
Type the word "confirm" to continue.
>>

8. 此时，Minotari 钱包将在控制台界面中启动。

注意：以下部分将介绍钱包的配置。虽然没有必要，但额外的安全预防措施是确认您复制的种子单词实际上可以恢复钱包。

第3节：获取主钱包的地址

现在我们已经创建了钱包，我们将需要地址Tari Address one-sided来创建第二个钱包，该钱包将用于监控交易。

如果您按照上一节的说明进行操作，您应该已经进入 Minotari 控制台钱包界面。如果没有，请运行 minotari_console_wallet --base-path ~/tari_wallet_data 并输入密码以启动界面。

1. 在钱包界面中，按两次向右箭头进入 Receive 选项卡。此选项卡将列出与钱包关联的所有地址。

2. 复制提供的所有信息，特别注意 Tari Address one-sided 字段。这是用户将资金发送到交换的地址。
3. 按 f10 或 Ctrl+Q 退出钱包
4. 接下来，我们将导出钱包的view key（我们将在第 4 节中使用它）。运行以下命令，并在提示时输入钱包密码。

minotari_console_wallet --base-path ~/tari_wallet_data export-view-key-and-spend-key

您将看到类似于以下内容的信息：

1. ExportViewKeyAndSpendKey(ExportViewKeyAndSpendKeyArgs { output_file: None })

View key: cb6c13f07af23380c7756bbfcd622bc3277ec2cc42abd5ed3d8ddd19fa49060c
Spend key: f29039796b3430c6927f26bf216b6241dd7fad7f30a6640e8ac95f3d0af51a52
Minotari Console Wallet running... (Command mode completed)

Press Enter to continue to the wallet, or type q (or quit) followed by Enter.

5. 记下 view key 和 spend key；将它们复制到容易引用的地方。我们将在以后的步骤中要求它们。
6. 键入 q，然后按 Enter 退出控制台钱包。
7. 确保您已保存上述数据。永久删除文件夹 tari_wallet_data，并考虑销毁或安全擦除机器。（译者注：不一定销毁机器这么严重）

注意事项：在删除文件夹中的配置数据和/或销毁/擦除设备之前，务必检查记录的密钥、种子短语和地址。

第4节：设置只读钱包以接收存款

在本节中，我们将创建第二个钱包，即只读钱包，它将监视在上一节中保存的地址收到的资金。如果你正在进行一笔交易，这是你可以观察收到的资金的方式。这个钱包将需要能够联网。

注意：第二个钱包将无法发送任何资金。虽然这限制了钱包使用，但在配置任何可以访问链并与主钱包有某种关联的系统时，保持安全最佳实践是一个很好的做法。

1. 在连接到互联网的服务器上。运行 minotari_console_wallet 命令创建钱包。

注意：默认情况下，所有数据都存储在 ~/.tari 中。你可以在这里找到所有的日志、配置和数据。如果你想使用一个特定的文件夹，你可以使用 --base-path 参数来指向一个现有的文件夹或你之前为此目的创建的文件夹。

2. 你会被问到你是否想要挖矿。选择 n

Node config does not exist.
Would you like to mine (Y/n)?
NOTE: this will enable additional gRPC methods that could be used to monitor and submit blocks from this node.

3. 接下来，您将被询问是否要创建新钱包，恢复它，或使用视图密钥创建只读钱包。我们想创建一个只读钱包 ，所以我们在这里选择 3。

Console Wallet

1. Create a new wallet.
2. Recover wallet from seed words or hardware device.
3. Create a read-only wallet using a view key.
>>

4. 接下来我们将被要求输入密码。您需要保存此密码以备将来使用。现在输入此密码并确认。

注意：建议您在此处使用与创建第一个钱包时使用的密码不同的密码。

5. You will need to enter the view and spend keys noted in Section 4
   您需要输入第 3 节中提到的view key和spend key

Enter view key:  (hex)
<...view key here...>

Enter the public spend key:  (hex or base58)
<...public spend key here...>  

6. 您现在应该看到熟悉的控制台钱包。我们需要在其附带的配置文件中进一步配置它，所以现在按 f10 或 Ctrl+Q 关闭它并进入下一节。

第5节：配置只读钱包

1. 找到 ~/.tari/mainnet/config/config.toml 配置文件（或您指定的钱包配置文件夹中相应的文件），并在您最喜欢的文本编辑器中打开它。
2. 找到 Wallet Configuration Options (WalletConfig)部分。下面是 config.toml 文件中钱包配置部分开头的一个典型示例。

########################################################################################################################
#                                                                                                                      #
#                      Wallet Configuration Options (WalletConfig)                                                     #
#                                                                                                                      #
########################################################################################################################

[wallet]
# The buffer size constants for the publish/subscribe connector channel, connecting comms messages to the domain layer:
# (min value = 300, default value = 50000).
#buffer_size = 50000is

3. 接下来，找到行 #grpc_enabled = false 并将其更改为 grpc_enabled = true。您还需要取消对 grpc_address 的注释。

注意：如果您希望更安全的 gRPC，您可以编辑其他设置，如 grpc_authentication。让钱包的 gRPC 端口不能从公共互联网访问很重要

# Set to true to enable grpc. (default = false)
grpc_enabled = true
# The socket to expose for the gRPC base node server (default = "/ip4/127.0.0.1/tcp/18143")
grpc_address = "/ip4/127.0.0.1/tcp/18143"
# gRPC authentication method (default = "none")
#grpc_authentication = { username = "admin", password = "xxxx" }

4. 设置钱包的基本节点。将此值设置为您在第 1 节中创建或选择的 minotari_node。

Note: The format is <...public key...>::<...public address...>, with <...> being replaced with the addresses noted previously. Below is a sample of what these configuration settings look like, using the example data from Section 1. You should not use the data below, but insert your own details.
注意：格式为 <...public key...>::<...public address...>，其中 <...> 被替换为之前提到的地址。下面是这些配置设置的示例，使用第 1 节中的示例数据。您不应该使用下面的数据，而是插入您自己的详细信息。

# A custom base node peer that will be used to obtain metadata from, example
# "0eefb45a4de9484eca74846a4f47d2c8d38e76be1fec63b0112bd00d297c0928::/ip4/13.40.98.39/tcp/18189"
# (default = )
custom_base_node = "22d33b525d35d256674c5184c262b70d15275effcf5f6fe6dc0d359a18541d04::/onion3/6x54mmubphz5r3opswpuhseswivvlaxbohuqvwsn4o36zmtudq73dgid:18141"

5. 保存文件并重新启动钱包。

minotari_console_wallet

您现在可以接受存款了。在下一节中，我们将解释如何监听传入交易。

第6节：监听传入交易

如何监听传入的事务（以及如何处理它们）将取决于您的流程。在我们的示例中，我们将使用托管在我们刚刚创建的只读钱包中的 gRPC 服务器来监听传入的存款。

如果您想要以您最喜欢的语言提供示例，请联系我们。您可以在 wallet.proto 中找到有关可用方法的更多信息。

const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');

// Load the protobuf
const PROTO_PATH = './proto/wallet.proto';
const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
    keepCase: true,
    longs: String,
    enums: String,
    defaults: true,
    oneofs: true
});
const streamingProto = grpc.loadPackageDefinition(packageDefinition).tari.rpc;

// Create a client
console.log(streamingProto);
const client = new streamingProto.Wallet('localhost:18143', grpc.credentials.createInsecure());

const request = {};

// Call the gRPC method
const call = client.GetCompletedTransactions(request);

// Handle the stream of responses
call.on('data', (response) => {
    console.log('Received data:', response);
    // ..... Do business logic with transaction. E.g. compare the reference in payment_id to a reference provided to the exchange client and allocate
    // to their account
    // ....
});

call.on('end', () => {
    console.log('Stream ended.');
});

call.on('error', (err) => {
    console.error('Stream error:', err);
});

call.on('status', (status) => {
    console.log('Stream status:', status);
});

这是一个基本实现；对于生产环境，您可能需要考虑的一些其他项目包括：

• 使用 grpc.credentials.createSsl() 来保护钱包和任何调用它的应用程序之间的连接。我们不会在这里讨论创建服务器密钥或证书的过程；您可以在这里阅读更多关于该过程的信息。下面是一个例子：

// Load the protobuf definition
const PROTO_PATH = './proto/wallet.proto';
const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
    keepCase: true,
    longs: String,
    enums: String,
    defaults: true,
    oneofs: true
});
const streamingProto = grpc.loadPackageDefinition(packageDefinition).tari.rpc;

// Read the server's certificate (server.crt)
const serverCert = fs.readFileSync('path/to/server.crt'); // Specify the path to your server's certificate

// Create secure credentials for the client using the server's certificate
const credentials = grpc.credentials.createSsl(serverCert);

// Create the gRPC client with the secure credentials
const client = new streamingProto.Wallet('localhost:18143', credentials);

// Prepare the request object (you can modify this based on the method's requirements)
const request = {};

// Call the gRPC method with secure connection
const call = client.GetCompletedTransactions(request);

// Handle the stream of responses
call.on('data', (response) => {
    console.log('Received data:', response);
    // Process transaction data here. Example:
    // Compare the reference in payment_id to a reference provided to the exchange client and allocate to their account
});

call.on('end', () => {
    console.log('Stream ended.');
});

call.on('error', (err) => {
    console.error('Stream error:', err);
});

call.on('status', (status) => {
    console.log('Stream status:', status);
});

常规活动用法

第7节：交易所接收资金示例

每个交易所都有自己存入资金流程，下面是一个从 KYC 交易所存入资金流程的例子。

1. 客户开始存款过程。例如，点击 "Deposit" 按钮。
2. 交易所为存款生成一个长的唯一ID。这可以是客户端重复使用的单个reference，或者每个存款都可以有自己的reference。
3. 交易所提供他们的 Tari Address one-sided 地址和客户端的引用。交易所还必须将此引用保存在其内部数据库中。

注意：交易所应使用单边或非交互式地址，以便即使其基础设施处于离线状态，也可以接收存款。交互式地址用于点对点交易。

4. 客户使用 Tari Aurora 或其他支持 Tari 的钱包，并向提供的地址发送非交互式交易。他们必须包括reference的与此交易。

注意：例如，使用 Minotari 控制台钱包，建议用户将您的付款参考放在Payment ID字段中。

5. 这个过程类似于第 6 节中的示例，交易所定期运行脚本，以查看是否有任何新的交易。
6. 对于新的交易，与其内部数据库中的预期参考列表进行比较，如果有匹配，请调用内部系统将资金分配到客户的帐户。

第8节：从本地发送Tari币示例

在本节中，我们将从第 3 节中使用的同一地址执行取款。您还可以拥有多个不同的钱包并在它们之间发送资金。该过程基本相同，但超出了本文档的范围。

注意：用于支出资金的钱包不应联网超过必要的时间。建议运行此钱包的机器是安全的。

在我们花钱之前，我们必须用第 2 节第 7 步中创建的种子词设置一个钱包。

钱包设置完成后，继续下面的步骤。

1. 运行钱包更新余额

minotari_console_wallet --password <password> -p "wallet.custom_base_node=<...node_pub_key...>::<...node_pub_address...>" --auto-exit sync

注意：自定义基节点也可以设置为环境变量 TARI_WALLET__CUSTOM_BASE_NODE

2. 检查钱包里是否有足够的钱

minotari_console_wallet --password <password> -p "wallet.custom_base_node=<...node_pub_key...>::<...node_pub_address...>" --auto-exit get-balance

Minotari Console Wallet running... (Command mode started)
==============
Command Runner
==============

1. GetBalance

Available balance: 10000.000000 T
Time locked: 0 µT
Pending incoming balance: 27960.980255 T
Pending outgoing balance: 0 µT

Minotari Console Wallet running... (Command mode completed)

3. 接下来，将资金发送到所需的地址。

minotari_console_wallet --password <password> -p "wallet.custom_base_node=<node_pub_key>::<node_pub_address>" --auto-exit send-minotari <amount> <destination>

将 <amount> 和 <destination> 替换为要发送的金额和要将资金发送到的 Tari 地址。注：金额以 0.000001 XTM 为单位。要指定Tari金额，你可以附加字母 T.例如，send-minotari 10000 将发送 0.01 XTM 的量。send-minotari 10000 T 将发送 10000 XTM 的量。

交易所不应允许客户提供交互式 Tari 地址。这可以通过检查地址的第2个字节来轻松验证。具体来说，表示交互式钱包的字节在十六进制中是 01，在二进制中是 00000001。

具体来讲：

• 值为01（十六进制）
• 在二进制中，是0000001
• 最低有效位（最右边的位）为1，表示支持交互式交易