Feature: Implement Sponsored Stellar Account Funding

[3m1n3nc3]

Description

Fund the provisioned Stellar account minimum through a controlled source with durable transaction state.

File Location

Funding service/job, Stellar adapter/config, transaction records, and tests

Design Reference

API Roadmap Phase 1: Implement Sponsored Stellar Account Funding.

Dependencies

• Status: Blocked
• Blocked by: Feature: Implement Idempotent Stellar Wallet Provisioning; Feature: Add Transaction Outbox and Job Delivery Foundation
• Blocks: Feature: Add Wallet Status Balance and History API; integration suite

Tasks

• Define network funding policy, amount, source, caps, and eligibility
• Persist attempt, idempotency, hash, ledger, error, retry, and finality
• Submit without exposing funding secret
• Detect already-funded accounts
• Handle retry, review, insufficient funds, and provider outage
• Test duplicates, timeout-after-submit, confirmation, and reconciliation

Acceptance Criteria

• Retries cannot double fund
• Final hash/ledger is queryable
• Limits and low balance are explicit
• No funding secret leaks
• Tests pass

Verification Evidence

• Attach mocked Horizon tests and redacted testnet proof when available

Difficulty

Advanced

[shepherd-001]

Hello, I have reviewed the issue and am confident in my ability to resolve it. Please assign this task to me.

[afeezorobsco-cyber]

i would like to work on this issue

[grantfox-oss]

🦊 GrantFox — @afeezorobsco-cyber has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #91)
2. Your PR will be reviewed by the learnault maintainers

Good luck! Track your progress on GrantFox.