Who does what
The verifier
Your KYC source. Seals the file to your key, signs it with its own key, delivers it, and can revoke it later
Trusset
Stores the sealed envelope and relays it. Holds no key that opens it and decrypts nothing
You
Open the envelope with a tool on your own machine, file the record, approve or reject it, and sign every whitelist change
What Trusset holds
For each record Trusset stores two things: the ciphertext, and a clear header.
The header has a fixed set of fields and no free text. Opening happens only in software you run. The Issuer Platform lists records and takes your decisions, and it never downloads or opens an envelope.
Trusset also cannot alter a record or pass one off as coming from your verifier. The verifier signs each record twice, once inside the ciphertext and once over the header and the ciphertext, and your tool checks both against a signing key you pinned yourself.
When the ciphertext is deleted
Trusset deletes the ciphertext of a record as soon as one of these happens:- your tool proves it opened the record
- you reject the record
- the verifier revokes it
- its validity date passes
- it stays uncollected for 30 days
From record to whitelist
1
Create your record key
The local tool,
trusset-kyc, creates a key pair on your machine. You register the public half for your instance. The private half never leaves your keystore.2
Designate a source
You add the verifier as a KYC source with its signing key, the investor profile it verifies for, and the whitelists its records admit to. Trusset returns an invite, which you hand to the verifier. Over a channel that does not run through Trusset, you read the verifier the fingerprint of your record key from your own tool, and the verifier reads you the fingerprint of its signing key. The verifier’s tool stores the invite only when your fingerprint matches the key in it.
3
The verifier delivers
The verifier seals the file of one wallet and posts it to your inbox. Trusset checks the header and the signature and stores the envelope.
4
You open it locally
Your tool downloads the envelope with your API key, verifies both signatures against the key you pinned, decrypts, and files the record on your disk. It then proves the opening to Trusset, and Trusset deletes the ciphertext.
5
You decide
You review the file and approve or reject the record, in the Issuer Platform or through the API.
6
Your wallet signs
Approving returns one unsigned transaction for each whitelist bound to the source. The owner or a manager of the whitelist signs it. Trusset holds no key and sends nothing.
Whitelists bound to a source
A whitelist gates a lending market or a vault, and by itself records nothing about why a wallet is on it. Binding it to a KYC source changes that. Trusset then builds a listing for a wallet only when the wallet has a record from a bound source that you opened and approved and that is still valid. That holds for the approval flow and for the ordinary whitelist member endpoint alike, which refuses other wallets withKYC_RECORD_REQUIRED.
The requirement applies to every listing built through Trusset, in the Issuer Platform and through the API. The whitelist contract itself is unchanged: its owner and managers can still call it directly with their own tools.
Lifecycle
A revocation or an expiry removes nothing on chain. The wallet stays listed until your wallet signs the removal. Trusset marks the record as waiting for a removal and builds the transaction, unless another approved, valid record still covers the wallet on that whitelist.
Each change is reported to your customer webhooks: a record received, opened, rejected, approved, revoked or expired.
Limits
- 25 KYC sources per instance
- 10 whitelists per source
- 6 MiB per sealed record, attachments included
Availability
Sealed KYC records are switched on for development instances. For production instances Trusset enables them for each organisation. Until then, registering a record key, adding a source or issuing an invite on a production instance is refused withSEALED_KYC_NOT_ENABLED.
What stays between you and your verifier
Trusset relays a sealed file. It does not verify an investor, does not assess a KYC file and takes no part in your decision to accept one. Whether you may rely on your verifier’s KYC, and how personal data passes between you, is governed by the reliance and data processing agreements between you and the verifier.KYC courier tool
The local tool for the bank and the verifier, with its trust model
Records and sources API
Register the key, manage sources, and approve, admit and remove through the API
KYC Inbox
The verifier’s API and the envelope format
Whitelists
The lists a source admits to
