MyTXO Documentation

infoPlatform Overview

MyTXO is a Bitcoin-native social platform where users create permanent digital identities inscribed as Ordinals. There was a golden age when your social identity and music discovery were inseparable. We're bringing it back — permanently, on Bitcoin.

Brand Pillars

• verified_user "Your identity, your rules" — True ownership on Bitcoin
• badge "A place for legends" — Permanence, legacy, creator-first
• history "The golden age returns" — Organic discovery, no algorithms
• public "Built on Bitcoin, accessible to everyone" — No crypto jargon
• stars "One UTXO, infinite expression" — Responsible, efficient inscribing

hubOP_NET Smart Contracts

MyTXO runs on OP_NET, a Bitcoin Layer 1 smart contract platform. Three core contracts power on-chain identity, social graph, and content. All contracts are deployed on OP_NET testnet.

Deployed on OP_NET testnet (Bitcoin L1). Contract calls require a connected wallet and gas costs are paid in testnet sats.

account_balance_walletWallet Integration

MyTXO uses the OP_NET WalletConnect SDK (@btc-vision/walletconnect) to connect wallets. All on-chain actions require a connected wallet.

personProfile System

Wallet-first registration and on-chain profile data. Profiles live at clean URLs and display data stored directly on OP_NET.

articleContent Model

Two content types: blurbs (short) and blogs (long-form). Both are minted as on-chain tokens and can appear in the feed.

rss_feedOn-Chain Feed

The feed scans OP_NET blocks for contract events and surfaces activity across the platform.

device_hubYOUTXO Protocol v2.0

The YOUTXO Protocol separates concerns across three sat ranges on a single UTXO. Each user gets one UTXO that serves as their entire on-chain identity, from their Creator Card to every piece of content they ever publish.

Feature cards (sat4-19) are the presentation/logic layer — they contain display code that knows how to render content. Content sats (sat20+) are the data layer — raw JSON payloads reinscribed with each new piece of content. When a user posts a blurb, sat20 is reinscribed with the latest blurb JSON, which includes a previous pointer forming a linked list.

mapSat Allocation Map

Card Range (sat0-3) — Inscribed at account creation

Feature Range (sat4-19) — Inscribed when features activate

Content Range (sat20+) — Reinscribed with each new piece of content

Inscription Costs (Estimated)

trending_upThe Utility Ladder

Progressive value — start with a simple business card for a few dollars, grow into a full on-chain social identity over time. Each level builds on the previous.

dnsArchitecture

Tech Stack

Container Layout

services:
  app:     # mytxo-app — Next.js production build
           # Exposed: 127.0.0.1:8086 -> :3000
  opnet:   # mytxo-opnet — OP_NET smart contract API
           # OP_NET SDK + Subfrost JSON-RPC, :4000
  db:      # mytxo-db — PostgreSQL 17 Alpine
           # Internal network only, persisted volume
  redis:   # mytxo-redis — Redis 7 Alpine
           # Internal network only, persisted volume

# Host Caddy: mytxo.space -> localhost:8086 (auto-SSL)
# mytxo-app calls mytxo-brc20 internally via http://brc20:4000

lockAuthentication

X OAuth 2.0 Flow

Passkey Wallet Flow (PassSeeds)

The passkey wallet follows the PassSeeds approach (reference: github.com/bitbragi/passseeds). WebAuthn PRF extension is used for seed derivation, with a fallback of hashing the P-256 public key from attestation. BIP86 taproot derivation paths produce four addresses: Creator ID, Inscriptions, Payments, and Signing.

starFeatures

Powerful tools made accessible through intuitive wizards.

starsInscription System

All signing happens in the user's wallet. The backend never holds private keys. PSBTs are constructed client-side, signed by the wallet, and broadcast via mempool.space API.

Structured Properties (tag 17)

Every inscription carries protocol metadata:

--trait "protocol" "youtxo"
--trait "component" "master|identity|card-html|card-css|feature-*|content-*"
--trait "version"  "1.0"        (identity)
--trait "locked"   "true"       (card-html)
--trait "edition"  "default"    (card-css)

codeAPI Reference

Auto-generated from the codebase. Run npm run docs:generate to refresh.

toll$MYTXO Token

Staking & Fee Discounts

Maximum 21,000 users can achieve zero fees (1M tokens each = 21B supply).

timelineRoadmap

paletteDesign System

"MySpace Nostalgia + Clean Modern Structure" — Bold blues, square corners, visible structure, and personality. Verdana for all text provides the authentic MySpace feel with consistent rendering across every device and platform.

Typography

Color Palette

Key Design Rules

1. ZERO border radius on structural elements (cards, buttons, inputs)
2. Visible 1-2px solid borders on cards, not box-shadows
3. Deep blue sticky header with subtle glass effect
4. Light grey page background (#D4D4D4)
5. White card backgrounds with solid borders
6. Glass effects ONLY on header, modals, tooltips, toasts
7. Material Icons (Classic Outlined) for all icons — no emojis
8. Square buttons with visible borders and bold text
9. Gold accents for Bitcoin/premium elements
10. Dense information layout, personality over empty minimalism
11. Retro hover effects: color shifts, underlines (not subtle opacity fades)
12. Verdana for all text (authentic MySpace font stack)