Users sign up for World ID by visiting a Worldcoin Operator and verifying their unique personhood at an Orb. The Orb uses iris biometrics to establish an individual’s unique personhood and then creates a digital World ID, which is stored on the users device using a compatible identity wallet. World App is built on top of Safe's smart contract accounts and also serves as an identity wallet.

Worldcoin is an open source protocol primarily consisting of World ID - a privacy-preserving digital identity and World App - a fully self custodial wallet. Worldcoin was founded by Sam Altman, Alex Blania and Max Novendstern and publicly launched in July 2023.

Worldcoin is currently governed by the Worldcoin Foundation, but intends to decentralize governance over time. Worldcoin's investors include a16z, Multicoin Capital, 1confirmation, CoinFund etc.

github

twitter

discord

etherscan

website

Infrastructure

Worldcoin

# Worldcoin Active addresses (weekly) Methodology

## 1. Overview

Weekly active addresses for Worldcoin measures the distinct number of unique addresses that were active within any 7-day rolling window. This metric combines activity from two blockchain networks: verified Worldcoin wallet creators on Optimism and transaction senders on Worldchain. The calculation uses HyperLogLog sketches for efficient distinct counting across rolling time windows and treats active users as equivalent to active addresses following blockchain analytics conventions.

## 2. Data sources

- **Optimism event logs**: Parsed `SafeSetup` events with topic hash `0x141df868a6331af528e38c83b7aa03edc19be66e37ae67f9285bf4f8e3c6a1a8` emitted by Worldcoin smart contract wallets during creation
- **Optimism transaction records**: Transaction data used to validate that wallet creation events originate from authorized Worldcoin wallet creator addresses  
- **Worldchain transaction records**: All transaction data from the Worldchain network to identify transaction senders as active users
- **Wallet creator whitelist**: Hardcoded list of 23 authorized Worldcoin wallet creator addresses used for filtering legitimate wallet creation activity

## 3. Step-by-step calculation

### Component A: Worldcoin user identification on Optimism
- **Purpose**: Identifies legitimate Worldcoin wallet creation events on Optimism network
- **Logic**: Extracts `SafeSetup` events from Optimism event logs using the specific topic hash `0x141df868a6331af528e38c83b7aa03edc19be66e37ae67f9285bf4f8e3c6a1a8`. Filters these events to only include those from transactions sent by one of 23 whitelisted wallet creator addresses (e.g., `0x7861b53731f4f29108e31c2b38dbbbc754ae6453`). Joins wallet creation events with authorized creator transactions using `transaction_hash` to ensure only verified Worldcoin wallet creations are counted. Data starts from June 1, 2023.
- **Key fields**: `block_timestamp` for timing, `user_address` for the created wallet address, `transaction_hash` for linking events to creator transactions, `from_address` for creator validation

### Component B: Worldchain user identification  
- **Purpose**: Identifies all transaction activity on the Worldchain network
- **Logic**: Extracts all transaction records from Worldchain blockchain data. Every transaction sender (`from_address`) is considered an active user. No additional filtering is applied since all Worldchain activity is considered legitimate Worldcoin ecosystem usage.
- **Key fields**: `block_timestamp` for timing, `from_address` as the active user address

### Component C: Daily active user aggregation
- **Purpose**: Combines and deduplicates users across both networks on daily boundaries
- **Logic**: Truncates all timestamps to daily granularity using `timestamp_trunc`. Creates distinct combinations of day, chain, user type, and user address. Unions Optimism wallet creators (labeled as "Wallet creator" user type) with Worldchain transaction senders (labeled as "Transaction sender" user type). This produces a clean daily view of unique active users across both networks.
- **Key fields**: `timestamp` (daily), `chain` (optimism or worldchain), `user_type` (Wallet creator or Transaction sender), `user_address`

### Component D: HyperLogLog sketch creation
- **Purpose**: Efficiently tracks distinct users using probabilistic data structures
- **Logic**: For each day, creates HyperLogLog sketches of distinct user addresses grouped by chain and user type. Uses precision parameter of 15 for HLL initialization. These sketches enable efficient merging across time windows without storing individual addresses.
- **Key fields**: `timestamp`, `chain_id`, `user_type`, `hll` (HyperLogLog sketch)

### Component E: Rolling 7-day window calculation
- **Purpose**: Calculates weekly active users using rolling 7-day windows
- **Logic**: Generates complete datespine from earliest data date to yesterday to ensure no missing days. For each day in the datespine, creates a window covering that day plus the previous 6 days (total 7 days) using the jointables approach. Joins window days with corresponding HLL sketches. Merges HLL sketches across each 7-day window using `hll_count.merge_partial`. Extracts final distinct user counts from merged sketches using `hll_count.extract`.
- **Key fields**: `timestamp` (end date of window), `user_wau` (weekly active user count)

### Component F: Dimensional breakdown
- **Purpose**: Provides multiple analytical perspectives on weekly active users
- **Logic**: Calculates WAU across four dimensions: project level (project_dbt_tag), chain level, user type level, and product level. Each breakdown aggregates the merged HLL sketches differently, setting unused dimension fields to null. Unions all dimensional breakdowns into a single result set.
- **Key fields**: `dimensions` (breakdown type), `chain_id`, `user_type`, `product_id`, `user_wau`

### Final aggregation
- **Combining components**: Filters the dimensional WAU results to include only 'chain' and 'project_dbt_tag' breakdowns, providing both individual chain metrics and overall project-level metrics
- **Currency conversion**: No currency conversion required as this is a count-based metric
- **Time aggregation**: Uses rolling 7-day windows ending on each day, providing daily time series of weekly active user counts
- **Final calculation**: Renames `user_wau` to `active_addresses_weekly` following blockchain convention where active users equal active addresses. Applies finalization logic with zero-filling strategy to ensure complete time series without gaps. The final metric represents the distinct count of addresses that were active within any 7-day period ending on the specified date.

*This methodology was automatically generated by Token Terminal's methodology analyzer.*

Unique active addresses over a rolling 7-day window.

WorldcoinWLD

Active addresses (weekly)

Active addresses (weekly)

Competitive landscape

Chain breakdown