Tax Calculator
Prices the listing tax from floor multiple and duration, with a softening kink above 2.00x floor.
TaxCalculator determines the tax a seller pays to create a listing. The tax is quoted and paid in the collection's ERC-20, prepaid at listing creation, and pro-rata refundable if the listing is later modified or cancelled. It's the mechanism that makes the self-assessed listing model work: overpricing an item is allowed, but the higher the price and the longer the duration, the more tax you pay.
Signatures and descriptions below come from the ITaxCalculator interface.
calculateTax
Calculates the tax required to create a listing from its floor multiple and duration. The function is pure and deterministic.
function calculateTax(address _collection, uint _floorMultiple, uint _duration) external view returns (uint taxRequired_);_collection
address
The collection address of the listing
_floorMultiple
uint
The floor multiple, to two decimals (150 = 1.50x, 200 = 2.00x)
_duration
uint
The duration of the listing, in seconds
taxRequired_
uint
The collection tokens required to list
The fee curve
Tax scales with the square of the floor multiple and linearly with duration, normalised to a 7-day reference. Above a kink at floor multiple 200 (2.00x), the curve softens — halving the effective slope — to encourage high-value "grail" listings rather than penalise them.
For floorMultiple ≤ 200:
For floorMultiple > 200 (the softened branch):
Both branches meet exactly at the FLOOR_MULTIPLE_KINK of 200, so the curve is continuous there.
Worked examples
For a 7-day listing, the tax works out to (in FLOOR / collection-token units, where 1 = one whole token):
1.50x
0.0225 FLOOR
2.00x (kink)
0.04 FLOOR
3.00x
0.0625 FLOOR
4.00x
0.09 FLOOR
10.00x
0.36 FLOOR
Because tax is linear in duration, halving the duration halves the tax, and doubling it doubles the tax. Setting a price far above fair value is possible, but the fee climbs steeply — so a mispriced item simply won't sell, and the prepaid tax bleeds down until the listing closes.
Last updated
Was this helpful?