Skip to content

Feature/stellar horizon path payment claim#190

Merged
JerryIdoko merged 2 commits intoVesting-Vault:mainfrom
Great-2025:feature/stellar-horizon-path-payment-claim
Mar 28, 2026
Merged

Feature/stellar horizon path payment claim#190
JerryIdoko merged 2 commits intoVesting-Vault:mainfrom
Great-2025:feature/stellar-horizon-path-payment-claim

Conversation

@Great-2025
Copy link
Copy Markdown

mplements the Stellar Horizon Path Payment Claim feature that allows users to claim their vesting tokens and instantly swap them for USDC in a single transaction. This "Auto-Exit" feature provides a massive UX improvement for team members who need immediate access to liquid funds for real-world expenses.

Issues Addressed
#146: Implement Stellar_Horizon_Path_Payment_Claim
#93: Auto-Exit feature for instant token-to-USDC conversion
Features Implemented
Core Functionality
configure_path_payment(): Admin function to set up destination asset (USDC), minimum amounts, and swap paths
claim_with_path_payment(): Main user function that claims tokens and executes path payment in one atomic transaction
simulate_path_payment_claim(): Gas-free simulation to preview expected amounts and execution feasibility
disable_path_payment(): Admin function to disable the feature when needed
Smart Contract Integration
Seamless integration with existing vesting vault infrastructure
Maintains compatibility with regular claim functionality
Respects emergency pause and other security measures
Proper event emission for indexing and frontend integration
Advanced Features
Custom Swap Paths: Support for multi-hop token swaps (Token → Asset1 → Asset2 → USDC)
Minimum Amount Protection: Users can set minimum destination amounts to prevent slippage
Fallback to Config: If no custom minimum provided, uses admin-configured default
Comprehensive Error Handling: Clear error messages for all failure scenarios
closes #146

- Add PathPaymentConfig, PathPaymentClaimEvent, and PathPaymentSimulation types
- Implement configure_path_payment() for admin setup of auto-exit feature
- Add claim_with_path_payment() for instant token-to-USDC swaps in one transaction
- Include simulate_path_payment_claim() for gas-free dry-run simulation
- Add comprehensive test suite covering all path payment scenarios
- Integrate with existing vesting vault infrastructure
- Support custom swap paths and minimum destination amounts
- Include proper error handling and event emission

Resolves Vesting-Vault#146 and Vesting-Vault#93
@drips-wave
Copy link
Copy Markdown

drips-wave bot commented Mar 27, 2026

@Great-2025 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@JerryIdoko JerryIdoko merged commit db9a82f into Vesting-Vault:main Mar 28, 2026
1 check failed
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.

#93. Implement Stellar_Horizon_Path_Payment_Claim

3 participants