Testnet
Testnet Faucet
Pre-launch
Section
Testnet
Documentation category
Type
Guide
Technical reference
Summary
How to obtain testnet SWSS Coin from the SwssChain testnet faucet for development and integration testing.
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
Testnet Access: SWSS DevHub Required

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 Faucet

The SwssChain testnet faucet dispenses testnet SWSS Coin to developer accounts at no cost. Testnet SWSS Coin has no monetary value and exists solely to enable testing of transactions, contract deployments, Deed settlement workflows, and staking mechanics without requiring real assets.

Faucet Access

Testnet allocation is issued through SWSS DevHub, where the faucet and its current limits are, against the developer account the SWSS Foundation approved. There is no anonymous faucet and no public faucet endpoint: the allocation is dispatched to the testnet address registered on your DevHub account, and the request is made from the DevHub dashboard.

Faucet Limits

Parameter Value
Amount per request100 testnet SWSS Coin
Rate limit (per address)1 request per 24 hours
Rate limit (per IP)5 requests per 24 hours
Confirmation time~2 seconds

Faucet API

The faucet exposes a simple REST API for automated testnet SWSS Coin requests, useful for CI/CD pipelines and automated test suites.

curl -X POST "$SWSSCHAIN_FAUCET_URL/api/request"   -H "Authorization: Bearer $SWSSCHAIN_DEVHUB_KEY"   -H "Content-Type: application/json"   -d '{"address": "0xYourRegisteredTestnetAddress"}'
{
  "success": true,
  "txHash": "0xFaucetTxHash...",
  "amount": "100000000000000000000",
  "address": "0xYourTestnetAddress",
  "nextAllowedAt": "2026-05-16T12:00:00Z"
}

Requesting Large Allocations

For testing scenarios that require amounts significantly larger than the standard faucet dispenses (for example, testing Deed settlements with high declared values or staking pool stress tests) developers can request a large allocation by contacting the SwssChain developer relations team via SWSS DevHub. Include a brief description of the testing purpose and the address requiring the allocation.

Using the Faucet in CI/CD

#!/bin/bash
# ci-fund-account.sh — fund testnet account before running tests

TESTNET_ADDRESS=$(cast wallet address --private-key $TESTNET_PRIVATE_KEY)

echo "Requesting testnet SWSS Coin for $TESTNET_ADDRESS..."

RESPONSE=$(curl -s -X POST "$SWSSCHAIN_FAUCET_URL/api/request"   -H "Authorization: Bearer $SWSSCHAIN_DEVHUB_KEY"   -H "Content-Type: application/json"   -d "{"address": "$TESTNET_ADDRESS"}")

TX_HASH=$(echo $RESPONSE | jq -r '.txHash')

if [ "$TX_HASH" = "null" ] || [ -z "$TX_HASH" ]; then
  echo "Faucet request failed or rate-limited: $RESPONSE"
  # If rate-limited, account may already have a balance — check before failing
  BALANCE=$(cast balance $TESTNET_ADDRESS --rpc-url "$SWSSCHAIN_TESTNET_RPC_URL")
  if [ "$BALANCE" -gt 0 ]; then
    echo "Account already funded with balance $BALANCE — proceeding."
    exit 0
  fi
  exit 1
fi

echo "Faucet tx: $TX_HASH"
echo "Waiting for confirmation..."
cast receipt $TX_HASH --rpc-url "$SWSSCHAIN_TESTNET_RPC_URL" > /dev/null
echo "Account funded."

After Reset

When the testnet is reset, all account balances return to zero. Re-request testnet SWSS Coin from the faucet after each reset before running tests. The faucet rate limit resets with each testnet reset.

Frequently Asked Questions
6 questions
Is there a public faucet URL?

No. Testnet allocation is requested from the SWSS DevHub dashboard against your approved developer account, and dispatched to the testnet address registered on it.

How much is dispatched, and how often?

A fixed amount per request, rate limited to one request per address per 24 hours. The current amount is shown in the dashboard.

I need more than the standard allocation for load testing.

Request a large allocation through SWSS DevHub, describing the testing purpose and the address that needs it.

Does testnet SWSS Coin have any value?

None. It exists to exercise transactions, contract deployments, deed settlement workflows and staking mechanics without real assets, and it is cleared at every reset.

Can I automate allocation in CI?

Yes, against your issued faucet URL and DevHub key. Treat that key as a credential: it belongs in your CI secret store, never in the pipeline definition.

My balance is zero after a reset.

Expected. Every balance returns to zero at reset and the rate limit resets with it: request again before your tests run.