用 Cadence 加 MultiSign 实现 Flowns 合约管理权限分割

用 Cadence 加 MultiSign 实现 Flowns 合约管理权限分割

多签场景

Flowns && Lilico 根域名铸造权限授权

• 安全问题
• 如何在不影响 Flowns 现有根域名 fn 的主要业务的情况下将新的根域名权限授权给 Lilico 或其他的第三方
• 如何进行交易权限的确认，防止中间人攻击，或篡改交易内容，导致 Flowns 核心权限被窃取
• 如果未来出现第二个根域名合作伙伴，如何将他们的权限与现有的合作伙伴隔离，不至于互相影响

• 体验问题
• 如何解决用户手续费不足或者没有足够的 Flow 的情况下让其能够拥有初始化的资源
• 如何在高并发的情况下，保证多笔授权交易的请求不会阻塞甚至失败

安全问题

// 授权白名单配置
export const whitelist = {
	testnet: {
	'0x**********77cd': ['mintLilicoDomain'],
	},
	mainnet: {},
}


// 授权脚本定义
const scripts = {
	mintLilicoDomain: () => {
		const script = `Lilico mint script that only allow mint lilico root domain` // 这里的脚本是只允许 lilico 的根域名进行铸造 flowns 域名
		return script
	},
	// 或者未来需要授权的其他交易脚本
	otherScripts:() => {
	}
}

export const getScripts = (key) => {
	const scriptFunc = scripts[key]
	const script = scriptFunc ? scriptFunc() : ''
	return script
}

// 脚本验证
export const verifyTrx = (script, address) => {

	let whiteList = whitelist[network]
	let scriptList = whiteList[address]
	if (scriptList.len == 0) return false
	let scriptHash = sha3(script)

	var flag = false
	scriptList.forEach((key) => {
		let script = getScripts(key)
		let hashStr = sha3(script)
		if (scriptHash === hashStr) {
			flag = true
		}
	})
	return flag
}

接收 Raw transaction 并拼装与手动签名处理

import * as fcl from '@onflow/fcl'

// receive post request
const data = req.body

const { transaction } = data

// init fcl config
fclinit()

const {
	script,
	payerAddress,
	referenceBlockId,
	proposalKey,
	gasLimit,
	authorizers,
	payloadSignatures,
} = transaction

// 验证脚本是否是有权限
let verified = verifyTrx(script, payerAddress)

if (verified) {
	// 手动组装交易体
	let trxMsg = {
		script: script,
		refBlock: referenceBlockId,
		arguments: transaction.arguments,
		proposalKey: {
			address: proposalKey.address,
			keyId: proposalKey.keyIndex,
			sequenceNum: proposalKey.sequenceNumber,
		},
		payer: payerAddress,
		authorizers,
		payloadSigs: payloadSignatures,
		gasLimit: gasLimit,
	}
	// RLP encode 将交易体进行编码
	let msg = fcl.encodeTransactionPayload(trxMsg)
	// 对编码后的 msg 进行签名签名实现可见参考 <https://github.com/onflow/fcl-dev-wallet/blob/main/src/crypto.ts#L16>
	let signature = sign(msg)

	// 将签名的数据拼装至原交易体的 payloadSignatures 中并返回
	transaction.payloadSignatures = transaction.payloadSignatures.concat({
		address: flownsAddr,
		keyIndex: 0,
		signature,
	})

	// 返回签名后的交易数据，交由第三方进行最后签名并发送
	return res.json(transaction)

• 通过监听 post 请求接受外部第三方的传递而来的 transaction 参数

• 解构 transaction 参数

• 校验授权地址和对应的脚本权限

• 拼装 fcl 支持的 raw transaction 数据

• RLP encode 交易数据(payload)生成 message

• 使用本地私钥调用本地签名函数签名 message

• 拼装签名信息至原交易数据的 payloadSignatures 数组中

• 返回签名后的结果

 import Domains from ${flownsAddr} // 地址会根据不通的网络进行替换做到测试网和主网通用脚本
  import Flowns from ${flownsAddr}
  import NonFungibleToken from ${flowNonFungibleAddr}
  import FungibleToken from ${flowFungibleAddr}

  // 参数只保留域名名称
  transaction(name: String) {
    let client: &{Flowns.AdminPrivate}
    let receiver: Capability<&{NonFungibleToken.Receiver}>
	// 这里使用到了三方的授权，用户，lilico 和 Flowns
    prepare(user: AuthAccount, lilico: AuthAccount, flowns: AuthAccount) {
      let userAcc = getAccount(user.address)
      // check user balance
	  // 防止用户因余额不够导致无法初始化域名 collection 资源
      let userBalRef = userAcc.getCapability(/public/flowTokenBalance).borrow<&{FungibleToken.Balance}>()
      if userBalRef!.balance < 0.001 {
        let vaultRef = flowns.borrow<&FungibleToken.Vault>(from: /storage/flowTokenVault)
        let userReceiverRef =  userAcc.getCapability(/public/flowTokenReceiver).borrow<&{FungibleToken.Receiver}>()
        userReceiverRef!.deposit(from: <- vaultRef!.withdraw(amount: 0.001))
      }

      // init user's domain collection
	  // 如果用户还没有域名资源，则帮助用户初始化
      if user.getCapability<&{NonFungibleToken.Receiver}>(Domains.CollectionPublicPath).check() == false {
        if user.borrow<&Domains.Collection>(from: Domains.CollectionStoragePath) != nil {
          user.unlink(Domains.CollectionPublicPath)
          user.link<&Domains.Collection{NonFungibleToken.CollectionPublic, NonFungibleToken.Receiver, Domains.CollectionPublic}>(Domains.CollectionPublicPath, target: Domains.CollectionStoragePath)
        } else {
          user.save(<- Domains.createEmptyCollection(), to: Domains.CollectionStoragePath)
          user.link<&Domains.Collection{NonFungibleToken.CollectionPublic, NonFungibleToken.Receiver, Domains.CollectionPublic}>(Domains.CollectionPublicPath, target: Domains.CollectionStoragePath)
        }
      }

      self.receiver = userAcc.getCapability<&{NonFungibleToken.Receiver}>(Domains.CollectionPublicPath)
      self.client = flowns.borrow<&{Flowns.AdminPrivate}>(from: Flowns.FlownsAdminStoragePath) ?? panic("Could not borrow admin client")
    }
    execute {
      self.client.mintDomain(domainId: 2, name: name, duration: 3153600000.00, receiver: self.receiver) // 这里将根域名 id 与租用时限进行硬编码
    }
 }

• 交易参数：只保留了域名名称参数，简化了第三方调用和操作

• 授权参数(prepare)： 这里使用到了三个签名的授权，这笔交易需要三份签名才能够执行，我们也会在交易体中看到 authorizers 中是三个地址，同时 payloadSignatures 也需要三个签名的元素
• 用户 —— 交易的发起方 ，也就是申请 Lilico 根域名的用户(proposer)
• Lilico —— 交易的校验和授权方，交易手续费的支付方(payer)
• Flowns —— 铸造权限授权方(Flowns admin)

• 另外在脚本里做了两个判断
• 判断用户的 Flow 余额是否足够初始化 Flowns Collection 资源， 如果不够，则通过 Flowns 的账户进行补贴
• 判断用户是否已经初始化了 Flowns Collection ，如果没有则帮助用户初始化 Collection

• 执行代码块中，将管理权 mintDomain 的权限通过硬编码参数进行了权限隔离，该脚本只允许调用 RootDomainId 为 2 的根域名，也就是说只能通过 Lilico 的根域名发行 Flowns 域名，也就自然而然的隔离了其他根域名的权限。

{
  script: 'Cadence script ...', // Cadence 交易脚本
  refBlock: 'd719c892c80b45de3d19c459dc7eeba8ab809b5f3b007a51c69f697b7eb42361', // 引用的区块 ID
  arguments: [ { type: 'String', value: 'Test' } ], // Cadence 交易的参数
  proposalKey: { address: '0xe242ccfb4b8ea3e2', keyId: 0, sequenceNum: 480 }, // 交易发起人的信息
  payer: '0xc6de0d94160377cd', // 交易费用支付人信息
  authorizers: [ '0xe242ccfb4b8ea3e2', '0xc6de0d94160377cd', '0xb05b2abb42335e88' ],
  gasLimit: 1000,
  payloadSignatures: [
    {
      address: '0xe242ccfb4b8ea3e2',
      keyIndex: 0,
      signature: '9aa7ca757c0c995d1cc11b71c6c5d3b83be92708905c8ba4528fadc602438acd027b479e1546f9ed96a3c9f8df424eccd318333c7f55378ce4994b164972c450'
    },{...},{...}
  ],
  envelopeSignatures: [
    {
      "address": "0x01",
      "keyId": 1,
      "sig": "0xabc123"
    }
  ]
}

具体流程

注意事项

最后