Skip to content

clarkezyz/EphemeralChain

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EphemeralChain

A proof-of-concept blockchain exploring temporal economics and memorable authentication

EphemeralChain demonstrates two novel concepts in blockchain design:

  1. Ephemeral Economics — Coins reset monthly while NFTs persist forever, preventing speculation toxicity and enabling fair, fresh-start economies
  2. FourWord Authentication — 4 memorable words + 1 number creates a universal crypto identity across 14+ blockchains

This is research/portfolio code exploring alternatives to traditional blockchain assumptions.

The Ideas

Ephemeral Economics: What If Coins Reset Monthly?

Traditional cryptocurrencies are designed for permanence. This creates:

  • Wealth accumulation and "rich get richer" dynamics
  • Speculation-driven toxicity
  • Barrier to entry for new participants
  • Hoarding behavior that reduces utility

EphemeralChain inverts this:

Asset Type Behavior Purpose
Coins Reset to 100 every month Engagement, not speculation
NFTs Persist forever Meaningful ownership

This creates economies optimized for participation rather than accumulation. Every month is a fresh start. Long-term value comes from NFTs (which must be deliberately acquired), not from hoarding coins.

Use cases:

  • Gaming economies where new players can compete immediately
  • Social platforms with engagement incentives, not financial ones
  • Art/collectible systems where attention is ephemeral but ownership is permanent

FourWord: What If Crypto Onboarding Took 30 Seconds?

Traditional crypto onboarding:

"Write down these 12 random words. Never lose them. Never share them.
If you forget them, your money is gone forever."

→ 90% abandonment rate

Traditional web onboarding:

"Create a username. Create a password (8+ characters, uppercase, number,
symbol). Confirm password. Enter email. Check email. Click verification link."

→ 5+ minutes, significant friction

FourWord authentication:

"coffee sunset mountain river 42"

→ Done. You have wallets on Bitcoin, Ethereum, Solana, and 11 other chains.
→ Takes 30 seconds. Memorable. No email required.

The same 4 words + number deterministically generate addresses across all major blockchains. Users think they're creating an app account; they're actually getting a universal Web3 identity.

How It Works

Blockchain Architecture

┌─────────────────────────────────────────────────────────────┐
│                    EphemeralChain                           │
├─────────────────────────────────────────────────────────────┤
│  Blocks (immutable transaction history)                     │
│    └── Transactions: transfers, mints, burns, resets        │
├─────────────────────────────────────────────────────────────┤
│  Wallets (current state)                                    │
│    ├── coins: float (EPHEMERAL - resets monthly)           │
│    ├── nfts: list (PERMANENT - survives forever)           │
│    └── address: derived from 4-word credentials            │
├─────────────────────────────────────────────────────────────┤
│  Monthly Reset                                              │
│    ├── All coin balances → 100                             │
│    ├── All NFT ownership → unchanged                        │
│    └── Transaction history → preserved (immutable)         │
└─────────────────────────────────────────────────────────────┘

Address Derivation

          ┌─────────────────────────────────────┐
          │  "coffee sunset mountain river 42"  │
          └──────────────────┬──────────────────┘
                             │
                      ┌──────┴──────┐
                      │ HMAC-SHA512 │
                      │ Master Seed │
                      └──────┬──────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
   ┌────┴────┐          ┌────┴────┐          ┌────┴────┐
   │ Bitcoin │          │Ethereum │          │ Solana  │
   │  Path   │          │  Path   │          │  Path   │
   └────┬────┘          └────┬────┘          └────┬────┘
        │                    │                    │
   bc1q...              0x...                 ...

Same credentials → deterministic addresses on every supported chain.

Installation

git clone https://github.com/clarkezyz/EphemeralChain.git
cd EphemeralChain
python3 -m pip install -e .

No external dependencies required (uses only Python standard library).

Quick Start

from ephemeral_chain import EphemeralBlockchain, FourWordWallet, CrossChainDerivation

# Create blockchain instance
chain = EphemeralBlockchain()

# Create wallet with 4 words + number
alice = chain.create_wallet("morning", "coffee", "bright", "sun", 23)

# Award coins (ephemeral) and mint NFT (permanent)
chain.award_coins(alice, 50, "welcome_bonus")
chain.mint_nft(alice, "badge", {"name": "Early Adopter"})

# Check wallet status
info = chain.get_wallet_info(alice)
print(f"Coins: {info['coins']}, NFTs: {info['nft_count']}")

# Execute monthly reset
chain.monthly_reset()

# Coins reset to 100, but NFT is still there
info = chain.get_wallet_info(alice)
print(f"Coins: {info['coins']}, NFTs: {info['nft_count']}")  # 100 coins, 1 NFT

Cross-Chain Addresses

from ephemeral_chain import CrossChainDerivation

derivation = CrossChainDerivation()

# Same 4 words work everywhere
addresses = derivation.derive_all("morning", "coffee", "bright", "sun", 23)

print(addresses["ETHEREUM"])   # 0x...
print(addresses["BITCOIN"])    # bc1q...
print(addresses["SOLANA"])     # ...
print(addresses["POLYGON"])    # 0x...
# ... 14 chains total

Security Considerations

FourWord Entropy Analysis

Metric Value
Vocabulary assumption 10,000 common words
Practical vocabulary ~1,000 (users pick common words)
Number range 00-99
Theoretical combinations 10^16 (10 quadrillion)
Practical combinations 10^14 (100 trillion)
Entropy ~46 bits

Comparison:

  • BIP-39 12-word seed: ~128 bits
  • Strong password: ~50-60 bits
  • FourWord: ~46 bits

Threat Model

FourWord is designed for applications where:

Appropriate:

  • Gaming/social platform identity
  • Low-value transactions
  • Progressive security (add 2FA when value increases)
  • Non-custodial applications

Not appropriate:

  • High-value cryptocurrency storage
  • Financial applications requiring maximum security
  • Situations where collision = catastrophic loss

Progressive Security

The system is designed for security to grow with value:

Year 1:  "coffee sunset mountain river 42"  → Just an app account
Year 2:  Add 2FA                            → Medium security
Year 3:  Add biometric + email backup       → High security

Users start with friction-free onboarding. Security upgrades when needed.

Supported Blockchains

Chain Address Format Example
Ethereum 0x + 40 hex 0x1a2b3c...
Polygon 0x + 40 hex 0x1a2b3c...
Arbitrum 0x + 40 hex 0x1a2b3c...
Optimism 0x + 40 hex 0x1a2b3c...
Base 0x + 40 hex 0x1a2b3c...
Avalanche 0x + 40 hex 0x1a2b3c...
BSC 0x + 40 hex 0x1a2b3c...
Bitcoin bc1q... (Bech32) bc1q1a2b...
Lightning lnbc... lnbc1a2b...
Litecoin ltc1q... ltc1q1a2b...
Dogecoin D... (Base58) D1a2b3c...
Solana Base58 ABC123...
Cardano addr1... addr11a2b...
NEAR Hex 1a2b3c4d...

Project Structure

EphemeralChain/
├── ephemeral_chain/
│   ├── __init__.py           # Package exports
│   ├── blockchain.py         # Core blockchain with monthly resets
│   ├── wallet.py             # FourWord wallet authentication
│   └── address_derivation.py # Cross-chain address generation
├── examples/
│   └── basic_usage.py        # Demonstration script
├── README.md
└── LICENSE

Running the Demo

# Run the basic usage example
python3 examples/basic_usage.py

# Or run individual modules
python3 -m ephemeral_chain.blockchain
python3 -m ephemeral_chain.wallet
python3 -m ephemeral_chain.address_derivation

Design Philosophy

Why Centralized?

EphemeralChain is intentionally centralized. This is a feature, not a limitation.

Decentralization is a means, not an end. It solves specific problems:

  • Censorship resistance
  • Trustless operation
  • Byzantine fault tolerance

For many applications (games, social platforms, internal systems), these properties aren't needed. What is needed:

  • Instant finality (no waiting for confirmations)
  • Zero transaction fees
  • Simple UX
  • Cryptographic integrity (hashes, signatures, immutability)

EphemeralChain provides the cryptographic properties of a blockchain without the UX costs of decentralized consensus.

Why Monthly Resets?

The "number go up" mentality of traditional crypto creates toxic dynamics:

  • Early adopters accumulate insurmountable advantages
  • Speculation replaces utility
  • New users face barriers to meaningful participation

Monthly resets create:

  • Fresh starts — New users can compete immediately
  • Engagement focus — Coins are for using, not hoarding
  • Meaningful permanence — NFTs must be deliberately acquired
  • Anti-speculation — Can't get rich by doing nothing

Potential Applications

  1. Gaming Economies

    • Fair competition (monthly resets level the field)
    • Permanent collectibles (NFTs for achievements)
    • Cross-game identity (same wallet everywhere)
  2. Social Platforms

    • Engagement tokens that don't create inequality
    • Permanent reputation/badges
    • Zero-friction onboarding
  3. Art/Collectibles

    • Ephemeral attention economy
    • Permanent ownership for meaningful pieces
    • Low-barrier entry for creators
  4. Enterprise/Internal Systems

    • Employee recognition tokens (reset quarterly)
    • Permanent certifications/achievements
    • Simple identity management

Contributing

This is a research/portfolio project exploring novel blockchain concepts. Issues and discussions welcome.

License

MIT License — See LICENSE for details.

Author

Clarke Zyz — Exploring the intersection of cryptography, UX, and economic design.


"What if we optimized blockchains for humans instead of hodlers?"

About

Blockchain with non persistent economics and 4 a four word passphrase

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages