Add TypeScript type definitions for base58.js

Co-authored-by: ChALkeR <291301+ChALkeR@users.noreply.github.com>

Author: Copilot

.gitignore

@@ -3,3 +3,4 @@ node_modules
 coverage
 playground
 *.tgz
+package-lock.json

base58.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Implements base58 encoding as used in Bitcoin and other cryptocurrencies.
+ *
+ * Supports both standard base58 and XRP variant alphabets.
+ *
+ * ```js
+ * import { fromBase58, toBase58 } from '@exodus/bytes/base58.js'
+ * import { fromBase58xrp, toBase58xrp } from '@exodus/bytes/base58.js'
+ * ```
+ *
+ * @module @exodus/bytes/base58.js
+ */
+
+/// <reference types="node" />
+
+import type { OutputFormat, Uint8ArrayBuffer } from './array.js';
+
+/**
+ * Encode a `Uint8Array` to a base58 string
+ *
+ * Uses the standard Bitcoin base58 alphabet
+ *
+ * @param arr - The input bytes
+ * @returns The base58 encoded string
+ */
+export function toBase58(arr: Uint8ArrayBuffer): string;
+
+/**
+ * Decode a base58 string to bytes
+ *
+ * Uses the standard Bitcoin base58 alphabet
+ *
+ * @param string - The base58 encoded string
+ * @param format - Output format (default: 'uint8')
+ * @returns The decoded bytes
+ */
+export function fromBase58(string: string, format?: OutputFormat): Uint8ArrayBuffer;
+export function fromBase58(string: string, format: 'buffer'): Buffer;
+
+/**
+ * Encode a `Uint8Array` to a base58 string using XRP alphabet
+ *
+ * Uses the XRP variant base58 alphabet
+ *
+ * @param arr - The input bytes
+ * @returns The base58 encoded string
+ */
+export function toBase58xrp(arr: Uint8ArrayBuffer): string;
+
+/**
+ * Decode a base58 string to bytes using XRP alphabet
+ *
+ * Uses the XRP variant base58 alphabet
+ *
+ * @param string - The base58 encoded string
+ * @param format - Output format (default: 'uint8')
+ * @returns The decoded bytes
+ */
+export function fromBase58xrp(string: string, format?: OutputFormat): Uint8ArrayBuffer;
+export function fromBase58xrp(string: string, format: 'buffer'): Buffer;

package.json

@@ -84,6 +84,7 @@
     "/base32.js",
     "/base32.d.ts",
     "/base58.js",
+    "/base58.d.ts",
     "/base58check.js",
     "/base58check.node.js",
     "/base64.js",
@@ -132,7 +133,10 @@
       "types": "./base32.d.ts",
       "default": "./base32.js"
     },
-    "./base58.js": "./base58.js",
+    "./base58.js": {
+      "types": "./base58.d.ts",
+      "default": "./base58.js"
+    },
     "./base58check.js": {
       "node": "./base58check.node.js",
       "default": "./base58check.js"