Identity & Privacy
SWSS Identity Verification Layer (IVL)
Pre-launch
Section
Identity & Privacy
Documentation category
Type
Guide
Technical reference
Summary
Overview of SWSS IVL v1.9.0, the on-chain identity and credential infrastructure required for DEED-1 settlement operations.
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

SWSS Identity Verification Layer (IVL v1.9.0)

Legal settlement of real-world assets requires more than a record of ownership. It requires a verified record of who owns what, under what authority, with what accountability. SWSS IVL v1.9.0 is the identity infrastructure that makes DEED-1 legally complete.

The SWSS Identity Verification Layer is a proprietary on-chain identity infrastructure integrated into the SwssChain protocol stack. It provides the credential framework through which individuals, institutions, and AI agents are verified, admitted to the settlement economy, and granted differentiated access rights to deed settlement records. No other public blockchain operates an identity infrastructure of this scope or regulatory depth.

Testnet Access: SWSS DevHub Required

Access to SwssChain testnet 122606 is limited to developers the SWSS Foundation has approved. Credentials, endpoints and testnet allocation are issued together on approval: see how access is granted. Testnet access is not publicly open.

Why On-Chain Identity Is Required

A deed settlement without identity verification is a record of a transaction. A deed settlement with IVL credentials is a record of a legally accountable transaction. The difference determines whether the settlement record can be recognised by a property registry, enforced by a court, or accepted by a regulated institution as proof of ownership.

SWSS IVL v1.9.0 solves four problems that no other public blockchain has addressed:

  • Accountability without surveillance: DEED-1 settlements are legally accountable without constructing a public record of individual identity
  • Regulatory compliance at settlement layer: KYC, KYB, and AML requirements are satisfied at the protocol level, not the application layer
  • Institutional admission: Only entities with valid IVL Institutional Credentials can operate DEED-1 settlement in regulated asset classes
  • Cross-product credential recognition: A credential issued once is recognised across all fourteen SWSS ecosystem products

The Foundation-Governed Provider Registry

All identity verification that feeds into SWSS IVL credentials is conducted through providers admitted to the SwssChain Foundation's IVL Provider Registry. Only providers that meet the Foundation's admission criteria (covering regulatory status, operational security, data handling standards, and jurisdictional coverage) are admitted.

Provider CategoryScope
KYC (Know Your Customer)Individual identity verification: passport, biometric, liveness checks
KYB (Know Your Business)Corporate entity verification: registration, directors, beneficial ownership
KYT (Know Your Transaction)Transaction pattern and source-of-funds verification
AML (Anti-Money Laundering)Ongoing monitoring and sanctions screening

If a provider is removed from the Registry, credentials already issued through that provider remain valid: only new issuances are blocked. The settlement economy is not disrupted by provider changes.

Four Credential Types

See IVL Credential Types for the complete breakdown of all four credential categories with issuance conditions, transfer restrictions, and access rights.

Three-Tier Deed Access Architecture

IVL credentials govern a three-tier access system that determines what any party can see when querying a DEED-1 settlement record. See Three-Tier Deed Access Architecture for the complete specification.

Cross-Product Credential Query

Any SWSS product can verify a wallet's credential status with a single RPC call to swss_credentialValid. The response is instant, a boolean with optional scope and jurisdiction data. No credential data is transmitted; only validity is confirmed.

{
  "jsonrpc": "2.0",
  "method": "swss_credentialValid",
  "params": ["0xwalletaddress...", "KYC"],
  "id": 1
}

See the Custom RPC Methods reference for the full IVL method set: swss_credentialValid, swss_getCredential, swss_getCredentialByDeedId.