From 6460f8b1aa2663a53e0e1ad878f387a1f404a0f7 Mon Sep 17 00:00:00 2001
From: Nex <nexzhu@gmail.com>
Date: Wed, 24 Apr 2019 00:18:08 +0800
Subject: [PATCH] Update docs

---
 README.md                                     | 30 +++++++++++++++++++
 .../java/bdchain/api/grpc/acchain/Block.java  | 20 ++++++-------
 .../api/grpc/acchain/BlockOrBuilder.java      |  6 ++--
 .../java/bdchain/api/grpc/txledger/Block.java | 20 ++++++-------
 .../api/grpc/txledger/BlockOrBuilder.java     |  6 ++--
 5 files changed, 56 insertions(+), 26 deletions(-)

diff --git a/README.md b/README.md
index eadf8ae..6f6c858 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,36 @@
 - io.grpc:grpc-protobuf
 - io.grpc:grpc-stub
 
+w/ **Gradle**
+```
+compile 'io.grpc:grpc-netty-shaded:' + grpc_java_version
+compile 'io.grpc:grpc-protobuf:' + grpc_java_version
+compile 'io.grpc:grpc-stub:' + grpc_java_version
+```
+
+w/ **Maven**
+```
+<dependency>
+    <groupId>io.grpc</groupId>
+    <artifactId>grpc-netty-shaded</artifactId>
+    <version>${grpc_java_version}</version>
+</dependency>
+<dependency>
+    <groupId>io.grpc</groupId>
+    <artifactId>grpc-protobuf</artifactId>
+    <version>${grpc_java_version}</version>
+</dependency>
+<dependency>
+    <groupId>io.grpc</groupId>
+    <artifactId>grpc-stub</artifactId>
+    <version>${grpc_java_version}</version>
+</dependency>
+```
+
+## Usage
+
+See Javadoc and `src/test/java/bdchain/api/*Tests.java` files.
+
 ## Testing
 
 1. Download [mock servers](https://public.internetapi.cn/?dir=bdchain/test) for Transaction Ledger &
diff --git a/src/main/java/bdchain/api/grpc/acchain/Block.java b/src/main/java/bdchain/api/grpc/acchain/Block.java
index 88bb154..43d8ad4 100644
--- a/src/main/java/bdchain/api/grpc/acchain/Block.java
+++ b/src/main/java/bdchain/api/grpc/acchain/Block.java
@@ -316,7 +316,7 @@ private static final long serialVersionUID = 0L;
   private java.util.List<com.google.protobuf.ByteString> transactionHashes_;
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -327,7 +327,7 @@ private static final long serialVersionUID = 0L;
   }
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -337,7 +337,7 @@ private static final long serialVersionUID = 0L;
   }
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1524,7 +1524,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1536,7 +1536,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1546,7 +1546,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1556,7 +1556,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1573,7 +1573,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1589,7 +1589,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1604,7 +1604,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
diff --git a/src/main/java/bdchain/api/grpc/acchain/BlockOrBuilder.java b/src/main/java/bdchain/api/grpc/acchain/BlockOrBuilder.java
index e7afa52..781b331 100644
--- a/src/main/java/bdchain/api/grpc/acchain/BlockOrBuilder.java
+++ b/src/main/java/bdchain/api/grpc/acchain/BlockOrBuilder.java
@@ -132,7 +132,7 @@ public interface BlockOrBuilder extends
 
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -140,7 +140,7 @@ public interface BlockOrBuilder extends
   java.util.List<com.google.protobuf.ByteString> getTransactionHashesList();
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -148,7 +148,7 @@ public interface BlockOrBuilder extends
   int getTransactionHashesCount();
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
diff --git a/src/main/java/bdchain/api/grpc/txledger/Block.java b/src/main/java/bdchain/api/grpc/txledger/Block.java
index a630e54..6c512e0 100644
--- a/src/main/java/bdchain/api/grpc/txledger/Block.java
+++ b/src/main/java/bdchain/api/grpc/txledger/Block.java
@@ -343,7 +343,7 @@ private static final long serialVersionUID = 0L;
   private java.util.List<com.google.protobuf.ByteString> transactionHashes_;
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -354,7 +354,7 @@ private static final long serialVersionUID = 0L;
   }
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -364,7 +364,7 @@ private static final long serialVersionUID = 0L;
   }
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1629,7 +1629,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1641,7 +1641,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1651,7 +1651,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1661,7 +1661,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1678,7 +1678,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1694,7 +1694,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
@@ -1709,7 +1709,7 @@ private static final long serialVersionUID = 0L;
     }
     /**
      * <pre>
-     * 32字节的交易哈希的数组，或为空
+     * 20字节的交易哈希的数组，或为空
      * </pre>
      *
      * <code>repeated bytes transaction_hashes = 9;</code>
diff --git a/src/main/java/bdchain/api/grpc/txledger/BlockOrBuilder.java b/src/main/java/bdchain/api/grpc/txledger/BlockOrBuilder.java
index b806ce5..cd16c25 100644
--- a/src/main/java/bdchain/api/grpc/txledger/BlockOrBuilder.java
+++ b/src/main/java/bdchain/api/grpc/txledger/BlockOrBuilder.java
@@ -148,7 +148,7 @@ public interface BlockOrBuilder extends
 
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -156,7 +156,7 @@ public interface BlockOrBuilder extends
   java.util.List<com.google.protobuf.ByteString> getTransactionHashesList();
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>
@@ -164,7 +164,7 @@ public interface BlockOrBuilder extends
   int getTransactionHashesCount();
   /**
    * <pre>
-   * 32字节的交易哈希的数组，或为空
+   * 20字节的交易哈希的数组，或为空
    * </pre>
    *
    * <code>repeated bytes transaction_hashes = 9;</code>