Documentation

Latest fair-20 documentation

Concept

Fair-20 is a novel standard, designed to integrate the equitable distribution principles of inscriptions with the Ethereum Virtual Machine (EVM) ecosystem. This integration aims to introduce liquidity through Wrapped ERC20 tokens, making them compatible with existing DeFi platforms.

1. Fair Distribution: Contrasting with the instant decision-making of bots in meme token launches, Fair-20 offers a genuinely fair and economical way of token distribution.

2. Accessibility for All: VC-backed tokens often come with high entry barriers in secondary markets. Fair-20, through inscriptions, democratizes the distribution process.

3. Integration with EVM: By wrapping inscriptions into ERC20, Fair-20 leverages the security and transparency of the EVM ecosystem, augmenting liquidity.

Key Functions

1. Deploy: Initialize Fair-20 tokens with specific parameters.

2. Mint: Generate Fair-20 tokens to be distributed to users.

3. Transfer: Facilitate the movement of Fair-20 tokens between wallets.

State Management

1. Deployments: Serve as the initialization step for Fair-20 tokens but do not alter the state.

2. Mints: Assign tokens to the initial owner of the mint function, marking the beginning of its state.

3. Transfers: Adjust balances by deducting from the sender and crediting the receiver.

Notes

1. Ticker Uniqueness: Initial deployment of a ticker secures its exclusivity within the Fair-20 ecosystem, preventing any duplications.

2. Event Prioritization: For concurrent events, the order of processing is determined by their confirmation sequence in a block, ensuring a systematic and fair transaction sequence.

3. Fair Distribution Approach: The 'first come, first served' policy, particularly in public minting, upholds equitable access and distribution.

4. State Changes: Balances are adjusted solely through the mint and transfer functions, ensuring controlled and transparent token movements.

5. Minting Oversubscription Protocol: If a mint request exceeds the maximum supply, only a proportionate amount is minted. Example: A request to mint 1,000 tokens with a total supply nearing the 21,000,000 cap will result in only 758 tokens being minted.

6. Decimal Consistency: All Fair-20 tokens adhere to a uniform decimal precision of 18 for standardization.

7. Data Type Restrictions: Transactions and balances within Fair-20 conform to a uint128 limitation for efficiency and range balance.

8. Maximum Supply Limit: The upper limit for any token’s supply is governed by the uint64_max, preventing overgeneration of tokens.

9. Lower-case Formatting: All elements, including tickers and operational codes, are to be in lower-case to avoid inconsistencies.

10. Self-Transferred Deployments and Minting: Deployment and mint transactions require the sender and receiver addresses to be identical, empowering the initiator with initial control over new tokens.

11. Exclusion of Internal Contract Calls: The standard disallows batch minting and other internal contract call-based mintings, favoring direct transaction methods.

12. Transfer Function Mechanics: During a transfer, the sender's balance is decreased, and the receiver's balance is correspondingly increased. This ensures a clear transfer of token ownership and balance adjustment, maintaining the integrity of the transaction process.

Operations

Deploy fair-20

data:,{"p":"fair-20","op":"deploy","tick":"fair","max":"10000000000","lim":"1000"}

Key	Required?	Description
p	Yes	Protocol: Helps other systems identify and process fair-20 events
op	Yes	Operation: Type of event
tick	Yes	Ticker: 4 letter identifier of the fair-20
max	Yes	Max supply: set max supply of the fair-20
lim	Yes	Mint limit: If letting users mint to themselves, limit per transaction

Mint fair-20

data:,{"p":"fair-20","op":"mint","tick":"fair","amt":"1000"}

Key	Required?	Description
p	Yes	Protocol: Helps other systems identify and process fair-20 events
op	Yes	Operation: Type of event
tick	Yes	Ticker: 4 letter identifier of the fair-20
amt	Yes	Amount to mint: States the amount of the fair-20 to mint. mint Has to be less than "lim" above if stated

Transfer fair-20

data:,{"p":"fair-20","op":"transfer","tick":"fair","amt":"100"}

Key	Required?	Description
p	Yes	Protocol: Helps other systems identify and process fair-20 events
op	Yes	Operation: Type of event
tick	Yes	Ticker: 4 letter identifier of the fair-20
amt	Yes	Amount to transfer: States the amount of the fair-20 to transfer.