feat: add Tron payment detection support

[rodrigopavezi]

Description of the changes

Added support for TRON blockchain payment detection in the Request Network. This implementation includes:

• Created a TRON-specific ERC20 fee proxy payment detector (TronERC20FeeProxyPaymentDetector)
• Added a TRON info retriever (TronInfoRetriever) to fetch payment events from TRON subgraphs
• Integrated GraphQL queries for TRON payments with support for both mainnet and Nile testnet
• Updated TheGraph client to support TRON chains
• Added codegen configuration for TRON GraphQL schema
• Registered TRON payment detectors in the payment network factory
• Added comprehensive unit tests for the new TRON components

The implementation follows the same pattern as other blockchain integrations while accounting for TRON-specific requirements.

---

Closes RequestNetwork/private-issues#227

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

• 🔍 Trigger a full review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[rodrigopavezi]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat: add Tron substreams indexing package #1691
• feat: add Tron payment processor support #1690
• feat: add Tron payment detection support #1689 👈 (View in Graphite)
• feat: add Tron chain definitions for currency package #1688
• feat: add Tron smart contracts and deployment infrastructure #1687
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Overview

Greptile Summary

This PR adds comprehensive support for TRON blockchain payment detection to the Request Network. The implementation follows the established architectural patterns used for EVM and NEAR chains.

Key Changes:

• Created TronERC20FeeProxyPaymentDetector that extends the base ERC20 fee proxy detector for TRON-specific payment detection
• Implemented TronInfoRetriever to fetch payment events from TRON subgraphs using GraphQL queries
• Integrated TRON support into TheGraphClient with dedicated SDK (getTronSdk) and subgraph URLs for both mainnet and Nile testnet
• Registered TRON payment detectors in the PaymentNetworkFactory for both tron and nile network chains
• Added GraphQL queries supporting both token-filtered and any-token payment retrieval
• Configured GraphQL code generation pipeline for TRON schema
• Included comprehensive unit tests achieving good coverage of core functionality

Implementation Quality:
The code follows consistent patterns from existing NEAR/EVM implementations, properly handles network validation, error cases, and edge conditions. The test coverage validates deployment information, network validation, and event extraction flows.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• The implementation follows established patterns from NEAR/EVM integrations, includes comprehensive unit tests, proper error handling, and network validation. The code is well-structured, maintainable, and integrates cleanly with existing architecture.
• No files require special attention

Important Files Changed

Filename	Overview
packages/payment-detection/src/tron/tron-fee-proxy-detector.ts	New TRON ERC20 fee proxy payment detector following established patterns from EVM/NEAR detectors
packages/payment-detection/src/tron/tron-info-retriever.ts	TheGraph-based info retriever for TRON payments with proper event mapping
packages/payment-detection/src/thegraph/client.ts	Added TRON chain support with dedicated SDK and subgraph URLs for mainnet and Nile testnet
packages/payment-detection/src/payment-network-factory.ts	Registered TRON ERC20 fee proxy detector for both tron and nile networks
packages/payment-detection/src/thegraph/queries/tron/GetTronPayments.graphql	GraphQL queries for TRON payment events with and without token filtering

Sequence Diagram

sequenceDiagram
    participant Client
    participant Factory as PaymentNetworkFactory
    participant Detector as TronERC20FeeProxyPaymentDetector
    participant Retriever as TronInfoRetriever
    participant GraphQL as TheGraphClient<TronChain>
    participant Subgraph as TRON Subgraph

    Client->>Factory: getPaymentNetworkFromRequest(request)
    Factory->>Factory: Identify TRON chain (tron/nile)
    Factory->>Detector: new TronERC20FeeProxyPaymentDetector({network, getSubgraphClient})
    Factory-->>Client: Return detector instance

    Client->>Detector: extractEvents(eventName, toAddress, paymentReference, currency, chain)
    Detector->>Detector: Validate TRON chain support
    Detector->>Detector: Validate network matches detector network
    Detector->>Detector: getDeploymentInformation(chain)
    Note over Detector: Gets proxy contract address & creation block

    Detector->>Detector: getSubgraphClient(chain)
    Note over Detector: Returns TheGraphClient for tron/nile
    
    Detector->>Retriever: new TronInfoRetriever(subgraphClient)
    Detector->>Retriever: getTransferEvents({paymentReference, toAddress, contractAddress, acceptedTokens})

    Retriever->>Retriever: Hash payment reference with keccak256
    
    alt Single token filter
        Retriever->>GraphQL: GetTronPayments(reference, to, tokenAddress, contractAddress)
    else No token filter
        Retriever->>GraphQL: GetTronPaymentsAnyToken(reference, to, contractAddress)
    end

    GraphQL->>Subgraph: Query payment events
    Subgraph-->>GraphQL: Return payments array
    GraphQL-->>Retriever: Return payments

    Retriever->>Retriever: Map payments to event format
    Note over Retriever: Convert amount, feeAmount to strings<br/>Add txHash, block, timestamp

    Retriever-->>Detector: Return {paymentEvents}
    Detector-->>Client: Return payment events

Loading

[greptile-apps]

_{No files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}

[MantisClone]

Looks good to me so far.

Reviewed with Claude Code Opus 4.5