Ücretlere Genel Bakış

Ücret (fee), bir tarafın platformdaki işlemlerden aldığı yüzde oranlarının kümesidir. Bu sayfa bir ücreti kimin aldığını, bir ücretin hangi kapsamlarda yazılabildiğini, bir kuruluma (setup) uygulanan oranın nasıl çözümlendiğini ve bir değişikliğin ne zaman zincire gittiğini anlatır. Bu bölümdeki endpoint sayfaları buraya bağlantı verir.

Ücreti kim alır: entity

Her ücret satırı tek bir entity'ye aittir. Üç entity birbirinden bağımsız fiyatlandırılır; bu yüzden her okuma ve yazma bunlardan birini belirtir.

entity	Ad	Bu API üzerinden kim yazar
1	Sahip (owner)	Hiç kimse. Sahip ücretleri sahip tarafında yazılır ve buraya yansıtılır; bu API üzerinden salt okunurdur (10004, domain 9).
2	Platform sahibi	Yalnızca platform sahibi düğümün kendi API anahtarı (diğer her anahtar için 10003, domain 9).
3	Düğüm (node)	Düğüm alt ağacı ilgili düğümü kapsayan bir API anahtarı.

Ücret neyi fiyatlar: dokuz ücret tipi

Bir ücretin value alanı üç grupta dokuz oran taşır. Her oran, value alanı yüzde olan bir yaprak (leaf) nesnesidir.

Grup	Yaprak anahtarları
tokenization	asset_tokenization, tokenized_asset_sales, management
secondary_market	buy_order, sell_order, otc_sale
lending	borrower, lending, liquidation

• Oran, "0" ile "100" arasında, en fazla bir ondalık basamaklı bir ondalık string'dir: "2.5" kabul edilir; "2.55" ve "100.5" 10015 ile reddedilir. Bkz. Tutarlar ve Yüzdeler.
• Her yazma işlemi value içinde dokuz yaprağın tamamını göndermelidir. Birini eksik bırakan gövde 10002 (domain 9) ile reddedilir.
• Bir yazma işlemi categories da gönderebilir: aynı dokuz oranın varlık kategorisi bazında geçersiz kılınması (override). Bir üst kategoriye verilen override, o kategorinin yaprak kategorilerine uygulanır; kendisi ayrıca listelenen bir yaprak kategori kendi değerini korur.

Ücret nerede geçerli: kapsamlar

Her ücret satırı tam olarak bir kapsamda yazılır. En özelden en genele:

Seviye	Kapsam	Anlamı
1	setup	Bir düğümün dağıtılmış (veya dağıtılacak) tek bir kurulumu
2	node + network	Tek bir düğüm, tek bir ağda
3	node	Tek bir düğüm, tüm ağlarda
4	network	Tüm düğümler, tek bir ağda
5	default	Entity genelindeki varsayılan

Kapsam satır yazılırken belirlenir ve sonradan değişmez: ID ile Ücret Güncelle, gövde ne derse desin saklanan kapsamı korur.

Geçerli (effective) ücret nasıl çözümlenir

Bir entity'nin bir kurulumdan ne aldığını bulmak için sunucu, yalnızca o entity için beş seviyeyi en özelden en genele doğru dolaşır. Her seviye yalnızca daha özel seviyelerin boş bıraktığı yaprakları doldurur; böylece bir seviyedeki kısmi bir satır, altındaki seviyelerle tamamlanır. Ekseni bilinmeyen seviye atlanır (örneğin ağ yoksa node + network ve network seviyeleri atlanır). Bir varlık kategorisi verildiğinde, satırın o kategori için override'ı satırın value alanı yerine kullanılır. Hiçbir seviyenin fiyatlamadığı yaprak boş kalır.

• Geçerli Ücreti Al bu çözümlemeyi, henüz dağıtımı olmayan kapsamlar dahil her kapsam için anlık çalıştırır. Bir değişikliği önizlemek için kullanın.
• Kurulumun Geçerli Ücretlerini Al dağıtılmış bir kurulumun ücret kontratının tuttuğu değerleri döner: son gönderimde çözümlenen değerler, her yaprağın geldiği seviye ve ücret satırı, ve bu gönderimin pending, confirmed ya da failed olduğu.

Bir kurulumun kontratları dağıtıldığında, ücretleri üç entity için çözümlenir ve bu anlık görüntü kurulumun geçerli ücretleri olarak kaydedilir.

Hangi endpoint hangi kapsamı yazar

Endpoint	entity	Yazılan kapsam	Kim çağırabilir
PUT /v2/admin/fees/platform-owner	2	default	Platform sahibi anahtarı
PUT /v2/admin/fees/nodes/{node_id}	3	node; gövdede network_id varsa node + network	Alt ağacı düğümü kapsayan anahtar
PUT /v2/admin/fees/nodes/{node_id}/platform-owner	2	node; gövdede network_id varsa node + network	Platform sahibi anahtarı
PUT /v2/admin/fees/nodes/{node_id}/setups/{setup_id}	3	setup	Alt ağacı düğümü kapsayan anahtar
PUT /v2/admin/fees/nodes/{node_id}/setups/{setup_id}/platform-owner	2	setup	Platform sahibi anahtarı
PUT /v2/admin/fees/{fee_id}	satırın kendisi	satırın kendisi	Düğüm satırları: alt ağacı düğümü kapsayan anahtar. Platform sahibi satırları: platform sahibi anahtarı. Sahip satırları: hiç kimse.

Diğer kapsamlardaki satırlar (sahibin varsayılanları, yalnızca ağ kapsamlı bir satır) burada okunabilir ama yazılamaz.

Değişiklik ne zaman zincire gider

Her yazma işlemi, satır kaydedilir kaydedilmez kaydedilen ücret satırıyla 200 döner. Zincire ulaşmak ayrı ve asenkron bir adımdır ve düğüm işlemleri (node transaction) olarak çalışır; bunları 3 (Done) veya 4 (Error) durumuna gelene kadar Get Node Transactions ile sorgulayın.

Kurulum kapsamlı yazmalar (iki PUT .../setups/{setup_id} endpoint'i) doğrudan o tek kuruluma gönderilir:

• Kurulum dağıtılmışsa ve oranlar değiştiyse (ya da bu, kurulumun ilk override'ıysa) bir düğüm işlemi başlatılır: düğüm ücreti için kurulumun düğümünde 10 (UpdateDefaultNodeFee) tipi, platform sahibi ücreti için platform sahibinin düğümünde 12 (UpdateDefaultNodeFeeByPlatformOwner) tipi.
• Kurulum henüz dağıtılmamışsa satır yalnızca kaydedilir. Dağıtım onu kullanır.
• Yalnızca categories değişikliği gönderim başlatmaz.

Bir kurulum satırı üzerinde ID ile Ücret Güncelle de, kurulum dağıtılmışsa ve oranlar ya da kategoriler değiştiyse, kurulumun düğümünde 10 tipinde tek bir düğüm işlemiyle doğrudan o kuruluma gönderir.

Düğüm ve düğüm + ağ yazmaları (PUT /fees/nodes/{node_id}, PUT /fees/nodes/{node_id}/platform-owner ve böyle bir satır üzerinde ID ile Ücret Güncelle) kendi override'ı olmayan her kurulum tarafından devralınır; bu yüzden arka planda yayılır (fan-out):

• Satırın kapsamındaki her dağıtılmış kurulum yeniden çözümlenir. Çözümlenen oranları değişen kurulum bir değer gönderimi alır ve geçerli ücretleri gönderim sonuçlanana kadar pending olarak işaretlenir.
• categories değişikliği, kapsamdaki her kurulum için bir kategori gönderimi ekler.
• Düğüm ücretleri, her kurulumun düğümünde 10 / 11 / 20 / 21 (UpdateDefaultNodeFee, UpdateCategoryNodeFee, UnsetDefaultNodeFee, UnsetCategoryNodeFee) tipleriyle çalışır. Platform sahibi ücretleri platform sahibinin düğümünde 12 / 13 / 22 / 23 (…ByPlatformOwner varyantları) tipleriyle çalışır.
• Bir değişikliğin kaç dağıtılmış kuruluma ulaşacağını görmek için önce Etkilenen Kurulum Sayısını Al çağrısını yapın.

Platform sahibinin varsayılanı (PUT /v2/admin/fees/platform-owner) kaydedilir ancak zaten dağıtılmış kurulumlara gönderilmez: yayılım, düğüm taşımayan platform sahibi satırlarını atlar. Sonradan dağıtılan kurulumlar onu dağıtım anında çözümler.

Sahip ücretleri (entity 1) bu API üzerinden hiçbir zaman yazılmaz ve gönderilmez.