Positions

Every Create or Stake made through Easy Mode is recorded as a position — a lightweight on-chain record that tracks what you did, when, and with what input.

Position data

Each position stores:

Field
Description

owner

The wallet that initiated the position.

stakeIndex

The index in the underlying PlazmCreateAndStake stake array.

kind

Create or Stake.

termDays

The chosen duration (1 – 77 days).

active

Whether the position is still running (flipped to false on claim or compound).

inputToken

The original token you sent in (address(0) for ETH).

inputAmount

How much of that token was consumed (net of refunds).

Querying positions

  • Single positionpositionView(positionId) returns the position data plus a full snapshot of the underlying stake (principal, shares, rewards, penalties, etc.).

  • Multiple positionsgetPositions(uint256[] ids) returns an array of position views in one call.

  • By owner (paginated)positionsOfUser(address, cursor, limit, includeInactive) lets you page through all positions belonging to a wallet. Set includeInactive to false to see only open positions.

Referrals

If a referral registry and forwarder are configured, Easy Mode automatically resolves and records referrer relationships. Referral rewards are flushed on every Create, Stake, or Compound — no extra steps needed on your part.

Last updated