(i/$ dZddlmZmZmZddlmZmZddlm Z m Z m Z ddhZ dd hZ Gd d eZGd d eZGddeZdedededeeeffdZGddZy)a Generate Heirarchical Deterministic Wallets (HDWallet). Partially implements the BIP-0032, BIP-0043, and BIP-0044 specifications: * BIP-0032: https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki * BIP-0043: https://github.com/bitcoin/bips/blob/master/bip-0043.mediawiki * BIP-0044: https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki Skips serialization and public key derivation as unnecssary for this library's purposes. Notes ----- * Integers are modulo the order of the curve (referred to as n). * Addition (+) of two coordinate pair is defined as application of the EC group operation. * Concatenation (||) is the operation of appending one byte sequence onto another. Definitions ----------- * point(p): returns the coordinate pair resulting from EC point multiplication (repeated application of the EC group operation) of the secp256k1 base point with the integer p. * ser_32(i): serialize a 32-bit unsigned integer i as a 4-byte sequence, most significant byte first. * ser_256(p): serializes the integer p as a 32-byte sequence, most significant byte first. * ser_P(P): serializes the coordinate pair P = (x,y) as a byte sequence using SEC1's compressed form: (0x02 or 0x03) || ser_256(x), where the header byte depends on the parity of the omitted y coordinate. * parse_256(p): interprets a 32-byte sequence as a 256-bit number, most significant byte first. )TupleTypeUnion)ValidationErrorto_int) SECP256K1_Nec_point hmac_sha512mM'HceZdZUdZdZdZeed<deddfdZde fdZ deddfd Z de fd Z de fd Zed e ded fdZy)Nodez A base node class. rindexreturncd|kDs|dkDrt|d|tj|||jz}||_|S)Nrz" cannot be initialized with value )rint__new__OFFSETr)clsrobjs T/var/www/br/venv/lib/python3.12/site-packages/eth_account/hdaccount/deterministic.pyrz Node.__new__NsK u9 !SE)KE7"ST Tkk#uszz12  cN|jjd|jdS)N()) __class____name__rselfs r__repr__z Node.__repr__Vs$..))*!DJJ|j|j|zSN)r!r)r$r&s r__add__z Node.__add__Ys~~djj5011rc(|jddS)Nbig byteorder)to_bytesr#s r serializezNode.serialize\s}}Q%}00rcFt|j|jzSr()strrTAGr#s rencodez Node.encode_s4::))rnode)SoftNodeHardNodect|dkr td|dtvr t}|dd}nt}|} t |}||S#t $r}td|d|d}~wwxYw)NrzCannot use empty stringrz' is not a valid node index.)lenrHARD_NODE_SUFFIXESr7r6r ValueError)r5 node_class node_index node_valueerrs rdecodez Node.decodebs t9q=!";< < 8) )!JcrJ!JJ YZJ*%% Y!Aj\1M"NOUX X Ys A A+A&&A+N)r" __module__ __qualname____doc__r3rr__annotations__rr2r%r)bytesr0r4 staticmethodrrArrrrEs C F JCF:#:2S2V2151**&S&U#9:&&rrceZdZdZdZdZy)r6z7 Soft node (unhardened), where value = index . rrNr"rBrCrDr3rrHrrr6r6ws C Frr6ceZdZdZdZdZy)r7zD Hard node, where value = index + BIP32_HARDENED_CONSTANT . rrNrJrHrrr7r7s C Frr7 parent_keyparent_chain_coder5rcnt|dk(sJt|tr1t|dk(sJt|d|z|j z}n^t|t r@tt |dk(sJt|t ||j z}ntd|t|dk(sJt|ddtk\rt|||dzSt|ddt|ztz}|dk(rt|||dzS|jdd }|dd}||fS) u Compute a derivative key from the parent key. From BIP32: The function CKDpriv((k_par, c_par), i) → (k_i, c_i) computes a child extended private key from the parent extended private key: 1. Check whether the child is a hardened key (i ≥ 2**31). If the child is a hardened key, let I = HMAC-SHA512(Key = c_par, Data = 0x00 || ser_256(k_par) || ser_32(i)). (Note: The 0x00 pads the private key to make it 33 bytes long.) If it is not a hardened key, then let I = HMAC-SHA512(Key = c_par, Data = ser_P(point(k_par)) || ser_32(i)). 2. Split I into two 32-byte sequences, I_L and I_R. 3. The returned child key k_i is parse_256(I_L) + k_par (mod n). 4. The returned chain code c_i is I_R. 5. In case parse_256(I_L) ≥ n or k_i = 0, the resulting key is invalid, and one should proceed with the next value for i. (Note: this has probability lower than 1 in 2**127.) !zCannot process: @Nrrr,r-) r: isinstancer7r r0r6r rrr derive_child_keyr/)rLrMr5child child_keychild_key_byteschild_chain_codes rrTrTsG6  !R '' '$!:"$$$-w/CdnnFV/VW D( #8J'(B...-x /CdnnFV/VW 0788 u:   eCRj[( ,=taxHHcr #fZ&88KGIA~ ,=taxHH((u(=ORSz , ,,rc@eZdZdefdZdefdZdefdZdedefdZy) HDPathpathc `t|dkr td|jd}|dtvrtd|dg}t |ddD]*\}} |j t j|,||_y#t$r}td|d |d ||d}~wwxYw) aY Create a new Hierarchical Deterministic path by decoding the given path. Initializes an hd account generator using the given path string (from BIP-0032). The path is decoded into nodes of the derivation key tree, which define a pathway from a given main seed to the child key that is used for a given purpose. Please also reference BIP- 0043 (which definites the first level as the "purpose" field of an HD path) and BIP-0044 (which defines a commonly-used, 5-level scheme for BIP32 paths) for examples of how this object may be used. Please note however that this object makes no such assumptions of the use of BIP43 or BIP44, or later BIPs. :param path : BIP32-compatible derivation path :type path : str as "m/idx_0/.../idx_n" or "m/idx_0/.../idx_n" where idx_* is either an integer value (soft node) or an integer value followed by either the "'" char or the "H" char (hardened node) rz$Cannot parse path from empty string./rzPath is not valid: "z". Must start with "m"NzPath "z!" is not valid. Issue with node "z": ) r:rsplitBASE_NODE_IDENTIFIERS enumerateappendrrA_path)r$r[nodes decoded_path_idxr5r@s r__init__zHDPath.__init__s$ t9q=!"HI I 3 80 0!$8>T"UV V #E!"I. JD$ ##DKK$56 " # %TF"CD6SER s$B  B-B((B-rcV|jjd|jdS)Nz(path="z"))r!r"r4r#s rr%zHDPath.__repr__s&..))*'$++-CCrcbdtd|jDz}dj|S)z] Encodes this class to a string (reversing the decoding in the constructor). )r c3<K|]}|jywr()r4).0r5s r z HDPath.encode..s%Kdkkm%Ksr])tuplerbjoin)r$ encoded_paths rr4z HDPath.encodes,%K %K KK xx %%rseedcttd|}|dd}|dd}|jD]}t|||\}}|S)a3 Perform the BIP32 Hierarchical Derivation recursive loop with the given Path. Note that the key and chain_code are initialized with the main seed, and that the key that is returned is the child key at the end of derivation process (and the chain code is discarded) s Bitcoin seedNrO)r rbrT)r$ro main_nodekey chain_coder5s rderivez HDPath.derivesR 6 nrs^ JJ FD.sJEOC F rN) r"rBrCr2rfr%r4rFrtrHrrrZrZs<""S""HD#D&& 5 U rrZN)rDtypingrrr eth_utilsrr_utilsr r r r_r;rrr6r7rFrTrZrHrrrxs$^   c 3Z/&3/&dtt5-5-5- 5- 5%< 5-p<<r