Wallets (Cüzdanlar)

Cüzdan yönetimi ve contract deploy.

Kimlik Doğrulama: Bearer token gereklidir.

---

Cüzdan Oluştur

Endpoint: POST /api/v1/wallets

İstek Gövdesi

Alan	Tip	Zorunlu	Açıklama
node_id	string	Evet	Node UUID
chain_id	string	Evet	Chain UUID
name	string	Evet	1–255 kar.

Yanıt — 201 Created

{
  "id": "...",
  "node_id": "...",
  "chain_id": "...",
  "name": "...",
  "address": "",
  "is_active": true,
  "created_at": "...",
  "updated_at": "..."
}

Kod	Açıklama
404	Node veya chain bulunamadı

---

Cüzdan Listele

Endpoint: GET /api/v1/wallets

Sorgu Parametreleri

Parametre	Tip	Zorunlu	Varsayılan	Açıklama
node_id	string	Evet	—	Node UUID
page	int	Hayır	1	Sayfa numarası
per_page	int	Hayır	10	Sayfa başına öğe (max 100)

Yanıt — 200 OK

items, page, per_page, total ile sayfalanmış liste.

---

Cüzdan ID ile Getir

Endpoint: GET /api/v1/wallets/{id}

Yanıt — 200 OK

Tam cüzdan nesnesi.

Kod	Açıklama
404	Cüzdan bulunamadı

---

Cüzdan Güncelle

Endpoint: PUT /api/v1/wallets/{id}

İstek Gövdesi

Alan	Tip	Zorunlu	Açıklama
name	string	Hayır	max 255
address	string	Hayır	max 255
is_active	bool	Hayır	Aktif bayrağı

Yanıt — 204 No Content

Kod	Açıklama
404	Cüzdan bulunamadı

---

Cüzdan Sil

Endpoint: DELETE /api/v1/wallets/{id}

Cüzdanı soft-delete eder.

Yanıt — 204 No Content

Kod	Açıklama
404	Cüzdan bulunamadı

---

Node Contract Deploy Et

Endpoint: POST /api/v1/wallets/{id}/deploy

Sıralı deploy akışını başlatır veya devam ettirir. Tekrarlı çağrım güvenlidir:

• Mevcut adım started/in_progress: no-op
• Mevcut adım done: sonraki adıma geçer
• Mevcut adım error: aynı adımı tekrarlar

İstek Gövdesi

Alan	Tip	Zorunlu	Açıklama
node_id	string	Evet	Node UUID
network_id	string	Evet	Network UUID

Wallet ID yol parametresinden gelir.

Yanıt — 201 Created

{
  "step": "deploy_diamond",
  "transaction_id": "550e8400-...",
  "status": "started"
}

Kod	Açıklama
404	Cüzdan, node veya network bulunamadı

---

Node Contract Sürüm Kontrolü

Endpoint: GET /api/v1/wallets/{id}/deploy/version-check

Aktif node_contract sürümlerini en son contract sürümleriyle karşılaştırır.

Sorgu Parametreleri

Parametre	Tip	Zorunlu	Açıklama
node_id	string	Evet	Node UUID
network_id	string	Evet	Network UUID

Yanıt — 200 OK

{
  "any_update_available": true,
  "checked_at": "2025-02-14T10:00:00Z",
  "contracts": [
    {
      "contract_type": "...",
      "current_version": "...",
      "latest_version": "...",
      "update_available": true
    }
  ]
}

Kod	Açıklama
404	Cüzdan, node veya network bulunamadı

---

Node Contract Güncelle

Endpoint: POST /api/v1/wallets/{id}/update

Gerekirse facet'leri deploy eder ve update_diamond_cut tetikler.

İstek Gövdesi

Alan	Tip	Zorunlu	Açıklama
node_id	string	Evet	Node UUID
network_id	string	Evet	Network UUID

Yanıt — 201 Created

Yeni contract durumu ile güncelleme yanıtı döner.

Kod	Açıklama
404	Cüzdan, node veya network bulunamadı