Developer Reference
Deed Transaction Developer Integration
Pre-launch
Section
Developer Reference
Documentation category
Type
Guide
Technical reference
Summary
How third-party developers integrate with deed settlements: event subscriptions, Finality Certificate polling, on-chain deed registry reads, and SDK access paths.
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

Deed Transaction Developer Integration

Deed transactions are a first-class transaction type on SwssChain: they are not standard smart contract calls and cannot be constructed manually by third-party developers. Deed transactions are created and submitted by the official SWSS product platforms (SWSS RWAX, SWSS InfraX, SWSS AI) through the SwssChain Deed SDK, available to registered partners via SWSS DevHub. Third-party developers integrate by reading deed settlement data and Finality Certificates, listening to deed events, and reacting to settlement confirmation in their application logic.

Who Needs Deed Integration

Developer TypeIntegration Path
Building on top of SWSS RWAXUse SWSS RWAX SDK: available at DevHub
Building a compute marketplaceUse SWSS InfraX SDK: available Q2 2027
Building an AI agent platformUse SWSS AI SDK: available Q4 2026
Verifying deed settlementsUse Finality Certificate API directly
Reacting to deed events on-chainSubscribe to deed settlement events via RPC
Standard smart contract developerNo deed integration required: build normally

Listening to Deed Settlement Events

Deed settlements emit on-chain events that any developer can subscribe to using standard ethers.js event filtering. The following example listens for all deed settlement events across all deed types:

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider(
  process.env.SWSSCHAIN_RPC_URL
);

const deedFilter = {
  topics: [
    ethers.id('DeedSettled(bytes32,string,address,uint256)')
  ]
};

provider.on(deedFilter, (log) => {
  const decoded = ethers.AbiCoder.defaultAbiCoder().decode(
    ['bytes32', 'string', 'address', 'uint256'],
    log.data
  );
  // decoded[1] = deed type string, decoded[2] = settler address
  onDeedSettled({ txHash: log.transactionHash, deedType: decoded[1], settler: decoded[2] });
});

Reacting to Finality Certificate Issuance

For flows where your application must confirm legal settlement finality before proceeding (for example, releasing funds or provisioning access) poll the Finality Certificate API after receiving a deed transaction hash:

async function waitForFinalityCertificate(txHash, maxAttempts = 10) {
  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch(
      `https://swssscan.swss.io/api/certificates/${txHash}`
    );
    if (response.ok) {
      const cert = await response.json();
      if (cert.verified) return cert;
    }
    // SwssChain produces blocks every 1 second
    await new Promise(resolve => setTimeout(resolve, 1000));
  }
  throw new Error('Finality Certificate not confirmed within timeout');
}

Reading Deed Data from a Solidity Contract

SwssChain exposes deed settlement data through an on-chain registry interface. Use the following interface definition to read settlement data from your contract:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IDeedRegistry {
    function getDeedSettlement(
        bytes32 txHash
    ) external view returns (
        string memory deedType,
        address settler,
        uint256 blockNumber,
        bool certified
    );
}

contract MyContract {
    IDeedRegistry constant DEED_REGISTRY =
        IDeedRegistry(0xDeedRegistryAddressHere);

    function checkSettlement(bytes32 txHash)
        external view returns (bool)
    {
        (, , , bool certified) = DEED_REGISTRY.getDeedSettlement(txHash);
        return certified;
    }
}

The current deed registry contract address is published at DevHub and in the API Reference. Always read the address from your environment configuration rather than hardcoding it, as the registry may be upgraded through governance.

Next Steps