Descripción detallada

Operaciones de apoyo a la seguridad de las estructuras basadas en Blockchain.

Funciones
void	BchainCreateXPrvBtcMinikey (cadena szId, bool isExportable, bool isTemporary)
	Crea una clave privada XPriv para Bitcoin en formato minikey.

void	BchainCreateXPrvBip32 (cadena szId, byte bVersion, bool isExportable, bool isTemporary)
	Crea una clave privada XPriv en formato BIP32.

void	BchainCreateXPrvBip32Seed (cadena szId, DinamoApi.DN_BCHAIN_BIP32_SEED_XPRV_DATA pData, bool isExportable, bool isTemporary)
	Crea una clave privada XPriv en formato BIP32 utilizando semilla.

void	BchainCreateXPrvBip39Seed (cadena szId, DinamoApi.DN_BCHAIN_BIP39_SEED_XPRV_DATA pData, bool isExportable, bool isTemporary)
	Crea una clave privada XPriv en formato BIP39 utilizando semilla.

DinamoApi.DN_BCHAIN_KEY_INFO	BchainCreateBip32Ckd (byte bVersion, UInt32 dwIndex, cadena szPar, cadena szDst, bool isExportable, bool isTemporary)
	Realiza una operación de derivación de clave secundaria (CKD). Deriva una clave privada extendida (XPrv) para la cadena de bloques en el estándar BIP32.

byte[]	BchainSignHash (byte bType, byte bHashMode, byte[] pbHash, cadena szPk)
	Firma un hash utilizando el módulo Blockchain.

byte[]	BchainGetPubKey (byte bType, cadena szId)
	Recupera una clave pública utilizando el módulo blockchain.

byte[]	BchainGetAddress (byte bType, byte bVersion, cadena szHrp, cadena szId)
	Recupera la dirección de una clave utilizando el módulo blockchain.

byte[]	BchainEdDsaSign (byte bType, cadena szCtxStr, byte[] pbData, cadena szId)
	Genera una firma EdDsa utilizando el módulo blockchain.

void	DinamoB chainGenerateKey (.Hsm.DinamoClient.KEY_ALG dwAlg, string szId, bool isExportable, bool isTemporary)
	Genera una clave marcada para su uso en el módulo blockchain.

Funciones

◆ BchainCreateXPrvBtcMinikey()

void BchainCreateXPrvBtcMinikey	(	string	szId,
		bool	isExportable,
		bool	isTemporary )

inline

Crea una clave privada XPriv para Bitcoin en formato minikey.

Parámetros

szId	Identificador clave.
isExportable	La clave puede exportarse desde el HSM.
isTemporary	La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

Excepciones

DinamoException Lanza una excepción en caso de error.

◆ BchainCreateXPrvBip32()

void BchainCreateXPrvBip32	(	string	szId,
		byte	bVersion,
		bool	isExportable,
		bool	isTemporary )

inline

Crea una clave privada XPriv en formato BIP32.

Parámetros

szId Identificador clave.

bVersion

Versión clave. Consulte la tabla siguiente.

Valor	Significado
DinamoApi.DN_BCHAIN_VER_BIP32_MAINNET	Mainnet BIP32.
DinamoApi.DN_BCHAIN_VER_BIP32_TESTNET	Testnet BIP32.
DinamoApi.DN_BCHAIN_VER_BIP32_HTR_MAINNET	Mainnet BIP32 Hathor.
DinamoApi.DN_BCHAIN_VER_BIP32_HTR_TESTNET	Testnet BIP32 Hathor.

isExportable La clave puede exportarse desde el HSM.

isTemporary La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: bchain_ckd.cs, bchain_get_address.cs, bchain_get_pub.cs y bchain_sign_hash.cs.

◆ BchainCreateXPrvBip32Seed()

void BchainCreateXPrvBip32Seed	(	string	szId,
		DinamoApi.DN_BCHAIN_BIP32_SEED_XPRV_DATA	pData,
		bool	isExportable,
		bool	isTemporary )

inline

Crea una clave privada XPriv en formato BIP32 utilizando semilla.

Parámetros

szId	Identificador clave.
pData	Datos para generar la clave.
isExportable	La clave puede exportarse desde el HSM.
isTemporary	La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

Excepciones

DinamoException Lanza una excepción en caso de error.

◆ BchainCreateXPrvBip39Seed()

void BchainCreateXPrvBip39Seed	(	string	szId,
		DinamoApi.DN_BCHAIN_BIP39_SEED_XPRV_DATA	pData,
		bool	isExportable,
		bool	isTemporary )

inline

Crea una clave privada XPriv en formato BIP39 utilizando semilla.

Parámetros

szId	Identificador clave.
pData	Datos para generar la clave.
isExportable	La clave puede exportarse desde el HSM.
isTemporary	La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

Excepciones

DinamoException Lanza una excepción en caso de error.

◆ BchainCreateBip32Ckd()

DinamoApi.DN_BCHAIN_KEY_INFO BchainCreateBip32Ckd	(	byte	bVersion,
		UInt32	dwIndex,
		string	szPar,
		string	szDst,
		bool	isExportable,
		bool	isTemporary )

inline

Realiza una operación de derivación de clave secundaria (CKD). Deriva una clave privada extendida (XPrv) para la cadena de bloques en el estándar BIP32.

Parámetros

bVersion

Versión clave. Consulte la tabla siguiente.

Valor	Significado
DinamoApi.DN_BCHAIN_VER_BIP32_MAINNET	Mainnet BIP32.
DinamoApi.DN_BCHAIN_VER_BIP32_TESTNET	Testnet BIP32.
DinamoApi.DN_BCHAIN_VER_BIP32_HTR_MAINNET	Mainnet BIP32 Hathor.
DinamoApi.DN_BCHAIN_VER_BIP32_HTR_TESTNET	Testnet BIP32 Hathor.

dwIndex Índice de la clave que debe derivarse. Las claves no endurecidas utilizan un índice de 0 a ^231-1 y las endurecidas (sin restricciones de seguridad) utilizan índices de ²³¹ a ^232-1, tal y como se especifica en el estándar BIP32. Se recomienda encarecidamente generar claves reforzadas. Utilice DinamoApi . DN_BCHAIN_SECURE_BIP32_INDEX_BASE como base para generar índices endurecidos (por ejemplo, DinamoApi . DN_BCHAIN_SECURE_BIP32_INDEX_BASE + 1 ...).

szPar Identificador de la clave padre.

szDst Identificador de la clave derivada. Debe ser una clave XPrv(DinamoApi.DN_BCHAIN_BIP32_XPRV etc.)

isExportable La clave puede exportarse desde el HSM.

isTemporary La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

Devolución: Información sobre la clave derivada.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: bchain_ckd.cs.

◆ BchainSignHash()

byte[] BchainSignHash	(	byte	bType,
		byte	bHashMode,
		byte[]	pbHash,
		string	szPk )

inline

Firma un hash utilizando el módulo Blockchain.

Parámetros

bType

Tipo de llave.

Valor	Significado
DinamoApi.DN_BCHAIN_SIG_DER_ECDSA	Firma DER, en el formato v \|\| DER. SECG!SEC1 DER estricto con S baja como se describe en BIP62/66, BIP146, EIP2. Con 'v' de un tamaño de 1 byte. v' es el bit de paridad de 'r' y puede tener los valores 0 ó 1.
DinamoApi.DN_BCHAIN_SIG_RAW_ECDSA	Firma RAW, en el formato v \|\| r \|\| s. v' tiene un tamaño de 1 byte y 'r' y 's' tienen un tamaño de 32 bytes cada uno. v' es el bit de paridad de 'r' y puede tener los valores 0 o 1.
DinamoApi.DN_BCHAIN_SIG_BIP340	Firma BIP340 - Schnorr 64 bytes.

bHashMode

Tipo hash.

Valor	Significado
DinamoApi.DN_BCHAIN_HASH_BTC_H160	Bitcoin H160.
DinamoApi.DN_BCHAIN_HASH_RIPEMD160	RIPEMD160.
DinamoApi.DN_BCHAIN_HASH_SHA256	SHA256
DinamoApi.DN_BCHAIN_HASH_BTC_SHA256_2X	Bitcoin SHA256 2x.
DinamoApi.DN_BCHAIN_HASH_KECCAK256	KECCAK256.

pbHash Hash calculado según la información de bHashMode.

szPk Identificador de la clave privada.

Devolución: Firma.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: bchain_sign_hash.cs.

◆ BchainGetPubKey()

byte[] BchainGetPubKey	(	byte	bType,
		string	szId )

inline

Recupera una clave pública utilizando el módulo blockchain.

Parámetros

bType

Tipo de llave.

Valor	Significado
DinamoApi.DN_BCHAIN_PBK_SEC1_UNCOMP	ECDSA SEC1 sin comprimir.
DinamoApi.DN_BCHAIN_PBK_SEC1_COMP	ECDSA SEC1 comprimido.
DinamoApi.DN_BCHAIN_PBK_BIP340	Schnorr, BIP-340.
DinamoApi.DN_BCHAIN_PBK_ED25519	Ed25519.
DinamoApi.DN_BCHAIN_PBK_AT_ALGORAND	Algoritmo.
DinamoApi.DN_BCHAIN_PBK_BIP32_XPUB	BIP32 XPub.
DinamoApi.DN_BCHAIN_PBK_AT_SOL	Solana.

szId Identificador de la clave privada.

Devolución: Clave pública.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: bchain_get_pub.cs.

◆ BchainGetAddress()

byte[] BchainGetAddress	(	byte	bType,
		byte	bVersion,
		string	szHrp,
		string	szId )

inline

Recupera la dirección de una clave utilizando el módulo blockchain.

Parámetros

bType

Tipo de dirección a generar. Puede ser uno de los valores siguientes.

Valor	Significado
DinamoApi.DN_BCHAIN_AT_BTC_P2PKH	Dirección P2PKH.
DinamoApi.DN_BCHAIN_AT_BTC_P2SH	Dirección P2SH BIP13..
DinamoApi.DN_BCHAIN_AT_BTC_B32_PKH	Dirección BIP32 P2PKH BIP173.
DinamoApi.DN_BCHAIN_AT_BTC_B32_SH	Dirección BIP32 P2SH.
DinamoApi.DN_BCHAIN_AT_ETH_EOA	Dirección ETH EOA.
DinamoApi.DN_BCHAIN_AT_ETH_EOA_MC_CKS	Dirección ETH EOA MC CKS. EIP55.
DinamoApi.DN_BCHAIN_AT_ETH_EOA_ICAP	Dirección ETH EOA ICAP.
DinamoApi.DN_BCHAIN_AT_ALGORAND	Dirección Algorand.
DinamoApi.DN_BCHAIN_AT_TRON_HEX	Dirección hexadecimal de TRON.
DinamoApi.DN_BCHAIN_AT_TRON_B58	Dirección TRON Base 58.
DinamoApi.DN_BCHAIN_AT_XRP	Dirección de XRP Ledger/Ripple.
DinamoApi.DN_BCHAIN_AT_SOL	Dirección Solana.

Parámetros

bVersion

Versión de la dirección. Consulte la tabla siguiente.

Valor	Significado
DinamoApi.DN_BCHAIN_VER_UNUSED	Parámetro no utilizado.
DinamoApi.DN_BCHAIN_VER_BTC_A1_MAIN_NET	Red principal de Bitcoin A1.
DinamoApi.DN_BCHAIN_VER_XRP_CLASSIC	XRP Ledger/Ripple Classic.
DinamoApi.DN_BCHAIN_VER_BTC_AMN_TEST_NET	Red de prueba Bitcoin P2PKH.
DinamoApi.DN_BCHAIN_VER_BTC_A3_MAIN_NET	Red principal de Bitcoin A3.
DinamoApi.DN_BCHAIN_VER_BTC_B32_WITVER	Bitcoin B32 witver.
DinamoApi.DN_BCHAIN_VER_HTR_MAINNET	Hathor mainnet.
DinamoApi.DN_BCHAIN_VER_HTR_TESTNET	Hathor testnet.
DinamoApi.DN_BCHAIN_VER_HTR_P2SH_MAINNET	Red principal Hathor P2SH.
DinamoApi.DN_BCHAIN_VER_HTR_P2SH_TESTNET	Hathor P2SH testnet.

szHrp

HRP (Human Readable Part) de la clave. Se aceptan los valores de la tabla. Debe tener un tamaño máximo de DinamoApi.DN_BCHAIN_MAX_HRP

Valor	Significado
DinamoApi.DN_BCHAIN_HRP_UNUSED	Parámetro no utilizado.
DinamoApi.DN_BCHAIN_HRP_BTC_MAIN_NET	Bitcoin mainnet.
DinamoApi.DN_BCHAIN_HRP_BTC_TEST_NET	Bitcoin testnet.

szId Identificador de la clave privada.

Devolución: Dirección.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: bchain_get_address.cs.

◆ BchainEdDsaSign()

byte[] BchainEdDsaSign	(	byte	bType,
		string	szCtxStr,
		byte[]	pbData,
		string	szId )

inline

Genera una firma EdDsa utilizando el módulo blockchain.

Parámetros

bType

Tipo de suscripción que se va a generar. Puede ser uno de los valores siguientes.

Valor	Significado
DinamoApi.DN_BCHAIN_EDDSA_SIG_PURE	EdDsa Pure Signature.
DinamoApi.DN_BCHAIN_EDDSA_SIG_ALGORAND	Firma del algoritmo EdDsa.
DinamoApi.DN_BCHAIN_EDDSA_SIG_XRP	Firma EdDsa XRP.
DinamoApi.DN_BCHAIN_EDDSA_SIG_SOL	Firma EdDsa Solana.

szCtxStr Cadena de contexto definida en RFC-8032 de tamaño máximo DinamoApi.DN_BCHAIN_EDDSA_MAX_CSTRL. Se puede pasar DinamoApi.DN_BCHAIN_EDDSA_CSTR_UNUSED.

pbData Datos a firmar.

szId Identificador de la clave privada.

Devolución: Firma.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: bchain_eddsa_sign.cs.

◆ BchainGenerateKey()

void BchainGenerateKey	(	Dinamo.Hsm.DinamoClient.KEY_ALG	dwAlg,
		string	szId,
		bool	isExportable,
		bool	isTemporary )

inline

Genera una clave marcada para su uso en el módulo blockchain.

Parámetros

dwAlg	DinamoAlgoritmo que debe utilizarse. .Hsm.DinamoClient.KEY_ALG
szId	Identificador clave.
isExportable	La clave puede exportarse desde el HSM.
isTemporary	La clave sólo existirá mientras la sesión esté activa. Se destruirá una vez cerrada la sesión.

Excepciones

DinamoException Lanza una excepción en caso de error.

Ejemplos: bchain_eddsa_sign.cs.