FT MetadataViews 与 Switchboard

• 本次的更新升级只部署在测试网, 新的特性需要新版本的 Cadence 支持

• 原有的 FT 合约不强制升级, 不升级不会影响使用

• 用户已经初始化过的 Vault 的资源也不需要重新初始化, 如果合约实现进行函数升级, 则用户已经初始化的资源会自动继承

• 除了包含基础的 FT 信息之外, 也会包含资源信息和类型信息(猜测是为了链上信息聚合展示做准备)

• 同 NFTMetadataView 类似, FTMetadataView 也具备展示类型扩展的能力, 可以支持未来更多的 Metadata 种类.

• FungibleTokenSwitchboard 作为一个额外的路由资源, 保存了用户账户下的 FT Receiver 资源, 能够作为一个路由通过一个资源接收多种 FT token

FungibleTokenMetadataViews

• FTDisplay 包含了 FT 展示所需要的信息, 名称, 符号, 描述, 外部链接, Logo 链接和一些社交账号的链接, 可以理解为 Token 的基本信息

• FTVaultData 这是包含了 FT Vault 的资源信息和接口的一些类型信息,这里还包含了一个创建 Vault 的初始化函数 createEmptyVault

pub fun getViews(): [Type] {
     return []
   }

pub fun resolveView(_ view: Type): AnyStruct? {
    return nil
  }

注意: 这里 FungibleToken 的改动略有不同.因为增加了 Balance 接口类型中的实现函数, 会导致现有部署在网络中继承了 FungibleToken.Balance 的资源出现问题, (正常来讲这样继承了 FungibleToken.Balance 却没有实现 getViews 和 resolveView 的合约是无法正常部署的)在和 B.T.Wood 讨论时候他告诉我了一个 Cadecne 最近的更新 概括来说是如果继承了接口的资源即使没有实现接口定义的方法,这会使用接口自身的默认方法, 这样就不会出现上述问题.这个 feature 将会在未来的 spork 更新.

 pub fun getViews(): [Type]{
     return [Type<FungibleTokenMetadataViews.FTView>(),
        Type<FungibleTokenMetadataViews.FTDisplay>(),
        Type<FungibleTokenMetadataViews.FTVaultData>()]
        }

FungibleTokenSwitchboard

 pub resource Switchboard: FungibleToken.Receiver, SwitchboardPublic {

        access(contract) var receiverCapabilities: {Type: Capability<&{FungibleToken.Receiver}>}
        //....

}

• addNewVault 支持通过 Capability 添加新的 Vault 路由到 Switchboard

• addNewVaultsByPath 通过资源路径的数组批量添加到 Switchboard

• removeVault 移除

  pub fun deposit(from: @FungibleToken.Vault) {
            // Get the capability from the ones stored at the switchboard
            let depositedVaultCapability = self
                .receiverCapabilities[from.getType()]
                ?? panic ("The deposited vault is not available on this switchbard")
            // Borrow the reference to the desired vault
            let vaultRef = depositedVaultCapability.borrow()
                ?? panic ("Can not borrow a reference to the the vault")
            vaultRef.deposit(from: <-from)
        }

• getVaultTypes 获取支持接收的 Vault 类型

• deposit 同上

• safeDeposit 安全的充值函数, 即使失败也不会引起 Panic 而是返回 @FungibleToken.Vault 资源
• 和 Deposit 相同, 接收 @FungibleToken.Vault 资源
• 会先做判断 receiverCapabilities 是否有配置对应资源的接收资源
• 如果没找到且充值金额大于零, 则触发充值失败的事件, 并将充值的 @FungibleToken.Vault 资源返回
• 否则直接销毁充值资源并返回 nil

 pub fun safeDeposit(from: @FungibleToken.Vault): @FungibleToken.Vault? {
            // Try to get the proper vault capability from the switchboard
            // If the desired vault is present on the switchboard...
            if let depositedVaultCapability = self
                                        .receiverCapabilities[from.getType()] {
                // We try to borrow a reference to the vault from the capability
                // If we can borrow a reference to the vault...
                if let vaultRef =  depositedVaultCapability.borrow() {
                    // We deposit the funds on said vault
                    vaultRef.deposit(from: <-from.withdraw(amount: from.balane))
                }
            }
            // if deposit failed for some reason
            if from.balance > 0.0 {
                emit NotCompletedDeposit(type: from.getType(),
                                        amount: from.balance,
                                        switchboardOwner: self.owner?.address)
                return <-from
            }
            destroy from
            return nil
        }

NFT borrowNFTSafe

最后