Architecture at a glance
Unvault is non-custodial: users sign from their own wallets, and every state change happens in a smart contract on a public chain. Unvault's servers index, display, and — for a few actions — co-sign. The contracts themselves are owned and administered by UV Tech Foundation; Unvault (BVI) Ltd holds no admin keys to them.
Contract groups#
| Group | Role | Notes |
|---|---|---|
| Settlement | Matches signed listings and offers and transfers item + payment atomically, paying the 0.5% marketplace fee and creator earnings | Off-chain signed orders settled through the Seaport protocol with an Unvault signed zone; English and Dutch auctions run in a separate auction contract (deployed; auctions are PLANNED in the app). Creator earnings are paid on every collection, enforced on-chain or not. Items minted on an Echo contract also carry the Echo Protocol Fee (see below). |
| Collections | ERC-721AC implementations deployed for launchpad collections | PLANNED — the launchpad is not yet open. ERC-721A batch minting plus ERC-721C creator-earnings enforcement; cross-chain extension for vaultable collections. |
| Transfer validator | Enforces which operators may transfer tokens of a creator-token collection | Configured so sales through Unvault and other compliant marketplaces pay creator earnings; the vault contract is allow-listed for lock/unlock transfers. |
| Vault and messaging | Locks an item on the origin chain and mirrors it on the destination chain via a cross-chain messaging protocol (LayerZero) | Vault moves are PLANNED in the app; the omnichain factory, LayerZero sender and receiver and the bridge fee oracle are deployed on every chain (see Contract addresses). One usable copy of an item across all chains at any time; a 0.69 USDC vault fee per move, plus the messaging fee. |
| Pools | BUY / SELL / TRADE liquidity pools per collection, deployed through a factory | PLANNED — no pool factory is deployed yet. Owner-set spot price, linear or exponential delta, and fee rate; a 10% protocol swap fee applies to each swap into or out of a pool. |
| DIVIT | Per-collection reward pools funded at the collection's election | PLANNED. Holders earn DIVIT marketing rewards by posting about the collection on X (post-to-claim), weighted by holdings; the collection configures the pool's split between holder rewards, creator, protocol and the Minter's Bonus; claims are verified against Unvault-signed proofs; optional gacha cycles. There is no DIVIT token. |
A trade#
- Seller approves the settlement contract for the collection (once per collection per chain) and signs a listing (no gas).
- Buyer fills the listing. For collections that enforce creator earnings, the fill includes an Unvault server signature authorizing the transfer route.
- Settlement transfers the item and the payment, and pays the marketplace fee and creator earnings in the same transaction.
A vault move#
Vault moves are PLANNED in the app; the contracts are deployed.
- Owner transfers the item into the vault contract on chain A (lock).
- The vault sends a cross-chain message naming the item and the beneficial owner.
- The destination contract on chain B — the collection's Echo contract — mints or releases the mirror item to the owner.
- Unvaulting reverses the flow; the mirror is locked or burned and the original is released.
Echo contracts#
Unvault's collection contracts on chains other than a collection's home chain are called Echo contracts. They are deployed through the omnichain factory only where the collection's owner has signed up with Unvault, and they mint the items delivered to that chain. Every item minted on an Echo contract carries the Echo Protocol Fee, enforced by the contract itself on each secondary sale wherever it takes place: 2% of the sale price on any other venue, or 1% when the sale settles on the Unvault marketplace, where it is charged in addition to the 0.5% marketplace fee and creator earnings. See the Fee Schedule.
Server signatures#
Some actions require an EIP-712 signature from an Unvault signer in addition to the user's own: allowlist mint vouchers, and fulfilment of orders on creator-earnings-enforced collections. Unvault can withhold a signature to enforce its policies; withholding only limits what can be done through Unvault.
Patent notice#
The vault and cross-chain protocol is the subject of International Patent Application No. PCT/US25/55750 and U.S. Provisional Patent Application No. 63/985,753. These docs describe public interfaces, not the protected internals.
Markdown version: /architecture.md · llms.txt · Use of the APIs is governed by the Terms of Service, Section 21.