როგორ შევამციროთ USDT გადარიცხვის საკომისიო API საშუალებით: ეტაპობრივი ინსტრუქცია TronNRG API გამოყენებით
მოკლე ვერსია: სტანდარტული USDT TRC-20 გადარიცხვა მოიხმარს 65,000 Energy . თუ თქვენს საფულეს Energy არ აქვს, Tron თქვენი ბალანსიდან დაახლოებით 13 TRX ხარჯავს მის დასაფარად. TronNRG API ით თქვენ იგივე Energy 4 TRX ზე დელეგირებთ — დაახლოებით 70%-იან შემცირებას ყოველ გაგზავნაზე. ინტეგრაცია სამი HTTP ოპერაციაა: TRX გაგზავნა გაგზავნის მისამართზე, საკუთრების შეტყობინების ხელმოწერა და POST-ით გაგზავნა /delegate საბოლოო წერტილზე. ეს სახელმძღვანელო განმარტავს თითოეულ ნაბიჯს კოდით და ოთხი ყველაზე გავრცელებული შეცდომით, რომლებსაც შეიძლება წააწყდეთ წარმოების პროცესში.
დაწყებამდე
პირველი API ზარის დაწყებამდე სამი რამ გჭირდებათ:
Tron საფულე TRX ით. მინიმუმ 4 TRX ერთი დელეგაციის გადასახდელად. წარმოებაში, მეტი - თქვენ გადაიხდით თითო გადარიცხვაზე და ცხელი საფულის პერიოდულად შევსება უფრო მარტივია, ვიდრე მისი მიკროდაფინანსება თითო გაგზავნაზე.
Tron შეტყობინებების ხელმოწერის გზა. TronWeb წარმოგიდგენთ tronWeb.trx.signMessageV2() . Python იყენებს tron.trx.sign_message_v2() ფუნქციას tronpy-ის საშუალებით. PHP იყენებს iexbase/tron-api ბიბლიოთეკას. TronNRG API მითითებას აქვს ოთხივე ენაზე მომუშავე მაგალითები.
მიმღები საფულის მისამართი. წინასწარ გადაწყვიტეთ, თავად გადამხდელ საფულეს აძლევთ უფლებამოსილებას (უმარტივესი შემთხვევა) თუ თქვენს მიერ კონტროლირებად სხვა საფულეს (სახაზინო სისტემის დაყენება). ორივე მუშაობს. ხელმოწერა ორივეს ერთმანეთთან აკავშირებს.
თქვენი არსებული USDT გაგზავნის ფუნქციის გარშემო არსებული შეფუთვა. შეფუთვა ასრულებს სამ HTTP ოპერაციას (გადახდა, ხელმოწერა, მოთხოვნა), ელოდება Energy მიწოდებას და შემდეგ იძახებს თქვენს არსებულ USDT გადარიცხვის ლოგიკას. ეს არის მთელი ინტეგრაცია. ქვემოთ მოცემული ყველაფერი თითოეული ნაბიჯის დეტალურ აღწერას წარმოადგენს.
ნაბიჯი 1: გაგზავნეთ TRX გაგზავნის მისამართზე
გაგზავნეთ TRX იმ საფულიდან, რომლის Energy იხდით, TronNRG გაგზავნის მისამართზე. მინიმალური რაოდენობაა 4 TRX (რაც 65,000 Energy ყიდულობს, რაც საკმარისია ერთი სტანდარტული USDT გადარიცხვისთვის). თითო დელეგირებაზე მაქსიმალური რაოდენობაა 1,000 TRX (16.25 მილიონი Energy ). ფასები წრფივია, შუალედში 16,250 Energy თითო TRX ზე.
TronWeb ში:
const DISPATCH = 'TFqUiCu1JwLHHnBNeaaVKH7Csm4aA3YhZx';
const payment = await tronWeb.trx.sendTransaction(DISPATCH, 4 * 1e6);
// payment.txid is what you will sign in Step 2
გავრცელებული შეცდომა: TRX გაგზავნა SUN-დენომინირებული მთელი რიცხვებით, მაგრამ კონვერტაციის დავიწყება. TRX აქვს 6 ათწილადი. 4 TRX არის 4_000_000 SUN ( 4 * 1e6 ). არასწორი გაკეთების შემთხვევაში ან მტვერი გამოვა (დელეგირება ძალიან მცირე იქნება) ან ასობით TRX (დელეგირება წარმატებული იქნება, მაგრამ თქვენ საჭიროზე გაცილებით მეტს გადაიხდით). ყოველთვის გააორმაგეთ თანხა sendTransaction ზე გადასვლამდე.
ნაბიჯი 2: ავტორიზაციის შეტყობინების ხელმოწერა
API სჭირდება მტკიცებულება, რომ დელეგირების მოთხოვნის მქონე პირი იგივე პირია, ვინც გადაიხადა. თქვენ ამას ადასტურებთ გადამხდელი საფულის პირადი გასაღებით შეტყობინების ხელმოწერით. შეტყობინების ფორმატია:
{payment_tx_hash}:{delegate_to_address}
სადაც payment_tx_hash არის პირველ ეტაპზე დაბრუნებული txid, ხოლო delegate_to_address არის Tron მისამართი, რომელზეც გსურთ Energy დელეგირება. TronWeb ში:
const message = `${payment.txid}:${delegateTo}`;
const signature = await tronWeb.trx.signMessageV2(message);
რატომ არის ეს დიზაინი ასეთი: ის გამორიცხავს API გასაღებების საჭიროებას და ამავდროულად უზრუნველყოფს დელეგირების უსაფრთხოებას. ვერავინ შეძლებს თქვენი გადახდის მოთხოვნას, რადგან მხოლოდ თქვენ გაქვთ კერძო გასაღები. ასევე შეგიძლიათ გადაიხადოთ A საფულიდან და დელეგირება მოახდინოთ B საფულეზე, თუ თქვენ აკონტროლებთ A-ს — სასარგებლოა ხაზინებისთვის, რომლებიც აფინანსებენ Energy ერთი გადამხდელისგან მრავალი გაგზავნის საფულისთვის.
გავრცელებული შეცდომა: ხელმოწერის არასწორი მეთოდის გამოყენება. Tron აქვს შეტყობინების ხელმოწერის ორი სტანდარტი — signMessage (legacy) და signMessageV2 (EIP-191 თავსებადი). API ელის V2-ს. მემკვიდრეობითი მეთოდის გამოყენება გამოიწვევს ვალიდური იერის მქონე ხელმოწერის გენერირებას, რომელსაც API უარყოფს ხელმოწერის შეუსაბამობის გამო.
ნაბიჯი 3: მოითხოვეთ თქვენი დელეგაცია
გადახდის ჰეში, სამიზნე საფულე და ხელმოწერა გააგზავნეთ api.tronnrg.com/delegate ზე JSON სახით.
const res = await fetch('https://api.tronnrg.com/delegate', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
tx_hash: payment.txid,
delegate_to: delegateTo,
signature
})
}).then(r => r.json());
API აბრუნებს სამ ველს, რომლებსაც გამოიყენებთ: res.energy (დელეგირებული Energy რაოდენობა, ტოლია TRX გაგზავნის 16,250-ის გამრავლებისა), res.delegations[0].tx (ჯაჭვში დელეგირების ტრანზაქციის ჰეში — შეინახეთ ეს თქვენი აუდიტის ჟურნალისთვის) და res.ref (საცნობარო ID, როგორიცაა nrg_d_42 რომელიც სასარგებლოა დახმარების მოთხოვნებისთვის).
დელეგაცია ჯაჭვზე წარმატებული მოთხოვნიდან დაახლოებით 3 წამში ჯდება. ამ მომენტიდან ის 15 წუთის განმავლობაში რჩება. 15 წუთის შემდეგ, გამოუყენებელი Energy ავტომატურად ბრუნდება TronNRG აუზში — ნაწილობრივი თანხის დაბრუნება არ ხდება.
ნაბიჯი 4: თქვენი USDT გადარიცხვის გადაცემა
USDT გადარიცხვის გადაცემამდე დაადასტურეთ, რომ Energy რეალურად ჩამოვიდა. სამიზნე საფულეზე გამოიყენეთ tronWeb.trx.getAccountResources() ფუნქცია მანამ, სანამ EnergyLimit - EnergyUsed არ გახდება მინიმუმ 65,000. სტანდარტულია 500 მილიწამიანი ინტერვალი 30 წამიანი ტაიმაუტით.
შემდეგ, როგორც წესი, გაგზავნეთ USDT . საკომისიოს ფარავს Energy . გამგზავნი საფულედან TRX არ იხარჯება.
// Wait for Energy to arrive
await pollUntilEnergyAvailable(delegateTo, 65000, { interval: 500, timeout: 30000 });
// Broadcast the USDT transfer
const contract = await tronWeb.contract().at( USDT _CONTRACT);
const txHash = await contract.transfer(recipient, amount).send({ feeLimit: 20_000_000 });
ყოველთვის დააყენეთ feeLimit. თუ Energy რატომღაც არ მოვა და თქვენი კოდი მაინც გადაიცემა, feeLimit ზღუდავს ქსელის მიერ დახარჯული TRX მაქსიმალურ რაოდენობას. 20 TRX (გამოხატული როგორც 20,000,000 SUN) არის გონივრული ზღვარი - საკმარისია ერთი გადარიცხვის დასაფარად, თუ Energy ვერ მოხერხდება, შეზღუდულია ისე, რომ შეცდომამ ვერ დაცალა ცხელი საფულე.
რას გიშველის ეს სინამდვილეში
თითო გადარიცხვაზე დაზოგილი თანხა ფიქსირებულია TRX თვალსაზრისით: დაახლოებით 9 TRX დაზოგილია ყოველ სტანდარტულ USDT გაგზავნაზე (აცილებულია 13 TRX დაწვა, მინუს 4 TRX გადახდილია Energy ). ეს რიცხვი არ იცვლება ბაზრის პირობების მიხედვით - ეს Tron ქსელის პროტოკოლის დონის თვისებაა. იცვლება ის, თუ რამდენ დოლარს წარმოადგენს ეს 9 TRX .
რეალური ბიზნესის მოცულობის შემთხვევაში, დანაზოგი სწრაფად იზრდება:
| ყოველდღიური გადარიცხვები | ყოველწლიური TRX Burn ( API გარეშე) | ყოველწლიური TRX API მეშვეობით | წელიწადში დაზოგილი TRX | შემცირება |
|---|---|---|---|---|
| 10 | ~47,450 | 14,600 | ~32,850 | ~69% |
| 100 | ~474,500 | 146,000 | ~328,500 | ~69% |
| 500 | ~2.37 მილიონი | 730,000 | ~1.64 მილიონი | ~69% |
| 1,000 | ~4.75 მილიონი | 1.46 მილიონი | ~3.29 მილიონი | ~69% |
| 5,000 | ~23.7 მილიონი | 7.30 მილიონი | ~16.4 მილიონი | ~69% |
TRX რეალურ ფასად აშშ დოლარის მიმდინარე მაჩვენებლების სანახავად გამოიყენეთ TronNRG საკომისიოს კალკულატორი — შეიყვანეთ თქვენი ყოველდღიური მოცულობა და ის რეალურ დროში დაგიბრუნებთ დოლარის დაზოგვის მონაცემებს.
თუ დღეში 500-ზე მეტ გადარიცხვას ახორციელებთ, ასევე ღირს მისი შედარება თვითდაფუძნებულ TRX , რათა საკუთარი Energy გამოიმუშაოთ. თვითდაფუძნებულ გადარიცხვას თითქმის ნულოვანი ღირებულება აქვს, მაგრამ მნიშვნელოვან კაპიტალის დაგროვებას მოითხოვს. დაფუძნებული შემოსავლის კალკულატორი გიჩვენებთ, თუ სად იკვეთება API და თვითდაფუძნებული ხაზები თქვენი კონკრეტული მოცულობისთვის.
პრობლემების მოგვარება
ოთხი შეცდომა იმდენად ხშირად გვხვდება, რომ წინასწარ მათი ცოდნა ღირებულია:
ხელმოწერის შეუსაბამობა (ყველაზე გავრცელებული). API ხელს აწერს V2-ით, მაგრამ თქვენ ხელმოწერა მოძველებული signMessage მეთოდით განახორციელეთ. გამოსწორება: გადადით signMessageV2 ზე. შეცდომის კოდების სრული სია მოცემულია TronNRG შეცდომის დოკუმენტაციაში .
გადახდა ვერ მოიძებნა. თქვენ გამოიძახეთ /delegate გადახდის ტრანზაქციის ჯაჭვზე დადასტურებამდე. გამოსწორება: ნაბიჯი 3-ის გამოძახებამდე დაელოდეთ მინიმუმ ერთ ბლოკს (დაახლოებით 3 წამი) პირველი ნაბიჯის შემდეგ. კოდში გამოკითხეთ tronWeb.trx.getTransaction(payment.txid) მანამ, სანამ ის შედეგს არ დააბრუნებს.
გადახდა მინიმუმზე ნაკლებია. თქვენ გაგზავნეთ 4 TRX ზე ნაკლები. გაგზავნა 4 TRX ზე ნაკლებ თანხას არასწორად მიიჩნევს და თანხა ავტომატურად ბრუნდება. გამოსწორება: გაგზავნამდე შეამოწმეთ თანხა - მინიმალური თანხა ფიქსირებულია.
Energy არ მოვიდა. დელეგირება წარმატებით განხორციელდა API მხარეს, მაგრამ სამიზნე საფულე კვლავ არ აჩვენებს Energy . გამოსწორება: დაელოდეთ კიდევ ერთ ბლოკს და ხელახლა შეამოწმეთ - გავრცელებას ზოგჯერ შეიძლება 3 წამის ნაცვლად 6 წამი დასჭირდეს. თუ Energy 30 წამის შემდეგაც არ გამოჩნდება, შეამოწმეთ, ემთხვევა თუ არა თქვენს მიერ მოწოდებული სამიზნე საფულის მისამართი თქვენს მიერ მოძიებულს (აქ, როგორც წესი, შეცდომაა მიზეზი).
წაიკითხეთ სრული დოკუმენტაცია →
საწარმო მოცულობებისთვის: დაუკავშირდით TronNRG Telegram-ზე webhook-ის დადასტურების, საბითუმო ფასების და მორგებული SLA-ებისთვის.
დაკავშირებული სახელმძღვანელოები: Tron Energy API დეველოპერებისთვის · USDT გადარიცხვების ავტომატიზაცია მასშტაბურად · USDT გაგზავნა 1 დოლარზე ნაკლები ღირებულების
სამი API ზარი. 70%-იანი ფასდაკლება USDT ყველა გადარიცხვაზე.
TronNRG ხელმისაწვდომია api.tronnrg.com-ზე. მინიმუმ 4 TRX , წრფივი ფასწარმოქმნა 1000 TRX მდე. 3 წამიანი დელეგირება. ხელმოწერაზე დაფუძნებული ავტორიზაცია, API გასაღები არ არის საჭირო. სრული დოკუმენტაცია ყველა მხარდაჭერილ ენაზე support.tronnrg.com-ზე.
ენერგიის გაქირავება →