Transaction fee accounting how-to
How operators configure the transaction-fee-accounting token feature for off-chain settlement of mint, burn, and transfer fees.
Use this how-to when you need to configure and operate the transaction-fee-accounting token feature on an asset. It assumes you have already chosen off-chain settlement and need DALP to record 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.
Configure the feature
In the Asset Designer details step, set:
| 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.
Operate accruals after deployment
After deployment:
- 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 configure the external-transaction-fee token feature to charge fixed fees in a separate ERC-20 asset for mint, burn, and transfer operations.