@monerium/sdk 3.4.11 → 4.0.0

package/dist/index.d.ts

@@ -1,61 +1,222 @@
+/**
+ * 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;
+}
+/**
+ * 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
+ */
+declare const parseAuthorizationResponse: (input: string) => ParsedAuthorizationResponse;
+
+/**
+ * Single source of truth for all supported EVM chain pairs.
+ *
+ * Each entry is a { production, sandbox } pair sharing the same network family.
+ *
+ * ── Adding a new EVM chain ────────────────────────────────────────────────────
+ * Add ONE entry to EVM_CHAIN_PAIRS below. All types (ProductionChain,
+ * SandboxChain, EvmChainId) and all lookup maps (chainIdToName,
+ * validEvmChainNames, productionToSandbox) are derived automatically.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+declare const EVM_CHAIN_PAIRS: readonly [{
+    readonly production: {
+        readonly id: "ethereum";
+        readonly chainId: 1;
+    };
+    readonly sandbox: {
+        readonly id: "sepolia";
+        readonly chainId: 11155111;
+    };
+}, {
+    readonly production: {
+        readonly id: "gnosis";
+        readonly chainId: 100;
+    };
+    readonly sandbox: {
+        readonly id: "chiado";
+        readonly chainId: 10200;
+    };
+}, {
+    readonly production: {
+        readonly id: "polygon";
+        readonly chainId: 137;
+    };
+    readonly sandbox: {
+        readonly id: "amoy";
+        readonly chainId: 80002;
+    };
+}, {
+    readonly production: {
+        readonly id: "arbitrum";
+        readonly chainId: 42161;
+    };
+    readonly sandbox: {
+        readonly id: "arbitrumsepolia";
+        readonly chainId: 421614;
+    };
+}, {
+    readonly production: {
+        readonly id: "linea";
+        readonly chainId: 59144;
+    };
+    readonly sandbox: {
+        readonly id: "lineasepolia";
+        readonly chainId: 59141;
+    };
+}, {
+    readonly production: {
+        readonly id: "scroll";
+        readonly chainId: 534352;
+    };
+    readonly sandbox: {
+        readonly id: "scrollsepolia";
+        readonly chainId: 534351;
+    };
+}, {
+    readonly production: {
+        readonly id: "base";
+        readonly chainId: 8453;
+    };
+    readonly sandbox: {
+        readonly id: "basesepolia";
+        readonly chainId: 84532;
+    };
+}, {
+    readonly production: {
+        readonly id: "camino";
+        readonly chainId: 500;
+    };
+    readonly sandbox: {
+        readonly id: "columbus";
+        readonly chainId: 501;
+    };
+}];
+/**
+ * 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 SandboxChain = 'sepolia' | 'chiado' | 'amoy' | 'arbitrumsepolia' | 'lineasepolia' | 'scrollsepolia' | 'basesepolia' | 'columbus' | 'grand';
-type ProductionChain = 'ethereum' | 'gnosis' | 'polygon' | 'arbitrum' | 'linea' | 'scroll' | 'base' | 'camino' | 'noble';
-type Chain = string | ProductionChain | SandboxChain;
-type EvmChainId = number | 1 | 11155111 | 100 | 10200 | 500 | 501 | 137 | 80002 | 8453 | 84532 | 42161 | 421614 | 59141 | 59144 | 534352 | 534351;
-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;
@@ -64,130 +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 */
-    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;
@@ -197,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[];
@@ -258,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;
 }
-type SubmitProfileDetailsPayload = PersonalProfileDetailsRequest | CorporateProfileDetailsRequest;
+/**
+ * @group Profiles
+ */
+interface CorporateProfileVerification {
+    /** The type of the verification. */
+    kind: CorporateVerificationKind;
+    /** ID of a previously uploaded file associated with this verification. */
+    fileId: string;
+}
+/**
+ * @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;
@@ -276,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;
@@ -361,7 +707,10 @@ interface OrderMetadata {
     txHashes?: string[];
     supportingDocumentId?: string;
 }
-interface OrderFilter {
+/**
+ * @group Orders
+ */
+interface OrderParams {
     address?: string;
     txHash?: string;
     profile?: string;
@@ -369,6 +718,9 @@ interface OrderFilter {
     accountId?: string;
     state?: OrderState;
 }
+/**
+ * @group Orders
+ */
 interface Order {
     id: string;
     profile: string;
@@ -383,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;
@@ -411,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;
@@ -432,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. */
@@ -451,7 +799,10 @@ interface LinkAddress {
     signature: string;
     chain: Chain | ChainId;
 }
-interface LinkedAddress {
+/**
+ * @group Addresses
+ */
+interface LinkAddressResponse {
     profile: string;
     address: string;
     state: string;
@@ -460,91 +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;
-}
-type ClassOptions = {
-    environment?: ENV;
-    debug?: boolean;
-} & BearerTokenCredentials;
-interface AuthFlowOptionsShared {
-    /** the state oauth parameter */
-    state?: string;
-}
-interface AuthFlowOptions extends AuthFlowOptionsShared {
-    /** the email of the user to prefill the login form */
-    email?: string;
-    /** skip account creation in 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;
-}
-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;
+/**
+ * @group Primitives
+ * @internal
+ */
+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;
@@ -554,6 +893,7 @@ interface PendingSignatureBase {
 }
 /**
  * Pending signature for an order
+ * @group Signatures
  */
 interface PendingOrderSignature extends PendingSignatureBase {
     id: string;
@@ -564,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 */
@@ -587,6 +930,7 @@ interface SignaturesQueryParams {
 }
 /**
  * Response from the signatures endpoint
+ * @group Signatures
  */
 interface SignaturesResponse {
     /** Array of pending signatures */
@@ -594,322 +938,453 @@ interface SignaturesResponse {
     /** Total number of pending signatures */
     total: number;
 }
+/**
+ * @group Webhooks
+ */
+type WebhookSubscriptionState = 'active' | 'inactive';
+/**
+ * @group Webhooks
+ */
+type WebhookEventType = 'iban.updated' | 'order.created' | 'order.updated' | 'profile.updated';
+/**
+ * @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 {
+    clientId: string;
+    redirectUri: string;
+    codeChallenge: string;
+    state?: string;
+    email?: string;
+    skipKyc?: boolean;
+    authMode?: 'login' | 'signup';
+}
+/**
+ * @category Types
+ */
+interface BuildSiweAuthorizationUrlOptions {
+    clientId: string;
+    redirectUri: string;
+    codeChallenge: string;
+    message: string;
+    signature: string;
+    state?: string;
+}
+/**
+ * @category Types
+ */
+interface AuthorizationCodeGrantOptions {
+    clientId: string;
+    redirectUri: string;
+    code: string;
+    codeVerifier: string;
+}
+/**
+ * @category Types
+ */
+interface RefreshTokenGrantOptions {
+    clientId: string;
+    refreshToken: string;
+}
+/**
+ * @category Types
+ */
+interface ClientCredentialsGrantOptions {
+    clientId: string;
+    clientSecret: string;
+}
 
 /**
- * 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'
- * });
- *
- *```
+ * 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 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;
-    /**
-     * @defaultValue `sandbox`
-     * */
-    constructor(envOrOptions?: ENV | ClassOptions);
-    /**
-     * 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>;
-    /**
-     * 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>;
+declare function getEnv(env?: ENV): Environment;
+
+/**
+ * @group Client
+ * @category Types
+ */
+type TransportRequest = {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: BodyInit | string;
+    signal?: AbortSignal;
+};
+/**
+ * @group Client
+ * @category Types
+ */
+type TransportResponse = {
+    status: number;
+    headers?: Record<string, string>;
+    bodyText: 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.
+ * @group Client
+ * @category Types
+ */
+type Transport = (request: TransportRequest) => Promise<TransportResponse>;
+
+interface MoneriumApiClientOptions {
+    environment?: ENV;
+    getAccessToken: () => Promise<string | undefined> | string | undefined;
+    transport?: Transport;
+}
+/**
+ * Base abstract client containing the shared configuration and request logic.
+ */
+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>;
     /**
-     * Will use the authorization code flow code to get access token
-     *
-     * @group Authentication
+     * Get the current auth context.
      *
-     * @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
-     *
-     * // 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>;
+    /**
+     * 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>;
     /**
-     * @group Orders
-     * @see {@link https://docs.monerium.com/api#tag/orders | API Documentation}
+     * 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
-     * @see {@link https://docs.monerium.com/api#tag/order | API Documentation}
+     * 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'
-     * });
-     *
-     * // Get pending signatures on a specific chain
-     * const polygonSignatures = await monerium.getSignatures({
-     *   chain: 'polygon'
-     * });
-     * ```
-     */
-    getSignatures(params?: SignaturesQueryParams): Promise<SignaturesResponse>;
-    /**
-     * Add a new address to the profile
-     * @group Addresses
-     * @see {@link https://docs.monerium.com/api#tag/addresses/operation/link-address | API Documentation}
+     * Accepts binary data in multiple formats and normalizes it to a {@link Blob}
+     * internally before sending the request.
+     *
+     * @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.
      */
-    linkAddress(payload: LinkAddress): Promise<LinkedAddress>;
+    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 {
     /**
-     * Place a new order.
+     * Get an access token using client credentials. Server-side only.
+     * clientSecret must never be used in a browser context.
      *
-     * **Note:** For multi-signature orders, the API returns a 202 Accepted response
-     * with `{status: 202, statusText: "Accepted"}` instead of the full Order object.
+     */
+    clientCredentialsGrant(clientId: string, clientSecret: string): Promise<BearerProfile>;
+    /**
+     * List all webhook subscriptions for the authenticated user.
      *
-     * @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.
+     *
+     */
+    buildSiweAuthorizationUrl(options: Omit<BuildSiweAuthorizationUrlOptions, 'environment'>): string;
+    /**
+     * Exchange an authorization code for tokens.
+     * The caller stores the returned BearerProfile — the SDK does not write to any storage.
+     *
      */
-    requestIban({ address, chain, emailNotifications, }: RequestIbanPayload): Promise<ResponseStatus>;
+    authorizationCodeGrant(options: Omit<AuthorizationCodeGrantOptions, 'environment' | 'transport'>): Promise<BearerProfile>;
     /**
-     * @group Profiles
-     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/profile-details | 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.
      */
-    submitProfileDetails(profile: string, body: SubmitProfileDetailsPayload): Promise<ResponseStatus>;
+    refreshTokenGrant(options: Omit<RefreshTokenGrantOptions, 'environment' | 'transport'>): Promise<BearerProfile>;
     /**
-     * @group Orders
-     * @see {@link https://docs.monerium.com/api#tag/orders/operation/supporting-document | API Documentation}
+     * 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 } = client.parseAuthorizationResponse(req.url);
+     * const { code, error } = client.parseAuthorizationResponse('?code=abc&state=xyz');
      */
-    uploadSupportingDocument(document: File): Promise<SupportingDoc>;
+    parseAuthorizationResponse(input: string): ParsedAuthorizationResponse;
+}
+declare class MoneriumWhitelabelClient extends MoneriumServerClient {
     /**
-     * Connects to the order notifications socket
+     * Creates a new profile.
      *
-     * @group Orders
-     * @param {OrderNotificationQueryParams} [params]
-     * @see {@link https://docs.monerium.com/api#tag/orders/operation/orders-notifications | API Document - Websocket}
-  
+     * @see {@link https://docs.monerium.com/api#tag/profiles/operation/create-profile | API Documentation}
      */
-    subscribeOrderNotifications({ filter, onMessage, onError, }?: {
-        /** specify which type of orders to listen to */
-        filter?: OrderNotificationQueryParams;
-        onMessage?: (data: Order) => void;
-        onError?: (err: Event) => void;
-    }): WebSocket | undefined;
+    createProfile(input: CreateProfileInput): Promise<Profile>;
     /**
-     * Closes the order notifications sockets
+     * 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>;
     /**
-     * Cleanups the localstorage and websocket connections
+     * Submit the compliance details for a profile. Updates only the `details` section without affecting other sections.
+     *
+     * > **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>;
     /**
-     * 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;
 /**
@@ -931,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;
@@ -962,44 +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.
- *
- *
- * ## Installation
- *
- * ```bash
- * pnpm add @monerium/sdk
- * ```
- *
- * @example
- * ```tsx
- * 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();
- * ```
+ * 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 Balances, type BankAccountIdentifier, type BearerProfile, type BearerTokenCredentials, type Beneficiary, type Chain, type ChainId, type ClassOptions, type ClientCredentials, 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, MoneriumClient, 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, 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 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, _default as constants, MoneriumClient as default, getChain, parseChain, placeOrderMessage, 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 };