2. Troubleshooting Guide

Even with thorough documentation, you may encounter issues. Below is a troubleshooting reference for common obstacles:

  1. Bonding Curve Purchase Errors

    • Symptoms: “Transaction Reverted” or “Insufficient Output Amount” errors when trying to buy tokens on the bonding curve.
    • Potential Causes:
      • Incorrect assetRate updates by the token creator.
      • Low slippage settings in your wallet or DApp.
      • Token has already graduated from the bonding phase.
    • Solution:
      • Ensure the token is still in its bonding phase.
      • Increase slippage tolerance in your wallet settings.
      • Check that the assetRate or relevant parameters are up-to-date if you are the token owner.

  2. Migration Not Available

    • Symptoms: Unable to migrate your old AgentToken to the GraduatedToken.
    • Potential Causes:
      • Migration window (migrationOpen) not yet active.
      • You do not hold any AgentTokens in your wallet.
    • Solution:
      • Confirm that the project’s owner has called openMigration() on the GraduatedToken contract.
      • Ensure your AgentToken balance is correct; if not, verify transaction history.

  3. Liquidity Locker Vesting Issues

    • Symptoms: Inability to withdraw liquidity after the cliff/vesting period.
    • Potential Causes:
      • Cliff period still in effect.
      • Vesting clock not accurately set in the contract (rare if it’s a trusted deployment).
    • Solution:
      • Confirm the current timestamp is beyond the cliff period.
      • Check if any local time settings are confusing your calculations; rely on on-chain data.

  4. Tax Configuration & Exclusion Errors

    • Symptoms: Unexpected taxes on custom whitelisted addresses/contracts.
    • Potential Causes:
      • Contract’s tax list (inclusion/exclusion) not updated.
      • The token creator locked parameters prematurely.
    • Solution:
      • Confirm the final tax rate is set.
      • If you are the creator, update excludedAsSender or excludedAsRecipient (if not locked). If locked, no further changes can be made.