Transaction fee accounting how-to
How operators configure the transaction-fee-accounting token feature for off-chain settlement of mint, burn, and transfer fees.
The transaction-fee-accounting feature records fee accruals for each token operation on-chain, supporting settlement outside the platform. Configure it when you have chosen off-chain settlement and need the platform to maintain the accrual trail.
For the canonical product model, event semantics, controls, and risks, read Transaction fee accounting. For route shapes, read the API reference.
When it attaches
The ETF template (system-etf) and the asset-backed-token template (system-asset-backed-token) attach transaction-fee-accounting automatically. No manual feature selection is needed.
Configure the feature
In the Asset Designer details step, set the parameters below. Any rate set to zero suppresses accrual logging for that operation type.
| Parameter | Description |
|---|---|
mintFeeBps | Mint-fee accrual rate logged for each mint, in basis points. |
burnFeeBps | Burn-fee accrual rate logged for each burn. |
transferFeeBps | Transfer-fee accrual rate logged for each transfer. |
recipient | Recipient identity captured with each accrual entry. The recipient is not transferred to automatically. |
Operate accruals after deployment
Once the asset is live, follow this sequence to manage the accrual trail:
- 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 accrual record as the reconciliation source.
- Reconcile periodically between the accrual record and off-chain settlement so the two stay in sync.
- Use transaction-fee instead when the fee should be collected on chain at the moment of the token operation.
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 accounting API reference
- 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 use external-transaction-fee to keep fee costs in a separate ERC-20 asset, so the operated asset's balance is never reduced by the fee collection.