Skip to content

Latest commit

 

History

History
119 lines (86 loc) · 6.21 KB

sep-0005-key-derivation.md

File metadata and controls

119 lines (86 loc) · 6.21 KB
Raw

SEP-0005 - Key Derivation Methods for Stellar Keys

Methods for key derivation for Stellar are described in SEP-005. This improves key storage and moving keys between wallets and apps.

In the following examples you can see how to generate 12 or 24 words mnemonics for different languages using the PHP SDK, how to generate key pairs from a mnemonic (with and without BIP 39 passphrase) and how to generate key pairs from a BIP 39 seed.

Generate mnemonic

$mnemonic =  Mnemonic::generate12WordsMnemonic();
print implode(" ", $mnemonic->words) . PHP_EOL;
// bind struggle sausage repair machine fee setup finish transfer stamp benefit economy

$mnemonic =  Mnemonic::generate24WordsMnemonic();
print implode(" ", $mnemonic->words) . PHP_EOL;
// cabbage verb depart erase cable eye crowd approve tower umbrella violin tube island tortoise suspect resemble harbor twelve romance away rug current robust practice

Default language is english.

Generate other language mnemonic

$frenchMnemonic = Mnemonic::generate12WordsMnemonic(WordList::LANGUAGE_FRENCH);
print implode(" ", $frenchMnemonic->words) . PHP_EOL;
// traction maniable punaise flasque digital maussade usuel joueur volcan vaccin tasse concert

$koreanMnemonic =  Mnemonic::generate24WordsMnemonic(WordList::LANGUAGE_KOREAN);
print implode(" ", $koreanMnemonic->words) . PHP_EOL;
// 배꼽 복숭아 오십 방바닥 변호사 교육 평가 휴일 고무신 여론 복사 부근 반응 페인트 예감 악수 하순 양주 줄거리 용기 온종일 의학 핑계 학급

Supported languages are:

  • english
  • french
  • spanish
  • italian
  • korean
  • japanese
  • simplified chinese
  • traditional chinese
  • malay

Generate key pairs from mnemonic

$mnemonic = Mnemonic::mnemonicFromWords("shell green recycle learn purchase able oxygen right echo claim hill again hidden evidence nice decade panic enemy cake version say furnace garment glue");

$keyPair0 = KeyPair::fromMnemonic($mnemonic, 0);
print($keyPair0->getAccountId() . " : " . $keyPair0->getSecretSeed() . PHP_EOL);
// GCVSEBHB6CTMEHUHIUY4DDFMWQ7PJTHFZGOK2JUD5EG2ARNVS6S22E3K : SATLGMF3SP2V47SJLBFVKZZJQARDOBDQ7DNSSPUV7NLQNPN3QB7M74XH

$keyPair1 = KeyPair::fromMnemonic($mnemonic, 1);
print($keyPair1->getAccountId() . " : " . $keyPair1->getSecretSeed() . PHP_EOL);
// GBPHPX7SZKYEDV5CVOA5JOJE2RHJJDCJMRWMV4KBOIE5VSDJ6VAESR2W : SCAYXPIDEUVDGDTKF4NGVMN7HCZOTZJ43E62EEYKVUYXEE7HMU4DFQA6

Generate key pairs from mnemonic of other language

$mnemonic = Mnemonic::mnemonicFromWords("절차 튀김 건강 평가 테스트 민족 몹시 어른 주민 형제 발레 만점 산길 물고기 방면 여학생 결국 수명 애정 정치 관심 상자 축하 고무신",
    WordList::LANGUAGE_KOREAN);

$keyPair0 = KeyPair::fromMnemonic($mnemonic, 0);
print($keyPair0->getAccountId() . " : " . $keyPair0->getSecretSeed() . PHP_EOL);
// GBEAH7ADD5NRYA5YGXDMSWB7PK7J44DYG5I7SVL2FYHCPH5ZH4EJC3YP : SAINP4ANECVGSF5SBNWZIQDX3XTGFLSTCWVHJN4BE5AFY42DOCPS6MEW

$keyPair1 = KeyPair::fromMnemonic($mnemonic, 1);
print($keyPair1->getAccountId() . " : " . $keyPair1->getSecretSeed() . PHP_EOL);
// GCCSXBOX7Y54MT74FGBTL3OI6IOPTB7LSCSLZXKMHG4X56DYN2DPKUTF : SAB26ECJ3TATPR3MHA75IL4KPRXAQWMCGRYKIK3DWXW7Y53DOPVA2YZP

Generate key pairs from mnemonic with BIP 39 passphrase

$mnemonic = Mnemonic::mnemonicFromWords("cable spray genius state float twenty onion head street palace net private method loan turn phrase state blanket interest dry amazing dress blast tube");
$passphrase = "p4ssphr4se";

$keyPair0 = KeyPair::fromMnemonic($mnemonic, 0, $passphrase);
print($keyPair0->getAccountId() . " : " . $keyPair0->getSecretSeed() . PHP_EOL);
// GDAHPZ2NSYIIHZXM56Y36SBVTV5QKFIZGYMMBHOU53ETUSWTP62B63EQ : SAFWTGXVS7ELMNCXELFWCFZOPMHUZ5LXNBGUVRCY3FHLFPXK4QPXYP2X

$keyPair1 = KeyPair::fromMnemonic($mnemonic, 1, $passphrase);
print($keyPair1->getAccountId() . " : " . $keyPair1->getSecretSeed() . PHP_EOL);
// GDY47CJARRHHL66JH3RJURDYXAMIQ5DMXZLP3TDAUJ6IN2GUOFX4OJOC : SBQPDFUGLMWJYEYXFRM5TQX3AX2BR47WKI4FDS7EJQUSEUUVY72MZPJF

Generate key pairs from BIP 39 seed

$bip39SeedHex = "e4a5a632e70943ae7f07659df1332160937fad82587216a4c64315a0fb39497ee4a01f76ddab4cba68147977f3a147b6ad584c41808e8238a07f6cc4b582f186";

$keyPair0 = KeyPair::fromBip39SeedHex($bip39SeedHex, 0);
print($keyPair0->getAccountId() . " : " . $keyPair0->getSecretSeed() . PHP_EOL);
// GDRXE2BQUC3AZNPVFSCEZ76NJ3WWL25FYFK6RGZGIEKWE4SOOHSUJUJ6 : SBGWSG6BTNCKCOB3DIFBGCVMUPQFYPA2G4O34RMTB343OYPXU5DJDVMN

$keyPair1 = KeyPair::fromBip39SeedHex($bip39SeedHex, 1);
print($keyPair1->getAccountId() . " : " . $keyPair1->getSecretSeed() . PHP_EOL);
// GBAW5XGWORWVFE2XTJYDTLDHXTY2Q2MO73HYCGB3XMFMQ562Q2W2GJQX : SCEPFFWGAG5P2VX5DHIYK3XEMZYLTYWIPWYEKXFHSK25RVMIUNJ7CTIS

Generate BIP 39 seed and m/44'/148' key from mnemonic

$mnemonic = Mnemonic::generate24WordsMnemonic(WordList::LANGUAGE_ITALIAN);

print("BIP 39 seed: " .  $mnemonic->bip39SeedHex() . PHP_EOL);
// BIP 39 seed: 54e3061b46c2ceeb9acb29b7c879f5c06414ecc70938ac9c8579fd7d188e9b96162d0477d3af08c86d8cda34949783849518b7be031da5b1fc068735846df573

print("BIP 39 seed with passphrase: " .  $mnemonic->bip39SeedHex("p4ssphr4se") . PHP_EOL);
// BIP 39 seed with passphrase: a277e7c3670cf371692a6ef6f9c4177dac6cba69d467b577a430193def40a1512bfedaec8a7cddc7b38573518f242f2b0178048389eeb5dbccaf4ee5556027a2

print("m/44'/148' key: " .  $mnemonic->m44148keyHex() . PHP_EOL);
// m/44'/148' key: c5af1061efaa129ef0e0b56e38b8139a27dcfef0f4cbbdfa45b8128a1ac89fbe

print("m/44'/148' key with passphrase: " .  $mnemonic->m44148keyHex("p4ssphr4se") . PHP_EOL);
// m/44'/148' key with passphrase: 896dacfe28cac6362e5df6a98482d82719853313feab117a01081110a5e5ca25