> For the complete documentation index, see [llms.txt](https://qubetics.gitbook.io/qubetics-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qubetics.gitbook.io/qubetics-docs/getting-started/publish-your-docs-4/cancel-unbonding.md).

# Cancel Unbonding

## Cancel Unbonding Guide

This guide explains how to **cancel the unbonding delegation** on qubetics chain using the `qubeticsd` CLI.

***

### Prerequisites

Ensure you have:

* A working **Qubetics chain** is running.
* The **CLI (qubetcisd )** is installed and configured.
* Your **keyring** is already set up with the validator and delegator keys.

***

### Step 1: Check Pending Unbonding Delegations

To see your current unbonding delegations:

```bash
qubetcisd q staking unbonding-delegation <delegator-address> <validator-address> --node <rpc-endpoint>
```

Example:

```bash
qubetcisd q staking unbonding-delegation qubetics1abcd... cqubeticsvaloper1abcd... --node https://tendermint.qubetics.com:443
```

You’ll see something like:

```json
{
  "unbonding_responses": [
    {
      "delegator_address": "qubetics14adqfq7hdrqxpy5qtnnmshvpzpxvmr3x0pqgn2",
      "validator_address": "qubeticsvaloper1xyz...",
      "entries": [
        {
          "creation_height": "789195",
          "completion_time": "2025-08-25T16:05:59.861001704Z",
          "initial_balance": "1000000000000000000000",
          "balance": "1000000000000000000000",
          "unbonding_id": "378",
          "unbonding_on_hold_ref_count": "0"
        }
      ]
    }
  ]
}
```

Field meanings:

`<creation_height>`: The block height when the unbonding delegation was initiated. Here: it started at block 789195.&#x20;

`<completion_time>`: The timestamp when the unbonding period finishes (i.e., when the tokens become liquid and transferable). Here: 2025-08-25T16:05:59Z is the unlock time.&#x20;

`<initial_balance>`: The original number of tokens that were unbonded at the time of starting. Here: 1000000000000000000000 (tics = 18 decimals → 1000 TICS).&#x20;

`<balance>`: The remaining balance that is still unbonding. If you redelegate or cancel part of it, this value decreases. Here, still the full amount (1000 TICS) is waiting. `<unbonding_id>`: A unique identifier for this unbonding entry. Useful if there are multiple unbondings per delegator. Here: entry ID is 378.&#x20;

`<unbonding_on_hold_ref_count>`: Internal counter used when unbonding is paused/put on hold (e.g., due to slashing events or other protocol logic).

&#x20;0 → means not on hold; tokens are progressing toward release normally.&#x20;

Greater than 0 → means unbonding is currently paused.

***

### Step 2: Cancel the Unbonding

To cancel the unbonding delegation and redelegate it back:

```bash
qubetcisd tx staking cancel-unbond <validator-address> <amount> <creation_height> --from <delegator-key> --gas auto --gas-prices <fee-amount> --chain-id <chain-id> --node <rpc-endpoint>

```

#### Note:

The amount entered on the CLI must include 18 zeros. For example, if the amount is 1 TICS, then on the CLI it should be entered as 1000000000000000000 TICS.

#### Example:

```bash
qubetcisd tx staking cancel-unbond qubeticsvaloper1xyz... 1000000tics 789195 --from mywallet --gas auto --gas-prices 100000000000tics --chain-id qubetics_9030-1 --node https://tendermint.qubetics.com:443
```

#### Note:

The amount entered on the CLI must include 18 zeros. For example, if the amount is 1 TICS, then on the CLI it should be entered as 1000000000000000000 TICS.

Where:

* `<validator-address>` → The validator where you delegated.
* `<amount>` → Amount you want to cancel unbonding.
* `<creation_height>` → The block height when the unbonding delegation was initiated. Here: it started at block 789195.
* `--from` → Your delegator wallet name.
* `--gas-prices` → Transaction fees.
* `--chain-id` → Your chain ID.

***

### Step 3: Verify the Transaction

After submission, confirm it on-chain:

```bash
qubetcisd q tx <tx-hash> --node <rpc-endpoint>
```

Or check your updated delegation:

```bash
qubeticsd q staking delegation <delegator-address> <validator-address> --node <rpc-endpoint>
```

***

### ⚠️ Common Issues & Fixes

1. **`account sequence mismatch`**
   * Your account has pending transactions. Wait for confirmation or increase the sequence manually.
2. **`insufficient funds`**
   * Make sure you have enough balance to pay fees.
3. **`unknown command`**
   * Ensure your chain supports `cancel-unbonding-delegation` (introduced in Cosmos SDK v0.46+).

***

### Notes

* Canceling unbonding **must be done before the `completion_time`** shown in the unbonding entry.

***

### References

* Cosmos SDK Staking Docs: <https://docs.cosmos.network/main/modules/staking>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://qubetics.gitbook.io/qubetics-docs/getting-started/publish-your-docs-4/cancel-unbonding.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
