How privately-exclusive/privately-smartcontract works
Project type and purpose
• This is a blockchain “core” repository for Privately, a platform for private-reference NFTs on the Base chain.
• It contains three Solidity smart contracts (ERC20 token, ERC721 collection, auction system), a TypeScript client library for meta-transaction flows, deployment & test scripts, plus Docker/Hardhat setups.
File structure
• Top‐level:
• contracts/ – Solidity code (PrivatelyCoin.sol, PrivatelyCollection.sol, PrivatelyAuctionSystem.sol)
• lib/ – TypeScript SDK (client.ts, modules for auctions, coin, collection) and its tests
• scripts/ – build-docs.sh, deploy.ts
• Dockerfile, docker-compose.yml/test, run_node.sh, run_tests.sh
• Hardhat configs (hardhat.config.js/ts)
• CI workflows (.github/workflows)
• Patterns:
• On‐chain vs off‐chain separation
• Meta-transaction EIP-712 layer
• Modular TS client (one module per contract)
• Containerized local development & CI
Insights from README
• Meta-transaction system: user signs off-chain → Relayer API → on-chain
• TypeScript library abstracts contract interactions and EIP-712 signature crafting
• Local Docker+Hardhat for reproducible dev/testing