Start here
What is Setrya
Revenue-share settlement in fully shielded ZEC: who it is for, what it does, and what runs where.
On this page
Setrya is self-hosted software for paying the people you share revenue with. You import the fees your business actually earned, apply each partner's agreement, review anything that looks wrong, then pay every partner with one fully shielded ZEC transaction and give each of them a statement of their own. The amounts and the recipients stay off the public chain.
Who it's for
Setrya is for small crypto-native businesses that owe partners a share of their fees: a launch studio paying promoters, a platform paying creators, a protocol paying referrers. If you work this out in a spreadsheet today and pay from a wallet one address at a time, Setrya replaces both steps with a record you can show a partner or an accountant.
You run it yourself. One owner runs each installation, and the keys that move money live on a server you control. It's operator-managed custody on your own infrastructure. It isn't a hosted wallet, and it isn't a browser wallet.
The problems it solves
Payouts that nobody can check
A share of "revenue" means little until you know which revenue. Setrya keeps every fee row you import with its original fields and a fingerprint of the file, and you classify each row as an eligible fee, excluded or held. Trading volume, for example, is never counted as fees. Every payout then shows its fee base, the agreement version, the rate you approved and the exact zatoshis. Periods and exceptions shows how a period is calculated.
Paying in public
A normal crypto payment puts the recipient, the amount and your treasury on a public ledger for anyone to read. Setrya pays only inside one shielded pool, so the chain shows that a transaction happened and when, and not who was paid or how much. Privacy model lists exactly who can see what.
One problem stalling everyone
A missing address or a disputed row holds only the payouts it touches. Everyone else in the period can still be paid. Partners and payout addresses explains what holds a payout.
Payments you can't take back
Shielded payments can't be reversed, so Setrya checks before anything is signed. Your wallet builds the transaction, Setrya compares it with what you approved down to the zatoshi, and you confirm with your password before it's signed. If a payment's outcome is unclear after a crash or a timeout, Setrya checks the chain and only ever resubmits the same signed transaction. Approve and pay walks through it.
What you can do today
- Create projects, each with its own revenue sources, partners, agreements and settlement periods.
- Import a fee export as CSV, map its columns, classify each row, and commit it once. The same file can't be counted twice.
- Add partners and check that each payout address can receive a shielded payment on your network.
- Write versioned agreements that turn eligible fees into an amount owed.
- Calculate a period, resolve its exceptions, freeze a hashed snapshot and approve it.
- Enter and approve the conversion rate from your fee currency to ZEC.
- Pay every payable partner in one fully shielded transaction, inspected before signing, and follow it to confirmation.
- Issue one statement per partner, as a print view, a CSV, or an encrypted link that shows them only their own line.
- Download an encrypted backup of every record.
What runs where
| Part | Where it runs | What it holds |
|---|---|---|
| Web app | Any Node host. Vercel works | Nothing. It renders pages and relays your requests to the API |
| API | Your Linux settlement host | Your account, the encrypted records and the payment jobs |
| Database | Your settlement host, PostgreSQL 16 | Every record, with sensitive fields encrypted |
| Wallet service | Your settlement host | The spending keys, with the seed encrypted at rest |
The wallet service is the Setrya signer, a light-client Zcash wallet built on the Zcash Rust libraries. Architecture explains how the parts connect.
What's live on which network
| Testnet | Mainnet | |
|---|---|---|
| Imports, agreements, periods and statements | Yes | Yes |
| Shielded payments through the signer | Yes | Not until the signer's Zcash libraries know mainnet's NU7 height |
| Funding the payer wallet | Faucets are not paying right now | Send ZEC from any wallet that can pay an Orchard receiver |
Mainnet, testnet and regtest has the details.
Where to go next
Getting started takes you from an empty server to a first reviewed period. Before you move real money, read Keys, vault and sessions to see who holds what, and Fees and limits for what each payment costs.
All docs
Start here
- What is Setrya
Revenue-share settlement in fully shielded ZEC: who it is for, what it does, and what runs where.
- Getting started
Deploy the settlement host and the web app, create the owner, fund the wallet and close a first period.
- Mainnet, testnet and regtest
What each Zcash network is for, how Setrya keeps them apart, and what is live on each.
Using Setrya
- Projects and revenue sources
A project holds one business’s partners and periods. A source is where its fee figures come from.
- Import revenue
Upload a fee export, map its columns, classify each row and commit it without counting anything twice.
- Partners and payout addresses
Add the people you pay, check that their address can receive a shielded payment, and what holds a payout.
- Agreements
Versioned terms that turn eligible fees into what each partner is owed, and how revisions take effect.
- Periods and exceptions
Calculate a period, resolve the rows that need a decision, and freeze a snapshot for approval.
- Conversion rates
Rates you enter and approve to convert fees into ZEC, and how rounding to whole zatoshis works.
- Approve and pay
Approve a frozen snapshot, read the wallet’s inspection, authorise the payment and follow it to confirmation.
- Statements and sharing
One statement per partner, what its stamp means, and encrypted links that show a partner only their own line.
- Wallet and funding
The payer wallet’s health, balances by pool, its receiving address, and how to fund it.
Safety and trust
- Keys, vault and sessions
Who holds the spending keys, how records are encrypted, and the confirmations money movement needs.
- Privacy model
Exactly what you, each partner, the public chain and the chain server can see, and what Setrya cannot hide.
- Backups and recovery
What to back up, how to restore it, and how Setrya reconciles payments after an interruption.
- Fees and limits
The network fee every payment pays, minimum payouts, rounding, and the limits Setrya enforces.
Reference
- Architecture
The web app, the API, the database and the signer, how they connect, and what each one holds.
- The Setrya signer
The light-client wallet that builds, inspects, signs and broadcasts payments, and the rules it enforces.
- Payment states
Every state a payment can be in, what moves it on, and what Setrya does when the outcome is unknown.
- API
How the web tier reaches the API, authentication, response format and the main endpoints.
- FAQ
Direct answers to the questions operators and partners ask about Setrya.
- Glossary
Plain-word definitions of the Zcash and settlement terms in the app and these docs.