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.
Access to SwssChain testnet 122606 is limited to developers the SWSS Foundation has approved. Credentials, endpoints and testnet allocation are issued together on approval: see how access is granted. Testnet access is not publicly open.
Testnet Explorer
The SwssChain testnet block explorer at testnet.swssscan.swss.io provides full visibility into all testnet activity. Its interface and data model are identical to the mainnet explorer: using the testnet explorer during development ensures that your interpretation of explorer data transfers directly to mainnet without surprises.
Accessing the Testnet Explorer
The explorer serves a read-only record of testnet activity (blocks, transactions, Deed records, Finality Certificates) and is open to browse. Reading the record is not network access: submitting to SwssChain testnet 122606 requires credentials issued by SWSS DevHub. Data persists until the next testnet reset.
Key Explorer Functions
Transaction Lookup
Paste a transaction hash into the search bar to view full transaction details: sender, recipient, value, gas used, input data, event logs, and execution trace where available. For Deed settlement transactions, the explorer renders a structured Deed summary panel alongside the raw transaction data.
Address Inspection
Enter any testnet address to view its SWSS Coin balance, complete transaction history, deployed contracts, and participation in Deed settlements. The address page also shows the current staking status and delegated stake amount if applicable.
Contract Verification
Verified contracts display their source code, ABI, and an interactive read/write interface directly in the explorer. To verify a contract:
- Navigate to the contract address page on the testnet explorer.
- Click "Verify and Publish" in the contract tab.
- Provide the Solidity source code, compiler version, and optimisation settings matching the deployed bytecode.
- The explorer compiles the submitted source and confirms whether the resulting bytecode matches the on-chain deployment.
Alternatively, use the Hardhat Verify plugin:
npx hardhat verify --network swssTestnet 0xContractAddress "constructor_arg_1" "constructor_arg_2"
// hardhat.config.ts — add etherscan config block for testnet explorer
const config: HardhatUserConfig = {
// ... network config ...
etherscan: {
apiKey: {
swssTestnet: 'any-string', // testnet explorer does not require API key
},
customChains: [
{
network: 'swssTestnet',
chainId: 122606,
urls: {
apiURL: 'https://testnet.swssscan.swss.io/api',
browserURL: 'https://testnet.swssscan.swss.io',
},
},
],
},
};
Deed Settlement Tracking
Navigate to the Deeds section of the testnet explorer to browse all submitted Deed settlement transactions. Filter by Deed type, parcel reference, or address. Each Deed record links to the associated Finality Certificate once issued.
SCM Telemetry
The testnet explorer exposes the same Settlement Combustion Model telemetry panel as mainnet. View the current Transactional Settlement Levy rate, total supply retired to date on testnet, and the ERRP distribution history. Note that testnet SCM figures are for testing purposes only and carry no economic significance.
Explorer API on Testnet
# Testnet explorer API base URL
BASE=https://testnet.swssscan.swss.io/api/v1
# Get latest testnet blocks
curl $BASE/blocks?limit=5
# Get testnet Deed settlements
curl $BASE/deeds?status=confirmed&limit=10
# Get testnet chain status
curl $BASE/status
Differences from Mainnet Explorer
The testnet explorer is functionally identical to the mainnet explorer. The primary differences are cosmetic, the testnet explorer displays a visible "TESTNET" banner on all pages and uses a distinct colour scheme to prevent confusion with the mainnet explorer. All data displayed is testnet-only and is cleared on network reset.
