Sahiplik Değişikliği Sürecini Başlat

Düğümün bir kurulumunda düğüm sahipliği değişikliğini başlatır: kurulum altında dağıtılmış her tokenize varlık seçtiğiniz cüzdana devredilir, ardından kurulumun diamond kontratındaki sahip adresi bu cüzdana çevrilir. Çağrı yalnızca süreci oluşturur; adımlar asenkron çalışır ve her biri zincir üstü bir işlemdir. Süreci izlemek için Sahiplik Değişikliği Sürecini Al uç noktasını yoklayın. Yaşam döngüsü için genel bakış sayfasına bakın.

Bu uç noktayı yalnızca platform sahibinin API anahtarı çağırabilir; diğer anahtarlar 403 alır. Kurulum düğüme ait olmalı; yeni cüzdan aynı düğümün bir cüzdanı olmalı, kurulumun zincirinde bulunmalı ve adresi kurulumun mevcut sahip cüzdanından farklı olmalıdır. Bir kurulumda bitmemiş tek bir süreç bulunabilir.

Gerekli izin: node:change-owner

İstek

POST /v2/admin/nodes/{node_id}/change-owner-processes

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	Sahipliği değişecek kurulum. 24 karakterlik hex id; `node_id` düğümüne ait olmalı.
`new_wallet_id`	string	Evet	Yeni sahip olacak düğüm cüzdanı. `node_id` düğümüne ait olmalı, kurulumun ağının zincirinde bulunmalı ve adresi kurulumun mevcut sahip cüzdanından farklı olmalı.

Örnek

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

Yanıt

201 Created

{
  "id": "6907a4e1b5c83f2d9e6a0b17",
  "node_id": "6901350deb7ed8c1c38de4e9",
  "setup_id": "6905f1c2a8e4b27d3c9a1f42",
  "network_id": "68fe7b31c2d94a5e8b1f0c63",
  "old_owner_address": "0xecE2c86490b1214035cb1bbcC9781aE45d29BB97",
  "new_wallet_id": "6a89b68e0c46ca4c941271aa",
  "new_owner_address": "0xa112983907944387B64ba512daF256B3f28f93f5",
  "status": "started",
  "current_step_order": 0,
  "total_steps": 3,
  "progress": 0,
  "steps": [
    {
      "id": "6907a4e1b5c83f2d9e6a0b18",
      "type": "transfer_tokenized_assets",
      "status": "pending",
      "order": 1,
      "token_id": "67d8774e903bfcbe7eb5d93e",
      "transaction_hash": null,
      "retry_count": 0,
      "max_retries": 3,
      "error": null,
      "started_at": null,
      "completed_at": null
    },
    {
      "id": "6907a4e1b5c83f2d9e6a0b19",
      "type": "transfer_tokenized_assets",
      "status": "pending",
      "order": 2,
      "token_id": "67e1a2b3c4d5e6f708192a3b",
      "transaction_hash": null,
      "retry_count": 0,
      "max_retries": 3,
      "error": null,
      "started_at": null,
      "completed_at": null
    },
    {
      "id": "6907a4e1b5c83f2d9e6a0b1a",
      "type": "change_node_owner",
      "status": "pending",
      "order": 3,
      "token_id": null,
      "transaction_hash": null,
      "retry_count": 0,
      "max_retries": 3,
      "error": null,
      "started_at": null,
      "completed_at": null
    }
  ],
  "error": null,
  "created_at": "2026-11-02T09:14:27.512Z",
  "updated_at": "2026-11-02T09:14:27.512Z",
  "completed_at": null
}

Yanıt Alanları

Alan	Tip	Açıklama
`id`	string	Süreç id'si
`node_id`	string	Kurulumun sahibi olan düğüm
`setup_id`	string	Değişikliğin çalıştığı kurulum
`network_id`	string	Kurulumun ağı
`old_owner_address`	string	Kurulumun mevcut, yerine yenisi gelecek sahip cüzdanının adresi
`new_wallet_id`	string	Yeni sahip olarak seçilen cüzdan
`new_owner_address`	string	Yeni sahip cüzdanının adresi
`status`	string	Süreç durumu: `started`, `in_progress`, `paused`, `completed`, `failed`, `cancelled`. Bkz. genel bakış.
`current_step_order`	integer	Yürütülen adımın `order` değeri; ilk adım gönderilmeden önce `0`
`total_steps`	integer	Adım sayısı: her tokenize varlık için bir adım artı son sahip değişikliği
`progress`	number	`completed` veya `skipped` adımların yüzdesi (`0`–`100`)
`steps`	array	`order` sırasıyla adımlar
`steps[].id`	string	Adım id'si
`steps[].type`	string	`transfer_tokenized_assets` veya `change_node_owner`
`steps[].status`	string	`pending`, `in_progress`, `completed`, `failed`, `skipped`
`steps[].order`	integer	Adımın sırası, 1'den başlar. Yeniden denemek için `step_order` olarak gönderin.
`steps[].token_id`	string \| null	Devir adımının taşıdığı token; `change_node_owner` için `null`
`steps[].transaction_hash`	string \| null	Onaylanan işlemin hash'i
`steps[].retry_count`	integer	Adımın kaç kez yeniden denendiği
`steps[].max_retries`	integer	Adımın yeniden deneme sınırı (`3`)
`steps[].error`	string \| null	Adımın başarısız olma nedeni
`steps[].started_at`	string \| null	Adımın gönderildiği zaman
`steps[].completed_at`	string \| null	Adımın tamamlandığı zaman
`error`	string \| null	Süreç düzeyindeki hata. Adım hataları adımın üzerinde raporlanır.
`created_at`	string	ISO 8601 oluşturulma zamanı
`updated_at`	string	ISO 8601 son değişiklik zamanı
`completed_at`	string \| null	Sürecin tamamlandığı 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ı, kurulumun mevcut sahip cüzdanı veya ağı bulunamadı, yeni cüzdan bulunamadı, düğüme ait değil, kurulumun zincirinde değil ya da zaten kurulumun sahibi. Hangisi olduğunu `message` belirtir.
400	`10016`	`new_wallet_id` geçerli bir id değil
400	`10001`	Düğüm bulunamadı
400	`20002`	Bu kurulum için bitmemiş (`started`, `in_progress` veya `paused`) bir süreç zaten var
403	`10005`	API anahtarı platform sahibine ait değil

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

İstek​

Parametreler​

Başlıklar​

Gövde​

Örnek​

Yanıt​

Yanıt Alanları​

Hatalar​