The chain holds the authority
Authorization isn’t a flag in someone’s database. It’s on-chain state that you own:- Account — an address on Base that owns everything: a wallet you control (an EOA or Safe) in ChainSecured mode, or a Lit-managed credential in API mode. See API mode vs ChainSecured mode.
- API keys & scopes — each key is registered on-chain with explicit, per-group scopes (
execute,group:addPkp, and so on). - PKPs & Groups — a Group is the authorization policy: it binds the keys (PKPs) to the immutable Lit Actions (IPFS CIDs) allowed to use them.
An attested TEE enforces it — by reading
On-chain rules are only as strong as what enforces them. In Lit, that’s a sealed TEE that reads the contracts on every request:- A request arrives: an API key, and “run action
QmABCwithpkp_001.” - The TEE reads on-chain — does this key have
executescope on a group where bothQmABCandpkp_001are listed? - If yes, it derives the key inside the enclave, runs the action, and signs. If no, it refuses.
Why it scales: write the rules, read to enforce
The split between authority and enforcement is the point:- Setting or changing a rule is a write — one on-chain transaction, only when you configure or govern.
- Using a rule is a read — the TEE reads current on-chain state and signs in the enclave. No per-operation transaction, no gas, no waiting on a block.
What Chain Secured locks down
Because authority lives on-chain and the TEE only ever enforces it:- A leaked execute-only key can invoke the actions it is already permitted to, and nothing else. It cannot add itself to new groups, swap in new code, or move funds outside policy.
- Changing what the rules are requires an owner transaction on Base. Put the owner behind a Safe, and an evil admin holding an execute key can invoke existing actions but cannot change the rules.
- The rules are visible to anyone, at any time. Don’t trust — verify.
Further reading
- Authentication Model — entities, scopes, and the full permission matrix
- System Diagram — on-chain vs TEE boundaries and management paths
- On-Chain KMS — how Base contracts gate root-key release
- Security & Verification — attestation and the full chain of trust