波场节点连接指南
CatFee 提供稳定高效的 TRON 节点租用服务,支持通过 gRPC 协议 与 TRON 网络交互,助力开发者快速集成波场功能,构建高性能 DApp 或链上服务。
📍 节点信息
演示节点地址(Node Host):
tron-deom.catfee.io
端口(Port):
50051
协议:
gRPC
认证方式:
Header 名:
X-CATFEE-TOKEN
Header 值:
YOUR_API_KEY
(如需测试请联系客服获取3天测试key体验)
💡
wallet
和walletSolidity
的 gRPC 服务均通过端口50051
提供。💡 付费后,在控制面板【波场节点】 -【套餐】菜单可以找到自己的节点地址和key,如下图示:

🌐 通信方式概览
通过 gRPC 协议,可以访问 TRON 节点的常用服务:
wallet
: 适用于状态未确认的交易(未进区块)walletSolidity
: 用于读取已上链的数据
🚀 多语言连接示例
下面是常用语言如何连接 TRON 节点的示例,使用 CatFee 提供的 gRPC 服务。
🐍 Python 示例(使用 grpcio
和 tronpy
)
grpcio
和 tronpy
)pip install grpcio tronpy
from tronpy.providers.grpc_provider import GrpcProvider
from tronpy import Tron
provider = GrpcProvider(
endpoint="tron-168.catfee.io:50051",
api_key="YOUR_API_KEY",
secure=False # 非加密连接
)
client = Tron(provider=provider)
account = client.get_account("T...")
print(account)
🟦 Node.js 示例(使用 grpc
和官方 proto)
grpc
和官方 proto)npm install grpc @grpc/grpc-js @grpc/proto-loader
const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');
const packageDef = protoLoader.loadSync('wallet.proto', {});
const walletProto = grpc.loadPackageDefinition(packageDef).protocol;
const metadata = new grpc.Metadata();
metadata.set('X-CATFEE-TOKEN', 'YOUR_API_KEY');
const client = new walletProto.Wallet(
'tron-168.catfee.io:50051',
grpc.credentials.createInsecure()
);
// 示例调用
client.GetNow({},metadata, (err, res) => {
console.log(res);
});
🔧 提前准备
.proto
文件,详见 TRON 官方仓库:https://github.com/tronprotocol/protocol
☕ Java 示例(使用 grpc-java
)
grpc-java
)/*
<dependency>
<groupId>io.github.tronprotocol</groupId>
<artifactId>trident</artifactId>
<version>0.9.2</version>
</dependency>
*/
import io.grpc.ManagedChannel;
import io.grpc.Metadata;
import io.grpc.netty.NettyChannelBuilder;
import io.grpc.stub.MetadataUtils;
import org.tron.trident.api.GrpcAPI;
import org.tron.trident.api.WalletGrpc;
import org.tron.trident.core.ApiWrapper;
import org.tron.trident.proto.Response;
ManagedChannel channel = NettyChannelBuilder
.forAddress("tron-168.catfee.io", 50051)
.usePlaintext()
.build();
Metadata metadata = new Metadata();
metadata.put(Metadata.Key.of("X-CATFEE-TOKEN", Metadata.ASCII_STRING_MARSHALLER), "YOUR_API_KEY");
WalletGrpc.WalletBlockingStub walletStub = WalletGrpc.newBlockingStub(channel)
.withInterceptors(MetadataUtils.newAttachHeadersInterceptor(metadata));
GrpcAPI.AccountAddressMessage request = GrpcAPI.AccountAddressMessage.newBuilder().setAddress(ApiWrapper.parseAddress("T...")).build();
Response.Account response = walletStub.getAccount(request);
System.out.println(response);
📦 支持的调用接口
GetAccount
GetTransactionById
CreateTransaction
BroadcastTransaction
TriggerSmartContract
等等……
📚 接口文档参考:https://developers.tron.network/reference/installation
⚠️ 使用注意事项
测试环境每秒并发请求限制为:20 req/s
请务必携带
X-CATFEE-TOKEN
头部进行认证gRPC 客户端需支持
http2
使用
walletsolidity
时默认查询的是已上链数据
🛠️ 技术支持
如有接入问题或需定制化支持,请联系 CatFee 技术团队:
客服 Telegram:@CatFee_James
官方网站:https://catfee.io
构建波场应用,选择稳定可信的节点是关键。CatFee 提供高可用、低延迟、支持认证的波场节点服务,是您链上开发的不二之选!
Last updated
Was this helpful?