波场节点连接指南

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）

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 （测试或者您正式套餐超出了限制的并发会返回 429 错误）

• 请务必携带 X-CATFEE-TOKEN 头部进行认证

• gRPC 客户端需支持 http2

• 使用 walletsolidity 时默认查询的是已上链数据

---

🛠️ 技术支持

如有接入问题或需定制化支持，请联系 CatFee 技术团队：

• 客服 Telegram：@CatFee_James

• 官方网站：https://catfee.io

---

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