zeldwallet 0.1.0

package/dist/src/types/index.d.ts

@@ -0,0 +1,245 @@
+/**
+ * ZeldWallet Type Definitions
+ */
+/** Bitcoin address types supported */
+export type AddressType = 'p2pkh' | 'p2sh-p2wpkh' | 'p2wpkh' | 'p2tr';
+/** Purpose for address derivation (WBIP compatible) */
+export type AddressPurpose = 'payment' | 'ordinals' | 'stacks';
+/** Network type */
+export type NetworkType = 'mainnet' | 'testnet';
+/** Derived address information */
+export interface DerivedAddress {
+    address: string;
+    publicKey: string;
+    path: string;
+    type: AddressType;
+}
+/** Full address info including purpose */
+export interface AddressInfo {
+    address: string;
+    publicKey: string;
+    purpose: AddressPurpose;
+    addressType: AddressType;
+    derivationPath: string;
+}
+/** Wallet implementation type (WBIP) */
+export type WalletImplementation = 'software' | 'ledger' | 'keystone';
+/** Bitcoin network identifiers (WBIP/sats-connect) */
+export type BitcoinNetworkName = 'Mainnet' | 'Testnet' | 'Testnet4' | 'Signet' | 'Regtest';
+export type StacksNetworkName = 'mainnet' | 'testnet';
+export type SparkNetworkName = 'mainnet' | 'regtest';
+/** getInfo response payload (WBIP002) */
+export interface GetInfoResult {
+    version: string;
+    platform?: 'web' | 'mobile';
+    methods?: string[];
+    supports: string[];
+}
+/** Network payload returned by WBIP getAddresses */
+export interface WBIPNetworkInfo {
+    bitcoin: {
+        name: BitcoinNetworkName;
+    };
+    stacks: {
+        name: StacksNetworkName;
+    };
+    spark: {
+        name: SparkNetworkName;
+    };
+}
+/** getAddresses response payload (WBIP005) */
+export interface WBIPAddressEntry {
+    address: string;
+    publicKey: string;
+    purpose: AddressPurpose;
+    addressType: AddressType;
+    walletType: WalletImplementation;
+}
+/**
+ * WBIP005 getAddresses response. Returned as an array for convenience while
+ * keeping the spec fields as properties on the array itself.
+ */
+export type WBIPAddressesResult = WBIPAddressEntry[] & {
+    addresses: WBIPAddressEntry[];
+    network: WBIPNetworkInfo;
+};
+/** Options for signing PSBT inputs */
+export interface SignInputOptions {
+    /** Index of the input to sign */
+    index: number;
+    /** Address to use for signing */
+    address?: string;
+    /** Optional explicit derivation path to bypass address lookups */
+    derivationPath?: string;
+    /** Optional Taproot merkle root (script-path signing not yet supported) */
+    tapMerkleRootHex?: string;
+    /** Optional Taproot leaf hash (script-path signing not yet supported) */
+    tapLeafHashHex?: string;
+    /** Sighash type */
+    sighashTypes?: number[];
+    /** Whether to finalize the input after signing */
+    finalize?: boolean;
+}
+/** PSBT signing options */
+export interface SignPsbtOptions {
+    /** PSBT in base64 format */
+    psbt: string;
+    /** Inputs to sign */
+    signInputs: SignInputOptions[];
+    /** Whether to broadcast after signing */
+    broadcast?: boolean;
+}
+/** Encrypted data structure stored in IndexedDB */
+export interface EncryptedData {
+    /** Versioned envelope for forward-compatible migrations */
+    version: number;
+    /** Initialization vector */
+    iv: Uint8Array;
+    /** Encrypted ciphertext (includes GCM tag) */
+    ciphertext: Uint8Array;
+}
+/** Stored key envelope for passwordless mode */
+export interface StoredKeyEnvelope {
+    /** Envelope version */
+    version: number;
+    /** Encoding format for the persisted key */
+    format: 'raw';
+    /** Raw key bytes (never exposed to callers) */
+    keyBytes: Uint8Array;
+}
+/** Storage metadata */
+export interface StorageMetadata {
+    /** Version of the storage format */
+    version: number;
+    /** Whether password protection is enabled */
+    hasPassword: boolean;
+    /** Whether a backup has been created at least once */
+    hasBackup?: boolean;
+    /** Timestamp of the most recent backup (ms since epoch) */
+    lastBackupAt?: number;
+    /** PBKDF2 iterations used for password-derived keys (for unlock/migration) */
+    pbkdf2Iterations?: number;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Last update timestamp */
+    updatedAt: number;
+}
+/** WBIP Provider registration options */
+export interface WBIPProviderOptions {
+    /** Unique identifier for the provider */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Icon URL or data URI */
+    icon: string;
+    /** Optional web URL for the provider */
+    webUrl?: string;
+}
+/** WBIP Provider descriptor (registered in window.wbip_providers) */
+export interface WBIPProviderDescriptor {
+    id: string;
+    name: string;
+    icon: string;
+    webUrl?: string;
+    methods: string[];
+}
+/** WBIP getAddresses request parameters */
+export interface GetAddressesParams {
+    purposes: AddressPurpose[];
+    message?: string;
+}
+/** WBIP signMessage request parameters */
+export interface SignMessageParams {
+    address: string;
+    message: string;
+    protocol?: 'ecdsa' | 'bip322-simple';
+}
+/** WBIP signPsbt request parameters */
+export interface SignPsbtParams {
+    psbt: string;
+    signInputs: Record<string, number[]>;
+    broadcast?: boolean;
+}
+/** WBIP sendTransfer request parameters */
+export interface SendTransferParams {
+    recipients: Array<{
+        address: string;
+        amount: number;
+    }>;
+}
+/** WBIP Error codes */
+export declare enum WBIPErrorCode {
+    /** User rejected the request */
+    USER_REJECTED = 4001,
+    /** Unauthorized - wallet not connected */
+    UNAUTHORIZED = 4100,
+    /** Unsupported method */
+    UNSUPPORTED_METHOD = 4200,
+    /** Disconnected from wallet */
+    DISCONNECTED = 4900,
+    /** Chain disconnected */
+    CHAIN_DISCONNECTED = 4901,
+    /** Method not found */
+    METHOD_NOT_FOUND = -32601,
+    /** Invalid params */
+    INVALID_PARAMS = -32602,
+    /** Internal error */
+    INTERNAL_ERROR = -32603
+}
+/** WBIP Error */
+export interface WBIPError {
+    code: WBIPErrorCode;
+    message: string;
+    data?: unknown;
+}
+/** Wallet event types */
+export type WalletEvent = 'lock' | 'unlock' | 'accountsChanged' | 'networkChanged';
+/** Event handler type */
+export type EventHandler<T = unknown> = (data: T) => void;
+/** Backup structure */
+export interface WalletBackup {
+    /** Backup format version */
+    version: number;
+    /** Encrypted mnemonic payload (base64) */
+    encrypted: string;
+    /** Creation timestamp */
+    createdAt: number;
+    /** Optional label */
+    label?: string;
+}
+/** Backup envelope for portable backups */
+export interface WalletBackupEnvelope {
+    version: number;
+    cipher: string;
+    kdf: {
+        name: string;
+        hash: string;
+        iterations: number;
+        salt: string;
+    };
+    iv: string;
+    ciphertext: string;
+    createdAt: number;
+    network?: 'mainnet' | 'testnet';
+    mac?: string;
+    macAlgo?: string;
+}
+/** Types of confirmation dialogs */
+export type ConfirmationType = 'connect' | 'sign_message' | 'sign_psbt' | 'send_transfer';
+/** Confirmation dialog data */
+export interface ConfirmationData {
+    type: ConfirmationType;
+    origin?: string;
+    message?: string;
+    psbt?: string;
+    amount?: number;
+    recipient?: string;
+}
+declare global {
+    interface Window {
+        wbip_providers?: WBIPProviderDescriptor[];
+        [key: string]: unknown;
+    }
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/Modal.d.ts

@@ -0,0 +1,19 @@
+import { ConfirmationData, ConfirmationType } from '../types';
+/**
+ * Lightweight modal-based confirmation UI for browser environments.
+ * Falls back to throwing when no DOM is available so callers can provide
+ * their own confirmation handler in SSR or native contexts.
+ */
+export declare class ConfirmationModal {
+    private container;
+    private keydownHandler;
+    show(type: ConfirmationType, data?: Partial<ConfirmationData>): Promise<boolean>;
+    /**
+     * Close the modal if it is open.
+     */
+    close(): void;
+    private buildSummary;
+    private getTitle;
+    private injectStyles;
+}
+//# sourceMappingURL=Modal.d.ts.map

package/dist/src/ui/Modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/ui/Modal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEnE;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,cAAc,CAAiD;IAEjE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IA2EtF;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,YAAY;IAiDpB,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,YAAY;CAiFrB"}

package/dist/src/unifiedWallet.d.ts

@@ -0,0 +1,29 @@
+import { AddressInfo, NetworkType, SignInputOptions } from './types';
+export type ExternalWalletSession = {
+    id: string;
+    name: string;
+    network: NetworkType;
+    addresses: AddressInfo[];
+    /**
+     * Sign an arbitrary message with the connected wallet.
+     */
+    signMessage: (message: string, address: string, protocol?: 'ecdsa' | 'bip322-simple') => Promise<string>;
+    /**
+     * Optional PSBT signing hook. Falls back to ZeldWallet when omitted.
+     */
+    signPsbt?: (psbtBase64: string, inputs: SignInputOptions[]) => Promise<string>;
+};
+declare class UnifiedWalletBridge {
+    private external?;
+    useExternal(session: ExternalWalletSession): void;
+    reset(): void;
+    isExternalActive(): boolean;
+    getActiveName(): string;
+    getNetwork(): NetworkType;
+    getAddresses(purposes: Array<'payment' | 'ordinals' | 'stacks'>): AddressInfo[];
+    signMessage(message: string, address: string, protocol?: 'ecdsa' | 'bip322-simple'): Promise<string>;
+    signPsbt(psbtBase64: string, inputs: SignInputOptions[]): Promise<string>;
+}
+export declare const UnifiedWallet: UnifiedWalletBridge;
+export type { UnifiedWalletBridge };
+//# sourceMappingURL=unifiedWallet.d.ts.map

package/dist/src/unifiedWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unifiedWallet.d.ts","sourceRoot":"","sources":["../../src/unifiedWallet.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE1E,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzG;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChF,CAAC;AAEF,cAAM,mBAAmB;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAwB;IAEzC,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAIjD,KAAK,IAAI,IAAI;IAIb,gBAAgB,IAAI,OAAO;IAI3B,aAAa,IAAI,MAAM;IAIvB,UAAU,IAAI,WAAW;IAIzB,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC,GAAG,WAAW,EAAE;IAOzE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,GAAG,eAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IAe7G,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAMhF;AAED,eAAO,MAAM,aAAa,qBAA4B,CAAC;AAEvD,YAAY,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/src/utils/crypto.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Crypto utilities shared across storage and backup helpers.
+ * Provides PBKDF2-based AES-GCM key derivation and simple
+ * password-based encryption/decryption helpers.
+ */
+/** Payload returned by password-based encryption helpers */
+export interface PasswordEncryptedPayload {
+    version: number;
+    salt: Uint8Array;
+    iv: Uint8Array;
+    ciphertext: Uint8Array;
+    /** Optional PBKDF2 iterations used during encryption (backward compatible) */
+    iterations?: number;
+}
+/**
+ * Compute an HMAC-SHA256 over the provided payload using a password-derived key.
+ */
+export declare function computeHmacSha256(payload: Uint8Array, password: string, salt: Uint8Array, iterationsOverride?: number): Promise<Uint8Array>;
+/**
+ * Constant-time comparison of two byte arrays.
+ */
+export declare function timingSafeEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Derive an AES-GCM key from a password and salt using PBKDF2.
+ */
+export declare function deriveAesKeyFromPassword(password: string, salt: Uint8Array, extractable?: boolean, usages?: KeyUsage[], iterationsOverride?: number): Promise<CryptoKey>;
+/**
+ * Encrypt arbitrary bytes with a password using PBKDF2 + AES-GCM.
+ * Returns the envelope with salt + iv + ciphertext for easy transport.
+ */
+export declare function encryptWithPassword(plaintext: Uint8Array, password: string, iterationsOverride?: number): Promise<PasswordEncryptedPayload>;
+/**
+ * Decrypt bytes produced by encryptWithPassword (salt + iv + ciphertext).
+ */
+export declare function decryptWithPassword(encrypted: PasswordEncryptedPayload | Uint8Array, password: string): Promise<Uint8Array>;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/src/utils/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../src/utils/crypto.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAgCD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,UAAU,CAAC,CAIrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAOrE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,WAAW,GAAE,OAAe,EAC5B,MAAM,GAAE,QAAQ,EAA2B,EAC3C,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,SAAS,CAAC,CAqBpB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CAiBnC;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,wBAAwB,GAAG,UAAU,EAChD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAiBrB"}

package/dist/src/utils/encoding.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Encoding Utilities
+ *
+ * Functions for converting between different data formats.
+ */
+/**
+ * Convert a hex string to Uint8Array
+ */
+export declare function hexToBytes(hex: string): Uint8Array;
+/**
+ * Convert a Uint8Array to hex string
+ */
+export declare function bytesToHex(bytes: Uint8Array): string;
+/**
+ * Convert a string to Uint8Array (UTF-8)
+ */
+export declare function stringToBytes(str: string): Uint8Array;
+/**
+ * Convert a Uint8Array to string (UTF-8)
+ */
+export declare function bytesToString(bytes: Uint8Array): string;
+/**
+ * Convert a Uint8Array to base64 string
+ */
+export declare function bytesToBase64(bytes: Uint8Array): string;
+/**
+ * Convert a base64 string to Uint8Array
+ */
+export declare function base64ToBytes(base64: string): Uint8Array;
+/**
+ * Concatenate multiple Uint8Arrays
+ */
+export declare function concatBytes(...arrays: Uint8Array[]): Uint8Array;
+/**
+ * Compare two Uint8Arrays for equality
+ */
+export declare function bytesEqual(a: Uint8Array, b: Uint8Array): boolean;
+/**
+ * Generate cryptographically secure random bytes
+ */
+export declare function randomBytes(length: number): Uint8Array;
+/**
+ * Best-effort zeroization of sensitive buffers.
+ */
+export declare function wipeBytes(bytes: Uint8Array): void;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/src/utils/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../../src/utils/encoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CASlD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAErD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAOxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAS/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAMhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAEtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAEjD"}

package/dist/src/utils/validation.d.ts

@@ -0,0 +1,42 @@
+import { AddressPurpose, AddressType, NetworkType } from '../types';
+/**
+ * Validate a BIP39 mnemonic phrase
+ */
+export declare function isValidMnemonic(mnemonic: string): boolean;
+/**
+ * Validate that a mnemonic has the correct number of words
+ */
+export declare function isValidMnemonicLength(mnemonic: string): boolean;
+/**
+ * Basic Bitcoin address format validation
+ * Note: This is a basic check, not cryptographic validation
+ */
+export declare function isValidBitcoinAddress(address: string, network?: NetworkType): boolean;
+/**
+ * Detect the address type from a Bitcoin address
+ */
+export declare function detectAddressType(address: string, network?: NetworkType): AddressType | null;
+/**
+ * Validate address purpose
+ */
+export declare function isValidAddressPurpose(purpose: string): purpose is AddressPurpose;
+/**
+ * Validate password strength
+ */
+export declare function validatePassword(password: string): {
+    valid: boolean;
+    message?: string;
+};
+/**
+ * Validate hex string
+ */
+export declare function isValidHex(str: string): boolean;
+/**
+ * Validate base64 string
+ */
+export declare function isValidBase64(str: string): boolean;
+/**
+ * Validate PSBT (basic format check)
+ */
+export declare function isValidPsbtBase64(psbt: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzE;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAuB,GAAG,OAAO,CA6BhG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAuB,GAAG,WAAW,GAAG,IAAI,CAgCvG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAEhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CASvF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASvD"}

package/dist/wasm/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "zeldhash-miner-wasm",
+  "type": "module",
+  "collaborators": [
+    "Ouziel Slama <ouziel@gmail.com>"
+  ],
+  "description": "WASM bindings for the Zeldhash miner with optional WebGPU acceleration",
+  "version": "0.2.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zeldhash/zeldhash-miner"
+  },
+  "files": [
+    "zeldhash_miner_wasm_bg.wasm",
+    "zeldhash_miner_wasm.js",
+    "zeldhash_miner_wasm.d.ts"
+  ],
+  "main": "zeldhash_miner_wasm.js",
+  "homepage": "https://github.com/zeldhash/zeldhash-miner",
+  "types": "zeldhash_miner_wasm.d.ts",
+  "sideEffects": [
+    "./snippets/*"
+  ],
+  "keywords": [
+    "bitcoin",
+    "mining",
+    "wasm",
+    "webgpu"
+  ]
+}

package/dist/wasm/zeldhash_miner_wasm.d.ts

@@ -0,0 +1,82 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export function build_mining_template(inputs: any, outputs: any, network: string, sats_per_vbyte: bigint, start_nonce: bigint, batch_size: number, distribution: any): any;
+
+export function build_psbt(inputs: any, outputs: any, network: string, sats_per_vbyte: bigint, nonce: bigint, distribution: any): string;
+
+export function calibrate_batch_size(): Promise<number>;
+
+export function compute_txid(tx_bytes: Uint8Array): string;
+
+export function init_gpu(): Promise<any>;
+
+export function init_panic_hook(): void;
+
+/**
+ * Dispatch a GPU batch and return the match with the smallest nonce (OP_RETURN value).
+ */
+export function mine_batch_gpu(tx_prefix: Uint8Array, tx_suffix: Uint8Array, start_nonce: bigint, batch_size: number, target_zeros: number, use_cbor_nonce: boolean): Promise<any>;
+
+export function mine_batch_wasm(tx_prefix: Uint8Array, tx_suffix: Uint8Array, start_nonce: bigint, batch_size: number, target_zeros: number, use_cbor_nonce: boolean): any;
+
+export function mine_range_gpu(inputs: any, outputs: any, network: string, sats_per_vbyte: bigint, range: any, target_zeros: number, distribution: any): Promise<any>;
+
+/**
+ * Mine across a nonce range, automatically splitting at byte-length boundaries.
+ */
+export function mine_range_wasm(inputs: any, outputs: any, network: string, sats_per_vbyte: bigint, range: any, target_zeros: number, distribution: any): any;
+
+export function validate_address(addr: string, network: string): any;
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+  readonly memory: WebAssembly.Memory;
+  readonly mine_batch_wasm: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number, h: number) => any;
+  readonly mine_range_wasm: (a: any, b: any, c: number, d: number, e: bigint, f: any, g: number, h: any) => any;
+  readonly validate_address: (a: number, b: number, c: number, d: number) => any;
+  readonly build_psbt: (a: any, b: any, c: number, d: number, e: bigint, f: bigint, g: any) => [number, number, number, number];
+  readonly build_mining_template: (a: any, b: any, c: number, d: number, e: bigint, f: bigint, g: number, h: any) => [number, number, number];
+  readonly compute_txid: (a: number, b: number) => [number, number];
+  readonly init_gpu: () => any;
+  readonly mine_batch_gpu: (a: number, b: number, c: number, d: number, e: bigint, f: number, g: number, h: number) => any;
+  readonly mine_range_gpu: (a: any, b: any, c: number, d: number, e: bigint, f: any, g: number, h: any) => any;
+  readonly calibrate_batch_size: () => any;
+  readonly init_panic_hook: () => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h4173f797cb68abd1: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__h08603745582b4e0f: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h1a38164a3a667135: (a: number, b: number, c: any) => void;
+  readonly wasm_bindgen__closure__destroy__h16b8b0f00158f31c: (a: number, b: number) => void;
+  readonly wasm_bindgen__convert__closures_____invoke__h2845bf56d21a7dac: (a: number, b: number, c: any, d: any) => void;
+  readonly __wbindgen_exn_store: (a: number) => void;
+  readonly __externref_table_alloc: () => number;
+  readonly __wbindgen_externrefs: WebAssembly.Table;
+  readonly __wbindgen_malloc: (a: number, b: number) => number;
+  readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+  readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+  readonly __externref_table_dealloc: (a: number) => void;
+  readonly __wbindgen_start: () => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+* Instantiates the given `module`, which can either be bytes or
+* a precompiled `WebAssembly.Module`.
+*
+* @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+*
+* @returns {InitOutput}
+*/
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+* If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+* for everything else, calls `WebAssembly.instantiate` directly.
+*
+* @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+*
+* @returns {Promise<InitOutput>}
+*/
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;