Skip to content

potcoin/PotCoin

Repository files navigation

PotCoin (POT)

A Community Proof-of-Stake Cryptocurrency with Native Solana Bridge

420M supply • 1% staking APR • Solana DEX liquidity • Built for the cannabis community


What is PotCoin?

PotCoin is a Proof-of-Stake cryptocurrency purpose-built for the cannabis industry. Operating on a Bitcoin-derived codebase (Bitcoin → Peercoin → NovaCoin → MotaCoin → PotCoin), it combines a 420,000,000 fixed supply, 1% annual staking rewards, and a bidirectional escrow bridge to Solana for instant DEX liquidity.

The bridge architecture uses pre-funded escrow wallets on both chains — not mint/burn — so the total supply is always verifiable and can never exceed the 420M hard cap. Users buy POT on Solana DEXes and bridge to the mainchain for staking rewards, or bridge back for trading.

PotCoin ships 28 custom RPC commands for staking management, bridge operations, coin control, and chain analytics — all accessible from the daemon CLI.


Quick Facts

Ticker POT
Consensus Pure Proof-of-Stake (after block 500)
Block Time 260 seconds (4:20)
Max Supply 420,000,000 POT
Staking Reward 1% APR
Minimum Fee 0.420 POT
Address Prefix P
Data Directory ~/.PotCoin
P2P Port 16420
RPC Port 16421
Hashing X13 (PoW phase), SHA-256d stake kernel
Last PoW Block 500
Genesis March 29, 2026 — "4/20/2026 PotCoin Rises From The Ashes"
Solana SPL Token PotzPaFGzK3cbu1u3g5HtoZbyTUkyhka8T2aBy8LMEq

See the Whitepaper for full chain parameters.


Highlights

  • 1% APR Proof-of-Stake — pure PoS after block 500, with stake split/combine automation, stake-for-charity auto-donations, and HyperStake kernel derivation
  • Solana bridge built into the daemonbridgetosol <amount> <solana_address> sends POT to Solana directly from the CLI, using OP_RETURN on-chain routing data (no external APIs in the transaction path)
  • Static supply escrow — the 380M premine is pre-distributed across 1,374 escrow UTXOs in graduated tiers; no minting, no burning, total supply always = 420M
  • Tor-routed staking — P2P traffic can be routed through Tor (proxy=127.0.0.1:9050) for IP privacy on staking nodes
  • 28 custom RPCs — staking management, bridge operations, coin control, chain analytics, wallet utilities (see RPC Reference)
  • Deterministic multi-platform Guix builds — x86_64-linux, arm-linux, aarch64-linux, Windows (mingw), macOS (x86_64 and arm64)

Building From Source

PotCoin uses the standard Bitcoin-Core-derived autotools + Guix build system.

Option A: Guix Deterministic Build (recommended for releases)

git clone https://github.com/<owner>/potcoin-core.git
cd potcoin-core
./contrib/guix/guix-build

This builds all 6 target platforms deterministically. Artifacts land in guix-build-<commit>/output/<host>/. Each platform tarball contains both potcoind and potcoin-qt.

To build only one platform (e.g., x86_64-linux):

HOSTS="x86_64-linux-gnu" ./contrib/guix/guix-build

Requirements: Guix 1.4+ installed, ~40 GB disk for depends cache, 2-6 hours for full multi-platform build.

See BUILD_NOTES.md for a gotcha to be aware of after project renames.

Option B: System Build (development)

cd depends
make HOST=x86_64-linux-gnu -j$(nproc)
cd ..

./autogen.sh
./configure --prefix=$(pwd)/depends/x86_64-linux-gnu
make -j$(nproc)

Binaries produced at src/potcoind and src/qt/potcoin-qt.

Dependencies (Debian/Ubuntu):

sudo apt-get install build-essential libtool autotools-dev automake pkg-config \
    libssl-dev libevent-dev bsdmainutils python3 \
    libboost-system-dev libboost-filesystem-dev libboost-chrono-dev \
    libboost-test-dev libboost-thread-dev \
    libdb4.8-dev libdb4.8++-dev \
    libminiupnpc-dev libnatpmp-dev libzmq3-dev \
    qtbase5-dev qttools5-dev-tools qtwayland5 libqrencode-dev

Running

Daemon

# Default: joins mainnet, uses ~/.PotCoin/ data directory
potcoind -daemon

# Configure by editing ~/.PotCoin/PotCoin.conf
# Basic config:
#   rpcuser=myuser
#   rpcpassword=strongpassword
#   server=1
#   daemon=1
#   bridgeescrow=<valid P-prefix address>   # for bridgetosol
#   bridgeminamount=1.0                     # optional
#   proxy=127.0.0.1:9050                    # optional Tor

# Invoke RPCs (no separate potcoin-cli — daemon doubles as CLI)
potcoind getinfo
potcoind getstakinginfo
potcoind help

GUI Wallet

potcoin-qt &

The GUI exposes a Bridge tab for moving POT between the mainchain and Solana without touching the CLI. Full wallet features include staking controls, coin control, stake-for-charity configuration, and the integrated block explorer.

Fresh Sync

The daemon automatically discovers peers via DNS seeds (seeds.potcoin.com) and syncs the chain. Expect ~1-2 hours for a full initial block download depending on bandwidth.


Solana Bridge

PotCoin's bridge is chain-native — all routing data is embedded on the blockchain using OP_RETURN outputs. No external APIs, no centralized servers in the transaction path. Bridge instructions live permanently on both chains and are fully auditable.

PotCoin → Solana (from daemon)

potcoind bridgetosol 1000 "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"

This sends 1000 POT to the bridge escrow with an OP_RETURN containing your Solana address. After 10 confirmations on PotCoin, the bridge service releases the equivalent SPL tokens to your Solana wallet.

potcoind bridgestatus          # list all your bridge transactions
potcoind bridgestatus <txid>   # details for a specific bridge TX

Solana → PotCoin

Send SPL POT to the bridge escrow ATA on Solana with a Memo instruction containing your PotCoin address (starts with P). After 30 Solana confirmations, the bridge sends the equivalent native POT to your mainchain address.

See the Whitepaper §4 for the full architecture including UTXO tier selection, security properties, and escrow distribution.


RPC Reference

PotCoin ships 28 custom RPCs beyond the standard Bitcoin set.

Staking

Command Description
getstakinginfo Status, difficulty, weight, expected time
getweight Total stake weight for confirmed outputs
getstaketx <txid> Detailed stake TX: days, amount, weight, reward %
setstakesplitthreshold <n> Set split threshold (1-999999)
getstakesplitthreshold Current split threshold
reservebalance [reserve] [amount] Exclude balance from staking
hashsettings <drift/interval> [sec] Configure hash drift and interval
stakeforcharity <cmd> Auto-donate % of stake rewards to addresses
multisend <cmd> Auto-send % of matured stakes to multiple addresses

Bridge

Command Description
bridgetosol <amount> <solana_addr> Bridge POT to Solana with OP_RETURN memo
bridgestatus [txid] List bridge transactions

Coin Control

Command Description
cclistcoins List spendable UTXOs with age, weight, potential reward
ccselect <hash> <index> Select specific UTXO
cclistselected List selections
ccreturnchange <bool> Control change behavior
cccustomchange <address> Set custom change address
ccreset Clear selections
ccsend <addr> <amount> Send using selected UTXOs

Chain Analytics

Command Description
getmoneysupply [height] Money supply at height
moneysupply Supply with 1/7/30-day inflation rates
getconfs <txid> Confirmation count
getsubsidy [target] Current PoW subsidy
getcheckpoint Synchronized checkpoint info
createbootstrap Create clean bootstrap.dat from best chain

Wallet Utilities

Command Description
checkwallet Check wallet integrity
repairwallet Repair wallet
deleteaddress <address> Permanently delete address
rescanfromblock <height> Rescan from block

All standard Bitcoin-era RPCs (getinfo, sendtoaddress, getnewaddress, signmessage, etc.) are also available. Run potcoind help for the complete list.


Architecture

Consensus

  • Hybrid PoW/PoS bootstrap — blocks 1-500 are Proof-of-Work (X13 hashing, 15-minute target difficulty retarget); block 501 onward is pure Proof-of-Stake
  • HyperStake-derived PoS kernel — stake hash depends on nStakeModifier, block time, prev output, and UTXO age; must satisfy hash < target × coin-day-weight
  • Staking parameters — 15 min minimum age, 25 day max age, 10 block coinbase maturity, 260s block time target
  • Automatic UTXO management — stake split above threshold (default 250 POT), combined stake outputs capped at 2,500 POT (Max Combine)

Supply Distribution

Block 1 mints 380,000,000 POT as the bridge escrow premine. The remaining 40,000,000 exists as the Solana SPL token reserve. Staking adds ~1% annually; the 420M hard cap is enforced in consensus via MAX_MONEY. The 0.420 POT minimum fee creates mild deflationary pressure.

Lineage

Bitcoin → Peercoin → NovaCoin → MotaCoin → PotCoin
                                             ↑ this repo

Each fork added: Peercoin (PoS consensus), NovaCoin (Scrypt hybrid), MotaCoin (X13 hashing, custom params, Guix builds), PotCoin (420M supply, Solana bridge, 28 custom RPCs, cannabis branding).


Whitepaper

Full protocol specification, economic model, consensus details, bridge architecture, and security properties: WHITEPAPER.md.


Network Services

Service URL
Block Explorer https://explorer.potcoin.com
Bridge Dashboard https://bridge.potcoin.com
Paper Wallet https://paper.potcoin.com
Retro Paper Wallet https://retropaper.potcoin.com
DNS Seed seeds.potcoin.com:16420
ElectrumX seeds.potcoin.com:50001 (TCP) / :50002 (SSL)

Community


Security

  • Do not paste your wallet seed or private keys anywhere
  • Keep wallet.dat backed up offline
  • Consider running a staking node behind Tor (proxy=127.0.0.1:9050) for IP privacy
  • Bridge transactions are irreversible after 10 on-chain confirmations — double-check Solana addresses before invoking bridgetosol

Report vulnerabilities responsibly — contact the core team directly via support@potcoin.net rather than filing a public issue.


Contributing

Pull requests welcome. Please:

  1. Fork and work on a feature branch
  2. Match the existing code style (Bitcoin-era conventions)
  3. Include test coverage where practical
  4. Describe the change clearly in the PR body

Consensus-critical code (anything in src/main.cpp affecting block/tx validation, src/kernel.cpp stake rules, src/chainparams.cpp parameters) needs exceptionally careful review.


License

PotCoin is released under the MIT License. See COPYING and LICENSE.

Your stake. Your community. Your PotCoin.