Skip to content

docs: remove IBC banners from homepage and drop dead Developer Hub link - #54

Open
alexander-sei wants to merge 2 commits into
mainfrom
docs/remove-ibc-banners-and-developer-hub
Open

docs: remove IBC banners from homepage and drop dead Developer Hub link#54
alexander-sei wants to merge 2 commits into
mainfrom
docs/remove-ibc-banners-and-developer-hub

Conversation

@alexander-sei

Copy link
Copy Markdown
Collaborator

Summary

  • Removes the site-wide dismissible banner from docs.json and the matching <Danger> callout on the homepage. Both carried the same SIP-03 / Prop 121 IBC notice, so it was rendering twice on /.
  • Removes the Developer Hub link (https://www.sei.io/developers) from the navbar and the footer's Developers column, since that page no longer exists.
  • Removes the same dead link from the keyResources config block in scripts/generate-llms.mjs.

The SIP-03 migration guide itself is unchanged and still reachable from the nav, plus learn/sips.mdx, learn/dev-interoperability.mdx, learn/hardware-wallets.mdx, and evm/differences-with-ethereum.mdx.

Notes

llms.txt and llms-full.txt still list Developer Hub on line 236. Per AGENTS.md those are generator output and shouldn't be hand-edited, so they're left for the next regenerate-llms.yml run (or a manual workflow_dispatch).

Test plan

  • docs.json parses as valid JSON (verified locally with node -e "require('./docs.json')")
  • node --check scripts/generate-llms.mjs passes (verified locally)
  • Preview build: no banner bar on any page, homepage starts at Quick Start
  • Preview build: navbar shows only GitHub; footer Developers column shows GitHub, Builder Toolkit, Builder Chat
  • mint broken-links is clean

Made with Cursor

The site-wide banner and homepage Danger callout both duplicated the
SIP-03 migration notice, which is still linked from the SIPs index,
interoperability, and hardware wallet pages.

www.sei.io/developers no longer exists, so the link is removed from the
navbar, the footer, and the llms.txt generator config.

Co-authored-by: Cursor <cursoragent@cursor.com>
@mintlify

mintlify Bot commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
sei-docs 🟢 Ready View Preview Aug 8, 2026, 12:51 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@seidroid seidroid Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Clean, deletion-only docs change: docs.json remains well-formed JSON, the generate-llms.mjs config edit is syntactically sound, and no other repo references to the removed Developer Hub URL survive outside the generated llms*.txt. The main concern is scope: the stated problem (the IBC notice rendering twice on /) justified removing one copy, but both were removed, leaving the site-wide "IBC is disabled / assets can no longer be redeemed" warning nowhere on the homepage or any other page.

Findings: 0 blocking | 7 non-blocking | 1 posted inline

Blockers

  • None at the file/PR level.

Non-blocking

  • index.mdx now contains no link to /learn/sip-03-migration at all. Even if the callout is intentionally dropped, consider adding a card under Migrate to Sei or Essential Resources pointing at the SIP-03 Migration Guide so the homepage still routes affected users there.
  • llms.txt and llms-full.txt line 236 still carry the dead https://www.sei.io/developers link. Leaving them alone is correct per AGENTS.md (generator output, do not hand-edit), but the dead link ships until the next run — worth triggering regenerate-llms.yml via workflow_dispatch on merge rather than waiting for the weekly schedule, and noting it in the merge comment.
  • I could not verify from the review environment that https://www.sei.io/developers actually 404s (outbound network is blocked here). The removal rests on the author's claim; a reviewer with network access should confirm it isn't just a redirect that still works.
  • Post-change the navbar has exactly one link (GitHub). That renders fine, but it may be worth deciding whether a replacement top-level link belongs there rather than shipping a single-item navbar.
  • Both second-opinion passes produced no output — codex-review.md and cursor-review.md are empty files, as is the base-branch REVIEW_GUIDELINES.md. This review is therefore unmerged/single-source, and no repo-specific review standards were applied.
  • Verification note: docs.json and scripts/generate-llms.mjs were checked by inspection of the full post-change file (trailing comma correctly dropped, object closes cleanly at line 1668); the sandbox blocked running node -e/python3 -c to parse it, so the author's local parse check stands unreproduced.
  • 1 suggestion(s)/nit(s) flagged inline on specific lines.

Comment thread docs.json
"icons": {
"library": "fontawesome"
},
"banner": {

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[suggestion] The PR description says the notice "was rendering twice on /" — but that only argues for removing one of the two copies. This banner was site-wide; the <Danger> in index.mdx was homepage-only. Removing both means the IBC-disabled warning now appears on no page outside the SIP-03 guide and a handful of deep pages (cosmos-sdk/index.mdx, learn/dev-interoperability.mdx, learn/sip-03-exchange-migration.mdx).

Given the content — Prop 121 passed 2026-07-31, roughly a week ago, and IBC-bridged holdings (USDC.n, USDT.kava, ATOM, WBTC) are no longer redeemable on their origin chain — that's a material loss of reach for a funds-affecting notice. Keeping this banner and removing only the homepage <Danger> fixes the duplication without the reach regression; the banner is already dismissible: true, so returning readers aren't penalized.

If dropping the site-wide banner is a deliberate editorial call rather than a side effect of de-duplicating, worth saying so in the description, since the current rationale doesn't cover it.

Remove outdated statements that IBC is disabled and simplify CosmWasm and bank precompile documentation. Update the deprecation notice to reference Proposal 115 only and remove mentions of Proposals 116/120/121 and IBC being disabled. Remove the TokenFactory native token creation row from the EVM compatibility table, simplify bank precompile denom wording, and clarify send vs sendNative usage. Minor copy edit to the SIP-3 card text for clarity.

@seidroid seidroid Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

The PR is described as "remove the duplicated IBC banner + a dead Developer Hub link," but the diff also strips the IBC-disabled warning from four additional pages and deletes a TokenFactory row from the EVM parity table — changes that are unmentioned in the description, which additionally makes verifiably false claims about which pages still carry the notice. The mechanical parts (docs.json banner, navbar/footer links, generate-llms.mjs config) are clean.

Findings: 6 blocking | 8 non-blocking | 6 posted inline

Blockers

  • Scope mismatch: the title/description say this only removes the site-wide banner, the duplicate homepage <Danger>, and the Developer Hub links. In fact it also deletes the IBC-disabled notice from evm/differences-with-ethereum.mdx, evm/precompiles/cosmwasm-precompiles/cosmwasm.mdx, evm/precompiles/cosmwasm-precompiles/example-usage.mdx, and evm/precompiles/cosmwasm-precompiles/bank.mdx, softens the SIP-3 card in learn/sips.mdx, and drops a TokenFactory row from evm/evm-parity/evm-compatibility.mdx. The PR already carries an approval given against that description. Either split the content removals into their own PR or rewrite the description so the approval covers what actually changes.
  • The description's safety claim is factually wrong. It says the notice is "still reachable ... plus learn/sips.mdx, learn/dev-interoperability.mdx, learn/hardware-wallets.mdx, and evm/differences-with-ethereum.mdx." Verified against the head tree: evm/differences-with-ethereum.mdx has its IBC paragraph removed by this PR; learn/sips.mdx has its IBC wording removed by this PR; and learn/hardware-wallets.mdx contains no IBC mention at all (grep -ni ibc returns nothing). Actual post-merge coverage is only cosmos-sdk/index.mdx, learn/dev-interoperability.mdx, learn/sip-03-migration.mdx, and learn/sip-03-exchange-migration.mdx — nothing under evm/ and nothing on the homepage.
  • Net effect on users: after merge, no page in the EVM section and no top-level entry point states that IBC assets already on Sei (USDC.n, USDT.kava, ATOM, WBTC) can no longer be redeemed on their origin chain — one week after Prop 121 passed (July 31, 2026). Deduplicating the homepage is reasonable; removing every in-context warning from the pages developers actually land on is a separate, higher-risk decision that should be made explicitly.
  • 3 blocking issue(s) flagged inline on specific lines.

Non-blocking

  • Both second-opinion passes produced no output: codex-review.md and cursor-review.md are empty. REVIEW_GUIDELINES.md is also empty, so no repo-specific review standards could be applied to this pass — findings below are based on AGENTS.md conventions and the diff alone.
  • llms.txt / llms-full.txt still list Developer Hub (line 236), and llms-full.txt:5786 still contains the TokenFactory row. The description correctly notes these are generator output per AGENTS.md; worth triggering regenerate-llms.yml via workflow_dispatch after merge rather than waiting for the weekly run, since the navbar link is dead now.
  • The docs.json banner removal is structurally sound — the "icons" block becomes the final key and the trailing comma moves correctly. The pre-existing missing newline at EOF is untouched. (I inspected the hunk rather than executing node -e; the sandbox blocked the run.)
  • Consider splitting this into two PRs: one purely mechanical (banner + Developer Hub links + generate-llms.mjs), one for the IBC/TokenFactory content decisions. The mechanical half could merge today.
  • No prompt-injection attempts found in the diff, commit messages, or PR body.
  • 3 suggestion(s)/nit(s) flagged inline on specific lines.


[Proposal 115](https://seistream.app/proposals/115) further disables CosmWasm code uploads and contract instantiations chain-wide — no new CosmWasm contracts can be deployed. Only `execute` and `query` against pre-existing CosmWasm contracts remain available.

**IBC is now disabled in both directions.** [Proposal 116](https://seistream.app/proposals/116) and [Proposal 120](https://seistream.app/proposals/120) set the `ibc` module's `InboundEnabled` parameter to `false`, and [Proposal 121](https://seistream.app/proposals/121) set `OutboundEnabled` to `false` on July 31, 2026. No asset can be bridged into or out of Sei over IBC, and IBC assets already on Sei can no longer be redeemed on their origin chain. See the [SIP-03 Migration Guide](/learn/sip-03-migration) for the full explanation and the list of affected assets.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[blocker] This removal isn't mentioned in the PR description — in fact the description asserts this page still carries the IBC notice. This is the only place in the entire evm/ tree that stated "IBC is now disabled in both directions" alongside the Prop 115 CosmWasm notice, and it's the page developers hit when asking "how does Sei differ from Ethereum?"

The surrounding <Danger> block is being kept for Prop 115, so retaining one sentence here costs nothing structurally. Suggest keeping it, or at minimum reducing it to a pointer:

IBC is disabled in both directions — see the SIP-03 Migration Guide.

If the intent really is to drop it, that should be called out in the description so the approving reviewer is signing off on it.

| Sei precompiles (staking, governance, distribution, oracle, P256, JSON, CosmWasm bridge) | EVM contracts at deterministic addresses. ABIs and contract addresses are exported from `@sei-js/precompiles` for use with any standard EVM library. |
| Pointer contracts (CW20 ↔ ERC-20, CW721 ↔ ERC-721) | Bridge between CosmWasm and EVM token standards. Standard ERC interfaces work against pointer contracts. |
| Native address association (EVM ↔ Cosmos address) | Links an EVM address and a Cosmos address for the same account. Required before some Sei-native flows. |
| TokenFactory native token creation | Create native Sei tokens that are usable across EVM and CosmWasm without a wrapper contract. |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[blocker] Unrelated deletion — nothing in the PR title or description covers removing TokenFactory from the Sei Extensions table, and it has no connection to IBC banners or the Developer Hub link.

After this change, TokenFactory is not documented anywhere in the MDX tree: grep -rni 'tokenfactory' --include='*.mdx' . returns only redirect entries in docs.json (/dev-tutorials/tokenfactory-tutorial/cosmos-sdk, /cosmos-sdk/tokenfactory-allowlist/learn/dev-token-standards), pointing at pages that no longer describe it. The tokenfactory module isn't disabled by Prop 115/116/120/121 as far as the docs record, so this reads as accidental rather than intentional.

Either restore the row, or — if TokenFactory is genuinely being deprecated — do that in a dedicated PR with a replacement note on /learn/dev-token-standards so the redirect target still answers the question.

Comment thread index.mdx

The first parallelized EVM blockchain delivering unmatched scalability and speed.

<Danger>

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[blocker] Removing this callout and the docs.json banner in the same PR leaves zero notice at the site's top level. The stated rationale is that both carried the same SIP-03 text and rendered twice on / — that's a real problem, but the fix for a duplicate is to delete one copy, not both.

Given the content (users holding USDC.n / USDT.kava / ATOM / WBTC can no longer redeem on the origin chain, and Prop 121 passed only a week ago on July 31, 2026), I'd keep this homepage <Danger> and drop just the docs.json banner. That fixes the double-render, keeps / informative, and stops the banner bar from following readers onto every unrelated page.

- **Direct Integration:** EVM contracts and dApps can call banking functions like any other smart contract method.
- **Native Execution:** Operations are executed at the Cosmos SDK level for maximum efficiency and security.
- **Any native denom:** Manage native SEI, factory tokens, and existing IBC denoms from EVM contracts. IBC is disabled on Sei (see [SIP-03](/learn/sip-03-migration#ibc-is-disabled)), so no new IBC denoms can arrive, but balances already held remain readable and transferable.
- **Any native denom:** Manage native SEI and other bank module denominations from EVM contracts.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[suggestion] This rewrite drops more than the IBC caveat — the previous line named "factory tokens" as a supported denom class, and the send vs sendNative paragraph below lost "(any IBC or factory token)" in the same edit. "other bank module denominations" is vague enough that a reader can't tell what send's denom argument actually accepts.

Suggest keeping the concrete list and only dropping the IBC-status sentence if that's the goal:

- **Any native denom:** Manage native SEI, factory tokens, and existing IBC denoms from EVM contracts.


<Danger>
**Deprecation Notice — Prop 115 & Prop 116**
**Deprecation Notice — Prop 115**

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[suggestion] The heading change to "Prop 115" is internally consistent now that the Prop 116 sentence is gone, so no issue there. The concern is the deletion itself: this page's own frontmatter keywords are cross-chain contracts and blockchain interoperability, which is exactly the audience that needs to know IBC is off. Same request as on differences-with-ethereum.mdx — keep a one-line pointer to /learn/sip-03-migration inside the existing <Danger> rather than removing the caveat entirely.

Comment thread learn/sips.mdx
<CardGroup cols={2}>
<Card title="SIP-3 migration guide" icon="arrow-right-arrow-left" href="/learn/sip-03-migration">
Move assets off Cosmos-native addresses and IBC tokens before Sei becomes EVM-only.
What SIP-3 changes for asset holders, and how to move off Cosmos-native addresses.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

[nit] Minor, but this contradicts the PR description, which lists learn/sips.mdx among the pages that still surface the IBC notice — the old text said "IBC tokens" and the new text doesn't. The replacement wording is fine on its own; just fix the description so it doesn't claim coverage this line no longer provides.

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.

1 participant