Skip to content

Better document Michelson evm call - #443

Merged
skenaja merged 7 commits into
import-tx-docfrom
michelson-evm-call
Aug 19, 2026
Merged

Better document Michelson evm call#443
skenaja merged 7 commits into
import-tx-docfrom
michelson-evm-call

Conversation

@NicNomadic

@NicNomadicNicNomadic commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator

NB: Replaces #442 (closed)

Depends on #436

Solves issue #439

That is, fill in some important gaps in the doc of the Michelson interface. Except the aspects touching the ERC-20 and FA1.2 wrappers, because these were temporarily removed from the doc, while better doc for them is prepared.

@NicNomadicNicNomadic mentioned this pull request Aug 13, 2026

@NicNomadicNicNomadic left a comment

Copy link
Copy Markdown
CollaboratorAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I tested the added SmartPy examples in the online IDE, and the embedded tests were green. I have no idea if that's sufficient for saying the examples work with kernel Etherlink 7.

@NicNomadicNicNomadic changed the title Michelson evm callBetter document Michelson evm callAug 13, 2026

@saroupillesaroupille left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fact-checked every kernel-facing claim against the kernel sources on etherlink-ganesha — the page is accurate: enshrined gateway address (network-independent by construction), %call_evm entrypoint type and field order, gateway-computed Keccak256 selector, callback as a 0-mutez TRANSFER_TOKENS of the raw response bytes (None → dropped), whole-operation-group revert on EVM failure, and the staticcall_evm outcome table matches dispatch_staticcall_evm_get's mapping line for line (2xx → Some, other 4xx → None, 429 → out-of-gas failure, 5xx → failure). The FA1.2/ERC-20 wrapper removals are also correct (retired, no source in the kernel).

Two real bugs in the examples (inline, with suggestions) and two minor consistency nits. With the suggestions applied this is good to merge — @skenaja can apply them from the web UI since Nic is away.

🤖 Review researched with Claude Code on behalf of @saroupille

Comment threaddocs/michelson/nac-usage.md Outdated
Comment threaddocs/michelson/nac-usage.md Outdated
Comment threaddocs/michelson/nac-usage.md Outdated
Comment threaddocs/michelson/nac-usage.md Outdated
Comment threaddocs/overview/glossary.md Outdated
skenaja added a commit that referenced this pull request Aug 19, 2026
Apply saroupille's fact-check suggestions from PR #443:
- callback field is `option (contract bytes)`, not `option bytes`
- `VIEW` takes the view name and return type only (input comes
from the stack)
- staticcall_evm snippet: push the gateway address onto the stack
and reorder pushes so `PAIR` builds `pair string bytes`
- align on `sp.Some` (module syntax) over `sp.some`
- glossary: selector goes in `calldata`, not `abi_params`
@vercel

vercelBot commented Aug 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
docs-etherlinkReadyReadyPreviewAug 19, 2026 3:04pm

Request Review

NicNomadicand others added 7 commits August 19, 2026 16:01
Apply saroupille's fact-check suggestions from PR #443:
- callback field is `option (contract bytes)`, not `option bytes`
- `VIEW` takes the view name and return type only (input comes
from the stack)
- staticcall_evm snippet: push the gateway address onto the stack
and reorder pushes so `PAIR` builds `pair string bytes`
- align on `sp.Some` (module syntax) over `sp.some`
- glossary: selector goes in `calldata`, not `abi_params`
@skenaja
skenaja merged commit fab2014 into mainAug 19, 2026
4 checks passed
Sign up for freeto 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.

3 participants

@NicNomadic@skenaja@saroupille