Skip to content

feat: implement BLE swarm registry system#99

Draft
aliXsed wants to merge 1 commit intomainfrom
aliX/swarm-manager
Draft

feat: implement BLE swarm registry system#99
aliXsed wants to merge 1 commit intomainfrom
aliX/swarm-manager

Conversation

@aliXsed
Copy link
Collaborator

@aliXsed aliXsed commented Feb 6, 2026

BLE Swarm Registry System with Geographic Tiered Bonding

A complete BLE tag registry enabling decentralized device discovery using cryptographic membership proofs.

Core Contracts

  • FleetIdentity (ERC-721): UUID-based fleet ownership with geographic registration
    • Two-level registration: Country (ISO 3166-1) or Local (admin area)
    • Geometric bond tiers: BASE_BOND * 2^tier (local), *16 for country
    • Operator delegation for cold/hot wallet separation
    • O(1) setOperator via uuidTotalTierBonds tracking
  • ServiceProvider (ERC-721): Service endpoint URL ownership
  • SwarmRegistryL1: SSTORE2 filter storage for Ethereum L1
  • SwarmRegistryUniversal: Native bytes storage for ZkSync Era

Registration Model

Scenario Who Pays Amount
Fresh registration Caller (becomes owner+operator) BASE_BOND + tierBond
Owned to Registered Operator only tierBond
Multi-region Operator tierBond per region
Burn (non-last) Refund to operator tierBond
Burn (last token) Refund operator gets tierBond, owner gets BASE_BOND

Discovery

  • buildHighestBondedUuidBundle: Priority-ordered bundle (up to 20 UUIDs)
  • XOR filter membership verification for tag validation
  • Inclusion hints (localInclusionHint, countryInclusionHint) for optimal tier selection

Documentation

Complete technical specification in src/swarms/doc/:

Checklist

  • Tier 0 livelock prevention (operator-only registration with tier param)
  • O(1) setOperator via uuidTotalTierBonds storage tracking
  • BASE_BOND refund only on last burn
  • Documentation updated
  • Review tests

@aliXsed aliXsed force-pushed the aliX/swarm-manager branch from 52bb4af to 538047d Compare February 6, 2026 07:55
@aliXsed aliXsed force-pushed the aliX/swarm-manager branch from 401a465 to 483982d Compare March 2, 2026 01:39
@aliXsed aliXsed changed the title feat: implement BLE swarm registry system with dual-chain support feat: implement BLE swarm registry system with geographic tiered bonding Mar 2, 2026
@aliXsed aliXsed changed the title feat: implement BLE swarm registry system with geographic tiered bonding feat: implement BLE swarm registry system Mar 2, 2026
…red bonding

Core Contracts:
- FleetIdentity (ERC-721): UUID-based fleet ownership with geographic registration
  - Two-level registration: Country (ISO 3166-1) or Local (admin area)
  - Geometric bond tiers: BASE_BOND * 2^tier (local), *16 for country
  - Operator delegation for cold/hot wallet separation
  - O(1) setOperator via uuidTotalTierBonds tracking
- ServiceProvider (ERC-721): Service endpoint URL ownership
- SwarmRegistryL1: SSTORE2 filter storage for Ethereum L1
- SwarmRegistryUniversal: Native bytes storage for ZkSync Era

Registration Model:
- Fresh registration: caller becomes owner+operator, pays BASE_BOND + tierBond
- Owned-to-Registered: only operator can register, pays tierBond
- Multi-region: same UUID can register in multiple regions at same level
- Burn refunds: BASE_BOND to owner (on last token), tierBond to operator

Discovery:
- buildHighestBondedUuidBundle: priority-ordered bundle (up to 20 UUIDs)
- XOR filter membership verification for tag validation
- Inclusion hints for optimal tier selection

Documentation:
- Complete technical specification in src/swarms/doc/
- ISO 3166-2 admin area mappings for 18 countries
@aliXsed aliXsed force-pushed the aliX/swarm-manager branch from 3bc4f36 to 540f23a Compare March 2, 2026 03:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant