How-to use the Ledger Stax Metadata tool | Developers

How-to use the Ledger Stax Metadata tool

Estimated reading time: 4 minutes

Sometimes you can’t change the metadata yourself due to their immutable nature or simply because you don’t have the technical capability to do so. Don’t worry, we got you covered. We built a UI tool that makes it super easy to update the metadata of your collection, at a click of a button.

1. Open the tool:

2. Connect to your wallet (clear signing is required)

CryptoPunk on Ledger Stax
Wallet connection

3. Once your wallet is connected, select the contract that contains the tokens (NFTs) you wish to add/update the Ledger Stax metadata for.

Note that you can see for each contract the number of tokens available (total supply) and how many of them are Ledger Stax compatible (i.e. the ledger_stax_image attribute [pointing to the Ledger Stax compatible image location] is part of your Metadata).

Only ERC-721 and ERC-1155 smart contracts which are owned by the connected wallet will be shown on this page.
CryptoPunk on Ledger Stax
List of smart contracts you own

4.Select the tokens you wish to add/update the Ledger Stax metadata for.

CryptoPunk on Ledger Stax
List of tokens

Note that you can select tokens in bulk in three different ways:

  • Select all tokens of the contract.
  • Select a token range.
  • Select only tokens without Ledger Stax metadata.

5. Upon the selected tokens, provide the folder location (URL) where the Ledger Stax images are stored and hit the “Update Metadata” button.

The folder must contain images that follow the following requirements:
  • Supported files: JPEG (.jpeg/.jpg) and PNG (.png)
  • File name convention: {token_id}.{file_extension}
Where should I upload my Ledger Stax images?
  • We strongly recommend to upload your Ledger Stax images on one of our validated storage providers: AWS S3 or Google Cloud. IPFS is also supported but not optimal for large folders.
  • You could store them anywhere else as long as the hosting server can handle a minimum of 100 read requests per second.
  • The ability to upload files right from the app will be supported soon!

6. Should your Ledger Stax images comply with the requirements, your metadata will be updated, and your NFTs can now be showcased on the Ledger Stax screen. You’re ready to go!

CryptoPunk on Ledger Stax
Ledger Stax metadata successfully updated

In case of errors with the Ledger Stax images (i.e. images missing in the folder), we’ll report them in the modal dialog as shown below:

CryptoPunk on Ledger Stax
We found some errors

To resolve the issues:

  • Click on the “Fix now” button.
  • In your cloud-based folder, fix the missing images by making sure that all selected tokens have an associated image with the right convention name.
  • Click on the “Update metadata” button to start over the Update Metadata process

Did you find this page helpful?

How would you improve this page for developers?

Getting Started
Theme Features