Ownership Changes Overview
Two operations move ownership of a deployment, and both are scoped to one setup (one deployment of a node on one network):
List Change Owner Processes
Lists the node ownership change processes of one setup, newest first. A setup keeps one row per attempt, including finished and cancelled ones. Any API key whose node is the node in the path or one of its ancestors may read it.
Get Change Owner Process
Returns one node ownership change process with its steps. Poll it after starting a process: it reports which step is running, each step's transaction hash once confirmed, and the error of a failed step. Any API key whose node is the node in the path or one of its ancestors may read it.
Start Change Owner Process
Starts a node ownership change on one setup of the node: every tokenized asset deployed under the setup is transferred to the wallet you select, then the owner address on the setup's diamond is changed to it. The call only creates the process; the steps run asynchronously, one on-chain transaction each. Poll Get Change Owner Process to follow it. See the overview for the lifecycle.
Pause Change Owner Process
Pauses a node ownership change process that is started or in_progress. No further step is sent until the process is resumed. A step whose transaction was already sent is not recalled: it still settles and is recorded, but the next step waits. See the overview for the lifecycle.
Resume Change Owner Process
Resumes a paused node ownership change process. The process returns to inprogress and continues from currentstep_order; a step that already completed is not sent again, the next pending one is. See the overview for the lifecycle.
Retry Change Owner Process Step
Retries a failed step of a paused node ownership change process. The step goes back to pending, its retrycount grows by one and its error is cleared, then the process resumes (inprogress) and sends the step again as a new on-chain transaction. A step can be retried max_retries (3) times. Poll Get Change Owner Process for the outcome. See the overview for the lifecycle.
Cancel Change Owner Process
Cancels a node ownership change process that is not finished (started, in_progress or paused). The process becomes cancelled and no further step is sent. Cancelling does not undo anything already done on-chain: transfers that completed stay with the new wallet, and a step whose transaction was already sent still settles. A new process can be started on the setup afterwards. See the overview for the lifecycle.
List Platform Owner Changes
Lists the platform owner changes of one setup, newest first. Poll it after Start Platform Owner Change until the change reads done or error. Any API key whose node is the node in the path or one of its ancestors may read it.
Start Platform Owner Change
Replaces the platform owner address on one setup's diamond with one of the platform owner's own wallets. This is a single on-chain transaction, recorded as a node transaction of type 35 (ChangePlatformOwnerAddress) on the platform owner node; it is asynchronous and answered with status in_progress. Poll List Platform Owner Changes until the change reads done or error. When it is done, the setup's platform owner fee-recipient wallet points at the new wallet.