Compliance & Data
Settlement Data and Privacy
Pre-launch
Section
Compliance & Data
Documentation category
Type
Guide
Technical reference
Summary
What a DEED-1 settlement publishes, what it does not, how the three-tier access model works, and what that means for an integrator handling personal data.
SWSS Foundation Notice

This documentation is restricted to authorised members of the SWSS Developer Community. Access is granted exclusively through SWSS DevHub, after KYB and SWSS Foundation approval.

All SwssChain GitHub repositories are private. Significant updates are currently deploying across the full SWSS Ecosystem. SDK and API specifications are subject to change at any time in accordance with security requirements and SwssChain Foundation governance decisions.

Join SWSS DevHub →Have a question? Use the Need Help? button below.
SDK Update Notice

SWSS SDK v2.1 is deploying across the ecosystem. API signatures may change during this period. Ensure your integration uses the latest schema from SWSS DevHub.

Article Content

A settlement network has to publish enough for a settlement to be relied on, and no more than that. This page states which is which, so an integration is designed against what the chain actually exposes rather than an assumption about it.

What a Settlement Publishes

On chain, public and permanentNot on chain
Transaction hash, block, settlement timeIdentity documents
Deed identifier, class and asset referenceThe verification evidence behind a credential
Jurisdiction codeNames and contact details of natural persons
Holder address and DEED-1 token idCommercially sensitive terms, where SCP-ZK is used
The Finality Certificate and its attesting signaturesAnything held by an identity provider rather than issued as a credential
Credential validity: that an address is verifiedThe credential's underlying personal data

The distinction that matters: the chain records that a party is verified, and to what scope. It does not record who they are. A credential query returns validity, optionally with scope and jurisdiction: no credential data is transmitted.

Three-Tier Access

What any party can see when querying a DEED-1 record depends on the credentials they hold. The tiers are specified in Three-Tier Deed Access Architecture; the property to design against is that access is evaluated at query time against the caller's credential, not baked into the record when it settled.

Confidentiality Without Losing Compliance

SCP-ZK exists for the case where a settlement must be provable but its terms must not be public. A zero-knowledge settlement proves the transaction met its conditions without publishing the conditions, and selective disclosure lets a party demonstrate compliance to a specific counterparty or regulator without publishing to everyone. See SCP-ZK.

What This Means for Your Integration

  • Do not put personal data in a settlement field. Memo and asset reference fields are public and permanent. A name, an address or an identifier that resolves to a person does not belong in one, and cannot be removed afterwards.
  • Reference, do not embed. Carry a reference the authorised party can resolve, and keep the data in your own system where your obligations to it apply.
  • Erasure requests reach your systems, not the chain. A settlement record is immutable by design. Plan for that in your data map before you settle, not after a request arrives.
  • Credential validity is not identity. Confirming an address is verified is not the same as knowing who holds it, and your own obligations may require more than the protocol gives you.
Not legal advice

This page describes what the protocol publishes. Your obligations under the data protection and financial regulation regimes you operate in are yours to determine with your own advisers. The whitepaper's Legal & Regulatory Framework sets out the framework SWSS itself operates under.

Next Steps

Frequently Asked Questions
6 questions
Is personal data stored on chain?

No. The chain records that a party is verified and to what scope. It does not record who they are, a credential query returns validity, optionally with scope and jurisdiction, and transmits no credential data.

Can I put a customer reference in the memo field?

Only if it is safe to publish permanently. Memo and asset reference are public and immutable. Carry a reference the authorised party can resolve and keep the data in your own systems.

How do I handle an erasure request?

In your systems. A settlement record cannot be deleted by anyone. Map that constraint before you settle, not when a request arrives.

Does a verified credential tell me who someone is?

No. It tells you an address is verified and to what scope. Your own obligations may require more than the protocol gives you.

How do I keep commercial terms private but provable?

SCP-ZK proves a settlement met its conditions without publishing them, and selective disclosure lets a party demonstrate compliance to a specific counterparty or regulator. See SCP-ZK.

Who decides what I can see on a deed?

Your credential, evaluated at query time rather than baked into the record when it settled. See Three-Tier Deed Access.