# TRON Node Connection Guide

**CatFee** offers stable and high-performance **TRON node rental services**, supporting gRPC protocol for seamless interaction with the TRON network. This helps developers quickly integrate TRON features to build high-performance DApps or on-chain services.

***

### 📍 Node Information

* **Node Host**: `tron-168.catfee.io`
* **Port**: `50051`
* **Protocol**: gRPC
* **Authentication**:
  * **Header Name**: `X-CATFEE-TOKEN`
  * **Header Value**: `YOUR_API_KEY` (Please contact support to obtain)

> 💡 Both `wallet` and `walletSolidity` gRPC services are available on port 50051.

***

### 🌐 Communication Overview

Using the **gRPC protocol**, you can access common services of the TRON node:

* `wallet`: For unconfirmed transactions (not yet on-chain)
* `walletSolidity`: For reading confirmed on-chain data

***

### 🚀 Multi-language Connection Examples

#### **🐍 Python (Using `grpcio` and `tronpy`)**

```bash
pip install grpcio tronpy
```

```python
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  # Unsecured connection
)

client = Tron(provider=provider)
account = client.get_account("T...")
print(account)
```

***

#### **🟦 Node.js (Using `grpc` and official proto files)**

```bash
npm install grpc @grpc/grpc-js @grpc/proto-loader
```

```js
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);
});
```

> 🔧 Be sure to prepare `.proto` files in advance. See TRON’s official repository:\
> <https://github.com/tronprotocol/protocol>

***

#### **☕ Java (Using `grpc-java`)**

```java
ManagedChannel channel = NettyChannelBuilder
    .forAddress("tron-168.catfee.io", 50051)
    .usePlaintext()
    .build();

WalletGrpc.WalletBlockingStub walletStub = WalletGrpc.newBlockingStub(channel)
    .withInterceptors(MetadataUtils.newAttachHeadersInterceptor(
        new Metadata() {{
            put(Metadata.Key.of("X-CATFEE-TOKEN", Metadata.ASCII_STRING_MARSHALLER), "YOUR_API_KEY");
        }}
    ));

Account request = Account.newBuilder().setAddress(ByteString.copyFromUtf8("T...")).build();
Account response = walletStub.getAccount(request);
System.out.println(response);
```

***

### 📦 Supported API Interfaces

* `GetAccount`
* `GetTransactionById`
* `CreateTransaction`
* `BroadcastTransaction`
* `TriggerSmartContract`\
  ...and more

> 📚 Refer to API documentation:\
> <https://developers.tron.network/reference/wallet-getaccount>

***

### ⚠️ Important Notes

* The test environment supports up to **20 requests per second (**&#x41; 429 error will be returned if the test or your official package exceeds the concurrency limit.**)**
* Always include the `X-CATFEE-TOKEN` header for authentication
* gRPC clients must support **HTTP/2**
* When using `walletSolidity`, data is retrieved from the **confirmed on-chain state**

***

### 🛠️ Technical Support

If you encounter any integration issues or need customized support, contact the CatFee tech team:

* **Telegram Support**: [@CatFee\_James](https://t.me/CatFee_James)
* **Official Website**: [https://catfee.io](https://catfee.io/)

***

Choosing a reliable node is critical for building on TRON.\
**CatFee** offers highly available, low-latency, authenticated TRON node services—your best choice for blockchain development!