Docs

How the jar works

Everything Zyhipem does, in plain words: what gets swept, how desks count, where the yield comes from, and what a pay link is.

Getting started

Open the app and sign in with an email to get a wallet without a seed phrase, or connect the wallet you already use on Solana. Connecting is enough to look around. The first time you move money you sign one free message that proves the wallet is yours — no transaction, no fee.

The jar

The jar is one USDC balance. Sweeps, drop-offs and claimed links all land in it. It earns a base yield that is paid daily and is variable: it follows the dollar markets the balance is lent to and can go down. Withdraw to your own wallet whenever you like; there is no lock-up.

Goals split the jar by size — a $1,200 trip and a $1,800 laptop share the balance 40/60. Goals are labels, not separate accounts; you can delete one at any time.

Sweeping dust

A scan reads every token balance in a wallet from the Solana network and prices it. Anything too small to sell on its own is dust. You pick what goes, and the sweeper swaps it into USDC through Jupiter and other venues in one batch instruction, signed once.

Some tokens are never swapped. They are hidden from the default view, and each shows why:

  • Arrived unasked with a link in its name.
  • Copies a known ticker.
  • No market to sell into.
  • Sub-cent transfer sent to bait copy-paste.

You can scan any address read-only. Sweeping needs the wallet that owns it.

Drop-offs

  1. Find a partner desk in the app — filter by city, currency, coins or transit cards.
  2. Get a drop-off code. It is a signed request, valid for 24 hours at that desk, shown as a QR code.
  3. At the desk, the staff count your notes, coins and card balance in front of you at the rate the desk posted.
  4. The desk confirms; the value lands in your jar and a receipt with the counted amounts appears under My drop-offs.

Think the count is wrong? Open a dispute from the receipt within 7 days. The desk's count is reviewed and the difference, if any, is paid into the jar.

Transit cards

Desks read the spending balance on these cards. Deposits and card fees follow the issuer's own rules:

CardCityWhat to know
SuicaTokyoSpending balance only — the ¥500 deposit is refunded at the issuer's counter (¥220 handling fee).
PASMOTokyoSame rules as Suica: the deposit stays with the issuer.
ICOCAOsakaSpending balance only; the deposit is refunded by the issuer.
Welcome SuicaTokyoNo deposit and no refund from the issuer — the desk is the only way out after day 28.
OysterLondonPay-as-you-go balance. The £7 card fee is not refundable since September 2022.
OctopusHong KongOn-loan cards: the issuer charges HK$11 or 1% if returned within 90 days.
EZ-LinkSingaporeStored value only.
T-moneySeoulStored value; convenience-store refunds carry a fee.
EasyCardTaipeiStored value; the card cost is not refunded.
OpalSydneyStored value on adult and child cards.
RabbitBangkokStored value only.
Navigo EasyParisLoaded tickets are read at face value.

Lock an amount from the jar into a link, add a note, choose how long it lives (1 to 30 days) and, if you like, a passcode you share separately. The person who opens it claims with an email — they don't need a wallet. An unclaimed link returns to your jar when it expires, and you can cancel an active one at any time.

Fees

  • Scanning, holding, creating and claiming links: free.
  • Sweeping: 1% of the swept value, minimum $0.05. The priority fee is paid from the sweep.
  • Drop-offs: the spread each desk posts before you hand anything over.
  • Withdrawals: only the priority fee, paid in SOL.

Security

Every move out of a wallet is signed by you. Sign-in is a plain message signature that cannot move funds. We never ask for a seed phrase, and support will never message you first. Cash handed to a desk is the desk's responsibility until it confirms the deposit to your jar.

SDK

Desk partners and wallets can create drop-off codes and read sweep quotes with the SDK.

import { Zyhipem } from "@zyhipem-protocol/sdk";

const jar = new Zyhipem({ network: "solana" });

// price the dust in a wallet (read-only)
const quote = await jar.sweep.quote({ owner });
console.log(quote.tokens.length, quote.net); // e.g. 14, 18.42 (USDC)

// a desk confirms a counted drop-off
await jar.desks.confirm({ code: "K7Q-42M", counted: [{ currency: "JPY", notes: 4000, coins: 630 }] });

FAQ

What counts as dust?

Any token balance too small to be worth a swap on its own — usually under a few dollars. A scan lists them with their value in USDC, and you pick which ones go.

How do you keep spam tokens out?

Tokens that arrived unasked, copy a real ticker, have no liquidity, or were sent in sub-cent amounts to bait copy-paste are hidden and never swapped. You can still review the hidden list.

Do I need a seed phrase?

No. Sign in with an email and you get a wallet straight away. If you already have one on Solana, connect it instead — sweeping always happens from your own wallet, after you sign.

Which currencies can I drop off?

Partner desks take notes and coins in the currencies they list, plus balances on the transit cards they can read. Each desk page shows exactly what it accepts and its current rate.

What about the deposit on my transit card?

Some cards carry a refundable deposit that only the issuer pays back. We read and move the spending balance; the desk tells you if a deposit refund is worth claiming at the counter instead.

Where does the yield on the jar come from?

Jar balances are lent to vetted dollar markets. The rate is variable — it moves with those markets and can go down. It is shown live in the app and paid daily.

How does a pay link work?

You lock an amount into a link and share it anywhere. Whoever opens it claims with an email. If nobody claims it before it expires, the money returns to your jar.

Can I take my money out?

Any time, to your own wallet, in USDC. There is no lock-up and no withdrawal fee beyond the priority fee.

Is it custodial?

Sweeps and withdrawals are signed by you, from your wallet. Cash handed to a partner desk is held by that desk until it confirms the deposit to your jar.

What if a desk gets my count wrong?

Every drop-off has a receipt with the counted amounts. Dispute it from the receipt within 7 days and the desk's count is reviewed against its camera log.