Gas Sponsor Cüzdanlarını Listele
Her ağ için kullanıcıların gas ücretini karşılayan platform cüzdanını listeler. Bir kullanıcının cüzdanında, imzalaması gereken bir işlemin ücretini ödeyecek kadar ağın yerel para birimi yoksa platform o ağın sponsor cüzdanından bu cüzdana yerel para birimi gönderir ve ardından işlemi çalıştırır. Sponsor cüzdan tek kaynaktır: sponsoru tanımlı olmayan bir ağda gas gönderilemez ve onu bekleyen işlem başarısız olur. Yerine başka bir cüzdan seçilmez.
Liste, platform düğümünün cüzdan tuttuğu her zincirin her ağı için bir satır içerir; önce zincir adına, sonra ağ adına göre sıralanır. Platformun cüzdan tutmadığı zincirlerdeki ağlar listelenmez: hiçbir cüzdan onlara sponsor olamaz. wallet_id ve address alanları boş olan satır, sponsoru tanımlı olmayan bir ağdır.
Gas sponsorluğu platform genelinde bir ayardır: yalnızca platform düğümünün (düğüm hiyerarşisinin kökü) API istemcisi çağırabilir. Diğer istemciler 10005 ile reddedilir. Sponsoru Gas Sponsor Cüzdanını Ayarla ile atayın ya da kaldırın.
Gerekli izin: node:summary:view
İstek
GET /v2/gas-sponsor-wallets
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
page | integer | query | Zorunlu. Sayfa numarası, 1'den başlar |
per_page | integer | query | Zorunlu. Sayfa başına öğe, 1–100 |
search | string | query | Ağ adında ya da zincir adında büyük/küçük harf duyarsız kısmi arama. Sayfalamadan önce uygulanır; total eşleşmeleri sayar |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Örnek
curl --request GET \
--url '{{baseUrl}}/v2/gas-sponsor-wallets?page=1&per_page=20' \
--header 'Authorization: Bearer <access_token>'
Yanıt
{
"data": [
{
"network_id": "6740e0a20000000000000101",
"network_name": "Ethereum",
"chain_id": "6740e0a10000000000000101",
"chain_name": "EVM",
"address": "",
"wallet_id": ""
},
{
"network_id": "6740e0a20000000000000102",
"network_name": "Polygon",
"chain_id": "6740e0a10000000000000101",
"chain_name": "EVM",
"address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
"wallet_id": "6a89b68e0c46ca4c941271aa"
}
],
"total": 2,
"page": 1,
"per_page": 20
}
Yanıt Alanları
| Alan | Tip | Açıklama |
|---|---|---|
data | array | Bu sayfadaki ağlar |
data[].network_id | string | Ağları Listele uç noktasındaki ağ id'si (24 karakterlik hex) |
data[].network_name | string | Ağın görünen adı |
data[].chain_id | string | Ağın zincirinin id'si |
data[].chain_name | string | Zincirin görünen adı |
data[].address | string | Sponsor cüzdanın adresi. Sponsor tanımlı değilse boş |
data[].wallet_id | string | Bu ağda gas ücretini karşılayan platform cüzdanının id'si. Sponsor tanımlı değilse boş |
total | integer | search ile eşleşen ağ sayısı |
page | integer | İstekteki sayfa numarası |
per_page | integer | İstekteki sayfa boyutu |
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | page ya da per_page eksik veya aralık dışında — details alanına bakın |
| 403 | 10005 | Çağıran, platform düğümünün istemcisi değil (domain 2) |
| 400 | 10001 | Platform düğümü bulunamadı (domain 2) |
| 500 | 10000 | Beklenmeyen sunucu hatası |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.