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) for shard-independent tip address and POST ./api/v2/tip-wallet to get tip address for a specific shard, sender wallet address or external messages.

Parameters:

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

Note that either external_messages , shard 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"
}