Skip to content

Add ICON namespace (icon) with CAIP-2 profile - #208

Open
okwme wants to merge 1 commit into
ChainAgnostic:mainfrom
okwme:add-icon-namespace
Open

okwme wants to merge 1 commit into
ChainAgnostic:mainfrom
okwme:add-icon-namespace

Conversation

@okwme

@okwme okwme commented Sep 14, 2026

Copy link
Copy Markdown

Adds a CAN for ICON with a CAIP-2 Blockchain ID profile.

Who wrote this

I do not represent the ICON ecosystem. I maintain FAR, an open cross-reference between CAIP-19, CoinGecko and ISO 24165 identifiers. Offered as a starting point for ICON's maintainers to correct, adopt or replace.

Proposal

icon: + the NID as canonical decimal.

icon:1    ICON Mainnet

Why decimal, when ICON publishes hex

ICON's JSON-RPC returns the NID as "0x1". Using that verbatim would admit icon:0x1, icon:0x01, icon:0X1 and icon:0x001 for one network. The spec gives an explicit three-step hex→decimal derivation and lists icon:0x1 among the invalid test cases.

Verified live (2026-09-14)

icx_getNetworkInfo against two independent endpoints that agreedhttps://ctz.solidwallet.io/api/v3 and https://api.icon.community/api/v3, both returning {"platform":"icon","nid":"0x1","channel":"icon_dex"}. So icon:1 is current mainnet, post-ICON 2.0.

What I could not verify, stated in the draft rather than glossed

  • Lisbon (0x2) and Berlin (0x7) testnets are documentation-only. lisbon.net.solidwallet.io and sejong.net.solidwallet.io have no DNS A record, and api.lisbon.icon.community / api.berlin.icon.community returned 502. The Well-Known Networks table footnotes this.
  • github.com/icon-project/goloop returns 404 (the org and icon-project/IIPs are fine, so the node repo appears to be gone or private). That means the CID-vs-NID distinction in goloop is described from secondary documentation rather than source. Flagged in Additional Considerations rather than citing a dead link — a maintainer confirming the CID/NID semantics would be the single most useful review comment here.

Addressing

hx = EOA, cx = contract, 40 lowercase hex each. Worth noting for cross-chain tooling: the prefix identifies a contract without an equivalent of an EVM getCode call.

BTP Network Addresses (btp://0x1.icon/hx…) embed the same NID, which corroborates the value, but they are not themselves CAIP-2 references — icon:0x1.icon is an invalid test case.

discussions-to: 0xcounting/FAR#1

Adds a CAN for the icon ecosystem with a CAIP-2 Blockchain ID profile.
Drafted by the maintainers of FAR, an open cross-reference between CAIP-19,
CoinGecko and ISO 24165 identifiers, which needs a CAIP-2 for this chain to
name assets that exist on it. The authors do not represent the icon ecosystem
and offer this as a starting point for its community to correct, adopt or
replace. Discussion: 0xcounting/FAR#1
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