User Roles and Protocol Interactions

The SecondSwap protocol defines three primary user roles, each with distinct capabilities and interactions with the smart contract system. Below is a description of each role and their interaction patterns.

2.1 SecondSwap Admin

The SecondSwap Admin represents the protocol administrators who manage global platform settings and emergency controls.

Capabilities:

• Configure global marketplace parameters

• Manage supported payment tokens

• Control platform-wide emergency functions

• Set default fee structures

Interaction Flow:

1. Platform Management

   • Set global buyer and seller fee rates

   • Add or remove supported payment tokens

   • Adjust minimum listing durations

   • Configure referral reward rates

2. Emergency Controls

   • Freeze/unfreeze marketplace activities

   • Update critical contract addresses

   • Manage penalty fees for early unlisting

   • Override listing parameters in emergencies

Constraints

• Cannot modify individual vesting schedules

• Must operate within protocol design limits

2.3 Vesting Holder

Vesting Holders are the initial recipients of vesting tokens, typically early investors or team members. They can both sell their original vesting positions and participate as secondary market traders by purchasing additional positions.

Capabilities:

• Claim vested tokens according to schedule

• List vesting positions for sale

• Transfer vesting rights (partial or full)

• Participate in secondary market trading

Interaction Flow:

1. Vesting Management

   • View vesting schedule and claimable amounts

   • Claim released tokens at each vesting step

   • Monitor vesting position value

2. Secondary Market Participation

   • List vesting positions with custom parameters

     • Set price and minimum purchase amount

     • Configure discount mechanisms

     • Enable private sale restrictions

   • Transfer vesting rights to other addresses

   • Manage multiple vesting positions

Constraints:

• Cannot exceed maximum sell percentage

• Must maintain original vesting schedule

• Subject to minimum listing duration

2.4 Secondary Market Trader

Secondary Market Traders are participants who enter the ecosystem by purchasing vesting positions. Unlike initial Vesting Holders, they must first acquire positions through purchases.

Capabilities:

• Purchase listed vesting positions

• Manage acquired vesting schedules

• Participate in subsequent trading

• Claim vested tokens from acquired positions

Interaction Flow:

1. Position Acquisition

   • Browse available vesting listings

   • Verify vesting parameters and schedules

   • Execute purchases with specified amounts

   • Complete whitelist verification if required

2. Position Management

   • Monitor acquired vesting schedules

   • Claim vested tokens when available

   • Optionally relist positions

   • Track investment performance

Constraints:

• Must respect whitelist restrictions

• Cannot modify vesting parameters

• Subject to protocol fees and rules

This role-based system ensures proper segregation of responsibilities while maintaining flexibility for all participants to interact with the protocol according to their needs and permissions.