Block an Account - Base Documentation

Sometimes you need to stop one address from moving your stablecoin — a compliance hold or a support request. A blocklist denies only the addresses you list and leaves every other holder untouched. Bind it to the sender scope so a blocked account can’t send.

Demo

Block, then unblock

Terminal

REG=0x8453000000000000000000000000000000000002  # Policy Registry

# Add an address to the blocklist bound to TRANSFER_SENDER. Takes effect immediately.
base-cast send $REG "updateBlocklist(uint64,bool,address[])" $BLOCKLIST_ID true "[$ACCOUNT]" \
  --rpc-url $RPC_URL --private-key $ADMIN_KEY

# When the hold clears, remove it.
base-cast send $REG "updateBlocklist(uint64,bool,address[])" $BLOCKLIST_ID false "[$ACCOUNT]" \
  --rpc-url $RPC_URL --private-key $ADMIN_KEY

Transfers from a blocked address revert with PolicyForbids. See Restrict who can hold it to create and bind the policy.

See also

Recover funds · Pause activity
Policy integration in the B20 standard

⌘I