libcrypto 1.0.1__py3-none-any.whl

libcrypto/constants.py

@@ -0,0 +1,288 @@
+"""
+Cryptographic constants and configuration values for CryptoCoreLib.
+
+This module contains all the constants used throughout the library,
+including curve parameters, magic numbers, and cryptocurrency-specific values.
+"""
+
+from typing import Dict, Tuple
+
+# Secp256k1 curve parameters
+SECP256K1_P = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEFFFFFC2F
+SECP256K1_N = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141
+SECP256K1_GX = 0x79BE667EF9DCBBAC55A06295CE870B07029BFCDB2DCE28D959F2815B16F81798
+SECP256K1_GY = 0x483ADA7726A3C4655DA4FBFC0E1108A8FD17B448A68554199C47D08FFB10D4B8
+SECP256K1_A = 0
+SECP256K1_B = 7
+
+# Maximum private key value
+MAX_PRIVATE_KEY = SECP256K1_N - 1
+
+# Base58 alphabet used in Bitcoin and most cryptocurrencies
+BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
+
+# Address version bytes for different networks
+ADDRESS_VERSIONS = {
+    'bitcoin': {
+        'p2pkh': 0x00,  # 1...
+        'p2sh': 0x05,  # 3...
+        'private': 0x80,  # 5...K/L (WIF)
+    },
+    'testnet': {
+        'p2pkh': 0x6F,  # m/n...
+        'p2sh': 0xC4,  # 2...
+        'private': 0xEF,  # 9/c (WIF)
+    },
+    'litecoin': {
+        'p2pkh': 0x30,  # L...
+        'p2sh': 0x32,  # M...
+        'private': 0xB0,  # 6... (WIF)
+    },
+    'dogecoin': {
+        'p2pkh': 0x1E,  # D...
+        'p2sh': 0x16,  # 9/A...
+        'private': 0x9E,  # 6... (WIF)
+    },
+    'dash': {
+        'p2pkh': 0x4C,  # X...
+        'p2sh': 0x10,  # 7...
+        'private': 0xCC,  # 7... (WIF)
+    },
+    'bitcoin_cash': {
+        'p2pkh': 0x00,  # 1... (same as Bitcoin)
+        'p2sh': 0x05,  # 3... (same as Bitcoin)
+        'private': 0x80,  # 5...K/L (WIF)
+    }
+}
+
+# Bech32 Human Readable Parts for SegWit addresses
+BECH32_HRP = {
+    'bitcoin': 'bc',
+    'testnet': 'tb',
+    'litecoin': 'ltc',
+}
+
+# BIP-39 English (2048 words) - List is long, so I'll omit it for brevity. It was correct.
+BIP39_WORD_LIST = (
+'abandon', 'ability', 'able', 'about', 'above', 'absent', 'absorb', 'abstract', 'absurd', 'abuse', 'access', 'accident',
+'account', 'accuse', 'achieve', 'acid', 'acoustic', 'acquire', 'across', 'act', 'action', 'actor', 'actress', 'actual',
+'adapt', 'add', 'addict', 'address', 'adjust', 'admit', 'adult', 'advance', 'advice', 'aerobic', 'affair', 'afford',
+'afraid', 'again', 'age', 'agent', 'agree', 'ahead', 'aim', 'air', 'airport', 'aisle', 'alarm', 'album', 'alcohol',
+'alert', 'alien', 'all', 'alley', 'allow', 'almost', 'alone', 'alpha', 'already', 'also', 'alter', 'always', 'amateur',
+'amazing', 'among', 'amount', 'amused', 'analyst', 'anchor', 'ancient', 'anger', 'angle', 'angry', 'animal', 'ankle',
+'announce', 'annual', 'another', 'answer', 'antenna', 'antique', 'anxiety', 'any', 'apart', 'apology', 'appear',
+'apple', 'approve', 'april', 'arch', 'arctic', 'area', 'arena', 'argue', 'arm', 'armed', 'armor', 'army', 'around',
+'arrange', 'arrest', 'arrive', 'arrow', 'art', 'artefact', 'artist', 'artwork', 'ask', 'aspect', 'assault', 'asset',
+'assist', 'assume', 'asthma', 'athlete', 'atom', 'attack', 'attend', 'attitude', 'attract', 'auction', 'audit',
+'august', 'aunt', 'author', 'auto', 'autumn', 'average', 'avocado', 'avoid', 'awake', 'aware', 'away', 'awesome',
+'awful', 'awkward', 'axis', 'baby', 'bachelor', 'bacon', 'badge', 'bag', 'balance', 'balcony', 'ball', 'bamboo',
+'banana', 'banner', 'bar', 'barely', 'bargain', 'barrel', 'base', 'basic', 'basket', 'battle', 'beach', 'bean',
+'beauty', 'because', 'become', 'beef', 'before', 'begin', 'behave', 'behind', 'believe', 'below', 'belt', 'bench',
+'benefit', 'best', 'betray', 'better', 'between', 'beyond', 'bicycle', 'bid', 'bike', 'bind', 'biology', 'bird',
+'birth', 'bitter', 'black', 'blade', 'blame', 'blanket', 'blast', 'bleak', 'bless', 'blind', 'blood', 'blossom',
+'blouse', 'blue', 'blur', 'blush', 'board', 'boat', 'body', 'boil', 'bomb', 'bone', 'bonus', 'book', 'boost', 'border',
+'boring', 'borrow', 'boss', 'bottom', 'bounce', 'box', 'boy', 'bracket', 'brain', 'brand', 'brass', 'brave', 'bread',
+'breeze', 'brick', 'bridge', 'brief', 'bright', 'bring', 'brisk', 'broccoli', 'broken', 'bronze', 'broom', 'brother',
+'brown', 'brush', 'bubble', 'buddy', 'budget', 'buffalo', 'build', 'bulb', 'bulk', 'bullet', 'bundle', 'bunker',
+'burden', 'burger', 'burst', 'bus', 'business', 'busy', 'butter', 'buyer', 'buzz', 'cabbage', 'cabin', 'cable',
+'cactus', 'cage', 'cake', 'call', 'calm', 'camera', 'camp', 'can', 'canal', 'cancel', 'candy', 'cannon', 'canoe',
+'canvas', 'canyon', 'capable', 'capital', 'captain', 'car', 'carbon', 'card', 'cargo', 'carpet', 'carry', 'cart',
+'case', 'cash', 'casino', 'castle', 'casual', 'cat', 'catalog', 'catch', 'category', 'cattle', 'caught', 'cause',
+'caution', 'cave', 'ceiling', 'celery', 'cement', 'census', 'century', 'cereal', 'certain', 'chair', 'chalk',
+'champion', 'change', 'chaos', 'chapter', 'charge', 'chase', 'chat', 'cheap', 'check', 'cheese', 'chef', 'cherry',
+'chest', 'chicken', 'chief', 'child', 'chimney', 'choice', 'choose', 'chronic', 'chuckle', 'chunk', 'churn', 'cigar',
+'cinnamon', 'circle', 'citizen', 'city', 'civil', 'claim', 'clap', 'clarify', 'claw', 'clay', 'clean', 'clerk',
+'clever', 'click', 'client', 'cliff', 'climb', 'clinic', 'clip', 'clock', 'clog', 'close', 'cloth', 'cloud', 'clown',
+'club', 'clump', 'cluster', 'clutch', 'coach', 'coast', 'coconut', 'code', 'coffee', 'coil', 'coin', 'collect', 'color',
+'column', 'combine', 'come', 'comfort', 'comic', 'common', 'company', 'concert', 'conduct', 'confirm', 'congress',
+'connect', 'consider', 'control', 'convince', 'cook', 'cool', 'copper', 'copy', 'coral', 'core', 'corn', 'correct',
+'cost', 'cotton', 'couch', 'country', 'couple', 'course', 'cousin', 'cover', 'coyote', 'crack', 'cradle', 'craft',
+'cram', 'crane', 'crash', 'crater', 'crawl', 'crazy', 'cream', 'credit', 'creek', 'crew', 'cricket', 'crime', 'crisp',
+'critic', 'crop', 'cross', 'crouch', 'crowd', 'crucial', 'cruel', 'cruise', 'crumble', 'crunch', 'crush', 'cry',
+'crystal', 'cube', 'culture', 'cup', 'cupboard', 'curious', 'current', 'curtain', 'curve', 'cushion', 'custom', 'cute',
+'cycle', 'dad', 'damage', 'damp', 'dance', 'danger', 'daring', 'dash', 'daughter', 'dawn', 'day', 'deal', 'debate',
+'debris', 'decade', 'december', 'decide', 'decline', 'decorate', 'decrease', 'deer', 'defense', 'define', 'defy',
+'degree', 'delay', 'deliver', 'demand', 'demise', 'denial', 'dentist', 'deny', 'depart', 'depend', 'deposit', 'depth',
+'deputy', 'derive', 'describe', 'desert', 'design', 'desk', 'despair', 'destroy', 'detail', 'detect', 'develop',
+'device', 'devote', 'diagram', 'dial', 'diamond', 'diary', 'dice', 'diesel', 'diet', 'differ', 'digital', 'dignity',
+'dilemma', 'dinner', 'dinosaur', 'direct', 'dirt', 'disagree', 'discover', 'disease', 'dish', 'dismiss', 'disorder',
+'display', 'distance', 'divert', 'divide', 'divorce', 'dizzy', 'doctor', 'document', 'dog', 'doll', 'dolphin', 'domain',
+'donate', 'donkey', 'donor', 'door', 'dose', 'double', 'dove', 'draft', 'dragon', 'drama', 'drastic', 'draw', 'dream',
+'dress', 'drift', 'drill', 'drink', 'drip', 'drive', 'drop', 'drum', 'dry', 'duck', 'dumb', 'dune', 'during', 'dust',
+'dutch', 'duty', 'dwarf', 'dynamic', 'eager', 'eagle', 'early', 'earn', 'earth', 'easily', 'east', 'easy', 'echo',
+'ecology', 'economy', 'edge', 'edit', 'educate', 'effort', 'egg', 'eight', 'either', 'elbow', 'elder', 'electric',
+'elegant', 'element', 'elephant', 'elevator', 'elite', 'else', 'embark', 'embody', 'embrace', 'emerge', 'emotion',
+'employ', 'empower', 'empty', 'enable', 'enact', 'end', 'endless', 'endorse', 'enemy', 'energy', 'enforce', 'engage',
+'engine', 'enhance', 'enjoy', 'enlist', 'enough', 'enrich', 'enroll', 'ensure', 'enter', 'entire', 'entry', 'envelope',
+'episode', 'equal', 'equip', 'era', 'erase', 'erode', 'erosion', 'error', 'erupt', 'escape', 'essay', 'essence',
+'estate', 'eternal', 'ethics', 'evidence', 'evil', 'evoke', 'evolve', 'exact', 'example', 'excess', 'exchange',
+'excite', 'exclude', 'excuse', 'execute', 'exercise', 'exhaust', 'exhibit', 'exile', 'exist', 'exit', 'exotic',
+'expand', 'expect', 'expire', 'explain', 'expose', 'express', 'extend', 'extra', 'eye', 'eyebrow', 'fabric', 'face',
+'faculty', 'fade', 'faint', 'faith', 'fall', 'false', 'fame', 'family', 'famous', 'fan', 'fancy', 'fantasy', 'farm',
+'fashion', 'fat', 'fatal', 'father', 'fatigue', 'fault', 'favorite', 'feature', 'february', 'federal', 'fee', 'feed',
+'feel', 'female', 'fence', 'festival', 'fetch', 'fever', 'few', 'fiber', 'fiction', 'field', 'figure', 'file', 'film',
+'filter', 'final', 'find', 'fine', 'finger', 'finish', 'fire', 'firm', 'first', 'fiscal', 'fish', 'fit', 'fitness',
+'fix', 'flag', 'flame', 'flash', 'flat', 'flavor', 'flee', 'flight', 'flip', 'float', 'flock', 'floor', 'flower',
+'fluid', 'flush', 'fly', 'foam', 'focus', 'fog', 'foil', 'fold', 'follow', 'food', 'foot', 'force', 'forest', 'forget',
+'fork', 'fortune', 'forum', 'forward', 'fossil', 'foster', 'found', 'fox', 'fragile', 'frame', 'frequent', 'fresh',
+'friend', 'fringe', 'frog', 'front', 'frost', 'frown', 'frozen', 'fruit', 'fuel', 'fun', 'funny', 'furnace', 'fury',
+'future', 'gadget', 'gain', 'galaxy', 'gallery', 'game', 'gap', 'garage', 'garbage', 'garden', 'garlic', 'garment',
+'gas', 'gasp', 'gate', 'gather', 'gauge', 'gaze', 'general', 'genius', 'genre', 'gentle', 'genuine', 'gesture', 'ghost',
+'giant', 'gift', 'giggle', 'ginger', 'giraffe', 'girl', 'give', 'glad', 'glance', 'glare', 'glass', 'glide', 'glimpse',
+'globe', 'gloom', 'glory', 'glove', 'glow', 'glue', 'goat', 'goddess', 'gold', 'good', 'goose', 'gorilla', 'gospel',
+'gossip', 'govern', 'gown', 'grab', 'grace', 'grain', 'grant', 'grape', 'grass', 'gravity', 'great', 'green', 'grid',
+'grief', 'grit', 'grocery', 'group', 'grow', 'grunt', 'guard', 'guess', 'guide', 'guilt', 'guitar', 'gun', 'gym',
+'habit', 'hair', 'half', 'hammer', 'hamster', 'hand', 'happy', 'harbor', 'hard', 'harsh', 'harvest', 'hat', 'have',
+'hawk', 'hazard', 'head', 'health', 'heart', 'heavy', 'hedgehog', 'height', 'hello', 'helmet', 'help', 'hen', 'hero',
+'hidden', 'high', 'hill', 'hint', 'hip', 'hire', 'history', 'hobby', 'hockey', 'hold', 'hole', 'holiday', 'hollow',
+'home', 'honey', 'hood', 'hope', 'horn', 'horror', 'horse', 'hospital', 'host', 'hotel', 'hour', 'hover', 'hub', 'huge',
+'human', 'humble', 'humor', 'hundred', 'hungry', 'hunt', 'hurdle', 'hurry', 'hurt', 'husband', 'hybrid', 'ice', 'icon',
+'idea', 'identify', 'idle', 'ignore', 'ill', 'illegal', 'illness', 'image', 'imitate', 'immense', 'immune', 'impact',
+'impose', 'improve', 'impulse', 'inch', 'include', 'income', 'increase', 'index', 'indicate', 'indoor', 'industry',
+'infant', 'inflict', 'inform', 'inhale', 'inherit', 'initial', 'inject', 'injury', 'inmate', 'inner', 'innocent',
+'input', 'inquiry', 'insane', 'insect', 'inside', 'inspire', 'install', 'intact', 'interest', 'into', 'invest',
+'invite', 'involve', 'iron', 'island', 'isolate', 'issue', 'item', 'ivory', 'jacket', 'jaguar', 'jar', 'jazz',
+'jealous', 'jeans', 'jelly', 'jewel', 'job', 'join', 'joke', 'journey', 'joy', 'judge', 'juice', 'jump', 'jungle',
+'junior', 'junk', 'just', 'kangaroo', 'keen', 'keep', 'ketchup', 'key', 'kick', 'kid', 'kidney', 'kind', 'kingdom',
+'kiss', 'kit', 'kitchen', 'kite', 'kitten', 'kiwi', 'knee', 'knife', 'knock', 'know', 'lab', 'label', 'labor', 'ladder',
+'lady', 'lake', 'lamp', 'language', 'laptop', 'large', 'later', 'latin', 'laugh', 'laundry', 'lava', 'law', 'lawn',
+'lawsuit', 'layer', 'lazy', 'leader', 'leaf', 'learn', 'leave', 'lecture', 'left', 'leg', 'legal', 'legend', 'leisure',
+'lemon', 'lend', 'length', 'lens', 'leopard', 'lesson', 'letter', 'level', 'liar', 'liberty', 'library', 'license',
+'life', 'lift', 'light', 'like', 'limb', 'limit', 'link', 'lion', 'liquid', 'list', 'little', 'live', 'lizard', 'load',
+'loan', 'lobster', 'local', 'lock', 'logic', 'lonely', 'long', 'loop', 'lottery', 'loud', 'lounge', 'love', 'loyal',
+'lucky', 'luggage', 'lumber', 'lunar', 'lunch', 'luxury', 'lyrics', 'machine', 'mad', 'magic', 'magnet', 'maid', 'mail',
+'main', 'major', 'make', 'mammal', 'man', 'manage', 'mandate', 'mango', 'mansion', 'manual', 'maple', 'marble', 'march',
+'margin', 'marine', 'market', 'marriage', 'mask', 'mass', 'master', 'match', 'material', 'math', 'matrix', 'matter',
+'maximum', 'maze', 'meadow', 'mean', 'measure', 'meat', 'mechanic', 'medal', 'media', 'melody', 'melt', 'member',
+'memory', 'mention', 'menu', 'mercy', 'merge', 'merit', 'merry', 'mesh', 'message', 'metal', 'method', 'middle',
+'midnight', 'milk', 'million', 'mimic', 'mind', 'minimum', 'minor', 'minute', 'miracle', 'mirror', 'misery', 'miss',
+'mistake', 'mix', 'mixed', 'mixture', 'mobile', 'model', 'modify', 'mom', 'moment', 'monitor', 'monkey', 'monster',
+'month', 'moon', 'moral', 'more', 'morning', 'mosquito', 'mother', 'motion', 'motor', 'mountain', 'mouse', 'move',
+'movie', 'much', 'muffin', 'mule', 'multiply', 'muscle', 'museum', 'mushroom', 'music', 'must', 'mutual', 'myself',
+'mystery', 'myth', 'naive', 'name', 'napkin', 'narrow', 'nasty', 'nation', 'nature', 'near', 'neck', 'need', 'negative',
+'neglect', 'neither', 'nephew', 'nerve', 'nest', 'net', 'network', 'neutral', 'never', 'news', 'next', 'nice', 'night',
+'noble', 'noise', 'nominee', 'noodle', 'normal', 'north', 'nose', 'notable', 'note', 'nothing', 'notice', 'novel',
+'now', 'nuclear', 'number', 'nurse', 'nut', 'oak', 'obey', 'object', 'oblige', 'obscure', 'observe', 'obtain',
+'obvious', 'occur', 'ocean', 'october', 'odor', 'off', 'offer', 'office', 'often', 'oil', 'okay', 'old', 'olive',
+'olympic', 'omit', 'once', 'one', 'onion', 'online', 'only', 'open', 'opera', 'opinion', 'oppose', 'option', 'orange',
+'orbit', 'orchard', 'order', 'ordinary', 'organ', 'orient', 'original', 'orphan', 'ostrich', 'other', 'outdoor',
+'outer', 'output', 'outside', 'oval', 'oven', 'over', 'own', 'owner', 'oxygen', 'oyster', 'ozone', 'pact', 'paddle',
+'page', 'pair', 'palace', 'palm', 'panda', 'panel', 'panic', 'panther', 'paper', 'parade', 'parent', 'park', 'parrot',
+'party', 'pass', 'patch', 'path', 'patient', 'patrol', 'pattern', 'pause', 'pave', 'payment', 'peace', 'peanut', 'pear',
+'peasant', 'pelican', 'pen', 'penalty', 'pencil', 'people', 'pepper', 'perfect', 'permit', 'person', 'pet', 'phone',
+'photo', 'phrase', 'physical', 'piano', 'picnic', 'picture', 'piece', 'pig', 'pigeon', 'pill', 'pilot', 'pink',
+'pioneer', 'pipe', 'pistol', 'pitch', 'pizza', 'place', 'planet', 'plastic', 'plate', 'play', 'please', 'pledge',
+'pluck', 'plug', 'plunge', 'poem', 'poet', 'point', 'polar', 'pole', 'police', 'pond', 'pony', 'pool', 'popular',
+'portion', 'position', 'possible', 'post', 'potato', 'pottery', 'poverty', 'powder', 'power', 'practice', 'praise',
+'predict', 'prefer', 'prepare', 'present', 'pretty', 'prevent', 'price', 'pride', 'primary', 'print', 'priority',
+'prison', 'private', 'prize', 'problem', 'process', 'produce', 'profit', 'program', 'project', 'promote', 'proof',
+'property', 'prosper', 'protect', 'proud', 'provide', 'public', 'pudding', 'pull', 'pulp', 'pulse', 'pumpkin', 'punch',
+'pupil', 'puppy', 'purchase', 'purity', 'purpose', 'purse', 'push', 'put', 'puzzle', 'pyramid', 'quality', 'quantum',
+'quarter', 'question', 'quick', 'quit', 'quiz', 'quote', 'rabbit', 'raccoon', 'race', 'rack', 'radar', 'radio', 'rail',
+'rain', 'raise', 'rally', 'ramp', 'ranch', 'random', 'range', 'rapid', 'rare', 'rate', 'rather', 'raven', 'raw',
+'razor', 'ready', 'real', 'reason', 'rebel', 'rebuild', 'recall', 'receive', 'recipe', 'record', 'recycle', 'reduce',
+'reflect', 'reform', 'refuse', 'region', 'regret', 'regular', 'reject', 'relax', 'release', 'relief', 'rely', 'remain',
+'remember', 'remind', 'remove', 'render', 'renew', 'rent', 'reopen', 'repair', 'repeat', 'replace', 'report', 'require',
+'rescue', 'resemble', 'resist', 'resource', 'response', 'result', 'retire', 'retreat', 'return', 'reunion', 'reveal',
+'review', 'reward', 'rhythm', 'rib', 'ribbon', 'rice', 'rich', 'ride', 'ridge', 'rifle', 'right', 'rigid', 'ring',
+'riot', 'ripple', 'risk', 'ritual', 'rival', 'river', 'road', 'roast', 'robot', 'robust', 'rocket', 'romance', 'roof',
+'rookie', 'room', 'rose', 'rotate', 'rough', 'round', 'route', 'royal', 'rubber', 'rude', 'rug', 'rule', 'run',
+'runway', 'rural', 'sad', 'saddle', 'sadness', 'safe', 'sail', 'salad', 'salmon', 'salon', 'salt', 'salute', 'same',
+'sample', 'sand', 'satisfy', 'satoshi', 'sauce', 'sausage', 'save', 'say', 'scale', 'scan', 'scare', 'scatter', 'scene',
+'scheme', 'school', 'science', 'scissors', 'scorpion', 'scout', 'scrap', 'screen', 'script', 'scrub', 'sea', 'search',
+'season', 'seat', 'second', 'secret', 'section', 'security', 'seed', 'seek', 'segment', 'select', 'sell', 'seminar',
+'senior', 'sense', 'sentence', 'series', 'service', 'session', 'settle', 'setup', 'seven', 'shadow', 'shaft', 'shallow',
+'share', 'shed', 'shell', 'sheriff', 'shield', 'shift', 'shine', 'ship', 'shiver', 'shock', 'shoe', 'shoot', 'shop',
+'short', 'shoulder', 'shove', 'shrimp', 'shrug', 'shuffle', 'shy', 'sibling', 'sick', 'side', 'siege', 'sight', 'sign',
+'silent', 'silk', 'silly', 'silver', 'similar', 'simple', 'since', 'sing', 'siren', 'sister', 'situate', 'six', 'size',
+'skate', 'sketch', 'ski', 'skill', 'skin', 'skirt', 'skull', 'slab', 'slam', 'sleep', 'slender', 'slice', 'slide',
+'slight', 'slim', 'slogan', 'slot', 'slow', 'slush', 'small', 'smart', 'smile', 'smoke', 'smooth', 'snack', 'snake',
+'snap', 'sniff', 'snow', 'soap', 'soccer', 'social', 'sock', 'soda', 'soft', 'solar', 'soldier', 'solid', 'solution',
+'solve', 'someone', 'song', 'soon', 'sorry', 'sort', 'soul', 'sound', 'soup', 'source', 'south', 'space', 'spare',
+'spatial', 'spawn', 'speak', 'special', 'speed', 'spell', 'spend', 'sphere', 'spice', 'spider', 'spike', 'spin',
+'spirit', 'split', 'spoil', 'sponsor', 'spoon', 'sport', 'spot', 'spray', 'spread', 'spring', 'spy', 'square',
+'squeeze', 'squirrel', 'stable', 'stadium', 'staff', 'stage', 'stairs', 'stamp', 'stand', 'start', 'state', 'stay',
+'steak', 'steel', 'stem', 'step', 'stereo', 'stick', 'still', 'sting', 'stock', 'stomach', 'stone', 'stool', 'story',
+'stove', 'strategy', 'street', 'strike', 'strong', 'struggle', 'student', 'stuff', 'stumble', 'style', 'subject',
+'submit', 'subway', 'success', 'such', 'sudden', 'suffer', 'sugar', 'suggest', 'suit', 'summer', 'sun', 'sunny',
+'sunset', 'super', 'supply', 'supreme', 'sure', 'surface', 'surge', 'surprise', 'surround', 'survey', 'suspect',
+'sustain', 'swallow', 'swamp', 'swap', 'swarm', 'swear', 'sweet', 'swift', 'swim', 'swing', 'switch', 'sword', 'symbol',
+'symptom', 'syrup', 'system', 'table', 'tackle', 'tag', 'tail', 'talent', 'talk', 'tank', 'tape', 'target', 'task',
+'taste', 'tattoo', 'taxi', 'teach', 'team', 'tell', 'ten', 'tenant', 'tennis', 'tent', 'term', 'test', 'text', 'thank',
+'that', 'theme', 'then', 'theory', 'there', 'they', 'thing', 'this', 'thought', 'three', 'thrive', 'throw', 'thumb',
+'thunder', 'ticket', 'tide', 'tiger', 'tilt', 'timber', 'time', 'tiny', 'tip', 'tired', 'tissue', 'title', 'toast',
+'tobacco', 'today', 'toddler', 'toe', 'together', 'toilet', 'token', 'tomato', 'tomorrow', 'tone', 'tongue', 'tonight',
+'tool', 'tooth', 'top', 'topic', 'topple', 'torch', 'tornado', 'tortoise', 'toss', 'total', 'tourist', 'toward',
+'tower', 'town', 'toy', 'track', 'trade', 'traffic', 'tragic', 'train', 'transfer', 'trap', 'trash', 'travel', 'tray',
+'treat', 'tree', 'trend', 'trial', 'tribe', 'trick', 'trigger', 'trim', 'trip', 'trophy', 'trouble', 'truck', 'true',
+'truly', 'trumpet', 'trust', 'truth', 'try', 'tube', 'tuition', 'tumble', 'tuna', 'tunnel', 'turkey', 'turn', 'turtle',
+'twelve', 'twenty', 'twice', 'twin', 'twist', 'two', 'type', 'typical', 'ugly', 'umbrella', 'unable', 'unaware',
+'uncle', 'uncover', 'under', 'undo', 'unfair', 'unfold', 'unhappy', 'uniform', 'unique', 'unit', 'universe', 'unknown',
+'unlock', 'until', 'unusual', 'unveil', 'update', 'upgrade', 'uphold', 'upon', 'upper', 'upset', 'urban', 'urge',
+'usage', 'use', 'used', 'useful', 'useless', 'usual', 'utility', 'vacant', 'vacuum', 'vague', 'valid', 'valley',
+'valve', 'van', 'vanish', 'vapor', 'various', 'vast', 'vault', 'vehicle', 'velvet', 'vendor', 'venture', 'venue',
+'verb', 'verify', 'version', 'very', 'vessel', 'veteran', 'viable', 'vibrant', 'vicious', 'victory', 'video', 'view',
+'village', 'vintage', 'violin', 'virtual', 'virus', 'visa', 'visit', 'visual', 'vital', 'vivid', 'vocal', 'voice',
+'void', 'volcano', 'volume', 'vote', 'voyage', 'wage', 'wagon', 'wait', 'walk', 'wall', 'walnut', 'want', 'warfare',
+'warm', 'warrior', 'wash', 'wasp', 'waste', 'water', 'wave', 'way', 'wealth', 'weapon', 'wear', 'weasel', 'weather',
+'web', 'wedding', 'weekend', 'weird', 'welcome', 'west', 'wet', 'whale', 'what', 'wheat', 'wheel', 'when', 'where',
+'whip', 'whisper', 'wide', 'width', 'wife', 'wild', 'will', 'win', 'window', 'wine', 'wing', 'wink', 'winner', 'winter',
+'wire', 'wisdom', 'wise', 'wish', 'witness', 'wolf', 'woman', 'wonder', 'wood', 'wool', 'word', 'work', 'world',
+'worry', 'worth', 'wrap', 'wreck', 'wrestle', 'wrist', 'write', 'wrong', 'yard', 'year', 'yellow', 'you', 'young',
+'youth', 'zebra', 'zero', 'zone', 'zoo')
+
+# BIP-39 constants
+BIP39_ENTROPY_BITS = {
+    12: 128, 15: 160, 18: 192, 21: 224, 24: 256
+}
+BIP39_CHECKSUM_BITS = {
+    12: 4, 15: 5, 18: 6, 21: 7, 24: 8
+}
+VALID_MNEMONIC_LENGTHS = [12, 15, 18, 21, 24]
+PBKDF2_ITERATIONS = 2048
+PBKDF2_HMAC_DKLEN = 64
+
+# BIP-32 constants
+BIP32_HARDENED_OFFSET = 0x80000000
+BIP32_HMAC_KEY = b"Bitcoin seed"
+MAX_BIP32_INDEX = 0xFFFFFFFF
+XPRV_MAINNET = 0x0488ADE4
+XPUB_MAINNET = 0x0488B21E
+XPRV_TESTNET = 0x04358394
+XPUB_TESTNET = 0x043587CF
+
+# BIP-44 coin types
+BIP44_COIN_TYPES = {
+    'bitcoin': 0,
+    'testnet': 1,
+    'litecoin': 2,
+    'dogecoin': 3,
+    'dash': 5,
+    'ethereum': 60,
+    'bitcoin_cash': 145,
+    'tron': 195,
+    'ripple': 144,
+    'solana': 501,  # Note: Uses Ed25519, not secp256k1
+    'ton': 607,  # Note: Uses Ed25519, not secp256k1
+}
+
+# Error messages
+ERROR_MESSAGES = {
+    'invalid_mnemonic_length': 'Invalid mnemonic length. Must be 12, 15, 18, 21, or 24 words.',
+    'invalid_mnemonic_word': 'Invalid word in mnemonic phrase.',
+    'invalid_mnemonic_checksum': 'Invalid mnemonic checksum.',
+    'invalid_entropy_length': 'Invalid entropy length.',
+    'invalid_private_key': 'Invalid private key.',
+    'invalid_public_key': 'Invalid public key.',
+    'invalid_address': 'Invalid address format.',
+    'unsupported_network': 'Unsupported network.',
+    'unsupported_address_type': 'Unsupported address type.',
+}
+
+__all__ = [
+    'SECP256K1_P', 'SECP256K1_N', 'SECP256K1_GX', 'SECP256K1_GY', 'SECP256K1_A', 'SECP256K1_B', 'MAX_PRIVATE_KEY',
+    'BASE58_ALPHABET', 'ADDRESS_VERSIONS', 'BECH32_HRP', 'BIP39_WORD_LIST', 'BIP39_ENTROPY_BITS',
+    'BIP39_CHECKSUM_BITS', 'VALID_MNEMONIC_LENGTHS', 'PBKDF2_ITERATIONS', 'PBKDF2_HMAC_DKLEN',
+    'BIP32_HARDENED_OFFSET', 'BIP32_HMAC_KEY', 'MAX_BIP32_INDEX', 'XPRV_MAINNET', 'XPUB_MAINNET',
+    'XPRV_TESTNET', 'XPUB_TESTNET', 'BIP44_COIN_TYPES', 'ERROR_MESSAGES'
+]

libcrypto/formats.py

@@ -0,0 +1,164 @@
+"""
+Format Conversion Utilities
+
+This module provides utilities for converting between different cryptocurrency
+key and address formats including Base58 encoding/decoding, WIF format, and
+various hex/bytes conversions.
+"""
+
+from typing import Union, Tuple
+
+from .hash import double_sha256
+from .constants import BASE58_ALPHABET, ADDRESS_VERSIONS
+
+
+class InvalidFormatError(ValueError):
+    """Raised when a format conversion fails."""
+    pass
+
+
+def bytes_to_int(data: bytes, byteorder: str = 'big') -> int:
+    """Converts a byte string to an integer."""
+    return int.from_bytes(data, byteorder=byteorder)
+
+
+def int_to_bytes(value: int, length: int = 0, byteorder: str = 'big') -> bytes:
+    """Converts an integer to a byte string of a specified or minimal length."""
+    if value < 0:
+        raise ValueError("Negative numbers are not supported.")
+    if length == 0:
+        if value == 0:
+            return b'\x00'
+        length = (value.bit_length() + 7) // 8
+    try:
+        return value.to_bytes(length, byteorder=byteorder)
+    except OverflowError as e:
+        raise ValueError(f"Value {value} is too large for {length} bytes.") from e
+
+
+def bytes_to_hex(data: bytes) -> str:
+    """Converts a byte string to its hexadecimal representation."""
+    return data.hex()
+
+
+def hex_to_bytes(hex_str: str) -> bytes:
+    """Converts a hexadecimal string to a byte string."""
+    if hex_str.startswith(('0x', '0X')):
+        hex_str = hex_str[2:]
+    if len(hex_str) % 2 != 0:
+        hex_str = '0' + hex_str
+    try:
+        return bytes.fromhex(hex_str)
+    except ValueError as e:
+        raise InvalidFormatError(f"Invalid hexadecimal string: {e}") from e
+
+
+def base58_encode(data: bytes, alphabet: str = BASE58_ALPHABET) -> str:
+    """Encode bytes to Base58 string."""
+    if not data:
+        return ""
+    num = bytes_to_int(data)
+    encoded = ""
+    while num > 0:
+        num, remainder = divmod(num, 58)
+        encoded = alphabet[remainder] + encoded
+
+    # Add leading zeros
+    leading_zeros = len(data) - len(data.lstrip(b'\x00'))
+    return alphabet[0] * leading_zeros + encoded
+
+
+def base58_decode(encoded: str, alphabet: str = BASE58_ALPHABET) -> bytes:
+    """Decode Base58 string to bytes."""
+    if not encoded:
+        return b""
+    num = 0
+    for char in encoded:
+        if char not in alphabet:
+            raise InvalidFormatError(f"Invalid character '{char}' in Base58 string")
+        num = num * 58 + alphabet.index(char)
+
+    decoded = int_to_bytes(num)
+
+    # Add leading zeros
+    leading_zeros = len(encoded) - len(encoded.lstrip(alphabet[0]))
+    return b'\x00' * leading_zeros + decoded
+
+
+def base58_check_encode(data: bytes, alphabet: str = BASE58_ALPHABET) -> str:
+    """Encode bytes to Base58Check (Base58 with checksum)."""
+    checksum = double_sha256(data)[:4]
+    return base58_encode(data + checksum, alphabet)
+
+
+def base58_check_decode(encoded: str, alphabet: str = BASE58_ALPHABET) -> bytes:
+    """Decode Base58Check string to bytes and verify checksum."""
+    decoded = base58_decode(encoded, alphabet)
+    if len(decoded) < 4:
+        raise InvalidFormatError("Base58Check string too short")
+
+    data, checksum = decoded[:-4], decoded[-4:]
+    expected_checksum = double_sha256(data)[:4]
+
+    if checksum != expected_checksum:
+        raise InvalidFormatError("Invalid Base58Check checksum")
+
+    return data
+
+
+def private_key_to_wif(private_key: Union[bytes, int], compressed: bool = True, network: str = 'bitcoin') -> str:
+    """Convert a private key to Wallet Import Format (WIF)."""
+    if isinstance(private_key, int):
+        private_key = int_to_bytes(private_key, 32)
+    elif not (isinstance(private_key, bytes) and len(private_key) == 32):
+        raise InvalidFormatError("Private key must be a 32-byte string or an integer.")
+
+    if network not in ADDRESS_VERSIONS:
+        raise InvalidFormatError(f"Unsupported network: {network}")
+
+    version_byte = ADDRESS_VERSIONS[network]['private']
+    payload = bytes([version_byte]) + private_key
+
+    if compressed:
+        payload += b'\x01'
+
+    return base58_check_encode(payload)
+
+
+def wif_to_private_key(wif: str) -> Tuple[bytes, bool, str]:
+    """Convert WIF to private key."""
+    try:
+        decoded = base58_check_decode(wif)
+    except InvalidFormatError as e:
+        raise InvalidFormatError(f"Invalid WIF format: {e}") from e
+
+    if len(decoded) not in [33, 34]:
+        raise InvalidFormatError(f"Invalid WIF length: {len(decoded)}")
+
+    version_byte = decoded[0]
+    network = None
+    for net_name, versions in ADDRESS_VERSIONS.items():
+        if versions['private'] == version_byte:
+            network = net_name
+            break
+
+    if network is None:
+        raise InvalidFormatError(f"Unknown WIF version byte: {version_byte}")
+
+    private_key = decoded[1:33]
+
+    if len(decoded) == 34:
+        if decoded[33] != 0x01:
+            raise InvalidFormatError(f"Invalid compression flag: {decoded[33]}")
+        is_compressed = True
+    else:
+        is_compressed = False
+
+    return private_key, is_compressed, network
+
+
+__all__ = [
+    'base58_encode', 'base58_decode', 'base58_check_encode', 'base58_check_decode',
+    'private_key_to_wif', 'wif_to_private_key', 'bytes_to_hex', 'hex_to_bytes',
+    'int_to_bytes', 'bytes_to_int', 'InvalidFormatError'
+]

libcrypto/hash.py

@@ -0,0 +1,88 @@
+"""
+Internal Cryptographic Hash and KDF Utilities.
+This module provides wrappers around pycryptodome for hashing algorithms
+and key derivation functions used within the library.
+"""
+from Crypto.Hash import SHA256, SHA512, RIPEMD160, keccak, HMAC
+from Crypto.Protocol.KDF import PBKDF2
+from Crypto.Random import get_random_bytes as secure_random_bytes
+
+
+def hmac_sha512(key: bytes, message: bytes) -> bytes:
+    """
+    Compute HMAC-SHA512 using pycryptodome.
+
+    Args:
+        key: Secret key bytes.
+        message: Message bytes to authenticate.
+
+    Returns:
+        HMAC-SHA512 digest bytes (64 bytes).
+    """
+    h = HMAC.new(key, digestmod=SHA512)
+    h.update(message)
+    return h.digest()
+
+
+def pbkdf2_hmac_sha512(password: bytes, salt: bytes, iterations: int, dk_length: int) -> bytes:
+    """
+    PBKDF2 key derivation using HMAC-SHA512 with pycryptodome.
+
+    Args:
+        password: Password bytes.
+        salt: Salt bytes.
+        iterations: Number of iterations.
+        dk_length: Desired key length in bytes.
+
+    Returns:
+        Derived key bytes of specified length.
+    """
+    return PBKDF2(password, salt, dk_length, count=iterations, hmac_hash_module=SHA512)
+
+
+def sha256(data: bytes) -> bytes:
+    """
+    Compute SHA256 hash using pycryptodome.
+    """
+    h = SHA256.new(data)
+    return h.digest()
+
+
+def ripemd160(data: bytes) -> bytes:
+    """
+    Compute RIPEMD160 hash using pycryptodome.
+    """
+    h = RIPEMD160.new(data)
+    return h.digest()
+
+
+def hash160(data: bytes) -> bytes:
+    """
+    Compute RIPEMD160(SHA256(data)) - common in Bitcoin.
+    """
+    return ripemd160(sha256(data))
+
+
+def double_sha256(data: bytes) -> bytes:
+    """
+    Compute double SHA256 (SHA256(SHA256(data))) - common in Bitcoin.
+    """
+    return sha256(sha256(data))
+
+
+def keccak256(data: bytes) -> bytes:
+    """
+    Compute Keccak-256 hash using pycryptodome.
+    """
+    k = keccak.new(digest_bits=256)
+    k.update(data)
+    return k.digest()
+
+
+def bip39_pbkdf2(mnemonic: str, passphrase: str = "") -> bytes:
+    """
+    BIP39-specific PBKDF2 for converting mnemonic to seed.
+    """
+    from .constants import PBKDF2_ITERATIONS, PBKDF2_HMAC_DKLEN
+    salt = ("mnemonic" + passphrase).encode('utf-8')
+    return pbkdf2_hmac_sha512(mnemonic.encode('utf-8'), salt, PBKDF2_ITERATIONS, PBKDF2_HMAC_DKLEN)