PQC-Mnemonic

BIP-39 니모닉을 사용하여 ECDSA-only, PQC-only, 하이브리드 주소를 생성하는 TypeScript 라이브러리입니다.

특징

- BIP-39 니모닉 지원: 표준 니모닉 생성 및 검증
- 다양한 주소 체계: ECDSA-only, PQC-only, 하이브리드 지원
- 모듈화된 설계: 주소 체계를 모듈처럼 교체 가능
- 동일 인덱스 지원: 같은 니모닉과 인덱스로 모든 주소 타입 생성 가능

설치

``bash
npm install pqc-mnemonic
`

사용법

$3

BIP-39 니모닉은 엔트로피 강도에 따라 단어 수가 결정됩니다:

- 12단어 (128비트 엔트로피): 기본값, 대부분의 사용 사례에 충분

- 보안 수준: 2^128 조합 (약 3.4 × 10^38)
- 입력 편의성: 더 짧고 기억하기 쉬움
- 권장: 일반적인 지갑 사용

- 24단어 (256비트 엔트로피): 더 높은 보안 수준
- 보안 수준: 2^256 조합 (약 1.2 × 10^77)
- 입력 편의성: 더 길지만 더 안전
- 권장: 고가치 자산이나 장기 보관이 필요한 경우

참고: 두 경우 모두 seed는 64바이트(512비트)로 동일하게 생성됩니다. 차이는 엔트로피의 무작위성 강도입니다.

`typescript
import { generateMnemonic, createWallet } from 'pqc-mnemonic';

// 12단어 니모닉 생성 (기본값, 128비트)
const mnemonic12 = generateMnemonic(); // 또는 generateMnemonic(128)
console.log(mnemonic12); // 12개 단어

// 24단어 니모닉 생성 (256비트)
const mnemonic24 = generateMnemonic(256);
console.log(mnemonic24); // 24개 단어

// 12단어로 지갑 생성 (기본값)
const wallet12 = createWallet();
console.log(wallet12.mnemonic.split(' ').length); // 12개 단어

// 24단어로 지갑 생성 (256비트 엔트로피)
const wallet24 = createWallet({ mnemonicStrength: 256 });
console.log(wallet24.mnemonic.split(' ').length); // 24개 단어
`

$3

`typescript
import { createWallet, restoreWallet } from 'pqc-mnemonic';

// 새 지갑 생성
const wallet = createWallet();

// 니모닉 확인
console.log(wallet.mnemonic);

// 주소 생성 (인덱스 0)
const addressInfo = wallet.getAddress(0);
console.log(addressInfo.address);
`

$3

`typescript
import { createWallet, ECDSAOnlyScheme } from 'pqc-mnemonic';

const wallet = createWallet({
addressScheme: new ECDSAOnlyScheme("m/44'/0'/0'"),
});

const addressInfo = wallet.getAddress(0);
// addressInfo.ecdsaKeyPair 사용
`

$3

`typescript
import { createWallet, PQCONlyScheme } from 'pqc-mnemonic';

const wallet = createWallet({
addressScheme: new PQCONlyScheme('pqc-keygen'),
});

const addressInfo = wallet.getAddress(0);
// addressInfo.pqcKeyPair 사용
`

$3

`typescript
import { createWallet, HybridScheme } from 'pqc-mnemonic';

const wallet = createWallet({
addressScheme: new HybridScheme("m/44'/0'/0'", 'pqc-hybrid'),
});

const addressInfo = wallet.getAddress(0);
// addressInfo.ecdsaKeyPair와 addressInfo.pqcKeyPair 모두 사용 가능
`

$3

`typescript
import { restoreWallet } from 'pqc-mnemonic';

const mnemonic = 'your twelve word mnemonic phrase here...';
const wallet = restoreWallet(mnemonic);

// 같은 인덱스로 모든 주소 타입 생성 가능
const addressInfo = wallet.getAddress(0);
`

주소 체계 커스터마이징

주소 체계가 바뀔 수 있으므로 AddressScheme 또는 HybridAddressScheme 인터페이스를 구현하여 교체할 수 있습니다:

`typescript
import { AddressScheme, KeyPair, Address } from 'pqc-mnemonic';

class CustomAddressScheme implements AddressScheme {
readonly name = 'custom';

deriveKeyPair(seed: Uint8Array, index: number): KeyPair {
// 커스텀 키 파생 로직
}

publicKeyToAddress(publicKey: Uint8Array): Address {
// 커스텀 주소 생성 로직
}

validateAddress(address: Address): boolean {
// 커스텀 주소 검증 로직
}
}

const wallet = createWallet({
addressScheme: new CustomAddressScheme(),
});
`

API

$3

- generateMnemonic(strength?: number): string - 새 니모닉 생성
- strength: 엔트로피 비트 수 (128=12단어, 256=24단어, 기본값: 128)
- 지원 값: 128, 160, 192, 224, 256
- validateMnemonic(mnemonic: string): boolean - 니모닉 검증
- mnemonicToSeed(mnemonic: string, passphrase?: string): Uint8Array - 니모닉에서 seed 생성

$3

- createWallet(options?: WalletOptions): Wallet - 새 지갑 생성
- options.mnemonicStrength: 니모닉 엔트로피 비트 수 (128=12단어, 256=24단어, 기본값: 128)
- options.addressScheme: 주소 체계 (기본값: HybridScheme)
- options.bip44Path: BIP-44 경로 (기본값: "m/44'/0'/0'")
- options.pqcDomain: PQC 도메인 분리 문자열 (기본값: "pqc-domain")
- restoreWallet(mnemonic: string, options?: WalletOptions): Wallet - 니모닉으로 지갑 복구
- wallet.getAddress(index: number): AddressInfo` - 인덱스별 주소 생성

라이선스

MIT