Wallet infrastructure for Zcash
Zcash wallet connections, in one React integration.
Connect browser extensions, mobile wallets, and viewing keys with one interface. Build shielded payment flows with ZIP-321.
pnpm add @cicero-zcash/react- 7 wallet paths
- ZIP-316 addresses
- ZIP-321 payments
Wallet connection preview
Try the real connect flow
Your shielded balance
—ZEC
Connect a supported wallet to display its current account and balance here. No sample balance is shown.
Wallet Connection Studio
Customize the button style, border geometry, typography, and badges in real-time. Live changes instantly reflect across both the workbench and the header navigation bar above.
Install extension to enable 1-click in-browser approval.
import { CiceroProvider, CiceroConnectButton, useAccount, useBalance } from '@cicero-zcash/react';
export default function App() {
return (
<CiceroProvider initialNetwork="mainnet" appName="My Zcash dApp">
<nav className="flex justify-between items-center p-4 border-b border-zinc-800">
<span className="font-semibold text-white">My Zcash dApp</span>
<CiceroConnectButton
variant="primary"
size="sm"
radius="md"
label="Connect Zcash Wallet"
showBalance={true}
showNetwork={true}
showIcon={true}
/>
</nav>
<MainDashboard />
</CiceroProvider>
);
}
function MainDashboard() {
const { address, isConnected, wallet } = useAccount();
const { zec, usd } = useBalance();
return (
<div className="p-6">
{isConnected ? (
<div className="space-y-2">
<h3 className="font-bold text-white">Connected to {wallet?.name}</h3>
<p className="font-mono text-xs text-zinc-400">Address: {address}</p>
<p className="text-emerald-400 font-mono font-bold">Balance: {zec} ZEC (~$${usd} USD)</p>
</div>
) : (
<p className="text-zinc-500">Please connect your Zcash wallet above.</p>
)}
</div>
);
}One Interface. All 7 Zcash Wallets.
One API for browser extensions, mobile wallet handoffs, read-only viewing keys, and local development sessions.
Noir Wallet
Web Extension
Self-custodial privacy extension for shielded Zcash & ZECFi with direct in-browser JSON-RPC authorization.
- Native zcash_requestAccounts RPC
- Zero-knowledge Orchard pool
- Automatic network detection
Zelcore Wallet
Extension & Desktop
Multi-asset web extension & desktop wallet with 1-click transparent ZEC binding and zel: protocol deep-linking.
- Zero-friction 1-click connection
- Native zel:?action=pay deep link
- Multi-currency portfolio bridge
Zucchini Wallet
Web Extension
Built specifically for Zcash with 1-click side-panel approvals via the official @zucchinifi/dapp-sdk.
- 1-click in-browser approval
- Live network sync listener
- Full Unified Address (u1) support
Zashi (Electric Coin Co.)
iOS & Android
Electric Coin Company’s shielded mobile wallet. Create a ZIP-321 request that users can review and approve in their wallet.
- ZIP-321 payment request handoff
- User reviews before approval
- Orchard & Sapling support
Ywallet
Desktop & Mobile
High-performance privacy wallet for desktop and mobile with ultra-fast sync and advanced transaction construction.
- Ultra-fast blockchain sync
- Cold-wallet signing bridge
- Multi-account management
Viewing Keys
Read-Only Key
Non-custodial read-only inspection for accounting, tax calculation, and proof-of-reserves without spend authority.
- Unified & Sapling viewing keys
- Zero spend key exposure
- Compliance & accounting ready
Ephemeral Dev Sessions
In-Memory Testnet
Instantly creates an in-memory session wallet pre-funded with simulated testnet ZEC for rapid local dApp testing.
- Instant zero-dependency launch
- Pre-funded simulated balance
- Perfect for hackathons & CI
Build a ZIP-321 payment request
Configure a recipient, amount, and memo. Cicero builds the payment URI and QR code for compatible wallets. This page demonstrates the request flow; it does not submit a transaction or generate a proof.
Demo only: no ZEC is transferred. The final unlock is simulated so you can preview a paywall experience.
Scan to review a 0.02 ZEC payment request in a compatible wallet
Simulates authorization and an access grant. No wallet prompt or transaction is created.
Built on Zcash Cryptographic Standards
Cicero provides a shared React interface for wallet connection, account state, balances, and Zcash payment requests.
RainbowKit-Style Connect Experience
A single <CiceroConnectButton /> renders a multi-state wallet pill: connect trigger → modal selector → connected drawer with live balance, network badge, QR code, and disconnect.
Unified Support for 7 Zcash Wallets
Supports Noir, Zelcore, Zucchini extension, mobile Zashi, Ywallet, read-only Viewing Keys, and Ephemeral Dev Sessions without writing custom adapters.
Bi-Directional Network Synchronization
Cicero auto-detects the wallet's active network on connect and listens for live change events. Toggling Mainnet ↔ Testnet in extension or app updates state in real-time.
Unified Address (ZIP-316) Parsing
Validates and classifies Unified Addresses (u1), Sapling shielded pools (zs1), and transparent addresses (t1). Cryptographic network inference directly from address prefixes.
Isolated Network Balance Queries
Balances are queried and cached per-network. Switching from Mainnet to Testnet instantly fetches the correct shielded balance with zero cross-state pollution.
Real-Time Fiat Rate Oracle
The useZcashPrice() hook provides live ZEC → USD conversion with decentralized API fallbacks, automatic caching, and configurable refresh intervals.
Where shielded wallet support helps
Privacy isn't just an optional feature — it is foundational security for decentralized commerce, confidential corporate treasuries, and free speech.
Privacy-First dApp Onboarding
The Pain: Public wallet addresses can make transaction history easy to inspect and link across applications.
The Cicero Fix: Cicero supports shielded Zcash address flows. The privacy properties depend on the address pool, wallet behavior, and how the application handles user data.
Confidential Treasury Dashboards
The Pain: Teams may need to share selected balance data with auditors without granting transaction signing authority.
The Cicero Fix: Use a read-only viewing key in an internal dashboard. Viewing keys can expose transaction details, so limit access and handle them like sensitive credentials.
Whistleblower & Investigative Portals
The Pain: Public transaction histories can reveal relationships between addresses and make sensitive activity easier to trace.
The Cicero Fix: Cicero supports shielded Zcash wallet flows, which can reduce public transaction visibility. Wallets and apps may still expose network or account metadata; operational privacy needs separate care.
Developer Reference
Everything you need to integrate zero-knowledge Zcash wallet connection and ZIP-321 checkout into your React applications.
pnpm add @cicero-zcash/react
# or
npm install @cicero-zcash/react
# or
yarn add @cicero-zcash/reactimport { CiceroProvider, CiceroConnectButton } from '@cicero-zcash/react';
export function App() {
return (
<CiceroProvider initialNetwork="mainnet" appName="My Zcash dApp">
<header className="flex justify-between items-center p-4 border-b border-zinc-800">
<CiceroConnectButton variant="primary" size="md" radius="md" />
</header>
<MainApp />
</CiceroProvider>
);
}import { useAccount, useBalance, useCicero } from '@cicero-zcash/react';
function Dashboard() {
const { address, isConnected, wallet } = useAccount();
const { zec, usd, refetch } = useBalance();
const { network, switchNetwork } = useCicero();
if (!isConnected) return <p>Not connected</p>;
return (
<div>
<p>{wallet?.name} on {network}</p>
<p>{address}</p>
<p>{zec} ZEC (~$${usd})</p>
<button onClick={refetch}>Refresh</button>
</div>
);
}import { generateZip321Uri, getWalletDeepLinks } from '@cicero-zcash/react';
const uri = generateZip321Uri({
address: 'u1q0v6wvg9u04vj945r20s9x2kqu4r73cstfqdfm8e8m57u3...',
amount: 0.05,
memo: 'Order #9042 verification'
});
const { zashi, ywallet } = getWalletDeepLinks(uri);Component Props:<CiceroConnectButton />
| Prop | Type | Required | Description |
|---|---|---|---|
| variant | 'primary' | 'outline' | 'dark' | 'ghost' | 'gradient' | 'gold' | Optional | Button visual style token (defaults to signature emerald primary) |
| size | 'sm' | 'md' | 'lg' | Optional | Button dimension and padding tier (defaults to md) |
| radius | 'none' | 'sm' | 'md' | 'lg' | 'full' | Optional | Corner geometry radius (defaults to md / 6px) |
| label | string | Optional | Custom button label text (defaults to "Connect Zcash Wallet") |
| showBalance | boolean | Optional | Show shielded balance in the connected pill (defaults to true) |
| showNetwork | boolean | Optional | Show network indicator badge in connected pill (defaults to true) |
| showIcon | boolean | Optional | Display zero-knowledge privacy shield icon beside label (defaults to true) |
| className | string | Optional | Custom CSS classes for the connect button trigger |
React Hooks Suite
| Hook | Returns / Capabilities |
|---|---|
| useCicero() | Full context: account, network, balance, connect, disconnect, switchNetwork, modal controls |
| useAccount() | Account state: address, isConnected, isConnecting, wallet, disconnect |
| useBalance() | Balance state: zec, usd, isLoading, refetch |
| useConnectModal() | Modal controls: isOpen, openConnectModal, closeConnectModal |
| useAccountModal() | Modal controls: isOpen, openAccountModal, closeAccountModal |
| useZcashPrice() | Live ZEC/USD price with convertZecToUsd() helper |
| useZucchiniWallet() | Direct Zucchini adapter: isAvailable, connect, address, getBalance |
Install Cicero Agent Skill or Copy Prompts
Equip your AI assistant (Cursor, Claude Code, Windsurf, Antigravity, ChatGPT, Copilot) with deep knowledge of shielded Zcash, `@cicero-zcash/react`, and ZIP-321 payment request specs.
You are an expert full-stack developer specialized in building decentralized applications (dApps) on Zcash using @cicero-zcash/react (the universal wallet connection kit for shielded Zcash).
Context & Rules:
1. Always use '@cicero-zcash/react' for all wallet connection, address management, shielded balances, and payment dispatch.
2. Setup requires wrapping client components with <CiceroProvider initialNetwork="mainnet" appName="YourAppName">.
3. For drop-in connection buttons, use <CiceroConnectButton variant="primary" size="md" radius="md" showBalance={true} showNetwork={true} />.
4. Supported wallets include:
- Zucchini Browser Extension (via @zucchinifi/dapp-sdk with 1-click in-browser authorization)
- Noir Wallet (self-custodial privacy extension for Orchard & ZECFi with native in-browser RPC 'zcash_requestAccounts')
- Zelcore Wallet (multi-asset extension & desktop with 1-click transparent ZEC binding and 'zel:' URI protocol)
- Zashi & Ywallet (mobile/desktop shielded wallets connecting via ZIP-321 QR handoff)
- Viewing Keys (read-only auditor view for accounting and taxes with 'uview...' or 'zxviews...')
- Ephemeral Dev Sessions (in-memory testnet wallet for testing without external tools)
5. Address formats:
- Unified Addresses start with 'u1' (mainnet) or 'utest1' (testnet).
- Sapling addresses start with 'zs1'.
- Transparent addresses start with 't1' (mainnet) or 'tm' (testnet).
6. Hooks available:
- useAccount(): { isConnected, isConnecting, address, wallet, disconnect }
- useBalance(): { zec, usd, isLoading, refetch }
- useCicero(): { network, switchNetwork, openConnectModal, openAccountModal, sendPayment, disconnect, wallets }
7. For payments or micro-tips, use 'generateZip321Uri({ address, amount, memo })' and 'getWalletDeepLinks(uri)'.