CosmosStealthService

SIP Protocol API Reference / CosmosStealthService

Class: CosmosStealthService

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:2898

Cosmos Stealth Address Service

Provides stealth address generation and key derivation for Cosmos chains. Reuses secp256k1 logic from core stealth module, adding Cosmos-specific address formatting.

Constructors

Constructor

new CosmosStealthService(): CosmosStealthService

Returns

CosmosStealthService

Methods

generateStealthMetaAddress()

generateStealthMetaAddress(chain, label?): object

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:2914

Generate a stealth meta-address for a Cosmos chain

Parameters

chain

CosmosChainId

Cosmos chain identifier

label?

string

Optional human-readable label

Returns

object

Stealth meta-address and private keys

metaAddress

metaAddress: StealthMetaAddress

spendingPrivateKey

spendingPrivateKey: `0x${string}`

viewingPrivateKey

viewingPrivateKey: `0x${string}`

Throws

If chain is invalid

Example

const service = new CosmosStealthService()
const { metaAddress, spendingPrivateKey, viewingPrivateKey } =
  service.generateStealthMetaAddress('cosmos', 'My Cosmos Wallet')

generateStealthAddress()

generateStealthAddress(spendingPubKey, viewingPubKey, chain): CosmosStealthResult

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:2939

Generate a one-time stealth address for a Cosmos chain

Parameters

spendingPubKey

Uint8Array

Recipient’s spending public key (33-byte compressed)

viewingPubKey

Uint8Array

Recipient’s viewing public key (33-byte compressed)

chain

CosmosChainId

Cosmos chain identifier

Returns

CosmosStealthResult

Cosmos stealth address with bech32 encoding

Throws

If keys or chain are invalid

Example

const service = new CosmosStealthService()
const result = service.generateStealthAddress(
  spendingKey,
  viewingKey,
  'osmosis'
)
console.log(result.stealthAddress) // "osmo1..."

generateStealthAddressFromMeta()

generateStealthAddressFromMeta(recipientMetaAddress, chain): CosmosStealthResult

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:2956

Generate stealth address from StealthMetaAddress

Convenience method that accepts a StealthMetaAddress directly.

Parameters

recipientMetaAddress

StealthMetaAddress

Recipient’s stealth meta-address

chain

CosmosChainId

Cosmos chain identifier

Returns

CosmosStealthResult

Cosmos stealth address with bech32 encoding

Throws

If meta-address or chain are invalid

Example

const service = new CosmosStealthService()
const result = service.generateStealthAddressFromMeta(metaAddress, 'cosmos')

stealthKeyToCosmosAddress()

stealthKeyToCosmosAddress(publicKey, prefix): string

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:2977

Convert stealth public key to Cosmos bech32 address

Algorithm:

SHA256 hash of compressed public key
RIPEMD160 hash of SHA256 hash
Bech32 encode with chain prefix

Parameters

publicKey

Uint8Array

Compressed secp256k1 public key (33 bytes)

prefix

string

Bech32 address prefix (e.g., “cosmos”, “osmo”)

Returns

string

Bech32-encoded address

Throws

If public key is invalid

Example

const service = new CosmosStealthService()
const address = service.stealthKeyToCosmosAddress(pubKey, 'cosmos')
// Returns: "cosmos1abc..."

deriveStealthPrivateKey()

deriveStealthPrivateKey(stealthAddress, spendingPrivateKey, viewingPrivateKey): StealthAddressRecovery

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:2998

Derive stealth private key for recipient to claim funds

Parameters

stealthAddress

StealthAddress

The stealth address to recover (as StealthAddress)

spendingPrivateKey

`0x${string}`

Recipient’s spending private key

viewingPrivateKey

`0x${string}`

Recipient’s viewing private key

Returns

StealthAddressRecovery

Recovery data with derived private key

Throws

If any input is invalid

Example

const service = new CosmosStealthService()
const recovery = service.deriveStealthPrivateKey(
  stealthAddress,
  spendingPrivKey,
  viewingPrivKey
)
// Use recovery.privateKey to spend funds

decodeBech32Address()

decodeBech32Address(address): object

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:3016

Decode a Cosmos bech32 address to raw hash

Parameters

address

string

Bech32-encoded address

Returns

object

Decoded address hash (20 bytes)

prefix

prefix: string

hash

hash: Uint8Array

Throws

If address is invalid

Example

const service = new CosmosStealthService()
const { prefix, hash } = service.decodeBech32Address('cosmos1abc...')

isValidCosmosAddress()

isValidCosmosAddress(address, expectedChain?): boolean

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:3034

Validate a Cosmos bech32 address format

Parameters

address

string

Address to validate

expectedChain?

CosmosChainId

Optional chain to validate prefix against

Returns

boolean

true if valid, false otherwise

Example

const service = new CosmosStealthService()
service.isValidCosmosAddress('cosmos1abc...', 'cosmos') // true
service.isValidCosmosAddress('osmo1xyz...', 'cosmos')   // false (wrong prefix)

getChainFromAddress()

getChainFromAddress(address): CosmosChainId | null

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:3048

Get the chain ID from a bech32 address prefix

Parameters

address

string

Bech32-encoded address

Returns

CosmosChainId | null

Chain ID or null if unknown prefix

Example

const service = new CosmosStealthService()
service.getChainFromAddress('cosmos1abc...') // 'cosmos'
service.getChainFromAddress('osmo1xyz...')   // 'osmosis'