Skip to main content

Telecom Data Model

High-level entity-relationship model for DePIN telecom networks.

Core Principle

Data flows where value flows. In traditional telecom, carriers own the data. In DePIN telecom, the network generates shared, verifiable data that enables new value creation.

See Telecom Principles for the immutable truths this model serves.


Entity Domains

┌─────────────────────────────────────────────────────────────────────────────┐
│ TELECOM DATA MODEL │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ INFRA │ │ NETWORK │ │ ECONOMIC │ │ TRUST │ │
│ │ DOMAIN │ │ DOMAIN │ │ DOMAIN │ │ DOMAIN │ │
│ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │
│ │ │ │ │ │
│ ▼ ▼ ▼ ▼ │
│ Hotspots Coverage Tokens Attestations │
│ Antennas Sessions Rewards Proofs │
│ Backhaul Traffic Credits Reputation │
│ Locations Quality Settlements Compliance │
│ │
└─────────────────────────────────────────────────────────────────────────────┘

Entity Relationship Diagram

                                    ┌──────────────┐
│ OPERATOR │
│──────────────│
│ wallet_addr │
│ reputation │
│ stake_amount │
└──────┬───────┘

┌────────────────┼────────────────┐
│ owns │ earns │ stakes
▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ HOTSPOT │ │ REWARD │ │ TOKEN │
│──────────────│ │──────────────│ │──────────────│
│ device_id │ │ epoch │ │ token_type │
│ location │ │ amount │ │ total_supply │
│ status │ │ reward_type │ │ burn_rate │
│ antenna_gain │ │ timestamp │ │ price │
└──────┬───────┘ └──────────────┘ └──────┬───────┘
│ │
┌──────────────┼──────────────┐ │
│ provides │ witnesses │ │ burned_for
▼ ▼ ▼ ▼
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ COVERAGE │ │ PROOF │ │ SESSION │ │ DATA_CREDIT │
│──────────────│ │──────────────│ │──────────────│ │──────────────│
│ hex_id │ │ challenge_id │ │ session_id │ │ amount │
│ signal_str │ │ beacon_tx │ │ start_time │ │ dc_per_byte │
│ coverage_rad │ │ witnesses[] │ │ end_time │ │ burned_at │
│ last_update │ │ validity │ │ bytes_tx │ │ purpose │
└──────┬───────┘ └──────────────┘ └──────┬───────┘ └──────────────┘
│ │
│ serves │ used_by
▼ ▼
┌──────────────┐ ┌──────────────┐
│ USER │◄─────────────────│ DEVICE │
│──────────────│ connects │──────────────│
│ user_id │ │ device_id │
│ plan_type │ │ device_type │
│ data_credits │ │ last_seen │
│ usage_hist │ │ data_used │
└──────────────┘ └──────────────┘

Core Entities

Infrastructure Domain

EntityDescriptionKey AttributesRelationships
OperatorEntity that deploys and maintains hotspotswallet_addr, reputation_score, stake_amount, locationowns Hotspots, earns Rewards, stakes Tokens
HotspotPhysical device providing network coveragedevice_id, location (lat/long/h3), status, antenna_gain, elevationowned_by Operator, provides Coverage, witnesses Proofs
AntennaRadio equipment attached to hotspottype, gain_dbi, direction, heightattached_to Hotspot
LocationGeographic position with H3 hex indexingh3_index, lat, long, elevation, terrain_typecontains Hotspots, defines Coverage

Network Domain

EntityDescriptionKey AttributesRelationships
CoverageGeographic area with usable signalhex_id, signal_strength, coverage_radius, last_verifiedprovided_by Hotspot, serves Users
SessionActive data transfer connectionsession_id, start_time, end_time, bytes_transferred, quality_scoreuses Hotspot, consumes Data_Credits
TrafficAggregated network usage dataperiod, total_bytes, unique_users, avg_latencyaggregates Sessions
QualityService quality measurementslatency_ms, packet_loss, jitter, uptime_pctmeasured_for Hotspot, Session

Economic Domain

EntityDescriptionKey AttributesRelationships
TokenNetwork cryptocurrency (HNT, MOBILE)token_type, total_supply, circulating, burn_rate, price_usdearned_by Operators, burned_for Data_Credits
RewardToken distribution to operatorsepoch, amount, reward_type (coverage/data/witness), timestampearned_by Operator, paid_in Token
Data_CreditUsage token (fixed USD price)amount, dc_per_byte, burned_at, purposeburned_from Token, consumed_by Session
SettlementInter-carrier payment recordsettlement_id, parties[], amount, settlement_time, statussettles Traffic between Carriers

Trust Domain

EntityDescriptionKey AttributesRelationships
ProofCoverage verification recordchallenge_id, challenger, beacon_tx, witnesses[], validity, timestampproves Coverage, witnessed_by Hotspots
AttestationQuality claim with cryptographic proofattestation_id, claim_type, claim_value, signature, timestampattests Quality, signed_by Operator
ReputationOperator trust scoreoperator_id, score, factors[], history[]scored_for Operator
ComplianceRegulatory compliance recordjurisdiction, requirement, status, evidence[]applies_to Operator, Hotspot

Key Relationships

The Coverage Loop

Operator deploys Hotspot

Hotspot provides Coverage

Coverage serves Users

Users create Sessions

Sessions burn Data_Credits

Data_Credits burn Tokens

Protocol mints Rewards

Rewards paid to Operator

Operator deploys more Hotspots

The Verification Loop

Hotspot receives Challenge

Hotspot transmits Beacon

Nearby Hotspots Witness

Witnesses submit Proofs

Protocol validates Proofs

Valid Proof generates Reward

Invalid Proof reduces Reputation

Data Flow Patterns

Real-Time Flows

FlowSourceDestinationFrequencyPurpose
Coverage beaconHotspotWitnessesPer challengeProof of coverage
Session dataDeviceHotspotContinuousUsage metering
Quality metricsHotspotOraclePer minuteQoS monitoring
Reward calculationProtocolOperatorPer epochIncentive distribution

Batch Flows

FlowSourceDestinationFrequencyPurpose
Traffic aggregationSessionsAnalyticsHourlyDemand forecasting
Settlement calculationTrafficCarriersDailyInter-carrier billing
Reputation updateProofsOperatorsPer epochTrust scoring
Coverage mappingProofsCoverage DBContinuousNetwork visualization

Traditional vs DePIN Data Model

AspectTraditional CarrierDePIN Network
OwnershipCarrier owns all dataShared, on-chain
AccessSiloed, proprietaryOpen, permissioned
VerificationSelf-reportedCryptographic proofs
LatencyBatch (monthly)Real-time
Trust modelContracts, SLAsVerification, reputation
Settlement30-90 daysAtomic, instant

Implementation Considerations

On-Chain vs Off-Chain

DataOn-ChainOff-ChainRationale
Hotspot registrationOwnership proof
Coverage proofsVerification
Token transfersSettlement
Session detailsVolume, privacy
Quality metrics✓ (oracle)Frequent updates
Traffic analyticsAggregation

Indexing Strategy

EntityPrimary IndexSecondary IndexesQuery Pattern
Hotspotdevice_idlocation (H3), operatorLookup, geo-query
Coveragehex_idsignal_strengthGeo-query, filtering
Sessionsession_iduser_id, hotspot_id, timeLookup, aggregation
Rewardepoch + operatorreward_typeTime-series, aggregation

Context