Glossary
Comprehensive terminology for the XPower Banq protocol suite — the consolidated References & Glossary paper ported into web form. Entries marked with a dagger (†) are specific to the bad-debt risk analysis in the simulations paper.
Where a term names a governable parameter, contract, or feature, the entry links out to its dedicated page rather than restating values. Numeric ranges and per-cycle bounds live in Parameters and the governance parameter catalog.
A
Accrual. The periodic update of the global index to reflect newly earned interest. In the multiplicative form, accrual multiplies the index by
Accrual Path. The code path executed during a reindex event. Also called the write path, since it mutates the stored index.
Acma. Access manager — wrapper around OpenZeppelin's AccessManager; manages three-tier roles per capability — the bare function-caller role (e.g. SET_TARGET), its _ADMIN (grants/revokes the caller role), and its _GUARD (emergency revoke). Role IDs are derived via keccak256 of the role name and a domain string in the Roles library. See role hierarchy and architecture overview.
Annualised Rate (
PowLimited(1 hours) in Oracle, this is a 12-hour half-life). Stored on-chain as the DECAY parameter.
AMM. Automated Market Maker — decentralized exchange architecture using liquidity pools and mathematical formulas for price discovery.
APY Differential. Difference in annual percentage yield between locked and unlocked positions; with spread
Asymptotic Transition. Parameter change mechanism where values approach targets gradually via time-weighted mean rather than discrete jumps. See lethargic governance and transition curves.
B
Bad Debt. Uncollectable debt arising when a position's collateral value falls below its debt value; protocol absorbs the loss. See bad debt scenarios and the simulations paper.
Bitmap. 16-bit mask tracking which slots contain active locks. Stored in the lower 16 bits of cache. See ring-lock.
Beta Cap. Position limit following
Bid/Ask. Price quotes for selling (bid) vs. buying (ask) an asset; spread provides manipulation resistance.
Block Stuffing. Attack filling blocks with transactions to delay or censor others; prevented by PoW requirements.
Breakeven Period. Minimum holding period
Borrow Position. ERC20 token representing debt obligation; uses inverted transfer semantics where transfer pulls debt. See positions as tokens and ERC20 semantics.
Borrow Rate. The interest rate charged to borrowers, computed as
Break-Even Ratio (
C
Calculator. Library providing overflow-safe LOG2_ONE private constant, scaled uint256 values and UD60x18 fixed-point representation in the paired functions Log2() / Exp2().
Cap Floor. Minimum position cap ensuring users can enter even when
Capital Efficiency. Borrowing power per unit of collateral; higher LTV ratios provide greater capital efficiency.
Cascade Amplification. Ratio of actual liquidations to initial shock-induced liquidations; measures feedback loop severity. See bad debt risk.
Cascade Attenuation. Reduction of liquidation-cascade depth by factor
Circuit Breaker. Mechanism halting cascading failures; locked positions act as circuit breakers during market stress.
Cold Start. Problem where the first depositor faces zero or minimal cap due to
Collateral. Assets deposited to back borrowed positions; must exceed borrow value by the over-collateralization ratio.
Compounding Index. A global accumulator tracking cumulative interest. Multiplicative form:
Conservation. The invariant that totalOf(u)
Constant Product. AMM pricing formula (
Coordination Game. Strategic interaction where player payoffs depend on aggregate choices; lock adoption exhibits coordination dynamics where seniority value decreases as adoption increases. See the theory paper.
D
Debt Assumption. Liquidation model where the liquidator assumes the victim's debt rather than repaying it; enables capital-efficient liquidation without requiring liquid capital. See debt-assumption liquidation overview.
Decay Factor. EMA smoothing parameter DECAY parameter; controls how quickly older price observations lose influence. See oracle parameters and half-life.
Depth (
Depth Identity. The algebraic identity
Difficulty. PoW puzzle hardness parameter; governance-adjustable per operation type to tune spam resistance. See PoW-gated public mode.
Dual Approval. Transfer model requiring approval from both sender and receiver; used for borrow position transfers. See ERC20 semantics.
Dust Extraction. A theoretical attack exploiting rounding errors to extract small token amounts. Bounded at totalOf query in the log-space form.
E
E-fold. One unit of natural-logarithmic growth; a factor of
Enlisting. Governance-approved process to add new tokens to a pool; subject to time delays for existing feed modifications. The relevant role is POOL_ENLIST_ROLE (with companion admin/guard).
EMA. Exponential Moving Average — smoothing technique giving exponentially decreasing weight to older observations. Applied in log-space for the TWAP oracle.
Entry Fee. Deposit fee charged when supplying assets to a vault; accrues to existing depositors. The on-chain FEE_ENTRY parameter — see vault parameters.
Epoch. Absolute quarter index
ERC20. Ethereum token standard defining transfer, approve, and balance interfaces; basis for position tokens. See ERC20 semantics.
ERC4626. Tokenized vault standard extending ERC20 with deposit/withdraw mechanics; basis for the XPower Banq Vault. See ERC4626 vaults. Position tokens themselves are ERC20Permit, not ERC4626.
Exit Fee. Withdrawal fee charged when redeeming assets from a vault; discourages short-term liquidity cycling. The on-chain FEE_EXIT parameter — see vault parameters.
F
Fixed Token List. Architecture requiring predetermined token sets per pool; ensures predictable collateral requirements.
Flash Loan. Uncollateralized loan that must be repaid within the same transaction.
Formal Verification. Mathematical proof of smart contract correctness; provides stronger guarantees than testing alone. See audits and reviews for current status.
Front-running. Inserting a transaction before a known pending transaction to profit from its price impact.
G
Gas. Ethereum transaction execution cost; measured in gas units multiplied by gas price. See gas costs.
Geomean Spread. Bidirectional geometric mean of relative spreads from forward and reverse AMM queries; stored in log-space as
Governance Cycle. Single parameter change period with minimum duration (e.g., monthly); bounds rate of protocol changes. See parameter bounds.
Growth Factor. The ratio
H
Half-Life. Time for EMA weight to decay to 50%; determines TWAP responsiveness to new price observations.
Hash Rate. Computational power for PoW puzzle solving, measured in hashes per second; determines solve time.
Health Check. Validation performed after operations ensuring health factor
Health Factor. Ratio of weighted supply value to weighted borrow value:
Holder-Count Scaling. Sybil resistance mechanism using the
Holder Floor. Governable lower bound on the effective holder count used in the cap divisor; largeHolders() Constant.MIN_HOLDERS = MIN_HOLDERS.
I
Index. Logarithmic accumulated-rate index stored in WAD (18 decimals) inside the packed state word; per-user balance growth is
Initial Lock Period. Mandatory delay before first parameter change after deployment; prevents immediate manipulation. See change-rate constraints.
Integrator. Library computing Parameterized base contract to implement asymptotic parameter transitions in lethargic governance.
Interest Rate Model. Utilization-based formula determining borrow/supply APY; slope increases sharply above the kink. Formalized in the theory paper. See interest rates.
Inverted Transfer. Borrow position transfer semantics where transfer(from, amount) pulls debt FROM the first parameter rather than pushing to it. See ERC20 semantics and transferring positions.
Iteration Cap. Maximum capacity gain per governance-defined period (e.g., per week); bounds accumulation rate. See how caps grow.
K
Kink. Utilization threshold (e.g., 90%) where interest rate slope increases; incentivizes liquidity retention. See interest rates.
L
Lambda (
Large Holder. Account holding
Leading Zeros. PoW validation metric counting zero nibbles at start of hash; determines if difficulty threshold is met. See PoW-gated public mode.
Lethargic Governance. Governance model with time-delayed, bounded parameter transitions. Values approach targets asymptotically, bounded to
Liquidation. Forced closure of an unhealthy position (
Liquidation Cascade. Destructive feedback loop where forced sales depress prices, triggering further liquidations. Modeled in the simulations paper.
Liquidation Seniority. Priority in liquidation order; locked positions gain de facto seniority because liquidators prefer unlocked positions for immediate liquidity.
Liquidation-Recovery Haircut (
Liquidity Buffer. Reserve of unutilized assets available for withdrawals; maintained via optimal utilization targeting.
Lock Adoption. Aggregate fraction
Lock Bonus. Additional interest earned by locked suppliers; percentage of interest accrued, bounded by spread. The on-chain LOCK_BONUS parameter — see position parameters and bonus and malus.
Lock Depth. The weighted sum
Lock Malus. Interest reduction for locked borrowers; percentage of interest owed, bounded by spread. The on-chain LOCK_MALUS parameter — see position parameters and bonus and malus.
Lock Ratio (
Lock Yield. The rate depth LOCK_TIMELOCK_TIME is the maximum lock horizon in seconds (16 quarterly slots = 48 months Lock library).
LOCK_TERM (
LOCK_TIME (
Log-Normal Distribution. Statistical distribution where logarithm is normally distributed; used to model position sizes in simulations.
Log-Space Index (uint256. Initialised to 0. Grows linearly (additively). See log-space index paper.
Log-Space Oracle. Oracle architecture storing prices as
Log-Sum-Exp. The numerical identity
LTV. Loan-to-Value ratio — maximum borrowing power as fraction of collateral value. Not a stored on-chain parameter; derived from the supply/borrow weights as
M
Market Depth. Total volume that can be traded before significantly moving price; inverse of market impact coefficient.
Market Impact. Price change from selling assets; coefficient
Market Impact Coefficient. Constant
Memory Decay. Weight
Mempool. Transaction waiting area before block inclusion; PoW prevents flooding attacks against mempool.
Merton Jump-Diffusion. Asset-price model with continuous Brownian motion plus a Poisson-driven jump component; basis for the Monte Carlo bad-debt simulation. See Merton 1976.
MEV. Maximal Extractable Value — profit available from transaction ordering, insertion, or censorship.
Modular Arithmetic. Solidity's unchecked arithmetic where values wrap at
Monotonicity. The property that
Monte Carlo Simulation. Randomized numerical method using many simulated paths to estimate statistical distributions; used for bad-debt risk quantification and TWAP analysis.
Multiplicative Bounds. Constraint limiting parameter changes to
Multiplicative Index (
N
Nash Equilibrium. Stable strategic state where no player can improve their payoff by unilaterally changing strategy; lock adoption exhibits utilization-dependent equilibria. Analyzed in the theory paper.
Nonce. Random value in PoW puzzle; combined with transaction data must hash below difficulty target.
O
Observation Window. Time available for detecting suspicious activity during gradual capacity accumulation; enabled by iteration caps.
Optimal Utilization. Target utilization UTIL parameter — see position parameters.
Oracle Aggregation. Combining prices from multiple feeds (TraderJoe, Chainlink) using log-space EMA smoothing with bidirectional geomean spread computation.
Overflow Horizon. The time until a stored value exceeds
Over-collateralization. Requirement that collateral value exceed borrow value; enforced via health factor
P
Partial Liquidation. Liquidation of partial_exp argument to liquidate() — see pool parameters and how liquidations work.
Permanent Lock. Irrevocable lock with dt_term cache (cache.perma), not in a ring slot. Contributes
Phantom-healthy †. A position state where the oracle reports
Pool. Main lending/borrowing contract managing supply, borrow, settle, and redeem operations with health checks. See architecture overview and contract addresses.
Pool-to-Depth Ratio. Pool size as fraction of market depth; determines cascade severity under price shocks.
Position Lock. Fraction
Position Transfer. Movement of supply or borrow position tokens between accounts. Supply uses standard ERC20 push; borrow uses inverted pull semantics. See transferring positions.
PoW. Proof-of-Work — computational puzzle required for certain operations to prevent spam. See PoW-gated public mode.
PRBMath. A Solidity library providing fixed-point exp(), ln(), mul(), and related functions at WAD (exp() function reverts when its input exceeds
Price Feed. External data source providing asset prices; XPower Banq supports TraderJoe and Chainlink feeds.
Price Shock. Sudden price change used to test TWAP responsiveness; EMA smoothing dampens shock impact based on half-life configuration.
Principal. Base position amount before interest accrual; multiplied by index ratio to get current balance.
Protocol Margin. Revenue retained by protocol from interest spread;
Protocol Parameters. Governable constants (weights, decay, spread, rates, caps) that control protocol behavior; each transitions lethargically. See parameter catalog for a one-stop list and the per-contract pages under Parameters.
Q
Quote / TWAP packed word. Log-space price representation packed into a uint256 word with four fields: mid (LOG2_ONE), rel (utc (timestamp), and dec (decimal-pair packed as (dec_source << 8) | dec_target for unit normalisation). The containing struct is TWAP { uint256 last; uint256 mean; } with two such words per pair: last for the most recent observation and mean for the EWMA running mean. Replaces linear bid/ask pairs with a compact log-space encoding suitable for EMA smoothing.
R
Rate Limit. Token-bucket mechanism bounding operation frequency; configured per pool with capacity and regeneration rate. See MAX_SUPPLY / MIN_SUPPLY / MAX_BORROW / MIN_BORROW in pool parameters.
Ray. Fixed-point representation with 27 decimal places (Constant library.
Read Path. The code path executed when querying a user's balance via totalOf. In the log-space form, this is where exp() is called.
Reentrancy Guard. Protection preventing a contract from being called recursively during execution; uses transient storage.
Reindex. Interest compounding mechanism that updates the global log-space index and snapshots per-user indices. The functions _reindex and _reindexWith advance the global log-space index; lock bonus/malus is applied per-user via _spreadDiff consumed by the IR model when computing the position rate. Per-user balance growth is
Reserves. Token balances held in AMM liquidity pools; used to calculate bid/ask quotes via constant product formula.
Ring-Lock. Base mechanism: ring buffer + bitmap + cached total. 9 words per user. See ring-buffer locks paper.
Role Guard. Contract restricting which addresses can execute role-gated functions; part of access control system. See role hierarchy.
S
Sandwich Attack. MEV attack bracketing a victim transaction with front-run and back-run to extract value.
Secondary Market Discount. Price reduction
Self-Healing. more() correcting stale slot contributions during overwrite, maintaining total and depth consistency per-slot. Stated as a theorem in the ring-buffer locks paper.
Slippage. Price deviation from executing a trade against AMM reserves; increases with trade size relative to reserves. See spread and slippage.
Solvency Boundary. Parameter constraint ensuring protocol can meet all obligations; default configuration satisfies
Spread. (1) Oracle: bidirectional geomean of relative spreads from both AMM query directions, stored as SPREAD parameter — see position parameters.
Spread Scaling. Logarithmic widening of bid/ask spreads for large positions via
Square. Restricted-access liquidation function executing debt assumption: for a given exponent wnav_supply >= wnav_borrow, equivalently Pool.liquidate(victim, partial_exp), which (after role/PoW checks) calls Pool.square(msg.sender, victim, partial_exp). The square() selector is gated by POOL_SQUARE_ROLE. See debt assumption and partial liquidation.
Staleness. Age of price data from an oracle; stale prices beyond threshold are rejected to prevent exploitation. See oracle staleness.
Supply Position. ERC20 token representing deposited collateral; uses standard transfer semantics. See positions as tokens.
Supply Rate. The interest rate earned by suppliers, computed as
Sybil Attack. Creating multiple accounts to gain unfair advantage; XPower Banq defends against rapid capacity monopolization via holder-count scaling.
Sybil Resistance. Protection against Sybil attacks; in XPower Banq, bounds accumulation rate via holder-count scaling, not equilibrium share.
T
Time-lock. Mandatory delay between proposing and executing governance parameter changes; prevents sudden malicious updates. See proposing changes.
Time-Lock (Lock Extension). Extension of Ring-Lock adding the depth mapping for token-seconds. 10 words per user.
Time-Weighted Mean. Integration technique averaging parameter values over time; enables smooth transitions without discrete jumps. See transition curves.
Token Bucket. Rate limiting mechanism with capacity
Token-Seconds.
Truncation Bias. The systematic negative error introduced by fixed-point truncation (rounding toward zero). In the multiplicative form, this bias compounds over
TVL †. Total Value Locked — the aggregate collateral value in the lending pool. All bad-debt metrics in bad-debt risk are reported as a percentage of TVL.
tx.origin. Transaction originator address included in PoW hash; prevents front-runners from reusing others' solutions. See PoW-gated public mode.
TWAP. Time-Weighted Average Price — price smoothed over time via log-space EMA (geometric mean temporal averaging) to resist manipulation. See TWAP oracle overview.
U
UD60x18. PRBMath's unsigned 60.18-decimal fixed-point type. 60 integer digits and 18 fractional digits, fitting in uint256. Used for exp(), mul(), and ln() operations.
uint256. Solidity's 256-bit unsigned integer type, holding values from 0 to
ULP. Unit in the Last Place — the smallest representable increment at a given precision. At WAD: 1 ULP
User Snapshot (_userIndex[user].
Utilization. Ratio of borrowed assets to supplied assets in a vault; drives interest rates via a piecewise-linear model with a kink at optimal utilization. See interest rates.
V
Vault. ERC4626-compliant custody contract holding deposited assets; tracks utilization for the interest rate model. Distinct from a Position — Position tokens are plain ERC20Permit. See ERC4626 vaults.
W
WAD. Fixed-point representation with 18 decimal places (Constant library.
Weight. Multiplier applied to asset values in health calculations; determines effective LTV. Defaults: WEIGHT_SUPPLY and WEIGHT_BORROW in pool parameters.
Write Path. The code path executed during index accrual (_reindex). In the log-space form, this is a single addition; in the multiplicative form, it calls exp() and mul().
Where to go next
- Bibliography — citations referenced throughout the glossary.
- FAQ — short answers to common questions.
- Comparison table — XPower Banq vs other protocols.
- Parameter catalog — every governable parameter with ranges.