Düğüm Kurulumu Oluştur

Seçtiğiniz cüzdan ve ağ üzerinde yeni bir kurulum (setup) açar ve sözleşmelerinin — düğümün diamond'ı ve facet'leri — dağıtımını başlatır. Bir düğümün sözleşmelerini dağıtmanın tek yolu budur. Her çağrı, zaten kurulumu olan bir cüzdan ve ağ için bile yeni bir kurulum oluşturur; dağıtımı takılan bir kurulumu yeniden denemek için bunun yerine Kurulum Sözleşmelerini Dağıt kullanın.

Kurulumlar account düğümlerine aittir. Platform düğümünün kurulumu yoktur ve reddedilir (10015); platformun KYC token'ları POST /v2/admin/kyc-tokens ile oluşturulur.

Kurulum oluşturulmadan önce sunucu şunları kontrol eder:

• cüzdan düğüme ait ve ağın zincirinde (10021);
• sahip (owner) ve platform sahibi ödeme cüzdanları ağ için yapılandırılmış (10024, 10025; on-premise kurulumda sahip cüzdanı gerekmez);
• ağda bir KYC token'ı dağıtılmış (10022) ve kyc_token_id ile belirttiğiniz token bunlardan biri (10026).

Dağıtım asenkrondur: yanıt completed: false ile yeni kurulumdur ve sözleşmeler arka planda sırayla dağıtılır. Her adım 3 (Done) olana kadar Kurulum Sözleşme Durumunu Al ile ya da completed true olana kadar Düğüm Kurulumunu Al ile yoklayın.

Gerekli izin: contract:deploy

İstek

POST /v2/admin/nodes/{node_id}/setups

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Account düğümünün kimliği

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
wallet_id	string	Evet	Kurulumun sözleşmelerini dağıtan ve imzalayan düğüm saklama cüzdanı (Düğüm Cüzdanlarını Listele)
network_id	string	Evet	Dağıtımın yapılacağı ağ. Cüzdanın zincirinde olmalıdır
name	string	Hayır	Kurulum için bir ad
kyc_token_id	string	Hayır	Diamond'ın ağda dağıtılmış KYC token'larından hangisine bağlanacağı. Boş ya da gönderilmezse: ağın en eski dağıtılmış KYC token'ı
value	object	Hayır	Kurulumun kendi düğüm ücreti. Gönderilmezse kurulum, oluşturulduğu anda düğüm için çözümlenen düğüm ücretini korur. Bkz. Ücret değeri
categories	array	Hayır	Bu kurulum için kategori bazında düğüm ücretleri
categories[].id	string	Evet, her öğede	Kategori kimliği
categories[].value	object	Evet, her öğede	O kategori için ücret değerleri, value ile aynı yapıda

Ücret değeri

Her yaprak tek alanlı bir nesnedir, value: ondalık string olarak yüzde ("2.5"). Herhangi bir yaprak gönderilmeyebilir. Bkz. Tutarlar ve Yüzdeler.

Alan	Açıklama
tokenization.asset_tokenization.value	Varlık tokenizasyonu ücreti
tokenization.tokenized_asset_sales.value	Tokenize varlık satış ücreti
tokenization.management.value	Yönetim ücreti
secondary_market.buy_order.value	İkincil piyasa alış emri ücreti
secondary_market.sell_order.value	İkincil piyasa satış emri ücreti
secondary_market.otc_sale.value	OTC satış ücreti
lending.borrower.value	Borçlu ücreti
lending.lending.value	Borç verme ücreti
lending.liquidation.value	Tasfiye ücreti

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/nodes/6a4bef2b1e781b11c22e9707/setups' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_id": "6a53f3dfad48accdb46eaf9e",
    "network_id": "6740e0a20000000000000101",
    "name": "My Setup API",
    "kyc_token_id": "",
    "value": {
      "tokenization": {
        "asset_tokenization": { "value": "5" },
        "tokenized_asset_sales": { "value": "6.8" },
        "management": { "value": "7" }
      },
      "secondary_market": {
        "buy_order": { "value": "8.5" },
        "sell_order": { "value": "0.5" },
        "otc_sale": { "value": "1" }
      },
      "lending": {
        "borrower": { "value": "0.7" },
        "lending": { "value": "0.5" },
        "liquidation": { "value": "2" }
      }
    }
  }'

Yanıt

Yeni kurulumla birlikte 200 OK:

{
  "setup_id": "6a552db09c6088e126a4be87",
  "name": "My Setup API",
  "wallet_id": "6a53f3dfad48accdb46eaf9e",
  "wallet_label": "Safe-Main-Wallet",
  "wallet_address": "0xAF4bf547c4d354266449dB91fe0c4d8861cFfc0E",
  "chain_id": "6740e0a10000000000000101",
  "chain_name": "EVM",
  "network_id": "6740e0a20000000000000101",
  "network_name": "Ethereum",
  "node_address": "0xAF4bf547c4d354266449dB91fe0c4d8861cFfc0E",
  "owner_address": "0x5B38Da6a701c568545dCfcB03FcB875f56beddC4",
  "platform_owner_address": "0x86123D7398a5a2C8b847b37B34eB499e07dE3A76",
  "platform_owner_wallet_label": "Platform Treasury",
  "completed": false,
  "status": "pending",
  "kyc_token_id": "6a51e0c2d4f1a2b3c4d5e6f7",
  "kyc_token_address": "0x1C0777276B13c56d416c41D4186744b9ba0a0D3a",
  "is_api": true
}

Yanıt Alanları

Yanıt tek bir kurulum satırıdır; alanları tek tek Düğüm Kurulumlarını Listele sayfasında açıklanmıştır.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (eksik wallet_id veya network_id, geçersiz ücret yüzdesi), ağ yok ya da düğüm platform düğümü — message / details alanlarına bakın
400	10016	node_id, wallet_id veya network_id geçerli bir kimlik değil
400	10001	Düğüm bulunamadı (düğüm domain'i 2)
400	10021	Cüzdan bu düğüme ait değil ya da ağın zincirinde değil (düğüm domain'i 2)
400	10022	Ağda dağıtılmış KYC token'ı yok (düğüm domain'i 2)
400	10024	Sahip ödeme cüzdanı bu ağ için yapılandırılmamış (düğüm domain'i 2)
400	10025	Platform sahibi ödeme cüzdanı bu ağ için yapılandırılmamış; PUT /v2/admin/platform-owner-wallets/networks/{network_id} ile ayarlayın (düğüm domain'i 2)
400	10026	kyc_token_id, ağın dağıtılmış KYC token'larından biri değil (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.