Address Operations | Centrifuge

No network call: Both operations on this page run entirely locally — pure Base58 decoding and a Blake2b-512 checksum, no Substrate RPC involved. They work regardless of chain status, including against the halted centrifuge mainnet.

validateAddress

Checks that a string decodes as a well-formed SS58 address with a valid checksum, and resolves which known network its prefix belongs to.

Field	Type	Required	Description
`address`	text	✓ Yes	The string to validate.

// Request
{ "address": "4d3..." }

// Response
{ "address": "4d3...", "isValid": true, "prefix": 36, "network": "centrifuge", "status": "success" }

An invalid address is still a successful check. status: "success" means the validation ran, not that the address is valid — check the isValid field. A malformed or checksum-failing address returns isValid: false with prefix and network empty, still under "success".

If the address decodes but its prefix doesn't match any network this node knows (other than the special-cased polkadot prefix 0), network comes back empty even though isValid is true — the address is well-formed, just for a chain this integration doesn't otherwise track.

convertAddress

Re-encodes the same underlying 32-byte public key under a different SS58 network prefix. This does not create a different account — an SS58 address is prefix || publicKey || checksum, so the same key produces a different string per network by design.

Field	Type	Required	Description
`address`	text	✓ Yes	SS58 address to re-encode.
`targetNetwork`	select	✓ Yes	`centrifuge` \| `altair` \| `development` \| `polkadot` \| `substrate`. See Networks.

// Request
{ "address": "4d3...", "targetNetwork": "polkadot" }

// Response
{
  "originalAddress": "4d3...",
  "convertedAddress": "15o...",
  "targetNetwork": "polkadot",
  "targetPrefix": 0,
  "publicKeyHex": "0xabc123...",
  "status": "success"
}

Response Field	Meaning
`convertedAddress`	The same account, re-encoded under `targetPrefix`.
`publicKeyHex`	The raw 32-byte public key as 0x-prefixed hex — identical no matter which network's prefix wraps it. Useful for confirming two differently-prefixed strings are the same account.

An unknown targetNetwork fails before touching the address. Only the five keys above resolve to a prefix (CentrifugeNetworks.TryResolveConversionPrefix); anything else returns CFG_INVALID_NETWORK without attempting to decode address at all.