Get Tip Wallet Address

This endpoint is used to get a tip destination address to be used with either single transaction (with MEV protection ON) or transactions batch submission.

Request

Method:

GET ./api/v2/tip-wallet (with no params) when sending a single transaction without MEV protection and POST ./api/v2/tip-wallet to get tip address for a specific shard defined by sender wallet address or external messages. The latter should be used when sending transaction with MEV protection or in a batch.

Parameters:

Parameter	type	Description
external_messages	array of string	External message payloads (base64) to resolve shard tip wallet address. Use this for Submit Signed Transactions Batch .
address	string	Sender wallet address. Use this for Submit Signed Transaction method with MEV protection.

Note that either external_messages or address must be set.

Request example:

HTTP (GET)

curl -X 'GET' \
  'https://ny.ton.dex.blxrbdn.com/api/v2/tip-wallet' \
  -header "Authorization: $AUTH_HEADER" 

HTTP (POST)

curl -X 'POST' \
  'https://ny.ton.dex.blxrbdn.com/api/v2/tip-wallet' \
  -header "Authorization: $AUTH_HEADER" \
  -d '{
 "external_messages": ["Aj+Br...ABC", "Aj+Br...ABC", ...]
}'

Response:

Fields:

Parameter	Type	Description
tip_wallet_address	string	A shard-specific for sending a tip.
shard	string	A shard that was located for a given input.

Example:

JSON

{
  "shard": "0xE000000000000000",
  "tip_wallet_address": "EQDPUyq1PnJ....CWzjOn976fe-j"
}