Enerji Miktarını Tahmin Et
Bu uç nokta işlem oluşturmadan token transferi yapmak için gereken enerji miktarını tahmin eder.
POST /v1/estimate-energy
İstek
İstek Parametreleri
Alan | Tür | Gerekli | Açıklama |
---|---|---|---|
from_address | string | Evet | Gönderenin TRON cüzdan adresi (34 karakter) |
to_address | string | Evet | Alıcının TRON cüzdan adresi (34 karakter) |
contract_address | string | Hayır | Akıllı sözleşme adresi (varsayılan: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t - Tether (USDT)) |
bash
#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{
"from_address": "TRX_FROM_ADDRESS",
"to_address": "TRX_TO_ADDRESS",
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}'
# İmzayı hesapla
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)
# API isteği yap
curl -X POST "https://api.tronzap.com/v1/estimate-energy" \
-H "Authorization: Bearer ${API_TOKEN}" \
-H "X-Signature: ${SIGNATURE}" \
-H "Content-Type: application/json" \
-d "${REQUEST_BODY}"
javascript
const crypto = require('crypto');
const axios = require('axios');
const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({
from_address: 'TRX_FROM_ADDRESS',
to_address: 'TRX_TO_ADDRESS',
contract_address: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
});
// İmzayı hesapla
const signature = crypto
.createHash('sha256')
.update(requestBody + apiSecret)
.digest('hex');
// API isteği yap
axios({
method: 'post',
url: 'https://api.tronzap.com/v1/estimate-energy',
headers: {
'Authorization': `Bearer ${apiToken}`,
'X-Signature': signature,
'Content-Type': 'application/json'
},
data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));
php
<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([
'from_address' => 'TRX_FROM_ADDRESS',
'to_address' => 'TRX_TO_ADDRESS',
'contract_address' => 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
]);
// İmzayı hesapla
$signature = hash('sha256', $requestBody . $apiSecret);
// API isteği yap
$ch = curl_init('https://api.tronzap.com/v1/estimate-energy');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $apiToken,
'X-Signature: ' . $signature,
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
python
import hashlib
import json
import requests
api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({
'from_address': 'TRX_FROM_ADDRESS',
'to_address': 'TRX_TO_ADDRESS',
'contract_address': 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t'
})
# İmzayı hesapla
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()
# API isteği yap
headers = {
'Authorization': f'Bearer {api_token}',
'X-Signature': signature,
'Content-Type': 'application/json'
}
response = requests.post(
'https://api.tronzap.com/v1/estimate-energy',
headers=headers,
data=request_body
)
print(response.json())
Yanıt
Yanıt, token transferi yapmak için gereken enerji ile ilgili ayrıntılı hesaplama bilgilerini sağlar.
Yanıt Alanları
Alan | Tür | Açıklama |
---|---|---|
code | integer | Yanıt kodu (0 = başarılı) |
result | object | Yanıt verisi |
result.energy | integer | Sözleşme kullanarak transfer yapmak için gereken enerji miktarı |
result.duration | integer | Saat cinsinden süre (şu anda yalnızca 1 saat mevcut) |
result.price | float | Enerji delegasyonu fiyatı |
result.activation_fee | float | Adres etkinleştirme fiyatı (gerekirse) |
result.total | float | Gerekirse etkinleştirme dahil nihai fiyat |
result.from_address | string | İstekte sağlanan gönderenin TRON adresi |
result.to_address | string | İstekte sağlanan alıcının TRON adresi |
result.contract_address | string | Hesaplama için kullanılan akıllı sözleşme adresi |
Örnek Yanıt
json
{
"code": 0,
"result": {
"energy": 64400,
"duration": 1,
"price": 3.66,
"activation_fee": 0,
"total": 3.66,
"from_address": "TRX_FROM_ADDRESS",
"to_address": "TRX_TO_ADDRESS",
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}
}
Örnek Yanıt (Adres etkinleştirilmemiş)
json
{
"code": 0,
"result": {
"energy": 64400,
"duration": 1,
"price": 3.66,
"activation_fee": 1.4,
"total": 5.06,
"from_address": "TRX_FROM_ADDRESS",
"to_address": "TRX_TO_ADDRESS",
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}
}
Olası Hatalar
Hata Kodu | Açıklama |
---|---|
1 | Kimlik doğrulama hatası (yanlış token veya imza) |
2 | Geçersiz hizmet veya parametreler |
10 | Geçersiz gönderen adresi |
10 | Geçersiz alıcı adresi |
10 | Geçersiz sözleşme adresi |
500 | Dahili sunucu hatası |
Notlar
- contract_address parametresi isteğe bağlıdır ve varsayılan olarak TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t (Tether USDT) değerini alır
- Bu uç nokta yalnızca işlem oluşturmadan USDT transferi yapmak için enerjiyi tahmin eder
- Gerçek bir enerji satın alma işlemi oluşturmak için İşlem Oluştur uç noktasını kullanın