KasPass
Quick helpMembership page

The KasPass guide

Everything about KasPass in one place: how to run a membership from the dashboard, how members join and manage theirs, how the contracts work, and what they can and can't do. Each section stands on its own, so you can jump straight to the one you need.

Contents

  1. What KasPass is
  2. How it works: the pieces
  3. What's fixed and what can change
  4. Money: prices, fees, deposits and refunds
  5. For members: joining and managing a membership
  6. For creators: the dashboard, tab by tab
  7. Promotions and invite links
  8. Telegram, Discord and the holder club
  9. Linking from another website
  10. Common messages and what to do
  11. Safety, privacy and limits
  12. Quick answers

What KasPass is

KasPass lets a creator sell memberships that live on the Kaspa blockchain instead of inside a company's database.

How it works: the pieces

Each plan is a few small contracts that belong together.

PieceWhat it isWho controls it
Owner recordOne per creator. Names the creator's wallet and a separate backup wallet. Price changes, giving passes and other creator actions go through it.The creator. The backup wallet can hand it to new wallets.
Payout vaultWhere every payment lands.Only the owner record's current owner can withdraw.
Sales lane (minter)The only way into a plan. Holds the plan's prices (as KAS ceilings) and any supply limit.Anyone can buy; only the creator can change prices.
Pass (membership)One per member. Holds its owner, end date, the rates it was bought at, a refundable deposit and any prepaid balance.The member.
Fees wallet (keeper)A small wallet on the site's server. Pays network fees for auto-renewals and pays for free promotion and invite claims.The server. Its key never leaves it.
Server key (voucher)Signs each purchase and renewal at today's price.The server. The creator can replace it (see Payouts).

Prices in dollars, paid in KAS. A plan can be priced in CAD, USD, EUR or KAS. For a currency plan, the contract holds a KAS ceiling (by default 3 times today's amount), and the server signs each payment down to today's price, using Kraken exchange rates refreshed every minute. The server signs every payment at today's price, so a buyer pays today's price, not the ceiling. With no fresh exchange rate, nothing is sold and auto-renewals wait.

What the contracts guarantee and what the server decides

Network: each site runs on Kaspa mainnet (real KAS) or Testnet-10 (test KAS, for trying things). The strip at the top of every page says which.

What's fixed and what can change

This is the most important part to understand before launching a plan.

Fixed forever when a plan is created

These are written into the plan's contracts. To offer something different, create a new plan.

The dashboard lists these for each plan under Plans › Set when it was created.

Can change any time

What a creator can never do

Prices and existing members

Money: prices, fees, deposits and refunds

What a member pays

The KasPass fee

Other payment options

Refunds

Payments go straight to the creator, so KasPass can't refund them. A member who wants money back should contact the creator, whose links are on the membership page. These always come back to the member:

Prices shown in other currencies

For members: joining and managing a membership

Get a wallet

Get KAS

Buy KAS on a crypto exchange, then send it to your Kaspire address (Receive in Kaspire; always copy and paste the address). Send the price plus about 2 KAS: 1 KAS for the refundable deposit and a little for network fees.

Join a plan

  1. On the membership page, press Choose this plan on the plan you want, or arrive from the creator's website with the plan already chosen.
  2. Sign in with Kaspire. It's free: Kaspire asks you to approve a short message, and nothing is paid. On a computer you can also use Use the Kaspire app on my phone instead and scan the code.
  3. The pay box opens beside your plan. It shows what you get, the price, the refundable deposit and the total. Tick Prepay future … (auto-renew, optional) (months, years and so on, following the plan) if you'd like it to renew itself.
  4. Press Pay … KAS in Kaspire. Right under the button the page says "You're approving … KAS"; the outputs to match with Kaspire are under Match these with Kaspire, and the button itself shows each step (Waiting for Kaspire, Sending, Sent, confirming). Check the amounts match, then approve.
  5. Your membership appears within a few seconds. If you came from the creator's site, a button takes you back; otherwise, if the creator has a website, Open appears.

Paying from another wallet or an exchange (test networks only for now): on plans priced in a currency, sign in, pick the plan, and choose Pay from another wallet (QR code). Send the exact amount shown. The membership goes to the wallet you're signed in with; if the payment can't become a membership (too little or too late), it comes back automatically after an hour. It's switched off on mainnet until its new contract has been reviewed.

Free trials

Some plans let you try them free.

Renewing

Auto-renew (prepaid months)

Moving to a higher plan

Buy the higher plan. The unused part of your current one counts toward its price. Afterwards the page offers to end the lower one and give its deposit back. On plans priced in KAS there may also be Upgrade to lifetime.

Cancel or end a membership

Give your membership to someone else

Only if the plan allows resale: Manage your membership › Give it to someone else, then paste their Kaspa address or a .kas or .k name. They get the rest of your time and you lose access. It can't be undone. Some creators receive a small royalty when a membership changes hands; the page shows it first.

Linked wallets

On the holder club page you can add more wallets you own (Add another wallet, then switch Kaspire to that wallet and sign). Their NFTs and tokens count together for the holder club and promotions, and a wallet belongs to one member at a time.

New phone or computer

Install Kaspire and restore your wallet with its recovery words. Your membership is still in it.

For creators: the dashboard, tab by tab

The dashboard is at /dashboard on the site. Sign in with your wallet: the one that created the plans (Kaspire on a computer, or the Kaspire app on a phone). If you see This membership belongs to another wallet, Kaspire is on a different wallet: switch to the creator's wallet in Kaspire and sign in again. Every action that changes something on the blockchain is approved in Kaspire; settings like names and the page's look save straight away. Every setting has a "?" tip.

The plain words the dashboard uses: the keeper is the fees wallet, the recovery wallet is the backup wallet, setting up the owner record is Turn on payouts, and closing a pass is ending a membership.

First-time setup

The Overview's Get set up list walks through it (about 10 minutes):

  1. Turn on payouts (Payouts tab): choose a backup wallet, a separate wallet (even a paper one) kept somewhere safe. This creates the owner record and the payout vault, and costs about 1 KAS.
  2. Create your first plan (Plans tab): name, price, billing period, and the settings that are fixed at creation. Each plan locks about 1 KAS in its contract. Putting it on sale restarts the site to load it; the page is unavailable for about a minute.
  3. Connect your group and share your link: Telegram or Discord (Groups tab), then send people your page.

Also worth doing: top up the fees wallet (needed for auto-renewals and free claims, see Fees wallet), write your page, and turn on sale alerts.

Keep the backup wallet safe. Whoever holds it can take over ownership of your plans and your vault, a handover can't be undone, and the backup wallet itself can't be changed from the dashboard.

Overview

Your page

Words and links:

Look and brand: logo, profile photo, banner, colours (your own, or matched to your website), fonts, and a preview of your page.

Plans

Members

Prices & sales

Promotions

Groups

Telegram group, Discord server and holder club: see Telegram, Discord and the holder club.

Payouts

Settings

Fees wallet

Promotions and invite links

Holder promotion

A free period for holders of an NFT or token, for example "Migrated NACHO to KCC-20? Claim a free month on us."

A free period for people you choose, without being there when they claim.

Telegram, Discord and the holder club

Telegram group

Discord server

Holder club

Writing a holder club rules file

The rules file is a small JSON text file. Upload it under Groups › Holder club › Advanced: upload holder club rules, then press Check and apply. If anything is wrong, nothing changes and the message says what to fix. Download an example in that panel gives you a working file to start from.

Ask an AI to write it. Give any AI assistant this page's plain-text version, https://<your site>/guide.md, and describe your club in your own words: the collection, who should get in, and any levels. For example: "Write a KasPass holder club rules file for my BITCOIN NFT collection on mainnet. Anyone with 1 NFT is a Turtle Holder. Anyone who owns a rank 1 to 4 NFT, or has 200 credits, is a Whale." Then upload the file and use Check a wallet on a few wallets you know before relying on it.

The fields:

FieldNeededWhat it is
clubyesThe club's name, shown to members.
collectionyesYour NFT collection: {"network": "mainnet", "tick": "BITCOIN"}. Use "testnet-10" while testing.
tiersyesThe levels, at least one. Each is {"name": "Whale", "rule": {...}}, with an optional "discord_role" if the Discord role should have another name. Each level becomes a Discord role and can have its own Telegram group. Names must be different, and pass is taken.
bandsnoRank ranges that give credits: {"name": "Gold", "ranks": [5, 21], "credits": 25}. Ranges can't overlap, and need the ranks list.
count_listednotrue to count NFTs listed for sale. Default false: a listed NFT doesn't count.

Rules. Each rule has exactly one of these. To combine several, put them in any_of (any one is enough) or all_of (all are needed).

RuleExampleMeans
min_tokens{"min_tokens": 3}Holds at least 3 NFTs of your collection.
min_credits{"min_credits": 200}Has at least 200 credits from the bands.
owns_band{"owns_band": "Gold"}Owns at least one NFT in that band.
owns_token{"owns_token": [7, 42]}Owns one of these specific NFTs (token ids).
has_pass{"has_pass": true}Has an active paid membership on this site.
holds_nft{"holds_nft": {"tick": "NACHO", "min": 1}}Holds NFTs of another KRC-721 collection (whole number, 1 to 1000).
holds_token{"holds_token": {"tick": "NACHO", "min": 100000}}Holds a KRC-20 token amount.
holds_kcc20{"holds_kcc20": {"id": "<64-character covenant id>", "tick": "NACHO", "min": 1000}}Holds a KCC-20 token amount. The id comes from the token's official page.
any_of / all_of{"any_of": [{"owns_band": "Legacy"}, {"min_credits": 200}]}Combines rules.

Holdings add up across all the wallets a member has linked.

The ranks list (optional second file, only if you use bands): each NFT's rank, either {"1": 950, "2": 14} (token id, then rank) or a list of rows like [{"id": 1, "rank": 950}], which is what a spreadsheet export usually gives. The ranks come from your collection's own rarity list.

A full example:

{
  "club": "Bitcoin the Turtle",
  "collection": { "network": "mainnet", "tick": "BITCOIN" },
  "count_listed": false,
  "bands": [
    { "name": "Legacy", "ranks": [1, 4], "credits": 0 },
    { "name": "Gold", "ranks": [5, 21], "credits": 25 },
    { "name": "Silver", "ranks": [22, 210], "credits": 10 },
    { "name": "Bronze", "ranks": [211, 630], "credits": 5 },
    { "name": "Normal", "ranks": [631, 2100], "credits": 2 }
  ],
  "tiers": [
    { "name": "Turtle Holder", "rule": { "min_tokens": 1 } },
    { "name": "Whale", "rule": { "any_of": [ { "owns_band": "Legacy" }, { "min_credits": 200 } ] } }
  ]
}

Common messages:

Linking from another website

Common messages and what to do

MessageWhat to do
"We couldn't find the Kaspire wallet in this browser"Check the extension is installed and turned on, then reload. On a phone, use the Kaspire app.
"You need about … KAS and this wallet has … KAS"Add KAS to the wallet, then try again.
"That price was held for 10 minutes and has run out"Press the button again for today's price.
"Price unavailable right now"Exchange rates couldn't be read just now. Try again in a minute.
"We're still loading the latest payments"Wait a minute and try again.
"You've been signed out"Sign in again.
"Your payment was sent and is still being confirmed"Don't pay again. Refresh in a minute.
"Free passes are paused for a moment"The site's fees wallet is low. The creator tops it up, and claims restart on their own.
"Couldn't read what your wallet holds right now"The token or NFT index didn't answer. Try again in a minute; it never counts as holding nothing.
"This invite has already been used"Each invite link works once. Ask the creator for a new one.
"This membership belongs to another wallet" (dashboard)You signed in with a wallet that isn't the creator's. Switch wallets in Kaspire and sign in again.
"This page isn't public"The creator only shares the page by private link.

Still stuck? Contact the creator (links on their page) and say which message you saw.

Safety, privacy and limits

Quick answers