EvidenceService - 3. getEvidence - 《WeIdentity 文档》

3. getEvidence

3. getEvidence

基本信息

接口名称:com.webank.weid.rpc.EvidenceService.getEvidence
接口定义:ResponseData<EvidenceInfo> getEvidence(String evidenceAddress)
接口描述: 根据传入的凭证存证地址，在链上查找凭证存证信息。

接口入参: String

接口返回: com.webank.weid.protocol.response.ResponseData<EvidenceInfo>;

名称	类型	说明	备注
errorCode	Integer	返回结果码
errorMessage	String	返回结果描述
result	EvidenceInfo	创建的凭证合约地址	业务数据
transactionInfo	TransactionInfo	交易信息

com.webank.weid.protocol.response.TransactionInfo

名称	类型	说明
blockNumber	BigInteger	交易块高
transactionHash	String	交易hash
transactionIndex	BigInteger	交易索引

com.webank.weid.protocol.base.EvidenceInfo

名称	类型	说明	备注
credentialHash	String	凭证Hash值	是一个66个字节的字符串，以0x开头
signers	List<String>	凭证签发者	链上允许存在多个凭证签发者
signatures	List<String>	签发者生成签名	和每个签发者一一按序对应的签名值

此方法返回code

enum	code	desc
SUCCESS	0	成功
CREDENTIAL_EVIDENCE_BASE_ERROR	100500	Evidence标准错误
TRANSACTION_TIMEOUT	160001	超时
TRANSACTION_EXECUTE_ERROR	160002	交易错误
ILLEGAL_INPUT	160004	参数为空

调用示例

EvidenceService evidenceService = new EvidenceServiceImpl();
ResponseData<Evidence> response = evidenceService.getEvidence("0xa3203e054bb7a7f0dec134c7510299869e343e8d");

返回结果如：
result:(com.webank.weid.protocol.base.EvidenceInfo)
   credentialHash: 0x31c2db44db19ec1af69ed6ad2dc36c7a8068c9871cf1a2bd0e67cb6264531f35
   signers:(java.util.ArrayList)
      [0]:0x39e5e6f663ef77409144014ceb063713b65600e7
   signatures:(java.util.ArrayList)
      [0]:HJoVLhynrqekQWjMEHubd0e5E/J3LLfnWtq3CXpjFaA/Tfj3i0+dDGfa76OqoZhqSuNucXW8f4BZn/Lkd6SPQ/I=
errorCode: 0
errorMessage: success
transactionInfo:null

时序图

sequenceDiagramparticipant 调用者participant EvidenceServiceparticipant 区块链节点调用者->>EvidenceService: 调用GetEvidence()EvidenceService->>EvidenceService: 入参非空、格式及合法性检查opt 入参校验失败EvidenceService—>>调用者: 报错，提示参数不合法并退出endEvidenceService->>区块链节点: 调用智能合约，查询凭证存证内容区块链节点—>>EvidenceService: 返回查询结果opt 查询出错EvidenceService—>>调用者: 报错并退出endEvidenceService—>>调用者: 返回成功