Skip to content

cancel-lease-transaction.md

Latest commit

 

History

History
75 lines (65 loc) · 2.99 KB

cancel-lease-transaction.md

File metadata and controls

75 lines (65 loc) · 2.99 KB
Raw
description The cancel lease transaction allows you to stop leasing to a node for staking.

Cancel Lease

To cancel leasing, you need the id of the transaction that started the leasing. You can obtain a list of leases of an address via the /leasing/active/{address} endpoint on the REST API.

{
  "type": 9,
  "version": 3,
  "id": "6XmeG7SRWiw8pD6Uad6D9AAaY354v5TV6AJMhPpHMkqy",
  "sender": "3JorA3ddE7i6fhgBjSuW6jNTYS8D4EZUzio",
  "senderKeyType": "ed25519",
  "senderPublicKey": "AWwAdRHFmSqTCMHJ346wFSbJUsGUzQYCzuqXWgaT4gL6",
  "fee": 100000000,
  "timestamp": 1607010190710,
  "proofs": [
    "2BK6wTH75N78ixT273kArQxTo6NHvSVWQvtubZ5PTVdybcwomoUFjcYdfxqY6Xk7BpePjDbyr9aWdE5iZxQLq63J"
  ],
  "leaseId": "B22YzYdNv7DCqMqdK2ckpt53gQuYq2v997N7g8agZoHo",
  "height": 1012314
}

{% hint style="info" %}

  • id and height should be omitted when broadcasting. These fields are set by the node.
  • chainId can be obtained by taking the 2nd byte from the sender or recipient address.
  • Binary strings are base58 encoded.
  • timestamp is in microseconds since epoch.
  • feeincludes 8 digits, so LTO * 10^8 {% endhint %}

Binary schema

The binary data structure of the unsigned transaction.

{% tabs %} {% tab title="V3 (current)" %}

# Field Name Type Length
1 Transaction type Byte (constant, value=9) 1
2 Version Byte (constant, value=3) 1
3 Network id Byte 1
4 Timestamp Long 8
5 Sender's key type KeyType (Byte) 1
6 Sender's public key PublicKey (Array[Byte]) 32 | 33
7 Fee Long 8
8 Lease id Transaction (Array[Byte]) 32

{% hint style="info" %}

  • Network id can be obtained by taking the 2nd byte from the sender address.
  • Each key type has a numeric id in addition to the reference from the JSON.
  • Integers (short, int, long) have a big endian byte order. {% endhint %} {% endtab %}

{% tab title="V2" %}

# Field Name Type Length
1 Transaction type Byte (constant, value=9) 1
2 Version Byte (constant, value=2) 1
3 Network id Byte 1
4 Sender's public key PublicKey (Array[Byte]) 32
5 Fee Long 8
6 Timestamp Long 8
7 Lease id Transaction (Array[Byte]) 32

{% hint style="info" %}

  • Network id can be obtained by taking the 2nd byte from the sender address.
  • Integers (short, int, long) have a big endian byte order. {% endhint %} {% endtab %} {% endtabs %}