feat: add Tron payment processor support

[rodrigopavezi]

Description of the changes

Added support for Tron blockchain payments in the payment-processor package. This implementation enables TRC20 token payments through the ERC20 Fee Proxy contract on Tron networks.

The changes include:

• New tron-fee-proxy.ts module with functions for paying requests on Tron:

  • payTronFeeProxyRequest - Process payments with TRC20 tokens
  • approveTronFeeProxyRequest - Approve token spending
  • hasSufficientTronAllowance - Check token allowance
  • hasSufficientTronBalance - Verify token balance
  • getTronPaymentInfo - Get payment details

• New utils-tron.ts module with Tron-specific utilities:

  • TronWeb type definitions
  • Address validation
  • Contract interaction helpers
  • Token approval and payment processing

• Comprehensive test coverage for all new functionality

• Exports for the new modules in the package index

---

Closes RequestNetwork/private-issues#234

[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 👈 (View in Graphite)
• 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

Added comprehensive Tron blockchain payment support to the payment-processor package, enabling TRC20 token payments through the ERC20 Fee Proxy contract.

Key Changes:

• Implemented tron-fee-proxy.ts with core payment functions: payTronFeeProxyRequest, approveTronFeeProxyRequest, hasSufficientTronAllowance, hasSufficientTronBalance, and getTronPaymentInfo
• Created utils-tron.ts with Tron-specific utilities including TronWeb type definitions, address validation (isValidTronAddress), and contract interaction helpers
• Added comprehensive test coverage in tron-fee-proxy.test.ts with proper mocking and edge case testing
• Leveraged existing ERC20FeeProxy smart contract artifact structure with Tron-specific deployments (mainnet: TCUDPYnS9dH3WvFEaE7wN7vnDa51J4R4fd, testnet: THK5rNmrvCujhmrXa5DB1dASepwXTr9cJs)
• Added tronweb@5.3.2 and ethers@6.16.0 dependencies to support Tron integration

Implementation Details:

• Payment flow follows the same pattern as EVM chains: validate network → check allowance → verify balance → execute payment
• Uses TronWeb's contract API to interact with TRC20 tokens and the ERC20FeeProxy contract
• Validates Tron addresses using Base58Check format (34 characters starting with 'T')
• Properly formats payment references with 0x prefix for contract calls
• Fee limits set to 100 TRX for approvals and 150 TRX for proxy payments

Confidence Score: 4/5

• This PR is safe to merge with standard review
• Implementation follows established patterns from EVM payment processors, includes comprehensive test coverage, and properly validates inputs. Minor points: error handling in utility functions returns default values which could mask network issues, and the test timeout increase suggests potential performance concerns worth monitoring
• Pay close attention to utils-tron.ts error handling in isTronAccountSolvent and getTronAllowance functions which catch and suppress errors by returning default values

Important Files Changed

Filename	Overview
packages/payment-processor/src/payment/tron-fee-proxy.ts	adds Tron payment processor functions with proper validation, allowance/balance checks, and payment execution
packages/payment-processor/src/payment/utils-tron.ts	implements Tron-specific utilities including TronWeb types, address validation, contract interactions, and payment processing
packages/payment-processor/test/payment/tron-fee-proxy.test.ts	comprehensive test coverage for Tron payment processor functions with proper mocking and edge case testing
packages/payment-processor/src/index.ts	exports new Tron modules for public API
yarn.lock	adds tronweb@5.3.2 and related dependencies (ethers@6.16.0, axios@1.13.2, etc.)

Sequence Diagram

sequenceDiagram
    participant Client
    participant TronFeeProxy as tron-fee-proxy.ts
    participant UtilsTron as utils-tron.ts
    participant TronWeb
    participant TRC20Contract as TRC20 Token
    participant ProxyContract as ERC20FeeProxy

    Note over Client,ProxyContract: Approval Flow
    Client->>TronFeeProxy: approveTronFeeProxyRequest(request, tronWeb)
    TronFeeProxy->>TronFeeProxy: Validate network (TronChains)
    TronFeeProxy->>TronFeeProxy: Calculate total amount (payment + fee)
    TronFeeProxy->>UtilsTron: approveTrc20(tronWeb, tokenAddress, network, amount)
    UtilsTron->>UtilsTron: getERC20FeeProxyAddress(network)
    UtilsTron->>TronWeb: contract(TRC20_ABI, tokenAddress)
    TronWeb-->>UtilsTron: TRC20 contract instance
    UtilsTron->>TRC20Contract: approve(proxyAddress, amount).send()
    TRC20Contract-->>UtilsTron: Transaction result
    UtilsTron->>UtilsTron: callback.onHash(txHash)
    UtilsTron-->>TronFeeProxy: txHash
    TronFeeProxy-->>Client: txHash

    Note over Client,ProxyContract: Payment Flow
    Client->>TronFeeProxy: payTronFeeProxyRequest(request, tronWeb)
    TronFeeProxy->>TronFeeProxy: Validate network (TronChains)
    TronFeeProxy->>TronFeeProxy: validateRequest(ERC20_FEE_PROXY_CONTRACT)
    TronFeeProxy->>TronFeeProxy: getRequestPaymentValues()
    TronFeeProxy->>TronFeeProxy: validatePaymentReference()
    TronFeeProxy->>UtilsTron: isValidTronAddress(paymentAddress)
    UtilsTron-->>TronFeeProxy: validation result
    
    TronFeeProxy->>UtilsTron: getTronAllowance(tronWeb, tokenAddress, network)
    UtilsTron->>TronWeb: contract(TRC20_ABI, tokenAddress)
    TronWeb-->>UtilsTron: contract instance
    UtilsTron->>TRC20Contract: allowance(owner, spender).call()
    TRC20Contract-->>UtilsTron: allowance amount
    UtilsTron-->>TronFeeProxy: BigNumber allowance
    
    alt Insufficient Allowance
        TronFeeProxy-->>Client: Error: Insufficient TRC20 allowance
    end
    
    TronFeeProxy->>UtilsTron: isTronAccountSolvent(tronWeb, tokenAddress, amount)
    UtilsTron->>TronWeb: contract(TRC20_ABI, tokenAddress)
    TronWeb-->>UtilsTron: contract instance
    UtilsTron->>TRC20Contract: balanceOf(owner).call()
    TRC20Contract-->>UtilsTron: balance
    UtilsTron-->>TronFeeProxy: true/false
    
    alt Insufficient Balance
        TronFeeProxy-->>Client: Error: Insufficient TRC20 token balance
    end
    
    TronFeeProxy->>UtilsTron: processTronFeeProxyPayment(params)
    UtilsTron->>UtilsTron: Validate all addresses
    UtilsTron->>UtilsTron: getERC20FeeProxyAddress(network)
    UtilsTron->>TronWeb: contract(ERC20_FEE_PROXY_ABI, proxyAddress)
    TronWeb-->>UtilsTron: proxy contract instance
    UtilsTron->>UtilsTron: Format payment reference (add 0x prefix)
    UtilsTron->>ProxyContract: transferFromWithReferenceAndFee(token, to, amount, ref, feeAmount, feeAddress).send()
    ProxyContract->>TRC20Contract: transferFrom(payer, recipient, amount)
    TRC20Contract-->>ProxyContract: success
    alt Fee > 0
        ProxyContract->>TRC20Contract: transferFrom(payer, feeRecipient, feeAmount)
        TRC20Contract-->>ProxyContract: success
    end
    ProxyContract-->>UtilsTron: Transaction result
    UtilsTron->>UtilsTron: callback.onHash(txHash)
    UtilsTron-->>TronFeeProxy: txHash
    TronFeeProxy-->>Client: txHash

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