/build/rpc / assets / governance_rotation

finalize_rotation

finalize_rotation "merged_psbt" ( {"broadcast":bool,"fee_rate":n} ) Finalize and broadcast a merged governance rotation. Adds BTC fee inputs, signs ICU input with SIGHASH_ALL, and broadcasts. Arguments: 1. merged_psbt (string, required) Base64-encoded merged PSBT from merge_rotation 2. options (json object, optional) Options { "broadcast": bool, (boolean, optional, default=true) Broadcast after signing "fee_rate": n, (numeric, optional) Fee rate in sat/vB } Result: { (json object) "txid" : "hex", (string) Transaction ID "hex" : "hex", (string) Signed raw transaction hex "broadcast" : true|false (boolean) True if the transaction was submitted to the mempool } Examples: > bitcoin-cli finalize_rotation "cHNidP8..." '{"broadcast":true}'

Signature

finalize_rotation(merged_psbt: string, options?: object) → any

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"finalize_rotation","params":["\"<merged_psbt>\"",{}]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli finalize_rotation "cHNidP8..." '{"broadcast":true}'

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "finalize_rotation",
        "params": ["\"<merged_psbt>\"", {}],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "finalize_rotation",
    params: ["\"<merged_psbt>\"",{}],
  }),
});
console.log(await res.json());

Parameters

Name	Type	Req.	Description
merged_psbt	`string`	yes	Base64-encoded merged PSBT from merge_rotation
options	`object`	—	Options { "broadcast": bool, (boolean, optional, default=true) Broadcast after signing "fee_rate": n, (numeric, optional) Fee rate in sat/vB }

Result

Type: any

{ (json object) "txid" : "hex", (string) Transaction ID "hex" : "hex", (string) Signed raw transaction hex "broadcast" : true|false (boolean) True if the transaction was submitted to the mempool }

Source: services/core-node/bcore/src/wallet/rpc/assets.cpp:8179

C++ symbol: finalize_rotation

Code samples

curl --user "$RPC_USER:$RPC_PASS" \
  --data-binary '{"jsonrpc":"1.0","id":"docs","method":"finalize_rotation","params":["\"<merged_psbt>\"",{}]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:8332/

bitcoin-cli finalize_rotation "cHNidP8..." '{"broadcast":true}'

import requests
r = requests.post(
    "http://127.0.0.1:8332/",
    auth=("$RPC_USER", "$RPC_PASS"),
    json={
        "jsonrpc": "1.0",
        "id": "docs",
        "method": "finalize_rotation",
        "params": ["\"<merged_psbt>\"", {}],
    },
    timeout=30,
)
print(r.json())

const res = await fetch("http://127.0.0.1:8332/", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "authorization": "Basic " + btoa(`${process.env.RPC_USER}:${process.env.RPC_PASS}`),
  },
  body: JSON.stringify({
    jsonrpc: "1.0",
    id: "docs",
    method: "finalize_rotation",
    params: ["\"<merged_psbt>\"",{}],
  }),
});
console.log(await res.json());