Skip to content

postqcoin/postq-miner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PostQ Miner

CLI miner for PostQ ($POSTQ) — mint tokens using post-quantum cryptographic signatures on Ethereum mainnet.

╔═══════════════════════════════════════════════════╗
║  PostQ Miner — post-quantum token minting on ETH  ║
╚═══════════════════════════════════════════════════╝

What is PostQ?

PostQ is an ERC-20 token on Ethereum where every token must be earned through a valid post-quantum cryptographic signature. No whitelist. No presale. No allocation. You prove you can produce a hash-based PQ signature → you mint.

  • Total Supply: 7,500,000 POSTQ
  • Public Mint: 5,000,000 (10,000 slots × 500 POSTQ)
  • LP Reserve: 2,500,000
  • Team Allocation: 0
  • Mint Price: 0.0025 ETH per slot

Quick Start

Check mint progress

npx postq-miner status

Mine (mint 500 POSTQ)

npx postq-miner mine

You'll be prompted for your private key (masked input). Or set it as an env var:

PRIVATE_KEY=0x... npx postq-miner mine

Requirements

  • Node.js 18+
  • ETH wallet with at least 0.003 ETH (0.0025 mint + gas)
  • That's it. No other setup needed.

Install (optional)

You can run without installing via npx, or install globally:

npm install -g postq-miner
postq-miner status
postq-miner mine

How It Works

┌─────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  1. Keygen   │────▶│  2. PQ Sign  │────▶│ 3. Attestation│────▶│  4. Mint TX  │
│             │     │              │     │              │     │              │
│ Generate a   │     │ Sign with     │     │ Backend       │     │ Submit       │
│ one-time PQ  │     │ hash-based    │     │ verifies PQ   │     │ attestation  │
│ keypair      │     │ signature     │     │ sig & issues  │     │ on-chain     │
│              │     │               │     │ ECDSA attest  │     │ → 500 POSTQ  │
└─────────────┘     └──────────────┘     └──────────────┘     └──────────────┘
  1. Keygen — Generates a one-time post-quantum keypair (hash-based, SPHINCS-style)
  2. PQ Sign — Signs a challenge message using the PQ private key
  3. Attestation — Backend verifies your PQ signature is valid, then signs an ECDSA attestation
  4. Mint TX — CLI submits the attestation to the smart contract → 500 POSTQ minted to your wallet

Each PQ key can only be used once. After minting, the public key hash is permanently recorded on-chain.

Commands

Command Description
postq-miner status Show mint progress, slots remaining, ETH raised
postq-miner mine Generate PQ key → sign → attest → mint 500 POSTQ
postq-miner help Show help and usage info

Environment Variables

Variable Default Description
PRIVATE_KEY (interactive) Your wallet private key
ETH_RPC_URL https://ethereum-rpc.publicnode.com Ethereum RPC endpoint
POSTQ_BACKEND_URL https://api.postqcoin.xyz PostQ backend API

Contracts (Ethereum Mainnet)

Contract Address
MintGateV2 0xf087AADFddF1ea4D5580d442Bc86E132771e44E8
PostQ Token 0xa81Ae8c88DBe2A48304204eA65c56017642D9Db7

Both contracts are verified on Etherscan. No admin keys, no proxy, no pause function, fully immutable.

Security

  • Your private key is never sent to the backend. It stays local.
  • The backend only receives the PQ keypair (generated fresh each time) and your recipient address.
  • All PQ signatures are independently verifiable.
  • The smart contract is immutable — no owner, no admin, no upgrade mechanism.

Links

License

MIT

Releases

No releases published

Packages

 
 
 

Contributors