feat: add Tron payment detection retrievers and advanced logic support

[rodrigopavezi]

Description of the changes

Added a new Substreams module for indexing ERC20FeeProxy payment events on the TRON blockchain. This module:

• Tracks TransferWithReferenceAndFee events from deployed ERC20FeeProxy contracts on TRON mainnet and Nile testnet
• Extracts payment details including token address, amount, recipient, payment reference, fee information, and transaction metadata
• Provides a Rust implementation with WASM compilation for Substreams
• Includes configuration for deployment as a Substreams-powered subgraph
• Contains Makefile, build scripts, and package configuration for easy development and deployment
• Implements Base58 encoding for TRON addresses
• Supports both mainnet (TCUDPYnS9dH3WvFEaE7wN7vnDa51J4R4fd) and Nile testnet (THK5rNmrvCujhmrXa5DB1dASepwXTr9cJs) contract addresses

---

Closes RequestNetwork/private-issues#226

[coderabbitai]

Warning

Rate limit exceeded

@rodrigopavezi has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 24 minutes and 17 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

✨ 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-substreams

---

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 👈 (View in Graphite)
• feat: add Tron payment processor support #1690
• feat: add Tron payment detection support #1689
• 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 a new Substreams module for indexing ERC20FeeProxy payment events on TRON blockchain (mainnet and Nile testnet). The implementation includes Rust code to parse TransferWithReferenceAndFee events, protobuf definitions, GraphQL schema, and deployment configurations.

Critical Issues Found:

• Missing bs58 dependency in Cargo.toml - code will not compile
• Event signature hash is incomplete (40 chars vs 64) AND never validated in the filtering logic, causing the parser to attempt processing ALL events from proxy contracts instead of just TransferWithReferenceAndFee events
• Missing src/mappings.ts file referenced in subgraph.yaml - subgraph deployment will fail
• store_payments module declared in substreams.yaml but no corresponding handler function implemented

Positive Aspects:

• Well-structured protobuf definitions and GraphQL schema
• Comprehensive README with clear documentation
• Proper Base58Check encoding implementation for TRON addresses
• Good separation of concerns with modular parsing functions

Confidence Score: 0/5

• This PR has critical build and logic errors that will prevent compilation and correct operation
• Multiple blocking issues: missing dependency will cause build failure, incorrect event validation will process wrong events, missing required file will block deployment, and undefined handler will cause runtime errors
• Critical attention needed for Cargo.toml, src/lib.rs, subgraph.yaml, and substreams.yaml - all have blocking issues that must be resolved before merge

Important Files Changed

Filename	Overview
packages/substreams-tron/Cargo.toml	Missing critical bs58 dependency - build will fail
packages/substreams-tron/src/lib.rs	Critical logic errors: incorrect event signature, no event validation, will parse wrong events
packages/substreams-tron/substreams.yaml	Defines store_payments module without implementation handler
packages/substreams-tron/subgraph.yaml	References non-existent mappings.ts file - deployment will fail

Sequence Diagram

sequenceDiagram
participant TB as TRON Blockchain
participant SS as Substreams Module
participant Map as map_erc20_fee_proxy_payments
participant Parser as Event Parser
participant Store as store_payments
participant SG as Subgraph (mappings.ts)
TB->>SS: Block Stream (sf.tron.type.v1.Block)
SS->>Map: Process Block
loop For each transaction
Map->>Map: Extract transaction logs
loop For each log entry
Map->>Map: Check contract address<br/>(MAINNET or NILE proxy)
alt Contract address matches
Map->>Parser: parse_transfer_with_reference_and_fee()
Parser->>Parser: Extract payment reference from topics[1]
Parser->>Parser: Parse ABI-encoded data:<br/>- token_address<br/>- to<br/>- amount<br/>- fee_amount<br/>- fee_address
Parser->>Parser: Extract sender from transaction
Parser->>Parser: base58_encode() addresses
Parser-->>Map: Payment object
Map->>Map: Add to payments collection
end
end
end
Map-->>Store: Payments (proto:request.tron.v1.Payments)
Store->>Store: Index by payment reference
Store-->>SG: Payment events
SG->>SG: Transform to GraphQL entities

Loading

[greptile-apps]

_{4 files reviewed, 4 comments}

_{Edit Code Review Agent Settings | Greptile}

[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:17 PM UTC: Graphite rebased this pull request as part of a merge.
• Feb 12, 1:18 PM UTC: @rodrigopavezi merged this pull request with Graphite.