Sorular ve yanıtlar
Entegrasyonu yapanların ilk siparişten önce sorduğu şeyler — gruplanmış ve kısa. Yanıtın bizim alışkanlığımıza değil sözleşmeye ait olduğu yerlerde, aynı şeyi API belgeleri ayrıntısıyla söylüyor.
Enerji ve fiyat
TRON enerjisi nedir?
Akıllı sözleşme çalıştırmanın bedelini ödeyen bir ağ kaynağı. Gönderen cüzdanda yeterli enerji varsa bir USDT transferi neredeyse hiç TRX yakmaz.
Neden yakmaktan ucuz?
Yakmak enerjiyi protokol oranıyla fiyatlar, birim başına ~100 sun — ağın zaman zaman değiştirdiği bir zincir parametresi; bu yıl düşürüldü. Biz devredilen enerjiyi toplu alır ve bu oranın küçük bir kısmına satarız; şu anda geçerli olan fiyat fiyatlar sayfasındadır.
Bütün fiyatları görün →
Gönderim penceresini kaçırırsam ne olur?
mode A'da tahsilat yerinde kalır: enerji teslim edilmiştir ve ödediğiniz şey teslimattır. mode B'de pencere kapandıktan sonra hiçbir şey yayınlamayız; kalem başarısız olur ve rezerv olduğu gibi geri döner. Pencere her siparişle birlikte gelir — akışınızı ona göre kurun.
Tek bir cüzdan için toplu enerji satın alabilir miyim?
Bir cüzdan için tek siparişte 65,000 ile 50,000,000 enerji birimi arasında, birim fiyatı siparişin oluşturulduğu anda geçerli olan tarifeden. Cüzdan başına tek bir pozisyon, ve piyasanın hacmin ne kadarını şu anda karşılayabileceği, hiçbir şey rezerve edilmeden önce POST /v1/estimate ile ücretsiz sorulabilir.
131,000 birimin üzerinde kiralama süresi en az bir saattir. Siparişin hep ya da hiç olup olmadığı ilk satın almadan önce belirlenir (allow_partial); ilk satın almadan sonraki eksik yine teslim edilir ve teslim edilen kadarı faturalandırılır.
Fiyatlandırma sayfasında toplu enerji →
Gönderim penceresini kaçırmak iki modda da aynı mı tutuyor?
Hayır. mode A'da enerji teslim edilmiştir, tahsilat yerinde kalır — mode C'de de öyle: beklenecek bir transfer yoktur, kalem pencere kapanınca yalnızca süresi dolarak biter. mode B'de pencere kapandıktan sonra hiç yayınlamayız: geç çıkan bir transfer, devredilen enerjinin çoktan geri alındığı bir cüzdana denk gelir ve TRX'inizi yakar. Kalem, broadcast_window_missed ile failed olarak kapanır, rezerv olduğu gibi geri döner, onun için aldığımız enerji de bizim zararımızdır.
Para ve iadeler
Ödemeyi nasıl yaparım?
TRX cinsinden ön ödemeli servis bakiyesi: kişisel adresinize TRX gönderirsiniz, hizmetlere harcarsınız. Fiyatlar sipariş oluşturulurken sabitlenir.
Yatırma adresime hangi jetonu gönderebilirim?
TRX, yalnızca TRX. Yatırma adresine gönderilen USDT kendiliğinden hesaba geçmez: kur riskini üstlenmiyoruz ve dönüştürme hizmeti işletmiyoruz, bu yüzden böyle bir transfer bir insanın bakması için ayrılır ve hesaba geçirilip geçirilmeyeceği her seferinde bizim kararımızdır. Yanlış jeton mu gönderdiniz? Bize yazın ve daha fazlasını göndermeyin.
Yatırılan tutar ne kadar sürede harcanabilir?
3 onaydan sonra — yaklaşık on saniye. Bakiye bundan sonra üç parça hâlinde bildirilir: toplam, sürmekte olan siparişler için tutulan kısım ve kullanılabilir kısım. Sipariş kullanılabilir kısımdan oluşturulur, toplamdan değil.
Siparişi iptal edebilir miyim?
Yalnızca satın alma başlamadan önce; sonrasında yanıt order_not_cancelable olur, çünkü enerji çoktan alınmıştır. İptal edilen sipariş rezervinin tamamını bırakır ve hiçbir şey tahsil etmez.
İade nasıl oluyor?
Serbest bırakmalar kendiliğinden olur ve hiçbir zaman talep açmayı gerektirmez. Kural tek: teslim etmediğimiz enerjinin parası alınmaz ve rezerv servis bakiyesi olarak hesabınıza döner — başarısız bir teslimat, satın alma başlamadan iptal edilen bir sipariş, bir Auto-refill gününün harcanmayan kısmı. Teslim edilen enerji, kullanılmış olsun olmasın, ücretlendirilir. Tek istisna: bir Auto-refill kuralı, dolumları cüzdanı için tedarikçimize önceden ödediğimiz tutarı karşılamadan silinirse, karşılanmayan kısım ücretlendirilir.
Güvenlik ve anahtarlar
Hangi anahtarlara ihtiyacınız var?
Hiçbiri. Mode A işleminizi hiç görmez. Mode B zaten imzaladığınız bir işlemi alır ve onun tek bir baytını bile değiştiremeyiz.
Çok imzalı bir gönderici kabul ediyor musunuz?
mode B'de hayır: işlemde tam olarak bir sahip imzası bulunmalı, Permission_id 0 ile. Çok imzalı bir hesabın anahtar takımı ağda yaşar ve bizim haberimiz olmadan değişir, bu yüzden yayının kabul edileceğine söz veremeyiz. mode A'da imzalamanızla ilgili hiçbir şey bize ulaşmaz — transferi siz yayınlarsınız.
Neyi, ne kadar süre saklıyorsunuz?
mode B'de imzaladığınız işlem şifreli tutulur ve sipariş nihai bir duruma ulaştıktan 7 gün sonra silinir. Siparişler, defter kayıtları ve yatırmalar kalır: bu muhasebedir ve saklamakla yükümlü olduğumuz kısım odur. Burada size ait başka hiçbir şey yok — ne özel anahtar, ne kurtarma ifadesi, ne de paranızın saklanması.
Entegrasyon
Limit var mı?
Anahtar başına dakikada 120 sipariş, toplu sipariş başına en fazla 500 transfer. Limiti aşınca sessiz bir düşüş değil, Retry-After alırsınız.
completed aslında ne demek?
Enerjinin teslim edildiği — transferinizin gittiği değil. Taahhüt teslimattır ve sipariş onunla kapanır: mode A'da completed, siz daha hiçbir şey göndermeden gelebilir. Siparişte send_before'un görünmesini kollayın, ready sözcüğünü değil: iki saniyede bir sorarken ready'yi hiç görmeyebilirsiniz.
İdempotentlik nasıl çalışır?
Idempotency-Key, birlikte geldiği gövdenin ham baytlarına bağlıdır. Aynı anahtar ve bayt bayt aynı gövde size aynı siparişi geri verir; aynı anahtar başka bir gövdeyle çakışmadır; doğrulamanın geri çevirdiği bir istek anahtarı harcamaz, dolayısıyla gövde düzeltilince aynı anahtarla yinelenebilir. Gövdeyi bir kez serileştirin ve tam olarak o baytları yeniden gönderin — anahtarların başka bir sırası ya da fazladan bir boşluk zaten başka bir gövdedir.
Hiçbir şey ödemeden bir adresi kontrol edebilir miyim?
Evet, üstelik ücretsiz. GET /v1/address-check bir cüzdan hakkında bildiklerimizi anlatır, POST /v1/estimate ise 500 alıcıya kadar, bir siparişin uygulayacağı kurallarla fiyat çıkarır — hangilerinin jeton sözleşmesince kara listeye alındığı dâhil. İkisi de ne bir şey ayırır ne de bir şey tahsil eder.
Hesabınız
Bir cüzdan kendi kendine dolu kalabilir mi?
Evet — bir Auto-refill kuralı: bir adres artı bir günlük bütçe. Enerji her transferden sonra yeniden dolar; bütçe sert bir günlük tavandır.
balance.low kaça ayarlanmalı?
Sayı sizin ayarınız — PATCH /v1/settings içindeki balance_low_threshold_trx; balance.low ise ona göre düşen olay. İşe yarar ölçü aşağı yukarı bir günlük cironuzdur: o zaman uyarı, siparişler insufficient_balance almaya başlamadan bir gün önce gelir; ilk reddin yerine geçmez. Belirgin biçimde düşük olursa olay olup bittikten sonraki bir bildirime, belirgin biçimde yüksek olursa gürültüye dönüşür. Sıfır onu kapatır.
Operasyon ekibim yalnızca okuma erişimine sahip olabilir mi?
Evet. Bir hesap davet ettiğiniz kadar kişiyi barındırır, her biri dört rolden biriyle — viewer, member, admin, owner — ve her rol kendinden öncekinin yapabildiği her şeyi yapar. viewer bakiyeyi, defteri, siparişleri ve tarifeyi okur ve hiçbir şey harcayamaz; member sipariş ve tahmin oluşturur; admin API anahtarlarını, webhooks'u, ayarları ve ekibi yönetir; owner hesabın kendisidir. Bir davet viewer, member veya admin rolü verir; owner hesabın kendisidir ve davet edilmez. Davetler ve roller panelde yaşar ve yalnızca paneli yönetir: bir API anahtarı bir kişiye değil hesaba aittir ve kim oluşturmuş olursa olsun tam erişim taşır.
Test ortamı (sandbox) ya da asgari hacim var mı?
Ne asgari hacim, ne abonelik, ne de boş durma ücreti. Test ortamı (sandbox) var: https://sandbox.nrg.market/v1 aynı API'nin test parası ve benzetilmiş bir ağ üzerindeki hâli, ona ait nrg_test_… anahtarlarını da sandbox-app.nrg.market veriyor. Entegrasyonun sizin tarafınızı kanıtlar — istek biçimleri, durumlar, webhooks, süreler — ama enerjinin on-chain ulaştığını kanıtlamaz; o ancak canlıda öğrenilir. Canlı sunucuda referans uç noktaları, bir tahmin ve bir webhook denemesi yine hiçbir şeye mal olmaz.
https://sandbox.nrg.market/v1
sandbox-app.nrg.market