Skip to content

docs: gallery vault governance and curation API specs - #135

Open
mxjxn wants to merge 1 commit into
mainfrom
docs/gallery-vault-curation-specs
Open

docs: gallery vault governance and curation API specs#135
mxjxn wants to merge 1 commit into
mainfrom
docs/gallery-vault-curation-specs

Conversation

@mxjxn

@mxjxn mxjxn commented May 18, 2026

Copy link
Copy Markdown
Owner

What

Two specs for the SuchGallery system beyond the base contracts in #132.

gallery-vault-spec.md — On-chain vault + governance

  • Solo mode — EOA owns gallery, full control, no governance overhead
  • Collective mode — GalleryDAO (lightweight governor) owns the gallery NFT, ERC-20 governance tokens per gallery, proposals for vault operations
  • GalleryToken — soul-bound by default (transfers disabled), enabled via DAO vote
  • Solo → Collective transition — irreversible, deploys GalleryDAO, transfers NFT, mints governance tokens
  • Emergency dissolve — 66% supermajority can dissolve DAO and return assets
  • Purely additive storage — no existing slots modified

gallery-curation-api.md — Off-chain mutable exhibitions

  • 5 content types: deposited (TBA vault), external_listing (other peoples art for sale), image (any image, minted or not), text (plain text panels), empty
  • Architecture: IPFS base (static geometry + render) + API overlay (mutable exhibition data)
  • EIP-712 signed auth — gallery owner or designated curator
  • Exhibition versioning — full history archive of every show
  • Vault sync indexer — watches registerDeposit events and TBA balance changes
  • Rendering pipeline — IPFS geometry → API exhibition → artwork metadata → 3D scene

Why

ERC-6551 needs a reason to exist beyond custody. The vault (permanent collection) is that reason. Collective ownership fills the Party Protocol gap with a lighter approach. The curation API makes the gallery a "wow such gallery" surface — curating anything, not just what you own.

Remaining for build

After this + #132 + #133 merge:

  • Blender geometry node pipeline (30 galleries)
  • GalleryDAO + GalleryToken contracts
  • Curation API (Postgres + Express/Fastify on Base)
  • 3D viewer (Three.js, loads glTF + exhibition data)
  • Curator web UI (frame editor, drag-and-drop)

Two new specs for the SuchGallery system:

- gallery-vault-spec.md: On-chain vault + governance layer
  - Solo vs Collective ownership modes
  - GalleryDAO lightweight governor (ERC-20 per gallery, proposals, voting)
  - GalleryToken with transferable toggle (soul-bound by default)
  - Solo → Collective transition (irreversible)
  - Emergency dissolve via supermajority
  - Purely additive storage changes to SuchGallery.sol

- gallery-curation-api.md: Off-chain mutable exhibition surface
  - 5 content types: deposited, external_listing, image, text, empty
  - EIP-712 signed curator auth
  - Exhibition versioning with full history
  - Vault sync indexer (watches registerDeposit + TBA transfers)
  - 3D viewer rendering pipeline
  - IPFS base (static) + API overlay (dynamic) architecture
@vercel

vercel Bot commented May 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
cryptoart-studio-mvp Ready Ready Preview, Comment May 18, 2026 5:02pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant