How to Inspect the Live Registry

Show all entries

ckb-firewall inspect

Shows all entries in the current registry cell with their status (active or expired), expiry timestamps, and governance header metadata (validator count, threshold, treasury balance). For the full CLI options, see the CLI reference — inspect.

With a custom registry

ckb-firewall inspect \
  --rpc-url https://testnet.ckb.dev \
  --registry-tx <tx-hash> \
  --registry-index <index>

Check a single address

ckb-firewall check --lock-args 0xabc123...

Returns whether the address is currently blacklisted. Checks both lock args and (if configured) type args.

From the SDK

import { findRegistryCell, fetchRegistryPayload } from "@ckb-firewall/sdk";
// findRegistryCell — discovers current outpoint via indexer
// fetchRegistryPayload — fetches and parses the BLKL v2 payload

const { txHash, index } = await findRegistryCell(rpcUrl, registrySpec);
const registry = await fetchRegistryPayload(rpcUrl, txHash, index);

console.log(`Entries: ${registry.entries.length}`);
for (const entry of registry.entries) {
  const expired = entry.expiresAt !== 0n && entry.expiresAt < BigInt(Math.floor(Date.now() / 1000));
  console.log(`${entry.identifier} — ${expired ? "expired" : "active"}`);
}