Skip to main content

Guide for Amoy testnet migration from Mumbai testnet

Welcome to the guide for migrating your projects and solutions built using PolygonID from the Mumbai testnet to the new Amoy testnet which is the new Sepolia-anchored testnet for Polygon PoS. With the deprecation of Goerli and Mumbai testnets, it's crucial to transition to Amoy for seamless development and testing. This guide aims to assist developers in understanding the changes required for integrating and using PolygonID on the Amoy testnet, ensuring a smooth transition.


These changes would only affect your project or solution on the testnet. Things on the Mainnet stay as it is. Most providers will shut down the Mumbai testnet RPC Nodes, so we request you to migrate to Amoy testnet for your solution to work as expected.


To migrate to the Amoy testnet, developers must set up a new Issuer node configured for Amoy. The migration involves two steps:

  1. Setting up a new Issuer node using the latest configuration guidelines.

    • To set up a new issuer node, please refer to this installation guide. It includes the latest configuration for the Amoy testnet.
    • An Issuer will need to create a new identity for Amoy, through the core API specifying the proper "network": "amoy". If you do it with the make generate-issuer-did command, then the program will ge the variables from the .env files that must be properly filled. (.env-samples are available at Issuer Node GitHub repository).
    • Here you can find more details about issuer configuration (advanced Issuer Node configuration).
  2. Deprecating and shutting down existing Issuer nodes configured for the Mumbai testnet.


The identities and the states won’t be migrated from Mumbai to Amoy.


To ensure compatibility with the Amoy testnet, you need to install the latest version of Verifier SDK. For instances where the Verifier SDK is already integrated into existing systems, you should proceed by updating it to the latest version. Tools:

  • JS-SDK (v1.10.0 or greater) is updated and compatible with the Amoy testnet.
  • Query Builder is updated and compatible with the Amoy testnet.


Integrating with the Amoy testnet requires installing and updating to the latest version of the Wallet (2.3.4). This version provides support for Amoy testnet.

Smart contracts

The Polygon ID smart contracts have been deployed to Amoy testnet. You can find the address of the contracts here and use them accordingly.

Affected tools status

Here is the status for all the Tools with respect to support for the Amoy testnet: