Thanks to visit codestin.com
Credit goes to github.com

Skip to content

unigamblers-stack/zkPULSE_OFFICIAL

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

127 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŒ€ zkPULSE - Privacy Protocol for PulseChain

PulseChain License Website GitHub

Zero-Knowledge Privacy Protocol for PulseChain

Website β€’ Twitter


πŸ” Overview

zkPULSE is a decentralized, non-custodial privacy protocol built natively on PulseChain. Using advanced zero-knowledge proof technology, zkPULSE enables completely private transactions while maintaining the security and transparency of blockchain technology.

πŸ” Verify Our Code

Don't trust - verify! We believe in complete transparency. You can verify that our hosted site matches this public repository:

Quick Verification Methods

Method Link Difficulty
🌐 Web Verification verify.html ⭐ Easiest
πŸ“‹ File Hashes HASHES.txt ⭐⭐ Easy
πŸ›‘οΈ Security Docs SECURITY.md ⭐⭐ Easy
πŸ€– Automated Script bash verify-deployment.sh ⭐⭐⭐ Advanced

What We Prove

βœ… No hidden tracking - Code matches GitHub exactly βœ… No data collection - Zero analytics or user tracking βœ… Complete privacy - All operations client-side only βœ… Smart contracts verified - On-chain code matches repository

Smart Contract Verification

All contracts are verified on PulseScan:

Pool Contract Address Verification
1M PLS 0x65d1D748b4d513756cA179049227F6599D803594 View βœ…
10M PLS 0x21349F435c703F933eBF2bb2A5aB2d716e00b205 View βœ…
100M PLS 0x2443ccEef2D2803A97A12f5A9AA7db3BEc154B73 View βœ…
1B PLS 0x282476B716146eAAbCfBDd339e527903deFD969b View βœ…

Read more: Complete Security Documentation

✨ Key Features

🎭 Complete Privacy

  • Anonymous transactions using zk-SNARKs technology
  • No link between deposit and withdrawal addresses
  • Enhanced privacy through relayer network

πŸ”’ Non-Custodial

  • You maintain full control of your funds
  • No trusted third parties
  • Decentralized architecture

⚑ PulseChain Optimized

  • Native PulseChain integration
  • Fast transaction processing
  • Low gas fees

πŸ”₯ Deflationary Tokenomics

  • zkPULSE token burns with every transaction
  • Burn address: 0x0000000000000000000000000000000000000369
  • Token contract: 0x8De9077B619DcBdA28edda4b8dC16538a59EFb49

πŸš€ Getting Started

πŸ’» Option 1: Download Desktop Application (Easiest)

One-click installation for Windows, macOS, and Linux

Download the latest release from our Releases Page

βœ… No installation required - Just download and run βœ… Automatic updates - Always uses latest version βœ… Offline capable - Access your deposits anytime βœ… Official relayer included - Connects to zkpulse.app relayer

How to use:

  1. Download the executable for your platform (Windows .exe, macOS, or Linux)
  2. Run the executable - a browser window will open automatically
  3. Connect your MetaMask wallet and start using zkPULSE!

For detailed instructions, see the USER-GUIDE.md

πŸ› οΈ Option 2: Run from Source

For developers and advanced users

Prerequisites

  • Node.js v16 or higher
  • npm or yarn package manager
  • MetaMask or compatible Web3 wallet
  • PulseChain network configured

Installation

  1. Clone the repository:
git clone https://github.com/proestever/zkPULSE_OFFICIAL.git
cd zkPULSE_OFFICIAL
  1. Install dependencies:
npm install
  1. Configure environment:
cp .env.example .env
# Edit .env with your configuration
# NEVER commit your .env file!
  1. Start the application:
npm start

The application will be available at http://localhost:8888

Development Commands

# Development server with hot reload
npm run dev

# Production server
npm run production

# Standalone desktop mode
npm run start:standalone

# Pre-cache blockchain events
npm run precache

# Run tests
npm test

Building Desktop Executables

# Build for all platforms (Windows, macOS, Linux)
npm run build:all

# Build for specific platform
npm run build:win      # Windows only
npm run build:mac      # macOS only
npm run build:linux    # Linux only

Executables will be created in the dist/ directory. See BUILD-GUIDE.md for detailed instructions.

πŸ’° Supported Denominations

zkPULSE supports multiple pool sizes for flexible privacy options:

Pool Size Amount
Small 1 Million PLS
Medium 10 Million PLS
Large 100 Million PLS
Whale 1 Billion PLS

πŸ—οΈ Architecture

zkPULSE_OFFICIAL/
β”œβ”€β”€ contracts/        # Smart contracts
β”‚   β”œβ”€β”€ zkPulseRouter.sol
β”‚   β”œβ”€β”€ Tornado.sol
β”‚   └── Verifier.sol
β”œβ”€β”€ frontend/         # Web interface
β”‚   β”œβ”€β”€ index.html
β”‚   β”œβ”€β”€ app-complete.js
β”‚   └── unified-server.js
β”œβ”€β”€ build/           # Compiled contracts & circuits
β”œβ”€β”€ branding/        # zkPULSE brand assets
└── cache/          # Event cache for performance

πŸ› οΈ Technology Stack

  • Smart Contracts: Solidity ^0.7.0
  • Zero-Knowledge Proofs: Circom, SnarkJS, WebSnark
  • Frontend: HTML5, JavaScript, Web3.js
  • Backend: Node.js, Express.js
  • Blockchain: PulseChain
  • Caching: Server-side event caching for instant stats

πŸ“Š Network Statistics

Real-time protocol statistics available:

  • Total Value Locked (TVL)
  • Deposits per denomination
  • Withdrawal count
  • zkPULSE tokens burned
  • Anonymity set size

πŸ”§ Advanced Features

Relayer Network

  • Automated withdrawal processing
  • Gas abstraction for enhanced privacy
  • Multiple relayer redundancy
  • Custom relayer support

Performance Optimizations

  • Server-side stats caching (<100ms load time)
  • Event pre-caching system
  • PulseScan API integration
  • Optimized contract interactions

🀝 Contributing

We welcome contributions to zkPULSE! Please follow these steps:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/YourFeature)
  3. Commit your changes (git commit -m 'Add YourFeature')
  4. Push to the branch (git push origin feature/YourFeature)
  5. Open a Pull Request

Please ensure:

  • Code follows existing style conventions
  • All tests pass
  • No sensitive data in commits
  • Clear commit messages

πŸ“ License

This project is completely open source and free for anyone to use, modify, and distribute. Licensed under the MIT License - see the LICENSE file for details.

⚠️ Security

Audit Status

  • Core contracts based on audited Tornado Cash codebase
  • Community-reviewed code

Best Practices

  • Always verify contract addresses
  • Never share your note/proof
  • Use VPN for additional privacy
  • Wait before withdrawing for larger anonymity set

IMPORTANT: This is experimental software. Use at your own risk.

πŸ”— Official Links

πŸ™ Acknowledgments

  • Built on cryptographic foundations of Tornado Cash
  • Powered by PulseChain ecosystem
  • Community-driven development
  • Special thanks to all contributors

πŸŒ€ zkPULSE - Privacy for PulseChain πŸŒ€

Made with πŸ’š by the zkPULSE Team

Website β€’ Verify Code β€’ GitHub β€’ Twitter

πŸ” 100% Open Source & Verifiable

About

zkPULSE is a tornadocash fork for Pulsechain

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 54.1%
  • Solidity 25.2%
  • HTML 19.8%
  • Shell 0.9%