fix(express): createLocalKeyChain type codec

Ticket: WP-6717

Author: lokesh-bitgo

modules/express/src/typedRoutes/api/v1/createLocalKeyChain.ts

@@ -3,35 +3,35 @@ import { httpRoute, httpRequest, optional } from '@api-ts/io-ts-http';
 import { BitgoExpressError } from '../../schemas/error';
 
 /**
- * Request parameters for creating a local keychain
+ * Request body for creating a local keychain
  */
 export const CreateLocalKeyChainRequestBody = {
-  /** Optional seed for key generation (use with caution) */
+  /** Optional seed for key generation (hex string that will be converted to Buffer internally) */
   seed: optional(t.string),
+  /** Whether to generate a root key pair (uses generateRootKeyPair instead of generateKeyPair) */
+  isRootKey: optional(t.boolean),
 };
 
 /**
  * Response for creating a local keychain
  */
 export const CreateLocalKeyChainResponse = t.type({
-  /** The extended private key */
-  xprv: t.string,
-  /** The extended public key */
-  xpub: t.string,
-  /** The Ethereum address derived from the xpub (if available) */
-  ethAddress: optional(t.string),
+  /** The private key (in extended key format) */
+  prv: t.string,
+  /** The public key (in extended key format) - optional */
+  pub: optional(t.string),
 });
 
 /**
  * Create a local keychain
  *
  * Locally creates a new keychain. This is a client-side function that does not
- * involve any server-side operations. Returns an object containing the xprv and xpub
- * for the new chain. The created keychain is not known to the BitGo service.
- * To use it with the BitGo service, use the 'Add Keychain' API call.
+ * involve any server-side operations. Returns an object containing the prv and pub
+ * keys (in extended key format) for the new chain. The created keychain is not known
+ * to the BitGo service. To use it with the BitGo service, use the 'Add Keychain' API call.
  *
  * For security reasons, it is highly recommended that you encrypt and destroy
- * the original xprv immediately to prevent theft.
+ * the original private key immediately to prevent theft.
  *
  * @operationId express.v1.keychain.local
  * @tag express