如何制作一个简单的多签合约

💡 概览

本教程将帮助您学习如何部署您的多签合约。回想一下，(n, k)多签合约是一个有n个私钥持有者的多签钱包，如果请求（又称订单、查询）至少收集到持有者的k个签名，则接受发送消息的请求。

基于akifoq对原始多签合约代码的更新：

原始TON区块链多签代码.multisig-code.fc
akifoq/multisig，带有fift库以使用多签。

初学者提示

对多签不熟悉的人可以看：什么是多签技术？(视频)

📖 您将学到什么

如何创建和定制一个简单的多签钱包。
如何使用轻客户端部署多签钱包。
如何签署请求并将其作为消息发送到区块链。

⚙ 设置您的环境

在我们开始之前，检查并准备您的环境。

从安装部分中安装func、fift、lite-client二进制文件和fiftlib。
克隆库并在CLI中打开其目录。

https://github.com/akifoq/multisig.git
cd ~/multisig

🚀 开始吧！

将代码编译为fift。
准备多签所有者的密钥。
部署您的合约。
与区块链中部署的多签钱包进行交互。

编译合约

使用以下命令将合约编译为Fift：

func -o multisig-code.fif -SPA stdlib.fc multisig-code.fc

准备多签所有者密钥

创建参与者密钥

要创建一个密钥，您需要运行：

fift -s new-key.fif $KEY_NAME$

其中KEY_NAME是将写入私钥的文件的名称。

例如：

fift -s new-key.fif multisig_key

我们将收到一个包含私钥的multisig_key.pk文件。

收集公钥

此外，脚本还会以以下格式发出一个公钥：

Public key = Pub5XqPLwPgP8rtryoUDg2sadfuGjkT4DLRaVeIr08lb8CB5HW

在"Public key = "之后的任何内容都需要保存在某个地方！

让我们将其存储在keys.txt文件中。每行一个公钥，这很重要。

部署您的合约

通过轻客户端部署

创建所有密钥后，您需要将公钥收集到文本文件keys.txt中。

例如：

PubExXl3MdwPVuffxRXkhKN1avcGYrm6QgJfsqdf4dUc0an7/IA
PubH821csswh8R1uO9rLYyP1laCpYWxhNkx+epOkqwdWXgzY4

之后，您需要运行：

fift -s new-multisig.fif 0 $WALLET_ID$ wallet $KEYS_COUNT$ ./keys.txt

$WALLET_ID$ - 分配给当前密钥的钱包号。对于每个使用相同密钥的新钱包，建议使用唯一的 $WALLET_ID$ 。
$KEYS_COUNT$ - 确认所需的密钥数量，通常等于公钥数量

wallet_id 解释

使用相同的密钥（Alice密钥，Bob密钥）可以创建许多钱包。如果Alice和Bob已经有treasure怎么办？这就是为什么 $WALLET_ID$ 在这里至关重要。

脚本将输出类似于以下的内容：

new wallet address = 0:4bbb2660097db5c72dd5e9086115010f0f8c8501e0b8fef1fe318d9de5d0e501

(Saving address to file wallet.addr)

Non-bounceable address (for init): 0QBLuyZgCX21xy3V6QhhFQEPD4yFAeC4_vH-MY2d5dDlAbel

Bounceable address (for later access): kQBLuyZgCX21xy3V6QhhFQEPD4yFAeC4_vH-MY2d5dDlAepg

(Saved wallet creating query to file wallet-create.boc)

信息

如果您遇到“公钥必须为48个字符长”的错误，请确保您的keys.txt具有unix类型的换行符 - LF。例如，可以通过Sublime文本编辑器更改换行符。

提示

最好保留可弹回地址 - 这是钱包的地址。

激活您的合约

您需要向我们新生成的_treasure_发送一些TON，例如0.5 TON。

之后，您需要运行轻客户端：

lite-client -C global.config.json

如何获取global.config.json？

您可以为主网或测试网获取最新的配置文件global.config.json。

启动轻客户端后，最好在轻客户端控制台运行time命令，以确保连接成功：

time

好的，轻客户端工作正常！

之后，您需要部署钱包。运行命令：

sendfile ./wallet-create.boc

之后，钱包将在一分钟内准备好可供使用。

与多签钱包进行交互

创建请求

首先，您需要创建一个消息请求：

fift -s create-msg.fif $ADDRESS$ $AMOUNT$ $MESSAGE$

$ADDRESS$ - 发送代币的地址
$AMOUNT$ - 代币的数量
$MESSAGE$ - 被编译消息的文件名。

例如：

fift -s create-msg.fif EQApAj3rEnJJSxEjEHVKrH3QZgto_MQMOmk8l72azaXlY1zB 0.1 message

提示

要为您的交易添加评论，请使用-C comment属性。要获取更多信息，请在没有参数的情况下运行_create-msg.fif_文件。

选择钱包

接下来，您需要选择一个要发送代币的钱包：

fift -s create-order.fif $WALLET_ID$ $MESSAGE$ -t $AWAIT_TIME$

其中

$WALLET_ID$ — 是由此多签合约支持的钱包的ID。
$AWAIT_TIME$ — 智能合约将等待多签钱包所有者对请求签名的时间（以秒为单位）。
$MESSAGE$ — 上一步中创建的消息boc文件的名称。

信息

如果在请求得到签名之前，时间等于 $AWAIT_TIME$ 这样的条件已经过去了，请求将过期。通常，$AWAIT_TIME$等于几个小时（7200秒）

例如：

fift -s create-order.fif 0 message -t 7200

准备好的文件将保存在order.boc中

信息

order.boc需要与密钥持有者共享，他们必须对其进行签名。

签署您的部分

要签名，您需要执行：

fift -s add-signature.fif $KEY$ $KEY_INDEX$

$KEY$ - 包含签名私钥的文件的名称，不带扩展名。
$KEY_INDEX$ - keys.txt中给定密钥的索引（从零开始）

例如，对于我们的multisig_key.pk文件：

fift -s add-signature.fif multisig_key 0

创建消息

在每个人都签署了订单后，需要将其转换为钱包的消息，并再次使用以下命令进行签名：

fift -s create-external-message.fif wallet $KEY$ $KEY_INDEX$

在这种情况下，只需要钱包所有者的一个签名即可。这样做的想法是，您无法使用无效签名攻击合约。

例如：

fift -s create-external-message.fif wallet multisig_key 0

将签名发送到TON区块链

之后，您需要再次启动轻客户端：

lite-client -C global.config.json

最后，我们要发送我们的签名！只需运行：

sendfile wallet-query.boc

如果其他人都签署了请求，它将被完成！

您做到了，哈哈！🚀🚀🚀

接下来

阅读更多关于TON中多签钱包的信息，来自akifoq。

💡 概览​

📖 您将学到什么​

⚙ 设置您的环境​

🚀 开始吧！​

编译合约​

准备多签所有者密钥​

创建参与者密钥​

收集公钥​

部署您的合约​

通过轻客户端部署​

激活您的合约​

与多签钱包进行交互​

创建请求​

选择钱包​

签署您的部分​

创建消息​

将签名发送到TON区块链​

接下来​