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.
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 Type | Integration Path |
|---|---|
| Building on top of SWSS RWAX | Use SWSS RWAX SDK: available at DevHub |
| Building a compute marketplace | Use SWSS InfraX SDK: available Q2 2027 |
| Building an AI agent platform | Use SWSS AI SDK: available Q4 2026 |
| Verifying deed settlements | Use Finality Certificate API directly |
| Reacting to deed events on-chain | Subscribe to deed settlement events via RPC |
| Standard smart contract developer | No 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
- Follow Finality Certificate Programmatic Verification for the complete verification guide in JavaScript and Python.
- Consult the API Reference for full endpoint documentation including authentication and response schemas.
- Visit Products to register at SWSS DevHub and access product-specific SDKs.
