Platform Sahibi Değişikliğini Başlat

Bir kurulumun diamond kontratındaki platform sahibi adresini, platform sahibinin kendi cüzdanlarından biriyle değiştirir. Bu, platform sahibi düğümünde 35 tipli (ChangePlatformOwnerAddress) bir düğüm işlemi olarak kaydedilen tek bir zincir üstü işlemdir; asenkron çalışır ve in_progress durumuyla yanıtlanır. Değişiklik done ya da error olana kadar Platform Sahibi Değişikliklerini Listele uç noktasını yoklayın. done olduğunda kurulumun platform sahibi ücret alıcı cüzdanı yeni cüzdanı gösterir.

Bu uç noktayı yalnızca platform sahibinin API anahtarı çağırabilir; diğer anahtarlar 403 alır. Kurulum düğüme ait olmalı ve platform_owner_can_change_wallet platform ayarı açıkken oluşturulmuş olmalıdır: her kurulum oluşturulduğu andaki değeri saklar ve kontrol edilen bu kopyadır (bkz. Platform Sahibinin Cüzdan Değiştirme İznini Güncelle). Bir kurulumda aynı anda tek değişiklik çalışabilir.

Gerekli izin: node:change-platform-owner

İstek

POST /v2/admin/nodes/{node_id}/platform-owner-changes

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	path	Zorunlu. Kurulumun sahibi olan düğüm

Başlıklar

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

Gövde

Alan	Tip	Zorunlu	Açıklama
setup_id	string	Evet	Diamond kontratına yeni platform sahibi yazılacak kurulum. 24 karakterlik hex id; node_id düğümüne ait olmalı.
new_wallet_id	string	Evet	Yeni platform sahibi cüzdanı. Platform sahibi (kök) düğümün bir cüzdanı olmalı ve kurulumun ağının zincirinde bulunmalı.

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/nodes/6901350deb7ed8c1c38de4e9/platform-owner-changes' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "setup_id": "6905f1c2a8e4b27d3c9a1f42",
    "new_wallet_id": "6907b0d3e2f1a4c5b6d7e8f9"
  }'

Yanıt

201 Created

{
  "id": "6907b2c4d1e8f93a5b7c0d21",
  "node_id": "665ae536a6392b75cfd40352",
  "setup_id": "6905f1c2a8e4b27d3c9a1f42",
  "status": "in_progress",
  "new_owner_address": "0x7De3a0B5C2f4E6d8A1b3C5e7F9a2B4d6E8f0A1c3",
  "hash": null,
  "error": null,
  "created_at": "2026-11-03T13:02:44.190Z",
  "updated_at": "2026-11-03T13:02:44.236Z"
}

Yanıt Alanları

Alan	Tip	Açıklama
id	string	Platform sahibi değişikliğinin id'si
node_id	string	Değişikliğin atandığı platform sahibi (kök) düğüm; path'teki düğüm değil
setup_id	string	Değişikliğin çalıştığı kurulum
status	string	started, in_progress, done veya error. Yeni bir değişiklik in_progress ile yanıtlanır.
new_owner_address	string	Yeni platform sahibi cüzdanının adresi
hash	string | null	İşlem hash'i; değişiklik done olduğunda dolar
error	string | null	Durum error olduğunda başarısızlık nedeni
created_at	string	ISO 8601 oluşturulma zamanı
updated_at	string	ISO 8601 son değişiklik zamanı

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (setup_id veya new_wallet_id eksik, setup_id 24 karakterlik hex id değil) ya da istek reddedildi: kurulum bu düğümde bulunamadı, kurulum platform sahibinin cüzdanını değiştirmesine izin vermiyor, kök düğüm ya da kurulumun ağı bulunamadı, yeni cüzdan bulunamadı, platform sahibine ait değil ya da kurulumun zincirinde değil. Hangisi olduğunu message belirtir.
400	10016	new_wallet_id geçerli bir id değil
400	10001	Düğüm bulunamadı
400	21002	Bu kurulumda started veya in_progress durumunda bir platform sahibi değişikliği zaten var
403	10005	API anahtarı platform sahibine ait değil

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