[ETHGlobal Feedback] Financial Settlement Patterns Need Documentation

[ReageMeuFilho]

I'm participating in ETHGlobal Buenos Aires 2025 hackathon. I'm new to Web3 and relied on AI tools (Gemini, Manus.ai) to help me understand the concepts, but this is genuine feedback from my implementation experience.

Built a cross-chain payment system (ReageCFO) using LayerZero OApp. The protocol works great, but the docs assume you're building token bridges. Financial settlement is different, and as a new builder, I had to figure a lot out myself.

What I Struggled With

1. Fee calculation for financial txs - How much gas to allocate for _lzReceive when releasing funds? The docs don't explain this. I used 500k but had to guess.

2. Settlement confirmation - I send from Sepolia, vault receives on Base and releases funds. But there's no pattern in docs for "wait for delivery → then release funds" workflows.

3. Preventing double-payments - I implemented processedInvoices mapping to prevent double-spending if a message is retried. This is critical for financial apps but not documented.

4. Message encoding for financial data - I encode (recipient, amount) but had to figure out the right way. Docs only show token transfer examples.

5. Handling failed settlements - What happens if _lzReceive fails? How do you refund? How do you track pending settlements? Not covered in docs.

TL;DR

LayerZero OApp is solid. Just need docs that show financial settlement patterns, not just token bridges. Would save new builders time.