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.
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.
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 Category | Scope |
|---|---|
| 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.
