Technical Documentation

Build on substrate.icu

Developer reference for the substrate.icu ecosystem — a suite of infrastructure, tooling, and applications built as Substrate FRAME pallets, deploying to Polkadot.

Documentation in progress - Paseo testnet

Introduction

substrate.icu is a suite of Substrate FRAME pallets for the Polkadot ecosystem. Three protocols are live on Paseo testnet.

Protocol Description Status
PNS2 Blockchain-native name service. Human-readable names resolving to wallet addresses and DNS records. Paseo Testnet
ZK-PKI Hardware-anchored public key infrastructure. Tier 1: TPM 2.0 (gold standard, full PoP). Tier 2: Android StrongBox (full PoP). Tier 3: Apple Secure Enclave (machine identity only, no PoP cert). Paseo Testnet
Dotwave The everything app. Multi-platform, written in Rust. Your gateway into the substrate.icu ecosystem — ZK-PKI ceremony, Secret Squirrel, and more coming. Paseo Testnet
Secret Squirrel Dead drop messaging built into Dotwave. Deniable communication between verified identities. Paseo Testnet
Both PNS2 and ZK-PKI have completed a full Fagan inspection with 226 tests passing. Live on Paseo. Questions? apollonius21@proton.me or find prodigalwon on the Polkadot Forum.

Architecture overview

PNS2 and ZK-PKI are independent FRAME pallets that integrate cleanly. Neither requires the other.

Paseo testnet

All protocols are live on Paseo, Polkadot's public testnet. Paseo is the path to mainnet.

DetailValue
NETWORKPaseo
ROOT DOMAIN*.paseo.substrate.icu
RPCwss://rpc.substrate.icu
TEST SUITE226 passing. Full regression tested, hardened, and benchmarked. Fagan inspection complete. (Paseo testnet)
TARGETPolkadot mainnet parachain

Polkadot Name Service 2

PNS2 is a blockchain-native DNS replacement built as a Substrate FRAME pallet. Names resolve to wallet addresses and standard DNS records. substrate.icu is the root domain.

Bring your own gateway. Point your PNS2 name at an IPFS gateway, a GitHub Pages site, or any web content you control. Because resolution goes through the Snorkel — real DNS, not a proxy — your name gets a legitimate DNS record, which means a legitimate TLS certificate. No workarounds. Reach out to get your gateway TLS cert set up.

Zero-Knowledge Public Key Infrastructure

ZK-PKI is a hardware-anchored identity system built as a Substrate FRAME pallet. Identity certificates are minted as NFTs, anchored to the hardware security chip in the user's device. One certificate is issued per hardware root per issuer. Proof of personhood is only enforced when the issuer performs KYC — without it, a user with multiple devices can hold multiple certificates. The KYC step is off-chain, issuer-driven, and not required by the protocol.

Dotwave

Dotwave is the everything app for the substrate.icu ecosystem. Written in Rust, multi-platform, and your gateway into the testnet. It handles the ZK-PKI ceremony via Android StrongBox, hosts Secret Squirrel, and is the launchpad for a growing suite of apps, games, and features. If substrate.icu is the highway, Dotwave is the on-ramp.

Reserved names

The following names are reserved at the pallet level and cannot be registered by users on any substrate.icu network.

NameReason
wwwSystem infrastructure
docsSystem infrastructure
apiSystem infrastructure
rpcSystem infrastructure
statusSystem infrastructure
adminSystem infrastructure
faucetSystem infrastructure
nodeSystem infrastructure
gatewaySystem infrastructure
resolverSystem infrastructure
dotwavedotwave product
snorkelSnorkel DNS bridge
zkpkiZK-PKI protocol
zk-pkiZK-PKI protocol
pnsPNS2 protocol
pns2PNS2 protocol
registryPNS2 protocol
explorerFuture product
substrateBrand protection
polkadotBrand protection
kusamaBrand protection
paseoBrand protection

Patent & IP

The ZK-PKI system is patent pending.

DetailValue
APPLICATIONUS Provisional 64/043,754
FILEDApril 19, 2026
STATUSPatent Pending