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.
IVL Credential Types
SWSS IVL v1.9.0 defines four credential types. Each is soul-bound: permanently associated with the wallet address at issuance and non-transferable. Each governs a specific category of participant in the SwssChain settlement economy.
| Credential | Issued To | Issued By | Transfer | Status |
|---|---|---|---|---|
| Individual Identity (KYC) | Verified individuals | IVL Registry-admitted provider | Non-transferable | Live |
| Institutional Identity (KYB) | Banks, funds, law firms, wealth managers | SwssChain Foundation | Non-transferable | Live |
| Accountability Notice | All credentialed participants | SwssChain protocol | Non-transferable | Live |
| AI Agent Credential | Registered AI agents | Owning wallet via Type 0x71 SCP transaction | Ownership-transfer only | Q4 2026 |
Individual Identity Credential (KYC)
A soul-bound identity credential issued to a verified individual on SwssChain. Soul-bound means the credential is permanently associated with the wallet address at issuance: it cannot be transferred, delegated, or sold. One credential per individual.
| Property | Value |
|---|---|
| Issued to | Verified individuals: any person who completes the IVL KYC process |
| Issued by | IVL Registry-admitted KYC provider |
| Records | Jurisdiction of verification, verification scope, expiry parameter |
| One per wallet | Yes: one credential per individual wallet address |
| Expiry | Foundation-configured per-credential: renewal required on expiry |
| Grants access to | DEED-1 settlement operations requiring identity verification, VERIFIED deed record tier, high-net-worth property acquisition in regulated jurisdictions |
Institutional Identity Credential (KYB)
A soul-bound institutional credential issued to verified legal entities: banks, funds, law firms, wealth managers, and other regulated institutions.
| Property | Value |
|---|---|
| Issued to | Verified legal entities operating in regulated financial or legal sectors |
| Issued by | SwssChain Foundation: institutional admission is a Foundation board decision |
| Records | Entity accountability classification, authorised deed prefix categories, KYB verification status |
| Grants access to | SWSS NodeX validator admission, INSTITUTIONAL deed record tier, custodial deed-holding on behalf of clients, full deed prefix category operations |
| Standing access | Registered institutions receive standing access grants to all deed records within their authorised categories: no per-deed permission required |
Accountability Notice
An immutable on-chain legal notice that establishes the accountability framework for all credentialed participants on SwssChain. The Accountability Notice is issued at the protocol level: it does not require an action by the participant. It is permanently associated with every IVL credential and forms part of the cryptographic commitment of every deed settlement that the credentialed wallet participates in.
The notice records the jurisdiction-specific accountability obligations applicable to the participant's credential scope. No party, including SwssChain, can retract or modify an Accountability Notice once issued.
AI Agent Credential (Q4 2026)
An on-chain identity credential for registered AI agents, issued through a Type 0x71 SCP Transaction submitted by the owning wallet. Unlike the three soul-bound human credential types, the AI Agent Credential is transferable as part of an AI Agent Deed ownership transfer, the credential moves with the agent.
| Property | Value |
|---|---|
| Issued to | Registered AI agents via SWSS AI OwlX v1 platform |
| Issued by | Owning wallet: Type 0x71 SCP Transaction |
| Records | Agent capability scope, owning wallet, deployment timestamp, invocation policy |
| Transferable | Yes: transfers with AI Agent Deed ownership |
| Status | Q4 2026: pending SWSS AI OwlX v1 product launch |
Credential Verification
Any application can verify a wallet's credential status in real time using the swss_credentialValid RPC method. The call is synchronous and returns immediately. No credential data is transmitted: only a validity flag, scope confirmation, and expiry timestamp.
For full credential data (subject to the wallet holder's consent and the querying party's access tier), use swss_getCredential or swss_getCredentialByDeedId. See the Custom RPC Methods reference.
