Prerequisites
Before deploying the Signing Module, confirm that you have everything listed here.
Before you begin
For sandbox integration, you must have:
- Received a secure email confirming your RTGS.global ID. If you have not received this, contact support@rtgs.com.
- Provided your organisation's decentralised identifier (DID) and verification key (Verkey) to RTGS.global's onboarding team (see Generating your wallet seed, DID and Verkey below).
Generating your wallet seed, DID and Verkey
Each connection you establish on the RTGS.global network is backed by an encrypted key pair stored in a wallet database alongside your Signing Module. The master key that unlocks your wallet is known as the seed — a random string of 32 alphanumeric characters.
We recommend generating a Globally Unique Identifier (GUID) without hyphens as the seed value. This provides maximum entropy within the allowed characters and length.
You are responsible for creating this seed value and keeping it secure, preferably in a managed secrets service such as Azure Key Vault. Like a password, you must not share this seed with anyone — RTGS.global cannot recover the value if lost.
Once you have a seed value, run the following Docker command to derive your DID and Verkey:
docker run --rm -it ghcr.io/indicio-tech/did-derive:latest from-seed '<seed>'
The output will look like:
DID/NYM: 2VemhUTQaWQixPhvvtDJgK
Verkey: pEDX3iAwJSzi6aqSoiohcEKC9kCAKkdJankwu4HwkBh
Short Verkey: ~53ZTaTG28YR5sHmY6Jdtgw
During onboarding, you will be asked to provide the DID/NYM and Verkey values. The Short Verkey is not required.
Your wallet seed cannot be recovered if lost. Store it in a secrets manager before proceeding with deployment.
Never re-provision your wallet without the original seed. If the wallet is re-provisioned without a seed — or with a different seed — ACA-Py generates a new DID that is not registered on the Indicio ledger, causing the Signing Module to fail on startup with a seed/DID mismatch error. If you need to restore or re-provision your wallet, always supply the same seed used during initial deployment.