E#ii SSKJr SSKrSSKJr SSKJrJr SSKJ r J r SSK J r J r SSKJrJrJrJrJr SSKJrJr SS KJrJrJrJrJrJrJrJrJ r J!r! \(aSS K"J#r#J$r$ "S S 5r%"S S5r&"SS5r'g)) annotationsN) TYPE_CHECKING)ffilib)GLOBAL_CONTEXTContext) decode_der encode_der) cdata_to_der der_to_cdatadeserialize_recoverablerecoverserialize_recoverable) EC_COMPRESSEDEC_UNCOMPRESSED) DEFAULT_NONCE bytes_to_int der_to_pemget_valid_secret hex_to_bytesint_to_bytes_padded pad_scalar pem_to_dersha256validate_secret)HasherNoncec(\rSrSrS\4SSjjr\\4SSjjrSSSjjr \\4SSjjr SSjr SSSjjr SSS jjr SS jrSS jrSS jrSS jr\\4S Sjj5r\\4S!Sjj5r\\4S"Sjj5r\\4S#Sjj5rSrS$SjrSSjrSrg)% PrivateKeyNcUb [U5O [5UlX l[R URUR5Ul[R URUR5Ulg)z Initializes a private key. Parameters: secret: The secret used to initialize the private key. If not provided, a new key will be generated. context: The context to use. N) rrsecretcontext PublicKeyfrom_valid_secret public_keyPublicKeyXOnlypublic_key_xonly)selfr"r#s H/home/james-whalen/.local/lib/python3.13/site-packages/coincurve/keys.py__init__PrivateKey.__init__s_9?8J_V4P`Pb  %.%@%@dll%[0>0P0PQUQ\Q\^b^j^j0kcHUbU"U5OUn[U5S:wa Sn[U5e[R"S5nUupx[R "UR RXdURXx5n U (d Sn[U5e[X`R 5$)a Creates an ECDSA signature. Parameters: message: The message to sign. hasher (collections.abc.Callable[[bytes], bytes] | None): The hash function to use, which must return 32 bytes. By default, the `sha256` algorithm is used. If `None`, no hashing occurs. custom_nonce (tuple[ffi.CData, ffi.CData]): Custom nonce data in the form `(nonce_function, input_data)`. For more information, refer to the `libsecp256k1` documentation [here](https://github.com/bitcoin-core/secp256k1/blob/v0.6.0/include/secp256k1.h#L637-L642). Returns: The ECDSA signature. Raises: ValueError: If the message hash was not 32 bytes long, the nonce generation function failed, or the private key was invalid. #Message hash must be 32 bytes long.zsecp256k1_ecdsa_signature *EThe nonce generation function failed, or the private key was invalid.) len ValueErrorrnewrsecp256k1_ecdsa_signr#ctxr"r r)messagehasher custom_noncemsg_hashmsg signaturenonce_fn nonce_datasigneds r*signPrivateKey.sign+s&'-&86'?g x=B 7CS/ !GG9: +))$,,*:*:IQUQ\Q\^fsYCS/ !I||44r-c8[U5S:wa Sn[U5eUS:Xa[R"S5nO0Uc[R nO[U5S:wa Sn[U5e[R "S5n[R"URRX@R5nU(d Sn[U5e[R "S5n[R"URRXaXB5nU(d Sn[U5e[R"URRXa[U5URR5nU(d S n[U5e[![R""U55$) a Creates a Schnorr signature. Parameters: message: The message to sign. aux_randomness: 32 bytes of fresh randomness, empty bytestring (auto-generated), or None (no randomness). Returns: The Schnorr signature. Raises: ValueError: If the message was not 32 bytes long, the optional auxiliary random data was not 32 bytes long, signing failed, or the signature was invalid. r/zMessage must be 32 bytes long.r-z,Auxiliary random data must be 32 bytes long.secp256k1_keypair *Secret was invalidzunsigned char[64]zSigning failedzInvalid signature)r2r3osurandomrNULLr4rsecp256k1_keypair_creater#r6r"secp256k1_schnorrsig_sign32secp256k1_schnorrsig_verifyr(r&bytesbuffer)r)r8aux_randomnessr<keypairresr=s r* sign_schnorrPrivateKey.sign_schnorrNs; w<2 2CS/ ! S ZZ^N  # XXN  B &@CS/ !''/0**4<<+;+;WkkR&CS/ !GG/0 --dll.>.> T[l"CS/ !-- LL  i#g,@U@U@`@` %CS/ !SZZ *++r-cHUbU"U5OUn[U5S:wa Sn[U5e[R"S5nUupx[R "UR RXdURXx5n U (d Sn[U5e[X`R 5$)a Creates a recoverable ECDSA signature. Parameters: message: The message to sign. hasher (collections.abc.Callable[[bytes], bytes] | None): The hash function to use, which must return 32 bytes. By default, the `sha256` algorithm is used. If `None`, no hashing occurs. custom_nonce (tuple[ffi.CData, ffi.CData]): Custom nonce data in the form `(nonce_function, input_data)`. For more information, refer to the `libsecp256k1` documentation [here](https://github.com/bitcoin-core/secp256k1/blob/v0.6.0/include/secp256k1.h#L637-L642). Returns: The recoverable ECDSA signature. Raises: ValueError: If the message hash was not 32 bytes long, the nonce generation function failed, or the private key was invalid. r/r0z'secp256k1_ecdsa_recoverable_signature *r1) r2r3rr4r secp256k1_ecdsa_sign_recoverabler#r6r"rr7s r*sign_recoverablePrivateKey.sign_recoverable~s&'-&86'?g x=B 7CS/ !GGEF +55 LL  i4;; YCS/ !$Y ==r-c>[R"S5n[R"URR U[ U5RUR[R[R5 [[R"US55$)ai Computes an EC Diffie-Hellman secret in constant time. !!! note This prevents malleability by returning `sha256(compressed_public_key)` instead of the `x` coordinate directly. Parameters: public_key: The formatted public key. Returns: The 32-byte shared secret. Raises: ValueError: If the public key could not be parsed or was invalid. unsigned char [32]r/) rr4rsecp256k1_ecdhr#r6r$r&r"rHrLrM)r)r&r"s r*ecdhPrivateKey.ecdhsk"-. 4<<++VYz5J5U5UW[WbWbdgdldlnqnvnvwSZZ+,,r-c[U5n[R"SUR5n[R "UR RX15nU(d Sn[U5e[[R"US55nU(aX0lUR5 U$[X0R 5$)aI Adds a scalar to the private key. Parameters: scalar: The scalar with which to add. update: Whether to update the private key in-place. Returns: The new private key, or the modified private key if `update` is `True`. Raises: ValueError: If the tweak was out of range or the resulting private key was invalid. rXzDThe tweak was out of range, or the resulting private key is invalid.r/) rrr4r"rsecp256k1_ec_seckey_tweak_addr#r6r3rLrM_update_public_keyr)r)scalarupdater"successr<s r*addPrivateKey.addsF#-t{{;33DLL4D4DfUXCS/ !szz&"-.  K  # # %K&,,//r-cX[U5n[R"SUR5n[R "UR RX15 [[R"US55nU(aX0lUR5 U$[X0R 5$)z Multiplies the private key by a scalar. Parameters: scalar: The scalar with which to multiply. update: Whether to update the private key in-place. Returns: The new private key, or the modified private key if `update` is `True`. rXr/) rrr4r"rsecp256k1_ec_seckey_tweak_mulr#r6rLrMr^r)r)r_r`r"s r*multiplyPrivateKey.multiplysz!(-t{{; ))$,,*:*:FKszz&"-.  K  # # %K&,,//r-c6URR5$)z2 Returns the private key encoded as a hex string. )r"hexr)s r*to_hexPrivateKey.to_hexs{{  r-c,[UR5$)z( Returns the private key as an integer. )rr"rjs r*to_intPrivateKey.to_intsDKK((r-c4[UR55$)z0 Returns the private key encoded in PEM format. )rto_derrjs r*to_pemPrivateKey.to_pems$++-((r-c\[URURRSS95$)z0 Returns the private key encoded in DER format. F compressed)r r"r&formatrjs r*rqPrivateKey.to_ders'$++t'='='='OPPr-c,[[U5U5$)z Creates a private key from a hex string. Parameters: hexed: The private key encoded as a hex string. context: The context to use. Returns: The private key. )rr)clshexedr#s r*from_hexPrivateKey.from_hex s,u-w77r-c,[[U5U5$)z Creates a private key from an integer. Parameters: num: The private key as an integer. context: The context to use. Returns: The private key. )rr)rznumr#s r*from_intPrivateKey.from_ints-c2G<[[[U55U5$)z Creates a private key from PEM format. Parameters: pem: The private key encoded in PEM format. context: The context to use. Returns: The private key. )rr r)rzpemr#s r*from_pemPrivateKey.from_pem)s*Z_5w??r-c,[[U5U5$)z Creates a private key from DER format. Parameters: der: The private key encoded in DER format. context: The context to use. Returns: The private key. )rr )rzderr#s r*from_derPrivateKey.from_der7s*S/733r-c[R"URRURRUR 5nU(d Sn[ U5eg)NInvalid secret.)rsecp256k1_ec_pubkey_creater#r6r&r"r3)r)createdr<s r*r^PrivateKey._update_public_keyEsH001A1A4??C]C]_c_j_jk#CS/ !r-c4URUR:H$N)r"r)others r*__eq__PrivateKey.__eq__Ls{{ell**r-c,[UR5$r)hashr"rjs r*__hash__PrivateKey.__hash__OsDKK  r-)r#r&r(r")r"z bytes | Noner#r)r8rLr9rr:rreturnrL)r-)r8rLrNrLrrL)r&rLrrLF)r_rLr`boolrr)rstrrintrrL)r{rr#rrr)rrr#rrr)rrLr#rrr)rrLr#rrrrr)__name__ __module__ __qualname____firstlineno__rr+rrrArQrUrZrbrfrkrnrrrq classmethodr|rrrr^rr__static_attributes__r-r*rrs.2~ l5;R_!5F.,`AG^k#>J-.0B04! ) ) Q 5C 8 83A = =5C @ @5C 4 4"+!r-rc \rSrSr\4SSjjr\\4SSjj5r\\4SSjj5r\\4SSjj5r \\ \4SSjj5r \\4SSjj5r SSSjjr SS jr\ 4SS jjrSSS jjrSSS jjrSSS jjrSSjrSSjrSrg) r$iSc[U[5(dXlO[[R"S5n[ R "URX1[U55nU(d Sn[U5eX0lX l g)a Initializes a public key. Parameters: data (bytes): The formatted public key. This class supports parsing compressed (33 bytes, header byte `0x02` or `0x03`), uncompressed (65 bytes, header byte `0x04`), or hybrid (65 bytes, header byte `0x06` or `0x07`) format public keys. context: The context to use. Raises: ValueError: If the public key could not be parsed or was invalid. secp256k1_pubkey *1The public key could not be parsed or is invalid.N) isinstancerLr&rr4rsecp256k1_ec_pubkey_parser6r2r3r#)r)datar#r&parsedr<s r*r+PublicKey.__init__Ts`$&&"O!56J227;; RUVZR[\FI o%(O r-c[R"S5n[R"URU[ U55nU(d Sn[ U5e[X25$)z Derives a public key from a private key secret. Parameters: secret: The private key secret. context: The context to use. Returns: The public key. Raises: ValueError: If an invalid secret was used. rzuSomehow an invalid secret was used. Please submit this as an issue here: https://github.com/ofek/coincurve/issues/new)rr4rrr6rr3r$rzr"r#r&rr<s r* from_secretPublicKey.from_secretqsUWW12 00j/Z`Jab?  S/ !--r-c[R"S5n[R"URX15nU(d Sn[ U5e[ X25$)z Derives a public key from a valid private key secret, avoiding input checks. Parameters: secret: The private key secret. context: The context to use. Returns: The public key. Raises: ValueError: If the secret was invalid. rr)rr4rrr6r3r$rs r*r%PublicKey.from_valid_secretsFWW12 00jQ#CS/ !--r-cJ[S[U5-[U5-U5$)z Derives a public key from a coordinate point. Parameters: x: The x coordinate. y: The y coordinate. context: The context to use. Returns: The public key. )r$r)rzxyr#s r* from_pointPublicKey.from_points)#6q#99.> Y@WYacrcrs <r-c&[U5n[R"SURS5n[R "UR RX15nU(d Sn[U5eU(aX0lU$[X0R 5$)aD Adds a scalar to the public key. Parameters: scalar: The scalar with which to add. update: Whether to update the public key in-place. Returns: The new public key, or the modified public key if `update` is `True`. Raises: ValueError: If the tweak was out of range or the resulting public key was invalid. rrzCThe tweak was out of range, or the resulting public key is invalid.) rrr4r&rsecp256k1_ec_pubkey_tweak_addr#r6r3r$)r)r_r`new_keyrar<s r*rb PublicKey.add!srF#''.0BC33DLL4D4DgVWCS/ ! %OK,,//r-c[U5n[R"SURS5n[R "UR RX15 U(aX0lU$[X0R 5$)z Multiplies the public key by a scalar. Parameters: scalar: The scalar with which to multiply. update: Whether to update the public key in-place. Returns: The new public key, or the modified public key if `update` is `True`. rr) rrr4r&rsecp256k1_ec_pubkey_tweak_mulr#r6r$)r)r_r`rs r*rfPublicKey.multiply?s^!(''.0BC ))$,,*:*:GL %OK,,//r-cR[R"S5n[R"URR X0/UQVs/sHoDR PM sn[U5S-5nU(d Sn[U5eU(aX0lU$[X0R5$s snf)a5 Adds a number of public keys together. Parameters: public_keys: A sequence of public keys. update: Whether to update the public key in-place. Returns: The combined public key, or the modified public key if `update` is `True`. Raises: ValueError: If the sum of the public keys was invalid. rrr) rr4rrr#r6r&r2r3r$)r)rr`rrrr<s r*combinePublicKey.combineVs''./22 LL  g@T @T'U@T" @T'UWZ[fWgjkWk :CS/ ! %OK,,//(VsB$ c@URSS9URSS9:H$NFru)rwrs r*rPublicKey.__eq__ts#{{e{,  0NNNr-c2[URSS95$rrrwrjs r*rPublicKey.__hash__wsDKK5K122r-)r#r&N)rbytes | ffi.CDatar#r)r"rLr#rrr$)rrrrr#rrr$) r=rLr8rLr9rr#rrr$)rlist[PublicKey]r#rrr$)T)rvrrrL)rztuple[int, int])r=rLr8rLr9rrrr)r_rLr`rrr$)rrr`rrr$rr)rrrrrr+rrr%rrrrrwrrrbrfrrrrrr-r*r$r$SsCQ:;I..8AO..0;I ] ]@F[i  (- 7= QX   0KY..45*MIO 60<0.0<O3r-r$c\rSrSrS\4S Sjjr\\4SSjj5r\\4SSjj5rSSjr SSjr SSjr SS jr SS jr S rg )r'i{Fc[U[5(dXlOQ[R"S5n[ R "URXA5nU(d Sn[U5eX@lX l X0l g)a Initializes a BIP340 `x-only` public key. Parameters: data (bytes): The formatted public key. parity: Whether the encoded point is the negation of the public key. context: The context to use. Raises: ValueError: If the public key could not be parsed or is invalid. secp256k1_xonly_pubkey *rN) rrLr&rr4rsecp256k1_xonly_pubkey_parser6r3parityr#)r)rrr#r&rr<s r*r+PublicKeyXOnly.__init__|s\$&&"O!;R 4CS/ !66 LL  i#g,   r-c[U5n[R"S5n[R"UR R X RU5nU(d Sn[U5e[R"S5n[R"UR R URXR5 US(Ul g)z Adds a scalar to the public key. Parameters: scalar: The scalar with which to add. Returns: The modified public key. Raises: ValueError: If the tweak was out of range or the resulting public key would be invalid. rzHThe tweak was out of range, or the resulting public key would be invalidrrN) rrr4r secp256k1_xonly_pubkey_tweak_addr#r6r&r3"secp256k1_xonly_pubkey_from_pubkeyr)r)r_ out_pubkeyrPr<rs r* tweak_addPublicKeyXOnly.tweak_addsF#WW12 224<<3C3CZQ`Q`bhi\CS/ !GGG$  ..t||/?/?R[h'l* r-c[R"URRURUR5nUS:H$)Nr)rsecp256k1_xonly_pubkey_cmpr#r6r&)r)rrPs r*rPublicKeyXOnly.__eq__s4,,T\\-=-=tPUP`P`aaxr-c4[UR55$rrrjs r*rPublicKeyXOnly.__hash__sDKKM""r-)r#rr&N)rrrrr#r)r"rLr#rrr'r)r=rLr8rLrr)r_rLrNonerr)rrrrrr+rrr%rwrrrrrrr-r*r'r'{sX?DYg4;IOO4AOOO4/& ,+2#r-r')( __future__rrFtypingrcoincurve._libsecp256k1rrcoincurve.contextrr coincurve.derr r coincurve.ecdsar r r rrcoincurve.flagsrrcoincurve.utilsrrrrrrrrrrcoincurve.typesrrrr$r'rr-r*rs]" ,50oo:   -t!t!n e3e3P X#X#r-