POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
scanshieldedtrc20notesbyivk
wallet/scanshieldedtrc20notesbyivk
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/scanshieldedtrc20notesbyivk \
  --header 'Content-Type: application/json' \
  --data '{
  "start_block_index": 10000000,
  "end_block_index": 10001000,
  "ivk": "0x05d4e5f6789012345678901234567890123456789012345678901234567890abcdef",
  "ak": "0x03b2c3d4e5f6789012345678901234567890123456789012345678901234567890ab",
  "nk": "0x04c3d4e5f6789012345678901234567890123456789012345678901234567890abcd",
  "shielded_TRC20_contract_address": "TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVp"
}'
{
  "note_txs": [
    {
      "block_num": 123,
      "tx_id": "<string>",
      "index": 123,
      "note": {}
    }
  ]
}
TRON API method that scans for shielded TRC20 notes using an incoming viewing key (ivk). This method allows users to detect incoming shielded transactions without revealing their spending keys or compromising privacy.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • start_block_index — the starting block number for scanning
  • end_block_index — the ending block number for scanning
  • ivk — the incoming viewing key for decrypting notes
  • ak — the authentication key for verification
  • nk — the nullifier key for note identification
  • shielded_TRC20_contract_address — the shielded TRC20 contract address to scan

​
Response

  • note_txs — array of found shielded note transactions
  • block_num — block number where notes were found
  • tx_id — transaction ID containing the notes
  • index — index of the note within the transaction
  • note — the decrypted note details including value and payment address

​
Use case

The wallet/scanshieldedtrc20notesbyivk method is used for:
  • Scanning the blockchain for incoming shielded TRC20 payments
  • Detecting received transactions without compromising sender privacy
  • Building wallet interfaces that show shielded transaction history
  • Monitoring shielded contract activity for specific addresses

Body

application/json

Response

200 - application/json

Successfully scanned for shielded notes

The response is of type object.