@amadeus-protocol/sdk 1.0.0

package/dist/conversion.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Token Conversion Utilities
+ *
+ * This module provides functions for converting between atomic units
+ * and human-readable token amounts for the AMA token.
+ */
+/**
+ * Convert atomic AMA units to human-readable AMA amount
+ *
+ * @param atomicAma - Atomic units (as number or string)
+ * @returns Human-readable AMA amount
+ * @throws Error if the value is invalid
+ *
+ * @example
+ * ```ts
+ * const ama = fromAtomicAma(1000000000)  // Returns 1.0
+ * ```
+ */
+export declare function fromAtomicAma(atomicAma: number | string): number;
+/**
+ * Convert human-readable AMA amount to atomic units
+ *
+ * @param ama - Human-readable AMA amount
+ * @returns Atomic units
+ *
+ * @example
+ * ```ts
+ * const atomic = toAtomicAma(1.5)  // Returns 1500000000
+ * ```
+ */
+export declare function toAtomicAma(ama: number): number;
+//# sourceMappingURL=conversion.d.ts.map

package/dist/conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgBhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/conversion.js

@@ -0,0 +1,50 @@
+/**
+ * Token Conversion Utilities
+ *
+ * This module provides functions for converting between atomic units
+ * and human-readable token amounts for the AMA token.
+ */
+import { AMA_TOKEN_DECIMALS_MULTIPLIER } from './constants';
+/**
+ * Convert atomic AMA units to human-readable AMA amount
+ *
+ * @param atomicAma - Atomic units (as number or string)
+ * @returns Human-readable AMA amount
+ * @throws Error if the value is invalid
+ *
+ * @example
+ * ```ts
+ * const ama = fromAtomicAma(1000000000)  // Returns 1.0
+ * ```
+ */
+export function fromAtomicAma(atomicAma) {
+    const atomicAmaAmount = typeof atomicAma === 'string' ? parseFloat(atomicAma) : atomicAma;
+    if (isNaN(atomicAmaAmount) || atomicAmaAmount === 0) {
+        return 0;
+    }
+    if (atomicAmaAmount < 0) {
+        throw new Error('Negative value not allowed');
+    }
+    if (atomicAmaAmount < 1) {
+        throw new Error('Value is less than 1');
+    }
+    if (atomicAmaAmount > Number.MAX_SAFE_INTEGER) {
+        throw new Error('Value exceeds maximum safe integer');
+    }
+    return atomicAmaAmount / AMA_TOKEN_DECIMALS_MULTIPLIER;
+}
+/**
+ * Convert human-readable AMA amount to atomic units
+ *
+ * @param ama - Human-readable AMA amount
+ * @returns Atomic units
+ *
+ * @example
+ * ```ts
+ * const atomic = toAtomicAma(1.5)  // Returns 1500000000
+ * ```
+ */
+export function toAtomicAma(ama) {
+    return ama * AMA_TOKEN_DECIMALS_MULTIPLIER;
+}
+//# sourceMappingURL=conversion.js.map

package/dist/conversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../src/conversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,SAA0B;IACvD,MAAM,eAAe,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEzF,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,CAAA;IACT,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC9C,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACxC,CAAC;IACD,IAAI,eAAe,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACtD,CAAC;IACD,OAAO,eAAe,GAAG,6BAA6B,CAAA;AACvD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACtC,OAAO,GAAG,GAAG,6BAA6B,CAAA;AAC3C,CAAC"}

package/dist/crypto.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Cryptographic Utilities for Amadeus Protocol
+ *
+ * This module provides cryptographic functions for key generation and BLS12-381 operations
+ * used by the Amadeus protocol.
+ */
+import type { KeyPair } from './types';
+/**
+ * Reduce a 64-byte seed to a 32-byte private key compatible with BLS12-381
+ *
+ * @param bytes64 - 64-byte seed
+ * @returns 32-byte private key
+ * @throws Error if input is not exactly 64 bytes
+ */
+export declare function reduce512To256LE(bytes64: Uint8Array): Uint8Array;
+/**
+ * Derive a keypair from a 64-byte seed
+ *
+ * @param seed64 - 64-byte seed
+ * @returns Tuple of [publicKey, privateKey] as Uint8Array
+ *
+ * @example
+ * ```ts
+ * const [pk, sk] = seed64ToKeypair(seed64)
+ * ```
+ */
+export declare function seed64ToKeypair(seed64: Uint8Array): [Uint8Array, Uint8Array];
+/**
+ * Get public key from a 64-byte seed
+ *
+ * @param seed64 - 64-byte seed
+ * @returns Public key as Uint8Array
+ *
+ * @example
+ * ```ts
+ * const publicKey = getPublicKey(seed64)
+ * ```
+ */
+export declare function getPublicKey(seed64: Uint8Array): Uint8Array;
+/**
+ * Derive secret key and seed64 from a Base58 encoded seed
+ *
+ * @param base58Seed64 - Base58 encoded 64-byte seed
+ * @returns Object containing sk (secret key) and seed64
+ * @throws Error if the seed is invalid
+ *
+ * @example
+ * ```ts
+ * const { sk, seed64 } = deriveSkAndSeed64FromBase58Seed(base58Seed)
+ * ```
+ */
+export declare function deriveSkAndSeed64FromBase58Seed(base58Seed64: string): {
+    sk: Uint8Array;
+    seed64: Uint8Array;
+};
+/**
+ * Derive public key from a Base58 encoded seed
+ *
+ * @param base58Seed - Base58 encoded 64-byte seed
+ * @returns Base58 encoded public key
+ * @throws Error if the seed is invalid
+ *
+ * @example
+ * ```ts
+ * const publicKey = derivePublicKeyFromSeedBase58(base58Seed)
+ * ```
+ */
+export declare function derivePublicKeyFromSeedBase58(base58Seed: string): string;
+/**
+ * Generate a cryptographically secure random private key (64-byte seed)
+ *
+ * @returns 64-byte seed as Uint8Array
+ *
+ * @example
+ * ```ts
+ * const seed = generatePrivateKey()
+ * ```
+ */
+export declare function generatePrivateKey(): Uint8Array;
+/**
+ * Generate a new keypair
+ *
+ * @returns KeyPair object with Base58 encoded publicKey and privateKey
+ *
+ * @example
+ * ```ts
+ * const keypair = generateKeypair()
+ * console.log(keypair.publicKey)  // Base58 public key
+ * console.log(keypair.privateKey)  // Base58 private key (seed)
+ * ```
+ */
+export declare function generateKeypair(): KeyPair;
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAMtC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAsBhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAI5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAG3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG;IACtE,EAAE,EAAE,UAAU,CAAA;IACd,MAAM,EAAE,UAAU,CAAA;CAClB,CAWA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAUxE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAI/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAQzC"}

package/dist/crypto.js

@@ -0,0 +1,156 @@
+/**
+ * Cryptographic Utilities for Amadeus Protocol
+ *
+ * This module provides cryptographic functions for key generation and BLS12-381 operations
+ * used by the Amadeus protocol.
+ */
+import { bls12_381 as bls } from '@noble/curves/bls12-381';
+import { AMADEUS_SEED_BYTE_LENGTH } from './constants';
+import { toBase58, fromBase58 } from './encoding';
+// Constant: BLS12-381 group order
+const BLS12_381_ORDER = BigInt('0x73eda753299d7d483339d80809a1d80553bda402fffe5bfeffffffff00000001');
+// ============================================================================
+// BLS12-381 KEY OPERATIONS
+// ============================================================================
+/**
+ * Reduce a 64-byte seed to a 32-byte private key compatible with BLS12-381
+ *
+ * @param bytes64 - 64-byte seed
+ * @returns 32-byte private key
+ * @throws Error if input is not exactly 64 bytes
+ */
+export function reduce512To256LE(bytes64) {
+    if (!(bytes64 instanceof Uint8Array) || bytes64.length !== AMADEUS_SEED_BYTE_LENGTH) {
+        throw new Error('Expected 64-byte Uint8Array');
+    }
+    // Convert 64 bytes LE -> BigInt
+    let x = BigInt(0);
+    for (let i = 0; i < AMADEUS_SEED_BYTE_LENGTH; i++) {
+        x += BigInt(bytes64[i]) << (BigInt(8) * BigInt(i));
+    }
+    // Reduce mod the group order
+    x = x % BLS12_381_ORDER;
+    // Convert to 32-byte BIG-ENDIAN
+    const out = new Uint8Array(32);
+    for (let i = 31; i >= 0; i--) {
+        out[i] = Number(x & BigInt(0xff));
+        x >>= BigInt(8);
+    }
+    return out;
+}
+/**
+ * Derive a keypair from a 64-byte seed
+ *
+ * @param seed64 - 64-byte seed
+ * @returns Tuple of [publicKey, privateKey] as Uint8Array
+ *
+ * @example
+ * ```ts
+ * const [pk, sk] = seed64ToKeypair(seed64)
+ * ```
+ */
+export function seed64ToKeypair(seed64) {
+    const sk = reduce512To256LE(seed64);
+    const pk = bls.longSignatures.getPublicKey(sk).toBytes();
+    return [pk, sk];
+}
+/**
+ * Get public key from a 64-byte seed
+ *
+ * @param seed64 - 64-byte seed
+ * @returns Public key as Uint8Array
+ *
+ * @example
+ * ```ts
+ * const publicKey = getPublicKey(seed64)
+ * ```
+ */
+export function getPublicKey(seed64) {
+    const [pk] = seed64ToKeypair(seed64);
+    return pk;
+}
+/**
+ * Derive secret key and seed64 from a Base58 encoded seed
+ *
+ * @param base58Seed64 - Base58 encoded 64-byte seed
+ * @returns Object containing sk (secret key) and seed64
+ * @throws Error if the seed is invalid
+ *
+ * @example
+ * ```ts
+ * const { sk, seed64 } = deriveSkAndSeed64FromBase58Seed(base58Seed)
+ * ```
+ */
+export function deriveSkAndSeed64FromBase58Seed(base58Seed64) {
+    const seed64 = fromBase58(base58Seed64);
+    if (seed64.length !== AMADEUS_SEED_BYTE_LENGTH) {
+        throw new Error('Invalid base58Seed: Must be 64 bytes (512 bits) long.');
+    }
+    const sk = reduce512To256LE(seed64);
+    return {
+        sk,
+        seed64
+    };
+}
+/**
+ * Derive public key from a Base58 encoded seed
+ *
+ * @param base58Seed - Base58 encoded 64-byte seed
+ * @returns Base58 encoded public key
+ * @throws Error if the seed is invalid
+ *
+ * @example
+ * ```ts
+ * const publicKey = derivePublicKeyFromSeedBase58(base58Seed)
+ * ```
+ */
+export function derivePublicKeyFromSeedBase58(base58Seed) {
+    if (!base58Seed) {
+        throw new Error('Invalid base58Seed: Must be a non-empty base58 string.');
+    }
+    const seed64 = fromBase58(base58Seed);
+    if (seed64.length !== AMADEUS_SEED_BYTE_LENGTH) {
+        throw new Error('Invalid base58Seed: Must be 64 bytes (512 bits) long.');
+    }
+    const publicKey = getPublicKey(seed64);
+    return toBase58(publicKey);
+}
+// ============================================================================
+// KEY GENERATION
+// ============================================================================
+/**
+ * Generate a cryptographically secure random private key (64-byte seed)
+ *
+ * @returns 64-byte seed as Uint8Array
+ *
+ * @example
+ * ```ts
+ * const seed = generatePrivateKey()
+ * ```
+ */
+export function generatePrivateKey() {
+    const seed = new Uint8Array(AMADEUS_SEED_BYTE_LENGTH);
+    crypto.getRandomValues(seed);
+    return seed;
+}
+/**
+ * Generate a new keypair
+ *
+ * @returns KeyPair object with Base58 encoded publicKey and privateKey
+ *
+ * @example
+ * ```ts
+ * const keypair = generateKeypair()
+ * console.log(keypair.publicKey)  // Base58 public key
+ * console.log(keypair.privateKey)  // Base58 private key (seed)
+ * ```
+ */
+export function generateKeypair() {
+    const seed64 = generatePrivateKey();
+    const [pk] = seed64ToKeypair(seed64);
+    return {
+        publicKey: toBase58(pk),
+        privateKey: toBase58(seed64)
+    };
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,IAAI,GAAG,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEjD,kCAAkC;AAClC,MAAM,eAAe,GAAG,MAAM,CAAC,oEAAoE,CAAC,CAAA;AAIpG,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IACnD,IAAI,CAAC,CAAC,OAAO,YAAY,UAAU,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAC/C,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,wBAAwB,EAAE,CAAC,EAAE,EAAE,CAAC;QACnD,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IACnD,CAAC;IAED,6BAA6B;IAC7B,CAAC,GAAG,CAAC,GAAG,eAAe,CAAA;IAEvB,gCAAgC;IAChC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAA;IAC9B,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;QACjC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,OAAO,GAAG,CAAA;AACX,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,MAAkB;IACjD,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACnC,MAAM,EAAE,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;IACxD,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC9C,MAAM,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IACpC,OAAO,EAAE,CAAA;AACV,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,+BAA+B,CAAC,YAAoB;IAInE,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,CAAA;IACvC,IAAI,MAAM,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IACzE,CAAC;IACD,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAEnC,OAAO;QACN,EAAE;QACF,MAAM;KACN,CAAA;AACF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAAkB;IAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAC1E,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,wBAAwB,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IACzE,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;IACtC,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAA;AAC3B,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB;IACjC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,wBAAwB,CAAC,CAAA;IACrD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAC5B,OAAO,IAAI,CAAA;AACZ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe;IAC9B,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAA;IACnC,MAAM,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAEpC,OAAO;QACN,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;QACvB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC;KAC5B,CAAA;AACF,CAAC"}

package/dist/encoding.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Encoding/Decoding Utilities
+ *
+ * Provides general-purpose encoding and decoding functions for converting
+ * between different binary formats (Uint8Array, ArrayBuffer, Base64, Base58)
+ */
+/**
+ * Convert Uint8Array to Base64 string
+ *
+ * Uses Node.js Buffer when available (more efficient), falls back to btoa for browsers.
+ *
+ * @param bytes - Bytes to encode
+ * @returns Base64 encoded string
+ *
+ * @example
+ * ```ts
+ * const base64 = uint8ArrayToBase64(new Uint8Array([1, 2, 3]))
+ * ```
+ */
+export declare function uint8ArrayToBase64(bytes: Uint8Array): string;
+/**
+ * Convert Base64 string to Uint8Array
+ *
+ * Uses Node.js Buffer when available (more efficient), falls back to atob for browsers.
+ *
+ * @param base64 - Base64 encoded string
+ * @returns Decoded bytes
+ *
+ * @example
+ * ```ts
+ * const bytes = base64ToUint8Array('AQID')
+ * ```
+ */
+export declare function base64ToUint8Array(base64: string): Uint8Array;
+/**
+ * Convert ArrayBuffer to Base64 string
+ *
+ * @param buffer - Buffer to encode
+ * @returns Base64 encoded string
+ *
+ * @example
+ * ```ts
+ * const base64 = arrayBufferToBase64(new ArrayBuffer(8))
+ * ```
+ */
+export declare function arrayBufferToBase64(buffer: ArrayBuffer): string;
+/**
+ * Convert Base64 string to ArrayBuffer
+ *
+ * @param base64 - Base64 encoded string
+ * @returns Decoded buffer
+ *
+ * @example
+ * ```ts
+ * const buffer = base64ToArrayBuffer('AQID')
+ * ```
+ */
+export declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
+/**
+ * Convert Uint8Array to ArrayBuffer
+ *
+ * @param bytes - The Uint8Array to convert
+ * @returns ArrayBuffer
+ *
+ * @example
+ * ```ts
+ * const buffer = uint8ArrayToArrayBuffer(new Uint8Array([1, 2, 3]))
+ * ```
+ */
+export declare function uint8ArrayToArrayBuffer(bytes: Uint8Array): ArrayBuffer;
+/**
+ * Convert ArrayBuffer to Uint8Array
+ *
+ * @param buffer - The ArrayBuffer to convert
+ * @returns Uint8Array view of the buffer
+ *
+ * @example
+ * ```ts
+ * const bytes = arrayBufferToUint8Array(new ArrayBuffer(8))
+ * ```
+ */
+export declare function arrayBufferToUint8Array(buffer: ArrayBuffer): Uint8Array;
+/**
+ * Encode a Uint8Array to Base58 string
+ *
+ * @param buf - The bytes to encode
+ * @returns Base58 encoded string
+ *
+ * @example
+ * ```ts
+ * const encoded = toBase58(new Uint8Array([1, 2, 3]))
+ * ```
+ */
+export declare function toBase58(buf: Uint8Array): string;
+/**
+ * Decode a Base58 string to Uint8Array
+ *
+ * @param str - The Base58 string to decode
+ * @returns Decoded bytes as Uint8Array
+ * @throws Error if the string is invalid Base58
+ *
+ * @example
+ * ```ts
+ * const decoded = fromBase58('5Kd3N...')
+ * ```
+ */
+export declare function fromBase58(str: string): Uint8Array;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAW5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAY7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAI/D;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAKtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAEvE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAElD"}

package/dist/encoding.js

@@ -0,0 +1,165 @@
+/**
+ * Encoding/Decoding Utilities
+ *
+ * Provides general-purpose encoding and decoding functions for converting
+ * between different binary formats (Uint8Array, ArrayBuffer, Base64, Base58)
+ */
+import bs58 from 'bs58';
+// ============================================================================
+// Base64 Encoding/Decoding
+// ============================================================================
+/**
+ * Check if Buffer is available (Node.js environment)
+ */
+function isBufferAvailable() {
+    return typeof Buffer !== 'undefined' && Buffer.from !== undefined;
+}
+/**
+ * Convert Uint8Array to Base64 string
+ *
+ * Uses Node.js Buffer when available (more efficient), falls back to btoa for browsers.
+ *
+ * @param bytes - Bytes to encode
+ * @returns Base64 encoded string
+ *
+ * @example
+ * ```ts
+ * const base64 = uint8ArrayToBase64(new Uint8Array([1, 2, 3]))
+ * ```
+ */
+export function uint8ArrayToBase64(bytes) {
+    if (isBufferAvailable()) {
+        // Node.js: Use Buffer for better performance
+        return Buffer.from(bytes).toString('base64');
+    }
+    // Browser: Use btoa (available in Node.js 18+ and all modern browsers)
+    let binary = '';
+    for (let i = 0; i < bytes.byteLength; i++) {
+        binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+}
+/**
+ * Convert Base64 string to Uint8Array
+ *
+ * Uses Node.js Buffer when available (more efficient), falls back to atob for browsers.
+ *
+ * @param base64 - Base64 encoded string
+ * @returns Decoded bytes
+ *
+ * @example
+ * ```ts
+ * const bytes = base64ToUint8Array('AQID')
+ * ```
+ */
+export function base64ToUint8Array(base64) {
+    if (isBufferAvailable()) {
+        // Node.js: Use Buffer for better performance
+        return new Uint8Array(Buffer.from(base64, 'base64'));
+    }
+    // Browser: Use atob (available in Node.js 18+ and all modern browsers)
+    const binaryString = atob(base64);
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+        bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Convert ArrayBuffer to Base64 string
+ *
+ * @param buffer - Buffer to encode
+ * @returns Base64 encoded string
+ *
+ * @example
+ * ```ts
+ * const base64 = arrayBufferToBase64(new ArrayBuffer(8))
+ * ```
+ */
+export function arrayBufferToBase64(buffer) {
+    const bytes = new Uint8Array(buffer);
+    return uint8ArrayToBase64(bytes);
+}
+/**
+ * Convert Base64 string to ArrayBuffer
+ *
+ * @param base64 - Base64 encoded string
+ * @returns Decoded buffer
+ *
+ * @example
+ * ```ts
+ * const buffer = base64ToArrayBuffer('AQID')
+ * ```
+ */
+export function base64ToArrayBuffer(base64) {
+    const bytes = base64ToUint8Array(base64);
+    const buffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    return buffer;
+}
+// ============================================================================
+// ArrayBuffer/Uint8Array Conversions
+// ============================================================================
+/**
+ * Convert Uint8Array to ArrayBuffer
+ *
+ * @param bytes - The Uint8Array to convert
+ * @returns ArrayBuffer
+ *
+ * @example
+ * ```ts
+ * const buffer = uint8ArrayToArrayBuffer(new Uint8Array([1, 2, 3]))
+ * ```
+ */
+export function uint8ArrayToArrayBuffer(bytes) {
+    if (bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength) {
+        return bytes.buffer;
+    }
+    return bytes.slice().buffer;
+}
+/**
+ * Convert ArrayBuffer to Uint8Array
+ *
+ * @param buffer - The ArrayBuffer to convert
+ * @returns Uint8Array view of the buffer
+ *
+ * @example
+ * ```ts
+ * const bytes = arrayBufferToUint8Array(new ArrayBuffer(8))
+ * ```
+ */
+export function arrayBufferToUint8Array(buffer) {
+    return new Uint8Array(buffer);
+}
+// ============================================================================
+// Base58 Encoding/Decoding
+// ============================================================================
+/**
+ * Encode a Uint8Array to Base58 string
+ *
+ * @param buf - The bytes to encode
+ * @returns Base58 encoded string
+ *
+ * @example
+ * ```ts
+ * const encoded = toBase58(new Uint8Array([1, 2, 3]))
+ * ```
+ */
+export function toBase58(buf) {
+    return bs58.encode(buf);
+}
+/**
+ * Decode a Base58 string to Uint8Array
+ *
+ * @param str - The Base58 string to decode
+ * @returns Decoded bytes as Uint8Array
+ * @throws Error if the string is invalid Base58
+ *
+ * @example
+ * ```ts
+ * const decoded = fromBase58('5Kd3N...')
+ * ```
+ */
+export function fromBase58(str) {
+    return bs58.decode(str);
+}
+//# sourceMappingURL=encoding.js.map

package/dist/encoding.js.map

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