Skip to content

docs: document originOf, resolveAddress and the alias RPCs - #459

Merged
NicNomadic merged 1 commit into
mainfrom
docs/origin-of-resolve-address
Sep 25, 2026
Merged

NicNomadic merged 1 commit into
mainfrom
docs/origin-of-resolve-address

Conversation

@pecornilleau

Copy link
Copy Markdown
Collaborator

Summary

The cross-runtime address-translation primitives were undocumented. This PR adds:

  • NAC usage (EVM to Michelson): an Address translation section with the Solidity interface for originOf / resolveAddress, the classification codes (Unknown / Native / Alias) and resolution codes (Recorded / Derived), when the kernel records an account's origin, short examples, and a failure-behavior entry.
  • NAC usage (Michelson to EVM): the same section for the gateway views, with the exact Michelson parameter and return types, result tables, and a VIEW "resolveAddress" snippet in the style of the existing staticcall_evm one.
  • Michelson RPC reference: an Alias RPCs section for tez_getTezosEthereumAddress / tez_getEthereumTezosAddress, noting they are served on the main JSON-RPC endpoint rather than under /tezlink.
  • Accounts and Aliases: a short Translating addresses paragraph cross-linking the three sections above.

All statements were checked against the kernel and node code (runtime_gateway.rs, enshrined_contracts.rs, the two runtime read_origin implementations, rpc_encodings.ml / services.ml). No gas figures were added, since the pages list none for the other gateway functions.

Test plan

  • npm run build passes (only pre-existing theme warnings)
  • npm run mocha passes
  • Maintainer read-through before requesting review

🤖 Generated with Claude Code

@vercel

vercel Bot commented Sep 8, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
docs-etherlink Ready Ready Preview Sep 23, 2026 8:27am UTC

Request Review

@NicNomadic NicNomadic left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

A first comment on the main page, I'm still reviewing the other pages

Comment thread docs/overview/accounts-and-aliases.md Outdated
Comment thread docs/michelson/developing/rpc-reference.md Outdated
@NicNomadic

Copy link
Copy Markdown
Collaborator

LGTM modulo the open threads above

@NicNomadic

Copy link
Copy Markdown
Collaborator

@pecornilleau do you want me to take over this PR by handling the open threads myself and merging it?

@pecornilleau

Copy link
Copy Markdown
Collaborator Author

@pecornilleau do you want me to take over this PR by handling the open threads myself and merging it?

yes that would be very helpful, thank you

Add an Address translation section to both NAC usage pages describing
the originOf and resolveAddress gateway functions (Solidity interface
and Michelson view types, classification and resolution codes, when
origins are recorded, failure behavior). Document the
tez_getTezosEthereumAddress / tez_getEthereumTezosAddress JSON-RPC
methods on the Michelson RPC reference and cross-link everything from
Accounts and Aliases.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@NicNomadic
NicNomadic force-pushed the docs/origin-of-resolve-address branch from 5375ec0 to 494bed1 Compare September 23, 2026 08:26

@NicNomadic NicNomadic left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Solved the pending thread, LGTM

@NicNomadic

Copy link
Copy Markdown
Collaborator

@pecornilleau do you want me to take over this PR by handling the open threads myself and merging it?

yes that would be very helpful, thank you

@pecornilleau can you please remove the Draft mode so that we can merge it?

@pecornilleau
pecornilleau marked this pull request as ready for review September 23, 2026 12:37
@NicNomadic
NicNomadic merged commit c11895c into main Sep 25, 2026
5 checks passed

This branch was successfully deployed

1 active deployment
Preview — 494bed1f Deployed Sep 23, 2026 by vercel[bot]
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.

2 participants