Transaction fee accounting
How operators configure the transaction-fee-accounting token feature for off-chain settlement of mint, burn, and transfer fees.
The transaction-fee-accounting token feature records the accrued fee for each mint, burn, or transfer operation but does not deduct on chain. The holder receives the full gross amount, the recipient does not receive tokens automatically, and the platform records the accrual for off-chain settlement on the operating team's schedule.
The transaction-fee-accounting feature is mutually exclusive with transaction-fee. Pick accounting when the operating model settles fees through banking flows on a published schedule (ETF distributions, securitised-pool fee accrual); pick transaction-fee when the fee should be collected on chain at the moment of the operation.
For the architecture reference, see Transaction fee accounting.
When it attaches
The ETF template (system-etf) and the asset-backed-token template (system-asset-backed-token) attach transaction-fee-accounting.
What you configure
In the Asset Designer details step, the wizard surfaces:
| Parameter | Description |
|---|---|
mintFeeBps | Recorded mint-fee accrual rate, in basis points. |
burnFeeBps | Recorded burn-fee accrual rate. |
transferFeeBps | Recorded transfer-fee accrual rate. |
recipient | Recipient identity recorded with each accrual entry. The recipient is not transferred to automatically. |
Any rate set to zero suppresses accrual recording for that operation type.
What you operate
After deployment:
- Operations execute at gross — holders receive the full amount, no on-chain fee deduction. Accruals are recorded in the platform's accounting ledger.
- Inspect accrued fees on the asset detail workspace's fee-accounting tab. The tab shows total accrual per operation type and the recipient.
- Settle off chain on the published schedule. The recipient or the administrator transfers value from the operating treasury to the manager outside DALP, using the on-chain accrual record as the reconciliation source.
- Reconcile periodically between the on-chain accrual and off-chain settlement so the two stay in sync.
Operating considerations
- The feature records, it does not transfer. The recipient wallet does not accrue on-chain token balance through this feature.
- Accruals do not expire automatically. The accrual entries stay queryable until the operating team marks them settled.
- Rate changes apply forward. Past accruals stay at the previous rate.
- The fee accrual is per operation, not per period. A holder who transfers ten times in a day records ten accrual entries.
Troubleshooting
| What you see | What to check |
|---|---|
| Recipient wallet shows no incoming tokens | The accounting feature does not transfer. Read the fee-accounting tab to see accruals; settle off chain. |
| Need on-chain collection instead | Use transaction-fee. The two features are mutually exclusive on the same asset. |
| Accrual rate mismatch | Confirm the configured *FeeBps values and the platform accrual frequency match the operating-team approval. |
Read next
- Transaction fee accounting architecture
- Transaction fee — the on-chain-collection variant.
- Feature constraints
Transaction fee
How operators configure the transaction-fee token feature for on-chain fee collection on mint, burn, and transfer operations.
External transaction fee
How operators configure the external-transaction-fee token feature to charge fixed fees in a separate ERC-20 asset for mint, burn, and transfer operations.