"""
比特币(Bitcoin)特定的函数、类、工具函数和全局参数配置。
这段代码定义了比特币加密学的基础常数，是后续生成公私钥、签名交易的基石。
"""

from dataclasses import dataclass
# 导入底层实现的椭圆曲线（Curve）、坐标点（Point）和生成器（Generator）类
# 这些类通常在同级目录的 curves.py 中用纯数学运算（加减乘除、取模）手写实现
from .curves import Curve, Point, Generator

# -----------------------------------------------------------------------------
# 公开 API (Public API)
# 定义当其他模块使用 `from current_module import *` 时，只暴露 BITCOIN 这个全局对象
__all__ = ['BITCOIN']

# -----------------------------------------------------------------------------

@dataclass
class Coin:
    """
    定义一个通用的加密货币数据类。
    不同的加密货币可能使用不同的椭圆曲线或生成器，这里将其抽象出来。
    """
    gen: Generator # 币种使用的曲线生成器（包含基点和阶）

# -----------------------------------------------------------------------------

def bitcoin_gen():
    """
    初始化比特币的椭圆曲线生成器。
    
    # 比特币使用的是 secp256k1 椭圆曲线标准：http://www.oid-info.com/get/1.3.132.0.10
    # 注意：美国国家标准局(NIST)推荐的是 secp256r1，但中本聪特意避开了它，
    # 选择了比较冷门的 secp256k1，很多人认为这是为了防范潜在的后门。
    """
    
    # 1. p (Prime): 素数域的模数
    # 它定义了曲线所在的有限域的大小。所有的加法和乘法运算最后都要对 p 取模。
    # 这是一个非常非常大的质数，接近 2^256。
    p = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFC2F
    
    # 2. a 和 b: 决定椭圆曲线形状的参数
    # 椭圆曲线的一般方程是： y^2 = x^3 + ax + b (mod p)
    # 因为 a = 0, b = 7，所以比特币的曲线方程极度简化为： y^2 = x^3 + 7 (mod p)
    a = 0x0000000000000000000000000000000000000000000000000000000000000000
    b = 0x0000000000000000000000000000000000000000000000000000000000000007
    
    # 3. Gx 和 Gy: 基点 G (Generator Point) 的横纵坐标
    # 这是比特币网络中所有人公认的一个起始点（位于上述的曲线上）。
    # 你的私钥（一个巨大的随机整数 k）与这个基点 G 进行标量乘法（即 G 点在曲线上累加 k 次），
    # 算出来的终点坐标，就是你的公钥。
    Gx = 0x79BE667EF9DCBBAC55A06295CE870B07029BFCDB2DCE28D959F2815B16F81798
    Gy = 0x483ada7726a3c4655da4fbfc0e1108a8fd17b448a68554199c47d08ffb10d4b8
    
    # 4. n (Order): 曲线的阶
    # 它代表从基点 G 开始在曲线上不断“跳跃”，总共能产生多少个不同的有效坐标点。
    # 这个 n 值极其重要：它是比特币私钥的最大取值范围！
    # 你的私钥必须是一个在 [1, n-1] 之间的整数。
    n = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141
    
    # 实例化椭圆曲线方程对象
    curve = Curve(p, a, b)
    # 将基点的坐标映射到这条曲线上
    G = Point(curve, Gx, Gy)
    # 创建完整的生成器（捆绑了基点和可取私钥的最大范围 n）
    gen = Generator(G, n)
    
    return gen

# -----------------------------------------------------------------------------
# 创建一个可供其他模块导入的全局对象
# 其他文件只需要导入这个 BITCOIN，就可以获取比特币底层的所有数学参数
BITCOIN = Coin(bitcoin_gen())