常见问题

Illegal key size or default parameters

问题背景

加载user.key失败，提示key长度不合法。

运行错误提示

09:49:40.623 [main] ERROR com.github.lyd.msg.provider.DemoSample - unable to read private key,wrong password? errorCode :{MychainSdkErrorCodeEnum{errorCode='30001', errorDesc='sdk invalid private key'}}
09:49:40.626 [main] ERROR com.github.lyd.msg.provider.DemoSample - unable to read encrypted data: 1.2.840.113549.1.12.1.3 not available: Illegal key size or default parameters
Exception in thread "main" com.alipay.mychain.sdk.exceptions.MychainSdkException: unable to read encrypted data: 1.2.840.113549.1.12.1.3 not available: Illegal key size or default parameters

解决方案

出现此错误的原因是个别JDK的默认配置限制了key的长度，因此SDK在加载key文件时解密失败。

可在DemoSample.java中main函数最开始位置，增加一段代码来进行处理，如下所示。

    String errorString = "Failed to modify key-length permissions";
    int newMaxKeyLength;
    try {
        if ((newMaxKeyLength = Cipher.getMaxAllowedKeyLength("AES")) < 256) {
            System.out.println("will modify aes length");
            Class c = Class.forName("javax.crypto.CryptoAllPermissionCollection");
            Constructor con = c.getDeclaredConstructor();
            con.setAccessible(true);
            Object allPermissionCollection = con.newInstance();
            Field f = c.getDeclaredField("all_allowed");
            f.setAccessible(true);
            f.setBoolean(allPermissionCollection, true);
            c = Class.forName("javax.crypto.CryptoPermissions");
            con = c.getDeclaredConstructor();
            con.setAccessible(true);
            Object allPermissions = con.newInstance();
            f = c.getDeclaredField("perms");
            f.setAccessible(true);
            ((Map) f.get(allPermissions)).put("*", allPermissionCollection);
            c = Class.forName("javax.crypto.JceSecurityManager");
            f = c.getDeclaredField("defaultPolicy");
            f.setAccessible(true);
            Field mf = Field.class.getDeclaredField("modifiers");
            mf.setAccessible(true);
            mf.setInt(f, f.getModifiers() & ~Modifier.FINAL);
            f.set(null, allPermissions);
            newMaxKeyLength = Cipher.getMaxAllowedKeyLength("AES");
        }
    } catch (Exception e) {
        throw new RuntimeException(errorString, e);
    }
    if (newMaxKeyLength < 256) {
        throw new RuntimeException(errorString);
    }

Connection reset by peer

问题背景

SDK出现cause: Connection reset by peer的异常。

问题分析

• 如果A端的Socket因为主动关闭或者因为异常退出被关闭，B端仍发送数据，发送的第一个数据包则引发Connect reset by peer异常（A端连接断开后，B端给通道中写数据）。

• A端退出，但退出时并未关闭该连接，B端如果仍然从连接中读数据则抛出Connect reset by peer异常（A端连接断开后B端仍然从通道中读数据）。

• 主动给客户端推送TCP层的reset包，客户端收到后，报Connect reset by peer异常。

解决方案

1. 查看区块链是否运行正常，是否主动关闭了与SDK之间的链接。

2. SDK与链之间是否经过了SLB（负载均衡），且SDK进程中，是否启动了多个连接，如果是，可以重启SDK解决，并将SDK升级到0.10.2.24.5。

   查看是否建立多个链接：netstat -na | grep ip:端口。

   显示ESTABLISHED则是建立成功的连接。

   

General OpenSslEngine problem

问题背景

SDK启动时报以下异常，导致SDK启动失败。

解决方案

1. 排查SDK启动的证书、密码是否正确。

2. 排查SDK启动的证书是否过期。

   openssl x509 -in client.crt -noout -dates

   

3. 排查netty-tcnative包是否冲突，netty和netty-tcnative包需要是以下配套版本，命令如下：

   io.netty:netty-all:jar:4.1.29.Final
   io.netty:netty-tcnative-boringssl-static:jar:2.0.17.Final

   重要

   可以通过mvn dependency:tree查看JAR包依赖关系。

invalid keypair

问题背景

SDK提示invalid keypair。

问题分析

构造keypair的代码如下。

使用keypair对象时，keypair == null或者keypair的type不正确。

解决方案

1. 创建签名，是根据用户的私钥进行签名的，所以需要检查用户的私钥是否正确。

2. 打断点查看获取的Keypair对象是否为null，或者keypair对象中的type=unknown，在构造Keypair的位置打断点进一步分析。

3. 查看bouncycastel包是否存在冲突，SDK在V0.10.2.22之前要求bouncycastel包的版本为1.60。

4. 检查JDK的版本，目前已知SDK运行时，JDK不会存在问题的版本：JDK 1.8.0_151、JDK 1.8.0_251。

5. 排查netty-all和netty-tcnative包是否冲突，如果依赖了netty-tcnative-openssl需要排除掉，且当前需求的版本配置如下。

   io.netty:netty-all:jar:4.1.29.Final
   io.netty:netty-tcnative-boringssl-static:jar:2.0.17.Final

合约是否支持对象类型解析

问题背景

定义的这些值在SDK中怎么解析？

解决方案

SDK中暂时不支持对象类型解析，可以通过以下文档查看SDK支持的合约参数解析类型：

• V0.10.2.24.5的合约参数类型。

• V0.10.2.12的合约参数类型。

• V0.10.2.6的合约参数类型。

同一个事件有订阅次数的限制吗？

问题背景

同一个事件有订阅次数的限制吗？

解决方案

1. 同一个session，默认最大是10次，不区分事件类型。

   可以在mychain.conf中进行配置：event_plugin.max_session_filter_number。

2. 一个节点支持的最大订阅数量：1000，不区分事件类型。

   在mychain.conf文件中可以配置：max_filter_number

客户端A和B同时连链，A可以监听B的事件吗？

问题背景

初始化得到一个SDK A，使用这个SDK A订阅一个合约事件。然后初始化得到了一个SDK B，使用SDK B发起合约交易。请问SDK A中能监听到触发的合约事件吗？

解决方案

客户端A和B同时连链，A可以监听B的事件。

引用SDK后提示ClassNotFoundException

问题背景

例如出现以下问题：

解决方案

1. 查找不到的这个类是属于哪个包的。

2. 执行命令：mvn dependency:tree，查看这个包是否产生冲突。

3. 当前SDK依赖的netty和netty-tcnative包版本如下：

   io.netty:netty-all:jar:4.1.29.Final
   io.netty:netty-tcnative-boringssl-static:jar:2.0.17.Final

sendRequest, connect failed

问题背景

出现以下错误日志：

[log:2022-05-09 12:23:48.385 [SenderWorker-thread-0] ERROR MychainClient - [networkconnection] sendRequest, connect failed, seq:25911219 ]

解决方案

1. 检查本机网络是否正常。

2. 检查链节点是否正常，是否可以访问，是否停机了。

3. 检查链节点出块是否正常。

4. 是否出现了多连接，如果是可以重启SDK解决，建议升级SDK版本到2.24.5。

   查看是否建立多个连接：netstat -na | grep ip:端口。

   显示ESTABLISHED则是建立成功的连接。

   

断网后sdk error日志量太大/进程挂掉怎么处理

问题背景

1. 链节点断开后，SDK不断重连，导致进程挂掉。

2. 日志量很大。

解决方案

SDK从2.23开始，可以设置重连的频率，但是2.23之前的版本没法处理，可升级SDK版本。

参数说明

示例一：

connectionRetryDelayMs = 1000（1秒）

maxConnectionRetryDelayFactor = 5

则重连的频率为：1秒，2秒，3秒，4秒，5秒，最后会稳定在5s重连一次。

示例二：

connectionRetryDelayMs = 2000（2秒）

maxConnectionRetryDelayFactor = 5

那重连的频率就是：2秒，4秒，6秒，8秒，10秒，最后会稳定在10s重连一次已读。

SDK获取Service时报NullPointerException

问题背景

java.lang.NullPointerException: null
at com.alipay.mychain.sdk.api.MychainClient.getContractService(MychainClient.java:150)

解决方案

这种获取Service时报空指针异常，一般是因为SDK启动失败，可以去查看SDK启动位置失败的原因进行分析。

Identity类型和交易Hash是多少位的

问题背景

问题一：Identity是多少位？

问题二：txHash是多少位？

解决方案

1. Identity是32位的，如果转化为16进制是64个字符。

2. txHash是32位的，如果转化为16进制是64个字符。

arm64_linux环境集成方式

问题背景

arm64_linux环境下如何集成mychain-java-sdk。

解决方案

1. 在官网下载对应版本的Jar包。

   • V0.10.2.12 JAR包

   • V0.10.2.6 JAR包

   说明

   V0.10.2.24.5无需下载Jar包，通过Maven坐标即可引入，具体参见Java SDK说明。

2. 将Jar包安装到本地仓库。

   • 安装V0.10.2.20的Jar包执行命令如下。

     mvn install:install-file -Dfile=mychainx-sdk-java-all-0.10.2.20.jar -DgroupId=com.alipay.mychainx -DartifactId=mychainx-sdk-java-all -Dversion=0.10.2.20 -Dpackaging=jar

   • 安装V0.10.2.12的Jar包执行命令如下。

     mvn install:install-file -Dfile=mychainx-sdk-java-all-0.10.2.12.jar -DgroupId=com.alipay.mychainx -DartifactId=mychainx-sdk-java-all -Dversion=0.10.2.12 -Dpackaging=jar

3. 本地项目中添加以下依赖。

   重要

   请替换官网示例中的对应依赖。

           <dependency>
               <groupId>io.netty</groupId>
               <artifactId>netty-all</artifactId>
               <version>4.1.52.Final</version>
           </dependency>
           <dependency>
               <groupId>io.netty</groupId>
               <artifactId>netty-tcnative-boringssl-static</artifactId>
               <version>2.0.34.Final</version>
           </dependency>
           <dependency>
               <groupId>com.alipay.mychainx</groupId>
               <artifactId>mychainx-sdk-java-all</artifactId>
               <!--请使用最新 SDK 版本 或者0.10.2.12 -->
               <version>0.10.2.20</version>
           </dependency>
           <dependency>
               <groupId>org.bouncycastle</groupId>
               <artifactId>bcpkix-jdk15on</artifactId>
               <version>1.60</version>
           </dependency>

4. 替换Maven仓库io.netty.netty-tcnative-boringssl-static.2.0.34.Final的JAR包。

   2.0.34的JAR包为：netty-tcnative-boringssl-static-2.0.34.Final.jar（4.6MB）。

   具体操作如下：

   1. 进入Maven仓库netty-tcnative-boringssl-static.2.0.34.Final目录下。

      cd ~/.m2/repository/io/netty/netty-tcnative-boringssl-static/2.0.34.Final

   2. 将以下JAR包替换为上面附件中的JAR包。

      

out of gas

问题背景

调用合约，产生的out of gas异常。

如果执行时间很长，合约接口中客户批量操作，则数量越多，出现的概率越大。

SDK中报错：errorCode : 10200, errorDesc : out of gas。

问题分析

链上执行交易使用的gas超过了配置的gaslimit。

gaslimit取值规则：

SDK传的gas如果不是0则取链配置的gaslimit和SDK传的值中取一个最小值作为limit，如果SDK传的gas为0，则取链配置的gaslimit为limit，SDK默认传输的gaslimit为0。

解决方案

1. 即使将gas调大，但这个合约的执行比较长，仍会影响链的出块，建议优化合约。

2. 优化一下合约，建议不要进行此类较复杂的批量操作。

3. 现在不支持调整链的gas，现在的gaslimit已经够大了。

针对solidity的解析，支持ABIEncoderV2么？

问题背景

ABIEncoderV2的特性：支持返回User对象：

如果是ABIEncoderV1，编译合约的时候会报以下错误。

解决方案

对SDK进行验证。

可以看到部署合约成功，调用合约成功，但是SDK无法解析出User对象。

结论：mychain java sdk针对solidity的解析，不支持ABIEncoderV2全部功能，其中对象类型无法解析。

日志配置推荐（logback）

问题背景

• 如何配置SDK的日志打印。

• 当前slf4j-api版本：1.7.25。

解决方案

使用logback。

pom依赖添加如下

<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-core</artifactId>
    <version>1.1.11</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.1.11</version>
</dependency>

logback.xml

将logback.xml放置在resource目录下。

logback.xml文件的内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="true">
<!--定义日志文件的存储地址，勿在 LogBack 的配置中使用相对路径-->
<property name="LOG_HOME" value=" ../mychain-java-sdk/log " />
<!-- 控制台输出 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
 <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
 </encoder>
 </appender>
<!-- 按照每天生成日志文件 -->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
 <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<!--日志文件输出的文件名-->
<FileNamePattern>${LOG_HOME}/unionsdk-btn-sdk.%d{yyyy-MM-dd}.%i.log</FileNamePattern>
 <maxFileSize>100MB</maxFileSize> <!-- 日志文件过大会使的编辑器打开非常慢，因此设置日志最大50MB -->
<maxHistory>30</maxHistory> <!-- 保存30天 -->
<totalSizeCap>10GB</totalSizeCap> <!-- 总日志大小 -->
</rollingPolicy>
 <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
 </encoder>
<!--日志文件最大的大小-->
<!-- <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">-->
<!-- <MaxFileSize>3MB</MaxFileSize>-->
<!-- </triggeringPolicy>-->
</appender>

<!-- 日志输出级别 -->
<root level=" debug ">
 <appender-ref ref="STDOUT" />
 <appender-ref ref="FILE" />
 </root>
</configuration>

class org.bouncycastle.asn1.ASN1Primitive overrides final method equals.(Ljava/lang/Object;)Z

问题背景

SDK版本：

SDK报错：

解决方案

bcprov包冲突，由于项目依赖的其他包使用了其他版本，和SDK需要的版本有冲突。

从2.22开始，SDK要求bcprov版本必须是1.66，2.22之前bcprov版本是1.60。

合约返回10201,output打印时有乱码

问题背景

合约源码：

返回的output：

08c379a0
0000000000000000000000000000000000000000000000000000000000000020   //字符串偏移
0000000000000000000000000000000000000000000000000000000000000012   //字符串长度
546f6b656e49442072657065746974696f6e0000000000000000000000000000    //字符串内容

SDK解析错误：

output直接进行getString()时，返回结果是空的。

如果直接进行new String(output.getBytes())时，又有乱码。

解决方案

SDK解析时需要去掉前4个字节。

2.22之前的SDK版本：

//调用合约
CallContractResponse replyTransactionReceipt = sdk.getContractService().callContract(request);

// 
如果response返回的code是 10201，按照以下方式解析output 

byte[] decode = replyTransactionReceipt.getTransactionReceipt().getOutput();
byte[] content = new byte[decode.length-4];
System.arraycopy(decode,4,content,0,content.length);
EVMOutput vmOutput = new EVMOutput(ByteUtils.toHexString(content));
System.out.println(vmOutput.getString());

2.22及2.22之后的SDK版本：

//调用合约
CallContractResponse replyTransactionReceipt = sdk.getContractService().callContract(request);

//如果response返回的code是 10201，按照以下方式解析output 

String errorDesc = EVMOutput.evmRevertDecoder(replyTransactionReceipt.getTransactionReceipt().getOutput());
System.out.println(errorDesc);

unable to read encrypted data: Error finalising cipher

问题背景

用户证书的密码不正确。

解决方案

修改用户证书密码。

Input stream does not contain valid private key

问题背景

只要IP正确，均可以连接成功，但是握手失败，错误提示：Input stream does not contain valid private key。

解决方案

1. client.key密码不正确。

2. JDK版本问题。

目前已知版本的报错情况如下。

decode trustCa happens IOException with password：xxxxxx

问题背景

错误提示：Init SslContext exception:load custom key store happen IOException。connect是成功的，但握手失败。

解决方案

1. trustca密码不正确。

2. 目前已发现JDK 11会出现此问题，推荐使用JDK 1.8。

3. 检查trustCa文件是否进行过重置密码，是否重置失败。

4. trustCa是否是对应当前连接链的trustCa文件。

5. 排查netty-all、netty-tcnative、org.bouncycastle包冲突。

   • V0.10.2.24.5的SDK，请参考Java SDK说明中的版本要求。

   • V0.10.2.12的SDK，请参考Java SDK说明中的版本要求。

   • V0.10.2.6的SDK，请参考Java SDK 说明中的版本要求。

6. POM依赖中，把以下内容注释掉，因为编译会改变resource目录下的trustCa文件。

   <build>
          <resources>
               <resource>
                   <directory>src/main/resources</directory>
                   <filtering>true</filtering>
               </resource>
           </resources>
   </build>

OPENSSL_internal:KEY_VALUES_MISMATCH

问题背景

错误提示：

io.netty.handler.codec.DecoderException: javax.net.ssl.SSLHandshakeException: error:0b000074:X.509 certificate routines:OPENSSL_internal:KEY_VALUES_MISMATCH

解决方案

client.crt错误或者client.key错误。

verification of certificate failed

问题背景

错误提示：

2022-04-13 13:41:47.746 [WorkThreadPool-1-2] DEBUG i.netty.handler.ssl.ReferenceCountedOpenSslContext - verification of certificate failed
java.security.cert.CertificateException: Unable to construct a valid chain

解决方案

检查trustca文件是否正确。

如何订阅EVM合约内部自定义事件

问题背景

如何订阅evm合约自定义的事件。

解决方案

EVM合约示例如下：

调用SDK接口进行监听：

SDK连接Nginx代理后的链节点报错

问题背景

错误描述：

OPENSSL_internal:WRONG_VERSION_NUMBER

Nginx配置：

解决方案

Nginx配置时，不能配置HTTP通道的方式，因为SDK默认是使用tcp + rlp的方式连接的，所以如果SDK内使用tcp方式连接的话，Nginx中，也需要通过配置tcp的通道才可以。

the timestamp of tx is not in valid period

问题背景

发起交易时，出现the timestamp of tx is not in valid period的异常。

解决方案

重启SDK解决。

由于链节点出块的时间戳和SDK发起交易的时间戳相差太大，大于1个小时，SDK不重启的情况下，需要等待链节点追块完成后，才能正常发送交易。

TEE链请求公钥验证不正确

问题背景

以TEE链的方式请求时，提示公钥不正确。

解决方案

1. 链公钥获取（登录阿里云BaaS控制台下载），下载的公钥，其格式如下：

   

2. 使用公钥进行加密请求。

   重要

   请不要忘记写下面红框中的内容。

   

SDK如何设置签名

问题背景

SDK设置签名的方式有哪些？

解决方案

全局配置：SDK启动时配置

protected List<Keypair> abstractAdminKeyPairs = new ArrayList<>();
Pkcs8KeyOperator pkcs8KeyOperator = new Pkcs8KeyOperator();
String path = this.getClass().getClassLoader().getResource("").getPath();
Keypair ecKeyPair1 = pkcs8KeyOperator.load(path + properties.getProperty("client1.pk8"),
                                           keyPassword);
Keypair ecKeyPair2 = pkcs8KeyOperator.load(path + properties.getProperty("client2.pk8"),
                                           keyPassword);
Keypair ecKeyPair3 = pkcs8KeyOperator.load(path + properties.getProperty("client3.pk8"),
                                           keyPassword);
Keypair ecKeyPair4 = pkcs8KeyOperator.load(path + properties.getProperty("client4.pk8"),
                                           keyPassword);

abstractAdminKeyPairs.add(ecKeyPair1);
abstractAdminKeyPairs.add(ecKeyPair2);
abstractAdminKeyPairs.add(ecKeyPair3);
abstractAdminKeyPairs.add(ecKeyPair4);

List<SignerBase> signerBaseList = new ArrayList<>();
for (Keypair keypair : abstractAdminKeyPairs) {
    SignerBase signerBase = MyCrypto.getInstance().createSigner(keypair);
    signerBaseList.add(signerBase);
}
signerOption.setSigners(signerBaseList);
//配置到clientEnv中
clientEnv = ClientEnv.build(socketAddressArrayList, sslOption, signerOption);

局部配置：SDK发起交易时配置签名

// sign request
long ts = sdk.getNetwork().getSystemTimestamp();
preResetPubKeyRequest.setTxTimeNonce(ts, BaseFixedSizeUnsignedInteger.Fixed64BitUnsignedInteger
    .valueOf(RandomUtil.randomize(ts + preResetPubKeyRequest.getTransaction().hashCode())), true);
preResetPubKeyRequest.complete();
SignerBase signer = env.getSignerOption().getSigners().get(0);  
List<SignerBase> signers = new ArrayList<>();
signers.add(signer);
sdk.getAccountService().signRequest(signers, preResetPubKeyRequest);

局部配置的例子：

存证，先用admin创建一个用户，然后用创建的账户进行存证。

首先，创建一个新用户。

其次，使用新用户进行存证，进行存证之前，单独对这个账户进行了签名，签名用的私钥，就是创建账户时生成的私钥。

zk_lib：could not load a native libary

问题背景

解决方案

这块是零知识证明相关的，如果没用到，暂时可以忽略该异常。

SDK启动构造KeyPair时，提示Unknown Source

问题背景

解决方案

如果私钥路径没问题，获取的byte[]也没有问题，可以分析下私钥对应的密码有没有问题，现在发现的原因是私钥密码不正确会导致以上问题。

Mychain-java-sdk国密如何使用

问题背景

国密如何使用。

解决方案

一、TLS使用国密（可选）

• SDK开始支持的版本：V0.10.2.22。

• 配置SDK启动位置。

  以下位置设置为true。

  

二、交易使用国密

• SDK开始支持的版本：V0.10.2.14。

• 国密交易：hash算法为国密SM3；签名算法为SM2。

• 配置SDK启动位置配置全局国密算法。

  IHash hash = HashFactory.getHash(HashTypeEnum.SM3);
  DigestOption digestOption = new DigestOption();
  digestOption .setDefaultDigestType(HashTypeEnum.SM3));
  clientEnv.setDigestOption(digestOption);

  账户签名配置部分需要如下配置：

  

• 操作的账户必须为国密账户。

  用户的账户名称需要单独使用国密SM3进行hash。

  byte[] id = HashFactory.getHash(HashTypeEnum.SM3).hash(ByteUtils.stringToByteArray(identityName));
  Identity identity = new Identity(id);

连接正常但握手失败

问题背景

解决方案

1. client.key、client.crt、trustca证书是否正确，client.crt证书是否过期，client.key及trustca密码是否正确

2. 访问的链端口是否正确，是否是链节点之间共识同步的端口号。

3. 如果分析证书和链证书是完全一致的，则看看项目pom.xml中引用的org.bouncycastle相关包的版本是否正确，2.22版本之前为1.6.0，之后为1.66，可以通过命令：mvn dependency:tree查看是否存在冲突。

   如果出现以下情况，则表示有冲突，需要将1.62版本排除掉。

   

4. 链出块是否正常。

5. tcnative包是否冲突，需要netty和netty-tcnative的版本配套如下。

   io.netty:netty-all:jar:4.1.29.Final
   io.netty:netty-tcnative-boringssl-static:jar:2.0.17.Final

   如果netty-tcnative版本不正确，通常会报以下异常：

   

6. 如果本地访问如：localhost，需要定义为127.0.0.1。

7. 部署时如果出现问题，请检查JDK环境中是否引用了bcprov-jdk15-135.jar包。

   如果未引用，可以通过以下步骤进行添加。

   1. 查找SDK的安装位置：which java。

   2. 进入到SDK的安装位置。

   3. java安装目录下找到jre/lib/security/java.security文件。

   4. 添加一行：security.provider=org.bouncycastle.jce.provider.BouncyCastleProvider，（如果系统提示不能操作，切换到管理员权限，sudo su - root）。

   5. 进入jre/lib/ext目录下，将bcprov-jdk15-135.jar放进去。

   重要

   不能在java.security中添加配置，也不能在ext目录下添加bcprov-jdk15-135.jar包，即使改了名字也不能放在里面。

mychain-java-sdk支持的监控

问题背景

SDK支持监控吗？

解决方案

1. 开启QPS和TPS的监控。

   执行命令如下：

   ClientEnv -> MetricsOption.setEnableMetrics(true)

   执行后，会在控制台打印当前的QPS和TPS。

2. 查询mychain链监控接口。

   • V0.10.2.24.5的SDK，具体可参见监控指标接口。

   • V0.10.2.12的SDK，具体可参见监控指标接口。

   • V0.10.2.6的SDK，具体可参见监控指标接口。

存证交易的data大小限制是多少

问题背景

存证交易的data大小限制是多少？

解决方案

存证交易的data数据大小有上限限制，此限制为合约链的一个配置选项，通常默认1 MB，实际根据合约链的配置情况而定。

通常接口中参数amount转账金额的含义

问题背景

例如depositDataRequest中最后一个参数amount的含义是什么？

public void depositData() {
        String content = "hello world";
        DepositDataRequest depositDataRequest = new DepositDataRequest(
                userIdentity,
                adminAccount.getIdentity(),
                content.getBytes(), BigInteger.valueOf(10));
        DepositDataResponse depositDataResponse = sdk.getAccountService().depositData(depositDataRequest);
        if (!depositDataResponse.isSuccess()) {
            exit("depositData", getErrorMsg((int) depositDataResponse.getTransactionReceipt().getResult()));
        } else {
            System.out.println("depositData success.返回信息:" + depositDataResponse.toString());
        }
    }

解决方案

以上述的示例进行说明：

这个是交易里面的字段，单纯存证的话可以不管，但是存证的接口里面也包含了转账的能力，如果amount这个字段填写了，就会把这个from里面的资产转移那个数目到to账户里面去，如果不填，就不进行转账。