aHYPESeat Contract Interface

Complete API reference for the SeatMarket contract.

Constructor

constructor(
    address hypeToken,
    uint256 _maxSeats,
    uint256 _minFeePerSecond,
    uint256 _maxFeePerSecond,
    address _feeRecipient,
    uint256 _burnBps
)

User Functions

purchaseSeat

Deposit collateral and occupy a seat.

function purchaseSeat(uint256 deposit) external nonReentrant

• Caller must not already have a seat
• deposit >= minDepositForSeat()
• occupiedSeats < maxSeats
• Caller must have approved contract for deposit amount

• Transfers aHYPE from caller to contract
• Creates new position with hasSeat = true
• Snapshots current cumulativeFeePerSeat
• Adds caller to seatHolders array

Emits: SeatPurchased(address indexed user, uint256 deposit)

addCollateral

Add more collateral to an existing position.

function addCollateral(uint256 amount) external nonReentrant

• Caller must have a seat
• Caller must have approved contract for amount

• Transfers aHYPE from caller to contract
• Increases position.collateral by amount

Emits: CollateralAdded(address indexed user, uint256 amount)

repayFees

Repay accrued fees to reduce debt.

function repayFees(uint256 amount) external nonReentrant

• Caller must have a seat
• amount <= debtValueOf(caller)
• Caller must have approved contract for amount

• Accrues fees to current timestamp
• Transfers aHYPE from caller to contract
• Reduces settledDebt by repayment
• Distributes repayment as fees (burn + recipient)
• Updates fee index snapshot

Emits: FeesRepaid(address indexed user, uint256 amount)

withdrawCollateral

Withdraw excess collateral (must remain healthy).

function withdrawCollateral(uint256 amount) external nonReentrant

• Caller must have a seat
• Position must remain healthy after withdrawal: collateral - amount >= debt

• Accrues fees to current timestamp
• Settles current debt
• Reduces collateral by amount
• Transfers aHYPE to caller

Emits: CollateralWithdrawn(address indexed user, uint256 amount)

exit

Voluntarily exit, settle debt, and receive remaining collateral.

function exit() external nonReentrant

• Caller must have a seat

• Accrues fees to current timestamp
• Calculates final debt
• If debt <= collateral:
  • Distributes debt as fees
  • Returns collateral - debt to user
• If debt > collateral:
  • Distributes all collateral as fees
  • User receives nothing
• Removes seat and clears position
• Removes from seatHolders array

Emits: FeeDistributed(uint256 toRecipient, uint256 burned)

kick

Liquidate an unhealthy position.

function kick(address user) external nonReentrant

• Target must have a seat
• Target must be unhealthy: debt > collateral

• Accrues fees to current timestamp
• Seizes all collateral
• Distributes collateral as fees (burn + recipient)
• Removes seat and clears position
• Removes from seatHolders array

Emits: SeatKicked(address indexed user, address indexed kicker, uint256 collateralSeized, uint256 debtValue)

View Functions

isActive

Check if user has a healthy seat (for API gating).

function isActive(address user) external view returns (bool)

Returns: true if user has a seat AND collateral >= debt

Use Case: Backend access control systems should call this to verify access.

isHealthy

Check if a position is healthy.

function isHealthy(address user) public view returns (bool)

Returns: true if collateral >= debt

debtValueOf

Get current debt including pending (unaccrued) fees.

function debtValueOf(address user) public view returns (uint256)

Returns: settledDebt + (cumulativeFeePerSeatView() - feeIndexSnapshot)

utilizationWad

Get current utilization rate.

function utilizationWad() public view returns (uint256)

Returns: (occupiedSeats * WAD) / maxSeats

feePerSecond

Get current fee rate per second.

function feePerSecond() public view returns (uint256)

Returns: minFeePerSecond + (maxFeePerSecond - minFeePerSecond) * utilization / WAD

feePerDay

Get current daily fee rate.

function feePerDay() external view returns (uint256)

Returns: feePerSecond() * 86400

feePerYear

Get current annual fee rate.

function feePerYear() external view returns (uint256)

Returns: feePerSecond() * 31536000

minDepositForSeat

Get minimum deposit required for a new seat.

function minDepositForSeat() public view returns (uint256)

Returns: Minimum collateral needed (typically 1 day of maximum fees)

getHealthySeats

Get array of all healthy seat holder addresses.

function getHealthySeats() external view returns (address[] memory)

Returns: Array of addresses with isActive(addr) == true

Note: May be gas-intensive for large seat counts. Use for off-chain queries.

cumulativeFeePerSeatView

Get cumulative fee index including pending accruals.

function cumulativeFeePerSeatView() public view returns (uint256)

Returns: cumulativeFeePerSeat + (feePerSecond() * timeSinceLastAccrual)

positions

Get position data for a user.

function positions(address user) external view returns (Position memory)

struct Position {
    bool hasSeat;
    uint256 collateral;
    uint256 settledDebt;
    uint256 feeIndexSnapshot;
}

Admin Functions

setParams

Update market parameters.

function setParams(
    uint256 _maxSeats,
    uint256 _minFeePerSecond,
    uint256 _maxFeePerSecond,
    address _feeRecipient,
    uint256 _burnBps
) external onlyOwner

• _maxSeats >= occupiedSeats
• _minFeePerSecond <= _maxFeePerSecond
• _burnBps <= 10000
• _feeRecipient != address(0)

Emits: ParamsUpdated(uint256 maxSeats, uint256 minFeePerSecond, uint256 maxFeePerSecond, address feeRecipient, uint256 burnBps)

transferOwnership

Transfer contract ownership.

function transferOwnership(address newOwner) external onlyOwner

• newOwner != address(0)

Error Conditions