Farms

Panoptis Farms let you earn PSW rewards by staking LP tokens from the DEX. The boosted farm additionally multiplies your rewards based on your vePSW voting escrow balance, rewarding long-term participants.

Getting Started

What You Need

• LP tokens: Provide liquidity to any Panoptis pool to receive LP tokens.
• PSW tokens (optional): Lock PSW to get vePSW and boost your rewards by up to 2.5×.

Staking LP Tokens

Step 1 — Approve the Farm

Before staking, approve the farm contract to transfer your LP tokens:

lpToken.approve(farmAddress, amount)

Step 2 — Deposit

farm.deposit(pid, amount)

pid is the pool ID for the LP token you want to stake. Depositing also automatically harvests any pending rewards you’ve accrued so far.

Step 3 — Earn Rewards

Rewards start accruing instantly. Your share of rewards per second is:

$\text{reward}_{\text{user}} = \text{rewardPerSecond} \times \frac{\text{pool.allocPoint}}{\text{totalAllocPoint}} \times \frac{\text{yourStake}}{\text{totalStaked}}$

For boosted pools, yourStake is replaced by your boosted amount (see below).

Step 4 — Harvest

farm.harvest(pid, receiver)

Harvests pending rewards without changing your staked amount. You can harvest at any time.

Step 5 — Withdraw

farm.withdraw(pid, amount)

Unstakes your LP tokens and simultaneously harvests pending rewards.

Emergency Withdrawal

farm.emergencyWithdraw(pid, receiver)

Returns your staked LP tokens immediately, forfeiting all pending rewards. Use only in exceptional circumstances.

Boosted Farming (vePSW)

The PanoptisFarmV2Boosted contract multiplies your reward weight based on your vePSW balance. Maximum boost is 2.5× (configurable per pool).

How Your Boost Is Calculated

The BoostController computes your boost every time you interact with the boosted farm:

$\text{requiredVe} = \frac{\text{yourLP} \times \text{vePerLp}}{10^{18}}$

$\text{boost} = 1\times + (2.5\times - 1\times) \times \min\!\left(1, \frac{\text{yourVePSW}}{\text{requiredVe}}\right)$

• At zero vePSW you receive 1× (base rewards).
• At requiredVe or more vePSW you receive the maximum boost (up to 2.5×).
• Between those points your boost scales linearly.

Refreshing Your Boost

Your boost is recalculated automatically on every deposit, withdrawal, and harvest. You can also force a refresh without changing your position:

farm.refreshBoost(pid, user)

This is useful after locking more PSW or extending your lock — the farm won’t pick up the increased vePSW balance until a refresh.

Locking PSW for vePSW

To participate in boosted farming and governance, lock PSW tokens in the VePSW contract.

Create a Lock

vePSW.createLock(amount, unlockTime)

• unlockTime must be between 7 days and 4 years from now.
• Unlock times are rounded to the nearest Thursday (weekly boundary).

Increase Your Lock

Add more PSW to your existing lock:

vePSW.increaseAmount(additionalAmount)

Extend your lock duration:

vePSW.increaseUnlockTime(newUnlockTime)

You cannot shorten an existing lock.

Voting Power Decay

Your vePSW balance decays linearly as you approach your unlock date:

$\text{vePSW}(t) = \text{lockedPSW} \times \frac{t_{\text{unlock}} - t_{\text{now}}}{\text{4 years}}$

A lock of 100 PSW for the full 4 years starts with 100 vePSW and decreases to 0 at expiry. To maintain boost levels, extend your lock periodically.

Withdraw After Expiry

vePSW.withdraw()

After the unlock date, your full PSW amount is returned. No penalties.

Reward Rates and Pool Weights

Each farm pool has an allocation point weight. The proportion of total global rewards flowing to a pool is:

$\text{pool share} = \frac{\text{pool.allocPoint}}{\text{sum of all allocPoints}}$

Governance adjusts allocation points to direct incentives. You can view current pool configurations by reading poolInfo(pid) from the farm contract.

Emission Schedule

Farm rewards are funded from the treasury via the EmissionManager contract, which enforces an epoch cap on how many tokens can be sent per period. This prevents sudden large emissions that would spike circulating supply. Rates therefore increase gradually and predictably.

Buyback and Burn

A portion of protocol revenue is used to buy back PSW on the open market and permanently burn it. This creates deflationary pressure proportional to protocol activity, benefiting long-term holders and stakers.

Key Contract Functions Reference

Farm / Boosted Farm

VePSW

BoostController