Kondux Contracts

Kondux is a powerful and versatile smart contract system built on the Ethereum blockchain. It is designed to facilitate the creation, management, and monetization of NFTs, incorporating features such as royalties and access control. The smart contract leverages popular open-source libraries from the OpenZeppelin project and uses Foundry (Forge) for development, testing, and deployment.

Staking enables users to stake tokens and earn rewards. It includes features such as time-locked staking and rewards compounding. The contract is built with Solidity and uses OpenZeppelin library for standard interfaces and utilities.

Key Features

• ERC-721 compliant NFT creation and management
• Extensible with ERC-721 Enumerable, Pausable, Burnable, and Royalty features
• Customizable royalty and access control mechanisms
• Events for tracking important contract actions
• Integration with Foundry (Forge) for fast testing and deployment

Staking Features

• Staking: Users can stake their tokens to participate in the rewards program.
• Time-lock: Users can choose different time-lock durations for their stakes, which affects the rewards earned.
• Rewards Calculation: Rewards are calculated based on the staked amount, the time passed, and any applicable reward boosts.
• Reward Boosts: There are reward boosts for founders and kNFT holders that increase the rewards earned.
• Compound Rewards: Users can compound their rewards, allowing them to earn interest on their earned rewards.
• Claim Rewards: Users can claim their earned rewards at any time after the time-lock period has passed.
• Withdraw Stakes: Users can withdraw their staked tokens after the time-lock period has passed.

The Staking smart contract is built on top of the AccessControlled contract and includes several mappings to keep track of user deposits and rewards. The contract makes use of external interfaces such as IHelix, IERC20, IERC721, and ITreasury to interact with other components of the system.

Vision

To be the leading provider of custom-fit SaaS solutions for artists, brands, and manufacturers, driving innovation in the realms of blockchain technology, NFTs, 3D marketplaces, AR/VR/XR environments, metaverse design, and gaming experiences.

Mission

Our mission is to create custom-fit SaaS solutions by combining advanced API pipelines with secured technologies. We bridge creativity and blockchain technology together with NFTs, 3D NFT Marketplaces, AR/VR/XR Environments, Metaverse Design, Manufacturing Models, and Gaming Experiences.

Community Values

• Innovation: We are committed to pushing the boundaries of technology and creativity to deliver cutting-edge solutions to our clients.
• Collaboration: We foster a culture of teamwork and open communication, believing that great ideas emerge from diverse perspectives.
• Quality: We are dedicated to providing high-quality, reliable, and secure solutions that meet and exceed our clients' expectations.
• Trust: We build trust by prioritizing security, transparency, and accountability in all our business practices.
• Empowerment: We support and empower artists, brands, and manufacturers to achieve their goals and realize their visions through our technology solutions.

Licensing Strategy

Kondux's software and services are provided under a proprietary license, with specific licensing terms tailored to each client's needs. This approach ensures that we maintain the necessary control and flexibility to protect our intellectual property while providing clients with the customized solutions they require.

Code of Conduct

We are committed to fostering a welcoming and inclusive community. Please read our Code of Conduct for more information.

🔧 Setting up local development

Requirements

• Foundry (includes forge, anvil, cast)
• Git
• Node.js v18+ (for helper scripts only)

Local Setup Steps

# Clone the repository with submodules
git clone --recurse-submodules https://github.com/Kondux/smart_contracts.git
cd smart_contracts

# Install Foundry (if not already installed)
curl -L https://foundry.paradigm.xyz | bash
foundryup

# Set up environment variables
cp .env.example .env # (linux/mac)
copy .env.example .env # (windows)

# Install npm dependencies (optional, for Python/JS helper scripts)
npm install

Foundry Commands

# Build contracts
forge build

# Run all tests
forge test -vv

# Run specific test contract
forge test --match-contract KonduxImplementation -vvv

# Run specific test function
forge test --match-test test_safeMint -vvv

# Deploy (see scripts/solidity/deploy/ for deployment scripts)
forge script scripts/solidity/deploy/DeployKonduxBatchMinter.s.sol --rpc-url $RPC_URL --broadcast

Windows + WSL Setup

On Windows, Foundry runs best through WSL. Use these commands:

# Build
wsl -e bash -c "cd /mnt/d/git/smart_contracts && ~/.foundry/bin/forge build"

# All tests
wsl -e bash -c "cd /mnt/d/git/smart_contracts && ~/.foundry/bin/forge test -vv"

# Single test
wsl -e bash -c "cd /mnt/d/git/smart_contracts && ~/.foundry/bin/forge test --match-contract KonduxImplementation -vvv"

Project Structure

contracts/           # Solidity source files
forge-tests/         # Foundry tests (*.t.sol)
scripts/solidity/deploy/  # Forge deployment scripts (*.s.sol)
scripts/cli/         # Python CLI utilities
scripts/shell/       # Shell helper scripts
test/_archived/      # Legacy Hardhat tests (archived)
ignition/_archived_modules/  # Legacy Ignition modules (archived)
docs/               # Documentation and guides

Historical Deployments

Previous deployment records (from Hardhat-deploy and Ignition) are preserved in:

• docs/deployments/historical-addresses.json - Consolidated address archive
• docs/deployments/kondux-batchminter/address-book.json - Active deployment tracking

📖 Guides

Whitelist Minting

1. Get the user's address from the frontend with Metamask

2. Send to Merkle Proof Server

https://h7af1y611a.execute-api.us-east-1.amazonaws.com/:address/proof

Return: Proof is a JSON object with the array of proofs

1. Get the Merkle Proof Array from the server and send to the contract

contract.whitelistMint(proof)

Contracts

• Rinkeby Addresses

Documentation

• Kondux DAO
• Kondux NFT DNA
• Royalty Reward
• Staking