Merge pull request #168 from tronprotocol/release_0.9.2

Merge release 0.9.2 to main

Author: kuny0707

README.md

@@ -1,27 +1,115 @@
-# trident
+# Trident - TRON Java SDK
 
-trident is a SDK that includes libraries for working with TRON, it makes it easy to build TRON applications with multi-language.
+## Overview
 
-## Contribution
+Trident is a lightweight Java SDK for interacting with the TRON blockchain. It provides a simple and efficient way to integrate TRON functionality into your Java applications.
+
+## Features
+
+- Complete implementation of TRON's gRPC interfaces
+- Smart contract deployment and interaction
+- Wallet key management and address utilities
+- Transaction building and signing
+- TRC10/TRC20/TRC721 token support
+
+## Adding Trident to your build
+
+Trident-java is compiled with java version 1.8 and gradle 7.6.
+
+### Gradle
+
+```groovy
+    implementation("io.github.tronprotocol:trident:0.9.2")
+```
+
+### Maven
+
+Add repo setting:
+
+```xml
+<dependency>
+  <groupId>io.github.tronprotocol</groupId>
+  <artifactId>trident</artifactId>
+  <version>0.9.2</version>
+</dependency>
+```
+
+### Using local build
 
-We're very glad and appreciate to have contributions from the community. 
+You can use locally built packages by follow steps:
 
-Refer to our [contributing guide](./CONTRIBUTING.md) for more information.
+1. Copy the compiled jar file to your project's `libs` directory
+2. Add the following to your project's `build.gradle`:
+```groovy
+dependencies {
+    implementation files('libs/trident-0.9.2.jar')
+    implementation "com.google.guava:guava:33.0.0-jre"
+    implementation "io.grpc:grpc-netty-shaded:1.60.0"
+    implementation "io.grpc:grpc-netty:1.60.0"
+    implementation "io.grpc:grpc-okhttp:1.60.0"
+    implementation "io.grpc:grpc-protobuf:1.60.0"
+    implementation "io.grpc:grpc-stub:1.60.0"
+    implementation "com.google.protobuf:protobuf-java-util:3.25.5"
+    implementation "org.bouncycastle:bcprov-jdk18on:1.78.1"
+    implementation "io.vertx:vertx-core:4.5.10"
+    implementation "io.netty:netty-all:4.1.118.Final"
+    implementation "com.alibaba.fastjson2:fastjson2:2.0.55"
+}
+```
 
-[Join our Telegram group](https://t.me/TronOfficialDevelopersGroupEn)
+## Quick Start
 
-## trident-java
+**Initialize client**
+```java
+// Initialize with TronGrid mainnet 
+ApiWrapper client = ApiWrapper.ofMainnet("private_key", "api_key"); //api_key from TronGrid
 
-trident-java is a lightweight SDK that includes libraries for working with TRON network.
+//Or Shasta test net 
+ApiWrapper client = ApiWrapper.ofShasta("private key");
 
-Functions include:
+// Or nile testnet
+ApiWrapper client = ApiWrapper.ofNile("private_key");
 
-- Offline address generation
+//Initialize with special grpc endpoint
+ApiWrapper client = new ApiWrapper("grpc endpoint", "solidity grpc endpoint", "private_key");
+
+// Send TRX
+TransactionExtention transactionExtention = client.transfer("fromAddress", "toAddress", 100_000_000L); //100TRX
+// Sign
+Transaction signedTxn = client.signTransaction(transactionExtention);
+// Broadcast
+String txId = client.broadcastTransaction(signedTxn);
+System.out.println("txId is " + txId);
+```
+
+## Documentation
+
+- [Official Documentation](https://developers.tron.network/docs/trident-java)
+
+
+## Build instructions
+Trident includes integration tests for running on the Nile testnet. If you want to run test cases involving write operations on the blockchain, such as transfer or deploy contract and so on, please follow the steps:
+
+1. Uncomment the Disabled function in the unit test cases.
+```
+   //@Disabled("add private key to enable this case")
+```
+2. Set the tron.private-key and tron.tokenId in the test configuration file in the core directory [here](trident-java/core/src/test/resources/application-test.properties).
+
+
+``` 
+tron.private-key=xxx
+tron.tokenId=1000587
+```
+
+**Note:** The account should have at least 1000 TRX, 100 USDT, and 1000 TRC10 token on the Nile testnet. you can get testCoin from [nileex.io](https://nileex.io/join/getJoinPage).
+
+## Contribution
 
-- Offline transaction construct
+We're very glad and appreciate to have contributions from the community.
 
-- Offline transaction signature 
+Refer to our [contributing guide ](CONTRIBUTING.md)for more information.
 
-- java-tron full node API support
+## Licence
 
-For more informations refer to : [trident-java document](https://developers.tron.network/docs/trident-java)
+Trident is distributed under a MIT licence.

trident-java/.gitignore

@@ -26,3 +26,7 @@ build/
 .idea
 .vscode
 demo/
+
+# proto gen file
+/core/src/main/java/org/tron/trident/proto/
+/core/src/main/java/org/tron/trident/api/

trident-java/README.md

@@ -6,67 +6,23 @@ Trident-Java makes it easy to build TRON applications with java.
 
 [Trident-Java document](https://developers.tron.network/docs/trident-java)
 
-Due to safety concerns, trident-java will no longer upload packaged files to maven. Please clone the code from GitHub and do the packaging.
-
-Trident-java is compiled with java version 1.8.0_231 and gradle 5.6.4.
+Trident-java is compiled with java version 1.8 and gradle 7.6.
 
 ## How to use
 
 ### Gradle Setting
 
-Add repo setting:
-
 ```groovy
-repositories {
-    mavenCentral()
-}
+    implementation("io.github.tronprotocol:trident:0.9.2")
 ```
 
-Then add required packages as dependencies. Please add dependencies locally.
-
-```groovy
-dependencies {
-    // protobuf & grpc
-    implementation 'com.google.protobuf:protobuf-java:3.25.5'
-
-    implementation fileTree(dir:'../core')
-    implementation fileTree(dir:'../utils')
-    implementation fileTree(dir:'../abi')
-
-    implementation 'com.google.guava:guava:28.0-jre'
-}
-```
+### Maven Setting
 
-Or if you are using the jar files as your dependencies:
-
-```groovy
-dependencies {
-    implementation fileTree(dir:'your path', include: '*.jar')
-}
-```
-
-### Maven Settings
 
 ```xml
 <dependency>
-  <groupId>org.tron.trident</groupId>
-  <artifactId>abi</artifactId>
-  <version>0.9.1</version>
-  <scope>system</scope>
-  <systemPath>your path</systemPath>
-</dependency>
-<dependency>
-  <groupId>org.tron.trident</groupId>
-  <artifactId>utils</artifactId>
-  <version>0.9.1</version>
-  <scope>system</scope>
-  <systemPath>your path</systemPath>
-</dependency>
-<dependency>
-  <groupId>org.tron.trident</groupId>
-  <artifactId>core</artifactId>
-  <version>0.9.1</version>
-  <scope>system</scope>
-  <systemPath>your path</systemPath>
+  <groupId>io.github.tronprotocol</groupId>
+  <artifactId>trident</artifactId>
+  <version>0.9.2</version>
 </dependency>
 ```

trident-java/abi/build.gradle

@@ -1,23 +1,9 @@
 plugins {
-    
+    id 'java-library'
 }
 
 description 'TRON Application Binary Interface (ABI) for working with smart contracts'
 
 dependencies {
     implementation project(':utils')
 }
-
-tasks.create('buildLib', Jar) {
-    baseName = 'trident'
-    version = null
-    from(sourceSets.main.output) {
-        include '/**'
-    }
-
-    from {
-        configurations.compile.collect {
-            it.isDirectory() ? it : zipTree(it)
-        }
-    }
-}