Triggers a metadata refresh of all NFTs in the provided contract address. This method is useful after an NFT collection is revealed.

Refreshes are queued on the Alchemy backend and may take time to fully process. To refresh the metadata for a specific token, use the refreshNftMetadata method instead.

Parameters

Response

RefreshContractResult response object parameters

Example Request and Response

Prerequisite: You will need to install the Alchemy SDK before making requests with it.

The commands for installing it using npm or yarn are given below:

$
npm install alchemy-sdk

Request

1
// Imports the Alchemy SDK
2
const { Alchemy, Network } = require("alchemy-sdk");
3
4
// Configures the Alchemy SDK
5
const config = {
6
    apiKey: "alchemy-replit", // Replace with your API key
7
    network: Network.ETH_MAINNET, // Replace with your network
8
};
9
10
// Creates an Alchemy object instance with the config to use for making requests
11
const alchemy = new Alchemy(config);
12
13
const main = async () => {
14
    // define the contract address
15
    const address = "0x5180db8F5c931aaE63c74266b211F580155ecac8";
16
17
    //Call the method to return the refresh result response object
18
    const response = await alchemy.nft.refreshContract(address)
19
20
    //Logging the response to the console
21
    console.log(response)
22
}
23
24
main();

Response

$
{
>
  contractAddress: '0x5180db8f5c931aae63c74266b211f580155ecac8',
>
  refreshState: 'queued',
>
  progress: 0
>
}

Use Cases

Here are some potential use cases for the refreshContract method:

• Marketplace management: NFT marketplaces can use the refreshContract method to ensure that the data for a specific contract is up-to-date, including any changes to the contract’s metadata or events. This information is crucial for ensuring that the marketplace accurately reflects the current state of the contract.

• Contract management: Developers can use the refreshContract method to update the data for a contract they are developing. This can be useful for ensuring that the contract is functioning properly and for identifying any potential issues or bugs.

• User interface updates: DApp developers can use the refreshContract method to update their user interfaces to reflect any changes to the contract’s metadata or events. This can be useful for improving the user experience and ensuring that the DApp is always displaying the most accurate information.

Related Methods

Here are the methods related to refreshContract:

• refreshNftMetadata: Refreshes the cached metadata for a provided NFT contract address and token id. Returns a boolean value indicating whether the metadata was refreshed.

• searchContractMetadata: Search for a keyword across the metadata of all ERC-721 and ERC-1155 smart contracts.