Identity & Privacy
IVL Credential Types
Pre-launch
Section
Identity & Privacy
Documentation category
Type
Guide
Technical reference
Summary
The four SWSS IVL credential types (Individual KYC, Institutional KYB, Accountability Notice, and AI Agent Credential) with issuance conditions and access rights.
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

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.

CredentialIssued ToIssued ByTransferStatus
Individual Identity (KYC)Verified individualsIVL Registry-admitted providerNon-transferableLive
Institutional Identity (KYB)Banks, funds, law firms, wealth managersSwssChain FoundationNon-transferableLive
Accountability NoticeAll credentialed participantsSwssChain protocolNon-transferableLive
AI Agent CredentialRegistered AI agentsOwning wallet via Type 0x71 SCP transactionOwnership-transfer onlyQ4 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.

PropertyValue
Issued toVerified individuals: any person who completes the IVL KYC process
Issued byIVL Registry-admitted KYC provider
RecordsJurisdiction of verification, verification scope, expiry parameter
One per walletYes: one credential per individual wallet address
ExpiryFoundation-configured per-credential: renewal required on expiry
Grants access toDEED-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.

PropertyValue
Issued toVerified legal entities operating in regulated financial or legal sectors
Issued bySwssChain Foundation: institutional admission is a Foundation board decision
RecordsEntity accountability classification, authorised deed prefix categories, KYB verification status
Grants access toSWSS NodeX validator admission, INSTITUTIONAL deed record tier, custodial deed-holding on behalf of clients, full deed prefix category operations
Standing accessRegistered 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.

PropertyValue
Issued toRegistered AI agents via SWSS AI OwlX v1 platform
Issued byOwning wallet: Type 0x71 SCP Transaction
RecordsAgent capability scope, owning wallet, deployment timestamp, invocation policy
TransferableYes: transfers with AI Agent Deed ownership
StatusQ4 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.