zenith-docs/docs/overview/lockdrop-onboarding.md
2025-11-28 15:34:21 -05:00

8.8 KiB

Lockdrop Onboarding

The lockdrop onboarding process is the critical mechanism through which Azimuth point owners commit to the Zenith network and secure their initial $Z token allocation. This process occurs during Stage 0 and determines eligibility for the initial token distribution at TGE.

!!! warning "Initial Allocation Requirement" Participating in the lockdrop guarantees an initial $Z allocation at TGE. However, lockdrop participation is not required to earn $Z as a network operator once that feature is enabled in Stage 2. Operators who join later can still earn $Z through active participation, but will not receive initial allocation.

Overview

The lockdrop serves multiple purposes. It demonstrates real economic commitment to network success, secures initial $Z token allocation at TGE, links Azimuth point ownership to Zenith participation, and creates the initial economic foundation for the network.

Contract Details

The repository is available at zenith-lockdrop. The testnet deployment is on Sepolia, and the mainnet contract will be deployed when Stage 0 begins following a professional security audit.

Point Ownership

Participants must own the required Azimuth points registered in the Ethereum Azimuth registry. See Roles & Responsibilities for specific ownership requirements by participant type.

Lockdrop Participation

Participants must deposit their owned Azimuth points into the lockdrop contract and choose a commitment duration between 1-5 years, which affects future reward multipliers. This demonstrates real commitment through economic risk, and points cannot be withdrawn until the commitment period ends.

Attestation Submission

Participants must provide both Ethereum and Zenith cryptographic signatures as proof of point ownership. This links Azimuth identity to a Zenith account and must be submitted during the 6-month Stage 0 period.

Participation Process

Step 1: Prepare for Onboarding

Verify Point Ownership

# Verify your points in Azimuth registry
# Check ownership status and any restrictions

Set Up Wallets

Participants need an Ethereum wallet (MetaMask or hardware wallet) with point control and a new Zenith account for blockchain participation. Secure backup of all cryptographic keys is essential.

Step 2: Lockdrop Participation

Access Onboarding Application

The onboarding application is available at onboarding.zenith-test.tlon.systems and requires a modern web browser with wallet support. Participants must be connected to Ethereum mainnet (or Sepolia for testing).

Connect Wallets

  1. Connect Ethereum Wallet: Connect wallet containing your Azimuth points
  2. Auto-Generate Zenith Account: App automatically creates Zenith account
  3. Point Detection: App fetches your owned points from live Azimuth watcher
  4. Selection: Choose which points to commit to lockdrop

Create Attestations

The onboarding process creates a nested attestation structure:

┌────────────────────────────────────────────────────────┐
│                    ATTESTATION STRUCTURE               │
├────────────────────────────────────────────────────────┤
│  Outer Layer (Zenith Signature):                       │
│  ┌───────────────────────────────────────────────────┐ │
│  │ Zenith Payload:                                   │ │
│  │ • zenith_address: zenith1j66ujjcuv2l4d...         │ │
│  │ • message: "Onboarding my validator..."           │ │
│  │ • ethereum_payload: ┌───────────────────────────┐ │ │
│  │                     │ Inner Layer (ETH Sig):    │ │ │
│  │                     │ • eth_address: 0x5dc6...  │ │ │
│  │                     │ • msg: "Onboarding..."    │ │ │
│  │                     │ • owned_points:           │ │ │
│  │                     │   - galaxy: "~byt"        │ │ │
│  │                     │   - stars: ["~mipbyt"]    │ │ │
│  │                     └───────────────────────────┘ │ │
│  └───────────────────────────────────────────────────┘ │
│  Signatures:                                           │
│  • Zenith Signature: xv6BkXuB03uCMS9QLHsS...           │
│  • ETH Signature: 0x1621de2ce664a7e201e43bae...        │
└────────────────────────────────────────────────────────┘

Step 3: Blockchain Submission

Submit to Stage 0 Chain

Attestations are submitted to the single Tlon-operated zenithd validator, with gas fees paid using znt tokens from a faucet. Participants receive transaction confirmation on the testnet, and attestations are stored on the Stage 0 blockchain for later verification.

Verification Status

Stage 0 accepts all attestations with limited verification, collecting all submissions for later processing. Full verification occurs during TGE between Stage 0 and Stage 1.

Critical Timing and Deadlines

Stage 0 Duration

The Stage 0 phase lasts 6 months from lockdrop contract deployment, and participants must complete onboarding within this period. There is a hard deadline with no extensions for late participation.

Economic Implications

Initial Token Allocation Rights

Lockdrop participation directly determines initial $Z allocation at TGE. Galaxy owners (who must also own an associated star) are eligible for validator allocations, while star-only participants are eligible for bundler allocations. Longer commitments may receive allocation bonuses, with each participant's share determined relative to total network participation.

!!! info "Future Operator Participation" Starting in Stage 2, operators can join the network and earn $Z through active participation even without lockdrop participation. However, they will not receive the initial allocation reserved for lockdrop participants.

Future Value Accrual

Different participant types earn tokens differently. Galaxies earn through active block validation, stars earn through transaction bundling services, and service providers earn additional tokens through optional network services. All participants need $Z to pay transaction fees.

Verification Process (Between Stages)

What Gets Verified

During TGE, all Stage 0 attestations undergo rigorous verification:

  1. Signature Verification: Both Ethereum and Zenith signatures verified
  2. Point Ownership: Claimed points verified against live Azimuth registry
  3. Lockdrop Status: Lockdrop participation confirmed on Ethereum L1
  4. Data Integrity: All attestation data checked for consistency

Verification Outcomes

Verified participants proceed to Stage 1 with initial token allocations, while those who fail verification are excluded from the initial $Z allocation. Verification is final with no appeals or second chances, and failed participants lose their lockdrop commitments and initial allocation rights. However, they may still join as operators in Stage 2 to earn $Z through active participation.

Testing and Simulation

Lockdrop Simulation

Comprehensive simulation tools are available at lockdrop-simulation that allow participants to test the complete lockdrop workflow without real assets. These tools cover the full network lifecycle from Stage 0 through Stage 1, enabling developers and participants to practice the process and understand how different lockdrop durations (1-5 years) affect their allocations.

Testnet Environment

The contract is available on the Ethereum Sepolia testnet where participants can use test Azimuth points for practice. This provides safe testing with no real economic value at risk, allowing users to validate their understanding before mainnet.

!!! success "Next Steps" After completing lockdrop onboarding, participants wait for TGE where their attestations are verified and they receive initial $Z allocations if verification succeeds. See Network Stages for what happens next.