Skip to main content

IncreaseTotemShares

Increases the supply of a splittable totem proportionally across all holders. This performs a non-dilutive share increase where each holder receives additional units proportional to their current holdings. This is a transaction creation endpoint.

Endpoint: POST /nxt?requestType=IncreaseTotemShares

Parameters:

  • totem (long, required): Totem ID to increase
  • increasePerShareQNT (long, required): Additional quantity per share in Quantum Units. This is the amount each existing share receives
  • height (int, required): Snapshot block height used to calculate holder proportions. Must be between 0 and current height - 1
  • secretPhrase (string, required): Sender account secret phrase (must be the totem issuer)
  • feeMTA (long, optional): Transaction fee in MTA
  • deadline (int, optional): Transaction deadline in minutes (default: 1440)
  • referencedTransactionFullHash (string, optional): Referenced transaction full hash
  • broadcast (boolean, optional, default: true): Whether to broadcast the transaction

Request Example: /nxt?requestType=IncreaseTotemShares&totem=123456789&increasePerShareQNT=1000000&height=100000&secretPhrase=mySecret

Response:

{
  "type": 2,
  "subtype": 7,
  "chain": 1,
  "phased": false,
  "timestamp": 123456789,
  "deadline": 123457789,
  "senderPublicKey": "abc123...",
  "sender": "111111111",
  "feeMTA": "1000000",
  "amountMTA": "0",
  "signature": "def456...",
  "signatureHash": "ghi789...",
  "fullHash": "jkl012...",
  "transaction": "1234567890",
  "version": 1,
  "ecBlockId": "123456",
  "ecBlockHeight": 123456,
  "attachment": {
    "version.TotemIncrease": 1,
    "totem": "123456789",
    "increasePerShareQNT": "1000000",
    "height": 100000
  }
}

Response Fields:

  • type: number (2) - Transaction type (Asset Exchange)
  • subtype: number (7) - TOTEM_INCREASE
  • chain: number - Chain ID
  • phased: boolean - Whether transaction is phased
  • timestamp: number - Transaction timestamp
  • deadline: number - Transaction deadline
  • senderPublicKey: string - Sender public key (hex)
  • sender: string - Sender account ID (must be totem issuer)
  • feeMTA: string - Transaction fee
  • amountMTA: string - Amount (always "0")
  • signature: string - Transaction signature (hex)
  • signatureHash: string - Signature hash (hex)
  • fullHash: string - Full transaction hash (hex)
  • transaction: string - Transaction ID
  • version: number - Transaction version
  • ecBlockId: string - EC block ID
  • ecBlockHeight: number - EC block height
  • attachment: TotemIncreaseAttachment
  • attachment.totem: string - Totem ID
  • attachment.increasePerShareQNT: string - Increase per share in QNT
  • attachment.height: number - Snapshot block height

Validation:

  • Sender must be totem issuer
  • Totem must be SPLITTABLE type
  • increasePerShareQNT > 0
  • height: 0 to current height - 1
  • Total new supply must not exceed maxQuantityQNT

Error: INCORRECT_TOTEM_QUANTITY if constraints violated

Tags: AE, CREATE_TRANSACTION Notes: Non-dilutive proportional increase. Uses snapshot at specified height. Calculation: Convert.unitRateToAmount(currentBalance, decimals, increasePerShareQNT, decimals)