KYC Tokenı Oluştur

Bir ağda platform KYC tokenı oluşturur ve deploy işlemini başlatır. Yanıt, deploying durumundaki yeni tokendır.

Asenkron çalışır: deploy iki zincir adımında yürür; önce UUPS implementasyonu, ardından ERC1967 proxy. Token address değeriyle görünene kadar aynı network_id ile KYC Tokenlarını Listele endpoint'ini sorgulayın. Katalog yalnızca deploy edilmiş tokenları listeler; deploy işlemi başarısız olan bir token orada hiç görünmez.

Cüzdanı çağıran seçer, sunucu çözümlemez: cüzdan, platform sahibi düğümün ağın zincirindeki cüzdanlarından biri olmalıdır. İki deploy adımını da imzalar ve tokenın sahip cüzdanı olur; bu KYC tokenında sonraki tüm grup değişikliklerini ve token kurallarını o imzalar. Etkin bir custody sağlayıcısı gerekir. Yalnızca platform sahibi (kök) düğüm çağırabilir.

Gerekli izin: kyc:token:create

İstek

POST /v2/admin/kyc-tokens

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
name	string	Evet	KYC tokenlarının listelendiği her yerde görünen ad. Baştaki ve sondaki boşluklar kırpılır
network_id	string	Evet	Deploy edilecek ağ
wallet_id	string	Evet	Platform sahibi düğümün ağın zincirindeki cüzdanlarından biri. Deploy işlemini imzalar ve tokenın sahip cüzdanı olur

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/kyc-tokens' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Apex KYC Polygon",
    "network_id": "68a1f0c2d4e5f60718293a4b",
    "wallet_id": "68a2b3c4d5e6f708192a3b4c"
  }'

Yanıt

Durum 201.

{
  "id": "68c4a1f2b9e3d70012a5c3e8",
  "name": "Apex KYC Polygon",
  "network_id": "68a1f0c2d4e5f60718293a4b",
  "wallet_id": "68a2b3c4d5e6f708192a3b4c",
  "status": "deploying",
  "address": "",
  "impl_address": "",
  "version": "",
  "proxy_version": "",
  "created_at": "2026-10-02T09:14:31.512Z"
}

Yanıt Alanları

Alan	Tip	Açıklama
id	string	KYC tokenının id'si: setup'ların ve KYC gruplarının kullandığı kyc_token_id
name	string	Görünen ad
network_id	string	Tokenın deploy edildiği ağ
wallet_id	string	Tokenın sahip cüzdanı
status	string	deploying, done veya error; bu yanıtta her zaman deploying
address	string	KYC tokenının adresi (proxy'si). Proxy adımı onaylanana kadar boş
impl_address	string	İmplementasyonun adresi. İmplementasyon adımı onaylanana kadar boş
version	string	KYC tokenı implementasyon sürümü. İmplementasyon adımı onaylanana kadar boş
proxy_version	string	Proxy kontratı sürümü. Proxy adımı onaylanana kadar boş
deployed_at	string	Deploy işleminin tamamlandığı zaman (ISO 8601). O zamana kadar yer almaz
created_at	string	Tokenın oluşturulduğu zaman (ISO 8601)

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. network_id hiçbir ağa karşılık gelmediğinde de network not found mesajıyla döner
400	10016	network_id veya wallet_id geçerli bir id değil
403	10005 (domain 2)	Düğümünüz platform sahibi (kök) düğüm değil
400	10021 (domain 2)	wallet_id, platform sahibi düğümün ağın zincirindeki cüzdanlarından biri değil
400	10028 (domain 2)	Etkin bir custody sağlayıcısı yok; deploy çalıştırılamaz

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