TRON Developer Hub CN

TRON开发者中心

欢迎来到TRON开发者中心。您将找到全面的指南和文档,以帮助您尽快开始使用TRON Developer Hub,并在遇到困难时提供支持。让我们跳进去吧!

Get Started    

快速入门

🚧

重要通知

由于Bintray & jcenter将逐步停止服务(详见Into the Sunset on May 1st: Bintray, JCenter, GoCenter, and ChartCenter),trident-java已经迁移到Nexus中,地址在下面的示例中。同时对jcenter的引用也需要替换为mavenCentral

旧的maven URL将在Bintray完全停止服务之前一直可用,但仅适用于0.1.0版本。

概述

trident-java是一个极其轻量的SDK。它包含了一系列库,方便开发者使用波场网络的系统与智能合约。

我们相信trident-java可以很大程度帮助你使用java开发波场相关的应用程序。

入门

安装trident-java

要想在工程中使用trident-java,首先需要添加trident-java的包作为依赖。

使用Bintray仓库

trident-java使用的是Bintray仓库,需要添加配置。

依赖配置

Gradle配置:

repositories {
    maven {
        mavenCentral()
        url  "http://3.130.234.198:8081/nexus/content/repositories/trident/"
    }
}

选择需要的库

trident-java有三个包:

abi

包含了ABI中使用的各种数据类型,以及编码/解码工具。

core

包含了封装的方法,便于使用波场系统合约与智能合约。对常用内容有单独封装(如:TRC-20)。

utils

包含了各种常用工具,例如:sha256计算,地址格式转换,等。

在Gradle中添加依赖

trident-java的封装函数中,使用GRPC与波场网络进行交互,所以在添加依赖时,需要添加Google Protobuf以及GRPC相关的依赖。

dependencies {
    // protobuf & grpc
    implementation 'com.google.protobuf:protobuf-java:3.11.0'

    implementation 'org.tron.trident:abi:0.1.1'
    implementation 'org.tron.trident:core:0.1.1'
    implementation 'org.tron.trident:utils:0.1.1'

    implementation 'com.google.guava:guava:28.0-jre'
}

在Maven中添加依赖

<dependency>
  <groupId>org.tron.trident</groupId>
  <artifactId>abi</artifactId>
  <version>0.1.1</version>
  <type>pom</type>
</dependency>
<dependency>
  <groupId>org.tron.trident</groupId>
  <artifactId>utils</artifactId>
  <version>0.1.1</version>
  <type>pom</type>
</dependency>
<dependency>
  <groupId>org.tron.trident</groupId>
  <artifactId>core</artifactId>
  <version>0.1.1</version>
  <type>pom</type>
</dependency>

使用trident-java

core包中的ApiWrapper类,是各个API以及智能合约调用的封装方法的入口。

新建一个ApiWrapper实例

在使用ApiWrapper包含的方法之前,需要在初始化时,将一个私钥绑定到ApiWrapper的实例。

ApiWrapper wrapper = new ApiWrapper("grpc endpoint", "solidity grpc endpoint", "hex private key");

你可以使用任何节点/TronGrid。除此之外,ApiWrapper有封装好的波场主网、Shasta以及Nile测试网的初始化方法,分别使用TronGrid和Nile官方网站上提供的节点。

//main net, using TronGrid
ApiWrapper wrapper = ApiWrapper.ofMain("hex private key", "API key");
//Shasta test net, using TronGrid
ApiWrapper wrapper = ApiWrapper.ofShasta("hex private key");
//Nile test net, using a node from Nile official website
ApiWrapper wrapper = ApiWrapper.ofNile("hex private key");

📘

绑定私钥

私钥的唯一作用是给交易签名。也就是说,当你只需要做查询操作时,可以使用任何符合长度的十六进制字符串当做私钥来初始化ApiWrapper实例。

JavaDoc

core包中的方法有完善的JavaDoc。在需要的时候,手动生成它!

Updated about 17 hours ago

快速入门


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.