@1sat/utils 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -44,4 +44,5 @@ export declare function validIconFormat(icon: string): boolean;
  * Returns Error if validation fails, undefined if valid
  */
 export declare function validateSubTypeData(subType: 'collection' | 'collectionItem', subTypeData: CollectionItemSubTypeData | CollectionSubTypeData): Error | undefined;
+export { type WalletKeys, type KeyDerivationPaths, YOURS_WALLET_PATH, YOURS_ID_PATH, YOURS_ORD_PATH, RELAYX_ORD_PATH, RELAYX_ID_PATH, RELAYX_WALLET_PATH, RELAYX_SWEEP_PATH, TWETCH_WALLET_PATH, TWETCH_ORD_PATH, AYM_WALLET_PATH, AYM_ORD_PATH, wifToHex, wifToAddress, wifToPublicKey, deriveKeyFromMnemonic, getKeysFromMnemonicAndPaths, findKeysWithVanityOrdinal, generateMnemonic, isValidMnemonic, } from './keys';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EAEf,GAAG,EACH,MAAM,EACN,MAAM,aAAa,CAAA;AAUpB;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACZ,CAWA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuBzD;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAqBpE;AAMD,eAAO,MAAM,kBAAkB,OAE9B,CAAA;AACD,eAAO,MAAM,oBAAoB,OAA4C,CAAA;AAC7E,eAAO,MAAM,oBAAoB,OAAsC,CAAA;AACvE,eAAO,MAAM,6BAA6B,OAEzC,CAAA;AA2CD;;;GAGG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,eAAe,GACnB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA6BvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,YAAY,GAAG,gBAAgB,EACxC,WAAW,EAAE,yBAAyB,GAAG,qBAAqB,GAC5D,KAAK,GAAG,SAAS,CAgFnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EAEf,GAAG,EACH,MAAM,EACN,MAAM,aAAa,CAAA;AAUpB;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACZ,CAWA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuBzD;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAqBpE;AAMD,eAAO,MAAM,kBAAkB,OAE9B,CAAA;AACD,eAAO,MAAM,oBAAoB,OAA4C,CAAA;AAC7E,eAAO,MAAM,oBAAoB,OAAsC,CAAA;AACvE,eAAO,MAAM,6BAA6B,OAEzC,CAAA;AA2CD;;;GAGG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,eAAe,GACnB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CA6BvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,YAAY,GAAG,gBAAgB,EACxC,WAAW,EAAE,yBAAyB,GAAG,qBAAqB,GAC5D,KAAK,GAAG,SAAS,CAgFnB;AAMD,OAAO,EAEN,KAAK,UAAU,EACf,KAAK,kBAAkB,EAEvB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,YAAY,EAEZ,QAAQ,EACR,YAAY,EACZ,cAAc,EAEd,qBAAqB,EACrB,2BAA2B,EAC3B,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,GACf,MAAM,QAAQ,CAAA"}

package/dist/index.js

@@ -232,4 +232,14 @@ export function validateSubTypeData(subType, subTypeData) {
         return new Error('Invalid JSON data');
     }
 }
+// ============================================================================
+// Key Derivation Utilities
+// ============================================================================
+export { 
+// Derivation path constants
+YOURS_WALLET_PATH, YOURS_ID_PATH, YOURS_ORD_PATH, RELAYX_ORD_PATH, RELAYX_ID_PATH, RELAYX_WALLET_PATH, RELAYX_SWEEP_PATH, TWETCH_WALLET_PATH, TWETCH_ORD_PATH, AYM_WALLET_PATH, AYM_ORD_PATH, 
+// Conversion utilities
+wifToHex, wifToAddress, wifToPublicKey, 
+// Key derivation functions
+deriveKeyFromMnemonic, getKeysFromMnemonicAndPaths, findKeysWithVanityOrdinal, generateMnemonic, isValidMnemonic, } from './keys';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/keys.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Key derivation utilities for BSV wallets
+ *
+ * @example
+ * ```typescript
+ * import { getKeysFromMnemonicAndPaths, YOURS_WALLET_PATH, YOURS_ORD_PATH } from '@1sat/utils'
+ *
+ * const keys = getKeysFromMnemonicAndPaths(mnemonic, {
+ *   changeAddressPath: YOURS_WALLET_PATH,
+ *   ordAddressPath: YOURS_ORD_PATH,
+ * })
+ * ```
+ */
+import { PrivateKey } from '@bsv/sdk';
+/**
+ * Wallet keys in WIF format
+ * This is the standard format used by 1sat-web and compatible wallets
+ */
+export interface WalletKeys {
+    /** Payment private key (WIF) */
+    payPk: string;
+    /** Ordinal private key (WIF) */
+    ordPk: string;
+    /** Original mnemonic (optional, for backup) */
+    mnemonic?: string;
+    /** Derivation path for payment key */
+    changeAddressPath?: number | string;
+    /** Derivation path for ordinal key */
+    ordAddressPath?: number | string;
+    /** Identity private key (WIF, optional) */
+    identityPk?: string;
+    /** Derivation path for identity key */
+    identityAddressPath?: number | string;
+}
+/**
+ * Configuration for key derivation paths
+ */
+export interface KeyDerivationPaths {
+    /** Path for payment/change address (e.g., "m/44'/236'/0'/1/0") */
+    changeAddressPath: string;
+    /** Path for ordinal address (e.g., "m/44'/236'/1'/0/0") */
+    ordAddressPath: string;
+    /** Path for identity address (optional) */
+    identityAddressPath?: string;
+}
+/** Yours Wallet payment derivation path */
+export declare const YOURS_WALLET_PATH = "m/44'/236'/0'/1/0";
+/** Yours Wallet identity derivation path */
+export declare const YOURS_ID_PATH = "m/0'/236'/0'/0/0";
+/** Yours Wallet ordinal derivation path */
+export declare const YOURS_ORD_PATH = "m/44'/236'/1'/0/0";
+/** RelayX ordinal derivation path */
+export declare const RELAYX_ORD_PATH = "m/44'/236'/0'/2/0";
+/** RelayX identity path (same as Yours) */
+export declare const RELAYX_ID_PATH = "m/0'/236'/0'/0/0";
+/** RelayX payment path (same as Yours) */
+export declare const RELAYX_WALLET_PATH = "m/44'/236'/0'/1/0";
+/** RelayX sweep path */
+export declare const RELAYX_SWEEP_PATH = "m/44'/236'/0'/0/0";
+/** Twetch payment derivation path */
+export declare const TWETCH_WALLET_PATH = "m/0/0";
+/** Twetch ordinal path (same as Yours) */
+export declare const TWETCH_ORD_PATH = "m/44'/236'/1'/0/0";
+/** AYM payment derivation path */
+export declare const AYM_WALLET_PATH = "m/0/0";
+/** AYM ordinal derivation path (master key) */
+export declare const AYM_ORD_PATH = "m";
+/**
+ * Convert a WIF (Wallet Import Format) private key to hex format
+ * Useful for wallet-toolbox which uses rootKeyHex format
+ */
+export declare function wifToHex(wif: string): string;
+/**
+ * Get the public address from a WIF private key
+ */
+export declare function wifToAddress(wif: string): string;
+/**
+ * Get the public key (hex) from a WIF private key
+ */
+export declare function wifToPublicKey(wif: string): string;
+/**
+ * Derive a single private key from a mnemonic and path
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @param path - Derivation path (e.g., "m/44'/236'/0'/0/0")
+ * @returns PrivateKey object
+ */
+export declare function deriveKeyFromMnemonic(mnemonic: string, path: string): PrivateKey;
+/**
+ * Derive wallet keys from a mnemonic using specified paths
+ * Returns keys in WIF format for compatibility with 1sat-web
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @param paths - Derivation paths for each key type
+ * @returns WalletKeys with WIF-encoded private keys
+ */
+export declare function getKeysFromMnemonicAndPaths(mnemonic: string, paths: KeyDerivationPaths): WalletKeys;
+/**
+ * Find wallet keys from a mnemonic, searching for a "1s" vanity ordinal address
+ * This searches child keys until finding an ordinal address starting with "1s"
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @param timeoutMs - Maximum time to search (default: 100000ms)
+ * @returns Promise resolving to WalletKeys with the found vanity address
+ */
+export declare function findKeysWithVanityOrdinal(mnemonic: string, timeoutMs?: number): Promise<WalletKeys>;
+/**
+ * Generate a new BIP39 mnemonic phrase
+ *
+ * @param strength - Bits of entropy (128 = 12 words, 256 = 24 words)
+ * @returns Mnemonic phrase string
+ */
+export declare function generateMnemonic(strength?: 128 | 256): string;
+/**
+ * Validate a BIP39 mnemonic phrase
+ *
+ * @param mnemonic - Mnemonic phrase to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidMnemonic(mnemonic: string): boolean;
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAgB,UAAU,EAAE,MAAM,UAAU,CAAA;AAMnD;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACnC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAA;IACzB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAMD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,4CAA4C;AAC5C,eAAO,MAAM,aAAa,qBAAqB,CAAA;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,cAAc,sBAAsB,CAAA;AAEjD,qCAAqC;AACrC,eAAO,MAAM,eAAe,sBAAsB,CAAA;AAElD,2CAA2C;AAC3C,eAAO,MAAM,cAAc,qBAAgB,CAAA;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,sBAAoB,CAAA;AAEnD,wBAAwB;AACxB,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AAEpD,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,UAAU,CAAA;AAEzC,0CAA0C;AAC1C,eAAO,MAAM,eAAe,sBAAiB,CAAA;AAE7C,kCAAkC;AAClC,eAAO,MAAM,eAAe,UAAU,CAAA;AAEtC,+CAA+C;AAC/C,eAAO,MAAM,YAAY,MAAM,CAAA;AAM/B;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACV,UAAU,CAKZ;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kBAAkB,GACvB,UAAU,CA6CZ;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAS,GAChB,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,GAAG,GAAG,GAAS,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAOzD"}

package/dist/keys.js

@@ -0,0 +1,192 @@
+/**
+ * Key derivation utilities for BSV wallets
+ *
+ * @example
+ * ```typescript
+ * import { getKeysFromMnemonicAndPaths, YOURS_WALLET_PATH, YOURS_ORD_PATH } from '@1sat/utils'
+ *
+ * const keys = getKeysFromMnemonicAndPaths(mnemonic, {
+ *   changeAddressPath: YOURS_WALLET_PATH,
+ *   ordAddressPath: YOURS_ORD_PATH,
+ * })
+ * ```
+ */
+import { HD, Mnemonic, PrivateKey } from '@bsv/sdk';
+// ============================================================================
+// Standard Derivation Paths
+// ============================================================================
+/** Yours Wallet payment derivation path */
+export const YOURS_WALLET_PATH = "m/44'/236'/0'/1/0";
+/** Yours Wallet identity derivation path */
+export const YOURS_ID_PATH = "m/0'/236'/0'/0/0";
+/** Yours Wallet ordinal derivation path */
+export const YOURS_ORD_PATH = "m/44'/236'/1'/0/0";
+/** RelayX ordinal derivation path */
+export const RELAYX_ORD_PATH = "m/44'/236'/0'/2/0";
+/** RelayX identity path (same as Yours) */
+export const RELAYX_ID_PATH = YOURS_ID_PATH;
+/** RelayX payment path (same as Yours) */
+export const RELAYX_WALLET_PATH = YOURS_WALLET_PATH;
+/** RelayX sweep path */
+export const RELAYX_SWEEP_PATH = "m/44'/236'/0'/0/0";
+/** Twetch payment derivation path */
+export const TWETCH_WALLET_PATH = 'm/0/0';
+/** Twetch ordinal path (same as Yours) */
+export const TWETCH_ORD_PATH = YOURS_ORD_PATH;
+/** AYM payment derivation path */
+export const AYM_WALLET_PATH = 'm/0/0';
+/** AYM ordinal derivation path (master key) */
+export const AYM_ORD_PATH = 'm';
+// ============================================================================
+// Key Conversion Utilities
+// ============================================================================
+/**
+ * Convert a WIF (Wallet Import Format) private key to hex format
+ * Useful for wallet-toolbox which uses rootKeyHex format
+ */
+export function wifToHex(wif) {
+    return PrivateKey.fromWif(wif).toString();
+}
+/**
+ * Get the public address from a WIF private key
+ */
+export function wifToAddress(wif) {
+    return PrivateKey.fromWif(wif).toAddress();
+}
+/**
+ * Get the public key (hex) from a WIF private key
+ */
+export function wifToPublicKey(wif) {
+    return PrivateKey.fromWif(wif).toPublicKey().toString();
+}
+// ============================================================================
+// Key Derivation Functions
+// ============================================================================
+/**
+ * Derive a single private key from a mnemonic and path
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @param path - Derivation path (e.g., "m/44'/236'/0'/0/0")
+ * @returns PrivateKey object
+ */
+export function deriveKeyFromMnemonic(mnemonic, path) {
+    const seed = Mnemonic.fromString(mnemonic).toSeed();
+    const masterNode = HD.fromSeed(seed);
+    const derived = masterNode.derive(path);
+    return derived.privKey;
+}
+/**
+ * Derive wallet keys from a mnemonic using specified paths
+ * Returns keys in WIF format for compatibility with 1sat-web
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @param paths - Derivation paths for each key type
+ * @returns WalletKeys with WIF-encoded private keys
+ */
+export function getKeysFromMnemonicAndPaths(mnemonic, paths) {
+    const seed = Mnemonic.fromString(mnemonic).toSeed();
+    const masterNode = HD.fromSeed(seed);
+    // Normalize payment path
+    const changeAddressPath = paths.changeAddressPath.startsWith('m/')
+        ? paths.changeAddressPath
+        : `m/${paths.changeAddressPath}`;
+    const payPrivKey = masterNode.derive(changeAddressPath);
+    const payPk = payPrivKey.privKey.toWif();
+    // Normalize ordinal path
+    const ordAddressPath = paths.ordAddressPath.startsWith('m/')
+        ? paths.ordAddressPath
+        : `m/${paths.ordAddressPath}`;
+    const ordPrivKey = paths.ordAddressPath === 'm'
+        ? masterNode
+        : masterNode.derive(ordAddressPath);
+    const ordPk = ordPrivKey.privKey.toWif();
+    // Optional identity key
+    let identityPk;
+    if (paths.identityAddressPath) {
+        const identityPath = paths.identityAddressPath.startsWith('m/')
+            ? paths.identityAddressPath
+            : `m/${paths.identityAddressPath}`;
+        const identityPrivKey = masterNode.derive(identityPath);
+        identityPk = identityPrivKey.privKey.toWif();
+    }
+    const keys = {
+        mnemonic,
+        payPk,
+        ordPk,
+        changeAddressPath: paths.changeAddressPath,
+        ordAddressPath: paths.ordAddressPath,
+    };
+    if (identityPk) {
+        keys.identityPk = identityPk;
+        keys.identityAddressPath = paths.identityAddressPath;
+    }
+    return keys;
+}
+/**
+ * Find wallet keys from a mnemonic, searching for a "1s" vanity ordinal address
+ * This searches child keys until finding an ordinal address starting with "1s"
+ *
+ * @param mnemonic - BIP39 mnemonic phrase
+ * @param timeoutMs - Maximum time to search (default: 100000ms)
+ * @returns Promise resolving to WalletKeys with the found vanity address
+ */
+export function findKeysWithVanityOrdinal(mnemonic, timeoutMs = 100000) {
+    return new Promise((resolve, reject) => {
+        const seed = Mnemonic.fromString(mnemonic).toSeed();
+        const masterNode = HD.fromSeed(seed);
+        // Payment key is always at m/0
+        const payPrivKey = masterNode.derive('m/0');
+        const payPk = payPrivKey.privKey.toWif();
+        const startTime = Date.now();
+        let found = false;
+        const searchForAddress = (i) => {
+            if (Date.now() - startTime > timeoutMs && !found) {
+                reject(new Error('Timeout while searching for the desired address prefix.'));
+                return;
+            }
+            const ordPrivKey = masterNode.derive(`m/${i}`);
+            const ordAddress = ordPrivKey.privKey.toAddress();
+            if (ordAddress?.startsWith('1s')) {
+                found = true;
+                const ordPk = ordPrivKey.privKey.toWif();
+                resolve({
+                    mnemonic,
+                    payPk,
+                    ordPk,
+                    changeAddressPath: 0,
+                    ordAddressPath: i,
+                });
+                return;
+            }
+            // Continue searching on next tick
+            setTimeout(() => searchForAddress(i + 1), 0);
+        };
+        // Start searching from child key 1
+        searchForAddress(1);
+    });
+}
+/**
+ * Generate a new BIP39 mnemonic phrase
+ *
+ * @param strength - Bits of entropy (128 = 12 words, 256 = 24 words)
+ * @returns Mnemonic phrase string
+ */
+export function generateMnemonic(strength = 128) {
+    return Mnemonic.fromRandom(strength).toString();
+}
+/**
+ * Validate a BIP39 mnemonic phrase
+ *
+ * @param mnemonic - Mnemonic phrase to validate
+ * @returns true if valid, false otherwise
+ */
+export function isValidMnemonic(mnemonic) {
+    try {
+        Mnemonic.fromString(mnemonic);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAuCnD,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAA;AAEpD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAA;AAE/C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAA;AAEjD,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAA;AAElD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAA;AAE3C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAA;AAEnD,wBAAwB;AACxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAA;AAEpD,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAA;AAEzC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAA;AAE7C,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA;AAEtC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA;AAE/B,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IACnC,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACvC,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACzC,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAA;AACxD,CAAC;AAED,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACpC,QAAgB,EAChB,IAAY;IAEZ,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;IACnD,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACvC,OAAO,OAAO,CAAC,OAAO,CAAA;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CAC1C,QAAgB,EAChB,KAAyB;IAEzB,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;IACnD,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEpC,yBAAyB;IACzB,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC;QACjE,CAAC,CAAC,KAAK,CAAC,iBAAiB;QACzB,CAAC,CAAC,KAAK,KAAK,CAAC,iBAAiB,EAAE,CAAA;IACjC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAA;IACvD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IAExC,yBAAyB;IACzB,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3D,CAAC,CAAC,KAAK,CAAC,cAAc;QACtB,CAAC,CAAC,KAAK,KAAK,CAAC,cAAc,EAAE,CAAA;IAC9B,MAAM,UAAU,GACf,KAAK,CAAC,cAAc,KAAK,GAAG;QAC3B,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IAExC,wBAAwB;IACxB,IAAI,UAA8B,CAAA;IAClC,IAAI,KAAK,CAAC,mBAAmB,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,KAAK,CAAC,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAAC;YAC9D,CAAC,CAAC,KAAK,CAAC,mBAAmB;YAC3B,CAAC,CAAC,KAAK,KAAK,CAAC,mBAAmB,EAAE,CAAA;QACnC,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QACvD,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IAC7C,CAAC;IAED,MAAM,IAAI,GAAe;QACxB,QAAQ;QACR,KAAK;QACL,KAAK;QACL,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,cAAc,EAAE,KAAK,CAAC,cAAc;KACpC,CAAA;IAED,IAAI,UAAU,EAAE,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,CAAA;IACrD,CAAC;IAED,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACxC,QAAgB,EAChB,SAAS,GAAG,MAAM;IAElB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAA;QACnD,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAEpC,+BAA+B;QAC/B,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QAExC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,IAAI,KAAK,GAAG,KAAK,CAAA;QAEjB,MAAM,gBAAgB,GAAG,CAAC,CAAS,EAAE,EAAE;YACtC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;gBAClD,MAAM,CACL,IAAI,KAAK,CAAC,yDAAyD,CAAC,CACpE,CAAA;gBACD,OAAM;YACP,CAAC;YAED,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC9C,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,CAAA;YAEjD,IAAI,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,KAAK,GAAG,IAAI,CAAA;gBACZ,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;gBAExC,OAAO,CAAC;oBACP,QAAQ;oBACR,KAAK;oBACL,KAAK;oBACL,iBAAiB,EAAE,CAAC;oBACpB,cAAc,EAAE,CAAC;iBACjB,CAAC,CAAA;gBACF,OAAM;YACP,CAAC;YAED,kCAAkC;YAClC,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC7C,CAAC,CAAA;QAED,mCAAmC;QACnC,gBAAgB,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAsB,GAAG;IACzD,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACJ,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QAC7B,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@1sat/utils",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"description": "Utility functions for 1Sat Ordinals SDK",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -20,7 +20,7 @@
 	"keywords": ["1sat", "bsv", "ordinals", "utils"],
 	"license": "MIT",
 	"dependencies": {
-		"@1sat/types": "workspace:*",
+		"@1sat/types": "^0.0.2",
 		"image-meta": "^0.2.2"
 	},
 	"peerDependencies": {