Skip to content

Latest commit

 

History

127 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bitcoin Universe: Bitcoin and Dogecoin metaprotocols in one place, with the source behind every number

Bitcoin Universe

One explorer and market for the Bitcoin and Dogecoin metaprotocols this application serves. Browse markets, look up an address, inspect an asset, and review a transaction before you sign it. Every number on screen can be traced back to the reader it came from, and a reading that failed says so instead of showing a zero.

Open the app · Protocol coverage · Guides · Data and availability · Safety · Report a security issue

Use https://www.bitcoinuniverse.io. The bare bitcoinuniverse.io address redirects to a different Bitcoin Universe application, so a link that drops the www will not open the pages described here.

What you can do

Without connecting a wallet:

  • Search a Bitcoin or Dogecoin address, a transaction, a block, an inscription, a sat, or a ticker, and land on the page that reads it. Search says so when it cannot resolve an input rather than guessing at one.
  • Browse markets by protocol family, with listings, floors, recent activity, and whichever holder or supply figures that protocol publishes.
  • Open a protocol's index and inspect individual assets. Not every protocol has a standalone index; the coverage page marks the ones that do.
  • Read what the application covers, and what "covered" does and does not mean.

With a self-custody wallet connected:

  • See your holdings grouped by network, protocol, and asset type.
  • List, update, and delist items in the markets that support it.
  • See the asset, the amount, the service fee, the network fee estimate, and the total before your wallet asks you to sign.
  • Watch a listing or a purchase appear in the market activity feed once it is on chain.

Start in under a minute

  1. Open www.bitcoinuniverse.io.
  2. Paste an address, a transaction ID, or a ticker into the search box at the top, or press Ctrl+K. Nothing here needs a wallet.
  3. Pick a market from Trade, or open Protocol coverage to see the full list and jump straight to the index or market for any row.

Connect a wallet only when you want to act. Read Market and wallet safety first if this is your first transaction.

Choose your path

You want to Start here
Look around without connecting Product tour, then the live markets
Understand what is covered Protocol coverage
Connect a wallet safely Market and wallet safety
See your own assets Manage assets from Portfolio
Buy from an Ordinals collection Browse an Ordinals collection market
Trade on the Ordex order book The Ordex market
Work with Atomicals Atomicals markets and Portfolio
Know where a number came from How data and availability work
List a collection you created Add an Ordinals collection
Understand an unavailable market Bitcoin data reliability
Report a problem Open an issue
Report a security issue SECURITY.md

Product tour

Every image below is the running product at www.bitcoinuniverse.io, captured without a wallet connected.

Home

The first screen states how many protocols this build serves, counted from the same registry that builds the routes, and offers four next steps. Nothing on it needs a wallet.

The Bitcoin Universe home screen: a headline counting the protocols this build serves, a sentence naming the families and chains with a link to the full list, and four start cards for connecting a wallet, buying, selling, and market activity

The same screen in dark theme.

The same home screen in dark theme

On a phone the same content stacks, and the four persistent destinations sit in a bottom bar that never covers the page.

The home screen on a phone, with the headline, the start cards stacked, and a bottom bar holding Home, Trade, Portfolio and More

Protocol coverage

One page lists what this build serves, grouped by family, with the index and the market for each row. The counts are computed from the same registry that builds the navigation, so the number on the page is the number of protocols the application can actually open.

The protocol coverage page: totals for protocols, families, chains, and how many have an index, then every row grouped by family with links to its index and its market

The whole application ships a light and a dark theme, and the coverage page is the same page in both.

The same protocol coverage page in dark theme

Markets

Each protocol family has a market with the same anatomy: a family picker, the period the figures cover, a searchable table, and an activity feed. Figures the reader did not return are shown as a dash, never as a zero.

The Ordinals market showing featured and top collections, a sortable collections table, and an activity feed

When a reader cannot be reached, the market says exactly that and offers a retry. It never presents a failed read as an empty market.

The Runes market showing the message that the order book did not answer, so the market could not be read, with a retry link and a Market unavailable table state

Explore an address

Paste any Bitcoin or Dogecoin address to see its holdings across the protocols Universe serves, with no wallet connected and nothing to sign.

The Explore address page with an address search field, a bulk watchlist input, and the list of protocols this view reads

Portfolio

Portfolio opens with what connecting gives you, and offers explore mode for anyone who would rather inspect a public address than connect.

The Portfolio page before a wallet is connected, offering connect, explore an address, browse markets, and wallet home

Networks, protocols, and actions

Bitcoin Universe serves protocol families on Bitcoin and on Dogecoin. The authoritative list is generated by the application itself and published at www.bitcoinuniverse.io/coverage: it names each protocol, its chain, its family, and whether it has an index page, a market, or both.

Covered means this application reads the protocol and serves it here. It does not mean that a market has listings right now, that a market has depth, that every action is available for that protocol, or that Universe operates the index behind every row.

Protocol coverage explains how to read that page and what each column means.

How data and availability work

flowchart LR
  R["You"] --> A["Bitcoin Universe app"]
  A --> P["Bitcoin Universe API"]
  P --> N["Universe-operated Bitcoin<br/>and Dogecoin services"]
  P --> X["External provider<br/>for some protocol families"]
  P --> H["indexer-health"]
  H --> A
Loading

indexer-health names the source, chain tip, lag, and last successful read for each protocol, and the application shows what it says rather than a summary of it.

Two different things are often confused, so they are stated separately.

Bitcoin and Dogecoin network data. Chain height, blocks, transactions, address activity, address UTXOs, and fee estimates come from Universe-operated services. There is no public-provider fallback: if that source is unavailable, the API answers with an explicit unavailable response rather than a zero or a stale value. Bitcoin data reliability describes that contract in full.

Protocol data. Some protocol families are read through an external provider rather than a Universe-operated index. That is stated on the coverage page rather than hidden. The public health response at api.bitcoinuniverse.io/indexer-health names the source, chain tip, lag, and last successful read for each protocol it serves, so the current answer is always one request away rather than a sentence in a document that can age.

What a state on screen means

stateDiagram-v2
  [*] --> Loading
  Loading --> Read: the reader answered
  Loading --> Unavailable: the reader did not answer
  Read --> Empty: it answered, with nothing in it
  Read --> Listed: it answered, with results
  Unavailable --> Loading: retry
  Empty --> Loading: refresh
Loading
  • Loading shows a placeholder that holds the layout. A placeholder never contains a number.
  • Listed shows results, with the period each figure covers.
  • Empty means the reader answered and there is nothing listed. This is a fact about the market.
  • Unavailable means the reader did not answer. This is a fact about the read, not about the market, and the page says so and offers a retry.
  • A figure that was not returned is shown as a dash. A dash is not a zero.

Safety and self-custody

  • Your keys stay in your wallet. Bitcoin Universe never holds them and never moves an asset without a signature you approve in your own wallet.
  • Nobody working on Bitcoin Universe will ever ask for your seed phrase or private key. There is no support process that needs either.
  • The trade confirmation shows the asset, the amount, the service fee, the network fee estimate, and the total before your wallet asks you to sign, and says that a broadcast transaction cannot be recalled. Your wallet shows the transaction’s own inputs and outputs; read them there before you approve.
  • Assets can live on a single satoshi. The application protects asset-bearing outputs from being spent as ordinary change.
  • A transaction that has been broadcast cannot be recalled.

Market and wallet safety is the page to read before your first transaction.

Guides

Getting started and safety

Markets

Owning and creating

Speed, navigation, and releases

For platform operators

Getting help

  • A question about using the product: open an issue.
  • A page here that does not match what the product does: open an issue and name the page and the screen. That mismatch is a defect in this repository.
  • A suspected security issue: follow SECURITY.md. Do not open a public issue for it.

About this repository

This repository is the public documentation for Bitcoin Universe. It describes what the product does and how to read it. The application source, its infrastructure, and its operator procedures are kept elsewhere and are not published here.

CONTRIBUTING.md covers the house rules for prose, screenshots, and the check that runs on every change:

node scripts/check-docs.cjs

About

Public product and safety documentation for Bitcoin Universe

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages