Identity-first
Payments are bound to a Transfer Identity Number (TIN) and authorized through GPRU scopes. Route metadata stays off-chain; the chain sees only commitments.
Intent-based
The sender signs an intent that fixes recipient, amount, mint, nonce, and
validity window. Every downstream role verifies against that intent
byte-for-byte.
Privacy-preserving
TCAP records balance transitions as commitments and owner-decryptable snapshots. The public ledger reveals movement, not amounts or parties.
The core idea
Most payment networks collapse three responsibilities into one operator: authorization, routing, and submission. TSN separates them.Transport does not authorize, and authorization does not require transport to
be honest. Mother Nodes, Receivers, and Cranker Nodes move traffic through TSN, but they
cannot forge a Mother signature, rewrite sender-signed fields, or replay a
settlement.
The five roles
Every role fails closed. A Node that cannot verify rejects. A Cranker that submits a mutated transaction is rejected by the on-chain program. A replayed settlement hits a spent nullifier.
Follow a payment through TSN
1
Sender signs a payment intent
An off-chain intent binds recipient, amount, mint, nonce, and validity
window to the sender’s TIN. It is never public and never re-signed
downstream.
2
Node verifies
A stateless Node checks signatures, TIN and GPRU bindings, sequence, expiry,
and policy. The Node holds no signing authority and can only accept or
reject.
3
Receiver stores and leases the work
The Receiver is durable infrastructure for verified work. It moves the job
through
RECEIVED → NODE_VERIFYING → VERIFIED → CRANKER_LEASED → SUBMITTED → CONFIRMED under short leases and strict state versions.4
Cranker submits atomically on Solana
The Cranker pays fees and submits
tsn_fund_epoch_treasury and
tsn_accept_intent in one transaction. The on-chain program re-checks
stored state, signed fields, sequence, and nullifiers before it commits.5
Epoch Treasury settles; TCAP records the delta
The Epoch Treasury moves funds and tracks liability. TCAP writes a
commitment and an owner-decryptable snapshot so the recipient can reconcile
a private balance without exposing amounts on-chain.
What a payment intent looks like
ConfidentialSettlement struct is what the Solana program re-verifies at submit time. Nothing between the two can change a field without invalidating both.
Core primitives
TIN and GPRU: identity and routing
TIN and GPRU: identity and routing
A Transfer Identity Number (TIN) is a 10-digit portable identity issued by the Transfer Identity Protocol (TIP). The encrypted master seed is sealed to the owner wallet via a
wallet-owner-signature-v1 envelope and authorizes derivation of GPRU scopes, a non-custodial authorization and routing scope derived from the TIN privacy-receiving root, settlement commitment, epoch, and authorization scope. See Identity and routing.Settlement DNA, nullifiers, and sequence
Settlement DNA, nullifiers, and sequence
Settlement DNA binds payout parameters to a one-time slot. Nullifiers,
AcceptedIntentV1 PDAs, sequence checks, and validity windows enforce
single-use consumption. See Replay protection.Epoch Treasury
Epoch Treasury
The Epoch Treasury holds epoch-level liquidity and tracks liability against
Mother. Funds and pending obligations are separated so operators cannot spend
against unaccepted intents. See Epoch
Treasury.
TCAP: confidential balance accounting
TCAP: confidential balance accounting
The Transfer Confidential Asset Protocol (TCAP) records balance transitions as commitments and encrypted snapshots pinned to a
TCapTinTipV1 PDA. The live path is credit-only through credit_tcap_tin_tip_v1; debits and exits are proof-gated. See TCAP.Built by TrustLink Labs
TSN is developed and maintained by TrustLink Labs, a research and engineering organization building open infrastructure for identity-aware, privacy-conscious blockchain payments. TSN is the network. TrustLink Pay is the reference application on top of it. Follow the work on GitHub and X.Where to go next
How It Works
See the simple payment experience and the protocol work behind it.
Architecture
See identity, authorization, verification, transport, settlement, and TCAP as
one system on Solana.
Getting started
Set up devnet, resolve a TIN, and submit your first authorized payment intent
through TSN.
Security invariants
The guarantees TSN enforces at every boundary, and what no operator can rewrite.