---

Hammer Auction House

Hammer Auction House is a decentralized auction platform that redefines digital asset trading on blockchain. Supporting multiple auction mechanisms through smart contracts, it provides a secure and transparent environment for trading digital assets.

The platform is powered by smart contracts (HammerAuctionHouse-Solidity) that implement:

• Multiple Auction Types: English, Dutch (Linear, Exponential, Logarithmic), All-Pay and Vickrey auctions for NFTs and ERC-20 tokens
• Smart Contract Security: Trustless execution with on-chain validation and verifiable, immutable transactions
• NFT & Token Trading: List, bid on, and win ERC-721 NFTs and ERC-20 tokens
• Wallet Integration: Seamless MetaMask and Web3 wallet support
• Transparent History: Fully on-chain transaction records and bid history
• Extensible Services: Modular auction services interface to support future auction mechanisms

---

Tech Stack

Frontend

• Next.js 14+ (React)
• TypeScript
• TailwindCSS
• shadcn/ui

Blockchain

• Wagmi
• Solidity Smart Contracts
• Ethers.js
• Rainbow-Kit Wallet Integration

---

Getting Started

Prerequisites

• Node.js 18+
• npm/yarn/pnpm
• MetaMask or any other web3 wallet browser extension

Installation

1. Clone the Repository

git clone https://github.com/StabilityNexus/HammerAuctionHouse-WebUI.git
cd HammerAuctionHouse-WebUI

2. Install Dependencies

Using your preferred package manager:

npm install
# or
yarn install
# or
pnpm install

3. Run the Development Server

Start the app locally:

npm run dev
# or
yarn dev
# or
pnpm dev

4. Open your Browser

Navigate to http://localhost:3000 to see the application.

---

Contributing

We welcome contributions of all kinds! To contribute:

1. Fork the repository and create your feature branch (git checkout -b feature/AmazingFeature).
2. Commit your changes (git commit -m 'Add some AmazingFeature').
3. Run the development workflow commands to ensure code quality:
   • npm run format:write
   • npm run lint:fix
   • npm run typecheck
4. Push your branch (git push origin feature/AmazingFeature).
5. Open a Pull Request for review.

If you encounter bugs, need help, or have feature requests:

• Please open an issue in this repository providing detailed information.
• Describe the problem clearly and include any relevant logs or screenshots.

We appreciate your feedback and contributions!