feat: add Tron substreams indexing package

[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]

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 👈 (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
• 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}