transaction-fee-accounting

The transaction-fee-accounting token feature records the accrued fee for each mint, burn, or transfer operation without deducting on chain. The platform exposes the accrual ledger for off-chain settlement. It is mutually exclusive with transaction-fee.

For the operator how-to, see Transaction fee accounting how-to. For the architecture model, see Transaction fee accounting architecture.

Configuration during token creation

{
  "transaction-fee-accounting": {
    "mintFeeBps": 50,
    "burnFeeBps": 50,
    "transferFeeBps": 25,
    "recipient": "0x..."
  }
}

Behaviour

The platform records the accrual but does not transfer. Holders receive the full gross amount. Settlement to recipient happens off chain through the operating-team's banking flow, using the accrual ledger as the reconciliation source.

Reading the accrual ledger

GET /api/v2/token/{address}/features/transaction-fee-accounting
GET /api/v2/token/{address}/features/transaction-fee-accounting/entries?since={block}

Returns the running accrual totals and the per-operation entries since a given block.

Marking settled

POST /api/v2/token/{address}/features/transaction-fee-accounting/settle
{
  "entriesUpTo": "0x...",
  "settledAmount": "..."
}

Marks accrual entries as settled. The platform records the off-chain settlement reference for the audit ledger.

Related

• transaction-fee — on-chain-collection variant.
• Feature constraints