Skip to main content

Troubleshooting

Wallet Connection Problems​

Wallet connection issues are one of the most common hurdles for new users. Wapal requires a supported Aptos wallet to interact with the launchpad and marketplace.

Typical causes include:

  • Using an unsupported wallet extension.
  • Browser permissions blocking the wallet connection.
  • Cached session conflicts after a failed login.

Steps to resolve:

  • Use a supported Aptos wallet such as Petra.
  • Refresh the page and reconnect.
  • Clear the browser cache if the wallet still does not appear.
  • Ensure your wallet extension is updated to the latest version.

Invite Code Not Accepted​

Wapal requires an invite code for first-time creators before they can access the full launchpad.

Possible issues:

  • Entering an invalid or expired invite code.
  • Attempting to proceed without a code.

How to fix:

  • Double-check the invite code you received.
  • If you don’t have one, apply through the platform.
  • Reach out to support if you believe your code is valid but not being recognized.

Vault Naming Restrictions​

A vault is the container for your NFT assets. Creators often make errors when choosing vault names with unsupported characters.

Important rules:

  • Vault names cannot contain spaces.
  • Special characters like @, #, %, or emojis are not supported.
  • Stick to simple letters and numbers, such as MyVault or Collection01.

Asset Upload Fails​

Uploading images, audio, or video assets is a critical step. Problems here can prevent you from moving forward with collection creation.

Why uploads fail:

  • Files are not named sequentially.
  • Assets are too large and time out during upload.
  • Wrong file formats are used.

Solutions:

  • Ensure images are named 0.png, 1.png, 2.png ... without gaps.
  • Metadata files must mirror the image sequence: 0.json, 1.json, 2.json ....
  • Allow 20–25 minutes for large sets to process completely.
  • Use only supported formats:
    • Images: .png
    • Video: .mp4, .webm, .mkv, .mov, .avi, .flv, .mpeg, .ts, etc.
    • Audio: .mp3, .wav, .ogg, .aac, .flac, .alac, .aiff, .opus, etc.

Metadata Errors​

Metadata defines the traits and descriptions of your NFTs. Errors in metadata can break collection validation.

Common problems:

  • Missing or mismatched .json files.
  • Incorrectly formatted JSON structure.
  • CSV-based generation not matching the sample template.

How to resolve:

  • Confirm every NFT has a .json file with the same index as the asset.
  • Validate JSON files include:
    • name
    • description
    • image link
    • attributes array
  • When generating via CSV:
    • The second row must correspond to 0.png.
    • Ensure rows align consistently.
  • Use the provided sample CSV file to avoid formatting mistakes.

Royalties and Fees​

Unexpected charges are often due to misunderstandings about Wapal’s fee model.

Key details to remember:

  • Wapal charges a 3% fee for paid mints.
  • 0% fee applies for free mints.
  • Creators must manually set their desired royalty percentage during collection setup.
  • Mint revenues are transferred instantly to the creator’s wallet (custodial by default).

Performance and Slow Speed​

Users may experience slow loading or lag, especially during large uploads.

What helps:

  • Clear your browser cache.
  • Refresh the page to reload socket connections.
  • Expect longer processing times for large uploads (20–25 minutes).

Real-Time Updates Missing​

The live activity feed depends on socket subscriptions.

When feeds stop updating:

  • The socket connection likely dropped.
  • Wallet disconnection can also break the feed.

How to restore:

  • Refresh the page.
  • Reconnect your wallet.
  • Check your internet stability.

Metadata Generation From CSV​

Automatic metadata generation simplifies launches, but formatting errors can stop the process.

Fixes:

  • Ensure images are named sequentially (0.png, 1.png, ...).
  • The second row in the CSV must match 0.png.
  • Each row should list traits and values clearly.
  • Upload the CSV through the metadata section — metadata will generate automatically if formatted correctly.

File Format Errors​

Unsupported formats are a frequent cause of upload rejection.

Supported formats:

  • Images: .png
  • Audio: .mp3, .wav, .ogg, .aac, .flac, .wma, .alac, .aiff, .opus
  • Video: .mp4, .webm, .mkv, .mov, .avi, .flv, .3gp, .mpeg, .ts, and others.

Always verify your files match these formats before attempting uploads.