跳到主要内容

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

💡 概览

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

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

初学者提示

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

📖 您将学到什么

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

⚙ 设置您的环境

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

  • 安装部分中安装funcfiftlite-client二进制文件和fiftlib
  • 克隆并在CLI中打开其目录。
https://github.com/akifoq/multisig.git
cd ~/multisig

🚀 开始吧!

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

编译合约

使用以下命令将合约编译为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

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

您做到了,哈哈!🚀🚀🚀

接下来