Products
SWSS REALM
Pre-launch
Section
Products
Documentation category
Type
Guide
Technical reference
Summary
SWSS REALM, the SwssChain virtual environment platform for immersive digital experiences with on-chain asset ownership and Deed-backed virtual property.
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 REALM

SWSS REALM is the SwssChain virtual environment platform, a structured digital world in which participants own, develop, and interact with virtual spaces whose ownership is recorded on SwssChain via the Deed Transaction Standard. All REALM assets are backed by on-chain Deed records, ensuring provable ownership and transferability independent of the SWSS REALM application layer.

Core Concepts

  • REALM Parcel: A defined spatial unit within the SWSS REALM environment. Each parcel is registered as a Deed on SwssChain using a REALM-specific Deed type (roadmap). Parcels are addressable by REALM coordinate reference.
  • REALM District: A collection of adjacent parcels governed by shared environmental rules. Districts may be public (open to all REALM participants) or private (accessible only to parcel holders within the district).
  • REALM Experience: A designed environment layered on top of one or more parcels: exhibitions, meeting spaces, product showcases, or interactive environments created by parcel owners.
  • REALM Identity: Each participant's REALM presence is linked to their SwssChain wallet address. REALM Identity data is stored off-chain with only the wallet address anchor recorded on-chain.

On-Chain Ownership

REALM parcel ownership is recorded using the Deed Transaction Standard on SwssChain. Ownership transfer between participants proceeds through the standard Deed settlement workflow: parcel transfers produce Finality Certificates that serve as the authoritative ownership record. This design ensures that REALM parcel ownership is not contingent on the availability or continued operation of any REALM application server.

SWSS Coin Integration

SWSS Coin is the sole currency of exchange within SWSS REALM for parcel acquisition, experience access fees, and development services. REALM transactions are standard SwssChain transactions and are therefore subject to the Transactional Settlement Levy per the Settlement Combustion Model.

Development Tooling

SWSS REALM provides a JavaScript SDK for building interactive experiences within the REALM environment:

import { RealmClient } from '@swsschain/realm-sdk';

const realm = new RealmClient({
  apiKey: process.env.REALM_API_KEY,
  walletAddress: '0xYourAddress',
});

// Load a parcel
const parcel = await realm.getParcel('REALM-00042-A');

// Verify on-chain ownership
const owner = await realm.getParcelOwner('REALM-00042-A');
console.log('Owner:', owner);  // SwssChain wallet address

// Deploy an experience to a parcel
await realm.deployExperience({
  parcelId: 'REALM-00042-A',
  experienceBundle: './my-experience.zip',
  accessPolicy: 'public',
});

Status

SWSS REALM is currently in early access. The parcel Deed type on SwssChain is scheduled for network activation on the roadmap. During the early access period, a limited number of parcels are available in a pre-production environment for developer testing and experience design. Parcel reservations during early access do not constitute binding on-chain ownership until the REALM Deed type is activated.

Accessing SWSS REALM

SWSS REALM runs in WebGL-capable desktop browsers and will have its own web address on release. A dedicated REALM companion application for mobile is planned for a later release phase.