As described in the incentives module documentation, Econia is a permissionless system that mitigates denial-of-service (DoS) attacks by charging utility coins for assorted operations.
Econia also charges taker fees, denominated in the quote coin for a given market, which are distributed between integrators and Econia. The share of taker fees distributed between an integrator and Econia, for a given market, is determined by the "tier" to which the integrator has "activated" their fee store: when the matching engine fills a taker order, the integrator who facilitated the transaction has a portion of taker fees deposited to their fee store, and Econia gets the rest, with the split thereof determined by the integrator's fee store tier for the given market.
Econia does not charge maker fees.
Econia involves several major incentive parameters, defined at
- The utility coin type, set to
APTat mainnet genesis and later switched to the Econia coin.
- The fee, denominated in the utility coin, to register a market.
- The fee, denominated in the utility coin, to register an underwriter capability.
- The fee, denominated in the utility coin, to register a custodian capability.
- The taker fee divisor, denoting the portion of quote coins for a particular trade, paid by the taker, to be split between the integrator who facilitated the trade, and Econia. A taker fee divisor of 2000, for instance, implies a flat taker fee, or 5 basis points.
- The portion of the taker fee divisor reserved for an integrator activated to a given tier.
- The cumulative fee, denominated in the utility coin, to activate to the given tier.
- The fee, denominated in the utility coin, to withdraw quote coins from an integrator's fee store. Charged so as to disincentivize excessively-frequent withdrawals and thus potential transaction collisions with the matching engine.
See the assorted incentives module getters for parameter lookup during runtime.
Upon module publication, Econia's incentive parameters will be set to genesis values that are calibrated against the market price of
APT, denominated in US dollars (USD).
Later, the incentive parameters can be tuned to account for variations in market prices.
|Incentive parameter||Genesis value|
|Utility coin type|
|Market registration fee||25 USD|
|Underwriter registration fee||0.01 USD|
|Custodian registration fee||0.01 USD|
|Taker fee divisor (as a %)||2000 (0.05%)|
|Tier||Fee share (%)||Activation fee (USD)||Withdrawal fee (USD)|
For example, consider a hypothetical
by default, an integrator who routes traffic through Econia can collect 0.01% of the 0.05% taker fees collected on the market, but can collect 0.014% if they pay the 40 USD equivalent fee to activate to tier 3.
Hence if they route five million USD of volume through Econia on the given market, at the base tier they will only collect 500
USDC in fees, but if they activate to tier 3 they will collect 700
USDC, paying off the $40 USD equivalent charged for activation and thus profiting $160 for activating to tier 3.
When the matching engine calls
assess_taker_fees(), Econia assesses the flat taker fee defined at
IncentiveParameters, attempts to route a portion to the indicated integrator's
IntegratorFeeStore, then routes the remainder to an
EconiaFeeStore for the market.
Integrators can then withdraw any fees they have collected via
An integrator must register an
IntegratorFeeStore before they can collect any fees, via any of the following:
If they route volume through Econia without first registering an
IntegratorFeeStore, all generated taker fees will go to Econia.