Common Issues and Solutions

• Insufficient Balances:

  • Symptom: Minting, transfer, or liquidity addition fails due to insufficient UserBalance.

  • Solution: Ensure that the transaction sender holds enough NFTs or tokens before attempting these operations. Adjust test scenarios or pre-mint additional NFTs to the sender’s account.

• Deny List Failures:

  • Symptom: Transfers or purchases fail unexpectedly.

  • Solution: Check if the recipient is on the deny list. If so, remove them from the deny list or ensure your test scenario sets the correct permissions and authority flags.

• Max Supply Exceeded:

  • Symptom: Minting additional NFTs fails with an overflow or max supply error.

  • Solution: Increase the max supply if intended or adjust test scenarios so that you do not exceed the predefined limits.

• Unexpected Price Behavior in TRADE:

  • Symptom: Trades result in unexpected price impacts or slippage errors.

  • Solution: Verify that you’ve set realistic min_price, max_price, and fee_percent. Test with smaller trades first and ensure the oracle and TWAP logic is correct.

• Fee Distribution Errors:

  • Symptom: Withdrawing currency or distributing fees fails.

  • Solution: Confirm that percentages sum to 100% and that the sale or pool creator still holds the required authority. Check that the pool or sale actually contains sufficient funds to withdraw.