@monerium/sdk 3.5.0 → 4.0.0

package/dist/index.d.ts

@@ -1,22 +1,47 @@
-type TransportRequest = {
-    method: string;
-    url: string;
-    headers: Record<string, string>;
-    body?: BodyInit | string;
-    signal?: AbortSignal;
-};
-type TransportResponse = {
-    status: number;
-    headers?: Record<string, string>;
-    bodyText: string;
+/**
+ * Generate a cryptographically random PKCE code verifier (RFC 7636).
+ * Returns a base64url-encoded string of 32 random bytes (256 bits of entropy).
+ * The caller is responsible for storing this until the callback.
+ * @group Auth
+ * @category Functions
+ */
+declare const randomPKCECodeVerifier: () => string;
+/**
+ * Derive the S256 code challenge from a code verifier.
+ * Synchronous. Returns a base64url-encoded SHA-256 hash.
+ * @group Auth
+ * @category Functions
+ */
+declare const calculatePKCECodeChallenge: (codeVerifier: string) => string;
+/**
+ * Generate a new PKCE code verifier and its corresponding challenge.
+ * @group Auth
+ * @category Functions
+ */
+declare const generatePKCE: () => {
+    codeVerifier: string;
+    codeChallenge: string;
 };
+interface ParsedAuthorizationResponse {
+    code?: string;
+    state?: string;
+    error?: string;
+    errorDescription?: string;
+}
 /**
- * Replaces the internal `fetch` call. Headers (`Authorization`, `Content-Type`,
- * `Accept`) are pre-populated. Must return a `Promise` resolving with the raw
- * response `status` and `bodyText`. Throw on network-level failures.
- * The SDK owns JSON parsing and error normalisation.
+ * Parse a callback URL or query string into structured fields.
+ *
+ * - Returns an empty object if none of the expected parameters are present.
+ * - Check for the presence of `code` or `error` to determine if the URL
+ *   contains an OAuth2 authorization response.
+ *
+ * @example
+ * const { code, error } = parseAuthorizationResponse(req.url);
+ * const { code, error } = parseAuthorizationResponse('?code=abc&state=xyz');
+ * @group Auth
+ * @category Functions
  */
-type Transport = (request: TransportRequest) => Promise<TransportResponse>;
+declare const parseAuthorizationResponse: (input: string) => ParsedAuthorizationResponse;
 
 /**
  * Single source of truth for all supported EVM chain pairs.
@@ -102,70 +127,96 @@ declare const EVM_CHAIN_PAIRS: readonly [{
         readonly chainId: 501;
     };
 }];
-type ProductionChain = (typeof EVM_CHAIN_PAIRS)[number]['production']['id'] | 'noble';
-type SandboxChain = (typeof EVM_CHAIN_PAIRS)[number]['sandbox']['id'] | 'grand';
+/**
+ * All supported production chain names.
+ * @group Primitives
+ */
+type ProductionChain = 'ethereum' | 'gnosis' | 'polygon' | 'arbitrum' | 'linea' | 'scroll' | 'base' | 'camino' | 'noble';
+/**
+ * All supported sandbox chain names.
+ * @group Primitives
+ */
+type SandboxChain = 'sepolia' | 'chiado' | 'amoy' | 'arbitrumsepolia' | 'lineasepolia' | 'scrollsepolia' | 'basesepolia' | 'columbus' | 'grand';
 /**
  * All known EVM chain IDs. The union extends `number` for backwards
  * compatibility — known values are listed in EVM_CHAIN_PAIRS above.
+ * @group Primitives
  */
 type EvmChainId = number | (typeof EVM_CHAIN_PAIRS)[number]['production' | 'sandbox']['chainId'];
+/**
+ * @group Primitives
+ */
+type Chain = ProductionChain | SandboxChain;
+/**
+ * @group Primitives
+ */
+type ChainId = EvmChainId | CosmosChainId;
+/**
+ * @group Primitives
+ */
+type CosmosChainId = 'noble-1' | 'grand-1' | 'florin-1';
 
+/**
+ * @group Primitives
+ */
 type Environment = {
     name: ENV;
     api: string;
     web: string;
-    wss: string;
 };
+/**
+ * @group Primitives
+ */
 type Config = {
     environments: {
         production: Environment;
         sandbox: Environment;
     };
 };
+/**
+ * @group Primitives
+ */
 type ENV = 'sandbox' | 'production';
-
-type Chain = string | ProductionChain | SandboxChain;
-type ChainId = EvmChainId | CosmosChainId;
-type CosmosChainId = 'noble-1' | 'grand-1' | 'florin-1';
+/**
+ * @group Tokens
+ */
 declare enum Currency {
     eur = "eur",
     usd = "usd",
     gbp = "gbp",
     isk = "isk"
 }
+/**
+ * @group Tokens
+ */
 type TokenSymbol = 'EURe' | 'GBPe' | 'USDe' | 'ISKe';
+/**
+ * @group Tokens
+ */
 type Ticker = 'EUR' | 'GBP' | 'USD' | 'ISK';
+/**
+ * @group Tokens
+ */
 type CurrencyCode = 'eur' | 'gbp' | 'usd' | 'isk';
-type AuthArgs = Omit<AuthCodePayload, 'grant_type'> | Omit<RefreshTokenPayload, 'grant_type'> | Omit<ClientCredentialsPayload, 'grant_type'>;
-/** One of the options for the {@link AuthArgs}.
- *
- * [Auth endpoint in API documentation:](https://docs.monerium.com/api#operation/auth).
- * */
-interface AuthCodePayload {
-    grant_type: 'authorization_code';
-    client_id: string;
-    code: string;
-    code_verifier: string;
-    redirect_uri: string;
-}
-/** One of the options for the {@link AuthArgs}.
- *
- * [Auth endpoint in API documentation:](https://docs.monerium.com/api#operation/auth).
- * */
-interface RefreshTokenPayload {
-    grant_type: 'refresh_token';
-    client_id: string;
-    refresh_token: string;
-}
-/** One of the options for the {@link AuthArgs}.
- *
- * [Auth endpoint in API documentation:](https://docs.monerium.com/api#operation/auth).
- * */
-interface ClientCredentialsPayload {
-    grant_type: 'client_credentials';
-    client_id: string;
-    client_secret: string;
+/**
+ * Information about the EURe token on different networks.
+ * @group Tokens
+ */
+interface Token {
+    currency: Currency;
+    ticker: Ticker;
+    symbol: TokenSymbol;
+    chain: Chain;
+    /** The address of the EURe contract on this network */
+    address: string;
+    /** How many decimals this token supports */
+    decimals: number;
 }
+/**
+ * Returned by all auth grant functions. Store server-side — never in the browser.
+ * @group Auth
+ * @category Types
+ */
 interface BearerProfile {
     access_token: string;
     token_type: string;
@@ -174,133 +225,82 @@ interface BearerProfile {
     profile: string;
     userId: string;
 }
-interface PKCERequestShared {
-    /** the authentication flow client id of the application */
-    client_id: string;
-    /** the redirect uri of the application */
-    redirect_uri?: string;
-    /** the code challenge automatically generated by the SDK */
-    code_challenge: string;
-    /** the code challenge method for the authentication flow , handled by the SDK  */
-    code_challenge_method: 'S256';
-    /** the state of the application */
-    state?: string;
-}
 /**
- * @returns A {@link PKCERequest} object with properties omitted that are automatically computed in by the SDK.
+ * @group Profiles
  */
-type PKCERequestArgs = Omit<PKCERequest, 'code_challenge' | 'code_challenge_method' | 'response_type'>;
-interface PKCERequest extends PKCERequestShared {
-    /** the response type of the authentication flow, handled by the SDK */
-    response_type: 'code';
-    /** the email of the user to prefill the login form */
-    email?: string;
-    /** @deprecated: will be removed, the scope of the application */
-    scope?: string;
-    /** the address of the wallet to automatically link */
-    address?: string;
-    /** the signature of the wallet to automatically link */
-    signature?: string;
-    /** The network of the wallet to automatically link  */
-    chain?: Chain | ChainId;
-    /**
-     * You can skip the connect wallet and request IBAN steps in the Authorization Flow and use the Link Address and Request IBAN API endpoints after you have gotten the authorization
-     * @deprecated Account creation is no longer offered in the auth flow
-     *  */
-    skip_create_account?: boolean;
-    /** You can skip the KYC onboarding steps in the Authorization Flow and use the the details, additional data, and verifications API endpoints after you have gotten the authorization. */
-    skip_kyc?: boolean;
-}
+type Method = 'password' | 'resource' | 'jwt' | 'apiKey' | 'bearer';
 /**
- * @returns A {@link PKCESIWERequest} object with properties omitted that are automatically computed in by the SDK.
+ * @group Profiles
  */
-type PKCERSIWERequestArgs = Omit<PKCESIWERequest, 'code_challenge' | 'code_challenge_method' | 'authentication_method'>;
-interface PKCESIWERequest extends PKCERequestShared {
-    /**
-     * Authentication method used. The default is to redirect the user to Monerium login screen, where the user can either sign in, or go through the register flow.
-     * `siwe` is only applicable for existing Monerium customers who have already linked at least one of their addresses with Monerium.
-     **/
-    authentication_method: 'siwe';
-    /** An EIP-4361 compatible message. https://eips.ethereum.org/EIPS/eip-4361
-     *  https://monerium.com/siwe
-     * */
-    message: string;
-    /** Signature for the SIWE message. Must include the 0x prefix. */
-    signature: string;
-}
-declare enum Method {
-    password = "password",
-    resource = "resource",
-    jwt = "jwt",
-    apiKey = "apiKey",
-    bearer = "bearer"
-}
+type ProfileKind = 'corporate' | 'personal';
+/**
+ * @ignore
+ * @deprecated Use ProfileKind instead
+ *  */
 declare enum ProfileType {
     corporate = "corporate",
     personal = "personal"
 }
-declare enum Permission {
-    read = "read",
-    write = "write"
-}
-declare enum ProfileState {
-    /** The profile has been created but no details have been submitted.*/
-    created = "created",
-    /** The details have been submitted and are being processed. */
-    pending = "pending",
-    /** The profile is active and all Monerium services are supported.*/
-    approved = "approved",
-    /**The applicant details did not meet the compliance requirements of Monerium. Details can be fixed and re-submitted for processing.*/
-    rejected = "rejected",
-    /**Monerium is unable to offer the applicant services because of compliance reasons. Details cannot be re-submitted.*/
-    blocked = "blocked"
-}
-declare enum KYCState {
-    absent = "absent",
-    submitted = "submitted",
-    pending = "pending",
-    confirmed = "confirmed"
-}
-declare enum KYCOutcome {
-    approved = "approved",
-    rejected = "rejected",
-    unknown = "unknown"
-}
-declare enum AccountState {
-    requested = "requested",
-    approved = "approved",
-    pending = "pending",
-    rejected = "rejected",
-    closed = "closed"
-}
-interface KYC {
-    state: KYCState;
-    outcome: KYCOutcome;
-}
-declare enum PaymentStandard {
-    iban = "iban",
-    scan = "scan",
-    chain = "chain",
-    account = "account"
+/**
+ * @group Profiles
+ */
+type Permission = 'read' | 'write';
+/**
+ * The state of the profile lifecycle.
+ * @group Profiles
+ */
+type ProfileState = 'created' | 'incomplete' | 'submitted' | 'approved' | 'rejected';
+/**
+ * KYC details section with its current state.
+ *
+ * @group Profiles
+ */
+interface ProfileDetailsState {
+    state: ProfileState;
 }
 /**
- * The type of ID document. Passports, National ID cards, and driving licenses are supported.
- * The ID document must verify the person's name, birthday, and nationality
+ * Additional data section used for risk calculations.
+ *
+ * @group Profiles
  */
-declare enum IdDocumentKind {
-    passport = "passport",
-    nationalIdentityCard = "nationalIdentityCard",
-    drivingLicense = "drivingLicense"
+interface ProfileFormState {
+    state: ProfileState;
 }
-interface Identifier {
-    standard: PaymentStandard;
-    bic?: string;
+/**
+ * The type of personal profile verification.
+ *
+ * @group Profiles
+ */
+type PersonalVerificationKind = 'idDocument' | 'facialSimilarity' | 'proofOfResidency' | 'sourceOfFunds';
+/**
+ * The type of corporate profile verification.
+ *
+ * @group Profiles
+ */
+type CorporateVerificationKind = 'sourceOfFunds' | 'corporateName' | 'corporateAddress' | 'registrationNumber' | 'dateOfRegistration' | 'beneficialOwnership' | 'powerOfAttorney';
+/**
+ * Verification items required for this profile, each with its current state.
+ *
+ * @group Profiles
+ */
+interface ProfileVerificationState {
+    kind: PersonalVerificationKind | CorporateVerificationKind;
+    state: ProfileState;
 }
+/**
+ * The type of ID document. Passports, National ID cards, and driving licenses are supported.
+ * The ID document must verify the person's name, birthday, and nationality.
+ * @group Profiles
+ */
+type IdDocumentKind = 'passport' | 'nationalIdentityCard' | 'drivingLicense';
+/**
+ * @group Profiles
+ */
 interface AuthContext {
     userId: string;
     email: string;
     name: string;
-    roles: [] | null;
+    roles?: string[];
     auth: {
         method: Method;
         subject: string;
@@ -310,59 +310,108 @@ interface AuthContext {
     defaultProfile: string;
     profiles: {
         id: string;
-        kind: ProfileType | 'unknown';
+        kind: ProfileKind | 'unknown';
         name: string;
         perms: Permission[];
     }[];
 }
+/**
+ * @group Profiles
+ */
 interface ProfilesResponse {
-    profiles: Profile[];
+    profiles: Omit<Profile, 'details' | 'form' | 'verifications'>[];
 }
+/**
+ * @group Profiles
+ */
 interface Profile {
+    /** Unique identifier of the profile. The Profile ID is the main identifier used to represent ownership of other API resources */
     id: string;
+    /** String identifier specifying the type of the profile. */
+    kind: ProfileKind;
+    /** The Profile name. This can be a corporate or an individual. */
     name: string;
-    kind: ProfileType;
+    /** The state of the profile lifecycle. */
     state: ProfileState;
+    /**  KYC details section with its current state. */
+    details?: ProfileDetailsState;
+    /** The form data for the profile. */
+    form?: ProfileFormState;
+    /** Verification items required for this profile, each with its current state. */
+    verifications?: ProfileVerificationState[];
 }
-/** @deprecated use Profile */
-type ProfilePermissions = Profile;
-interface ProfilesQueryParams {
-    /** profile state to filter by */
+/**
+ * @group Profiles
+ */
+interface GetProfilesParams {
+    /** Filter the list on the state of profiles */
     state?: ProfileState;
-    /** profile kind to filter by */
-    kind?: ProfileType;
+    /** Filter the list on the kind of profiles*/
+    kind?: ProfileKind;
 }
+/**
+ * @group Profiles
+ */
 interface PersonalProfileDetails {
     idDocument: {
+        /** The document number. */
         number: string;
+        /** The type of ID document. Must verify the person's name, birthday, and nationality */
         kind: IdDocumentKind;
     };
     firstName: string;
     lastName: string;
+    /** Street and building number where the person lives. */
     address: string;
+    /** Postal code where the person lives. */
     postalCode: string;
+    /** City where the person lives. */
     city: string;
+    /**Two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) where the person lives */
     country: string;
+    /** State/County where the person lives. */
     countryState?: string;
+    /** Two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) for the person's nationality. */
     nationality: string;
+    /** The person's date of birth in `YYYY-MM-DD format. */
     birthday: string;
 }
-interface PersonalProfileDetailsRequest {
-    personal: PersonalProfileDetails;
-}
+/**
+ * @group Profiles
+ */
 type Representative = PersonalProfileDetails;
+/**
+ * @group Profiles
+ */
 type Beneficiary = Omit<PersonalProfileDetails, 'idDocument'> & {
     /** Ownership in % that is between 25% and 100%. */
     ownershipPercentage: number;
 };
+/**
+ * @group Profiles
+ */
 type Director = Omit<PersonalProfileDetails, 'idDocument'>;
+/**
+ * @group Profiles
+ */
 interface CorporateProfileDetails {
     name: string;
     registrationNumber: string;
+    /** The company's registration date in the `YYYY-MM-DD` format. */
+    registrationDate?: string;
+    /** The company's VAT number */
+    vatNumber?: string;
+    /** The company's website */
+    website?: string;
+    /** Street and building number where the corporate is located. */
     address: string;
+    /** Postal code where the corporate is located. */
     postalCode: string;
+    /** City where the corporate is located. */
     city: string;
+    /** Two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) where the corporate is located */
     country: string;
+    /** State/County where the corporate is located. */
     countryState: string;
     /** List of individuals representing the company and authorized to act on it's behalf. */
     representatives: Representative[];
@@ -371,16 +420,138 @@ interface CorporateProfileDetails {
     /** List of Individual who has powers to legally bind the company (power of procuration). */
     directors: Director[];
 }
-interface CorporateProfileDetailsRequest {
+/**
+ * @group Profiles
+ */
+type UpdateProfileDetailsInput = {
+    /** The profile ID to update. */
+    profile: string;
+    personal: PersonalProfileDetails;
+} | {
+    /** The profile ID to update. */
+    profile: string;
     corporate: CorporateProfileDetails;
+};
+/**
+ * @group Profiles
+ */
+type PersonalProfileForm = {
+    /** The occupation code representing the individual's current employment status. */
+    occupation: 'OCCUPATION_STUDENT' | 'OCCUPATION_EMPLOYED' | 'OCCUPATION_SELF_EMPLOYED' | 'OCCUPATION_UNEMPLOYED' | 'OCCUPATION_RETIRED';
+    /** The profession code representing the individual's professional field. */
+    profession: 'PROF_ACCOUNTANCY' | 'PROF_ADMINISTRATIVE' | 'PROF_AGRICULTURE' | 'PROF_ARTS_MEDIA' | 'PROF_BROKER_DEALER' | 'PROF_CATERING_HOSPITALITY' | 'PROF_CHARITY' | 'PROF_CONSTRUCTION_REAL_ESTATE' | 'PROF_DEALER_HIGH_VALUE_GOODS' | 'PROF_DEALER_PRECIOUS_METALS' | 'PROF_EDUCATION' | 'PROF_EMERGENCY_SERVICES' | 'PROF_EXTRACTIVE_INDUSTRY' | 'PROF_FIN_SERVICES_BANKING' | 'PROF_FIN_SERVICES_INSURANCE' | 'PROF_FIN_SERVICES_OTHER' | 'PROF_FIN_SERVICES_PRIVATE_BANKING' | 'PROF_GAMBLING' | 'PROF_GOVERNMENT' | 'PROF_HEALTHCARE_MEDICAL' | 'PROF_INFORMATION_TECHNOLOGY' | 'PROF_LEGAL' | 'PROF_MANUFACTURING' | 'PROF_MARKETING' | 'PROF_MILITARY_DEFENCE' | 'PROF_MONEY_SERVICE_BUSINESS' | 'PROF_PENSIONER' | 'PROF_PUBLIC_PROCUREMENT' | 'PROF_RETAIL_SALES';
+    /** The origin of the fund code representing the source of the individual's funds. */
+    fundOrigin: 'FUND_ORIGIN_SALARY' | 'FUND_ORIGIN_DIVIDENDS' | 'FUND_ORIGIN_INHERITANCE' | 'FUND_ORIGIN_SAVINGS' | 'FUND_ORIGIN_INVESTMENT' | 'FUND_ORIGIN_GIFT' | 'FUND_ORIGIN_MINING' | 'FUND_ORIGIN_REAL_ESTATE' | 'FUND_ORIGIN_LOAN';
+    /** The code representing the individual's annual income range. */
+    annualIncome: 'ANNUAL_INCOME_UNDER_10K' | 'ANNUAL_INCOME_10K_TO_50K' | 'ANNUAL_INCOME_50K_TO_150K' | 'ANNUAL_INCOME_150K_TO_300K' | 'ANNUAL_INCOME_OVER_300K';
+    /** The code representing the individual's monthly turnover range. */
+    monthlyTurnover: 'TURNOVER_UNDER_10K' | 'TURNOVER_10K_TO_50K' | 'TURNOVER_50K_TO_150K' | 'TURNOVER_150K_TO_500K' | 'TURNOVER_OVER_500K';
+    /** The code representing the number of transactions the individual makes each month. */
+    monthlyTransactionCount: 'TRANSACTION_COUNT_LESS_THAN_5' | 'TRANSACTION_COUNT_5_TO_50' | 'TRANSACTION_COUNT_50_TO_100' | 'TRANSACTION_COUNT_100_TO_200' | 'TRANSACTION_COUNT_OVER_200';
+    /** List of codes representing the individual's financial activities. */
+    activities: ('ACTIVITY_COMMERCE_SELLING' | 'ACTIVITY_COMMERCE_BUYING' | 'ACTIVITY_INVESTING_CRYPTO' | 'ACTIVITY_OTHER')[];
+    /** A description of the other activity if the code `ACTIVITY_OTHER` is chosen. */
+    activityOther?: string;
+    /** Indicates whether the individual holds a politically exposed person (PEP) status. */
+    publicFunction: boolean;
+    /** Indicates whether the individual is the owner of the funds. */
+    fundOwner: boolean;
+    /** Indicates whether the individual is a United States citizen. */
+    usCitizen: boolean;
+    /** Indicates whether the individual is subject to US tax obligations (e.g. holds a US tax identification number or is a US resident for tax purposes). */
+    usTaxPerson: boolean;
+    /** Tax Identification Number (TIN) assigned by the individual's tax authority. Format varies by country (e.g. SSN in the US, NI number in the UK). */
+    taxId: string;
+};
+/**
+ * Form for a company
+ * @group Profiles
+ */
+type CorporateProfileForm = {
+    /** A brief description of the company's services. */
+    service: string;
+};
+/**
+ * @group Profiles
+ */
+type UpdateProfileFormInput = {
+    /** The profile ID to update. */
+    profile: string;
+    personal: PersonalProfileForm;
+} | {
+    /** The profile ID to update. */
+    profile: string;
+    corporate: CorporateProfileForm;
+};
+/**
+ * @group Profiles
+ */
+interface CreateProfileInput {
+    /** Determines whether the profile is personal or corporate, and which body structure to use in subsequent PATCH endpoints. */
+    kind: ProfileKind;
+    /** Optional partner-supplied profile ID. */
+    id?: string;
+}
+/**
+ * @group Profiles
+ */
+type KYCProvider = 'sumsub';
+/**
+ * @group Profiles
+ */
+interface ShareProfileKYCInput {
+    /** Id of the profile to share. */
+    profile: string;
+    /** Determines whether the profile is personal or corporate, and which body structure to use in subsequent PATCH endpoints. */
+    provider: KYCProvider;
+    /** Token for a personal profile applicant. */
+    personal: {
+        /** Provider-issued applicant token. */
+        token: string;
+    };
+}
+/**
+ * @group Profiles
+ */
+interface PersonalProfileVerification {
+    /** The type of the verification. */
+    kind: PersonalVerificationKind;
+    /** ID of a previously uploaded file associated with this verification. */
+    fileId: string;
+}
+/**
+ * @group Profiles
+ */
+interface CorporateProfileVerification {
+    /** The type of the verification. */
+    kind: CorporateVerificationKind;
+    /** ID of a previously uploaded file associated with this verification. */
+    fileId: string;
 }
-type SubmitProfileDetailsPayload = PersonalProfileDetailsRequest | CorporateProfileDetailsRequest;
+/**
+ * @group Profiles
+ */
+type UpdateProfileVerificationsInput = {
+    /** The profile ID to update. */
+    profile: string;
+    personal: PersonalProfileVerification[];
+} | {
+    /** The profile ID to update. */
+    profile: string;
+    corporate: CorporateProfileVerification[];
+};
+/**
+ * @group Addresses
+ */
 interface AddressesQueryParams {
     /** Filter the list by profile */
     profile?: string;
     /** Filter the list by chain */
     chain?: Chain | ChainId;
 }
+/**
+ * @group Addresses
+ */
 interface Address {
     /** The id of the profile the address belongs to. */
     profile: string;
@@ -389,84 +560,146 @@ interface Address {
     /** Which chains is the address linked on. */
     chains: Chain[];
 }
+/**
+ * @group Addresses
+ */
 interface AddressesResponse {
     addresses: Address[];
 }
+/**
+ * @group Addresses
+ */
 interface CurrencyBalance {
     currency: Currency;
     amount: string;
 }
+/**
+ * @group Addresses
+ */
+interface GetBalancesParams {
+    address: string;
+    chain: Chain | ChainId;
+    currencies?: Currency | Currency[];
+}
+/**
+ * @group Addresses
+ */
 interface Balances {
     id: string;
     address: string;
     chain: Chain;
     balances: CurrencyBalance[];
 }
-declare enum OrderKind {
-    redeem = "redeem",
-    issue = "issue"
-}
-declare enum OrderState {
-    placed = "placed",
-    pending = "pending",
-    processed = "processed",
-    rejected = "rejected"
+/**
+ * @group Orders
+ */
+type PaymentStandard = 'iban' | 'scan' | 'chain' | 'account';
+/**
+ * @group Orders
+ */
+interface Identifier {
+    standard: PaymentStandard;
+    bic?: string;
 }
+/**
+ * @group Orders
+ */
+type OrderKind = 'issue' | 'redeem';
+/**
+ * @group Orders
+ */
+type OrderState = 'placed' | 'pending' | 'processed' | 'rejected';
+/**
+ * @group Orders
+ */
 interface Fee {
     provider: 'satchel';
     currency: Currency;
     amount: string;
 }
+/**
+ * @group Orders
+ */
 interface IBANIdentifier extends Identifier {
-    standard: PaymentStandard.iban;
+    standard: 'iban';
     iban: string;
 }
+/**
+ * @group Orders
+ */
 interface CrossChainIdentifier extends Identifier {
-    standard: PaymentStandard.chain;
+    standard: 'chain';
     /** The receivers address */
     address: string;
     /** The receivers network  */
     chain: Chain | ChainId;
 }
+/**
+ * @group Orders
+ */
 interface BankAccountIdentifier extends Identifier {
     /** The standard of the bank account. This is used to identify generic bank account. */
-    standard: PaymentStandard.account;
+    standard: 'account';
     /** The account number of the bank account. */
     accountNumber: number;
     /** The address of the bank account holder. */
     address: string;
 }
+/**
+ * @group Orders
+ */
 interface SCANIdentifier extends Identifier {
-    standard: PaymentStandard.scan;
+    standard: 'scan';
     sortCode: string;
     accountNumber: string;
 }
+/**
+ * @group Orders
+ */
 interface Individual extends CounterpartDetails {
     firstName?: string;
     lastName?: string;
     address?: string;
 }
+/**
+ * @group Orders
+ */
 interface Corporation extends CounterpartDetails {
     companyName: string;
 }
+/**
+ * @group Orders
+ */
 interface Issuer {
     /** The sender name. This can be a corporate or an individual. */
     name: string;
 }
+/**
+ * @group Orders
+ */
 interface Counterpart {
     identifier: IBANIdentifier | SCANIdentifier | CrossChainIdentifier | BankAccountIdentifier;
     details: Individual | Corporation | Issuer;
 }
+/**
+ * @group Orders
+ */
 interface CounterpartDetails {
     name?: string;
     bank?: CounterpartBank;
     country?: string;
 }
+/**
+ * @group Orders
+ */
 interface CounterpartBank {
     name?: string;
     address?: string;
     bic?: string;
 }
+/**
+ * @group Orders
+ */
 interface OrderMetadata {
     placedAt: string;
     processedAt?: string;
@@ -474,7 +707,10 @@ interface OrderMetadata {
     txHashes?: string[];
     supportingDocumentId?: string;
 }
-interface OrderFilter {
+/**
+ * @group Orders
+ */
+interface OrderParams {
     address?: string;
     txHash?: string;
     profile?: string;
@@ -482,6 +718,9 @@ interface OrderFilter {
     accountId?: string;
     state?: OrderState;
 }
+/**
+ * @group Orders
+ */
 interface Order {
     id: string;
     profile: string;
@@ -496,25 +735,20 @@ interface Order {
     meta: OrderMetadata;
     state: OrderState;
 }
+/**
+ * @group Orders
+ */
 interface OrdersResponse {
     orders: Order[];
 }
 /**
- * Information about the EURe token on different networks.
+ * @group Orders
  */
-interface Token {
-    currency: Currency;
-    ticker: Ticker;
-    symbol: TokenSymbol;
-    chain: Chain;
-    /** The address of the EURe contract on this network */
-    address: string;
-    /** How many decimals this token supports */
-    decimals: number;
-}
-type NewOrder = NewOrderByAddress | NewOrderByAccountId;
-interface NewOrderCommon {
+interface PlaceOrderInput {
     /** The unique identifier of the order */
+    address: string;
+    /** The senders network  */
+    chain: Chain | ChainId;
     id?: string;
     amount: string;
     signature: string;
@@ -524,20 +758,18 @@ interface NewOrderCommon {
     memo?: string;
     supportingDocumentId?: string;
 }
-interface NewOrderByAddress extends NewOrderCommon {
-    address: string;
-    /** The senders network  */
-    chain: Chain | ChainId;
-}
-interface NewOrderByAccountId extends NewOrderCommon {
-    accountId: string;
-}
+/**
+ * @group Files
+ */
 interface SupportingDocMetadata {
     uploadedBy: string;
     createdAt: string;
     updatedAt: string;
 }
-interface SupportingDoc {
+/**
+ * @group Files
+ */
+interface FilesResponse {
     id: string;
     name: string;
     type: string;
@@ -545,7 +777,10 @@ interface SupportingDoc {
     hash: string;
     meta: SupportingDocMetadata;
 }
-interface LinkAddress {
+/**
+ * @group Addresses
+ */
+interface LinkAddressInput {
     /** Profile ID that owns the address. */
     profile?: string;
     /** The public key of the blockchain account. */
@@ -564,7 +799,10 @@ interface LinkAddress {
     signature: string;
     chain: Chain | ChainId;
 }
-interface LinkedAddress {
+/**
+ * @group Addresses
+ */
+interface LinkAddressResponse {
     profile: string;
     address: string;
     state: string;
@@ -573,103 +811,79 @@ interface LinkedAddress {
         linkedAt: string;
     };
 }
-interface RequestIbanPayload {
+type LinkAddress = LinkAddressResponse;
+/**
+ * @group IBANs
+ */
+type IBANState = 'requested' | 'approved' | 'pending' | 'rejected' | 'closed';
+/**
+ * @group IBANs
+ */
+interface RequestIbanInput {
     /** the address to request the IBAN. */
     address: string;
     /** the chain to request the IBAN. */
     chain: Chain | ChainId;
     /** payment email notifications sent to customers, `true` by default. */
-    emailNotifications: boolean;
+    emailNotifications?: boolean;
 }
-interface IbansQueryParams {
+/**
+ * @group IBANs
+ */
+interface IbansParams {
     profile?: string;
     chain?: Chain | ChainId;
 }
+/**
+ * @group IBANs
+ */
 interface IBAN {
+    /** The IBAN is a unique identifier for a bank account across different countries and includes a two-letter country code, two check digits, and a number of alphanumeric characters. It may include spaces for readability but should be stored without spaces. */
     iban: string;
+    /** Bank Identifier Code (BIC) of the bank associated with this IBAN. */
     bic: string;
+    /** The profile id that owns the IBAN */
     profile: string;
+    /** The address that this IBAN is connected to */
     address: string;
+    /** The chain that this IBAN is connected to */
     chain: Chain;
-    state: AccountState;
+    name: string;
+    state: IBANState;
     emailNotifications: boolean;
 }
+/**
+ * @group IBANs
+ */
 interface IBANsResponse {
     ibans: IBAN[];
 }
-interface MoveIbanPayload {
+/**
+ * @group IBANs
+ */
+interface MoveIbanInput {
+    iban: string;
     /** the address to move iban to */
     address: string;
     /** the chain to move iban to */
     chain: Chain | ChainId;
 }
-interface OrderNotificationQueryParams {
-    state?: OrderState;
-    profile?: string;
-}
 /**
- * @deprecated Will be removed in v4 in favour of 'MoneriumClientOptions'
+ * @group Primitives
+ * @internal
  */
-type ClassOptions = {
-    environment?: ENV;
-    debug?: boolean;
-} & BearerTokenCredentials;
-interface AuthFlowOptionsShared {
-    /** the state oauth parameter */
-    state?: string;
-}
-/**
- * @deprecated Will be removed in v4 in favour of 'BuildAuthorizationUrlOptions'
- */
-interface AuthFlowOptions extends AuthFlowOptionsShared {
-    /** the email of the user to prefill the login form */
-    email?: string;
-    /**
-     * skip account creation in auth flow
-     * @deprecated: acccount creation is no longer offered in the auth flow
-     */
-    skipCreateAccount?: boolean;
-    /** skip KYC in auth flow */
-    skipKyc?: boolean;
-    /** the address your customer should link in auth flow */
-    address?: string;
-    /** the signature of the address */
-    signature?: string;
-    /** the chain of the address */
-    chain?: Chain | ChainId;
-}
-/**
- * @deprecated Will be removed in v4 in favour of 'BuildSiweAuthorizationUrlOptions'
- */
-interface AuthFlowSIWEOptions extends AuthFlowOptionsShared {
-    /** Signature for the SIWE message. Must include the 0x prefix. */
-    signature: string;
-    /**
-     * An EIP-4361 compatible message. https://eips.ethereum.org/EIPS/eip-4361
-     *
-     * https://monerium.com/siwe
-     * */
-    message: string;
-}
-interface ClientCredentials {
-    clientId: string;
-    clientSecret: string;
-}
-interface AuthorizationCodeCredentials {
-    clientId: string;
-    redirectUri: string;
-}
-type BearerTokenCredentials = ClientCredentials | AuthorizationCodeCredentials;
-type ResponseStatus = {
-    status: number;
-    statusText: string;
+type AcceptedResponse = {
+    code: 202;
+    status: 'Accepted';
 };
 /**
  * Type of pending signature
+ * @group Signatures
  */
 type PendingSignatureKind = 'linkAddress' | 'order';
 /**
  * Base interface for pending signatures
+ * @group Signatures
  */
 interface PendingSignatureBase {
     kind: PendingSignatureKind;
@@ -679,6 +893,7 @@ interface PendingSignatureBase {
 }
 /**
  * Pending signature for an order
+ * @group Signatures
  */
 interface PendingOrderSignature extends PendingSignatureBase {
     id: string;
@@ -689,18 +904,21 @@ interface PendingOrderSignature extends PendingSignatureBase {
 }
 /**
  * Pending signature for linking an address
+ * @group Signatures
  */
 interface PendingLinkAddressSignature extends PendingSignatureBase {
     kind: 'linkAddress';
 }
 /**
  * Union type for all pending signature types
+ * @group Signatures
  */
 type PendingSignature = PendingOrderSignature | PendingLinkAddressSignature;
 /**
  * Query parameters for fetching pending signatures
+ * @group Signatures
  */
-interface SignaturesQueryParams {
+interface SignaturesParams {
     /** Filter by blockchain address */
     address?: string;
     /** Filter by blockchain network */
@@ -712,6 +930,7 @@ interface SignaturesQueryParams {
 }
 /**
  * Response from the signatures endpoint
+ * @group Signatures
  */
 interface SignaturesResponse {
     /** Array of pending signatures */
@@ -719,193 +938,61 @@ interface SignaturesResponse {
     /** Total number of pending signatures */
     total: number;
 }
-
-type MoneriumClientOptions = {
-    environment?: ENV;
-    getAccessToken: () => string | Promise<string>;
-    accessToken?: never;
-    transport?: Transport;
-} | {
-    environment?: ENV;
-    accessToken: string;
-    getAccessToken?: never;
-    transport?: Transport;
-} | {
-    environment?: ENV;
-    accessToken?: never;
-    getAccessToken?: never;
-    transport?: Transport;
-};
 /**
- * Creates a Monerium client instance.
- * @beta
- * @group v4
- * @category v4 - Client instance.
+ * @group Webhooks
  */
-declare function createMoneriumClient(options: MoneriumClientOptions): {
-    /**
-     * @group Authentication
-     * @see {@link https://docs.monerium.com/api#tag/auth/operation/auth-context | API Documentation}
-     */
-    getAuthContext: () => Promise<AuthContext>;
-    /**
-     * @group Profiles
-     * @param {string} profile - the id of the profile to fetch.
-     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/profile | API Documentation}
-     */
-    getProfile: (id: string) => Promise<Profile>;
-    /**
-     * @group Profiles
-     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/profiles | API Documentation}
-     */
-    getProfiles: (params?: ProfilesQueryParams) => Promise<ProfilesResponse>;
-    /**
-     * @group Profiles
-     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/patch-profile-details | API Documentation}
-     */
-    submitProfileDetails: (profileId: string, body: SubmitProfileDetailsPayload) => Promise<ResponseStatus>;
-    /**
-     * Get details for a single address by using the address public key after the
-     * address has been successfully linked to Monerium.
-     *
-     * @group Addresses
-     * @param {string} address - The public key of the blockchain account.
-     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/address | API Documentation}
-     */
-    getAddress: (address: string) => Promise<Address>;
-    /**
-     * @group Addresses
-     * @param {AddressesQueryParams} [params] - No required parameters.
-     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/addresses | API Documentation}
-     */
-    getAddresses: (params?: AddressesQueryParams) => Promise<AddressesResponse>;
-    /**
-     * @group Addresses
-     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/balances | API Documentation}
-     */
-    getBalances: (address: string, chain: Chain | ChainId, currencies?: Currency | Currency[]) => Promise<Balances>;
-    /**
-     * Add a new address to the profile.
-     *
-     * @group Addresses
-     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/link-address | API Documentation}
-     */
-    linkAddress: (payload: LinkAddress) => Promise<LinkedAddress>;
-    /**
-     * Fetch details about a single IBAN.
-     *
-     * @group IBANs
-     * @param {string} iban - the IBAN to fetch.
-     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/iban | API Documentation}
-     */
-    getIban: (iban: string) => Promise<IBAN>;
-    /**
-     * Fetch all IBANs for the profile.
-     *
-     * @group IBANs
-     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/ibans | API Documentation}
-     */
-    getIbans: (params?: IbansQueryParams) => Promise<IBANsResponse>;
-    /**
-     * @group IBANs
-     * @param {RequestIbanPayload} payload
-     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/request-iban | API Documentation}
-     */
-    requestIban: ({ address, chain, emailNotifications, }: RequestIbanPayload) => Promise<ResponseStatus>;
-    /**
-     * @group IBANs
-     * @param {string} iban - the IBAN to move.
-     * @param {MoveIbanPayload} payload - the payload to move the IBAN.
-     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/move-iban | API Documentation}
-     */
-    moveIban: (iban: string, { address, chain }: MoveIbanPayload) => Promise<ResponseStatus>;
-    /**
-     * @group Orders
-     * @see {@link https://docs.monerium.com/api/#tag/orders/operation/order | API Documentation}
-     */
-    getOrder: (orderId: string) => Promise<Order>;
-    /**
-     * @group Orders
-     * @see {@link https://docs.monerium.com/api/#tag/orders/operation/orders | API Documentation}
-     */
-    getOrders: (filter?: OrderFilter) => Promise<OrdersResponse>;
-    /**
-     * Place a new order.
-     *
-     * **Note:** For multi-signature orders, the API returns a 202 Accepted response
-     * with `{status: 202, statusText: "Accepted"}` instead of the full Order object.
-     *
-     * @returns Promise that resolves to either:
-     * - `Order` - Full order object for regular orders
-     * - `ResponseStatus` - Status object for multi-sig orders
-     *
-     * @group Orders
-     * @see {@link https://docs.monerium.com/api#tag/orders/operation/post-orders | API Documentation}
-     */
-    placeOrder: (order: NewOrder) => Promise<Order | ResponseStatus>;
-    /**
-     * @group Tokens
-     * @see {@link https://docs.monerium.com/api#tag/tokens | API Documentation}
-     */
-    getTokens: () => Promise<Token[]>;
-    /**
-     * Get pending signatures for the authenticated user.
-     *
-     * @group Signatures
-     * @param {SignaturesQueryParams} [params] - Optional query parameters to filter signatures.
-     * @see {@link https://docs.monerium.com/api#tag/signatures/operation/get-signatures | API Documentation}
-     */
-    getSignatures: (params?: SignaturesQueryParams) => Promise<SignaturesResponse>;
-    /**
-     * @group Files
-     * @see {@link https://docs.monerium.com/api/#tag/files | API Documentation}
-     */
-    /**
-     * Upload a supporting document for KYC onboarding or order support.
-     *
-     * Requires `Blob` and `FormData` support — available in Node.js 18+,
-     * browsers, and Cloudflare Workers. Not available in all environments.
-     *
-     * @param document - File content as a `Blob`, `Uint8Array`, or `ArrayBuffer`.
-     *   Node.js `Buffer` is a `Uint8Array` and works directly.
-     * @param filename - Optional filename sent to the API (e.g. `'kyc.pdf'`).
-     */
-    uploadSupportingDocument: (document: Blob | Uint8Array | ArrayBuffer, filename?: string) => Promise<SupportingDoc>;
-};
-
+type WebhookSubscriptionState = 'active' | 'inactive';
+/**
+ * @group Webhooks
+ */
+type WebhookEventType = 'iban.updated' | 'order.created' | 'order.updated' | 'profile.updated';
 /**
- * @group v4
- * @category v4 - Authorization
- * @beta
+ * @group Webhooks
+ */
+interface WebhookSubscription {
+    id: string;
+    url: string;
+    types: WebhookEventType[];
+    state: WebhookSubscriptionState;
+}
+/**
+ * @group Webhooks
+ */
+interface WebhookSubscriptionsResponse {
+    subscriptions: WebhookSubscription[];
+}
+/**
+ * @group Webhooks
+ */
+interface CreateWebhookSubscriptionInput {
+    url: string;
+    secret: string;
+    types?: WebhookEventType[];
+}
+/**
+ * @group Webhooks
+ */
+interface UpdateWebhookSubscriptionInput {
+    subscription: string;
+    state?: WebhookSubscriptionState;
+    types?: WebhookEventType[];
+}
+/**
+ * @category Types
  */
 interface BuildAuthorizationUrlOptions {
-    environment?: ENV;
     clientId: string;
     redirectUri: string;
     codeChallenge: string;
     state?: string;
     email?: string;
     skipKyc?: boolean;
-    address?: string;
-    signature?: string;
-    chain?: string;
+    authMode?: 'login' | 'signup';
 }
 /**
- * Build the authorization redirect URL.
- * Returns a URL string — the caller navigates to it.
- * The SDK does not redirect.
- * @group v4
- * @category v4 - Authorization
- * @beta
- */
-declare const buildAuthorizationUrl: (options: BuildAuthorizationUrlOptions) => string;
-/**
- * @group v4
- * @category v4 - Authorization
- * @beta
+ * @category Types
  */
 interface BuildSiweAuthorizationUrlOptions {
-    environment?: ENV;
     clientId: string;
     redirectUri: string;
     codeChallenge: string;
@@ -914,490 +1001,390 @@ interface BuildSiweAuthorizationUrlOptions {
     state?: string;
 }
 /**
- * Build the SIWE authorization redirect URL.
- * Returns a URL string — the caller navigates to it.
- * The SDK does not redirect.
- *
- * @group v4
- * @category v4 - Authorization
- * @beta
- */
-declare const buildSiweAuthorizationUrl: (options: BuildSiweAuthorizationUrlOptions) => string;
-/**
- * @group v4
- * @category v4 - Authorization
- * @beta
+ * @category Types
  */
 interface AuthorizationCodeGrantOptions {
-    environment?: ENV;
     clientId: string;
     redirectUri: string;
     code: string;
     codeVerifier: string;
-    transport?: Transport;
 }
 /**
- * Exchange an authorization code for tokens.
- * The caller stores the returned BearerProfile — the SDK does not write to any storage.
- *
- * @group v4
- * @category v4 - Authorization
- * @beta
+ * @category Types
  */
-declare const authorizationCodeGrant: (options: AuthorizationCodeGrantOptions) => Promise<BearerProfile>;
 interface RefreshTokenGrantOptions {
-    environment?: ENV;
     clientId: string;
     refreshToken: string;
-    transport?: Transport;
 }
 /**
- * Get a new access token using a refresh token.
- * The caller stores the returned BearerProfile — the SDK does not write to any storage.
- * @beta
+ * @category Types
  */
-declare const refreshTokenGrant: (options: RefreshTokenGrantOptions) => Promise<BearerProfile>;
 interface ClientCredentialsGrantOptions {
-    environment?: ENV;
     clientId: string;
     clientSecret: string;
-    transport?: Transport;
-}
-/**
- * Get an access token using client credentials. Server-side only.
- * clientSecret must never be used in a browser context.
- *
- * @group v4
- * @category v4 - Authorization
- * @beta
- */
-declare const clientCredentialsGrant: (options: ClientCredentialsGrantOptions) => Promise<BearerProfile>;
-/**
- * @group v4
- * @category v4 - Authorization
- * @beta
- */
-interface ParsedAuthorizationResponse {
-    code?: string;
-    state?: string;
-    error?: string;
-    errorDescription?: string;
 }
-/**
- * Parse a callback URL or query string into structured fields.
- *
- * - No globals. No side effects. Never throws.
- * - Returns an empty object if none of the expected parameters are present.
- * - Check for the presence of `code` or `error` to determine if the URL
- *   contains an OAuth2 authorization response.
- *
- * @example
- * const { code, error } = parseAuthorizationResponse(req.url);
- * const { code, error } = parseAuthorizationResponse('?code=abc&state=xyz');
- * @experimental  may not be included in v4
- * @group v4
- * @category v4 - Helpers
- */
-declare const parseAuthorizationResponse: (input: string) => ParsedAuthorizationResponse;
 
 /**
- * Generate a cryptographically random PKCE code verifier (RFC 7636).
- * Returns a base64url-encoded string of 32 random bytes (256 bits of entropy).
- * The caller is responsible for storing this until the callback.
- * @group v4
- * @category v4 - PKCE
+ * Get Environment configuration for the given environment. Defaults to 'sandbox' if not specified.
+ * @param env - The target environment (`'sandbox'` or `'production'`). Defaults to `'sandbox'`.
+ * @returns Environment configuration
  */
-declare const randomPKCECodeVerifier: () => string;
+declare function getEnv(env?: ENV): Environment;
+
 /**
- * Derive the S256 code challenge from a code verifier.
- * Synchronous. Returns a base64url-encoded SHA-256 hash.
- * @group v4
- * @category v4 - PKCE
+ * @group Client
+ * @category Types
  */
-declare const calculatePKCECodeChallenge: (codeVerifier: string) => string;
-
+type TransportRequest = {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: BodyInit | string;
+    signal?: AbortSignal;
+};
 /**
- * Thrown when the Monerium API returns a non-2xx response.
- * Fields map directly to the API response body — nothing is translated or normalised.
- *
- * @example
- * try {
- *   await client.getProfiles();
- * } catch (err) {
- *   if (err instanceof MoneriumApiError) {
- *     console.log(err.code);    // 401
- *     console.log(err.status);  // "Unauthorized"
- *     console.log(err.message); // "Not authenticated"
- *     console.log(err.errors);  // field-level validation errors, if present
- *   }
- * }
- * @group v4
- * @category v4 - Errors
+ * @group Client
+ * @category Types
  */
-declare class MoneriumApiError extends Error {
-    code: number;
-    status: string;
-    errors?: Record<string, string>;
-    details?: unknown;
-    constructor(body: {
-        code: number;
-        status: string;
-        message: string;
-        errors?: Record<string, string>;
-        details?: unknown;
-    });
-}
-type MoneriumSdkErrorType = 'network_error' | 'authentication_required' | 'invalid_configuration';
+type TransportResponse = {
+    status: number;
+    headers?: Record<string, string>;
+    bodyText: string;
+};
 /**
- * Thrown for SDK-level failures — no HTTP response involved.
- *
- * @example
- * try {
- *   await client.getProfiles();
- * } catch (err) {
- *   if (err instanceof MoneriumSdkError) {
- *     console.log(err.type);  // 'network_error' | 'authentication_required' | ...
- *     console.log(err.cause); // underlying fetch error, if type === 'network_error'
- *   }
- * }
- * @group v4
- * @category v4 - Errors
+ * Replaces the internal `fetch` call. Headers (`Authorization`, `Content-Type`,
+ * `Accept`) are pre-populated. Must return a `Promise` resolving with the raw
+ * response `status` and `bodyText`. Throw on network-level failures.
+ * The SDK owns JSON parsing and error normalisation.
+ * @group Client
+ * @category Types
  */
-declare class MoneriumSdkError extends Error {
-    type: MoneriumSdkErrorType;
-    cause?: unknown;
-    constructor(type: MoneriumSdkErrorType, message: string, cause?: unknown);
-}
+type Transport = (request: TransportRequest) => Promise<TransportResponse>;
 
+interface MoneriumApiClientOptions {
+    environment?: ENV;
+    getAccessToken: () => Promise<string | undefined> | string | undefined;
+    transport?: Transport;
+}
 /**
- * @deprecated Class will be removed in v4 in favour of 'createMoneriumClient' function.
- *
- * In the [Monerium UI](https://monerium.app/), create an application to get the `clientId` and register your `redirectUri`.
- * ```ts
- * import { MoneriumClient } from '@monerium/sdk';
- *
- * const monerium = new MoneriumClient() // defaults to `sandbox`
- *
- * // or
- * new MoneriumClient('production')
- *
- * // or
- * new MoneriumClient({
- *  environment: 'sandbox',
- *  clientId: 'your-client-id',
- *  redirectUri: 'http://your-redirect-url.com/monerium'
- * });
- *
- *```
+ * Base abstract client containing the shared configuration and request logic.
  */
-declare class MoneriumClient {
-    #private;
-    /**
-     * The bearer profile will be available after authentication, it includes the `access_token` and `refresh_token`
-     * */
-    bearerProfile?: BearerProfile;
-    /**
-     * The client is authorized if the bearer profile is available
-     */
-    isAuthorized: boolean;
-    /**
-     * The state parameter is used to maintain state between the request and the callback.
-     * */
-    state: string | undefined;
-    /**
-     * @deprecated  Class will be removed in v4 in favour of 'createMoneriumClient' function.
-     *
-     * @defaultValue `sandbox`
-     * */
-    constructor(envOrOptions?: ENV | ClassOptions);
-    /**
-     * @deprecated will be removed in v4 - in favour of `buildAuthorizationUrl`
-     * Constructs the url to the authorization code flow and redirects,
-     * Code Verifier needed for the code challenge is stored in local storage
-     * For automatic wallet link, add the following properties: `address`, `signature` & `chain`
-     *
-     * This authorization code is then used to request an access token via the token endpoint. (https://docs.monerium.com/api#operation/auth-token)
-     *
-     * @group Authentication
-     * @see {@link https://docs.monerium.com/api#tag/auth/operation/auth | API Documentation}
-     * @param {AuthFlowOptions} [params] - the auth flow params
-     * @returns void
-     *
-     */
-    authorize(params?: AuthFlowOptions): Promise<void>;
+declare abstract class MoneriumBaseClient {
+    protected options: MoneriumApiClientOptions;
+    protected env: ReturnType<typeof getEnv>;
+    protected transport: Transport;
+    constructor(options: MoneriumApiClientOptions);
+    protected getToken(): Promise<string | undefined>;
+    protected request<T>(method: string, path: string, body?: unknown, contentType?: string): Promise<T>;
+    protected requestFormData<T>(method: string, path: string, form: FormData): Promise<T>;
     /**
-     * @deprecated will be removed in v4 - in favour of `buildSiweAuthorizationUrl`
-     * Constructs the url to the authorization code flow and redirects,
-     * Code Verifier needed for the code challenge is stored in local storage
-     *
-     * "Sign in with Ethereum" (SIWE) flow can be used for existing Monerium customers.
-     *  In this case the payload must include a valid EIP-4361 (https://eips.ethereum.org/EIPS/eip-4361) message and signature.
-     *  On successful authorization the authorization code is returned at once.
-     *
-     * This authorization code is then used to request an access token via the token endpoint.
-     *
-     * https://monerium.com/siwe
-     *
-     * @group Authentication
-     * @see {@link https://docs.monerium.com/api#tag/auth/operation/auth | API Documentation}
-     * @param {AuthFlowSIWEOptions} [params] - the auth flow SIWE params
-     * @returns void
-     *
-     */
-    siwe(params: AuthFlowSIWEOptions): Promise<void>;
-    /**
-     * @deprecated Will be removed in v4 in favour of 'authorizationCodeGrant', 'refreshTokenGrant' and 'clientCredentialsGrant'
-     * Will use the authorization code flow code to get access token
-     *
-     * @group Authentication
-     *
-     * @param {string} refreshToken - provide the refresh token to get a new access token
-     *
-     * @returns boolean to indicate if access has been granted
-     *
-     * @example
-     * ```ts
-     *   import { MoneriumClient } from '@monerium/sdk';
-     *  // Initialize the client with credentials
-     *  const monerium = new MoneriumClient({
-     *    environment: 'sandbox',
-     *    clientId: 'your_client_credentials_uuid', // replace with your client ID
-     *    clientSecret: 'your_client_secret', // replace with your client secret
-     *  });
-     *
-     * await monerium.getAccess();
-     *
-     * const refreshToken = monerium.bearerProfile?.refresh_token;
-     *
-     * // TODO: store the refresh token securely
+     * Get the current auth context.
      *
-     * // reconnect...
-     * await monerium.getAccess(refreshToken);
-     * ```
-     */
-    getAccess(refreshToken?: string): Promise<boolean>;
-    /**
-     * @group Authentication
      * @see {@link https://docs.monerium.com/api#tag/auth/operation/auth-context | API Documentation}
      */
     getAuthContext(): Promise<AuthContext>;
     /**
-     * @group Profiles
-     * @param {string} profile - the id of the profile to fetch.
+     * Get a profile by its id.
+     *
+     * @param profileId - The id of the profile to fetch.
      * @see {@link https://docs.monerium.com/api#tag/profiles/operation/profile | API Documentation}
      */
-    getProfile(profile: string): Promise<Profile>;
+    getProfile(profileId: string): Promise<Profile>;
     /**
-     * @group Profiles
+     * Get all profiles.
+     *
      * @see {@link https://docs.monerium.com/api#tag/profiles/operation/profiles | API Documentation}
      */
-    getProfiles(params?: ProfilesQueryParams): Promise<ProfilesResponse>;
+    getProfiles(params?: GetProfilesParams): Promise<ProfilesResponse>;
     /**
-     *
-     * Get details for a single address by using the address public key after the address has been successfully linked to Monerium.
-     *
-     * @group Addresses
-     * @param {string} address - The public key of the blockchain account.
+     * Get details for a single address after it has been linked to Monerium.
+     * @param address - The public key of the blockchain account.
      *
      * @see {@link https://docs.monerium.com/api#tag/addresses/operation/address | API Documentation}
-     *
-     * @example
-     * ```ts
-     *  monerium.getAddress('0x1234567890abcdef1234567890abcdef12345678')
-     * ```
      */
     getAddress(address: string): Promise<Address>;
     /**
-     * @group Addresses
-     * @param {AddressesQueryParams} [params] - No required parameters.
+     * Get a list of all addresses linked to the profile.
+     *
      * @see {@link https://docs.monerium.com/api#tag/addresses/operation/addresses | API Documentation}
      */
     getAddresses(params?: AddressesQueryParams): Promise<AddressesResponse>;
     /**
-     * @group Addresses
-     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/balances| API Documentation}
+     * Add a new address to the profile.
+     *
+     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/link-address | API Documentation}
+     * @returns {LinkAddressResponse | AcceptedResponse} - The address was linked successfully or an accepted response if the address is being processed asynchronously.
+     */
+    linkAddress(body: LinkAddressInput): Promise<LinkAddressResponse | AcceptedResponse>;
+    /**
+     * Get the balances for a given address on a specific chain.
+     *
+     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/balances | API Documentation}
      */
-    getBalances(address: string, chain: Chain | ChainId, currencies?: Currency | Currency[]): Promise<Balances>;
+    getBalances(params: GetBalancesParams): Promise<Balances>;
     /**
-     * Fetch details about a single IBAN
+     * Fetch details about a single IBAN.
+     * @param iban - The IBAN to fetch.
      *
-     * @group IBANs
-     * @param {string} iban - the IBAN to fetch.
      * @see {@link https://docs.monerium.com/api#tag/ibans/operation/iban | API Documentation}
      */
     getIban(iban: string): Promise<IBAN>;
     /**
-     * Fetch all IBANs for the profile
-     * @group IBANs
+     * Fetch all IBANs for the profile.
+     *
      * @see {@link https://docs.monerium.com/api#tag/ibans/operation/ibans | API Documentation}
      */
-    getIbans(queryParameters?: IbansQueryParams): Promise<IBANsResponse>;
+    getIbans(params?: IbansParams): Promise<IBANsResponse>;
     /**
-     * @group Orders
-     * @see {@link https://docs.monerium.com/api/#tag/orders/operation/orders | API Documentation}
+     * Request an IBAN for the profile.
+     *
+     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/request-iban | API Documentation}
+     */
+    requestIban(input: RequestIbanInput): Promise<AcceptedResponse>;
+    /**
+     * Move an IBAN to a different address and chain.
+     *
+     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/move-iban | API Documentation}
      */
-    getOrders(filter?: OrderFilter): Promise<OrdersResponse>;
+    moveIban(input: MoveIbanInput): Promise<AcceptedResponse>;
     /**
-     * @group Orders
+     * Get an order by its ID.
+     *
      * @see {@link https://docs.monerium.com/api/#tag/orders/operation/order | API Documentation}
      */
     getOrder(orderId: string): Promise<Order>;
     /**
-     * @group Tokens
+     * Get a list of orders.
+     *
+     * @see {@link https://docs.monerium.com/api/#tag/orders/operation/orders | API Documentation}
+     */
+    getOrders(params?: OrderParams): Promise<OrdersResponse>;
+    /**
+     * Place a new order.
+     *
+     * **Note:** For multi-signature orders, the API returns a 202 Accepted response
+     * with `{ status: 202, statusText: "Accepted" }` instead of the full Order object.
+     *
+     * @returns `Order` for regular orders; `AcceptedResponse` for multi-sig orders.
+     * @see {@link https://docs.monerium.com/api#tag/orders/operation/post-orders | API Documentation}
+     */
+    placeOrder(input: PlaceOrderInput): Promise<Order | AcceptedResponse>;
+    /**
+     * Get Monerium tokens with contract addresses and chain details.
+     *
      * @see {@link https://docs.monerium.com/api#tag/tokens | API Documentation}
      */
     getTokens(): Promise<Token[]>;
     /**
      * Get pending signatures for the authenticated user.
      *
-     * Returns pending signatures that require user action, such as order signatures
-     * or link address signatures. Accepts filtering by address, chain, kind, and profile.
-     *
-     * @group Signatures
-     * @param {SignaturesQueryParams} [params] - Optional query parameters to filter signatures
      * @see {@link https://docs.monerium.com/api#tag/signatures/operation/get-signatures | API Documentation}
+     */
+    getSignatures(params?: SignaturesParams): Promise<SignaturesResponse>;
+    /**
+     * Upload a supporting document for KYC onboarding or order support using `multipart/form-data`.
      *
-     * @example
-     * ```ts
-     * // Get all pending signatures
-     * const signatures = await monerium.getSignatures();
-     *
-     * // Get pending order signatures for a specific address
-     * const orderSignatures = await monerium.getSignatures({
-     *   address: '0x1234...',
-     *   kind: 'order'
-     * });
+     * Accepts binary data in multiple formats and normalizes it to a {@link Blob}
+     * internally before sending the request.
      *
-     * // Get pending signatures on a specific chain
-     * const polygonSignatures = await monerium.getSignatures({
-     *   chain: 'polygon'
-     * });
-     * ```
+     * @param file - The document to upload. Can be a {@link Blob}, {@link Uint8Array}, or {@link ArrayBuffer}.
+     * @param filename - Optional filename to associate with the uploaded file.
+     * If not provided, a default name will be inferred when possible, otherwise `"document"` is used.
+     * @see {@link https://docs.monerium.com/api/#tag/files | API Documentation}
+     * @remarks
+     * This method constructs a {@link FormData} payload internally and sends it to the `POST /files` endpoint.
+     * Consumers do not need to manually create or manage multipart form data.
      */
-    getSignatures(params?: SignaturesQueryParams): Promise<SignaturesResponse>;
+    uploadSupportingDocument(file: Blob | Uint8Array | ArrayBuffer, filename?: string): Promise<FilesResponse>;
+}
+/**
+ * Server-side client containing operations that require client secrets.
+ * Must never be used in a browser context.
+ */
+declare abstract class MoneriumServerClient extends MoneriumBaseClient {
     /**
-     * Add a new address to the profile
-     * @group Addresses
-     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/link-address | API Documentation}
+     * Get an access token using client credentials. Server-side only.
+     * clientSecret must never be used in a browser context.
+     *
      */
-    linkAddress(payload: LinkAddress): Promise<LinkedAddress>;
+    clientCredentialsGrant(clientId: string, clientSecret: string): Promise<BearerProfile>;
     /**
-     * Place a new order.
+     * List all webhook subscriptions for the authenticated user.
      *
-     * **Note:** For multi-signature orders, the API returns a 202 Accepted response
-     * with `{status: 202, statusText: "Accepted"}` instead of the full Order object.
-     *
-     * @returns Promise that resolves to either:
-     * - `Order` - Full order object for regular orders
-     * - `ResponseStatus` - Status object with `{status: 202, statusText: "Accepted"}` for multi-sig orders
+     * @see {@link https://docs.monerium.com/api#tag/webhooks/operation/list-subscriptions | API Documentation}
+     */
+    getSubscriptions(): Promise<WebhookSubscriptionsResponse>;
+    /**
+     * Create webhook subscription.
      *
-     * @see {@link https://docs.monerium.com/api#tag/orders/operation/post-orders | API Documentation}
+     * @see {@link https://docs.monerium.com/api#tag/webhooks/operation/create-subscription | API Documentation}
+     */
+    createSubscription(input: CreateWebhookSubscriptionInput): Promise<WebhookSubscription>;
+    /**
+     * Update an existing webhook subscription.
      *
-     * @group Orders
+     * @see {@link https://docs.monerium.com/api#tag/webhooks/operation/update-subscription | API Documentation}
      */
-    placeOrder(order: NewOrder): Promise<Order | ResponseStatus>;
+    updateSubscription(input: UpdateWebhookSubscriptionInput): Promise<WebhookSubscription>;
+}
+declare class MoneriumPrivateClient extends MoneriumServerClient {
+}
+declare class MoneriumOAuthClient extends MoneriumBaseClient {
     /**
-     * @group IBANs
-     * @param {string} iban - the IBAN to move.
-     * @param {MoveIbanPayload} payload - the payload to move the IBAN.
-     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/move-iban | API Documentation}
+     * Build the authorization redirect URL.
+     * Returns a URL string — the caller navigates to it.
+     * The SDK does not redirect.
      */
-    moveIban(iban: string, { address, chain }: MoveIbanPayload): Promise<ResponseStatus>;
+    buildAuthorizationUrl(options: Omit<BuildAuthorizationUrlOptions, 'environment'>): string;
     /**
-     * @group IBANs
-     * @param {RequestIbanPayload} payload
-     * @see {@link https://docs.monerium.com/api#tag/ibans/operation/request-iban | API Documentation}
+     * Build the SIWE authorization redirect URL.
+     * Returns a URL string — the caller navigates to it.
+     * The SDK does not redirect.
+     *
      */
-    requestIban({ address, chain, emailNotifications, }: RequestIbanPayload): Promise<ResponseStatus>;
+    buildSiweAuthorizationUrl(options: Omit<BuildSiweAuthorizationUrlOptions, 'environment'>): string;
     /**
-     * @deprecated There is no longer a PUT endpoint for profile details. Use PATCH instead.
-     * @group Profiles
-     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/profile-details | API Documentation}
+     * Exchange an authorization code for tokens.
+     * The caller stores the returned BearerProfile — the SDK does not write to any storage.
+     *
      */
-    submitProfileDetails(profile: string, body: SubmitProfileDetailsPayload): Promise<ResponseStatus>;
+    authorizationCodeGrant(options: Omit<AuthorizationCodeGrantOptions, 'environment' | 'transport'>): Promise<BearerProfile>;
     /**
-     * @group Files
-     * @see {@link https://docs.monerium.com/api/#tag/files | API Documentation}
+     * Get a new access token using a refresh token.
+     * The caller stores the returned BearerProfile — the SDK does not write to any storage.
      */
-    uploadSupportingDocument(document: File): Promise<SupportingDoc>;
+    refreshTokenGrant(options: Omit<RefreshTokenGrantOptions, 'environment' | 'transport'>): Promise<BearerProfile>;
     /**
-     * @deprecated Web sockets will be removed in v4 - use webhooks instead.
-     * Connects to the order notifications socket
+     * Parse a callback URL or query string into structured fields.
      *
-     * @group Orders
-     * @param {OrderNotificationQueryParams} [params]
-     * @see {@link https://docs.monerium.com/api#tag/orders/operation/orders-notifications | API Document - Websocket}
-  
+     * - Returns an empty object if none of the expected parameters are present.
+     * - Check for the presence of `code` or `error` to determine if the URL
+     *   contains an OAuth2 authorization response.
+     *
+     * @example
+     * const { code, error } = client.parseAuthorizationResponse(req.url);
+     * const { code, error } = client.parseAuthorizationResponse('?code=abc&state=xyz');
      */
-    subscribeOrderNotifications({ filter, onMessage, onError, }?: {
-        /** specify which type of orders to listen to */
-        filter?: OrderNotificationQueryParams;
-        onMessage?: (data: Order) => void;
-        onError?: (err: Event) => void;
-    }): WebSocket | undefined;
+    parseAuthorizationResponse(input: string): ParsedAuthorizationResponse;
+}
+declare class MoneriumWhitelabelClient extends MoneriumServerClient {
     /**
-     * @deprecated Web sockets will be removed in v4 - use webhooks instead.
+     * Creates a new profile.
      *
-     * Closes the order notifications sockets
+     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/create-profile | API Documentation}
+     */
+    createProfile(input: CreateProfileInput): Promise<Profile>;
+    /**
+     * Share KYC data
      *
-     * @group Orders
-     * @param {OrderNotificationQueryParams} [params] - specify which socket to close or close all if not provided
-     * @see {@link https://docs.monerium.com/api#tag/orders/operation/orders-notifications | API Document - Websocket}
+     * @returns {Promise<AcceptedResponse>} The KYC data import has been initiated. Subscribe to `profile.update` webhook to monitor the progress.
+     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/share-profile-kyc | API Documentation}
+     *
+     * @ignore NOT YET LIVE
      */
-    unsubscribeOrderNotifications(params?: OrderNotificationQueryParams): void;
+    shareProfileKYC(input: ShareProfileKYCInput): Promise<AcceptedResponse>;
     /**
-     * @deprecated will be removed in v4, caller will manage state
+     * Submit the compliance details for a profile. Updates only the `details` section without affecting other sections.
      *
-     * Cleanups the localstorage and websocket connections
+     * > **KYC reliance model only.** Most integrations should use `shareProfileKYC()` to populate details via Sumsub instead.
      *
-     * @group Authentication
+     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/patch-profile-details | API Documentation}
+     * @returns {Promise<AcceptedResponse>} The applicant details have been received and will be processed by Monerium.
      */
-    disconnect(): Promise<void>;
+    updateProfileDetails(input: UpdateProfileDetailsInput): Promise<AcceptedResponse>;
     /**
-     * @deprecated will be removed in v4, caller will manage state
-     * Revokes access
+     * Submit additional data for a profile used for risk calculations (e.g. purpose of account, source of funds). Updates only the `form` section without affecting other sections.
      *
-     * @group Authentication
+     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/patch-profile-form | API Documentation}
+     * @returns {Promise<AcceptedResponse>} The profile form has been received and will be processed by Monerium.
      */
-    revokeAccess(): Promise<void>;
+    updateProfileForm(input: UpdateProfileFormInput): Promise<AcceptedResponse>;
     /**
+     * Submit verifications for a profile. Only the verifications provided are updated. `sourceOfFunds` is submitted here by all partners when required; other verification kinds are populated automatically when using the Sumsub share flow.
      *
-     * @hidden
+     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/patch-profile-verifications | API Documentation}
+     * @returns {Promise<AcceptedResponse>} The verification data has been received and will be processed by Monerium.
      */
-    getEnvironment: () => Environment;
+    updateProfileVerifications(input: UpdateProfileVerificationsInput): Promise<AcceptedResponse>;
+}
+
+/**
+ * Thrown when the Monerium API returns a non-2xx response.
+ * Fields map directly to the API response body — nothing is translated or normalised.
+ *
+ * @example
+ * try {
+ *   await client.getProfiles();
+ * } catch (err) {
+ *   if (err instanceof MoneriumApiError) {
+ *     console.log(err.code);    // 401
+ *     console.log(err.status);  // "Unauthorized"
+ *     console.log(err.message); // "Not authenticated"
+ *     console.log(err.errors);  // field-level validation errors, if present
+ *   }
+ * }
+ * @group Errors
+ */
+declare class MoneriumApiError extends Error {
+    code: number;
+    status: string;
+    errors?: Record<string, string>;
+    details?: unknown;
+    constructor(body: {
+        code: number;
+        status: string;
+        message: string;
+        errors?: Record<string, string>;
+        details?: unknown;
+    });
+}
+/**
+ * @group Errors
+ */
+type MoneriumSdkErrorType = 'network_error' | 'authentication_required' | 'invalid_configuration';
+/**
+ * Thrown for SDK-level failures — no HTTP response involved.
+ *
+ * @example
+ * try {
+ *   await client.getProfiles();
+ * } catch (err) {
+ *   if (err instanceof MoneriumSdkError) {
+ *     console.log(err.type);  // 'network_error' | 'authentication_required' | ...
+ *     console.log(err.cause); // underlying fetch error, if type === 'network_error'
+ *   }
+ * }
+ * @group Errors
+ */
+declare class MoneriumSdkError extends Error {
+    type: MoneriumSdkErrorType;
+    cause?: unknown;
+    constructor(type: MoneriumSdkErrorType, message: string, cause?: unknown);
 }
 
+/**
+ * @group Utilities
+ */
 declare const _default: {
     /**
      * The message used to link addresses.
      */
     LINK_MESSAGE: string;
-    /**
-     * The key used to store the code verifier in the local storage.
-     */
-    STORAGE_CODE_VERIFIER: string;
-    /**
-     * The key used to store the access token in the local storage.
-     */
-    STORAGE_ACCESS_TOKEN: string;
-    /**
-     * The unix timestamp used to calculate the expiration time of the access token.
-     */
-    STORAGE_ACCESS_EXPIRY: string;
 };
 
 /**
- *
  * @param d Date to be formatted
  * @returns RFC3339 date format.
  * @example 2023-04-30T12:00:00+01:00
  * @example 2023-04-30T02:08:15Z
+ * @group Utilities
  */
 declare const rfc3339: (d: Date) => string;
 /**
  * This will resolve the chainId number to the corresponding chain name.
  * @param chain The chainId of the network
  * @returns chain name, 'ethereum', 'polygon', 'gnosis', etc.
+ * @group Utilities
  */
 declare const parseChain: (chain: Chain | ChainId) => Chain;
 /**
@@ -1419,10 +1406,13 @@ declare const parseChain: (chain: Chain | ChainId) => Chain;
  * @example `Send EUR 1 to 0x1234123412341234123412341234123412341234 on ethereum at 2023-04-30T12:00:00+01:00`
  *
  * @example `Send EUR 1 to IS1234123412341234 at 2023-04-30T12:00:00+01:00`
+ * @group Utilities
  */
 declare const placeOrderMessage: (amount: string | number, currency: Currency, receiver: string, chain?: ChainId | Chain) => string;
 /**
- * https://monerium.com/siwe
+ * Construct an EIP-4361 SIWE message for use with {@link buildSiweAuthorizationUrl}.
+ * @see https://monerium.com/siwe
+ * @group Utilities
  */
 declare const siweMessage: ({ domain, address, appName, redirectUri, chainId, issuedAt, expiryAt, privacyPolicyUrl, termsOfServiceUrl, }: {
     domain: string;
@@ -1450,108 +1440,18 @@ declare const siweMessage: ({ domain, address, appName, redirectUri, chainId, is
  * getChain(137) // 'polygon'
  * getChain(80002) // 'amoy'
  * ```
+ * @group Utilities
  */
 declare const getChain: (chainId: number) => Chain;
+/**
+ * Shorten an IBAN for display: `GB29...2917`
+ * @group Utilities
+ */
 declare const shortenIban: (iban?: string) => string | undefined;
-declare const shortenAddress: (address?: string) => string | undefined;
-
 /**
- * @packageDocumentation
- * A library to interact with Monerium API.
- *
- * ![npm version](https://img.shields.io/npm/v/@monerium/sdk)
- *
- * ## Installation
- *
- * ```bash
- * pnpm add @monerium/sdk
- * ```
- *
- * @example
- * ```ts
- * // Current version - Deprecated in v4
- * import { MoneriumClient } from '@monerium/sdk';
- * const monerium = new MoneriumClient({
- *  clientId: '...',
- *  redirectUri: '...',
- *  environment: 'sandbox',
- * });
- *
- * // Will redirect the user to Monerium's authentication code flow.
- * await monerium.authorize();
- *
- * // Will use the authorization code flow code to get access token
- * await monerium.getAccess();
- *
- * // or use refresh token to get access token if provided.
- * await monerium.getAccess(refreshToken);
- *
- * // Retrieve profiles the client has access to.
- * await monerium.getProfiles();
- * ```
- * ```ts
- * // Upcoming v4 — factory function
- * import {
- *   randomPKCECodeVerifier,
- *   calculatePKCECodeChallenge,
- *   buildAuthorizationUrl,
- *   authorizationCodeGrant,
- *   refreshTokenGrant,
- *   createMoneriumClient,
- * } from '@monerium/sdk';
- *
- * // --- Initiate login ---
- * const codeVerifier = randomPKCECodeVerifier();
- * const codeChallenge = calculatePKCECodeChallenge(codeVerifier);
- * session.set('pkce_verifier', codeVerifier); // server-side session
- *
- * const url = buildAuthorizationUrl({
- *   environment: 'sandbox',
- *   clientId: 'your-client-id',
- *   redirectUri: 'https://your-app.com/callback',
- *   codeChallenge,
- * });
- * res.redirect(url);
- *
- * // --- On the callback page ---
- * const { code } = parseAuthorizationResponse(
- *   new URL(req.url, 'https://your-app.com')
- * );
- * const codeVerifier = session.get('pkce_verifier');
- * session.delete('pkce_verifier');
- *
- * const bearerProfile = await authorizationCodeGrant({
- *   environment: 'sandbox',
- *   clientId: 'your-client-id',
- *   redirectUri: 'https://your-app.com/callback',
- *   code,
- *   codeVerifier,
- * });
- *
- * req.session.accessToken = bearerProfile.access_token;
- * req.session.refreshToken = bearerProfile.refresh_token;
- * req.session.accessExpiry = Date.now() + bearerProfile.expires_in * 1000;
- *
- * // --- Use the API ---
- * const client = createMoneriumClient({
- *   environment: 'sandbox',
- *   getAccessToken: async () => {
- *     if (Date.now() > session.accessExpiry) {
- *       const newProfile = await refreshTokenGrant({
- *         environment: 'sandbox',
- *         clientId: 'your-client-id',
- *         refreshToken: session.refreshToken,
- *       });
- *       session.accessToken = newProfile.access_token;
- *       session.accessExpiry = Date.now() + newProfile.expires_in * 1000;
- *       return newProfile.access_token;
- *     }
- *     return session.accessToken;
- *   },
- * });
- *
- * const profiles = await client.getProfiles();
- * ```
+ * Shorten a blockchain address for display: `0x1234...abcd`
+ * @group Utilities
  */
+declare const shortenAddress: (address?: string) => string | undefined;
 
-export { AccountState, type Address, type AddressesQueryParams, type AddressesResponse, type AuthArgs, type AuthCodePayload, type AuthContext, type AuthFlowOptions, type AuthFlowOptionsShared, type AuthFlowSIWEOptions, type AuthorizationCodeCredentials, type AuthorizationCodeGrantOptions, type Balances, type BankAccountIdentifier, type BearerProfile, type BearerTokenCredentials, type Beneficiary, type BuildAuthorizationUrlOptions, type BuildSiweAuthorizationUrlOptions, type Chain, type ChainId, type ClassOptions, type ClientCredentials, type ClientCredentialsGrantOptions, type ClientCredentialsPayload, type Config, type CorporateProfileDetails, type CorporateProfileDetailsRequest, type Corporation, type CosmosChainId, type Counterpart, type CounterpartBank, type CounterpartDetails, type CrossChainIdentifier, Currency, type CurrencyBalance, type CurrencyCode, type Director, type ENV, type Environment, type EvmChainId, type Fee, type IBAN, type IBANIdentifier, type IBANsResponse, type IbansQueryParams, IdDocumentKind, type Identifier, type Individual, type Issuer, type KYC, KYCOutcome, KYCState, type LinkAddress, type LinkedAddress, Method, MoneriumApiError, MoneriumClient, type MoneriumClientOptions, MoneriumSdkError, type MoneriumSdkErrorType, type MoveIbanPayload, type NewOrder, type NewOrderByAccountId, type NewOrderByAddress, type NewOrderCommon, type Order, type OrderFilter, OrderKind, type OrderMetadata, type OrderNotificationQueryParams, OrderState, type OrdersResponse, type PKCERSIWERequestArgs, type PKCERequest, type PKCERequestArgs, type PKCERequestShared, type PKCESIWERequest, type ParsedAuthorizationResponse, PaymentStandard, type PendingLinkAddressSignature, type PendingOrderSignature, type PendingSignature, type PendingSignatureKind, Permission, type PersonalProfileDetails, type PersonalProfileDetailsRequest, type ProductionChain, type Profile, type ProfilePermissions, ProfileState, ProfileType, type ProfilesQueryParams, type ProfilesResponse, type RefreshTokenGrantOptions, type RefreshTokenPayload, type Representative, type RequestIbanPayload, type ResponseStatus, type SCANIdentifier, type SandboxChain, type SignaturesQueryParams, type SignaturesResponse, type SubmitProfileDetailsPayload, type SupportingDoc, type SupportingDocMetadata, type Ticker, type Token, type TokenSymbol, type Transport, type TransportRequest, type TransportResponse, authorizationCodeGrant, buildAuthorizationUrl, buildSiweAuthorizationUrl, calculatePKCECodeChallenge, clientCredentialsGrant, _default as constants, createMoneriumClient, MoneriumClient as default, getChain, parseAuthorizationResponse, parseChain, placeOrderMessage, randomPKCECodeVerifier, refreshTokenGrant, rfc3339, shortenAddress, shortenIban, siweMessage };
+export { type AcceptedResponse, type Address, type AddressesQueryParams, type AddressesResponse, type AuthContext, type AuthorizationCodeGrantOptions, type Balances, type BankAccountIdentifier, type BearerProfile, type Beneficiary, type BuildAuthorizationUrlOptions, type BuildSiweAuthorizationUrlOptions, type Chain, type ChainId, type ClientCredentialsGrantOptions, type Config, type CorporateProfileDetails, type CorporateProfileForm, type CorporateProfileVerification, type CorporateVerificationKind, type Corporation, type Counterpart, type CounterpartBank, type CounterpartDetails, type CreateProfileInput, type CreateWebhookSubscriptionInput, type CrossChainIdentifier, Currency, type CurrencyBalance, type CurrencyCode, type Director, type ENV, type Environment, type Fee, type FilesResponse, type GetBalancesParams, type GetProfilesParams, type IBAN, type IBANIdentifier, type IBANState, type IBANsResponse, type IbansParams, type IdDocumentKind, type Identifier, type Individual, type Issuer, type KYCProvider, type LinkAddress, type LinkAddressInput, type LinkAddressResponse, type Method, type MoneriumApiClientOptions, MoneriumApiError, MoneriumBaseClient, MoneriumOAuthClient, MoneriumPrivateClient, MoneriumSdkError, type MoneriumSdkErrorType, MoneriumServerClient, MoneriumWhitelabelClient, type MoveIbanInput, type Order, type OrderKind, type OrderMetadata, type OrderParams, type OrderState, type OrdersResponse, type ParsedAuthorizationResponse, type PaymentStandard, type PendingLinkAddressSignature, type PendingOrderSignature, type PendingSignature, type PendingSignatureKind, type Permission, type PersonalProfileDetails, type PersonalProfileForm, type PersonalProfileVerification, type PersonalVerificationKind, type PlaceOrderInput, type ProductionChain, type Profile, type ProfileDetailsState, type ProfileFormState, type ProfileKind, type ProfileState, ProfileType, type ProfileVerificationState, type ProfilesResponse, type RefreshTokenGrantOptions, type Representative, type RequestIbanInput, type SCANIdentifier, type SandboxChain, type ShareProfileKYCInput, type SignaturesParams, type SignaturesResponse, type SupportingDocMetadata, type Ticker, type Token, type TokenSymbol, type Transport, type TransportRequest, type TransportResponse, type UpdateProfileDetailsInput, type UpdateProfileFormInput, type UpdateProfileVerificationsInput, type UpdateWebhookSubscriptionInput, type WebhookEventType, type WebhookSubscription, type WebhookSubscriptionState, type WebhookSubscriptionsResponse, calculatePKCECodeChallenge, _default as constants, generatePKCE, getChain, parseAuthorizationResponse, parseChain, placeOrderMessage, randomPKCECodeVerifier, rfc3339, shortenAddress, shortenIban, siweMessage };