Token Oluştur

Bir düğüm altında token oluşturur ve tokenizasyonunu bir kurulum (setup) üzerinde başlatır. Çağrı asenkrondur: token'ı 1 (Draft) durumunda kaydeder, bir CreateTokenization işlemi (tip 1) kuyruğa alır ve iki id ile 201 döner. Dönen transaction_id ile ID ile Token İşlemi Getir uç noktasını sorgulayın: işlem 3 (Done) olduğunda token contract alanı dolu olarak 4 (NotListed) durumundadır; 4 (Error) olduğunda token 3 (Error) durumundadır ve Token'ı Yeniden Tokenize Et ile yeniden denenebilir.

Token'ın nerede yaşayacağını ve kimin imzalayacağını kurulum belirler: bir kurulum, düğümün tek bir cüzdan ve tek bir ağ üzerindeki dağıtımıdır, bu yüzden wallet_id alanı yoktur. Kurulum, token'ın hesap düğümüne (düğümün platform kökünün hemen altındaki atası; düğüm zaten oradaysa kendisi) ait olmalı, tüm kontratları dağıtılmış olmalı ve network_id kurulumun ağı olmalıdır. Platform kökünün kendisinde token oluşturulamaz.

Gerekli izin: token:create

İstek

POST /v2/admin/tokens

Görsel ya da belge yüklüyorsanız gövde multipart/form-data, dosya yoksa application/json olabilir. Alanlar her ikisinde de aynıdır.

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. multipart/form-data ya da application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
node_id	string	Evet	Token'ın oluşturulacağı düğüm (24 karakterlik hex id). Çağıranın düğümü onu kapsamalıdır.
setup_id	string	Evet	Tokenizasyonun yapılacağı kurulum. Düğümün hesap düğümüne ait olmalı ve tüm kontratları dağıtılmış olmalıdır. Tokenizasyonu ve token'ın sonraki tüm zincir üstü işlemlerini kurulumun cüzdanı imzalar.
network_id	string	Evet	Token'ın çalışacağı ağ. Kurulumun ağı olmalıdır.
category_id	string	Evet	Token'ın kaydedileceği kategori. Kategorinin tokenizasyon kuralları uygulanır (bkz. Hatalar).
name	string	Evet	Görünen ad.
description	string	Evet	Açıklama.
token_name	string	Evet	Zincir üzerindeki token adı.
token_symbol	string	Evet	Zincir üzerindeki token sembolü.
currency_token_id	string	Evet	Değerin ifade edildiği para birimi token'ı. Kontratı önceden dağıtılmış olmalıdır.
total_value	string	Evet	Varlığın tamamının değeri; sıfırdan büyük ve para birimi token'ından fazla ondalık basamak içermeyen ondalık string.
salable_percentage	string	Evet	Varlığın satışa sunulan payı; "0"'dan büyük, en fazla "100", en çok bir ondalık basamak.
max_supply	integer	Evet	Toplam token sayısı. Token fiyatı total_value × salable_percentage / max_supply olur.
images	file	Hayır	Yalnızca multipart. En fazla 10 görsel; PNG, JPEG ya da GIF, her biri 2 MB'tan küçük. İlki varsayılan görsel olur.
documents	file	Hayır	Yalnızca multipart. En fazla 10 PDF belge, her biri 2 MB'tan küçük. Belgeler özel olarak saklanır ve kısa ömürlü imzalı bağlantılarla okunur.
oracle_id	string	Hayır	Eklenecek fiyat oracle'ı. Yalnızca oracle_code ile birlikte kullanılır.
oracle_code	string	Hayır	Oracle'ın entegrasyon kodlarından biri.

Tutarlar ve yüzdeler Tutarlar ve Yüzdeler sayfasındaki kurallara uyar. Birden fazla dosya için images / documents parçalarını tekrarlayın.

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/tokens' \
  --header 'Authorization: Bearer <access_token>' \
  --form node_id=67d6c447f47ff3adafda700d \
  --form setup_id=6a837bb62998e4fbfed7f52a \
  --form network_id=6740e0a20000000000000103 \
  --form category_id=667e9251ca818a2138ed4915 \
  --form 'name=TKN Token Name' \
  --form 'description=Token Description' \
  --form token_name=tkn \
  --form token_symbol=TKN \
  --form currency_token_id=68fe8c129367fd414b227c7a \
  --form total_value=12000 \
  --form salable_percentage=80 \
  --form max_supply=1000 \
  --form images=@/path/to/image.png \
  --form documents=@/path/to/prospectus.pdf \
  --form oracle_id=677ed6e3cc111aea14a3dfc3 \
  --form oracle_code=IOG

Dosya olmadan aynı istek JSON olarak:

curl --request POST \
  --url '{{baseUrl}}/v2/admin/tokens' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "node_id": "67d6c447f47ff3adafda700d",
    "setup_id": "6a837bb62998e4fbfed7f52a",
    "network_id": "6740e0a20000000000000103",
    "category_id": "667e9251ca818a2138ed4915",
    "name": "TKN Token Name",
    "description": "Token Description",
    "token_name": "tkn",
    "token_symbol": "TKN",
    "currency_token_id": "68fe8c129367fd414b227c7a",
    "total_value": "12000",
    "salable_percentage": "80",
    "max_supply": 1000
  }'

Yanıt

201 Created

{
  "token_id": "67d8774e903bfcbe7eb5d93e",
  "transaction_id": "67d8774f903bfcbe7eb5d941"
}

Yanıt Alanları

Alan	Tip	Açıklama
token_id	string	Yeni token'ın id'si (durum 1, Draft).
transaction_id	string	CreateTokenization işlemi. ID ile Token İşlemi Getir ile sorgulayın.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın. Ayrıca total_value ya da salable_percentage sıfır veya hatalı biçimliyse, kurulum yoksa, başka bir hesap düğümüne aitse ya da network_id dışında bir ağdaysa, oracle_code oracle'ın kodlarından biri değilse, bir yükleme 2 MB veya daha büyükse ya da multipart gövde okunamıyorsa döner
400	10016	Gövdedeki bir id geçerli bir id değil
400	10001	Düğüm bulunamadı (düğüm domain'i 2)
403	10005	Çağıranın düğümü node_id'yi kapsamıyor (düğüm domain'i 2)
400	10007	Düğümün hesap düğümü yok, örneğin platform kökü (düğüm domain'i 2)
400	10011	Kurulumun kontratlarının tümü dağıtılmamış (düğüm domain'i 2)
404	10001	Para birimi token'ı bulunamadı (para birimi token'ı domain'i 15)
400	10004	Para birimi token'ının kontratı henüz dağıtılmamış (para birimi token'ı domain'i 15)
400	10015	Kategori salable_percentage değerinin 100 olmasını gerektiriyor (token domain'i 5)
400	10016	Kategori max_supply değerinin total_value ile eşleşmesini gerektiriyor (token domain'i 5)
400	10001	Oracle bulunamadı (oracle domain'i 5, mesaj oracle not found)
400	10040	Yüklenen bir dosyanın türüne izin verilmiyor (görseller: PNG, JPEG, GIF; belgeler: PDF)

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