ccxt 4.3.69 → 4.3.71

package/js/src/static_dependencies/starknet/types/lib/contract/abi.js

@@ -0,0 +1,13 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+var FunctionAbiType;
+(function (FunctionAbiType) {
+    FunctionAbiType[FunctionAbiType["function"] = 0] = "function";
+    FunctionAbiType[FunctionAbiType["l1_handler"] = 1] = "l1_handler";
+    FunctionAbiType[FunctionAbiType["constructor"] = 2] = "constructor";
+})(FunctionAbiType || (FunctionAbiType = {}));
+export {};

package/js/src/static_dependencies/starknet/types/lib/contract/index.d.ts

@@ -0,0 +1,24 @@
+import { LegacyCompiledContract, LegacyContractClass } from './legacy.js';
+import { CompiledSierra, SierraContractClass } from './sierra.js';
+/**
+ * format produced after compressing compiled contract
+ *
+ * CompressedCompiledContract
+ */
+export declare type ContractClass = LegacyContractClass | SierraContractClass;
+/**
+ * format produced after compile .cairo to .json
+ */
+export declare type CompiledContract = LegacyCompiledContract | CompiledSierra;
+/**
+ * Compressed or decompressed Cairo0 or Cairo1 Contract
+ */
+export declare type CairoContract = ContractClass | CompiledContract;
+export declare enum EntryPointType {
+    EXTERNAL = "EXTERNAL",
+    L1_HANDLER = "L1_HANDLER",
+    CONSTRUCTOR = "CONSTRUCTOR"
+}
+export * from './abi.js';
+export * from './legacy.js';
+export * from './sierra.js';

package/js/src/static_dependencies/starknet/types/lib/contract/index.js

@@ -0,0 +1,16 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+// Basic elements
+export var EntryPointType;
+(function (EntryPointType) {
+    EntryPointType["EXTERNAL"] = "EXTERNAL";
+    EntryPointType["L1_HANDLER"] = "L1_HANDLER";
+    EntryPointType["CONSTRUCTOR"] = "CONSTRUCTOR";
+})(EntryPointType || (EntryPointType = {}));
+export * from './abi.js';
+export * from './legacy.js';
+export * from './sierra.js';

package/js/src/static_dependencies/starknet/types/lib/contract/legacy.d.ts

@@ -0,0 +1,33 @@
+import { Abi } from './abi.js';
+/** LEGACY CONTRACT */
+/**
+ * format produced after compressing 'program' property
+ */
+export declare type LegacyContractClass = {
+    program: CompressedProgram;
+    entry_points_by_type: EntryPointsByType;
+    abi: Abi;
+};
+/**
+ * format produced after compiling .cairo to .json
+ */
+export declare type LegacyCompiledContract = Omit<LegacyContractClass, 'program'> & {
+    program: Program;
+};
+/** SUBTYPES */
+export declare type Builtins = string[];
+export declare type CompressedProgram = string;
+export declare type EntryPointsByType = {
+    CONSTRUCTOR: ContractEntryPointFields[];
+    EXTERNAL: ContractEntryPointFields[];
+    L1_HANDLER: ContractEntryPointFields[];
+};
+export declare type ContractEntryPointFields = {
+    selector: string;
+    offset: string | number;
+    builtins?: Builtins;
+};
+export interface Program extends Record<string, any> {
+    builtins: string[];
+    data: string[];
+}

package/js/src/static_dependencies/starknet/types/lib/contract/legacy.js

@@ -0,0 +1,7 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+export {};

package/js/src/static_dependencies/starknet/types/lib/contract/sierra.d.ts

@@ -0,0 +1,52 @@
+import { Abi } from './abi.js';
+import { EntryPointsByType } from './legacy.js';
+/** SYSTEM TYPES */
+export declare type CairoAssembly = {
+    prime: string;
+    compiler_version: string;
+    bytecode: ByteCode;
+    hints: any[];
+    pythonic_hints?: PythonicHints;
+    bytecode_segment_lengths?: number[];
+    entry_points_by_type: EntryPointsByType;
+};
+/** COMPILED CONTRACT */
+/**
+ * format produced after starknet-compile .cairo to .json
+ *
+ * sierra_program is hex array
+ */
+export declare type CompiledSierra = {
+    sierra_program: ByteCode;
+    sierra_program_debug_info?: SierraProgramDebugInfo;
+    contract_class_version: string;
+    entry_points_by_type: SierraEntryPointsByType;
+    abi: Abi;
+};
+/**
+ * format produced after compressing 'sierra_program', stringifies 'abi' property and omit sierra_program_debug_info
+ *
+ * CompressedCompiledSierra
+ */
+export declare type SierraContractClass = Omit<CompiledSierra, 'abi' | 'sierra_program_debug_info'> & {
+    sierra_program: string;
+    abi: string;
+};
+export declare type CompiledSierraCasm = CairoAssembly;
+/** SUBTYPES */
+export declare type ByteCode = string[];
+export declare type PythonicHints = [number, string[]][];
+export declare type SierraProgramDebugInfo = {
+    type_names: [number, string][];
+    libfunc_names: [number, string][];
+    user_func_names: [number, string][];
+};
+export declare type SierraEntryPointsByType = {
+    CONSTRUCTOR: SierraContractEntryPointFields[];
+    EXTERNAL: SierraContractEntryPointFields[];
+    L1_HANDLER: SierraContractEntryPointFields[];
+};
+export declare type SierraContractEntryPointFields = {
+    selector: string;
+    function_idx: number;
+};

package/js/src/static_dependencies/starknet/types/lib/contract/sierra.js

@@ -0,0 +1,7 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+export {};

package/js/src/static_dependencies/starknet/types/lib/index.d.ts

@@ -0,0 +1,248 @@
+import { StarknetChainId } from '../../constants.js';
+import { SignatureType } from '../../../noble-curves/abstract/weierstrass.js';
+import { CairoEnum } from '../cairoEnum.js';
+import { CompiledContract, CompiledSierraCasm, ContractClass } from './contract/index.js';
+export declare type WeierstrassSignatureType = SignatureType;
+export declare type ArraySignatureType = string[];
+export declare type Signature = ArraySignatureType | WeierstrassSignatureType;
+export declare type BigNumberish = string | number | bigint;
+export declare type ByteArray = {
+    data: BigNumberish[];
+    pending_word: BigNumberish;
+    pending_word_len: BigNumberish;
+};
+/**
+ * Compiled calldata ready to be sent
+ *
+ * decimal-string array
+ */
+export declare type Calldata = string[] & {
+    readonly __compiled__?: true;
+};
+/**
+ * Represents an integer in the range [0, 2^256)
+ */
+export interface Uint256 {
+    low: BigNumberish;
+    high: BigNumberish;
+}
+/**
+ * Represents an integer in the range [0, 2^256)
+ */
+export interface Uint512 {
+    limb0: BigNumberish;
+    limb1: BigNumberish;
+    limb2: BigNumberish;
+    limb3: BigNumberish;
+}
+/**
+ * BigNumberish array
+ *
+ * use CallData.compile() to convert to Calldata
+ */
+export declare type RawCalldata = BigNumberish[];
+/**
+ * Hexadecimal-string array
+ */
+export declare type HexCalldata = string[];
+export declare type AllowArray<T> = T | T[];
+export declare type OptionalPayload<T> = {
+    payload: T;
+} | T;
+export declare type RawArgs = RawArgsObject | RawArgsArray;
+export declare type RawArgsObject = {
+    [inputName: string]: MultiType | MultiType[] | RawArgs;
+};
+export declare type RawArgsArray = Array<MultiType | MultiType[] | RawArgs>;
+export declare type MultiType = BigNumberish | Uint256 | object | boolean | CairoEnum;
+export declare type UniversalDeployerContractPayload = {
+    classHash: BigNumberish;
+    salt?: string;
+    unique?: boolean;
+    constructorCalldata?: RawArgs;
+};
+export declare type DeployAccountContractPayload = {
+    classHash: string;
+    constructorCalldata?: RawArgs;
+    addressSalt?: BigNumberish;
+    contractAddress?: string;
+};
+export declare type DeployAccountContractTransaction = Omit<DeployAccountContractPayload, 'contractAddress'> & {
+    signature?: Signature;
+};
+export declare type DeclareContractPayload = {
+    contract: CompiledContract | string;
+    classHash?: string;
+    casm?: CompiledSierraCasm;
+    compiledClassHash?: string;
+};
+export declare type CompleteDeclareContractPayload = {
+    contract: CompiledContract | string;
+    classHash: string;
+    casm?: CompiledSierraCasm;
+    compiledClassHash?: string;
+};
+export declare type DeclareAndDeployContractPayload = Omit<UniversalDeployerContractPayload, 'classHash'> & DeclareContractPayload;
+export declare type DeclareContractTransaction = {
+    contract: ContractClass;
+    senderAddress: string;
+    signature?: Signature;
+    compiledClassHash?: string;
+};
+export declare type CallDetails = {
+    contractAddress: string;
+    calldata?: RawArgs | Calldata;
+    entrypoint?: string;
+};
+export declare type Invocation = CallDetails & {
+    signature?: Signature;
+};
+export declare type Call = CallDetails & {
+    entrypoint: string;
+};
+export declare type CairoVersion = '0' | '1' | undefined;
+export declare type CompilerVersion = '0' | '1' | '2' | undefined;
+export declare type InvocationsDetails = {
+    nonce?: BigNumberish;
+    maxFee?: BigNumberish;
+    version?: BigNumberish;
+} & Partial<V3TransactionDetails>;
+export declare type V3TransactionDetails = {
+    nonce: BigNumberish;
+    version: BigNumberish;
+    tip: BigNumberish;
+    paymasterData: BigNumberish[];
+    accountDeploymentData: BigNumberish[];
+};
+/**
+ * Contain all additional details params
+ */
+export declare type Details = {
+    nonce: BigNumberish;
+    maxFee: BigNumberish;
+    version: BigNumberish;
+    chainId: StarknetChainId;
+};
+export declare type InvocationsDetailsWithNonce = (InvocationsDetails & {
+    nonce: BigNumberish;
+}) | V3TransactionDetails;
+export declare enum TransactionType {
+    DECLARE = "DECLARE",
+    DEPLOY = "DEPLOY",
+    DEPLOY_ACCOUNT = "DEPLOY_ACCOUNT",
+    INVOKE = "INVOKE_FUNCTION"
+}
+/**
+ * new statuses are defined by props: finality_status and execution_status
+ * to be #deprecated
+ */
+export declare enum TransactionStatus {
+    NOT_RECEIVED = "NOT_RECEIVED",
+    RECEIVED = "RECEIVED",
+    ACCEPTED_ON_L2 = "ACCEPTED_ON_L2",
+    ACCEPTED_ON_L1 = "ACCEPTED_ON_L1",
+    REJECTED = "REJECTED",
+    REVERTED = "REVERTED"
+}
+export declare enum TransactionFinalityStatus {
+    NOT_RECEIVED = "NOT_RECEIVED",
+    RECEIVED = "RECEIVED",
+    ACCEPTED_ON_L2 = "ACCEPTED_ON_L2",
+    ACCEPTED_ON_L1 = "ACCEPTED_ON_L1"
+}
+export declare enum TransactionExecutionStatus {
+    REJECTED = "REJECTED",
+    REVERTED = "REVERTED",
+    SUCCEEDED = "SUCCEEDED"
+}
+export declare enum BlockStatus {
+    PENDING = "PENDING",
+    ACCEPTED_ON_L1 = "ACCEPTED_ON_L1",
+    ACCEPTED_ON_L2 = "ACCEPTED_ON_L2",
+    REJECTED = "REJECTED"
+}
+export declare enum BlockTag {
+    pending = "pending",
+    latest = "latest"
+}
+export declare type BlockNumber = BlockTag | null | number;
+/**
+ * hex string and BigInt are detected as block hashes
+ *
+ * decimal string and number are detected as block numbers
+ *
+ * text string are detected as block tag
+ *
+ * null return 'pending' block tag
+ */
+export declare type BlockIdentifier = BlockNumber | BigNumberish;
+/**
+ * items used by AccountInvocations
+ */
+export declare type AccountInvocationItem = (({
+    type: TransactionType.DECLARE;
+} & DeclareContractTransaction) | ({
+    type: TransactionType.DEPLOY_ACCOUNT;
+} & DeployAccountContractTransaction) | ({
+    type: TransactionType.INVOKE;
+} & Invocation)) & InvocationsDetailsWithNonce;
+/**
+ * Complete invocations array with account details (internal type from account -> provider)
+ */
+export declare type AccountInvocations = AccountInvocationItem[];
+/**
+ * Invocations array user provide to bulk method (simulate)
+ */
+export declare type Invocations = Array<({
+    type: TransactionType.DECLARE;
+} & OptionalPayload<DeclareContractPayload>) | ({
+    type: TransactionType.DEPLOY;
+} & OptionalPayload<AllowArray<UniversalDeployerContractPayload>>) | ({
+    type: TransactionType.DEPLOY_ACCOUNT;
+} & OptionalPayload<DeployAccountContractPayload>) | ({
+    type: TransactionType.INVOKE;
+} & OptionalPayload<AllowArray<Call>>)>;
+export declare type Tupled = {
+    element: any;
+    type: string;
+};
+export declare type Args = {
+    [inputName: string]: BigNumberish | BigNumberish[] | ParsedStruct | ParsedStruct[];
+};
+export declare type ParsedStruct = {
+    [key: string]: BigNumberish | BigNumberish[] | ParsedStruct | Uint256;
+};
+export declare type waitForTransactionOptions = {
+    retryInterval?: number;
+    successStates?: Array<TransactionFinalityStatus | TransactionExecutionStatus>;
+    errorStates?: Array<TransactionFinalityStatus | TransactionExecutionStatus>;
+};
+export declare type getSimulateTransactionOptions = {
+    blockIdentifier?: BlockIdentifier;
+    skipValidate?: boolean;
+    skipExecute?: boolean;
+    skipFeeCharge?: boolean;
+};
+export declare type getContractVersionOptions = {
+    blockIdentifier?: BlockIdentifier;
+    compiler?: boolean;
+};
+export declare type getEstimateFeeBulkOptions = {
+    blockIdentifier?: BlockIdentifier;
+    skipValidate?: boolean;
+};
+export interface CallStruct {
+    to: string;
+    selector: string;
+    calldata: string[];
+}
+/**
+ * Represent Contract version
+ */
+export declare type ContractVersion = {
+    /** version of the cairo language */
+    cairo: CairoVersion;
+    /** version of the cairo compiler used to compile the contract */
+    compiler: CompilerVersion;
+};
+export * from './contract/index.js';

package/js/src/static_dependencies/starknet/types/lib/index.js

@@ -0,0 +1,52 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+export var TransactionType;
+(function (TransactionType) {
+    TransactionType["DECLARE"] = "DECLARE";
+    TransactionType["DEPLOY"] = "DEPLOY";
+    TransactionType["DEPLOY_ACCOUNT"] = "DEPLOY_ACCOUNT";
+    TransactionType["INVOKE"] = "INVOKE_FUNCTION";
+})(TransactionType || (TransactionType = {}));
+/**
+ * new statuses are defined by props: finality_status and execution_status
+ * to be #deprecated
+ */
+export var TransactionStatus;
+(function (TransactionStatus) {
+    TransactionStatus["NOT_RECEIVED"] = "NOT_RECEIVED";
+    TransactionStatus["RECEIVED"] = "RECEIVED";
+    TransactionStatus["ACCEPTED_ON_L2"] = "ACCEPTED_ON_L2";
+    TransactionStatus["ACCEPTED_ON_L1"] = "ACCEPTED_ON_L1";
+    TransactionStatus["REJECTED"] = "REJECTED";
+    TransactionStatus["REVERTED"] = "REVERTED";
+})(TransactionStatus || (TransactionStatus = {}));
+export var TransactionFinalityStatus;
+(function (TransactionFinalityStatus) {
+    TransactionFinalityStatus["NOT_RECEIVED"] = "NOT_RECEIVED";
+    TransactionFinalityStatus["RECEIVED"] = "RECEIVED";
+    TransactionFinalityStatus["ACCEPTED_ON_L2"] = "ACCEPTED_ON_L2";
+    TransactionFinalityStatus["ACCEPTED_ON_L1"] = "ACCEPTED_ON_L1";
+})(TransactionFinalityStatus || (TransactionFinalityStatus = {}));
+export var TransactionExecutionStatus;
+(function (TransactionExecutionStatus) {
+    TransactionExecutionStatus["REJECTED"] = "REJECTED";
+    TransactionExecutionStatus["REVERTED"] = "REVERTED";
+    TransactionExecutionStatus["SUCCEEDED"] = "SUCCEEDED";
+})(TransactionExecutionStatus || (TransactionExecutionStatus = {}));
+export var BlockStatus;
+(function (BlockStatus) {
+    BlockStatus["PENDING"] = "PENDING";
+    BlockStatus["ACCEPTED_ON_L1"] = "ACCEPTED_ON_L1";
+    BlockStatus["ACCEPTED_ON_L2"] = "ACCEPTED_ON_L2";
+    BlockStatus["REJECTED"] = "REJECTED";
+})(BlockStatus || (BlockStatus = {}));
+export var BlockTag;
+(function (BlockTag) {
+    BlockTag["pending"] = "pending";
+    BlockTag["latest"] = "latest";
+})(BlockTag || (BlockTag = {}));
+export * from './contract/index.js';

package/js/src/static_dependencies/starknet/types/typedData.d.ts

@@ -0,0 +1,44 @@
+export declare const TypedDataRevision: {
+    readonly Active: "1";
+    readonly Legacy: "0";
+};
+export declare type TypedDataRevision = (typeof TypedDataRevision)[keyof typeof TypedDataRevision];
+export declare type StarknetEnumType = {
+    name: string;
+    type: 'enum';
+    contains: string;
+};
+export declare type StarknetMerkleType = {
+    name: string;
+    type: 'merkletree';
+    contains: string;
+};
+/**
+ * SPEC: STARKNET_TYPE
+ * A single type, as part of a struct. The `type` field can be any of the EIP-712 supported types.
+ * Note that the `uint` and `int` aliases like in Solidity, and fixed point numbers are not supported by the EIP-712
+ * standard.
+ */
+export declare type StarknetType = {
+    name: string;
+    type: string;
+} | StarknetEnumType | StarknetMerkleType;
+/**
+ * The EIP712 domain struct. Any of these fields are optional, but it must contain at least one field.
+ */
+export interface StarknetDomain extends Record<string, unknown> {
+    name?: string;
+    version?: string;
+    chainId?: string | number;
+    revision?: string | number;
+}
+/**
+ * SPEC: TYPED_DATA
+ * The complete typed data, with all the structs, domain data, primary type of the message, and the message itself.
+ */
+export interface TypedData {
+    types: Record<string, StarknetType[]>;
+    primaryType: string;
+    domain: StarknetDomain;
+    message: object;
+}

package/js/src/static_dependencies/starknet/types/typedData.js

@@ -0,0 +1,19 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+// Reexport types from package
+// export {
+//   TypedDataRevision,
+//   type StarknetEnumType,
+//   type StarknetMerkleType,
+//   type StarknetType,
+//   type StarknetDomain,
+//   type TypedData,
+// } from 'starknet-types-07';
+export const TypedDataRevision = {
+    Active: '1',
+    Legacy: '0',
+};

package/js/src/static_dependencies/starknet/utils/address.d.ts

@@ -0,0 +1,53 @@
+import { BigNumberish } from '../types/index.js';
+/**
+ * Format a hex number to '0x' and 64 characters, adding leading zeros if necessary.
+ * @param {BigNumberish} address
+ * @returns {string} Hex string : 0x followed by 64 characters. No upper case characters in the response.
+ * @example
+ * ```typescript
+ * const address = "0x90591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf";
+ * const result = addAddressPadding(address);
+ * // result = "0x0000090591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf"
+ * ```
+ */
+export declare function addAddressPadding(address: BigNumberish): string;
+/**
+ * Check the validity of a Starknet address, and format it as a hex number : '0x' and 64 characters, adding leading zeros if necessary.
+ * @param {BigNumberish} address
+ * @returns {string} Hex string : 0x followed by 64 characters. No upper case characters in the response.
+ * @example
+ * ```typescript
+ * const address = "0x90591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf";
+ * const result = validateAndParseAddress(address);
+ * // result = "0x0000090591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf"
+ * ```
+ */
+export declare function validateAndParseAddress(address: BigNumberish): string;
+/**
+ * Convert an address to her checksum representation which uses a specific pattern of uppercase and lowercase letters within
+ * a given address to reduce the risk of errors introduced from typing an address or cut and paste issues.
+ * @param {BigNumberish} address
+ * @returns {string} Hex string : 0x followed by 64 characters. Mix of uppercase and lowercase
+ * @example
+ * ```typescript
+ * const address = "0x90591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf";
+ * const result = getChecksumAddress(address);
+ * // result = "0x0000090591D9fA3EfC87067d95a643f8455E0b8190eb8Cb7bFd39e4fb7571fDF"
+ * ```
+ */
+export declare function getChecksumAddress(address: BigNumberish): string;
+/**
+ * If the casing of an address is mixed, it is a Checksum Address, which uses a specific pattern of uppercase and lowercase letters within
+ * a given address to reduce the risk of errors introduced from typing an address or cut and paste issues.
+ *
+ * @param address string
+ *
+ * @returns true if the ChecksumAddress is valid
+ * @example
+ * ```typescript
+ * const address = "0x0000090591D9fA3EfC87067d95a643f8455E0b8190eb8Cb7bFd39e4fb7571fDF";
+ * const result = validateChecksumAddress(address);
+ * // result = true
+ * ```
+ */
+export declare function validateChecksumAddress(address: string): boolean;

package/js/src/static_dependencies/starknet/utils/address.js

@@ -0,0 +1,89 @@
+// ----------------------------------------------------------------------------
+
+// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:
+// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code
+// EDIT THE CORRESPONDENT .ts FILE INSTEAD
+
+/* eslint-disable no-bitwise */
+import { hexToBytes } from '../../noble-curves/abstract/utils';
+import { ADDR_BOUND, ZERO } from '../constants.js';
+import { addHexPrefix, removeHexPrefix } from './encode.js';
+import { keccakBn } from './hash/index.js';
+import { assertInRange, toHex } from './num.js';
+/**
+ * Format a hex number to '0x' and 64 characters, adding leading zeros if necessary.
+ * @param {BigNumberish} address
+ * @returns {string} Hex string : 0x followed by 64 characters. No upper case characters in the response.
+ * @example
+ * ```typescript
+ * const address = "0x90591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf";
+ * const result = addAddressPadding(address);
+ * // result = "0x0000090591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf"
+ * ```
+ */
+export function addAddressPadding(address) {
+    return addHexPrefix(removeHexPrefix(toHex(address)).padStart(64, '0'));
+}
+/**
+ * Check the validity of a Starknet address, and format it as a hex number : '0x' and 64 characters, adding leading zeros if necessary.
+ * @param {BigNumberish} address
+ * @returns {string} Hex string : 0x followed by 64 characters. No upper case characters in the response.
+ * @example
+ * ```typescript
+ * const address = "0x90591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf";
+ * const result = validateAndParseAddress(address);
+ * // result = "0x0000090591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf"
+ * ```
+ */
+export function validateAndParseAddress(address) {
+    assertInRange(address, ZERO, ADDR_BOUND - 1n, 'Starknet Address');
+    const result = addAddressPadding(address);
+    if (!result.match(/^(0x)?[0-9a-fA-F]{64}$/)) {
+        throw new Error('Invalid Address Format');
+    }
+    return result;
+}
+/**
+ * Convert an address to her checksum representation which uses a specific pattern of uppercase and lowercase letters within
+ * a given address to reduce the risk of errors introduced from typing an address or cut and paste issues.
+ * @param {BigNumberish} address
+ * @returns {string} Hex string : 0x followed by 64 characters. Mix of uppercase and lowercase
+ * @example
+ * ```typescript
+ * const address = "0x90591d9fa3efc87067d95a643f8455e0b8190eb8cb7bfd39e4fb7571fdf";
+ * const result = getChecksumAddress(address);
+ * // result = "0x0000090591D9fA3EfC87067d95a643f8455E0b8190eb8Cb7bFd39e4fb7571fDF"
+ * ```
+ */
+// from https://github.com/ethers-io/ethers.js/blob/fc1e006575d59792fa97b4efb9ea2f8cca1944cf/packages/address/src.ts/index.ts#L12
+export function getChecksumAddress(address) {
+    const chars = removeHexPrefix(validateAndParseAddress(address)).toLowerCase().split('');
+    const hex = removeHexPrefix(keccakBn(address));
+    const hashed = hexToBytes(hex.padStart(64, '0'));
+    for (let i = 0; i < chars.length; i += 2) {
+        if (hashed[i >> 1] >> 4 >= 8) {
+            chars[i] = chars[i].toUpperCase();
+        }
+        if ((hashed[i >> 1] & 0x0f) >= 8) {
+            chars[i + 1] = chars[i + 1].toUpperCase();
+        }
+    }
+    return addHexPrefix(chars.join(''));
+}
+/**
+ * If the casing of an address is mixed, it is a Checksum Address, which uses a specific pattern of uppercase and lowercase letters within
+ * a given address to reduce the risk of errors introduced from typing an address or cut and paste issues.
+ *
+ * @param address string
+ *
+ * @returns true if the ChecksumAddress is valid
+ * @example
+ * ```typescript
+ * const address = "0x0000090591D9fA3EfC87067d95a643f8455E0b8190eb8Cb7bFd39e4fb7571fDF";
+ * const result = validateChecksumAddress(address);
+ * // result = true
+ * ```
+ */
+export function validateChecksumAddress(address) {
+    return getChecksumAddress(address) === address;
+}

package/js/src/static_dependencies/starknet/utils/assert.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Asserts that the given condition is true, otherwise throws an error with an optional message.
+ * @param {any} condition - The condition to check.
+ * @param {string} [message] - The optional message to include in the error.
+ * @throws {Error} Throws an error if the condition is false.
+ */
+export default function assert(condition: boolean, message?: string): asserts condition;