A token blacklist can stop swaps at the contract level

A token blacklist is a token contract rule that blocks selected addresses from sending or receiving tokens. When a swap requires a blocked transfer, the transaction can fail even if the wallet has enough funds and the trading pool is available.

How does a token blacklist work?

The token contract checks addresses during a transfer and rejects the transaction if one is on its blacklist. Depending on its design, the check can apply to the sender, the recipient, or both.

On a decentralized exchange, a swap usually moves tokens through a pool contract. The token can check the wallet, the pool, or another address involved in the transfer. For a broader look at how route choice affects a transfer, the thor swap guide covers the options.

Why can a blacklist make a swap fail?

A swap is a set of contract calls, and the token’s transfer rule applies when those calls move the asset. If any required transfer is rejected, the full transaction generally reverts, so the swap does not complete.

• Sending in: the token may reject the wallet’s transfer to the pool.
• Sending out: the token may reject the pool’s transfer to the wallet.
• Routing: a token may reject an intermediary address used in the swap.

A failed transaction may still consume network gas because the transaction was processed even though its state changes were undone.

What is confirmed and what remains open?

The confirmed rule is whatever the deployed token contract enforces. A blacklist can be permanent, removable, or controlled by an administrator, depending on the code and permissions.

What remains open is how a particular token applies the rule, which addresses are blocked, and whether an administrator can change the list. A swap quote or a successful balance check does not establish that the token will allow the transfer.

What should a holder check?

Check the token’s verified contract code and available transaction history for blacklist controls and failed transfers. Confirm the token address and network, then treat a repeated transfer rejection as a contract restriction to investigate; trying a different route may not help if the token itself blocks the wallet.