Hackathon Winner

Cicero v0.2.10 is Live: The universal RainbowKit for shielded Zcash. 1-click connect for Noir, Zelcore, Zucchini & Zashi.

View on GitHub

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.

@cicero-zcash/react
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

testnet
01

Connect a supported wallet to display its current account and balance here. No sample balance is shown.

Wallet stateWaiting for connection
React SDK · v0.2.10Shielded-first · ZIP-316
Interactive Design Studio

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.

Design Presets:1-click curated themes
Component StylingSyncs with Header
Connected Pill & Icon Toggles
Display Shielded BalanceShows real-time ZEC balance in connected state
Display Network IndicatorShows active Mainnet / Testnet status dot
Display zk-Shield IconRenders privacy shield glyph alongside trigger text
Live Interactive Preview
Click button to launch modal
🥒
Zucchini Browser Wallet

Install extension to enable 1-click in-browser approval.

Store
variant: primarysize: smradius: md
Generated React Code
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>
  );
}
Full Ecosystem Interoperability

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

In-Browser RPC

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
window.noirwallet.zcashMainnet & Testnet

Zelcore Wallet

Extension & Desktop

1-Click Connect

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
zel: URI & Extension BindingMainnet Native

Zucchini Wallet

Web Extension

Dedicated 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
@zucchinifi/dapp-sdkMainnet & Testnet

Zashi (Electric Coin Co.)

iOS & Android

Official Mobile

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
ZIP-321 QR ProtocolMainnet & Testnet

Ywallet

Desktop & Mobile

High Performance

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
ZIP-321 QR ProtocolMainnet & Testnet

Viewing Keys

Read-Only Key

Auditor Mode

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
uview... / zxviews...Mainnet & Testnet

Ephemeral Dev Sessions

In-Memory Testnet

Zero Setup

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
In-Memory KeypairSimulated Testnet
Interactive payment demo

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.

Transaction ParametersZIP-321 Protocol Ready
ZEC
Constructed ZIP-321 Payment URI:
zcash:u1q0v6wvg9u04vj945r20s9x2kqu4r73cstfqdfm8e8m57u3a59u39sp4x76scl30f2q39k8cws6k6x8k5g4eexn57k87w7z8f7k?amount=0.02&memo=UEFZV0FMTDp1bmxvY2s6aGFsbzItemstYWxwaGEtdjE
Direct Handoff:Open ZashiOpen Ywallet
Payment request preview
Request ready

Scan to review a 0.02 ZEC payment request in a compatible wallet

Payer Status
No Wallet Linked

Simulates authorization and an access grant. No wallet prompt or transaction is created.

Engineered For Zero-Knowledge Privacy

Built on Zcash Cryptographic Standards

Cicero provides a shared React interface for wallet connection, account state, balances, and Zcash payment requests.

Core UI

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.

Multi-Wallet

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.

Live Sync

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.

Multi-Pool

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.

State Machine

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.

Price Feed

Real-Time Fiat Rate Oracle

The useZcashPrice() hook provides live ZEC → USD conversion with decentralized API fallbacks, automatic caching, and configurable refresh intervals.

Real-World Impact

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.

Shielded address support (pool dependent)
Auto network detection (Mainnet / Testnet)
Multi-wallet support (Noir, Zelcore, Zucchini, Zashi, Ywallet)

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.

Viewing key read-only auditor mode (uview/zxviews)
Cached ZEC/USD price data
One-click account drawer with instant QR receive

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.

Shielded pool support where available
Unified Address (ZIP-316) support
Ephemeral Dev Sessions for air-gapped test workflows
API & Documentation

Developer Reference

Everything you need to integrate zero-knowledge Zcash wallet connection and ZIP-321 checkout into your React applications.

Installation
pnpm add @cicero-zcash/react
# or
npm install @cicero-zcash/react
# or
yarn add @cicero-zcash/react
RainbowKit-style Connect Wallet
import { 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>
  );
}
Account & Balance Hooks
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>
  );
}
ZIP-321 Payment Dispatching
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 />

PropTypeRequiredDescription
variant'primary' | 'outline' | 'dark' | 'ghost' | 'gradient' | 'gold'OptionalButton visual style token (defaults to signature emerald primary)
size'sm' | 'md' | 'lg'OptionalButton dimension and padding tier (defaults to md)
radius'none' | 'sm' | 'md' | 'lg' | 'full'OptionalCorner geometry radius (defaults to md / 6px)
labelstringOptionalCustom button label text (defaults to "Connect Zcash Wallet")
showBalancebooleanOptionalShow shielded balance in the connected pill (defaults to true)
showNetworkbooleanOptionalShow network indicator badge in connected pill (defaults to true)
showIconbooleanOptionalDisplay zero-knowledge privacy shield icon beside label (defaults to true)
classNamestringOptionalCustom CSS classes for the connect button trigger

React Hooks Suite

HookReturns / 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
AI-Assisted Development Ecosystem

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.

Download SKILL.md
Full dApp Specialist System Prompt
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)'.
Paste into Cursor Composer, Claude Code, Windsurf, or CopilotTokens: ~350