मुख्य सामग्री पर जाएं

​
ऑटो रिफिल

ऑटो रिफिल किसी TRON एड्रेस पर नज़र रखता है और जब भी उसकी एनर्जी या बैंडविड्थ आपके तय किए स्तर से नीचे गिरती है, उसे टॉप-अप कर देता है। आप थ्रेशोल्ड, हर बार जोड़ी जाने वाली मात्रा और किराये की अवधि चुनते हैं। हर रिफिल एक सामान्य ऑर्डर है, जिसका भुगतान आपके बैलेंस से होता है।

​
यह कैसे काम करता है

  1. किसी एड्रेस के लिए थ्रेशोल्ड, add_volume और duration के साथ नियम बनाएं।
  2. हम जाँचते हैं कि एड्रेस पर कितनी एनर्जी (या बैंडविड्थ) उपलब्ध है — हर मिनट एक बार, और उस एड्रेस से हर आउटगोइंग USDT ट्रांसफर के तुरंत बाद।
  3. यदि स्तर थ्रेशोल्ड से नीचे है, तो हम एड्रेस के लिए add_volume खरीदते हैं और आपकी कीमत पर आपके बैलेंस से शुल्क लेते हैं।
  4. किराया अपनी अवधि पूरी होने पर समाप्त हो जाता है। जब स्तर फिर से थ्रेशोल्ड से नीचे जाता है, नियम दोबारा खरीदता है। इसी तरह नियम एड्रेस पर आपूर्ति बनाए रखता है: रिन्यूअल का कोई अलग चरण नहीं है।
यदि कोई जाँच एड्रेस को पढ़ नहीं पाती, तो वह कुछ नहीं खरीदती; नियम उसका समय last_read_error_at में दिखाता है, और अगली जाँच फिर से प्रयास करती है। नियम बनाने से उसी समय कुछ नहीं खरीदा जाता। पहला रिफिल अगली जाँच पर होता है, आमतौर पर एक मिनट के भीतर। नियम बनाने वाले अनुरोध का रिस्पॉन्स बताता है कि रिफिल होगा या नहीं (will_refill_now) और इस समय एड्रेस पर कितना है।
ऑटो रिफिल स्तर गिरने के बाद प्रतिक्रिया करता है; यह ट्रांसफर से पहले ही पहुँचकर उसका इंतज़ार नहीं करता। थ्रेशोल्ड कम से कम उतना रखें जितना आपके अगले ट्रांज़ैक्शन को चाहिए, ताकि ट्रांज़ैक्शन भेजे जाते समय वह पहले से कवर हो।

​
एनर्जी और बैंडविड्थ

दोनों संसाधनों के अपने अलग एंडपॉइंट और अपने अलग नियम हैं। एक एड्रेस पर एक ही समय में एनर्जी नियम और बैंडविड्थ नियम दोनों हो सकते हैं; हर नियम की जाँच उसके अपने थ्रेशोल्ड से होती है। एनर्जी एक घंटे के लिए किराये पर ली जाती है। जब वह खत्म हो जाती है या उसकी अवधि पूरी होती है, स्तर गिरता है और नियम अगला घंटा खरीदता है। बैंडविड्थ में वह सब गिना जाता है जिससे एड्रेस किसी ट्रांज़ैक्शन का भुगतान कर सकता है: हर अकाउंट को रोज़ मिलने वाली मुफ़्त 600 बैंडविड्थ, साथ ही कोई भी स्टेक की गई या डेलिगेट की गई बैंडविड्थ। इसलिए 600 या उससे कम का थ्रेशोल्ड, जब तक एड्रेस मुफ़्त कोटा खर्च नहीं कर देता, अकेले उसी से पूरा हो जाता है।

​
संख्याएँ कैसे चुनें

add_volume को थ्रेशोल्ड के बराबर या उससे ऊपर रखें। रिफिल एड्रेस पर बची हुई मात्रा में add_volume जोड़ता है। यदि add_volume थ्रेशोल्ड से छोटा है, तो लगभग खाली एड्रेस पर एक रिफिल के बाद भी स्तर थ्रेशोल्ड से नीचे रह सकता है, और नियम हर खर्च के बाद फिर खरीदेगा — घंटे में एक बार नहीं, बल्कि मिनट में कई बार तक। इनमें से हर रिफिल अपने फिक्स्ड शुल्क के साथ एक पूरा ऑर्डर है। नियम के रिस्पॉन्स इस स्थिति को volume_below_threshold: true से चिह्नित करते हैं।
एक USDT ट्रांसफर में लगभग 65,000 एनर्जी लगती है जब प्राप्तकर्ता के पास पहले से USDT हो, और लगभग 131,000 जब न हो, साथ ही करीब 345 बैंडविड्थ। उदाहरण के लिए, threshold_energy: 65000 के साथ add_volume: 131000 दो ट्रांसफर जितनी एनर्जी तब खरीदता है जब एक ट्रांसफर से कम बची हो।

​
लागत

हर रिफिल एक सामान्य ऑर्डर है: आपकी दर पर किराया और साथ में फिक्स्ड शुल्क, जो हर रिफिल पर लिया जाता है। सूची और नियम बनाने के रिस्पॉन्स में estimated_cost_per_refill_trx आपके खाते के लिए एक रिफिल की पूरी कीमत है, फिक्स्ड शुल्क सहित। नियम बनाने से पहले यह कीमत देखने के लिए मूल्य अनुमान एंडपॉइंट का उपयोग करें: एनर्जी, बैंडविड्थ। बार-बार रिफिल होने वाला छोटा add_volume फिक्स्ड शुल्क कई बार चुकाता है; बड़ा वाला उसे कम बार चुकाता है। API कुंजी से बनाए गए नियम की कीमत उस API कुंजी से की गई खरीद जैसी होती है; वेबसाइट पर बनाए गए नियम की कीमत वेबसाइट पर की गई खरीद जैसी। estimated_cost_per_refill_trx में यह पहले से शामिल है। यदि एड्रेस अभी ऑन-चेन मौजूद नहीं है, तो पहला रिफिल उसे सक्रिय भी करता है, बिल्कुल सामान्य खरीद की तरह। सक्रियण का शुल्क अलग से जुड़ता है और estimated_cost_per_refill_trx का हिस्सा नहीं है; ऑर्डर इसे activation_cost_trx में दिखाता है। खर्च की कोई दैनिक सीमा नहीं है: जब तक स्तर थ्रेशोल्ड से नीचे है और आपका बैलेंस एक रिफिल को कवर करता है, नियम खरीदता रहता है।

​
ऑर्डर और वेबहुक

हर रिफिल आपके ऑर्डर इतिहास (ऑर्डर सूची) में source: "autorefill" के साथ दिखता है। केवल रिफिल ऑर्डर की सूची पाने के लिए GET /orders?source=autorefill कॉल करें; उन्हें फ़ाइल के रूप में एक्सपोर्ट करने के लिए autorefill रिपोर्ट का उपयोग करें। API कुंजी से बनाए गए नियम अपने रिफिल ऑर्डर के लिए order.updated वेबहुक भेजते हैं, ठीक वैसे ही जैसे API से दिए गए ऑर्डर के लिए। API कुंजी के बिना बनाए गए नियम ये नहीं भेजते।

​
नियम की स्थिति

विफलताओं के बाद रोका गया। विफल रिफिल का रिफंड किसी भी विफल ऑर्डर की तरह होता है। लगातार 5 विफल रिफिल के बाद नियम रोक दिया जाता है और stopped_reason आखिरी विफलता का कारण बताता है। consecutive_failures दिखाता है कि नियम उस सीमा के कितना करीब है; सफल रिफिल के बाद और जब आप नियम फिर से शुरू करते हैं, यह वापस 0 हो जाता है। रोका गया नियम कभी अपने-आप फिर से शुरू नहीं होता: कारण ठीक करें, फिर status: "active" सेट करें। बैलेंस के कारण रुका। जब आपका बैलेंस एक रिफिल को कवर नहीं कर पाता, नियम stopped_insufficient_balance के साथ रुक जाता है। जैसे ही कोई डिपॉज़िट बैलेंस को एक रिफिल की कीमत तक ले आता है, नियम अपने-आप active में लौट आता है। आप खुद भी status: "active" सेट कर सकते हैं; यदि बैलेंस तब भी कम है, तो नियम अगली जाँच पर फिर रुक जाता है। यदि आपका Telegram अकाउंट लिंक है, तो आपको किसी नियम के पहले रिफिल पर संदेश मिलता है, और तब भी जब नियम रोका जाता है, बैलेंस के कारण रुकता है या फिर से शुरू होता है।

​
सीमाएं

  • खाते पर प्रति एड्रेस और संसाधन एक नियम। उसी एड्रेस के लिए दूसरा एनर्जी नियम (या दूसरा बैंडविड्थ नियम) बनाने पर 409 AUTOREFILL_ADDRESS_TAKEN मिलता है — इसके बजाय मौजूदा नियम बदलें।
  • प्रति खाता 20 एनर्जी नियम और 20 बैंडविड्थ नियम। हटाए गए नियम नहीं गिने जाते। सीमा से ऊपर: 409 AUTOREFILL_LIMIT_REACHED।
  • कॉन्ट्रैक्ट एड्रेस नहीं, जैसे USDT टोकन कॉन्ट्रैक्ट: TRON उन्हें संसाधन डेलिगेट करने की अनुमति नहीं देता।
  • नियम बनाना हर संसाधन के लिए प्रति खाता 10 अनुरोध प्रति मिनट तक सीमित है। देखें रेट लिमिट।

​
बदलना और हटाना

बदलाव अगली जाँच से लागू होते हैं। जब नियम के लिए रिफिल खरीदा जा रहा हो, तब PATCH और DELETE 409 AUTOREFILL_IN_PROGRESS लौटाते हैं — एक मिनट में फिर प्रयास करें। नियम हटाने से पहले से खरीदी गई एनर्जी या बैंडविड्थ वापस नहीं ली जाती; वे किराये अपनी अवधि के अंत तक चलते हैं।

​
Smart Mode और ऑटो-रिन्यू रेंटल से तुलना

​
एंडपॉइंट