Ctrl+K

Freeze and Unfreeze Unspents

Overview

You can enable greater control over your unspents by freezing them, making them ineligible for automatic inclusion in your transactions. Frozen unspents are still spendable though, but only if you explicitly specify them in your transactions. Freezing unspents is especially useful if you don't want to commingle certain unspents in a wallet. Unspents remain frozen until their specified expiration time or until you unfreeze them. You can extend the time unspents remain frozen by Modifying Unspent Reservation. Freezing and unfreezing unspents follows the normal transaction flow, requiring signatures, approvals, and sending, as outlined in Wallets Overview.

Prerequisites

Steps

  • API (Freeze)
  • API (Unfreeze)
1
2
3
4
5
6
7
8
9
10
11
12
13
POST /api/v2/wallet/{walletId}/reservedunspents

Request Body
{
  "unspentIds": [
    "003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2"
  ],
  "expireTime": "string",
  "type": "ordinal",
  "inscriptionIds": [
    "003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8i2"
  ]
}

Step Result

  • Freeze
  • Unfreeze
1
2
3
4
5
6
7
8
9
10
11
12
{
  "unspents": [
    {
      "id": "003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2",
      "expireTime": "2019-08-24T14:15:22Z",
      "type": "undefined, ordinal, inscription",
      "inscriptionIds": [
        "string"
      ]
    }
  ]
}

Next

Sign the transaction.

See Also