Examples

Practical examples for interacting with STON.fi v2 smart contracts.

Available Examples

Swap Examples

  • Basic token swaps

  • Multi-hop swaps

  • Slippage protection

  • Custom routes

LP Provide Examples

  • Balanced liquidity provision

  • Single-sided liquidity

  • Optimal amounts calculation

  • Gas optimization

Vault Examples

  • Fee collection

  • Vault withdrawals

  • Permission management

  • Batch operations

Usage Guidelines

Best Practices

  1. Always simulate transactions first

  2. Use appropriate gas limits

  3. Handle all error cases

  4. Validate inputs thoroughly

Common Patterns

;; Check minimum output
throw_unless(error::insufficient_output, 
    output_amount >= min_output);

;; Validate addresses
throw_unless(error::invalid_address, 
    equal_slices(sender, expected_sender));

;; Handle timeouts
throw_if(error::expired, 
    now() > deadline);

Testing

  • Use testnet for development

  • Test edge cases thoroughly

  • Monitor gas consumption

  • Verify state changes

Integration Tips

  1. Start Simple: Begin with basic examples

  2. Add Complexity: Gradually add features

  3. Error Handling: Implement comprehensive error handling

  4. Gas Optimization: Profile and optimize gas usage

  5. Security: Follow security best practices

Need Help?

PreviousVaultNextSwap Examples

Last updated