> For the complete documentation index, see [llms.txt](https://docs.hypersign.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hypersign.id/hypersign-identity-network/governance/proposals/blockchain-node-upgrade.md).

# Blockchain Node Upgrade

## Proposal Structure

|        Field       |                 Description                |
| :----------------: | :----------------------------------------: |
|      **name**      |             Name of the Upgrade            |
|      **title**     |            Title of the proposal           |
|   **description**  |         Description of the proposal        |
| **upgrade-height** | Height at which node upgrade should happen |
|     **deposit**    |    Deposit for the proposal (in `uhid`)    |

## Submitting Node Upgrade Proposal

* Run the following to submit a blockchain node upgrade proposal:

```
hid-noded tx gov submit-legacy-proposal software-upgrade <Proposal Name> \
--title "<Proposal Title>" \
--description "<Proposal Description>" \
--upgrade-height "<Blockchain Height at which the upgrade should occur>" \
--deposit "<Deposit for the proposal>" \
--chain-id <Chain ID> \
--from <wallet-address> \
--yes
```

## Steps for Node Upgrade

If the Software Upgrade proposal is `Passed`, then following steps are needed to be performed in order to upgrade your node.

* Download and Install the **latest** binary.
* Create the following directory structure

```
mkdir -p <hid-node Config Directory>/cosmovisor/upgrades/<Proposal Name>/bin
```

> Note: Make sure that `<Proposal Name>` matches exactly with Upgrade Proposal's name. Please note that `Proposal Name` is different from `Proposal Title`.

* Copy the latest binary to the newly created directory

```
cp <Update Binary Location> <Binary Config Directory>/cosmovisor/upgrades/<Proposal Name>/bin
```

* At the the proposed height, the upgrade would take place automatically.