Düğüm Cüzdanı Oluştur
Bir account düğümü ya da platform düğümü için, seçtiğiniz zincirde yeni bir saklama (custody) cüzdanı oluşturur. Platform düğümü yalnızca platform düğümünün kendisine verilmiş bir erişim token'ıyla hedeflenebilir. Bir düğüm aynı zincirde birden çok cüzdan dahil birden çok cüzdan tutabilir; bu yüzden bu çağrı mevcut bir cüzdanın yerini almaz. Sub-account düğümleri cüzdan tutamaz (10027).
Bu çağrı asenkrondur: gövdesiz 202 Accepted döner ve cüzdanı sonrasında saklama sağlayıcısı oluşturur. Bu sırada düğüm 3 (Creating) durumunu gösterir. Cüzdan oluşturulduğunda Düğüm Cüzdanlarını Listele listesinde görünür; o listeyi yoklayın.
Platformda aktif bir saklama sağlayıcısı olmalıdır; yoksa istek kabul edilip sonradan başarısız olmak yerine 10028 ile reddedilir.
Gerekli izin: node:create
İstek
POST /v2/admin/nodes/{node_id}/wallets
Parametreler
| Ad | Tip | Konum | Açıklama |
|---|---|---|---|
node_id | string | path | Zorunlu. Cüzdanın oluşturulacağı düğüm |
Başlıklar
| Ad | Açıklama |
|---|---|
Authorization | Zorunlu. Bearer <access_token> |
Content-Type | Zorunlu. application/json |
Gövde
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
chain_id | string | Evet | Cüzdanın oluşturulacağı zincir. Cüzdan zincirin varsayılan ağında oluşturulur |
label | string | Hayır | Cüzdan için bir ad. Sonradan Cüzdanı Yeniden Adlandır ile değiştirilebilir |
Örnek
curl --request POST \
--url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707/wallets' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"chain_id": "6740e0a10000000000000101",
"label": "Safe-Main-Wallet"
}'
Yanıt
Boş gövdeli 202 Accepted.
Hatalar
| Durum | Kod | Açıklama |
|---|---|---|
| 400 | 10015 | Doğrulama başarısız (eksik chain_id), zincir bulunamadı ya da zincirin varsayılan ağı yok — message / details alanlarına bakın |
| 400 | 10016 | node_id veya chain_id geçerli bir kimlik değil |
| 400 | 10001 | Düğüm bulunamadı (düğüm domain'i 2) |
| 400 | 10027 | Düğüm bir sub-account; yalnızca account düğümleri ve platform düğümü cüzdan tutar (düğüm domain'i 2) |
| 400 | 10028 | Platformda aktif bir saklama sağlayıcısı yok (düğüm domain'i 2) |
| 403 | 10005 | Düğüm, hiyerarşide sizin erişebildiğiniz kısmın dışında (düğüm domain'i 2) |
Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.