The Hearth/ XRPL Home Docs/ Physical Art + COA: The Full Lifecycle
XRPL Home Docs

Physical Art + COA: The Full Lifecycle

How XRPL Home handles physical art with a Certificate of Authenticity on XRPL: mint, sell, ship, track, verify, and clean up the collector's shipping data once delivery is confirmed.

📚 8 min read 🖼 Physical + COA📘 Product docs 🔋 by $DOOD™

A painting is not a file. It has to be authenticated, packed, shipped, tracked and received — and the collector’s home address should not end up on a public ledger along the way. Physical Art + COA is the XRPL Home flow that handles all of it in one place.

XRPL Home has completed the first full end-to-end test of Physical Art + COA: artwork creation, sale, digital delivery, shipping, tracking, delivery confirmation and privacy cleanup, in a single connected flow. This page is the reference for how that flow works.

What makes Physical Art + COA different

Each physical artwork receives a unique Certificate of Authenticity (COA) and a D.O.O.D. Certificate™ — a Digital Origin & Ownership Document — recorded on the XRP Ledger. The certificate becomes the permanent digital record connected to the physical piece, while the shipping workflow is handled privately through Vault.

A collector who buys a Physical Art + COA piece receives:

  • The original physical artwork
  • A digital version of the artwork
  • A Certificate of Authenticity (COA)
  • A D.O.O.D. Certificate™ NFT
  • Ownership verification
  • Vault fulfillment tracking

The goal was simple: prove that a creator can sell a real physical piece, deliver a digital version and COA NFT, manage shipping through Vault, and preserve the collector’s privacy after the order is complete.

The full workflow at a glance

Seven stages carry a physical piece from the artist’s studio to a confirmed delivery.

  • Mint Physical Art — the artist creates a physical artwork listing with COA traits, certificate ID, digital artwork, and collection/taxon data.
  • List for Sale — the piece is listed with XRPL Home Instant Checkout and clearly marked Physical Art + COA / Ships Original Artwork.
  • Collector Purchases — the sale is recorded, the digital artwork transfers, the COA NFT transfers, and a physical fulfillment order is created.
  • Buyer Adds Address — the buyer submits shipping info in Vault. The address is not written to NFT metadata or the blockchain.
  • Seller Ships — the seller views the address, marks preparing, adds carrier and tracking, and marks shipped and delivered.
  • Buyer Confirms — the buyer tracks the shipment, receives the artwork, and clicks Confirm Received.
  • Privacy Cleanup — the shipping address is removed or redacted after delivery confirmation, while COA, tracking and order history remain.

Minting and listing physical art

  1. Mint the piece as Physical Art + COA

    During minting, the artwork receives a physical artwork record, a digital artwork version, Certificate of Authenticity data, a D.O.O.D. Certificate™ NFT, collection and taxon assignment, and ownership verification metadata. The artwork stays part of its existing collection while gaining physical fulfillment capabilities.

  2. List it with Instant Checkout

    The artist lists the artwork using XRPL Home Instant Checkout. The listing clearly identifies Physical Art + COA and Ships Original Artwork, so collectors know they are purchasing a real-world item backed by an authenticated digital record.

  3. The collector purchases

    When the collector buys the piece, the sale is recorded, the digital artwork transfers to the collector, the COA NFT transfers to the collector, and a physical fulfillment order is created. Buyer and seller both gain access to Physical Art & COA inside Vault.

Shipping and tracking through Vault

From this point the work happens inside Vault, where the buyer and the seller each see their own side of the same order.

The buyer submits shipping information

Inside Vault → Physical Art & COA → My Physical Orders, the buyer submits shipping information securely. The address is never written to the blockchain and is only shared for fulfillment purposes.

Buyer's shipping information form inside My Physical Orders in Vault
Buyer side: the shipping form appears inside My Physical Orders.

The seller fulfills the order

Inside Vault → Physical Art & COA → My Physical Sales, the seller can view the shipping address, mark the order as preparing, add the carrier, add tracking, mark it shipped, and mark it delivered. All fulfillment activity is recorded inside Vault.

Seller's order view in My Physical Sales with the View Shipping Address control
Seller side: View Shipping Address appears once a valid address is submitted.

The buyer tracks the shipment

As the seller updates the order, the buyer can follow fulfillment status, carrier, tracking number and shipment progress directly from Vault. No email chains, no guessing.

Order status showing Preparing Shipment on the buyer's side
The buyer sees Preparing Shipment; the seller saves tracking and then marks the order shipped.
Buyer's view of the saved carrier name and tracking number
The buyer can see the tracking carrier and number once saved by the seller.

The buyer confirms delivery

When the artwork arrives, the buyer clicks Confirm Received and the order is completed. The COA remains, the NFT remains, ownership verification remains, and the fulfillment record remains.

Confirm Received control completing the physical fulfillment order
The buyer confirms received; the seller can also mark delivered as part of the fulfillment flow.

The status flow across the whole order reads: Address Needed → Address Submitted → Preparing Shipment → Shipped → Delivered → Received Confirmed.

Privacy cleanup after delivery

💡 Privacy by design

After delivery confirmation, shipping addresses are removed or redacted. Tracking history, COA records, ownership records and order events remain. Collector privacy is protected without losing provenance.

This is the part that is easy to overlook and hard to retrofit. A physical sale needs an address for a few days, not forever. The permanent record keeps what proves the piece is real, and drops what only ever existed to get a parcel to a door.

Verify the COA anytime

Buyers and sellers can verify authenticity at any time inside Vault → Physical Art & COA → Verify COA. Verification can use either the Certificate ID or the NFT Token ID.

Verify COA tab in Vault accepting a certificate ID or NFT token ID
The Vault Verify COA tab: certificate ID and NFT token ID verification.

There is also a dedicated verify page at xrplhome.io/verify.html, which anyone can use — including someone who is only considering a purchase. Verification confirms collection, issuer, ownership, token ID, and XRP Ledger authenticity. Use the full NFT Token ID when verifying directly on XRPL.

Dedicated verify page showing on-chain verification results with Physical Art and COA badges
The dedicated verify page: on-chain verification with Physical Art + COA badges.

Why this matters

Physical and digital ownership should work together. With XRPL Home, artists can mint, sell, authenticate, fulfill, track and verify physical artwork through a single workflow — the complete path from mint to sale to digital delivery to COA transfer to shipping, tracking, delivery, confirmation and privacy cleanup has now been tested end to end.

If you want the artwork itself to stay hidden until the parcel lands, that is a Reveal Mint™ — the same fulfillment backbone, with a Living COA™ that keeps evolving after delivery. For files rather than objects, start with the digital art minting guide, and browse what is already out there on Explore.

Built by CommUnity. Still building. Still creating. Still early.

Key takeaways

  • Every physical piece gets a Certificate of Authenticity and a D.O.O.D. Certificate NFT recorded on the XRP Ledger.
  • Collectors receive the original artwork, a digital version, the COA, the certificate NFT, ownership verification and Vault tracking.
  • Shipping addresses are submitted in Vault and are never written to NFT metadata or the blockchain.
  • Order status runs from Address Needed through Shipped and Delivered to Received Confirmed.
  • After delivery confirmation the address is redacted while COA, tracking and order history remain verifiable.

See what you hold

Your wallet, your NFTs, your rewards — all in one place.

Open your Vault More from the Hearth
Published by XRPL Home · The Hearth.
Written for the XRPL creator and collector community and originally shared with the 🔋 by $DOOD™ CommUnity. XRPL Home is the home for XRPL art — mint anywhere, create anywhere, find it home.
Nothing here is financial advice. Always do your own research before buying, minting, or investing.