ArtSoul Protocol

Collector demand comes before minting: discover, bid, settle, then mint digital art on Base.

Comment

Inspiration

Most NFT marketplaces mint artwork first and search for demand later. This creates speculative inventory, weak price discovery, and little context for collectors.

ArtSoul reverses that order. Collector demand comes first, and minting happens only after a successful auction settlement.

What it does

ArtSoul is a discovery-first digital art auction protocol built on Base.

Artists publish artwork before minting and may receive optional AI value guidance for choosing a starting price. The guidance is advisory only and never controls auction settlement, ownership, floor price, fees, or royalties.

Collectors discover artwork, signal interest, and participate in auctions. If an auction does not settle successfully, no NFT is created. After successful settlement, ArtSoul lazily mints the NFT to the First Collector and records transparent provenance:

  • Creator
  • First Collector
  • Current Owner
  • Auction and resale history
  • Canonical floor established by settlement

Public artwork, profiles, discovery pages, and protocol documentation can be explored without connecting a wallet.

How we built it

ArtSoul combines:

  • A responsive web frontend built with JavaScript, React, Vite, and a custom Classic/Future theme system
  • Solidity smart contracts using Hardhat and OpenZeppelin
  • Base Sepolia for the current public testnet
  • Reown AppKit, WalletConnect, and injected wallet providers
  • Supabase and PostgreSQL for application data
  • A Node.js blockchain indexer for public projections and provenance
  • Vercel serverless APIs and deployment
  • Server-side AI value guidance that remains separate from protocol truth

ArtSoul existed before OpenAI Build Week. During Build Week, Codex with GPT-5.6 was used as an engineering agent for evidence-led debugging, implementation, regression-test design, validation, documentation, and pull-request preparation.

The founder supplied real iPhone reproduction steps and production wallet logs. Codex reconstructed the event timeline, isolated mobile WalletConnect session restoration and network-state races, implemented narrowly scoped fixes, added regression coverage, validated the production build, and prepared reviewable pull requests.

Challenges we ran into

The largest Build Week challenge was mobile wallet reliability in external iPhone browsers.

A mobile connection crosses several independent systems: the browser, Reown modal, WalletConnect relay, wallet application, iOS background suspension, session persistence, page restoration, and final chain validation. A wallet could approve the connection while the browser still had incomplete or stale state.

We treated the wallet flow as a state machine instead of repeatedly patching the Connect button. Production logs were compared with AppKit, WalletConnect, and application state so each failure could be isolated without changing auction or contract semantics.

Another challenge was ensuring that wallet identity restoration remained separate from operational network enforcement. ArtSoul can restore an existing session, but every write action must still require Base Sepolia.

Accomplishments that we are proud of

  • A working public testnet covering publishing, discovery, auctions, settlement, lazy minting, provenance, and resale
  • Evidence-driven mobile wallet debugging using real-device production logs
  • Regression tests for wallet session restoration and navigation races
  • Base Sepolia write guards that protect every transaction path
  • Public protocol documentation and an auditable indexer-backed data model
  • A responsive interface supporting desktop and mobile layouts

What we learned

Mobile wallet connection is not a single button action. It is a distributed session lifecycle that must survive background suspension, redirects, delayed settlement, page navigation, and network changes.

We also learned that an engineering agent produces its strongest work when it receives concrete evidence, explicit invariants, narrow scope, and reproducible tests.

ArtSoul keeps AI guidance separate from blockchain truth. AI may help a creator understand a possible starting value, but contracts and transaction receipts determine settlement, ownership, floor, and royalties.

What's next for ArtSoul Protocol

  • Complete the real-device mobile wallet verification matrix
  • Finish security review and testnet validation
  • Improve onboarding for the first artist and collector cohort
  • Add public, indexer-backed protocol metrics
  • Expand discovery-first community auction events
  • Prepare for a future Base mainnet deployment after the testnet and audit phases are complete

Built With

Share this project:

Updates