Kullanıcı Cüzdanı Oluştur

Kullanıcı için chain_id ile belirtilen zincirde bir custody cüzdanı daha ister. Bu bir oluşturmadır, upsert değildir: bir kullanıcının birden fazla cüzdanı olabilir (zincir başına bir tane, aynı zincirde birden fazla da olabilir); bu yüzden mevcut bir cüzdan hiçbir zaman değiştirilmez ve reddetme sebebi değildir.

Çağrı asenkrondur. 202, isteğin kabul edildiği anlamına gelir. Custody sağlayıcısı cüzdanı zincirin varsayılan ağında oluşturur; cüzdan ardından Kullanıcı Cüzdanlarını Listele içinde custody: true olarak görünür ve platform KYC token'ını zincirin her ağında yeni cüzdana gönderir. İstek idempotent değildir: iki kez göndermek iki cüzdan oluşturur.

Gerekli izin: user:update

İstek

POST /v2/users/{user_id}/wallets

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Kullanıcı ID'si

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 (24 karakterlik hex chains ID'si). Varsayılan ağı olmalı. Zincirler GET /v2/chains ile listelenir
label	string	Hayır	Cüzdan listesinde görünen ad; aynı zincirde birden fazla cüzdanı olan kullanıcının bunları ayırt etme yolu

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/users/6a87455ad5f439809d488ac3/wallets' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "chain_id": "6740e0a10000000000000101",
    "label": "Main wallet"
  }'

Yanıt

Durum Kodu: 202 Accepted, boş gövde. Cüzdan görünene kadar Kullanıcı Cüzdanlarını Listele ile sorgulayın.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama hatası (chain_id eksik ya da 24 hex karakter değil) — details alanına bakın
400	10016	user_id geçerli bir ID değil
400	10001	Kullanıcı bulunamadı (domain 1)
400	10015	chain not found ya da chain has no default network configured

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