波场节点连接指南

CatFee 提供稳定高效的 TRON 节点租用服务,支持通过 gRPC 协议 与 TRON 网络交互,助力开发者快速集成波场功能,构建高性能 DApp 或链上服务。

📍 节点信息

  • 演示节点地址(Node Host)tron-deom.catfee.io

  • 端口(Port)50051

  • 协议gRPC

  • 认证方式

    • Header 名:X-CATFEE-TOKEN

    • Header 值:YOUR_API_KEY(如需测试请联系客服获取3天测试key体验)

💡 walletwalletSolidity 的 gRPC 服务均通过端口 50051 提供。

💡 付费后,在控制面板【波场节点】 -【套餐】菜单可以找到自己的节点地址和key,如下图示:


🌐 通信方式概览

通过 gRPC 协议,可以访问 TRON 节点的常用服务:

  • wallet: 适用于状态未确认的交易(未进区块)

  • walletSolidity: 用于读取已上链的数据


🚀 多语言连接示例

下面是常用语言如何连接 TRON 节点的示例,使用 CatFee 提供的 gRPC 服务。


🐍 Python 示例(使用 grpciotronpy

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)

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

/*
        <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 技术团队:


构建波场应用,选择稳定可信的节点是关键。CatFee 提供高可用、低延迟、支持认证的波场节点服务,是您链上开发的不二之选!

Last updated

Was this helpful?