state

Token state (AVAILABLE, PENDING, or SPENT).

  • AVAILABLE: Can be used for fees, included in balance

  • PENDING: Locked for pending transaction, excluded from balance

  • SPENT: Confirmed spent, excluded from balance

State transitions:

  • New token → AVAILABLE

  • Fee payment created → PENDING

  • Transaction SUCCESS → SPENT

  • Transaction FAILURE → AVAILABLE (unlocked)