getExpectedTotemDeletes
Retrieves unconfirmed, pending Totem share deletion (burning) transactions currently resting in the node's memory pool waiting to be forged in an upcoming block.
Endpoint Details
- HTTP Method:
POST - Gateway Path:
/nxt - Content-Type:
application/x-www-form-urlencoded - API Tags:
AE - Chain Specific: Optional / Conditional
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
requestType | String | Yes | Must be set to getExpectedTotemDeletes. |
chain | int | No | Sovereign BetaChain ID filter. |
totem | long / String | No | Unique -bit identifier of the Totem to filter by. Default: 0. |
account | long / String | No | Filter pending deletion transactions originating from a specific sender Account ID or Reed-Solomon address. |
includeTotemInfo | boolean | No | If true, embeds complete Totem metadata into each transaction JSON record. Default: false. |
Example Request
curl -X POST http://localhost:22024/nxt \
-d "requestType=getExpectedTotemDeletes" \
-d "chain=2" \
-d "totem=9876543210123456789" \
-d "account=SHAMWARI-ABCD-EFGH-JKLM-NOPQR" \
-d "includeTotemInfo=true"
Successful Response
{
"deletes": [
{
"transaction": "76123049120394812",
"totem": "9876543210123456789",
"sender": "1234567890123456789",
"senderRS": "SHAMWARI-ABCD-EFGH-JKLM-NOPQR",
"quantityQNT": "500000",
"feeNQT": "10000000",
"type": 2,
"subtype": 5,
"totemInfo": {
"name": "HarareRealEstateFund",
"decimals": 4,
"type": 4,
"quantityQNT": "1000000000000"
}
}
]
}
Error Codes
| Error Code | Cause / Description |
|---|---|
INCORRECT_CHAIN | Invalid or non-existent BetaChain ID specified in the request. |
UNKNOWN_ACCOUNT | The specified account parameter is malformed or invalid. |