How Obsidry works

Obsidry is an inscription marketplace on Base. Anyone can upload media, launch a collection, and let collectors inscribe. Every inscription is recorded on Base under the obs-20 protocol — ownership is on-chain, media is served via Obsidry. Use the full marketplace, collection pages, or the floating Obsidry Agent (see docs) to inscribe from anywhere on the site.

Inscriptions are fully transferable. You can send them to another wallet or sell them on secondary markets.

Each inscription costs 0.000375 ETH plus Base gas on Genesis. The quantity slider sets how many inscriptions you inscribe in one transaction. On Genesis, 1,000 inscriptions ship per on-chain unit (e.g. #1–#1000). For community collections, 97.5% of each payment goes to the creator and 2.5% to Obsidry.

1. 1Connect a wallet on Base mainnet
2. 2Browse the marketplace, open a collection page, or use Obsidry Agent from the floating cube
3. 3Review the obs-20 inscription preview
4. 4Set inscription quantity (from 1 up to your wallet cap)
5. 5Click inscribe and confirm in your wallet
6. 6Your NFT appears in MetaMask collectibles — enable autodetect or import with the collection address. Each NFT represents an inscription range on large drops.

Batch inscribing is supported: raise the slider and confirm once. Total cost = inscriptions × 0.000375 ETH + gas. Example on Genesis: 10,000 inscriptions (10 on-chain units) ≈ 0.00375 ETH + gas. Minimum is 1 inscription (one on-chain unit on Genesis).

Obsidry Agent is the site-wide assistant — a floating cube in the bottom-right corner on every page except Create. It is a guided menu flow (not a chatbot): browse splits, inscribe, open your wallet, or deploy a new collection without leaving the page you are on.

Main menu

Quick actions

Shortcut chips below the main menu for common paths:

• Trending — top splits by recent velocity
• King of Onyx — jump to the featured hero split
• Genesis — open the official OBSDRY drop
• Recent — last split you viewed (stored locally in your browser)
• Continue — resume a flow you backed out of to the main menu

Page-aware context

• Marketplace home — highlights Marketplace and suggests browsing or inscribing from lists
• Collection page — offers a one-tap “Mint now” action and opens directly to inscribe when you launch the agent
• Dashboard — highlights My wallet for checking owned splits and badges

Search

From Marketplace → Search, type at least two characters. Results stay under the search field as you refine the query. Search matches collection name, tick symbol, description, and creator wallet address.

After inscribing

When you inscribe from the agent, a success card appears inside the drawer (no duplicate toast). Actions:

• View item — open the collection page
• Mint again — reset and inscribe another batch on the same split
• Browse more — return to marketplace lists

Inscribing from a collection page (outside the agent) still shows the standard success toast.

Session behavior

• Closing the drawer keeps your current step — reopen to continue where you left off
• After 30 minutes of inactivity, the agent resets to the main menu
• Press Esc or tap the overlay to close

Obsidry collections deploy through a shared factory on Base. Each collection gets its own contract with a unique name, tick symbol, supply cap, and metadata endpoint.

Obsidry Agent flow

1. 1Open Create and upload PNG, JPG, WEBP, or GIF (max 8 MB)
2. 2Pick a category (Art, Photo, Meme, PFP, Generative, Other)
3. 3Choose supply (1/1 through 20M, or open edition)
4. 4Set your collection name and tick symbol — both go on-chain
5. 5Add an optional description, or let Obsidry Agent draft one
6. 6Review the launch preview card and edit any field
7. 7Connect wallet on Base and confirm deploy (gas only)
8. 8Collection goes live on the marketplace — you are redirected to the split page and Obsidry Agent opens so you can share or inscribe immediately

What you set

• Name & tick symbol — you choose both; the tick is your obs-20 identifier on-chain (2–6 characters)
• Supply — fixed cap or open edition
• Description — shown on the collection page
• Media — the image every inscription in the collection shares

Every inscription on Obsidry follows the obs-20 envelope — inspired by inscription-style protocols, adapted for Base. The preview appears in the UI before you inscribe.

{
  "p": "obs-20",
  "op": "mint",
  "tick": "obsdry",
  "amt": "1"
}

p

Protocol identifier. Always obs-20 on Obsidry.

op

Operation type. Always mint when inscribing.

tick

Collection symbol in lowercase (e.g. obsdry). Set at launch and cannot change.

amt

Inscription count for this action — mint count × inscriptions per mint for the collection (e.g. 5 mints × 1,000 = 5,000 on Genesis).

The envelope is the canonical obs-20 preview on Obsidry. On-chain, ownership is recorded as an inscription under your collection's tick on Base.

Each inscription's metadata (name, description, image) is served from Obsidry and linked via the collection's on-chain uri.

• Images hosted on Cloudinary CDN — fast load, optimized delivery
• Metadata URL pattern: /api/metadata/{id}.json
• obs-20 envelope fields match the inscribe preview in the UI
• Ownership and inscription number are the on-chain proof on Base

The home page is split into two layers: the King of Onyx hero at the top, and the full inscription feed below with filters and search.

Feed filters

Sort & search

• Sort by recent, price (low/high), or total supply
• Search by name, tick symbol, category, creator address, or tags

Pinned collections

Official genesis drops can be pinned to the top of the All and New feeds with a pin badge on the row. Pinned items stay visible even if they are older than 24 hours.

Each collection row shows the image, name, tick, creator, tier badge, inscription progress bar, price, and hourly velocity.

How the slot is chosen

1. 1If an official collection is configured (currently Obsidry · OBSDRY), it always occupies King of Onyx.
2. 2If no pinned collection is set, the slot falls back to the live collection with the highest inscription count among Heating or Graduated tiers.

The hero shows inscription progress, price, hourly velocity, remaining supply, and quick links to view or inscribe. Official drops display a gold verified badge and genesis tags.

Every collection has a tier that updates automatically after each inscription. Higher tiers signal momentum and get visual emphasis (glowing progress bars on Heating and Graduated).

Fixed supply collections

Thresholds are based on inscribed ÷ supply:

Open editions

• Live — under 50 inscriptions
• Heating — 50–99 inscriptions
• Graduated — 100–999 inscriptions
• Sold out — 1,000+ inscriptions

What graduation means

Graduation is a milestone, not a separate contract or migration. Tier badge changes, the collection appears in the Graduated filter, and activity is logged — no manual action from creators.

When you launch a collection on Obsidry, every mint generates revenue. Obsidry takes a 2.5% platform fee; the remaining 97.5% goes directly to you.

• Launch is free — you only pay Base gas to deploy
• Mint price is fixed at 0.000375 ETH per mint
• Revenue settles on-chain to your connected wallet
• No hidden fees beyond the 2.5% platform cut

To launch, go to Create or open Obsidry Agent → Open a split, upload your media, follow the guided flow, connect your wallet on Base, and confirm the deploy transaction.

Share with friends — earn 10% per mint — Genesis (OBSDRY) only. Share your personal link; when someone mints through it, you earn 10% of their total mint payment.

How it works

1. 1Connect your wallet on the Genesis collection page and copy your referral link from the mint panel
2. 2Link format: /item/{id}?ref=0xYourWallet
3. 3When a friend opens your link, their browser stores the ref for 30 days
4. 4If they mint Genesis within that window, your reward is recorded as pending — paid out manually by the Obsidry team

• Commission = 10% of the friend's total mint payment (mints × 0.000375 ETH)
• Self-referrals are ignored — you cannot earn from your own mints
• Referrals apply to Genesis only, not community collections

To prevent single-wallet domination of a drop, each address can mint up to 10% of a collection's total inscription supply. Each mint costs 0.000375 ETH. Inscriptions per unit scale with supply — at 21K supply, 1 unit = 1 inscription; at 21,000,000 supply (Genesis), 1 unit = 1,000 inscriptions.

21,000,000 supply

1,000 per on-chain unit · min 1 inscription · max 2,100,000 inscriptions per wallet ( up to 2,100 on-chain units)

1,000 supply

Max 100 per wallet

Open editions

Max 100 per wallet

The remaining cap for your wallet is shown on the collection page.

Obsidry inscriptions are fully transferable. After inscribing, you own an obs-20 inscription on Base.

• Send inscriptions to another wallet
• List and sell on secondary marketplaces
• Hold as a permanent collectible

Ownership is verifiable on BaseScan. Inscription number and collection address are permanent identifiers.

Obsidry shows verification badges next to wallets and creators on the marketplace, collection pages, agent wallet panel, and navbar connect area.

Gold badge

Official Obsidry team wallet only — assigned to configured official addresses.

Blue tick

Early-access verified accounts — granted automatically when you registered for early access and connect the same wallet after launch.

Obsidry supports any EVM wallet compatible with Base:

• MetaMask, Coinbase Wallet, Rainbow, WalletConnect
• Switch network to Base mainnet before transacting
• Keep a small ETH balance for gas (0.001+ ETH recommended)
• Enable collectibles autodetect in MetaMask settings

If your inscription does not appear automatically, import it manually with the collection address and your inscription number from the confirmation.