Event signature · Stablecoins and issued tokens

Blacklisted (USDC) event signature and topic0

The topic0 of the Blacklisted (USDC) event is 0xffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b855, the keccak-256 hash of Blacklisted(address); 1 of its 1 arguments is indexed. Address frozen by the token issuer (Circle FiatToken).

Anatomy of a Blacklisted (USDC) log

Topics

  • topic00xffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b855keccak256("Blacklisted(address)")
  • topic1_account (address)indexed: filterable
Parameters

Arguments and where they sit in the log

Indexed arguments travel as topics and can be filtered cheaply; the others are ABI-encoded together in the data.

NameTypeIn the log
_accountaddresstopic1

Solidity declaration

event Blacklisted(address indexed _account);

Canonical signature

Blacklisted(address)

topic0

0xffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b855

Ready-made alerts

Get an alert on Blacklisted

Each rule opens with the contract and the conditions filled in. Sign in, pick your chat and click Create.

Who emits it

Contracts we list that emit Blacklisted

Any other contract with the same signature emits a log with the same topic0.

Code

Read Blacklisted logs in code

The same filter in viem, ethers and plain JSON-RPC, and the Solidity that emits it. The address is USD Coin (USDC), a contract we list that emits it.

viem
import { createPublicClient, http, parseAbiItem } from "viem"
import { mainnet } from "viem/chains"

const client = createPublicClient({ chain: mainnet, transport: http() })

const logs = await client.getLogs({
  address: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  event: parseAbiItem("event Blacklisted(address indexed _account)"),
  fromBlock: "latest",
})

for (const log of logs) console.log(log.args) // { _account }
ethers v6
import { Interface, JsonRpcProvider } from "ethers"

const provider = new JsonRpcProvider(process.env.RPC_URL)
const iface = new Interface(["event Blacklisted(address indexed _account)"])

const logs = await provider.getLogs({
  address: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  topics: [iface.getEvent("Blacklisted")!.topicHash],
})

for (const log of logs) console.log(iface.parseLog(log)?.args)
JSON-RPC (eth_getLogs)
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "eth_getLogs",
  "params": [
    {
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "topics": [
        "0xffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b855"
      ],
      "fromBlock": "latest"
    }
  ]
}
Solidity
event Blacklisted(address indexed _account);

// inside a function:
emit Blacklisted(_account);
Example

An example Blacklisted log, encoded and decoded

Placeholder values, not a real transaction: how each argument is stored in the topics and the data, and what decoding gives back.

Encoded (as the node returns it)
  • topic0keccak256("Blacklisted(address)")0xffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b855
  • topic1_account0x0000000000000000000000001111111111111111111111111111111111111111
  • data0x
Decoded with the ABI
  • _accountaddress · indexed0x1111111111111111111111111111111111111111
FAQ

Frequently asked questions

What is the topic0 of the Blacklisted (USDC) event?

0xffa4e6181777692565cf28528fc88fd1516ea86b56da075235fa575af6a4b855: the keccak-256 hash of Blacklisted(address).

Which Blacklisted (USDC) arguments are indexed?

_account is indexed and sit in the log's topics.

How do I get an alert when a contract emits Blacklisted (USDC)?

Open one of the ready-made rules on this page, or add any contract and pick Blacklisted (USDC) from the event list. Conditions can be set on indexed and non-indexed arguments, and each alert names the contract and links to the transaction.

Keep exploring

More event signatures and tools

Know the moment a contract emits it

The Beta plan is free: one wallet and one contract, no credit card.