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.
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.
Three-Tier Deed Access Architecture
Every DEED-1 settlement record on SwssChain enforces a three-tier access model governed by SWSS IVL v1.9.0 credentials. What any party can see when querying a deed is determined entirely by the IVL credentials attached to their wallet address, not by application-layer permissions, not by owner whitelists, and not by any centralised access control system.
This architecture is the only mechanism on any public blockchain that provides authenticated, credential-gated privacy at the settlement layer with no trusted intermediary.
Access Tier Summary
| Tier | Who Has Access | What Is Visible | Credential Required |
|---|---|---|---|
| Tier 1: Public | Any wallet address, any party worldwide | Transaction hash, block number, deed type, timestamp, certificate hash, TSL retirement amount | None: open public access |
| Tier 2: Verified | Wallet addresses holding a valid IVL Individual KYC credential | All Tier 1 data plus: jurisdiction, asset reference, legal owner (anonymous: wallet address only), deed status | SWSS IVL Individual Identity Credential (KYC) |
| Tier 3: Institutional | Registered institutions holding a valid IVL Institutional KYB credential | All Tier 2 data plus: full metadata schema, private annotations, legal owner identity (revealed under institutional accountability), counterparty data | SWSS IVL Institutional Identity Credential (KYB) |
Tier 1: Public Access
Publicly visible data is available to any party without any credential, authentication, or registration. This is the cryptographic proof layer: sufficient for any party to confirm that a settlement occurred, when it occurred, and that it was attested by the full active validator set.
Public access is available at swssscan.swss.io and via swss_getFinalityCert directly from any SwssChain RPC node.
Tier 2: Verified Access
Verified access is granted to wallet addresses holding a valid SWSS IVL Individual Identity Credential (KYC). This is the tier for retail participants, professional individuals, and regulated professionals who require more than the public record for legitimate business purposes.
Verified access includes the jurisdiction and asset reference of the settled deed, the data that confirms a settlement record maps to a specific real-world asset in a specific legal jurisdiction. This tier is sufficient for most professional use cases that do not involve institutional settlement authority.
Verified access is checked via swss_checkDeedAccess:
{
"jsonrpc": "2.0",
"method": "swss_checkDeedAccess",
"params": ["0xwalletaddress...", "SWSS-ESTATE-00001"],
"id": 1
}
Tier 3: Institutional Access
Institutional access is granted to wallet addresses holding a valid SWSS IVL Institutional Identity Credential (KYB). Registered institutions receive standing access grants to all deed records within their authorised categories: they do not need to request per-deed access.
Institutional access includes the complete deed record, private annotations, legal owner identity (revealed under the institutional accountability framework), and full counterparty data. This is the tier required for:
- Property registry integration and legal title verification
- Institutional custody operations and client portfolio management
- Regulatory reporting and audit workflows
- Cross-border settlement clearance and legal instrument validation
Private Annotations
Institutional participants can embed private annotations directly within a DEED-1 settlement record at the time of settlement. These annotations are included in the cryptographic commitment of the deed and are permanently associated with the Finality Certificate. They are visible only to parties at Tier 3 access level.
Annotations are used for internal settlement references, legal instrument identifiers, compliance notations, and asset management directives. No external party, including SwssChain, can read or alter a private annotation without Tier 3 credentials.
Standing Access Grants
Institutional credential holders can create standing access grants that give specified wallet addresses (or credential classes) standing access to their deed records: without issuing per-deed permissions. Standing grants are managed via swss_getDeedGrants and are publicly enumerable by the deed owner.
Standing grants are permanently recorded on-chain. Any grant created, modified, or revoked is part of the immutable chain record and can be audited by regulators, counterparties, and the owner at any time.
For integration patterns involving IVL credential verification, see the Custom RPC Methods reference: specifically
swss_credentialValid,swss_checkDeedAccess, andswss_getDeedGrants.
