华为云用户手册

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

导入用户证书秘钥并切换用户 导入用户证书和私钥，切换sdk当前使用的用户。 调用方法 public function switchIdentityWithPem(string $algorithm, string $cert, string $key) throws Exception 参数说明 参数 类型 说明 algorithm String 必填参数，生成秘钥对应算法，对应秘钥类型。默认 ecdsa_with_sha256。 cert String 必填参数，用户证书。 key String 必填参数，用户秘钥。 父主题： 工具接口

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

创建图片Metadata 工具方法，帮助生成metadata对象，获得对象后开发者可以自定义设置properties属性。 调用方法 public function newImageMetadata(string $data, string $name, string $url, string $description, int $category) throws Exception 参数说明 参数 类型 说明 data String 必填参数，图片内容信息。 name String 必填参数，图片名称，长度[1,100]。 url String 必填参数，图片存储地址， 长度[5,400]。 description String 描述信息。 categroy Int 分类，用户可自定义。例如： 1. 藏品 2. 个人创作等。 返回值 类型 说明 Metadata 数字资产对应的meta信息。 父主题： 工具接口

配置并切换用户 根据配置文件中的用户名，切换sdk当前使用的用户。 调用方法 SwitchIdentityWithName(identityName string) error 参数说明 参数 类型 说明 identityName String 必填参数，用户身名，用于加载本地文件，需与配置文件identities中用户匹配。 数字和字母组合，长度[3-32]。 返回值 类型 说明 error 错误对象，包含错误原因，为空代表成功。 父主题： 工具接口

创建图片Metadata 工具方法，帮助生成metadata对象，获得对象后开发者可以自定设置properties属性。 调用方法 NewImageMetadata(image []byte, name, url,description string, categroy int) (*Metadata, error) 参数说明 参数 类型 说明 image []Byte 必填参数，图片字节数组。 name String 必填参数，图片名称，长度[1,100]。 url String 必填参数，图片存储地址， 长度[5,400]。 description String 描述信息。 categroy Int 分类，用户可自定义。例如：1. 藏品 2. 个人创作等。 返回值 类型 说明 *Metadata 数字资产对应的meta信息。 error 错误对象，包含错误原因，为空代表成功。 父主题： 工具接口

修改集合信息 创建者有权限修改集合的名称和缩写。 调用方法 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。 父主题： 通用接口

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

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

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

创建数字资产集合 集合包括Name和Symbol，可调用SetOption方法设置。每一个集合中可包含0个或无限个数字资产。每个数字资产对应一个唯一的tokenId。 调用方法 public function createNFTCollection(string $collectionIndex) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： 通用接口

SDK配置 SDK在不同环境下支持的实例安全机制如下： Windows环境：ECDSA Linux环境：ECDSA 环境需要安装openssl 目前仅支持共享版数字资产链的调用 SDK中相关方法的使用示例，可参考应用程序的示例Samples/sample1.php（dac-php-sdk下载地址）。 项目安装依赖。 composer install 配置时区 php.ini中设置时区为国内 date.timezone = asia/shanghai 配置openssl Config（可选） 在DAC 配置文件conf.yaml中增加# windowsopensslCnf: D:\xampp\php\extras\ssl\openssl.cnf# linuxopensslCnf: /root/openssl.cnf 父主题： PHP

设置资产流转限制 创建者有权限修改集合内数字资产的流转限制，包括流转次数和每次流转之间的间隔天数。例如，希望每个资产仅可以流转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。 父主题： 通用接口

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

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

生成数字资产编码 根据集合标识符和数字资产编号生成数字资产编码，同样具备唯一性，可用于可视化展示和DAC产品页核验。 调用方法 public String generateAssetID(String collectionIndex, String tokenId) throws NoSuchAlgorithmException 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 string 数字资产编码。 父主题： 工具接口

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

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

调用示例 Java-sdk 调用示例 // 初始化SDKTD CS DK tdcsdk = new TDCSDK("/root/test-tdc-sdk-conf/conf.yaml");// 创建名为“tiger01”的集合String collectionIndex = "tiger01";String txid = tdcsdk.createNFTCollection(collectionIndex);System.out.println("Create collection txid: "+txid);// 生成数字资产meta信息Metadata md = tdcsdk.newImageMetadata(new String("image bytes").getBytes(), "tigerImage","http://obs.huawei.com/1/tiger","description",1);// 铸造数字资产MintResp mintResp = tdcsdk.nft721.mint(collectionIndex,"1",md);System.out.println("Mint nft:"+mintResp.getNft());System.out.println("Mint txid:"+mintResp.getTxid());// 生成新的用户信息，包括证书，私钥和地址IdentityInfo receiver = tdcsdk.generateIdentity(Tools.ECDSA_ALGORITHM,"test1");System.out.println("cert: "+receiver.getCert());System.out.println("sk: "+receiver.getKey());System.out.println("addr: "+receiver.getAddress());// 查询数字资产所有者String owner = tdcsdk.nft721.ownerOf(collectionIndex,"1");System.out.println("collection:"+collectionIndex+", token:1 owner is "+owner);// 数字资产转移String transferTxid = tdcsdk.nft721.transferFrom(collectionIndex,owner,receiver.getAddress(),"1");System.out.println("Transfer txid:"+transferTxid);// 批量铸造数字资产String tx = tdcsdk.nft1155.batchMint(collectionIndex, new BatchMintData("10000", "50", md));System.out.println("BatchMint txid: "+tx);// 铸造数字资产MintResp mintResp2 = tdcsdk.nft721.mint(collectionIndex, "2", md);System.out.println("Mint nft:"+mintResp2.getNft());System.out.println("Mint txid:"+mintResp2.getTxid());// 查询数字资产所有者String ownerOfTokenID = tdcsdk.nft721.ownerOf(collectionIndex,"2");System.out.println("collection:"+collectionIndex+", token:2 owner is "+ownerOfTokenID);// 铸造可组合资产MintResp mintComposeResp = tdcsdk.nft998.mint(collectionIndex, "10", md);System.out.println("Mint of composable asset nft:"+mintComposeResp.getNft());System.out.println("Mint of composable asset txid:"+mintComposeResp.getTxid());// 加入可组合资产String getChildTxid = tdcsdk.nft998.getChild(ownerOfTokenID, collectionIndex, "10", collectionIndex, "2");System.out.println("GetChild txid: "+getChildTxid);// 切换成新的用户身份tdcsdk.switchIdentityWithPem(Tools.ECDSA_ALGORITHM,receiver.getCert(),receiver.getKey());// 其他业务调用... 父主题： Java

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

查询用户数字资产所有权 查询用户是否拥有数字资产的所有权，拥有则返回NFT数字资产个数1。 仅专享版支持该接口调用。 调用方法 public long balanceOf(String identity, ID id) throws Exception 参数说明 参数 类型 说明 identity String 必填参数，用户身份标识。 id ID 必填参数，数字资产标识。 返回值 类型 说明 long 返回1则表示用户拥有该数字资产，0表示用户未拥有该数字资产。 父主题： ERC1155业务接口

查询用户级授权用户 查询owner用户是否对operator开启用户级授权。 调用方法 public boolean isAppravedForAll(String owner, String operator) throws Exception 参数说明 参数 类型 说明 owner String 必填参数，所有者身份标识。 operator String 必填参数，被授权用户身份标识符。 返回值 类型 说明 bool 开启为“true”，未开启为“false”。 父主题： ERC1155业务接口

设置用户级授权用户 为用户设置授权用户，被授权的用户拥有该用户下所有集合的数字资产操作权限。 调用方法 public String setApprovalForAll(String owner, String operator, boolean isApproved) throws Exception 参数说明 参数 类型 说明 owner String 必填参数，所有者身份标识。 operator String 必填参数，被授权的用户身份标识符。 isApproved boolean 必填参数，同意授权为“true”，取消授权为“false”。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： ERC1155业务接口

批量查询用户数字资产所有权 批量查询用户是否拥有数字资产的所有权，结果返回数组。 调用方法 public long[] balanceOfBatch(String[] identities, ID[] ids) throws Exception 参数说明 参数 类型 说明 identities String[] 必填参数，用户身份标识数组，数组长度最大为200。 ids ID[] 必填参数，数字资产标识数组，数字资产标识数组的长度需要与用户身份标识数组的长度相同。 返回值 类型 说明 long[] 返回的数组结果与用户身份标识数组下标匹配，其中数组的值为1表示该用户拥有指定的数字资产，为0表示未拥有指定的数字资产。 父主题： ERC1155业务接口

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

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

查询用户拥有数字资产数量 查询指定资产集合下，用户所拥有的数字资产数量。 仅专享版支持该接口调用。 调用方法 BalanceOf(collectionIndex, identity string) (int64, error) 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 identity String 必填参数， 用户身份标识。 返回值 类型 说明 int64 返回拥有的数字资产数量。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC721业务接口

批量铸造数字资产 为指定资产集合批量铸造若干个从某一资产编号开始的同一数字资产。 调用方法 public String batchMint(String collectionIndex, BatchMintData batchMintData) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 batchMintData BatchMintData 必填参数，批量铸造数据信息，详情见BatchMintData。 返回值 类型 说明 string 返回上链交易编号，txid。 父主题： ERC1155业务接口

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

查询数字资产是否铸造 查询指定资产集合下，数字资产标识tokenId是否被铸造。 调用方法 IsMinted(collectionIndex, tokenId string)(bool, error) 参数说明 参数 类型 说明 collectionIndex String 必填参数，集合唯一标识符，不能重复。 以字母开头，支持字母、数字。 长度[3-32]。 tokenId String 必填参数，数字资产编号。同一集合内不能重复，取值范围[0,2^64)。 返回值 类型 说明 bool 已铸造返回“true”，未铸造返回“false”。 error 错误对象，包含错误原因，为空代表成功。 父主题： ERC721业务接口