About SolSub

How on-chain subscriptions work, and where SolSub fits in.

The program SolSub is built on

SolSub is a client for the Solana Subscriptions & Allowances program (De1egAFMkMWZSN5rYXRj9CAdheBamobVNubTsi9avR44) — an audited, on-chain program on Solana mainnet. It does one thing: it lets your wallet grant someone a bounded permission to pull tokens — how much, how often, and to whom — and then enforces those bounds on every single charge.

Everything is pull-based. Nothing moves until the authorized party collects, and the program rejects any charge that comes too early, exceeds the cap for the period, or tries to send funds anywhere other than the destinations fixed when the permission was created. There is no company in the middle holding your money or your card details — the rules live on-chain, and the chain enforces them.

Three kinds of items

The program creates three types of items, and SolSub shows all of them:

• Subscriptions. A merchant publishes a plan — price, token, and billing period are fixed plan terms. When you subscribe, the merchant may pull up to the plan amount once per billing period, and never more. Cancelling keeps your access until the period you already paid for ends.
• Recurring allowances. A per-period spending cap you grant to any recipient — for example, 10 USDC per week. The cap resets each period; the recipient can never pull more than the cap within one period.
• Fixed allowances.A one-time total cap — for example, 50 USDC, ever. The remaining amount only goes down; once it's spent or you revoke it, it's done.

How SolSub fits in

SolSub is a non-custodial clientfor that program, with optional hosted convenience. The app reads your subscriptions, allowances, and plans directly from the blockchain, builds the transactions you ask for, and hands them to your own wallet app to review and sign. SolSub never holds your keys and can never move your funds anywhere you didn't agree to — every charge is on terms you approved in your own wallet.

As a user, that means: see every subscription and allowance tied to your wallet, what each one has charged, subscribe to verified plans, create allowances, cancel or revoke any time, and reclaim your storage deposit when an item is closed.

As a merchant, that means: create plans owned by your wallet, see who's subscribed and whether they're active or due, collect due payments, and verify any wallet's paid status with a single on-chain read.

Walkthrough: subscribing as a user

Say a merchant offers a plan at 5 USDC per month:

1. Connect your wallet. Open SolSub and connect the Solana wallet you already use — no sign-up.
2. Find the plan. Browse the verified catalog on Discover, or search by the plan or merchant address.
3. Review the exact terms.SolSub shows the price, token, billing period, and where payments go. The terms you see are locked into the transaction itself — if the plan changes before your transaction lands, it fails instead of charging you something you didn't see.
4. Approve once in your wallet. One signature creates the subscription. The merchant can now pull up to 5 USDC each month — no more, no sooner.
5. Watch the charges.Each billing period, the subscription's detail view shows exactly how much has been pulled of what you approved.
6. Cancel whenever. Unsubscribe and you keep access until the end of the period you already paid for. Change your mind during that window and you can resume.
7. Close and reclaim. Once the subscription has fully ended, close it out and the small storage deposit returns to your wallet.

Allowances are even simpler: tap ＋ on Home, choose fixed or recurring, set the recipient, token, and cap, and approve in your wallet. The detail view shows usage against the cap, and revoking takes effect immediately — one tap, one signature, done.

Walkthrough: running a plan as a merchant

Say you want to charge 5 USDC per month for your service:

1. Create the plan. Set the price, token, and billing period — anywhere from daily to yearly. Choose your payout wallets carefully: destinations are fixed forever at creation. The plan lives on-chain, owned by your wallet.
2. Share it.Anyone can subscribe with your plan address; verified plans also appear in SolSub's Discover catalog.
3. Watch subscribers arrive.Subscriptions are on-chain accounts — SolSub lists who's subscribed and whether each one is active, due, or cancelled, with full payment history.
4. Collect on schedule. Run Collect due chargesat least once per billing period. The program rejects double-charges within a period, so running it more often than needed is safe — but a fully missed period can't be collected retroactively.
5. Verify access."Has this wallet paid?" is a single cheap on-chain read — the app's Verify a wallet screen does it, and your backend can do the same on every request.
6. Wind down when you're done. Sunsetting a plan immediately blocks new subscribers and freezes its terms, while existing subscribers remain chargeable until the end date. After that, delete the plan to reclaim its rent.

Ready to try it? Get SolSub on the Solana dApp Store, or reach out on Telegram with questions.