Skip to content

feat: add Stable2LUT2 (A=50) and comprehensive stableswap documentation#5

Open
phessophissy wants to merge 1 commit intopinto-org:masterfrom
phessophissy:feat/docs-and-lut-tables
Open

feat: add Stable2LUT2 (A=50) and comprehensive stableswap documentation#5
phessophissy wants to merge 1 commit intopinto-org:masterfrom
phessophissy:feat/docs-and-lut-tables

Conversation

@phessophissy
Copy link

This PR introduces two enhancements:

New Lookup Table: Stable2LUT2 (A=50)

  • New LUT optimized for semi-stable token pairs
  • Lower amplification coefficient (A=50 vs A=100)
  • Ideal for:
    • Algorithmic stablecoins with moderate depegging risk
    • Bridged tokens with cross-chain arbitrage delays
    • LSTs vs underlying assets with small price variations
    • Semi-correlated asset pairs

Comprehensive Documentation

  • docs/STABLESWAP.md: Full technical documentation covering:
    • Mathematical foundation of the Stable2 invariant
    • Architecture overview with component relationships
    • LUT system explanation and configuration guide
    • Usage examples for protocol integration
    • Gas optimization strategies
    • Security considerations

Supporting Files

  • Python LUT generation script for reference/future LUT creation
  • Test suite for Stable2LUT2 with unit and fuzz tests

This PR introduces two enhancements:

## New Lookup Table: Stable2LUT2 (A=50)
- New LUT optimized for semi-stable token pairs
- Lower amplification coefficient (A=50 vs A=100)
- Ideal for:
  - Algorithmic stablecoins with moderate depegging risk
  - Bridged tokens with cross-chain arbitrage delays
  - LSTs vs underlying assets with small price variations
  - Semi-correlated asset pairs

## Comprehensive Documentation
- docs/STABLESWAP.md: Full technical documentation covering:
  - Mathematical foundation of the Stable2 invariant
  - Architecture overview with component relationships
  - LUT system explanation and configuration guide
  - Usage examples for protocol integration
  - Gas optimization strategies
  - Security considerations

## Supporting Files
- Python LUT generation script for reference/future LUT creation
- Test suite for Stable2LUT2 with unit and fuzz tests
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant