docs(evm): clarify Initia ERC20 compatibility for wallet/bridge and r… by restorenode · Pull Request #97 · initia-labs/docs

restorenode · 2026-03-08T02:43:34Z

No description provided.

…egistry requirements

coderabbitai · 2026-03-08T02:43:49Z

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 454140d7-c208-4e7b-bb8d-a2f7d3850c03

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch docs/clarify-evm-erc20-widget-bridge-compat

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

developers/developer-guides/integrating-initia-apps/registry/introduction.mdx

...pers/developer-guides/vm-specific-tutorials/evm/creating-erc20s/creating-standard-erc20s.mdx

developers/developer-guides/vm-specific-tutorials/evm/update-fee-token.mdx

resources/developer/contract-references/evm/initia-custom-erc20.mdx

...pers/developer-guides/vm-specific-tutorials/evm/creating-erc20s/creating-standard-erc20s.mdx

…roles

tansawit

We should make sure

that each page only contain content relevant to it (e.g. we don't need to mention adding sudoTransfer hook to ERC20 on the page about deploying via ERC20Factory
information is complete (having sudoTransfer is not enough to ensure compatibility. register is also required to register the ERC20 with the MiniEVM's ERC20Registry. We should be telling them to only choose between using ERC20Factory or inheriting InitiaERC20.sol in all places)
Be specific, concise, and give sufficient context. (e.g. avoid general terms like "Registry listing" which could mean Initia Registry, ERC20Registry, other registry for someone with minimal context on the topic).

tansawit · 2026-03-09T05:49:53Z

...pers/developer-guides/vm-specific-tutorials/evm/creating-erc20s/creating-standard-erc20s.mdx

-contract.
+contract. For most teams, this is the lowest-risk path because it deploys a
+token implementation that already includes the required Initia chain integration
+hooks (including `sudoTransfer`).


For most teams, this is the lowest-risk path because it deploys a
token implementation that already includes the required Initia chain integration
hooks (including sudoTransfer).

I don't think we need this sentence

tansawit · 2026-03-09T05:52:11Z

...pers/developer-guides/vm-specific-tutorials/evm/creating-erc20s/creating-standard-erc20s.mdx

+
+## Production Readiness Checklist
+
+Before treating a factory-deployed token as ready for support across Initia


"Factory-deployed tokens" is unclear/not specific. It should be "Tokens deployed via ERC20Factory satisfy this requirement by default" etc.

tansawit · 2026-03-09T05:52:56Z

...pers/developer-guides/vm-specific-tutorials/evm/creating-erc20s/creating-standard-erc20s.mdx

+  Registry listing is required for tokens to appear correctly in Initia product
+  UIs with metadata (name, symbol, decimals, logo), and to be selectable in
+  flows such as balances, transfers, and bridging.
+</Note>


Unclear what registry this refers to

tansawit · 2026-03-09T05:53:07Z

developers/developer-guides/vm-specific-tutorials/evm/update-fee-token.mdx

 <Warning>
-  The deployed ERC20 token must inherit the `InitiaERC20` contract.
+  The fee token ERC20 must implement Initia-compatible chain hooks, especially
+  `sudoTransfer`, which is used by chain-level transfer handling. Tokens


tansawit · 2026-03-09T05:53:21Z

developers/developer-guides/vm-specific-tutorials/evm/update-fee-token.mdx

 <Warning>
-  The deployed ERC20 token must inherit the `InitiaERC20` contract.
+  The fee token ERC20 must implement Initia-compatible chain hooks, especially
+  `sudoTransfer`, which is used by chain-level transfer handling. Tokens


not only sudoTransfer

tansawit · 2026-03-09T05:53:48Z

resources/developer/contract-references/evm/initia-custom-erc20.mdx

 checks. This function can only be called by the chain signer.

+<Info>
+  For MiniEVM ERC20 tokens, `sudoTransfer` is a required hook in the token


not just sudoTransfer for proper compatibility

tansawit · 2026-03-09T06:37:07Z

...pers/developer-guides/vm-specific-tutorials/evm/creating-erc20s/creating-standard-erc20s.mdx

+## Production Readiness Checklist
+
+Before treating a factory-deployed token as ready for support across Initia
+products (for example, Initia Scan, InterwovenKit, Wallet, and Bridge):
+
+1. Deploy via
+   [`ERC20Factory`](/resources/developer/contract-references/evm/erc20-factory).
+2. Add token metadata to the relevant `assetlist.json` in
+   [Initia Registry](/developers/developer-guides/integrating-initia-apps/registry/introduction).
+3. Confirm your token is compatible with the required `sudoTransfer` hook used
+   in sending and bridging flows (included by default for `ERC20Factory`
+   deployments) by following the compatibility guidance in
+   [Creating ERC20s Introduction](/developers/developer-guides/vm-specific-tutorials/evm/creating-erc20s/introduction)
+   and
+   [`InitiaCustomERC20` reference](/resources/developer/contract-references/evm/initia-custom-erc20).


This is irrelevant if they're deploying the token via ERC20Factory, which is the context of this page?

tansawit · 2026-03-09T06:44:42Z

developers/developer-guides/integrating-initia-apps/registry/introduction.mdx

+   product UIs (name, symbol, decimals, logo, and display info in Initia Scan).
+2. Token contract behavior: Controls whether token actions actually work (for
+   example, sending and bridging). For MiniEVM ERC20 tokens, this includes the
+   `sudoTransfer` hook.


It's not just sudoTransfer that's required? The register functions and others are also needed https://initia-labs.slack.com/archives/C08HUBCRV6Y/p1772709025874659?thread_ts=1772616413.010649&cid=C08HUBCRV6Y

tansawit · 2026-03-09T12:38:00Z

Will close this PR in favor of #98 (WIP)

docs(evm): clarify Initia ERC20 compatibility for wallet/bridge and r…

5536db1

…egistry requirements

restorenode requested a review from tansawit March 8, 2026 02:43

mintlify bot deployed to staging March 8, 2026 02:44 View deployment

tansawit requested changes Mar 8, 2026

View reviewed changes

fix: prettier formatting

c3ca179

mintlify bot deployed to staging March 8, 2026 15:12 View deployment

restorenode force-pushed the docs/clarify-evm-erc20-widget-bridge-compat branch from 0177243 to 9bc6e32 Compare March 9, 2026 04:10

mintlify bot deployed to staging March 9, 2026 04:10 View deployment

docs: clarify ERC20 compatibility requirements and registry metadata …

eaea053

…roles

restorenode force-pushed the docs/clarify-evm-erc20-widget-bridge-compat branch from 9bc6e32 to eaea053 Compare March 9, 2026 04:17

restorenode requested a review from tansawit March 9, 2026 04:24

tansawit reviewed Mar 9, 2026

View reviewed changes

tansawit closed this Mar 9, 2026


		## Production Readiness Checklist

		Before treating a factory-deployed token as ready for support across Initia

Conversation

restorenode commented Mar 8, 2026

Uh oh!

coderabbitai bot commented Mar 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

tansawit left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tansawit commented Mar 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

coderabbitai bot commented Mar 8, 2026 •

edited

Loading

tansawit left a comment •

edited

Loading