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.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/tron-payment-detection

---

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]

• feat: add Tron payment detection retrievers and advanced logic support #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
• chore: increase resource class to xlarge for CircleCI jobs #1698
• 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

[MantisClone]

LGTM — good test coverage for the detector and info retriever. Follows existing patterns well.

[rodrigopavezi]

Merge activity

• Feb 12, 1:06 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Feb 12, 1:13 PM UTC: Graphite rebased this pull request as part of a merge.
• Feb 12, 1:13 PM UTC: @rodrigopavezi merged this pull request with Graphite.