Ana içeriğe geç

Ağları Listele

Platformun ağ kataloğunun bir sayfasını EVM zincir id'sine (network_id) göre artan sırada döndürür. Her satır ağın kimliğini, ait olduğu zinciri ve yerel para biriminin görüntüleme alanlarını taşır. Listeyi chain_id ile tek bir zincire daraltın; zincir kapsamlı bir ağ seçicisinin ihtiyaç duyduğu liste budur.

Gerekli izin: node:summary:view

network_id kullanımı​

Bu katalogdaki bir ağın id'si, her istek gövdesinin network_id olarak gönderdiği değerdir. 24 karakterlik bir hex id'dir, EVM zincir id'si değildir: Polygon bir istekte "6740e0a20000000000000102" olarak gönderilir; 137 yalnızca buradaki network_id alanıdır.

  • Ağı her zaman çağıran seçer. Zincir üzerinde imza atan her işlem, çalışacağı ağı ve imzalayan cüzdanı istekten alır: düğüm kurulumu deploy etmek (POST /v2/admin/nodes/{node_id}/setups), ödeme token'ı oluşturmak (POST /v2/admin/currency-tokens), KYC token'ı oluşturmak (POST /v2/admin/kyc-tokens), düğüm ya da kullanıcı çekimi (POST /v2/admin/nodes/{node_id}/withdraw, POST /v2/users/{user_id}/withdraw) hem network_id hem wallet_id ister.
  • Ağ hiçbir zaman sunucu tarafında türetilmez. API ağı düğümden almaz ve düğümün zincirde tek bir cüzdanı olsa bile sizin yerinize cüzdan seçmez. Eksik network_id ya da wallet_id 10015 ile reddedilir; ağın zincirinde olmayan bir cüzdan da reddedilir.
  • Ağını zaten belirten bir kayıt onu korur. Token bir kurulum, yani bir (cüzdan, ağ) çifti üzerinde oluşturulur: POST /v2/admin/tokens, setup_id ile birlikte kurulumun ağıyla eşleşmesi gereken bir network_id alır. Token'ın sonraki zincir üstü işlemleri bu ağda çalışır; token üzerindeki kullanıcı işlemleri (alım, satış, yakma, talep) yine kullanıcının imzalayan cüzdanını wallet_id ile belirtir.
  • Cüzdanlar bir ağa değil, bir zincire aittir. Tek bir cüzdan zincirinin her ağında imza atar. Düğüm cüzdanı oluşturmak (POST /v2/admin/nodes/{node_id}/wallets) ağ yerine zincir seçilen tek yerdir: cüzdan zincirin default_network_id ağında oluşturulur (bkz. Zincirleri Listele).

Birkaç okuma uç noktası network_id adı altında sayısal EVM zincir id'sini kullanır: Gas Ücretini Getir onu query parametresi olarak alır, dağıtım token'ı okumaları da onu döndürür. Bu sayfalar bunu ayrıca belirtir.

İstek​

GET /v2/networks

Parametreler​

AdTipKonumAçıklama
pageintegerqueryZorunlu. Sayfa numarası, 1'den başlar
per_pageintegerqueryZorunlu. Sayfa başına öğe, 1–100
chain_idstringqueryYalnızca bu zincirin ağları (Zincirleri Listele uç noktasındaki zincir id'si, 24 karakterlik hex)
namestringqueryAğ adında büyük/küçük harf duyarsız "içerir" araması

Başlıklar​

AdAçıklama
AuthorizationZorunlu. Bearer <access_token>

Örnek​

curl --request GET \
--url '{{baseUrl}}/v2/networks?page=1&per_page=25&chain_id=6740e0a10000000000000101' \
--header 'Authorization: Bearer <access_token>'

Yanıt​

{
"data": [
{
"id": "6740e0a20000000000000101",
"chain_id": "6740e0a10000000000000101",
"network_id": 1,
"name": "Ethereum",
"slug": "ethereum",
"logo_url": "https://s3.tokenizationtr.com/networks/ethereum-mainnet.png",
"native_currency_symbol": "ETH",
"native_currency_logo_url": "https://s3.tokenizationtr.com/currencies/eth.svg",
"native_currency_decimals": 18
},
{
"id": "6740e0a20000000000000102",
"chain_id": "6740e0a10000000000000101",
"network_id": 137,
"name": "Polygon",
"slug": "polygon",
"logo_url": "https://s3.tokenizationtr.com/networks/polygon-mainnet.png",
"native_currency_symbol": "POL",
"native_currency_logo_url": "https://s3.tokenizationtr.com/currencies/pol.svg",
"native_currency_decimals": 18
}
],
"total": 2,
"page": 1,
"per_page": 25
}

Yanıt Alanları​

AlanTipAçıklama
dataarrayBu sayfadaki ağlar
data[].idstringAğ id'si. İstek gövdelerinin network_id olarak gönderdiği değer budur
data[].chain_idstringAğın ait olduğu zincirin id'si
data[].network_idintegerEVM zincir id'si (örn. 1 Ethereum, 137 Polygon)
data[].namestringGörünen ad
data[].slugstringMakine adı (örn. polygon)
data[].logo_urlstringAğ logosu URL'si
data[].native_currency_symbolstringGas ücretini ödeyen yerel para biriminin sembolü (örn. ETH, POL)
data[].native_currency_logo_urlstringYerel para birimi logosu URL'si
data[].native_currency_decimalsintegerYerel para biriminin ondalık basamak sayısı
totalintegerFiltrelere uyan ağ sayısı
pageintegerİstekteki sayfa numarası
per_pageintegerİstekteki sayfa boyutu

Hatalar​

DurumKodAçıklama
40010015page ya da per_page eksik veya aralık dışında — details alanına bakın
40010016chain_id geçerli bir 24 karakterlik hex id değil
50010000Beklenmeyen sunucu hatası

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.