@amadeus-protocol/sdk 1.0.7 → 1.0.8

package/dist/index.d.ts

@@ -42,6 +42,7 @@ export * from './crypto';
 export * from './conversion';
 export * from './encoding';
 export * from './encryption';
+export * from './mnemonic';
 export * from './validation';
 export * from './formatters';
 export * from './explorer';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,aAAa,CAAA"}

package/dist/index.js

@@ -42,6 +42,7 @@ export * from './crypto';
 export * from './conversion';
 export * from './encoding';
 export * from './encryption';
+export * from './mnemonic';
 export * from './validation';
 export * from './formatters';
 export * from './explorer';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,aAAa,CAAA"}

package/dist/mnemonic.d.ts

@@ -0,0 +1,96 @@
+/**
+ * BIP39 Mnemonic Utilities for Amadeus Protocol
+ *
+ * This module provides BIP39 mnemonic generation, validation, and seed derivation
+ * for use with Amadeus Protocol wallets.
+ */
+/**
+ * Generate a new 12-word BIP39 mnemonic
+ *
+ * @returns 12-word mnemonic phrase
+ *
+ * @example
+ * ```ts
+ * const mnemonic = generateMnemonic()
+ * // "abandon ability able about above absent absorb abstract absurd abuse access accident"
+ * ```
+ */
+export declare function generateMnemonic(): string;
+/**
+ * Validate a BIP39 mnemonic phrase
+ *
+ * @param mnemonic - Mnemonic phrase to validate
+ * @returns true if the mnemonic is valid
+ *
+ * @example
+ * ```ts
+ * const isValid = validateMnemonic('abandon ability able ...')
+ * ```
+ */
+export declare function validateMnemonic(mnemonic: string): boolean;
+/**
+ * Derive an Amadeus seed (base58-encoded 64 bytes) from a BIP39 mnemonic.
+ * Uses BIP39 seed derivation (PBKDF2 with SHA-512) which produces a 64-byte seed,
+ * matching the Amadeus SDK's expected seed length.
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @returns Base58-encoded 64-byte seed
+ *
+ * @example
+ * ```ts
+ * const seed = mnemonicToSeedBase58('abandon ability able ...')
+ * ```
+ */
+export declare function mnemonicToSeedBase58(mnemonic: string): string;
+/**
+ * Detect whether input is a mnemonic phrase or a raw private key.
+ *
+ * @param input - User input string
+ * @returns 'mnemonic' if the input looks like a word-based mnemonic, or 'seed' if it looks like a base58-encoded key
+ *
+ * @example
+ * ```ts
+ * const type = detectInputType('abandon ability able ...')
+ * // 'mnemonic'
+ * ```
+ */
+export declare function detectInputType(input: string): 'mnemonic' | 'seed';
+/**
+ * Vault data format that supports both mnemonic and raw seed storage.
+ * When decrypted, old vaults return a plain base58 string,
+ * new vaults return a JSON string with this shape.
+ */
+export interface VaultSecretData {
+    seed: string;
+    mnemonic?: string;
+}
+/**
+ * Encode vault secret data as a string for encryption.
+ * Always stores as JSON to include the optional mnemonic.
+ *
+ * @param seed - Base58-encoded seed
+ * @param mnemonic - Optional BIP39 mnemonic phrase
+ * @returns JSON string for vault encryption
+ *
+ * @example
+ * ```ts
+ * const vaultData = encodeVaultSecret(seed, mnemonic)
+ * const encrypted = await encryptWithPassword(vaultData, password)
+ * ```
+ */
+export declare function encodeVaultSecret(seed: string, mnemonic?: string): string;
+/**
+ * Decode vault secret data from a decrypted string.
+ * Handles both old format (plain base58 seed) and new format (JSON with seed + mnemonic).
+ *
+ * @param decrypted - Decrypted vault string
+ * @returns Parsed vault secret data
+ *
+ * @example
+ * ```ts
+ * const decrypted = await decryptWithPassword(encrypted, password)
+ * const { seed, mnemonic } = decodeVaultSecret(decrypted)
+ * ```
+ */
+export declare function decodeVaultSecret(decrypted: string): VaultSecretData;
+//# sourceMappingURL=mnemonic.d.ts.map

package/dist/mnemonic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.d.ts","sourceRoot":"","sources":["../src/mnemonic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAUlE;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAapE"}

package/dist/mnemonic.js

@@ -0,0 +1,128 @@
+/**
+ * BIP39 Mnemonic Utilities for Amadeus Protocol
+ *
+ * This module provides BIP39 mnemonic generation, validation, and seed derivation
+ * for use with Amadeus Protocol wallets.
+ */
+import * as bip39 from '@scure/bip39';
+import { wordlist } from '@scure/bip39/wordlists/english.js';
+import { toBase58 } from './encoding';
+/**
+ * Generate a new 12-word BIP39 mnemonic
+ *
+ * @returns 12-word mnemonic phrase
+ *
+ * @example
+ * ```ts
+ * const mnemonic = generateMnemonic()
+ * // "abandon ability able about above absent absorb abstract absurd abuse access accident"
+ * ```
+ */
+export function generateMnemonic() {
+    return bip39.generateMnemonic(wordlist, 128); // 128 bits = 12 words
+}
+/**
+ * Validate a BIP39 mnemonic phrase
+ *
+ * @param mnemonic - Mnemonic phrase to validate
+ * @returns true if the mnemonic is valid
+ *
+ * @example
+ * ```ts
+ * const isValid = validateMnemonic('abandon ability able ...')
+ * ```
+ */
+export function validateMnemonic(mnemonic) {
+    return bip39.validateMnemonic(mnemonic.trim().toLowerCase(), wordlist);
+}
+/**
+ * Derive an Amadeus seed (base58-encoded 64 bytes) from a BIP39 mnemonic.
+ * Uses BIP39 seed derivation (PBKDF2 with SHA-512) which produces a 64-byte seed,
+ * matching the Amadeus SDK's expected seed length.
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @returns Base58-encoded 64-byte seed
+ *
+ * @example
+ * ```ts
+ * const seed = mnemonicToSeedBase58('abandon ability able ...')
+ * ```
+ */
+export function mnemonicToSeedBase58(mnemonic) {
+    const seed = bip39.mnemonicToSeedSync(mnemonic.trim().toLowerCase());
+    return toBase58(seed);
+}
+/**
+ * Detect whether input is a mnemonic phrase or a raw private key.
+ *
+ * @param input - User input string
+ * @returns 'mnemonic' if the input looks like a word-based mnemonic, or 'seed' if it looks like a base58-encoded key
+ *
+ * @example
+ * ```ts
+ * const type = detectInputType('abandon ability able ...')
+ * // 'mnemonic'
+ * ```
+ */
+export function detectInputType(input) {
+    const trimmed = input.trim();
+    const words = trimmed.split(/\s+/);
+    // BIP39 mnemonics are 12 or 24 words
+    if (words.length === 12 || words.length === 24) {
+        // Check if all words look like English words (no numbers, no special chars)
+        const allWords = words.every((w) => /^[a-zA-Z]+$/.test(w));
+        if (allWords)
+            return 'mnemonic';
+    }
+    return 'seed';
+}
+/**
+ * Encode vault secret data as a string for encryption.
+ * Always stores as JSON to include the optional mnemonic.
+ *
+ * @param seed - Base58-encoded seed
+ * @param mnemonic - Optional BIP39 mnemonic phrase
+ * @returns JSON string for vault encryption
+ *
+ * @example
+ * ```ts
+ * const vaultData = encodeVaultSecret(seed, mnemonic)
+ * const encrypted = await encryptWithPassword(vaultData, password)
+ * ```
+ */
+export function encodeVaultSecret(seed, mnemonic) {
+    const data = { seed };
+    if (mnemonic) {
+        data.mnemonic = mnemonic;
+    }
+    return JSON.stringify(data);
+}
+/**
+ * Decode vault secret data from a decrypted string.
+ * Handles both old format (plain base58 seed) and new format (JSON with seed + mnemonic).
+ *
+ * @param decrypted - Decrypted vault string
+ * @returns Parsed vault secret data
+ *
+ * @example
+ * ```ts
+ * const decrypted = await decryptWithPassword(encrypted, password)
+ * const { seed, mnemonic } = decodeVaultSecret(decrypted)
+ * ```
+ */
+export function decodeVaultSecret(decrypted) {
+    try {
+        const parsed = JSON.parse(decrypted);
+        if (parsed && typeof parsed.seed === 'string') {
+            return {
+                seed: parsed.seed,
+                mnemonic: parsed.mnemonic || undefined
+            };
+        }
+    }
+    catch {
+        // Not JSON — old format, plain base58 seed
+    }
+    return { seed: decrypted };
+}
+//# sourceMappingURL=mnemonic.js.map

package/dist/mnemonic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.js","sourceRoot":"","sources":["../src/mnemonic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB;IAC/B,OAAO,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA,CAAC,sBAAsB;AACpE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAChD,OAAO,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;IACpE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAClC,qCAAqC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAChD,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1D,IAAI,QAAQ;YAAE,OAAO,UAAU,CAAA;IAChC,CAAC;IACD,OAAO,MAAM,CAAA;AACd,CAAC;AAYD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAiB;IAChE,MAAM,IAAI,GAAoB,EAAE,IAAI,EAAE,CAAA;IACtC,IAAI,QAAQ,EAAE,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IAClD,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACpC,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC/C,OAAO;gBACN,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;aACtC,CAAA;QACF,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,2CAA2C;IAC5C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@amadeus-protocol/sdk",
-	"version": "1.0.7",
+	"version": "1.0.8",
 	"description": "Official TypeScript/JavaScript SDK for Amadeus Protocol - Core utilities for serialization, cryptography, transaction building, and API client",
 	"repository": {
 		"type": "git",
@@ -65,6 +65,7 @@
 	"dependencies": {
 		"@noble/curves": "^1.9.1",
 		"@noble/hashes": "^1.8.0",
+		"@scure/bip39": "^2.0.1",
 		"bs58": "^6.0.0",
 		"effect": "^3.19.8"
 	},