ERC-8004 Events - Allium Documentation Hub

The gnosis.agents.erc8004_events table contains all decoded ERC-8004 protocol events on Gnosis. Each row is a single event — registrations, metadata updates, feedback submissions, revocations, and responses — with event-specific fields in the extra_fields VARIANT column. For full extra_fields reference and example queries, see the crosschain ERC-8004 events docs.

Table Details

Property	Value
Table Name	`gnosis.agents.erc8004_events`
Table Status	Production-Ready
Unique Key	`transaction_hash`, `log_index`
Clustering Key(s)	`to_date(block_timestamp)`, `event_name`

Table Columns

Column Name	Data Type	Description
event_name	VARCHAR	Event type: `Registered`, `URIUpdated`, `MetadataSet`, `NewFeedback`, `FeedbackRevoked`, `ResponseAppended`
agent_id	VARCHAR	Numeric agent NFT ID.
chain	VARCHAR	Network name.
registry_type	VARCHAR	Registry type: `identity` or `reputation`.
registry_address	VARCHAR	Registry contract address.
registry_name	VARCHAR	Registry name: `IdentityRegistry` or `ReputationRegistry`.
is_official	BOOLEAN	Whether the event is from an official ERC-8004 registry.
extra_fields	VARIANT	Event-specific decoded parameters as JSON.
block_timestamp	TIMESTAMP_NTZ(9)	The timestamp when the event occurred.
transaction_hash	VARCHAR	The transaction hash containing this event.
transaction_from_address	VARCHAR	The address of the transaction signer.
transaction_to_address	VARCHAR	The address of the transaction recipient.
block_number	NUMBER(38,0)	The block number containing this event.
block_hash	VARCHAR	The hash of the block containing this event.
log_index	NUMBER(38,0)	The position of the event log within the transaction.
unique_id	VARCHAR	Unique identifier for the event.
_created_at	TIMESTAMP_NTZ(9)	The timestamp when the record was created.
_updated_at	TIMESTAMP_NTZ(9)	The timestamp when the record was last updated.

Sample Query

SELECT
    DATE_TRUNC('day', block_timestamp)::DATE AS dt,
    event_name,
    COUNT(*) AS events
FROM gnosis.agents.erc8004_events
WHERE block_timestamp >= CURRENT_DATE - INTERVAL '30 days'
GROUP BY ALL
ORDER BY dt, events DESC;

​Table Details

​Table Columns

​Sample Query

Table Details

Table Columns

Sample Query