华为云用户手册

查询数字资产描述信息 根据集合标识和内容标识符查询其metadata信息。 调用方法 public function tokenURI(string $collectionIndex, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^63)。 返回值 类型 说明 Metadata 数字资产对应的meta信息。 父主题： ERC721业务接口

查询可组合资产的根所有者 遍历查询可组合资产的父所有者，获得可组合资产的根所有者。 调用方法 public String rootOwnerOf(String collectionIndex, String tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex string 必填参数，可组合资产的集合唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 tokenId string 必填参数，可组合资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 string 根所有者的身份标识符，例如地址。 父主题： ERC998业务接口

设置资产流转限制 创建者有权限修改集合内数字资产的流转限制，包括流转次数和每次流转之间的间隔天数。例如，希望每个资产仅可以流转2次，每次流转间隔时间需大于100天，可以设置times=2，duration=100。 调用方法 public String setCollectionLimit(String collectionIndex, int times, int duration) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 times Int 必填参数，流转次数[0-1000]，0表示不限制。 duration Int 必填参数，流转间隔天数[0-1000]，0表示不限制。（当前参数未启用，设置不生效，后续版本支持) 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： 通用接口

转移数字资产所有权 将指定集合中的指定数字资产的所有权，从from转移到to用户。 调用方法 public function safeTransferFrom(string $from, string $to, ID $id) throws Exception 参数说明 参数 类型 说明 from String 必填参数，所有者身份标识符。 to String 必填参数，接受者身份标识符。 id ID 必填参数，数字资产标识。可以通过generateID方法根据集合标识符和数字资产编号生成。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： ERC1155业务接口

生成数字资产标识 根据集合标识符和数字资产编号生成数字资产标识。 调用方法 GenerateID(collectionIndex,tokenId string) ID 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 ID 数字资产标识。 父主题： 工具接口

设置数字资产授权用户 指定某个数字资产的授权用户，授权用户拥有转移数字资产的权利。每个tokenId只可有一个授权用户。开发者可根据业务需要使用，例如设置代理操作员，无需所有者实时响应等。 调用方法 public String approve(String collectionIndex, String operator, String tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 operator String 必填参数，被授权的用户身份标识符。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： ERC721业务接口

铸造可组合资产 为指定资产集合铸造一个编号为tokenId的可组合资产，可组合数字资产可以拥有若干个子资产，默认最大可拥有20个子资产。 调用方法 Mint(collectionIndex, tokenId string, tokenURI *Metadata)(*NFT,string,error) 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 tokenURI *Metadata 必填参数，数字资产对应的meta信息。可以通过NewImageMetadata等方法生成，也可以根据业务自定义生成。 返回值 类型 说明 *NFT 返回铸造成功的数字资产信息。 string 返回上链交易编号，txid。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC998业务接口

查询资产集合的缩写 根据集合标识查询集合缩写。 调用方法 Symbol(collectionIndex string)(string, error) 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 返回值 类型 说明 symbol 集合缩写。 error 错误对象，包含错误原因，为空代表成功。 父主题： 通用接口

铸造数字资产 为指定资产集合铸造一个编号为tokenId的数字资产。 调用方法 Mint(collectionIndex, tokenId string, tokenURI *Metadata)(*NFT,string,error) 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 tokenURI *Metadata 必填参数，数字资产对应的meta信息。可以通过NewImageMetadata等方法生成，也可以根据业务自定义生成。 返回值 类型 说明 *NFT 返回铸造成功的数字资产信息。 string 返回上链交易编号，txid。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC721业务接口

配置并切换用户 根据配置文件中的用户名，切换sdk当前使用的用户。 调用方法 public function switchIdentityWithName(string $identityName)throws Exception 参数说明 参数 类型 说明 identityName String 必填参数，用户名，用于加载本地文件，需与配置文件identities中用户匹配。 数字和字母组合，长度[3-32]。 父主题： 工具接口

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 besides_count Integer 剩余数据条数，包括本次data的条数 size Integer 本次返回条数 data Array of data objects list的数据集 表3 data 参数 参数类型 描述 asset_from_addr String 资产来源 asset_to_addr String 资产拥有者，资产接收者 transaction_time Integer 交易时间 block_num Integer 区块高度 transaction_hash String 交易hash transaction_type String 交易类型

生成私钥和证书 根据用户名生成用户私钥、证书以及对应的地址。 调用方法 public function generateIdentity(string $algorithm, string $identityName) throws Exception 参数说明 参数 类型 说明 algorithm String 必填参数，生成秘钥对应算法，对应秘钥类型。例如：ecdsa_with_sha256。 identityName String 必填参数，用户名。 数字和字母组合，长度[3-32]。 返回值 类型 说明 IdentityInfo 用户信息，包括证书，秘钥，地址标识符。 父主题： 工具接口

拆分子资产给其它可组合资产 将可组合资产中的子资产拆分转移给其它可组合资产。 调用方法 public function safeTransferChild(string $fromCollectionIndex, string $fromTokenId, string $toCollectionIndex, string $childCollectionIndex, string $childTokenId, string $toTokenId) throws Exception 参数说明 参数 类型 说明 fromCollectionIndex String 必填参数，所有者的可组合资产所在集合的唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 fromTokenId String 必填参数，所有者的可组合资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 toCollectionIndex String 必填参数，接受者的可组合资产所在集合的唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 childCollectionIndex String 必填参数，子资产所在集合的唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 childTokenId String 必填参数，子资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 toTokenId String 必填参数，接受者的可组合资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： ERC998业务接口

监管者注销数字资产 为了满足特殊场景和监管需求，监管者可以销毁指定资产集合中的数字资产。每个租户的管理CA身份默认为监管者。 仅共享版支持该接口调用。 调用方法 public String supervisorBurn(String collectionIndex, String tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 string 返回销毁交易编号，txid。 父主题： ERC721业务接口

查询数字资产是否铸造 查询指定资产集合下，数字资产标识tokenId是否被铸造。 调用方法 public function isMinted(string $collectionIndex, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^63)。 返回值 类型 说明 bool 已铸造返回“true”，未铸造返回“false”。 父主题： ERC721业务接口

查询可组合资产拥有集合种类数量 查询可组合资产拥有的集合种类数量。 调用方法 TotalChildCollections(collectionIndex, tokenId string)(int64,error) 参数说明 参数 类型 说明 collectionIndex string 必填参数，可组合资产的集合唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 tokenId string 必填参数，可组合资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 int64 可组合资产拥有的集合种类数量。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC998业务接口

修改集合信息 创建者有权限修改集合的名称和缩写。 调用方法 public function setOption(string $collectionIndex, string $name, string $symbol) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 name String 必填参数，名称[3-60]。 symbol String 必填参数，缩写[3-20]。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： 通用接口

查询用户级授权用户 查询owner用户是否对operator开启用户级授权。 调用方法 IsApprovedForAll(owner, operator string)(bool,error) 参数说明 参数 类型 说明 owner String 必填参数，所有者身份标识。 operator String 必填参数，被授权的用户身份标识符。 返回值 类型 说明 bool 开启为true，未开启为false。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC1155业务接口

转移数字资产所有权 将指定集合中的指定数字资产的所有权，从from转移到to用户。 调用方法 public String safeTransferFrom(String from, String to, ID id) throws Exception 参数说明 参数 类型 说明 from String 必填参数，所有者身份标识符。 to String 必填参数，接受者身份标识符。 id ID 必填参数，数字资产标识。可以通过generateID方法根据集合标识符和数字资产编号生成。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： ERC1155业务接口

查询集合级授权用户 查询指定资产集合下，owner用户是否对operator开启授权。 调用方法 public boolean isAppravedForAll(String collectionIndex, String owner, String operator) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 owner String 必填参数，所有者身份标识。 operator String 必填参数，被授权用户身份标识符。 返回值 类型 说明 bool 开启为“true”，未开启为“false”。 父主题： ERC721业务接口

调用示例 Go-sdk 调用示例： // 初始化SDKsdk, err:=tdcsdk.New("/root/test-tdc-sdk-conf/conf.yaml")if err != nil {fmt.Println(err)return}// 创建名为“tiger01” 的集合collectionIndex := "tiger01"txid, err := sdk.CreateNFTCollection(collectionIndex)if err != nil {fmt.Println(err)return}fmt.Println("Create collection txid:",txid)// 生成数字资产meta信息meta, err := sdk.NewImageMetadata([]byte("123"),"tigerImage","http://obs.huawei.com/1/tiger","description",1)if err != nil {fmt.Println(err)return}// 铸造数字资产ntf, txid, err := sdk.NFT721.Mint(collectionIndex,"1",meta)if err != nil {fmt.Println(err)return}fmt.Println("Mint txid:",txid)fmt.Println("Mint ntf:",ntf)// 查询数字资产所有者owner, err := sdk.NFT721.OwnerOf(collectionIndex,"1")if err != nil {fmt.Println(err)return}fmt.Println("Collection:",collectionIndex,"token:1 owner is ",owner)// 生成新的用户信息，包括证书，私钥和地址cert, sk, receiverAddr, err := sdk.GenerateIdentity(utils.EcdsaWithSha256,"user1")if err != nil {fmt.Println(err)return}fmt.Println("cert:",cert)fmt.Println("sk:",sk)fmt.Println("addr:",receiverAddr)// 数字资产转移txid, err = sdk.NFT721.TransferFrom(collectionIndex,owner,receiverAddr,"1")if err != nil{fmt.Println(err)return}fmt.Println("TransferFrom txid:", txid)// 批量铸造数字资产batchMintData := &mgmt.BatchMintData{StartTokenID: "5000", Amount: "5000", TokenURI: meta}txid, err = sdk.NFT1155.BatchMint(collectionIndex, batchMintData)if err != nil{fmt.Println(err)return}fmt.Println("BatchMint txid:", txid)// 铸造可组合资产nft, txid, err := sdk.NFT998.Mint(collectionIndex, "10", meta)if err != nil {fmt.Println(err)return}fmt.Println("Mint of composable asset txid:",txid)fmt.Println("Mint of composable asset nft:",nft)// 铸造数字资产nft, txid, err = sdk.NFT721.Mint(collectionIndex,"2",meta)if err != nil {fmt.Println(err)return}fmt.Println("Mint txid:",txid)fmt.Println("Mint nft:",nft)// 查询数字资产拥有者owner, err = sdk.NFT721.OwnerOf(collectionIndex, "2")if err != nil {fmt.Println(err)return}fmt.Println("the nft of owner:", owner)// 加入可组合资产txid, err = sdk.NFT998.GetChild(owner, collectionIndex, "10", collectionIndex, "2")if err != nil {fmt.Println(err)return}fmt.Println("GetChild txid:", txid)// 切换成新的用户身份err = sdk.SwitchIdentityWithPem(utils.EcdsaWithSha256,cert,sk)// resourceByte 可以从本地文件获取或者从网络请求中接收图片的字节数组resourceByte := []byte("资源的byte数组")resourcePath, resourceUrl, metadata, err := sdk.ToolManager.UploadResourceWithAudit(resourceByte, mgmt.Image, mgmt.ImageJPEG, "1678671385", false)if err != nil {fmt.Println(err)return}fmt.Println("UploadResourceWithAudit resourceUrl:", resourceUrl)fmt.Println("UploadResourceWithAudit metadata:", metadata)fmt.Println("UploadResourceWithAudit resourcePath:", resourcePath)// 其他业务调用... 父主题： Go

查询资产集合的名称 根据集合标识查询集合名称。 调用方法 public String name(String collectionIndex) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 返回值 类型 说明 name 集合名称。 父主题： 通用接口

导入用户证书秘钥并切换用户 导入用户证书和私钥，切换sdk当前使用的用户。 调用方法 SwitchIdentityWithPem(algothrim, cert, key string) error 参数说明 参数 类型 说明 algorithm String 必填参数，生成秘钥对应算法，对应秘钥类型。默认 ecdsa_with_sha256。 cert String 必填参数，用户证书。 key String 必填参数，用户秘钥。 返回值 类型 说明 error 错误对象，包含错误原因，为空代表成功。 父主题： 工具接口

生成数字资产标识 根据集合标识符和数字资产编号生成数字资产标识。 调用方法 public ID generateID(String collectionIndex, String tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 ID 数字资产标识。 父主题： 工具接口

查询可组合资产拥有集合种类数量 查询可组合资产拥有的集合种类数量。 调用方法 public function totalChildCollections(string $collectionIndex, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex string 必填参数，可组合资产的集合唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 tokenId string 必填参数，可组合资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 int64 可组合资产拥有的集合种类数量。 父主题： ERC998业务接口

查询集合级授权用户 查询指定资产集合下，owner用户是否对operator开启授权。 调用方法 IsApprovedForAll(collectionIndex, owner, operator string) (bool, error) 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 owner String 必填参数，所有者身份标识。 operator String 必填参数，被授权用户身份标识符。 返回值 类型 说明 bool 开启为“true”，未开启为“false”。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC721业务接口

设置集合级授权用户 在指定资产集合下，为用户设置授权用户。被授权用户拥有该集合下该用户的所有资产操作权限。 调用方法 SetApprovalForAll(collectionIndex, owner, operator, isApproved string)(string,error) 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 owner String 必填参数，所有者身份标识。 operator String 必填参数，被授权的用户身份标识符。 isApproved String 必填参数，同意授权为“true”,取消授权为“false”。 返回值 类型 说明 string 返回上链交易编号，txid。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC721业务接口

销毁数字资产 销毁资产集合编号为tokenId的数字资产。 调用方法 public function burn(string $collectionIndex, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^63)。 返回值 类型 说明 string 返回销毁交易编号，txid。 父主题： ERC721业务接口

查询用户拥有的数字资产 查询指定资产集合下，用户所拥有的数字资产。 仅专享版支持该接口调用。 调用方法 public String[] account(String collectionIndex, String identity) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 identity String 必填参数， 用户身份标识。 返回值 类型 说明 string[] 返回拥有的数字资产标识列表。 父主题： ERC721业务接口

加入可组合资产 某一集合中数字资产的所有者或授权者将该资产加入指定集合中的可组合资产。 调用方法 public function getChild(string $from, string $toCollectionIndex, string $toTokenId, string $childCollectionIndex, string $childTokenId) throws Exception 参数说明 参数 类型 说明 from String 必填参数，子资产所有者身份标识符。 toCollectionIndex String 必填参数，可组合资产所在集合的唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 toTokenId String 必填参数，可组合资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 childCollectionIndex String 必填参数，子资产所在集合的唯一标识符，不能重复。以字母开头，支持字母、数字。长度[3-32]。 childTokenId String 必填参数，子资产的数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： ERC998业务接口