ZenithLedger

ZenithLedger is a next-generation decentralized NFT marketplace on Stacks, designed for creators, collectors, and teams seeking flexible minting, transparent trading, and Bitcoin-secured settlement at the peak of innovation.

What ZenithLedger Delivers

• Creator-first minting with SIP-009 NFTs, metadata control, and royalties
• Multi-mode trading including fixed-price listings, offers, and auctions
• Bundle sales for drops, collections, and multi-asset deals
• Escrow-backed settlement to keep buyers and sellers protected
• Clear auditability through Clarity smart contracts and on-chain history

Repo Layout

• contracts/: Clarity smart contracts for NFTs, marketplace, and treasury
• frontend/: Next.js frontend experience
• tests/: Clarinet and Vitest coverage for contracts
• deployments/: Example deployment plans for mainnet and devnet

Getting Started

Prerequisites

• Clarinet
• Node.js v18+

Install

git clone https://github.com/doej/zenith-ledger.git
cd zenith-ledger
npm install
cd frontend && npm install

Development

Run the local Stacks devnet and contract suite:

clarinet integrate

Launch the frontend:

cd frontend
npm run dev

Configuration

• Frontend configuration and contract addresses live in frontend/src/lib/constants.ts
• Example environment variables are in frontend/.env.example

Testing

ZenithLedger includes comprehensive test coverage for all smart contract functionality using Clarinet SDK and Vitest.

Running Tests

npm test
npm test marketplace-auctions
npm test -- --watch
npm test -- --coverage

Test Structure

• tests/ - Main test directory
  • collection-*.test.ts - Collection contract tests
  • nft-*.test.ts - NFT contract tests
  • marketplace-*.test.ts - Marketplace contract tests
  • helpers/ - Shared test utilities
  • wrappers/ - Contract wrapper functions

Test Coverage Areas

NFT Contract Tests

• Basic minting and transfers
• Metadata management
• Ownership verification
• Delegation mechanisms

Collection Contract Tests

• Collection creation and configuration
• Minting within collections
• Royalty configuration (0-25%)
• Access control

Marketplace Contract Tests

• Fixed-price listings
• Offers and counter-offers
• Auction mechanics (bidding, extension, settlement)
• Bundle sales (up to 10 NFTs)
• Royalty distribution
• Fee calculations

Advanced Test Scenarios

• Auction bid increments (5% minimum)
• Last-minute auction extensions
• Bundle size constraints
• Royalty enforcement on secondary sales
• Combined fee and royalty calculations

Contributing

Review CONTRIBUTING.md for branching, testing, and release workflows.

License

MIT