docs: address GMP review comments (FOU-1386, FOU-1392)

[srdtrk]

🤖 Gnut (automated assistant posting on behalf of Serdar)

Addresses the 8 inline comments I left in review #1380 (review) on the two GMP pages (FOU-1386, FOU-1392). Based on docs, not main, so it lands as a follow-up on top of #1380's branch.

Two commits, one per page/ticket, so they can be reviewed separately.

#	Comment	What changed
1	gmp.md:46 — payload is opaque, must be encoded for the counterparty GMP impl	Fixed. The payload bullet and the paragraph now say the payload is opaque to GMP and that encoding it for the destination implementation is the sender's job; for IBC-solidity that is an ABI-encoded Solidity call (selector + ABI args) handed to the target verbatim. Split out the packet data encoding (application/x-solidity-abi) into its own paragraph, which the old text conflated with the payload encoding.
2	gmp.md:80 — mostly packet lifecycle; say the relayer pays gas and insufficient gas can be retried	Fixed. Dropped the lifecycle narration (proof verification, router commits and emits the ack) down to the existing /how-ibc-works/packet-lifecycle link, kept the six GMP-specific steps, and added: the relayer delivers and pays, the call runs on whatever gas its transaction leaves, and an attempt that reverts before the packet is received leaves the packet in flight and can be re-delivered with more gas until the timeout. Also moved the gas paragraph out of "What comes back", where it was repeated.
3	ics27-…:36 — flowchart not useful	Cut. Flowchart deleted; the "one account per (clientId, sender, salt)" line it sat above is kept.
4	ics27-…:72 — diagram too complex, split it and box each chain	Fixed. The one 8-participant diagram is now three sequenceDiagrams — send, receive-and-execute, acknowledge — each paired with its own paragraph and using box Chain A … end / box Chain B … end so the chain name is no longer repeated in every participant label.
5, 6	ics27-…:140 — title doesn't say what the section is; ics27-…:160 — not sure this section is needed	Cut. "Packet handlers the router calls" is gone: its handler table restated "How a call moves through the contracts" and its closing paragraph restated "Acknowledgements and sender callbacks". The two things only it said — the three onRecvPacket checks, and that the router alone may call the three handlers — moved up into "How a call moves through the contracts". If you'd rather keep the section under a clearer title, say so and I'll restore it.
7	ics27-…:176 — note that empty salt is allowed	Fixed. Added that an empty salt is allowed and gives the sender one default account per client, which matches what gmp.md already said. sendCall only rejects an empty payload (ICS27PayloadEmpty); salt length is never checked and is hashed as-is into the identifier.
8	ics27-…:247 — "this is actually a bug in ICS27GMP if true"	No doc change — deliberately. Both copies of that paragraph (ics27-gmp-and-accounts.md and gmp.md) are left byte-identical and untouched, pending the answer to the bug question. If the FailedCall / empty-revert-data reasoning is wrong, both need rewriting together. Item 2's new wording is scoped to attempts that fail before the packet is received, so it doesn't contradict either copy whichever way that lands.

Net effect: gmp.md +7/−7, ics27-gmp-and-accounts.md +42/−51 (one flowchart and one ~20-line section gone, one diagram split into three smaller ones).

Two things worth a look:

• box in sequenceDiagram is standard mermaid ≥9.4, but no other page in this docs set uses it, so it hasn't been confirmed against Mintlify's renderer here. If it doesn't render, the fallback is short participant aliases plus a Note over per chain.
• No other files are touched, no link paths changed, and no claim was altered beyond the seven items above.

Draft on purpose — marking it ready is @evan's call.

[linear-code]

FOU-1386

FOU-1392

[greptile-apps]

Greptile Summary

The PR refines the GMP documentation following review feedback.

• Clarifies the distinction between opaque destination-call payload encoding and packet encoding.
• Explains relayer gas responsibility and retry behavior around packet receipt.
• Simplifies the ICS27 GMP contract-flow documentation by splitting its sequence diagram and removing duplicated handler material.
• Documents empty salts and acknowledgement success classification.

Confidence Score: 5/5

The documentation-only PR appears safe to merge with no actionable correctness issue identified.

The revised payload, relayer, receipt, account, and acknowledgement explanations remain consistent with the repository’s documented GMP model, while moved material preserves the existing contracts.

Important Files Changed

Filename	Overview
docs/3-applications/gmp.md	Clarifies payload encoding, packet execution, gas responsibility, receipt handling, and acknowledgement behavior without an actionable changed-code defect.
docs/5-ibc-solidity-contracts/ics27-gmp-and-accounts.md	Reorganizes contract-flow diagrams and handler documentation while adding accurate salt and acknowledgement details.

_{Reviews (1): Last reviewed commit: "docs: correct the gas-retry boundary and..." | Re-trigger Greptile}