Skip to main content

Linking Digital Assets

In the Immutable zkEVM ecosystem, linking digital assets (ERC20, ERC721, ERC1155) is essential for their authenticity, administration, and security. This process enables Immutable to verify the legitimacy of each asset, ensuring they originate from recognized sources.

This guide provides a detailed, step-by-step process for linking your digital assets through Immutable's Hub.

linking digital assets

Linking digital assets allows Immutable to associate the owner of the asset(s) with an acknowledged company or an organisation. This is important because linking allows Immutable to safeguard your digital assets against engagements of fraudulent and/or unauthorised actors.

Immutable protects your linked digital assets through a process called assets verification. This prevents the likelihood of unverified creators to imitate your digital assets.

On top of that, Linking also manages off chain authorization for all actions provided by our Immutable API and Immutable SDK suite. One example would be the metadata refresh.


Assets deployed by using the Immutable Hub's contract deployment feature are linked automatically to your account, so there is no need to perform this process manually.

  1. After deploying a contract, obtain the asset's contract address. It should look like this: 0xec1852d1ecaa54bfa96c50c43990e210edf09288
  2. Visit Immutable Hub and select your requisite project and environment. Then, go to the Tokens menu for ERC20 assets or the Collections menu for ERC721 assets on the left-hand sidebar.
  3. Click Link Collection and/or Link Token Button:

{' '}

link button1. Follow the instructions provided in the modal drawer. After signing a few steps, you should be done!link button

What about custom contracts?

For custom contracts, you must ensure that your contract is compatible with Immutable's linking process.

Custom collections

In order to link a custom collection, ensure that your contract implements one of the following functions:

  1. OpenZeppelin's Ownership and Ownable
  2. OpenZeppelin's Roles as specified by the specification here.

Custom tokens

For token contracts, these implementations are optional. If your contract doesn't implement OpenZeppelin's Ownable or RBAC methods, Immutable will query the block explorer to verify that the contract was deployed by the wallet linking the token.

IMX Whitepaper IMX Tokenomics Block Explorer Careers Contact Us