Transaction Sender Guide
Learn how to send high-priority transactions through the Paladin network to ensure they are processed efficiently and protected from sandwiching attacks.
1. Access Requirements
To become a transaction sender on the Paladin network, you need to meet two requirements:
- Have your IP address whitelisted for access to validator ports
- Have $TESTPAL tokens locked up on your behalf for token-gated access
Please reach out to @edgarpavlovsky
on Telegram to initiate the whitelisting process and token setup.
2. Getting the Validator List
Once whitelisted, you can retrieve the current list of active Paladin validators through our API:
GET https://api.paladin.one/validators
This endpoint returns an array of active validators. We recommend:
- Polling this endpoint once per day to maintain an up-to-date list
- Pairing the validator list with your leader schedule tracking
3. Understanding Priority Ports
Paladin validators expose two QUIC ports for priority transaction processing:
4819
: Standard P3 transactions (include on revert)4820
: MEV P3 transactions (fail on revert)
Note: Port 4818 has been deprecated. Please ensure you are using the new ports (4819 and 4820) for all transactions.
4. Sending Transactions
When sending transactions through Paladin ports, keep in mind:
- Only send transactions to a validator when they are the current leader
- Use port 4819 for transactions that should be included even if they revert
- Use port 4820 for transactions that should fail if they would revert
Important: Sending transactions to Paladin ports is only relevant when the target validator is the current leader. Ensure you are tracking the leader schedule and only sending to the appropriate validator.
For reference, you can find an example implementation of a Paladin transaction sender in our p3-txn-sender repository. Please note that this implementation is provided for educational purposes and should not be considered production-ready.