share-allocation-fairness

Analyze fairness vulnerabilities in Sui share allocation mechanisms.

276|56|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/PlamenTSV/plamen --skill share-allocation-fairness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: share-allocation-fairness
Source: https://github.com/PlamenTSV/plamen/tree/main/agents/skills/sui/share-allocation-fairness
Command: npx skills add https://github.com/PlamenTSV/plamen --skill share-allocation-fairness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes fairness of share allocation mechanisms in Sui protocols, identifying potential timing, ordering, and configuration gaps that could allow late entrants to dilute or capture rewards.

Core Features & Use Cases

  • Classify allocation mechanisms (pro-rata, time-weighted, queue-based, epoch-based) in Sui programs using Coin<ShareToken> and Balance<ShareToken>.
  • Model late-entry attacks, time-weighting risks via clock timestamps, and PTB (partial transaction bootstrap) composition across deposits, distributions, and withdrawals.
  • Produce concrete attack sequences, risk assessments, and mitigation recommendations suitable for security audits and design reviews.

Quick Start

Run the analysis against a Sui protocol's allocation logic to generate a detailed findings report.

Frequently Asked Questions about share-allocation-fairness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze share allocation fairness vulnerabilities in Sui Move?

To analyze share allocation fairness in Sui Move, classify the allocation mechanism and model late-entry attacks using Clock timestamps and transaction sequencing to generate a structured security finding. This identifies timing and ordering gaps that allow late entrants to dilute rewards.

What is a late-entry attack in Sui pro-rata share allocation?

A late-entry attack in Sui pro-rata share allocation occurs when users exploit timing and transaction sequencing to enter just before distribution, capturing or diluting rewards without proportional participation. Modeling this requires analyzing Clock timestamps and PTB composition risks.

Can I audit epoch-based and time-weighted share distribution mechanisms in Sui?

Yes, you can audit epoch-based and time-weighted share distribution mechanisms in Sui by applying an attack model that examines Clock timestamps and transaction sequencing. This process evaluates deposits, withdrawals, and configuration changes to detect fairness gaps across allocation types.

How do I model PTB composition risks for Sui share allocation?

Modeling PTB composition risks for Sui share allocation involves evaluating partial transaction bootstrap sequences across deposits, distributions, and withdrawals. By analyzing Move-based logic and transaction sequencing, you can identify how attackers manipulate transaction ordering to unfairly capture shares.

What are the limitations of analyzing Sui share allocation fairness using Move logic?

The analysis focuses strictly on Move-based logic, Clock timestamps, and transaction sequencing within Sui protocols. It may not detect external cross-chain economic exploits or off-chain oracle manipulations that also impact the ultimate fairness of share allocation mechanisms.