华为云用户手册

  • 拆分子资产给用户 将可组合资产中的子资产拆分转移给指定用户。 调用方法 public String transferChild(String fromCollectionIndex, String fromTokenId, String to, String childCollectionIndex, String childTokenId) throws Exception 参数说明 参数 类型 说明 fromCollectionIndex String 必填参数,可组合资产所在集合的唯一标识符,不能重复。以字母开头,支持字母、数字。长度[3-32]。 fromTokenId String 必填参数,可组合资产的数字资产编号。同一集合内不能重复,取值范围[0,2^64)。 to String 必填参数,接受者身份标识符。 childCollectionIndex String 必填参数,子资产所在集合的唯一标识符,不能重复。以字母开头,支持字母、数字。长度[3-32]。 childTokenId String 必填参数,子资产的数字资产编号。同一集合内不能重复,取值范围[0,2^64)。 返回值 类型 说明 string 返回上链交易编号,txid。 父主题: ERC998业务接口
  • 设置数字资产授权用户 指定某个数字资产的授权用户,授权用户拥有转移数字资产的权利。每个tokenId只可有一个授权用户。开发者可根据业务需要使用,例如设置代理操作员,无需所有者实时响应等。 调用方法 public function approve(string $collectionIndex, string $operator, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数,集合唯一标识符,不能重复。 以字母开头,支持字母、数字。 长度[3-32]。 operator String 必填参数,被授权的用户身份标识符。 tokenId String 必填参数,数字资产编号。同一集合内不能重复,取值范围[0,2^63)。 返回值 类型 说明 string 返回上链交易编号,txid。 父主题: ERC721业务接口
  • Metadata 参数说明 属性 类型 说明 name String 数字资产名称。 description String 描述信息。 category Int 分类,可根据业务需要指定。例如1代表藏品,2代表个人创作等。 type String 类型:[image/audio/3d/video]。 hash String 对应资源的hash。 url String 对应资源存储位置。 properties map[string]Property 属性字典。根据业务自定义,例如文件大小,图片tag标签,其他业务属性等。 父主题: 数据结构
  • 查询数字资产所有者 根据集合标识和资产标识符查询其所有者。 调用方法 public function ownerOf(string $collectionIndex, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数,集合唯一标识符,不能重复。 以字母开头,支持字母、数字。 长度[3-32]。 tokenId String 必填参数,数字资产编号。同一集合内不能重复,取值范围[0,2^63)。 返回值 类型 说明 string 所有者身份标识符,例如地址、数字资产标识。 父主题: ERC721业务接口
  • 设置用户级授权用户 为用户设置授权用户,被授权的用户拥有该用户下所有集合的数字资产操作权限。 调用方法 SetApprovalForAll(owner, operator, isApproved string)(string,error) 参数说明 参数 类型 说明 owner String 必填参数,所有者身份标识。 operator String 必填参数,被授权的用户身份标识符。 isApproved String 必填参数,同意授权为“true”,取消授权为“false”。 返回值 类型 说明 string 返回上链交易编号,txid。 error 错误对象,包含错误原因,为空代表成功。 父主题: ERC1155业务接口
  • 创建图片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信息。 父主题: 工具接口
  • 响应参数 状态码: 200 表2 响应Body参数 参数 参数类型 描述 id Integer 区块编号 txs_count Integer 交易数量 data_hash String 区块体哈希 pre_hash String 前一区块体哈希 time String 区块生成时间 txs Array of Transaction objects 交易集合 表3 Transaction 参数 参数类型 描述 tx_id String 交易id type String 交易类型COMMON_TRANSACTION:普通交易,VOTE_TRANSACTION:投票交易 枚举值: COMMON_TRANSACTION VOTE_TRANSACTION block_id Integer 区块号 creator String 创建者 create_time String 创建时间 chaincode_name String 合约名称 endorsor_orgs Array of strings 背书组织 read_set Array of Readset objects 读集 write_set Array of Writeset objects 写集 表4 Readset 参数 参数类型 描述 key String key值 version Array of Version objects 版本信息 表5 Version 参数 参数类型 描述 block_num Integer 区块号 tx_num String 交易编号 表6 Writeset 参数 参数类型 描述 key String 键 value Array of strings 值 signature Array of strings 签名 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述
  • 查询数字资产授权用户 查询某个数字资产的授权用户。 调用方法 public function getApproved(string $collectionIndex, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数,集合唯一标识符,不能重复。 以字母开头,支持字母、数字。 长度[3-32]。 tokenId String 必填参数,数字资产编号。同一集合内不能重复,取值范围[0,2^63)。 返回值 类型 说明 string 被授权的用户身份标识符。 父主题: ERC721业务接口
  • 设置集合级授权用户 在指定资产集合下,为用户设置授权用户。被授权用户拥有该集合下该用户的所有资产操作权限。 调用方法 public function setApprovalForAll(string $collectionIndex, string $owner, string $operator, bool $isApproved) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数,集合唯一标识符,不能重复。 以字母开头,支持字母、数字。 长度[3-32]。 owner String 必填参数,所有者身份标识。 operator String 必填参数,被授权的用户身份标识符。 isApproved boolean 必填参数,同意授权为“true”,取消授权为“false”。 返回值 类型 说明 string 返回上链交易编号,txid。 父主题: ERC721业务接口
  • 生成数字资产编码 根据集合标识符和数字资产编号生成数字资产编码,同样具备唯一性,可用于可视化展示和DAC产品页核验。 调用方法 public function generateAssetID(string $collectionIndex, string $tokenId) throws NoSuchAlgorithmException 参数说明 参数 类型 说明 collectionIndex String 必填参数,集合唯一标识符,不能重复。 以字母开头,支持字母、数字。 长度[3-32]。 tokenId String 必填参数,数字资产编号。同一集合内不能重复,取值范围[0,2^64)。 返回值 类型 说明 string 数字资产编码。 父主题: 工具接口
  • 修改集合信息 创建者有权限修改集合的名称和缩写。 调用方法 public String setOption(String collectionIndex, String name, String symbol) throws Exception 参数说明 参数 类型 说明 collectionIndex String 必填参数,集合唯一标识符,不能重复。 以字母开头,支持字母、数字。 长度[3-32]。 name String 必填参数,名称[3-60]。 symbol String 必填参数,缩写[3-20]。 返回值 类型 说明 string 返回上链交易编号,txid。 父主题: 通用接口
  • BatchMintData 参数说明 属性 类型 说明 startTokenID String 必填参数,数字资产起始编号。同一集合内数字资产编号不能重复,取值范围[0,2^64)。 amount String 必填参数,批量铸造个数,取值范围[1,5000]。 tokenURI *Metadata 必填参数,数字资产对应的meta信息。可以通过NewImageMetadata等方法生成,也可以根据业务自定义生成。 父主题: 数据结构
  • 批量查询用户数字资产所有权 批量查询用户是否拥有数字资产的所有权,结果返回数组。 调用方法 public long[] balanceOfBatch(String[] identities, ID[] ids) throws Exception 参数说明 参数 类型 说明 identities String[] 必填参数,用户身份标识数组,数组长度最大为200。 ids ID[] 必填参数,数字资产标识数组,数字资产标识数组的长度需要与用户身份标识数组的长度相同。 返回值 类型 说明 long[] 返回的数组结果与用户身份标识数组下标匹配,其中数组的值为1表示该用户拥有指定的数字资产,为0表示未拥有指定的数字资产。 父主题: ERC1155业务接口
  • 批量转移数字资产所有权 批量转移不同/相同资产集合中若干数字资产的所有权,从from转移到to用户。 调用方法 public String safeBatchTransferFrom(String from, String to, ID[] ids) throws Exception 参数说明 参数 类型 说明 from String 必填参数,所有者身份标识符。 to String 必填参数,接受者身份标识符。 ids ID[] 必填参数,批量转移的数字资产标识数组,最大支持5000个数字资产的批量流转。 返回值 类型 说明 string 返回上链交易编号,txid。 父主题: ERC1155业务接口
  • 查询可组合资产的根所有者 遍历查询可组合资产的父所有者,获得可组合资产的根所有者。 调用方法 public function rootOwnerOf(string $collectionIndex, string $tokenId) throws Exception 参数说明 参数 类型 说明 collectionIndex string 必填参数,可组合资产的集合唯一标识符,不能重复。以字母开头,支持字母、数字。长度[3-32]。 tokenId string 必填参数,可组合资产的数字资产编号。同一集合内不能重复,取值范围[0,2^64)。 返回值 类型 说明 string 根所有者的身份标识符,例如地址。 父主题: ERC998业务接口
  • 查询数字资产描述信息 根据集合标识和内容标识符查询其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业务接口
共100000条