TokenEntry

object type

One platform token-ledger fact. The wallet's balance = Σ these rows' signed amounts EXACTLY — cached in the SAME transaction as every append (ruling: the ledger never lies — drawdowns record IN FULL and the balance may transiently dip below zero; the floor is the exhaustion CASCADE, never entry-clamping).

Fields

Field	Type	Notes
`id`	ID `ID!`	No further notes.
`type`	String `String!`	No further notes.
`caption`	String `String!`	No further notes.
`status`	String `String!`	active (a posted fact) — the void lane is FSM data with NO wire op (corrections are authority adjustment entries).
`parentId`	ID `ID!`	The owning TokenAccount.
`rootId`	ID `ID!`	The org-group family root.
`createdAt`	String `String!`	No further notes.
`updatedAt`	String `String!`	No further notes.
`revisionNum`	Int `Int!`	No further notes.
`revision`	ID `ID!`	No further notes.
`entryKind`	String `String!`	purchase \| plan_included \| grant \| drawdown \| transfer \| adjustment (the registry roster VERBATIM — NO refund, NO expiry; plan_included = the monthly fee's beyond-overhead share auto-credited at settle — banks forever, fungible with purchases).
`amountTokens`	Int `Int!`	The SIGNED integer token amount — the sign IS the flow direction (purchase/grant +, drawdown −, transfer ±, adjustment ±).
`reason`	String	The reason text — always present on grant/adjustment (root money moves say why); optional narration otherwise.
`tokenPurchaseId`	ID	The settled TokenPurchase.
`billingChargeId`	ID	The BillingCharge whose settle minted this credit.
`transferCounterpartRootId`	ID	The transfer counterpart's org group.
`transferCounterpartEntryId`	ID	The transfer counterpart's entry (the sum-conserving pair cross-reference — transfer entries only).
`drawdownLines`	TokenDrawdownLine `[TokenDrawdownLine!]`	The per-(event × dimension) itemization (drawdown entries only — the transparency law; ruling: each line names ITS usage event).
`carriedInMicroTokens`	Int	The µtoken accrual carried INTO this entry from prior sub-token usage.
`carriedOutMicroTokens`	Int	The µtoken remainder carried OUT to the wallet's microTokenCarry after this entry materialized.
`rateCardVersion`	Int	The rate card that priced this entry.