Glossary
Deed Types Quick Reference
Pre-launch
Section
Glossary
Documentation category
Type
Guide
Technical reference
Summary
Quick reference card for all five Deed types in the SwssChain Deed Transaction Standard: type codes, status, and key fields.
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

Deed Types Quick Reference

The Deed Transaction Standard currently defines five Deed types. This page provides a compact reference for each type: its protocol type code, current network status, required fields, and the Finality Certificate structure it produces.

Overview Table

Deed Type Type Code Status Use Case
Home DeedHOME_DEEDLiveResidential property ownership transfer
Compute DeedCOMPUTE_DEEDLiveCompute resource provisioning contracts
AI Agent DeedAI_AGENT_DEEDLiveAutonomous AI agent deployment records
BizDeedBIZ_DEEDLiveHospitality assets, with holder paid for verified promotional work

Home Deed: Required Fields

Field Type Description
propertyIdstringUnique identifier for the property within the platform
parcelRefstringOfficial land registry parcel reference number
settlementValueuint256 (wei)Declared settlement value in SWSS Coin (wei denomination)
fromAddressaddressSwssChain address of the transferring party (seller)
toAddressaddressSwssChain address of the receiving party (buyer)
jurisdictionstring (ISO 3166-1)Two-letter country code of the property's jurisdiction
registrationRefstringLand authority registration reference (optional)
documentHashbytes32SHA-256 hash of supporting documentation package

Compute Deed: Fields (Planned)

Field Type Description
computeJobIdstringUnique identifier for the compute provisioning contract
resourceSpecbytesEncoded compute resource specification (CPU, RAM, storage, duration)
providerAddressaddressRegistered compute provider's SwssChain address
consumerAddressaddressConsumer's SwssChain address
settlementValueuint256 (wei)Agreed payment in SWSS Coin for the compute engagement

Finality Certificate Structure

All confirmed Deed types produce a Finality Certificate with the following common structure:

{
  "certificateId": "0xCertificateHash...",
  "deedId": "0xDeedHash...",
  "deedType": "HOME_DEED",
  "blockNumber": 4821953,
  "blockHash": "0xBlockHash...",
  "timestamp": 1747267200,
  "settlementHash": "0xSettlementDataHash...",
  "signatures": [
    {
      "validatorAddress": "0xValidatorAddress...",
      "signature": "0xSignature...",
      "signedAt": 1747267201
    }
  ],
  "signatureThreshold": 3,
  "signatureCount": 4
}

Important Terminology Notes

  • A Deed is not an NFT. Deeds are settlement records, not speculative digital assets.
  • A Finality Certificate is not a transaction receipt. A transaction receipt confirms EVM execution. A Finality Certificate confirms legal-grade settlement finality attested by the validator set.
  • SWSS Coin used in Deed settlements is not burned. The Transactional Settlement Levy retires a portion of the supply according to the Settlement Combustion Model formula.