@bitgo-beta/sdk-coin-flrp 1.0.1-beta.27 → 1.0.1-beta.271

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

@@ -1,214 +1,129 @@
-import { TransferableOutput } from '@flarenetwork/flarejs';
+import { Signature, TransferableOutput, Id } from '@flarenetwork/flarejs';
 import { BaseUtils, Entry } from '@bitgo-beta/sdk-core';
 import { FlareNetwork } from '@bitgo-beta/statics';
-import { DeprecatedOutput, DeprecatedTx, Output } from './iface';
+import { Buffer } from 'buffer';
+import { Output, DeprecatedTx } from './iface';
 export declare class Utils implements BaseUtils {
+    /**
+     * Check if addresses in wallet match UTXO output addresses
+     */
     includeIn(walletAddresses: string[], otxoOutputAddresses: string[]): boolean;
     /**
-     * Checks if it is a valid address no illegal characters
-     *
-     * @param {string} address - address to be validated
-     * @returns {boolean} - the validation result
+     * Validates a Flare address or array of addresses
+     * @param {string | string[]} address - address(es) to validate
+     * @returns {boolean} - validation result
      */
-    /** @inheritdoc */
     isValidAddress(address: string | string[]): boolean;
     private isValidAddressRegex;
     /**
-     * Checks if it is a valid blockId with length 66 including 0x
-     *
-     * @param {string} hash - blockId to be validated
-     * @returns {boolean} - the validation result
+     * Validates a block ID
+     * @param {string} hash - block ID to validate
+     * @returns {boolean} - validation result
      */
-    /** @inheritdoc */
     isValidBlockId(hash: string): boolean;
     /**
-     * Checks if the string is a valid protocol public key or
-     * extended public key.
-     *
-     * @param {string} pub - the  public key to be validated
-     * @returns {boolean} - the validation result
+     * Validates a public key
+     * @param {string} pub - public key to validate
+     * @returns {boolean} - validation result
      */
     isValidPublicKey(pub: string): boolean;
-    parseAddress: (pub: string) => Buffer;
     /**
-     * Returns whether or not the string is a valid protocol private key, or extended
-     * private key.
-     *
-     * The protocol key format is described in the @stacks/transactions npm package, in the
-     * createStacksPrivateKey function:
-     * https://github.com/blockstack/stacks.js/blob/master/packages/transactions/src/keys.ts#L125
-     *
-     * @param {string} prv - the private key (or extended private key) to be validated
-     * @returns {boolean} - the validation result
+     * Validates a private key
+     * @param {string} prv - private key to validate
+     * @returns {boolean} - validation result
      */
     isValidPrivateKey(prv: string): boolean;
     /**
-     * Returns whether or not the string is a composed of hex chars only
-     *
-     * @param {string} maybe - the  string to be validated
-     * @returns {boolean} - the validation result
-     */
-    allHexChars(maybe: string): boolean;
-    /**
-     * Lightweight Ethereum address validation
-     * Validates that an address is a 40-character hex string (optionally prefixed with 0x)
-     *
-     * @param {string} address - the Ethereum address to validate
-     * @returns {boolean} - true if valid Ethereum address format
-     */
-    isValidEthereumAddress(address: string): boolean;
-    /**
-     * Pick specific properties from an object (replaces lodash.pick)
-     *
-     * @param {T} obj - the source object
-     * @param {K[]} keys - array of property keys to pick
-     * @returns {Pick<T, K>} - new object with only the specified properties
+     * Checks if a string contains only hex characters
      */
-    pick<T, K extends keyof T>(obj: T, keys: K[]): Pick<T, K>;
+    allHexChars(str: string): boolean;
     /**
-     * Deep equality comparison (replaces lodash.isEqual)
-     *
-     * @param {unknown} a - first value to compare
-     * @param {unknown} b - second value to compare
-     * @returns {boolean} - true if values are deeply equal
-     */
-    isEqual(a: unknown, b: unknown): boolean;
-    /** @inheritdoc */
-    isValidSignature(signature: string): boolean;
-    /** @inheritdoc */
-    isValidTransactionId(txId: string): boolean;
-    /**
-     * FlareJS wrapper to create signature and return it for credentials
-     * @param network
-     * @param message
-     * @param prv
-     * @return signature
+     * Creates a signature using the Flare network parameters
+     * Returns a 65-byte signature (64 bytes signature + 1 byte recovery parameter)
      */
     createSignature(network: FlareNetwork, message: Buffer, prv: Buffer): Buffer;
     /**
-     * FlareJS wrapper to verify signature
-     * @param network
-     * @param message
-     * @param signature
-     * @param publicKey - public key instead of private key for verification
-     * @return true if it's verify successful
+     * Verifies a signature
      */
     verifySignature(network: FlareNetwork, message: Buffer, signature: Buffer, publicKey: Buffer): boolean;
     /**
-     * FlareJS wrapper to recover signature
-     * @param network
-     * @param message
-     * @param signature
-     * @return recovered public key
+     * Creates a new signature object
      */
-    recoverySignature(network: FlareNetwork, message: Buffer, signature: Buffer): Buffer;
-    sha256(buf: Uint8Array): Buffer;
+    createNewSig(sigHex: string): Signature;
     /**
-     * Check the raw transaction has a valid format in the blockchain context, throw otherwise.
-     * It's to reuse in TransactionBuilder and TransactionBuilderFactory
-     *
-     * @param rawTransaction Transaction as hex string
+     * Computes SHA256 hash
      */
-    validateRawTransaction(rawTransaction: string): void;
-    /**
-     * Check if tx is for the blockchainId
-     *
-     * @param {DeprecatedTx} tx
-     * @param {string} blockchainId
-     * @returns true if tx is for blockchainId
-     */
-    isTransactionOf(tx: DeprecatedTx, blockchainId: string): boolean;
+    sha256(buf: Uint8Array): Buffer;
     /**
-     * Check if Output is from PVM.
-     * Output could be EVM or PVM output.
-     * @param {DeprecatedOutput} output
-     * @returns {boolean} output has transferable output structure
+     * Validates raw transaction format
      */
-    deprecatedIsTransferableOutput(output: DeprecatedOutput): boolean;
+    validateRawTransaction(rawTransaction: string): void;
     /**
-     * Check if Output is from PVM.
-     * Output could be EVM or PVM output.
-     * @param {Output} output
-     * @returns {boolean} output is TransferableOutput
+     * Checks if output is TransferableOutput type
      */
     isTransferableOutput(output: Output): output is TransferableOutput;
     /**
-     * Return a mapper function to that network address representation.
-     * @param network required to stringify addresses
-     * @return mapper function
-     */
-    deprecatedMapOutputToEntry(network: FlareNetwork): (output: DeprecatedOutput) => Entry;
-    /**
-     * Return a mapper function to that network address representation.
-     * @param network required to stringify addresses
-     * @return mapper function
+     * Maps outputs to entry format
      */
     mapOutputToEntry(network: FlareNetwork): (Output: any) => Entry;
     /**
-     * remove hex prefix (0x)
-     * @param hex string
-     * @returns hex without 0x
+     * Removes 0x prefix from hex string
      */
     removeHexPrefix(hex: string): string;
     /**
-     * Outputidx convert from number (as string) to buffer.
-     * @param {string} outputidx number
-     * @return {Buffer} buffer of size 4 with that number value
+     * Converts output index to buffer
      */
     outputidxNumberToBuffer(outputidx: string): Buffer;
     /**
-     * Outputidx buffer to number (as string)
-     * @param {Buffer} outputidx
-     * @return {string} outputidx number
+     * Converts output index buffer to number string
      */
     outputidxBufferToNumber(outputidx: Buffer): string;
+    isValidSignature(signature: string): boolean;
+    isValidTransactionId(txId: string): boolean;
     /**
-     * CB58 decode function - simple Base58 decode implementation
-     * @param {string} data - CB58 encoded string
-     * @returns {Buffer} decoded buffer
+     * Helper method to convert address components to string
      */
-    cb58Decode(data: string): Buffer;
+    addressToString: (hrp: string, prefix: string, address: Buffer) => string;
     /**
-     * Convert address buffer to bech32 string
-     * @param {string} hrp - Human readable part
-     * @param {string} chainid - Chain identifier
-     * @param {Buffer} addressBuffer - Address buffer
-     * @returns {string} Address string
+     * Decodes a base58 string with checksum to a Buffer
      */
-    addressToString(hrp: string, chainid: string, addressBuffer: Buffer): string;
+    cb58Decode(str: string): Buffer;
     /**
-     * Convert string to bytes for FlareJS memo
-     * Follows FlareJS utils.stringToBytes pattern
-     * @param {string} text - Text to convert
-     * @returns {Uint8Array} Byte array
+     * Validates a checksum on a Buffer and returns true if valid, false if not
      */
-    stringToBytes(text: string): Uint8Array;
+    private validateChecksum;
     /**
-     * Convert bytes to string from FlareJS memo
-     * @param {Uint8Array} bytes - Bytes to convert
-     * @returns {string} Decoded string
+     * Encodes a Buffer as a base58 string with checksum
      */
-    bytesToString(bytes: Uint8Array): string;
+    cb58Encode(bytes: Buffer): string;
     /**
-     * Create memo bytes from various input formats
-     * Supports string, JSON object, or raw bytes
-     * @param {string | Record<string, unknown> | Uint8Array} memo - Memo data
-     * @returns {Uint8Array} Memo bytes for FlareJS
+     * Adds a checksum to a Buffer and returns the concatenated result
      */
-    createMemoBytes(memo: string | Record<string, unknown> | Uint8Array): Uint8Array;
+    private addChecksum;
     /**
-     * Parse memo bytes to string
-     * @param {Uint8Array} memoBytes - Memo bytes from FlareJS transaction
-     * @returns {string} Decoded memo string
+     * Parse an address string into a Buffer
+     * @param address - The address to parse
+     * @returns Buffer containing the parsed address
      */
-    parseMemoBytes(memoBytes: Uint8Array): string;
+    parseAddress: (address: string) => Buffer;
+    stringToAddress: (address: string, hrp?: string) => Buffer;
     /**
-     * Validate memo size (FlareJS has transaction size limits)
-     * @param {Uint8Array} memoBytes - Memo bytes
-     * @param {number} maxSize - Maximum size in bytes (default 4KB)
-     * @returns {boolean} Whether memo is within size limits
+     * Check if tx is for the blockchainId
+     *
+     * @param {DeprecatedTx} tx
+     * @param {string} blockchainId
+     * @returns true if tx is for blockchainId
      */
-    validateMemoSize(memoBytes: Uint8Array, maxSize?: number): boolean;
+    isTransactionOf(tx: DeprecatedTx, blockchainId: string): boolean;
+    flareIdString(value: string): Id;
+    /**
+     * FlareJS wrapper to recover signature
+     * @param network
+     * @param message
+     * @param signature
+     * @return recovered public key
+     */
+    recoverySignature(network: FlareNetwork, message: Buffer, signature: Buffer): Buffer;
 }
 declare const utils: Utils;
 export default utils;

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

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