Skip to main content

IssueTotem

Creates a new totem on the blockchain. This is a transaction creation endpoint.

Endpoint: POST /nxt?requestType=IssueTotem

Parameters:

  • name (string, required): Totem name. Must be 3-40 characters, lowercase alphanumeric only
  • description (string, optional): Totem description. Max 1000 characters
  • type (int, optional): Totem type bitmask. Can also use individual type flags (non_fungible=1, non_splittable=1, splittable=1)
  • quantityQNT (long, required): Initial quantity in Quantum Units
  • maxQuantityQNT (long, required): Maximum quantity in Quantum Units. Must be >= quantityQNT
  • decimals (byte, optional, default: 0): Number of decimal places (0-8)
  • secretPhrase (string, required): Sender account secret phrase
  • 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=IssueTotem&name=MyTotem&description=My+first+totem&quantityQNT=100000000&maxQuantityQNT=1000000000&decimals=8&secretPhrase=mySecret

Response:

{
  "type": 2,
  "subtype": 0,
  "chain": 1,
  "phased": false,
  "timestamp": 123456789,
  "deadline": 123457789,
  "senderPublicKey": "abc123...",
  "sender": "111111111",
  "feeMTA": "1000000",
  "signature": "def456...",
  "signatureHash": "ghi789...",
  "fullHash": "jkl012...",
  "transaction": "1234567890",
  "version": 1,
  "ecBlockId": "123456",
  "ecBlockHeight": 123456,
  "attachment": {
    "version.TotemIssuance": 1,
    "name": "MyTotem",
    "description": "My first totem",
    "type": 0,
    "quantityQNT": "100000000",
    "maxQuantityQNT": "1000000000",
    "decimals": 8
  }
}

Response Fields:

  • type: number (2) - Transaction type (Asset Exchange)
  • subtype: number (0) - TOTEM_ISSUANCE
  • 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
  • feeMTA: string - Transaction fee
  • 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: object - TotemIssuanceAttachment data
  • attachment.version.TotemIssuance: number
  • attachment.name: string
  • attachment.description: string
  • attachment.type: number - Type bitmask
  • attachment.quantityQNT: string
  • attachment.maxQuantityQNT: string
  • attachment.decimals: number

Validation:

  • name: 3-40 chars, lowercase alphanumeric
  • description: max 1000 chars
  • decimals: 0-8
  • maxQuantityQNT >= quantityQNT
  • type: 1=NON_FUNGIBLE, 2=NON_SPLITTABLE, 4=SPLITTABLE

Tags: AE, CREATE_TRANSACTION