Skip to content

Coinage

Introduction

Coinage is the Polkadot App's peer-to-peer payment feature. From a user perspective, it is a way to send and receive funds App-to-App with the privacy and personhood properties of the underlying pallet-coinage primitive. From a Product developer perspective, Coinage is one of two payment surfaces a Product can route through:

  • Coinage: Personhood-gated, peer-to-peer payments where the App is the originating UI on both sides.
  • Standard Balances transfer surface: General transfers and merchant-style flows.

Underlying asset: HOLLAR before pUSD

Coinage is backed by a stablecoin on Asset Hub (configured via UnderlyingAssetId). The configured asset is HOLLAR, and the system is designed to migrate to pUSD when pUSD lands. The asset is an implementation detail of the recycler, onboard, and offboard layer, not a gate on the developer-facing surface. The narrative below is stable across the HOLLAR-to-pUSD transition.

Provisional

The App's send/receive UX details and the recommended Product-side integration pattern are still being finalized by Parity. This page documents the conceptual model; per-flow specifics will be added once the surface is confirmed.

Conceptual Model

Three properties differentiate Coinage from a plain Balances.transfer_keep_alive:

  • Personhood-aware: Coinage payments can be gated on PoP, sending to "any real person on the network" rather than to a specific account address. The recipient's address need not be known to the sender.
  • Privacy-preserving by default: Coinage routes through the alias and Ring-VRF surface where appropriate, so the on-chain trail does not link the sender's account to the recipient's account in the same way a public transfer does.
  • App-native UX: The send and receive flows are rendered in the Polkadot App on both sides, with the user approving the transaction on their phone.

For the pallet-level storage model, privacy primitives, and dispatch surface, see the pallet-coinage reference.

Where to Go Next

  • Learn Proof of Personhood


    The personhood surface Coinage gates on, including Ring-VRF aliases and the Full and Lite tier model.

    Reference

Last update: June 16, 2026
| Created: June 16, 2026