vaults-multichain-sdk 1.1.0

package/dist/index.d.ts

@@ -0,0 +1,1955 @@
+declare const TransactionEstimatingType: {
+    readonly ExecOrder: "execOrder";
+    readonly Send: "send";
+    readonly ActivateMultisig: "activateMultisig";
+    readonly SignOrder: "SignOrder";
+    readonly CreateOrder: "CreateOrder";
+    readonly ChangeMultisig: "ChangeMultisig";
+};
+type TransactionEstimatingTypeValue = typeof TransactionEstimatingType[keyof typeof TransactionEstimatingType];
+
+/**
+ * Supported blockchain chain types
+ */
+type ChainType = "EVM" | "SOL" | "TRON" | "BTC" | "BTC_T3" | "ADA" | "XRP";
+declare enum EChainType {
+    EVM = "EVM",
+    SOL = "SOL",
+    TRON = "TRON",
+    BTC = "BTC",
+    BTC_T3 = "BTC_T3",
+    ADA = "ADA",
+    XRP = "XRP"
+}
+/**
+ * Returns the appropriate BTC chain type based on the current network mode.
+ * - Mainnet: EChainType.BTC
+ * - Testnet: EChainType.BTC_T3
+ *
+ * @example
+ * ```typescript
+ * const btcChain = getBtcChainType(); // Returns EChainType.BTC or EChainType.BTC_T3
+ * ```
+ */
+declare function getBtcChainType(): EChainType.BTC | EChainType.BTC_T3;
+declare enum TestnetChainId {
+    BASE_SEPOLIA = "84532",
+    ARBITRUM_SEPOLIA = "421614",
+    SOLANA_DEVNET = "sol_devnet",
+    BTC = "BTC_T3",
+    BNB = "97",
+    POL = "80002",
+    ETH_SEPOLIA = "11155111",
+    OPTIMISM_SEPOLIA = "11155420",
+    TRON = "tron_shasta",
+    AVAX_FUJI = "43113",
+    ADA_PP = "ada_preprod",
+    XRP = "xrp_testnet"
+}
+declare enum MainnetChainId {
+    BASE = "8453",
+    ARBITRUM = "42161",
+    SOLANA = "sol_mainnet",
+    BTC = "BTC",
+    BNB = "56",
+    POL = "137",
+    ETH = "1",
+    OPTIMISM = "10",
+    TRON = "tron_mainnet",
+    AVAX = "43114",
+    ADA = "ada_mainnet",
+    XRP = "xrp_mainnet"
+}
+/**
+ * Union of all possible chain ID values (EVM chain IDs are strings here for consistency)
+ */
+type ChainIdValue = `${MainnetChainId}` | `${TestnetChainId}`;
+interface TWallet {
+    name: string | null;
+    chain: EChainType;
+    address: string;
+    share: string;
+    isImported: boolean;
+}
+/**
+ * Response from wallet creation/import
+ */
+interface CreateWalletResponse {
+    wallets: TWallet[];
+}
+/**
+ * Single wallet details response
+ */
+interface SingleWalletDetailsResponse {
+    data: TWallet;
+}
+/**
+ * Paginated wallets response
+ */
+interface PaginatedWalletsResponse {
+    wallets: TWallet[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/**
+ * Multisig status enum
+ */
+declare enum MultisigStatus {
+    PENDING = "pending",
+    ACTIVE = "active",
+    INACTIVE = "inactive"
+}
+/**
+ * Multisig params with deployment data
+ */
+interface MultisigParams {
+    chainType: EChainType;
+    to: string;
+    data: string;
+    paymentToken: string;
+    payment: string;
+    vaultAddress: string;
+    paymentReceiverAddress: string;
+    fallbackAddress: string;
+    singleton: string;
+    initializer: string;
+    deployData: string;
+    share?: string;
+}
+/**
+ * Token within a multisig
+ */
+interface MultisignToken extends TokenMultisignBalance {
+}
+/**
+ * Multisig vault/safe object
+ */
+interface MultisigsItem {
+    id: string;
+    address: string | null;
+    chainId: ChainIdValue;
+    status: "created" | "execution" | "deployed";
+    threshold: string;
+    chainType: EChainType;
+    isDeployed: boolean;
+    factoryId: string;
+    name: string;
+    params: MultisigParams;
+    updatedAt: string;
+    createdAt: string;
+    owners: {
+        walletAddress: string;
+    }[];
+    tokens: MultisignToken[];
+    factoryAddress: string;
+}
+interface MultisigBaseDTO {
+    address: string;
+    chainType: EChainType;
+    data: MultisigsItem[];
+}
+/**
+ * One grouped multisig row from GET /sdk/multisig (paginated vault list).
+ */
+interface GroupedMultisigResponseDTO {
+    address: string;
+    chainType: EChainType;
+    createdAt: string;
+    data: MultisigsItem[];
+}
+/**
+ * Paginated vault list (GET /sdk/multisig).
+ */
+interface PaginatedMultisigsWithTokensResponse {
+    multisigs: GroupedMultisigResponseDTO[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/**
+ * Order status enum
+ */
+declare enum OrderStatus {
+    PENDING = "pending",
+    APPROVED = "approved",
+    EXECUTED = "executed",
+    REJECTED = "rejected",
+    CANCELLED = "cancelled",
+    FAILED = "failed"
+}
+/**
+ * Order method types - the action the order will perform
+ */
+type OrderMethodType = "native" | "erc20" | "spl" | "trc20" | "trc" | "addOwner" | "removeOwner" | "changeThreshold" | "addOwnerWithThreshold" | "AddOwner" | "RemoveOwner" | "ChangeThreshold" | "multiSend" | "MultiSend" | "updateOwners" | "updateOwnerThreshold" | "ada_native" | "ada_token" | "xrp_native" | "xrp_asset" | "xrp_setTrustLine" | "xrp_removeTrustLine" | "xrp_changeThreshold" | "xrp_updateOwners" | "xrp_updateOwnerThreshold";
+/**
+ * Solana instruction types
+ */
+declare enum ESolanaInstructionType {
+    native = "native",
+    spl = "spl",
+    addOwner = "addOwner",
+    removeOwner = "removeOwner",
+    changeThreshold = "changeThreshold",
+    MultiSend = "MultiSend",
+    NATIVE = "native",
+    SPL = "spl",
+    ADD_OWNER = "addOwner",
+    REMOVE_OWNER = "removeOwner",
+    CHANGE_THRESHOLD = "changeThreshold"
+}
+/**
+ * Tron order types
+ */
+declare enum ETronOrderType {
+    native = "native",
+    trc20 = "trc20",
+    trc = "trc",
+    addOwner = "addOwner",
+    removeOwner = "removeOwner",
+    changeThreshold = "changeThreshold",
+    updateOwners = "updateOwners",
+    updateOwnerThreshold = "updateOwnerThreshold"
+}
+/**
+ * Order instruction for creating orders
+ */
+interface SolanaSPLInstruction {
+    type: ESolanaInstructionType.spl;
+    toPubkey: string;
+    tokenAddress: string;
+    amount: string;
+}
+interface SolanaNativeInstruction {
+    type: ESolanaInstructionType.native;
+    toPubkey: string;
+    amount: string;
+}
+interface SolanaConfigAddOwnerInstruction {
+    type: ESolanaInstructionType.addOwner;
+    newOwner: string;
+}
+interface SolanaConfigRemoveOwnerInstruction {
+    type: ESolanaInstructionType.removeOwner;
+    removeOwner: string;
+}
+interface SolanaConfigChangeThresholdInstruction {
+    type: ESolanaInstructionType.changeThreshold;
+    newThreshold: number;
+}
+type TSolanaCommandInstruction = SolanaNativeInstruction | SolanaSPLInstruction | SolanaConfigAddOwnerInstruction | SolanaConfigRemoveOwnerInstruction | SolanaConfigChangeThresholdInstruction;
+interface TronNativeOrder {
+    type: ETronOrderType.native;
+    to: string;
+    amount: string;
+}
+interface TronTrcOrder {
+    type: ETronOrderType.trc | ETronOrderType.trc20;
+    to: string;
+    tokenAddress: string;
+    amount: string;
+}
+interface TronConfigChangeThresholdOrder {
+    type: ETronOrderType.changeThreshold;
+    newThreshold: number;
+}
+interface TronConfigChangeOwnersOrder {
+    type: ETronOrderType.updateOwners;
+    owners: string[];
+}
+interface TronConfigChangeOwnerThresholdOrder {
+    type: ETronOrderType.updateOwnerThreshold;
+    newThreshold: number;
+    owners: string[];
+}
+type TTronCommandInstruction = TronNativeOrder | TronTrcOrder | TronConfigChangeOwnersOrder | TronConfigChangeThresholdOrder | TronConfigChangeOwnerThresholdOrder;
+interface BtcNativeInstruction {
+    type: "native";
+    to: string;
+    amount: string | number;
+}
+declare enum EAdaInstructionType {
+    native = "native",
+    token = "token"
+}
+interface AdaNativeInstruction {
+    type: EAdaInstructionType.native;
+    to: string;
+    amount: string;
+}
+interface AdaTokenInstruction {
+    type: EAdaInstructionType.token;
+    to: string;
+    policyId: string;
+    assetName: string;
+    amount: string;
+}
+type TAdaCommandInstruction = AdaNativeInstruction | AdaTokenInstruction;
+declare enum EXrpOrderType {
+    native = "native",
+    asset = "asset",
+    setTrustLine = "setTrustLine",
+    removeTrustLine = "removeTrustLine",
+    changeThreshold = "changeThreshold",
+    updateOwners = "updateOwners",
+    updateOwnerThreshold = "updateOwnerThreshold"
+}
+interface XrpNativeInstruction {
+    type: EXrpOrderType.native;
+    to: string;
+    amount: string;
+    memo?: string;
+}
+interface XrpAssetInstruction {
+    type: EXrpOrderType.asset;
+    to: string;
+    amount: string;
+    tokenAddress: string;
+    memo?: string;
+}
+interface XrpSetTrustLineInstruction {
+    type: EXrpOrderType.setTrustLine;
+    tokenAddress: string;
+    issuer: string;
+    limit?: string;
+}
+interface XrpRemoveTrustLineInstruction {
+    type: EXrpOrderType.removeTrustLine;
+    currency: string;
+    issuer: string;
+}
+interface XrpChangeThresholdInstruction {
+    type: EXrpOrderType.changeThreshold;
+    newThreshold: number;
+}
+interface XrpUpdateOwnersInstruction {
+    type: EXrpOrderType.updateOwners;
+    newOwners: string[];
+}
+interface XrpUpdateOwnerThresholdInstruction {
+    type: EXrpOrderType.updateOwnerThreshold;
+    newOwners: string[];
+    newThreshold: number;
+}
+type TXrpCommandInstruction = XrpNativeInstruction | XrpAssetInstruction | XrpSetTrustLineInstruction | XrpRemoveTrustLineInstruction | XrpChangeThresholdInstruction | XrpUpdateOwnersInstruction | XrpUpdateOwnerThresholdInstruction;
+interface OrderParamsMethodsEvmDto {
+    method: string;
+    args: any[] | string;
+}
+interface OrderParamsSol {
+    chainType: EChainType.SOL;
+    proposalHash: string;
+    transactionIndex: string;
+    instructions: TSolanaCommandInstruction[];
+    token?: TokenMultisignBalance | null;
+    expireTime?: Date;
+}
+interface OrderParamsEvm {
+    chainType: EChainType.EVM;
+    operation: "0" | "1" | string;
+    safeTxGas: string;
+    baseGas: string;
+    gasPrice: string;
+    gasToken: string;
+    refundReceiver: string;
+    methods: OrderParamsMethodsEvmDto[];
+    token?: TokenMultisignBalance | null;
+    expireTime?: Date;
+    value?: string;
+    data?: string;
+}
+interface OrderParamsBtc {
+    chainType: EChainType.BTC | EChainType.BTC_T3;
+    instructions: BtcNativeInstruction;
+    feeSats: string;
+    utxo: Array<{
+        value: number;
+        txid: string;
+        vout: number;
+    }>;
+    token?: TokenMultisignBalance | null;
+    expireTime?: Date;
+}
+interface OrderParamsTron {
+    chainType: EChainType.TRON;
+    instructions: TTronCommandInstruction[];
+    transaction?: {
+        txID: string;
+        raw_data: any;
+        raw_data_hex: string;
+        visible?: boolean;
+        signature?: string[];
+    };
+    token?: TokenMultisignBalance | null;
+    expireTime?: Date | string;
+}
+interface OrderParamsAda {
+    chainType: EChainType.ADA;
+    policyId?: string;
+    nativeScriptCbor?: string;
+    feeLovelace?: string;
+    instructions?: TAdaCommandInstruction;
+    token?: TokenMultisignBalance | null;
+    expireTime?: Date;
+}
+interface OrderParamsXrp {
+    chainType: EChainType.XRP;
+    instructions?: TXrpCommandInstruction;
+    token?: TokenMultisignBalance | null;
+    expireTime?: Date;
+    version?: number;
+}
+/**
+ * Legacy support for loose typing (optional, but good for migration)
+ * We recommend using Discriminated Union `OrderParams` instead.
+ */
+interface OrderSigner {
+    address: string;
+    signature?: string;
+    signedAt?: string;
+}
+interface OrderInstruction {
+    to?: string;
+    symbol?: string;
+    toPubkey?: string;
+    amount?: string;
+    tokenAddress?: string;
+    decimals?: number;
+    type?: string;
+    newOwner?: string;
+    owners?: string[];
+    removeOwner?: string;
+    ownerToRemove?: string;
+    newThreshold?: number;
+    data?: string;
+    value?: string;
+    memo?: string;
+}
+type OrderParams = OrderParamsSol | OrderParamsEvm | OrderParamsBtc | OrderParamsTron | OrderParamsAda | OrderParamsXrp;
+interface Signature {
+    id: string;
+    orderId: string;
+    multisigOwnerId: string;
+    signedHash: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface Signatures {
+    walletAddress: string;
+    signedHash: string;
+    status: string;
+}
+declare enum EOrderStatus {
+    proposed = "proposed",
+    created = "created",
+    pending = "pending",
+    ready = "ready",
+    rejected = "rejected",
+    execution = "execution",
+    expired = "expired",
+    completed = "completed"
+}
+/**
+ * Order object
+ */
+interface Order {
+    id: string;
+    type?: string;
+    multisigId: string;
+    to: string;
+    data: string;
+    value: string;
+    method: string;
+    operation: number;
+    hashToSing: string;
+    txHash: string | null;
+    updatedAt: string;
+    createdAt: string;
+    nonce: number;
+    walletInitiator: string;
+    signature: Signature;
+    status: EOrderStatus;
+    multisig: MultisigsItem;
+    signatures: Signatures[];
+    params?: OrderParams;
+    isSmallestNonce?: boolean;
+}
+/**
+ * Paginated orders response
+ */
+interface PaginatedOrdersResponse {
+    orders: Order[];
+    total: number;
+    page: number;
+    limit: number;
+}
+interface TokenInfo {
+    address: string;
+    symbol: string;
+    name?: string;
+    decimals: number;
+    logoUrl?: string;
+    priceUsd?: string;
+    balance?: string;
+}
+/**
+ * Supported token from backend
+ */
+interface SupportedToken {
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    chainType: EChainType;
+    chainId: ChainIdValue;
+    logoUrl?: string;
+}
+/**
+ * Token balance for multisig
+ */
+interface TokenMultisignBalance {
+    name: string;
+    symbol: string;
+    balanceWei: string;
+    balance: string;
+    decimals: number;
+    address: string;
+    logoURL: string;
+    nativeTokenSymbol: string;
+    nativeTokenName: string;
+    amountNum?: number;
+    priceUsd?: number;
+    priceUSD?: number;
+    priceChange24h?: number;
+    price24hChange?: number;
+    valueUsd?: number;
+    balanceUSD?: number;
+}
+/**
+ * Wallet portfolio response
+ */
+interface TokensBalance {
+    name: string;
+    symbol: string;
+    balanceWei: string;
+    balance: string;
+    priceUSD: number;
+    price24hChange: number;
+    balanceUSD: number;
+    decimals: number;
+    address: string;
+    logoURL: string;
+}
+interface WalletPortfolioResponse {
+    walletAddress: string;
+    chainType: EChainType;
+    chain: ChainIdValue;
+    tokens: TokensBalance[];
+}
+/**
+ * Portfolio request payload
+ */
+interface PortfolioRequest {
+    walletAddress: string;
+    chainType: EChainType;
+    chain: string;
+}
+/**
+ * Total asset value response
+ */
+interface TotalAssetValueResponse {
+    totalAssetValueUSD: string;
+}
+/**
+ * Supported tokens response
+ */
+interface SupportedTokensResponse {
+    tokens: SupportedToken[];
+    total: number;
+}
+/**
+ * Estimated fee response
+ */
+interface EstimatedFee {
+    estimatedFee: string;
+    gasLimit?: string;
+    gasPrice?: string;
+    nativeFeeLamports?: number;
+    gasFeeRaw?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    energyFee?: string;
+    bandwidthFee?: string;
+    priorityFee?: string;
+    feeRate?: number;
+    feeInUsd?: string;
+    totalFee?: string;
+    currency?: string;
+}
+/**
+ * Transaction history item
+ */
+interface TokenData {
+    symbol: string;
+    value: string;
+    logoURL: string;
+}
+interface TransactionDetails {
+    to: string;
+    value: string;
+    data: string;
+    operation: number;
+    safeTxGas: string;
+    baseGas: number;
+    gasPrice: number;
+    gasToken: number;
+    refundReceiver: string;
+    nonce: number;
+}
+interface TransactionHistoryItem {
+    chainType: EChainType;
+    chainId: ChainIdValue;
+    threshold: string;
+    executed: string;
+    status: "success" | "failed" | "pending";
+    method: string;
+    from: string;
+    to: string;
+    value: string;
+    creator: string;
+    confirmations: string[];
+    token: TokenData;
+    details: TransactionDetails;
+    hash: string;
+    time: string;
+}
+interface HistoryResponse {
+    total: number;
+    page: number;
+    limit: number;
+    items: TransactionHistoryItem[];
+}
+/**
+ * Status filter for history queries
+ */
+declare enum StatusFilterEnum {
+    ALL = "all",
+    PENDING = "pending",
+    EXECUTED = "executed",
+    REJECTED = "rejected"
+}
+interface TxHistoryToken {
+    symbol: string;
+    logoURL: string;
+    value: string;
+    name?: string;
+    priceUSD?: number;
+    price24hChange?: number;
+}
+interface TxHistoryMethod {
+    args: (string | number)[];
+    method: string;
+}
+interface Instruction {
+    type: "native" | "spl" | "trc20" | string;
+    amount: string;
+    toPubkey?: string;
+    to?: string;
+    tokenAddress?: string;
+}
+interface TxHistoryDetails {
+    to: string;
+    value: string;
+    data: string;
+    operation: number;
+    safeTxGas: string;
+    baseGas: number;
+    gasPrice: number;
+    gasToken: number;
+    refundReceiver: string;
+    nonce: number;
+    instructions?: Instruction | Instruction[];
+    token: TxHistoryToken;
+    methods: TxHistoryMethod[];
+    chainType: string;
+}
+interface TxHistoryItem {
+    id: string;
+    status: string;
+    method: string;
+    chainId: string;
+    chainType: string;
+    threshold: string;
+    from: string;
+    to: string;
+    value: string;
+    token: TxHistoryToken;
+    details?: TxHistoryDetails;
+    hash: string;
+    time: string;
+    executed: string;
+    creator: string;
+    confirmations: string[];
+}
+/**
+ * Combined transaction history for multisigs
+ */
+interface TxHistoryCombinedResponse {
+    items: TxHistoryItem[];
+    limit: number;
+    total: number;
+    page: number;
+}
+declare enum EAddressBookEntryType {
+    CEX = "CEX",
+    Wallet = "Wallet"
+}
+type AddressBookEntryType = "CEX" | "Wallet";
+interface AddressBookEntry {
+    id: string;
+    name: string;
+    address: string;
+    chainType: ChainType;
+    type: AddressBookEntryType;
+    memo: string | null;
+    createdAt: string;
+}
+interface AddressTypeResponse {
+    type: AddressBookEntryType | null;
+}
+/** Org member role as returned by the API (e.g. "MASTER" | "EMPLOYEE"). */
+type OrgMemberRole = string;
+/** Org member account status as returned by the API. */
+type OrgMemberStatus = string;
+/**
+ * Individual KYC verification status for an org member.
+ * `null` is returned when the invite has not been accepted yet.
+ */
+type OrgMemberKycStatus = "new" | "pending" | "verified" | "failed" | "expired";
+/**
+ * A single member row from `GET /sdk/organization/team`.
+ * `userId`, `userName`, `kycStatus`, and `joinedAt` are `null` when the
+ * invitation has not been accepted yet.
+ */
+interface OrgTeamMember {
+    id: string;
+    email: string;
+    role: OrgMemberRole;
+    status: OrgMemberStatus;
+    userId: string | null;
+    userName: string | null;
+    kycStatus: OrgMemberKycStatus | null;
+    assignedWalletsCount: number;
+    assignedVaultsCount: number;
+    invitedAt: string;
+    joinedAt: string | null;
+}
+/** Response shape of `GET /sdk/organization/team`. */
+interface OrgTeamDirectoryResponse {
+    members: OrgTeamMember[];
+}
+/** Body of `POST /sdk/organization/team/invite`. */
+interface InviteOrgMemberInput {
+    email: string;
+}
+/** Response of `POST /sdk/organization/team/invite`. */
+interface InviteOrgMemberResponse {
+    memberId: string;
+    email: string;
+    status: string;
+}
+/** Path params for `DELETE /sdk/organization/team/{memberId}`. */
+interface RemoveOrgMemberInput {
+    memberId: string;
+}
+/** Path params for `GET /sdk/organization/team/{memberId}/wallets`. */
+interface ListOrgMemberWalletsInput {
+    memberId: string;
+}
+/**
+ * Body of `POST /sdk/organization/team/{memberId}/wallets`.
+ * `walletId` may refer to either a wallet or a vault — the backend
+ * validates ownership.
+ */
+interface AssignOrgWalletInput {
+    memberId: string;
+    walletId: string;
+}
+/** Response of `POST /sdk/organization/team/{memberId}/wallets`. */
+interface AssignOrgWalletResponse {
+    assignmentId: string;
+}
+/** Path params for `DELETE /sdk/organization/team/{memberId}/wallets/{walletId}`. */
+interface UnassignOrgWalletInput {
+    memberId: string;
+    walletId: string;
+}
+/**
+ * One row from `OrganizationWalletsResponseDto`. Used by both:
+ * - `GET /sdk/organization/wallets` (org-wide list)
+ * - `GET /sdk/organization/team/{memberId}/wallets` (member-assigned list)
+ */
+interface OrgWalletItem {
+    id: string;
+    address: string;
+    /** Lowercased chain key as returned by the server (e.g. "evm"). */
+    chainType: string;
+    name: string;
+    isImported: boolean;
+}
+/** Response of org wallet list endpoints. */
+interface OrgWalletsResponse {
+    wallets: OrgWalletItem[];
+}
+/**
+ * `GET /sdk/organization/policies` — current org security policy.
+ * Returned fields are partially optional/nullable when the corresponding
+ * feature is disabled (e.g. business hours fields when `businessHoursEnabled`
+ * is `false`).
+ */
+interface OrgPolicy {
+    id: string;
+    organizationId: string;
+    /** Daily spending limit in USD, serialized as a string. `null` when unset. */
+    dailySpendingLimitUsd: string | null;
+    businessHoursEnabled: boolean;
+    /** "HH:MM" in `businessHoursTimezone`. `null` when business hours are off. */
+    businessHoursStart: string | null;
+    /** "HH:MM" in `businessHoursTimezone`. `null` when business hours are off. */
+    businessHoursEnd: string | null;
+    /** IANA timezone (e.g. "Europe/Warsaw"). `null` when business hours are off. */
+    businessHoursTimezone: string | null;
+    /** ISO weekday numbers (1 = Monday, 7 = Sunday). */
+    businessHoursDays: number[];
+    /** Whether KYC is required for employees in this org. */
+    forceEmployeeKyc: boolean;
+    /** Whether transfers are restricted to verified Corporate Address Book entries. */
+    forceAddressBook: boolean;
+}
+/**
+ * Body of `PATCH /sdk/organization/policies` — partial update.
+ *
+ * Conditional validation enforced server-side:
+ * - Enabling `businessHoursEnabled` requires `businessHoursStart`,
+ *   `businessHoursEnd`, and `businessHoursTimezone`.
+ * - `dailySpendingLimitUsd` must be a positive numeric string when set;
+ *   pass `null` to clear the limit.
+ */
+interface UpdateOrgPolicyInput {
+    dailySpendingLimitUsd?: string | null;
+    businessHoursEnabled?: boolean;
+    businessHoursStart?: string;
+    businessHoursEnd?: string;
+    businessHoursTimezone?: string;
+    businessHoursDays?: number[];
+    forceEmployeeKyc?: boolean;
+    forceAddressBook?: boolean;
+}
+/** FATF Travel Rule: recipient legal nature. */
+type OrgAddressRecipientType = "individual" | "corporate";
+/** FATF Travel Rule: counterparty wallet category. */
+type OrgAddressWalletType = "self_hosted" | "crypto_service_provider";
+/**
+ * One entry from `GET /sdk/organization/address-book`.
+ *
+ * Travel Rule fields (`beneficiaryName`, `registeredName`, `vaspName`,
+ * `vaspLei`) are populated according to `recipientType` / `walletType` rules
+ * enforced at create time.
+ *
+ * `isVerified` indicates whether the entry counts toward transfer
+ * whitelisting (`forceAddressBook` policy). API-key flows auto-verify on
+ * create; JWT flows may require OTP confirmation (not exposed by this SDK).
+ */
+interface OrgAddressBookEntry {
+    id: string;
+    name: string;
+    address: string;
+    chainType: ChainType;
+    /** "CEX" | "Wallet". */
+    type: "CEX" | "Wallet";
+    memo?: string | null;
+    recipientType?: OrgAddressRecipientType;
+    walletType?: OrgAddressWalletType;
+    beneficiaryName?: string | null;
+    registeredName?: string | null;
+    vaspName?: string | null;
+    vaspLei?: string | null;
+    isVerified: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Body of `POST /sdk/organization/address-book`.
+ *
+ * Server enforces:
+ * - `recipientType === "individual"` → `beneficiaryName` required.
+ * - `recipientType === "corporate"`  → `registeredName` required.
+ * - `walletType   === "crypto_service_provider"` → `vaspName` required.
+ */
+interface CreateOrgAddressInput {
+    address: string;
+    chainType: ChainType;
+    name: string;
+    type: "CEX" | "Wallet";
+    recipientType: OrgAddressRecipientType;
+    walletType: OrgAddressWalletType;
+    beneficiaryName?: string;
+    registeredName?: string;
+    vaspName?: string;
+    vaspLei?: string;
+    memo?: string;
+}
+/** Response of `POST /sdk/organization/address-book`. */
+interface AddOrgAddressResponse {
+    id: string;
+    address: string;
+    isVerified: boolean;
+}
+/**
+ * Body of `PATCH /sdk/organization/address-book/{addressId}`.
+ *
+ * `address` and `chainType` are immutable server-side — they are intentionally
+ * absent from this shape.
+ */
+interface UpdateOrgAddressInput {
+    name?: string;
+    memo?: string;
+    type?: "CEX" | "Wallet";
+    recipientType?: OrgAddressRecipientType;
+    walletType?: OrgAddressWalletType;
+    beneficiaryName?: string;
+    registeredName?: string;
+    vaspName?: string;
+    vaspLei?: string;
+}
+/**
+ * Audit event labels enumerated by `GET /sdk/organization/audit-logs`.
+ *
+ * Keep this list in sync with the OpenAPI `eventTypes`/`event` enum in
+ * `docs/openapi-trustodian-sdk-production.json` (component
+ * `UserAuditLogItemDTO.event`).
+ */
+type OrgAuditEventType = "Account Created" | "Login" | "Password Changed" | "Password Reset" | "Email Changed" | "Email Reverted" | "2FA Disabled" | "2FA Enabled" | "Wallet Created" | "Wallet Imported" | "Wallet Deleted" | "Vault Created" | "Vault Activated" | "Transaction Created" | "Transaction Signed" | "Transaction Rejected" | "Transaction Executed" | "KYC Initiated" | "Org Created" | "Org KYB Initiated" | "Org KYB Completed" | "Org Member Invited" | "Org Member Joined" | "Org Member Removed" | "Org Wallet Assigned" | "Org Wallet Unassigned" | "Org Policy Updated" | "Org Address Added" | "Org Address Verified" | "Org Address Updated" | "Org Address Removed" | "Org Blocked" | "Org Activated";
+/** One row of `GET /sdk/organization/audit-logs`. */
+interface OrgAuditLogItem {
+    id: string;
+    /** ISO 8601 timestamp. */
+    date: string;
+    event: OrgAuditEventType;
+    ipAddress: string;
+    /** "Mobile" | "Tablet" | "Web" — server-derived from User-Agent. */
+    device?: string | null;
+    /** "iOS" | "Android" | "Windows" | "macOS" | "Linux" — server-derived. */
+    platform?: string | null;
+    /** Approximate city/country derived from IP. */
+    location?: string | null;
+}
+/** Paginated response of `GET /sdk/organization/audit-logs`. */
+interface OrgAuditLogsResponse {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    items: OrgAuditLogItem[];
+}
+/**
+ * Query of `GET /sdk/organization/audit-logs`.
+ *
+ * Encoding notes (see `docs/api-contract-clarifications.md`):
+ * - `eventTypes` is OpenAPI `type: array` of enum strings; the SDK serializes
+ *   it using OpenAPI's default `style: form, explode: true` — i.e. repeated
+ *   keys: `?eventTypes=Login&eventTypes=Wallet+Created`. Confirm the
+ *   server-accepted form with one staging request before locking down.
+ * - `dateFrom` / `dateTo` are ISO 8601 timestamps.
+ */
+interface GetOrgAuditLogsInput {
+    page?: number;
+    limit?: number;
+    dateFrom?: string;
+    dateTo?: string;
+    eventTypes?: OrgAuditEventType[];
+    actorId?: string;
+}
+/**
+ * Input for estimateFee
+ */
+interface EstimateFeeInput {
+    chain: ChainType;
+    txType: TransactionEstimatingTypeValue;
+    payload: {
+        from?: string;
+        to?: string;
+        amount?: string;
+        tokenAddress?: string;
+        decimals?: number;
+        orderId?: string;
+        multisigId?: string;
+        owners?: string[];
+        threshold?: number;
+        order?: Order;
+        multisig?: MultisigsItem;
+        method?: any;
+    };
+    chainId?: ChainIdValue;
+}
+/**
+ * Input for GET /sdk/multisig (paginated vault list).
+ */
+interface GetPaginatedMultisigsInput {
+    page?: number;
+    limit?: number;
+    /** Serialized as comma-separated chain types (e.g. EVM,SOL). */
+    chainTypes?: EChainType[];
+}
+/**
+ * Input for activateMultisig
+ */
+interface ActivateMultisigInput {
+    chain: ChainType;
+    multisigId: string;
+    multisigAddress: string;
+    walletAddress: string;
+    feeQuote: EstimatedFee;
+    chainId?: ChainIdValue;
+    /** Full multisig object for EVM activation */
+    multisig: MultisigsItem;
+    /** Gas limit override */
+    gasLimit?: string;
+    /** Gas price override */
+    gasPrice?: string;
+    /** Device share for wallet key reconstruction (required for SOL) */
+    deviceShare?: string;
+}
+/**
+ * SDK error codes
+ */
+declare enum SDKErrorCode {
+    UNKNOWN = "UNKNOWN",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    API_ERROR = "API_ERROR",
+    INVALID_INPUT = "INVALID_INPUT",
+    CHAIN_NOT_SUPPORTED = "CHAIN_NOT_SUPPORTED",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    KEY_MISMATCH = "KEY_MISMATCH",
+    KEY_RECONSTRUCTION_FAILED = "KEY_RECONSTRUCTION_FAILED",
+    SIGNATURE_FAILED = "SIGNATURE_FAILED",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    BROADCAST_FAILED = "BROADCAST_FAILED",
+    ORDER_NOT_FOUND = "ORDER_NOT_FOUND",
+    MULTISIG_NOT_FOUND = "MULTISIG_NOT_FOUND",
+    WALLET_NOT_FOUND = "WALLET_NOT_FOUND",
+    THRESHOLD_NOT_MET = "THRESHOLD_NOT_MET",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    ORG_POLICY_REJECTED = "ORG_POLICY_REJECTED",
+    RATE_LIMITED = "RATE_LIMITED",
+    TIMEOUT = "TIMEOUT"
+}
+/**
+ * Stable platform codes returned by the server when an order is rejected by
+ * an organization security policy. Applies to the six chain-specific order
+ * creation routes (`POST /sdk/order/create/{evm,sol,btc,tron,ada,xrp}`) and
+ * to any other downstream route that runs the same policy check pipeline.
+ *
+ * The four codes correspond to the four org policy checks documented in
+ * `docs/v3-b2b-sdk-implementation-plan.md` (Step 2b) and
+ * `docs/api-contract-clarifications.md`:
+ *
+ * - `ERROR_KYC_REQUIRED` — caller (or org) has not completed KYC/KYB.
+ * - `ERROR_BUSINESS_HOURS_VIOLATION` — outside the org's allowed window.
+ * - `ERROR_ADDRESS_NOT_WHITELISTED` — `forceAddressBook` is on and the
+ *   destination is not a verified Corporate Address Book entry.
+ * - `ERROR_DAILY_LIMIT_EXCEEDED` — `dailySpendingLimitUsd` would be
+ *   exceeded by this transfer.
+ *
+ * Master accounts are exempt from these checks server-side, so this error
+ * is never thrown for Master callers.
+ *
+ * Step 7.1 follow-up: confirm staging actually uses these literal strings
+ * (and which JSON field carries them) before flipping
+ * `ORG_POLICY_MAPPING_ENABLED` in `src/api/client.ts` to `true`.
+ */
+type OrgPolicyCode = "ERROR_KYC_REQUIRED" | "ERROR_BUSINESS_HOURS_VIOLATION" | "ERROR_ADDRESS_NOT_WHITELISTED" | "ERROR_DAILY_LIMIT_EXCEEDED";
+/**
+ * Runtime list of every known `OrgPolicyCode`. Kept in sync with the type
+ * union above; used by `extractOrgPolicyCode` in `src/core/errors.ts`.
+ */
+declare const ORG_POLICY_CODES: readonly OrgPolicyCode[];
+/**
+ * SDK error interface
+ */
+interface SDKError {
+    code: SDKErrorCode;
+    message: string;
+    chain?: ChainType;
+    operation?: string;
+    details?: Record<string, unknown>;
+    cause?: Error;
+}
+/**
+ * Network mode
+ */
+type NetworkMode = "mainnet" | "testnet";
+/**
+ * RPC overrides per chain
+ */
+type RpcOverrides = Partial<Record<ChainIdValue, string>>;
+/**
+ * SDK configuration options
+ */
+interface SDKConfig {
+    /** API key for authentication (use this OR accessToken) */
+    apiKey?: string;
+    /** Access token for authentication (use this OR apiKey) */
+    accessToken?: string;
+    network?: NetworkMode;
+    apiBaseUrl?: string;
+    /**
+     * Base path segment for SDK HTTP routes (default `/sdk`).
+     * Only change this if the API is mounted under a different prefix.
+     */
+    apiPathPrefix?: string;
+    rpcOverrides?: RpcOverrides;
+    timeout?: number;
+}
+/**
+ * Wallet rename response
+ */
+interface WalletRenameResponse {
+    wallet: TWallet;
+}
+/**
+ * Delete operation response
+ */
+interface DeleteResponse {
+    success: boolean;
+}
+
+interface XrpAccountReserveInfo {
+    address: string;
+    totalBalance: string;
+    availableBalance: string;
+    totalReserve: string;
+    baseReserve: string;
+    ownerCount: number;
+    ownerReservePerObject: string;
+    objects: {
+        trustLines: number;
+        signerList: boolean;
+        offers: number;
+        escrows: number;
+        otherObjects: number;
+    };
+}
+interface TrustLineInfo {
+    currency: string;
+    issuer: string;
+    balance: string;
+    limit: string;
+}
+
+interface CreateWalletInput {
+    chain: EChainType;
+}
+interface CreateWalletOutput {
+    wallets: TWallet[];
+}
+interface ImportWalletInput {
+    chain: EChainType;
+    privateKey: string;
+}
+interface DeleteWalletInput {
+    chain: EChainType;
+    address: string;
+}
+interface GetWalletInput {
+    address: string;
+}
+interface GetWalletsInput {
+    chain?: EChainType;
+    chainTypes?: EChainType[];
+    page?: number;
+    limit?: number;
+}
+interface GetPortfolioInput {
+    chain: EChainType;
+    address: string;
+    chainId: ChainIdValue;
+}
+interface SendTransactionInput {
+    chain: EChainType;
+    from: string;
+    to: string;
+    amount: string;
+    symbol?: string;
+    chainId?: number;
+    feeHint?: EstimatedFee;
+    tokenAddress: string;
+    decimals: number;
+    isNativeToken?: boolean;
+    memo?: string;
+}
+interface SendTransactionOutput {
+    txHash: string;
+}
+/** Input for exportWallet */
+interface ExportWalletInput {
+    chain: EChainType;
+    address: string;
+    format?: "hex" | "wif" | "bs58";
+}
+/** Output for exportWallet */
+interface ExportWalletOutput {
+    privateKey: string;
+}
+/** Input for updateWalletName */
+interface UpdateWalletNameInput {
+    chain: EChainType;
+    address: string;
+    name: string;
+}
+/** Input for createMultisig */
+interface CreateMultisigInput {
+    chain: EChainType;
+    owners: string[];
+    threshold: number;
+    chainIds?: ChainIdValue[];
+}
+/** Input for getMultisigs */
+interface GetMultisigsInput {
+    chain: EChainType;
+    walletAddress?: string;
+}
+/** Input for getMultisigById */
+interface GetMultisigByIdInput {
+    chain: EChainType;
+    address: string;
+}
+
+/** Output for activateMultisig */
+interface ActivateMultisigOutput {
+    txHash: string;
+}
+/** Input for estimateActivationFee */
+interface EstimateActivationFeeInput {
+    chain: EChainType;
+    multisigId?: string;
+    owners?: string[];
+    threshold?: number;
+    chainId?: ChainIdValue;
+}
+/** Input for updateMultisigName */
+interface UpdateMultisigNameInput {
+    chain: EChainType;
+    multisigId: string;
+    name: string;
+    walletAddress: string;
+}
+/** Input for deleteMultisig */
+interface DeleteMultisigInput {
+    chain: EChainType;
+    multisigId: string;
+}
+/** Input for createOrder */
+interface CreateOrderInput {
+    chain: EChainType;
+    multisigId: string;
+    walletAddress: string;
+    method: OrderMethodType;
+    instructions: OrderInstruction[];
+    threshold?: number;
+    token?: TokenInfo;
+    orderIdToActivate?: string;
+}
+/** Output for createOrder */
+interface CreateOrderOutput {
+    order: Order;
+    proposalHash?: string;
+}
+/** Input for signOrder */
+interface SignOrderInput {
+    chain: EChainType;
+    order: Order;
+    walletAddress: string;
+    multisigId?: string;
+}
+/** Output for signOrder */
+interface SignOrderOutput {
+    signature: string;
+    order: Order;
+}
+/** Input for rejectOrder */
+interface RejectOrderInput {
+    chain: EChainType;
+    order: Order;
+    multisig: MultisigsItem;
+    walletAddress: string;
+}
+/** Input for executeOrder */
+interface ExecuteOrderInput {
+    chain: EChainType;
+    order: Order;
+    multisig: MultisigsItem;
+    walletAddress: string;
+    feeQuote?: EstimatedFee;
+}
+/** Output for executeOrder */
+interface ExecuteOrderOutput {
+    txHash: string;
+    order: Order;
+}
+/** Input for estimateOrderExecutionFee */
+interface EstimateOrderExecutionFeeInput {
+    chain: EChainType;
+    orderId: string;
+    walletAddress: string;
+    chainId?: ChainIdValue;
+}
+/** Input for getOrders */
+interface GetOrdersInput {
+    chain: EChainType;
+    multisigId: string;
+    page?: number;
+    limit?: number;
+}
+/** Input for getOrderById */
+interface GetOrderByIdInput {
+    chain: EChainType;
+    orderId: string;
+}
+/** Input for deleteOrder */
+interface DeleteOrderInput {
+    chain: EChainType;
+    orderId: string;
+}
+/** Input for getSupportedTokens */
+interface GetSupportedTokensInput {
+    chain: EChainType;
+    chainId: ChainIdValue;
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+/** Input for getWalletHistory */
+interface GetWalletHistoryInput {
+    chain: EChainType;
+    walletAddress: string;
+    page?: number;
+    limit?: number;
+}
+/** Input for getMultisigTxHistory */
+interface GetMultisigTxHistoryInput {
+    multisigId: string;
+    page?: number;
+    limit?: number;
+}
+/** Input for getXrpAccountReserve */
+interface GetXrpAccountReserveInput {
+    address: string;
+}
+/** Input for getXrpTrustLines */
+interface GetXrpTrustLinesInput {
+    address: string;
+}
+/** Input for activateXrpTrustLine */
+interface ActivateXrpTrustLineInput {
+    /** XRP wallet address that will open the trust line */
+    address: string;
+    /** Currency code, e.g. "USD" or 40-char hex */
+    currency: string;
+    /** Issuer address, e.g. "rIssuer..." */
+    issuer: string;
+    /** Max token amount to hold (default: "1000000000") */
+    limit?: string;
+}
+/** Output for activateXrpTrustLine */
+interface ActivateXrpTrustLineOutput {
+    /** Transaction hash */
+    hash: string;
+    /** Signed tx blob (hex) */
+    tx: string;
+    /** Engine result, e.g. "tesSUCCESS" */
+    result: string;
+}
+interface CreateAddressBookEntryInput {
+    name: string;
+    address: string;
+    chainType: EChainType;
+    type: AddressBookEntryType;
+    memo?: string;
+}
+interface GetAddressBookEntriesInput {
+    chainType?: EChainType;
+    type?: AddressBookEntryType;
+}
+interface UpdateAddressBookEntryInput {
+    id: string;
+    name?: string;
+    memo?: string | null;
+}
+interface DeleteAddressBookEntryInput {
+    id: string;
+}
+interface GetAddressTypeInput {
+    chainType: EChainType;
+    address: string;
+}
+interface UpdateOrgAddressBookEntryInput extends UpdateOrgAddressInput {
+    /** UUID of the org address-book entry to update. */
+    addressId: string;
+}
+interface DeleteOrgAddressBookEntryInput {
+    /** UUID of the org address-book entry to remove. */
+    addressId: string;
+}
+declare class AfridaxSDK {
+    private readonly resolvedConfig;
+    private readonly rpcConfig;
+    private readonly client;
+    private readonly walletService;
+    private readonly multisigApi;
+    private readonly orderApi;
+    private readonly blockchainAdapter;
+    private readonly keyManager;
+    private readonly txService;
+    private readonly addressBookApi;
+    private readonly organizationApi;
+    constructor(config: SDKConfig);
+    /**
+     * 1.1 Create a new MPC wallet with Shamir secret sharing
+     */
+    createWallet(input: CreateWalletInput): Promise<CreateWalletOutput>;
+    /**
+     * 1.2 Import an existing wallet via private key
+     */
+    importWallet(input: ImportWalletInput): Promise<CreateWalletResponse>;
+    /**
+     * 1.3 Remove wallet from account
+     */
+    deleteWallet(input: DeleteWalletInput): Promise<DeleteResponse>;
+    /**
+     * 1.4 Fetch single wallet details
+     */
+    getWallet(input: GetWalletInput): Promise<TWallet>;
+    /**
+     * 1.5 List all wallets for user (with optional pagination)
+     */
+    getWallets(input?: GetWalletsInput): Promise<PaginatedWalletsResponse>;
+    /**
+     * 1.6 Get wallet token balances and portfolio (batch request)
+     * User constructs the PortfolioRequest array themselves
+     */
+    getWalletsPortfolio(requests: PortfolioRequest[]): Promise<WalletPortfolioResponse[]>;
+    /**
+     * 1.7 Get wallet portfolio for a single wallet (convenience method)
+     */
+    getPortfolio(input: GetPortfolioInput): Promise<WalletPortfolioResponse>;
+    /**
+     * 1.7 Send native currency (ETH/SOL/TRX/BTC)
+     */
+    sendTransaction(input: SendTransactionInput): Promise<SendTransactionOutput>;
+    /**
+     * 1.9 Estimate transaction fee for any operation
+     */
+    estimateFee(input: EstimateFeeInput): Promise<EstimatedFee>;
+    private getChainIdForEstimation;
+    exportWallet(input: ExportWalletInput): Promise<ExportWalletOutput>;
+    /**
+     * 1.11 Rename a wallet
+     */
+    updateWalletName(input: UpdateWalletNameInput): Promise<WalletRenameResponse>;
+    /**
+     * 2.1 Create a new multisig vault
+     */
+    createMultisig(input: CreateMultisigInput): Promise<MultisigsItem | MultisigsItem[]>;
+    /**
+     * 2.2 List all multisigs for user
+     */
+    getMultisigs(input: GetMultisigsInput): Promise<MultisigBaseDTO[]>;
+    /**
+     * 2.2b Paginated vault list (GET /sdk/multisig) with optional chain filters.
+     */
+    getPaginatedMultisigs(input?: GetPaginatedMultisigsInput): Promise<PaginatedMultisigsWithTokensResponse>;
+    /**
+     * 2.3 Get single multisig details
+     */
+    getMultisigById(input: GetMultisigByIdInput): Promise<MultisigBaseDTO>;
+    /**
+     * 2.4 Deploy/activate multisig on-chain
+     */
+    activateMultisig(input: ActivateMultisigInput): Promise<ActivateMultisigOutput>;
+    /**
+     * 2.5 Estimate gas/fee for multisig activation
+     * Note: Returns a placeholder fee. Use chain-specific methods for accurate estimates.
+     */
+    estimateActivationFee(input: EstimateActivationFeeInput): Promise<EstimatedFee>;
+    /**
+     * 2.6 Rename multisig vault
+     */
+    updateMultisigName(input: UpdateMultisigNameInput): Promise<MultisigBaseDTO>;
+    /**
+     * 2.7 Remove multisig from account
+     */
+    deleteMultisig(input: DeleteMultisigInput): Promise<DeleteResponse>;
+    /**
+     * 2.8 Create a new transaction proposal
+     */
+    createOrder(input: CreateOrderInput): Promise<CreateOrderOutput>;
+    /**
+     * 2.8a Create a send order (token transfer) - Simplified API
+     * Automatically detects method and builds instructions
+     */
+    createSendOrder(input: {
+        multisigId: string;
+        walletAddress: string;
+        to: string;
+        amount: string;
+        token?: TokenInfo;
+        chainId: string;
+        memo?: string;
+    }): Promise<CreateOrderOutput>;
+    /**
+     * 2.8b Create a settings order (multisig configuration change) - Simplified API
+     * Automatically calculates changes and determines method
+     */
+    createSettingsOrder(input: {
+        multisigId: string;
+        multisig: MultisigsItem;
+        walletAddress: string;
+        newOwners: string[];
+        newThreshold?: number;
+    }): Promise<CreateOrderOutput>;
+    /**
+     * 2.9 Sign/approve a pending order
+     * Uses blockchainAdapter to properly reconstruct key and sign order hash
+     */
+    signOrder(input: SignOrderInput): Promise<SignOrderOutput>;
+    private getChainIdForSignOrder;
+    /**
+     * 2.10 Reject a pending order
+     */
+    rejectOrder(input: RejectOrderInput): Promise<Order>;
+    /**
+     * 2.11 Execute a fully-signed order
+     */
+    executeOrder(input: ExecuteOrderInput): Promise<ExecuteOrderOutput>;
+    /**
+     * 2.12 Estimate fee for executing order
+     * Note: Returns a placeholder fee. Use chain-specific methods for accurate estimates.
+     */
+    estimateOrderExecutionFee(input: EstimateOrderExecutionFeeInput): Promise<EstimatedFee>;
+    /**
+     * 2.13 List orders for a multisig
+     */
+    getOrders(input: GetOrdersInput): Promise<PaginatedOrdersResponse>;
+    /**
+     * 2.14 Get single order details
+     */
+    getOrderById(input: GetOrderByIdInput): Promise<{
+        order: Order;
+    }>;
+    /**
+     * 2.15 Delete a pending order
+     */
+    deleteOrder(input: DeleteOrderInput): Promise<DeleteResponse>;
+    /**
+     * 3.1 List supported tokens for a chain
+     */
+    getSupportedTokens(input: GetSupportedTokensInput): Promise<SupportedTokensResponse>;
+    /**
+     * 3.2 Get aggregate portfolio value across all wallets
+     */
+    getTotalAssetValue(): Promise<TotalAssetValueResponse>;
+    /**
+     * 4.1 Get transaction history for a wallet
+     */
+    getWalletHistory(input: GetWalletHistoryInput): Promise<HistoryResponse>;
+    /**
+     * 4.2 Get order/execution history for a multisig
+     */
+    getMultisigTxHistory(input: GetMultisigTxHistoryInput): Promise<TxHistoryCombinedResponse>;
+    /**
+     * 5.1 Activate (open) a trust line for an IOU token on a personal XRP wallet.
+     * Builds and broadcasts a TrustSet transaction. Requires ~0.2 XRP available
+     * for the new reserve object.
+     */
+    activateXrpTrustLine(input: ActivateXrpTrustLineInput): Promise<ActivateXrpTrustLineOutput>;
+    /**
+     * 5.2 Get XRP account reserve breakdown
+     */
+    getXrpAccountReserve(input: GetXrpAccountReserveInput): Promise<XrpAccountReserveInfo>;
+    /**
+     * 5.2 Get trust lines for an XRP address
+     */
+    getXrpTrustLines(input: GetXrpTrustLinesInput): Promise<TrustLineInfo[]>;
+    /**
+     * 6.1 Create an address book entry
+     */
+    createAddressBookEntry(input: CreateAddressBookEntryInput): Promise<AddressBookEntry>;
+    /**
+     * 6.2 List address book entries
+     */
+    getAddressBookEntries(input?: GetAddressBookEntriesInput): Promise<AddressBookEntry[]>;
+    /**
+     * 6.3 Update an address book entry
+     */
+    updateAddressBookEntry(input: UpdateAddressBookEntryInput): Promise<AddressBookEntry>;
+    /**
+     * 6.4 Delete an address book entry
+     */
+    deleteAddressBookEntry(input: DeleteAddressBookEntryInput): Promise<void>;
+    /**
+     * 6.5 Get address type (CEX or Wallet)
+     */
+    getAddressType(input: GetAddressTypeInput): Promise<AddressTypeResponse>;
+    /**
+     * 7.1 List members of the calling user's organization. Master-only.
+     *
+     * Server route: `GET /sdk/organization/team`.
+     */
+    getOrgTeam(): Promise<OrgTeamDirectoryResponse>;
+    /**
+     * 7.2 Invite a new member by email. Master-only.
+     *
+     * Server route: `POST /sdk/organization/team/invite`.
+     *
+     * Server enforces the 10-user org limit and the global
+     * 1-organization-per-email rule; both surface as `ApiError(409)`.
+     */
+    inviteOrgMember(input: InviteOrgMemberInput): Promise<InviteOrgMemberResponse>;
+    /**
+     * 7.3 Remove a member from the org. Master-only.
+     *
+     * Server route: `DELETE /sdk/organization/team/{memberId}`. Cascades
+     * cleanup of wallet assignments, MPC shares, multisig signatures, and
+     * sessions. Resolves with `void` on success (HTTP 204).
+     */
+    removeOrgMember(input: RemoveOrgMemberInput): Promise<void>;
+    /**
+     * 7.4 List wallets/vaults currently assigned to a specific member.
+     * Master-only.
+     *
+     * Server route: `GET /sdk/organization/team/{memberId}/wallets`.
+     */
+    listOrgMemberWallets(input: ListOrgMemberWalletsInput): Promise<OrgWalletsResponse>;
+    /**
+     * 7.5 Grant a member access to a wallet or vault. Master-only.
+     *
+     * Server route: `POST /sdk/organization/team/{memberId}/wallets`.
+     * Returns 409 on duplicate assignment.
+     */
+    assignOrgWallet(input: AssignOrgWalletInput): Promise<AssignOrgWalletResponse>;
+    /**
+     * 7.6 Revoke a member's access to a wallet or vault. Master-only.
+     *
+     * Server route: `DELETE /sdk/organization/team/{memberId}/wallets/{walletId}`.
+     * Triggers MPC share cleanup server-side.
+     */
+    unassignOrgWallet(input: UnassignOrgWalletInput): Promise<void>;
+    /**
+     * 7.7 List all wallets/vaults owned by the organization (available for
+     * assignment to members). Master-only.
+     *
+     * Server route: `GET /sdk/organization/wallets`.
+     */
+    listOrgWallets(): Promise<OrgWalletsResponse>;
+    /**
+     * 7.8 Read the org's current security policy. Master-only.
+     *
+     * Server route: `GET /sdk/organization/policies`.
+     */
+    getOrgPolicies(): Promise<OrgPolicy>;
+    /**
+     * 7.9 Update the org's security policy (partial). Master-only.
+     *
+     * Server route: `PATCH /sdk/organization/policies`. Server enforces
+     * conditional validation (business-hours triplet, positive spending
+     * limit). Returns the full, fresh policy object.
+     */
+    updateOrgPolicies(input: UpdateOrgPolicyInput): Promise<OrgPolicy>;
+    /**
+     * 7.10 List Corporate Address Book entries (verified and pending).
+     *
+     * Server route: `GET /sdk/organization/address-book`. Accessible to all
+     * org members. Only entries with `isVerified === true` count toward the
+     * `forceAddressBook` transfer whitelist policy.
+     */
+    listOrgAddresses(): Promise<OrgAddressBookEntry[]>;
+    /**
+     * 7.11 Add an entry to the Corporate Address Book. Master-only.
+     *
+     * Server route: `POST /sdk/organization/address-book`. API-key flows
+     * auto-verify the entry (no OTP). Travel Rule conditional fields are
+     * validated server-side based on `recipientType` / `walletType`.
+     */
+    addOrgAddress(input: CreateOrgAddressInput): Promise<AddOrgAddressResponse>;
+    /**
+     * 7.12 Update label / memo / type / Travel Rule metadata of an org
+     * address-book entry. Master-only.
+     *
+     * Server route: `PATCH /sdk/organization/address-book/{addressId}`.
+     * `address` and `chainType` are immutable.
+     */
+    updateOrgAddress(input: UpdateOrgAddressBookEntryInput): Promise<OrgAddressBookEntry>;
+    /**
+     * 7.13 Remove an entry from the Corporate Address Book. Master-only.
+     *
+     * Server route: `DELETE /sdk/organization/address-book/{addressId}`.
+     */
+    deleteOrgAddress(input: DeleteOrgAddressBookEntryInput): Promise<void>;
+    /**
+     * 7.14 Read the org audit trail. Master-only.
+     *
+     * Server route: `GET /sdk/organization/audit-logs`. Supports pagination,
+     * date range, `actorId`, and a multi-select `eventTypes` filter.
+     * `eventTypes` is serialized as repeated query keys
+     * (`?eventTypes=Login&eventTypes=Wallet+Created`). Verify the exact
+     * server-accepted shape against staging before relying on this filter in
+     * production (see `docs/api-contract-clarifications.md`).
+     */
+    getOrgAuditLogs(input?: GetOrgAuditLogsInput): Promise<OrgAuditLogsResponse>;
+}
+
+declare const MEMO_MAX_LENGTH = 200;
+declare const XRP_MAX_DESTINATION_TAG = 4294967295;
+declare const MEMO_SUPPORTED_CHAINS: readonly [EChainType.XRP, EChainType.SOL, EChainType.TRON];
+interface MemoValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+declare function isMemoSupported(chainType: EChainType): boolean;
+declare function validateMemo(memo: string, chainType: EChainType): MemoValidationResult;
+declare function getMemoPlaceholder(chainType: EChainType): string;
+
+declare abstract class AfridaxBaseError extends Error implements SDKError {
+    readonly code: SDKErrorCode;
+    readonly chain?: ChainType;
+    readonly operation?: string;
+    readonly details?: Record<string, unknown>;
+    readonly cause?: Error;
+    constructor(code: SDKErrorCode, message: string, options?: {
+        chain?: ChainType;
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    /**
+     * Converts the error to a plain SDKError object for serialization
+     */
+    toJSON(): SDKError;
+    /**
+     * Returns a formatted string representation of the error
+     */
+    toString(): string;
+}
+/**
+ * Error thrown when an API request fails.
+ * Includes HTTP status code and response details.
+ */
+declare class ApiError extends AfridaxBaseError {
+    readonly statusCode?: number;
+    readonly responseBody?: unknown;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        responseBody?: unknown;
+        chain?: ChainType;
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    toJSON(): SDKError & {
+        statusCode?: number;
+    };
+}
+/**
+ * Error thrown when reconstructed private key does not match expected address.
+ * Indicates device share may be stale and requires force update.
+ */
+declare class KeyMismatchError extends AfridaxBaseError {
+    readonly expectedAddress: string;
+    readonly derivedAddress?: string;
+    constructor(message: string, options: {
+        expectedAddress: string;
+        derivedAddress?: string;
+        chain?: ChainType;
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    toJSON(): SDKError & {
+        expectedAddress: string;
+        derivedAddress?: string;
+    };
+}
+/**
+ * Error thrown when wallet has insufficient balance for a transaction.
+ * Includes required and available amounts.
+ */
+declare class InsufficientBalanceError extends AfridaxBaseError {
+    readonly requiredAmount: string;
+    readonly availableAmount: string;
+    readonly currency: string;
+    constructor(message: string, options: {
+        requiredAmount: string;
+        availableAmount: string;
+        currency: string;
+        chain?: ChainType;
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    toJSON(): SDKError & {
+        requiredAmount: string;
+        availableAmount: string;
+        currency: string;
+    };
+}
+/**
+ * Error thrown when an operation is attempted on an unsupported chain.
+ */
+declare class ChainNotSupportedError extends AfridaxBaseError {
+    readonly requestedChain: string;
+    readonly supportedChains: string[];
+    constructor(message: string, options: {
+        requestedChain: string;
+        supportedChains: string[];
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    toJSON(): SDKError & {
+        requestedChain: string;
+        supportedChains: string[];
+    };
+}
+/**
+ * Error thrown when a network request fails (connection issues, timeouts, etc.).
+ */
+declare class NetworkError extends AfridaxBaseError {
+    readonly endpoint?: string;
+    readonly isTimeout: boolean;
+    constructor(message: string, options?: {
+        endpoint?: string;
+        isTimeout?: boolean;
+        chain?: ChainType;
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    toJSON(): SDKError & {
+        endpoint?: string;
+        isTimeout: boolean;
+    };
+}
+/**
+ * Error thrown when input validation fails.
+ */
+declare class InvalidInputError extends AfridaxBaseError {
+    readonly field?: string;
+    readonly value?: unknown;
+    constructor(message: string, options?: {
+        field?: string;
+        value?: unknown;
+        chain?: ChainType;
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when authorization fails (invalid API key, expired token, etc.).
+ */
+declare class UnauthorizedError extends AfridaxBaseError {
+    constructor(message: string, options?: {
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when the API returns HTTP 403 (RBAC / ownership / Master-only).
+ *
+ * Distinct from `UnauthorizedError` (401, "who you say you are"):
+ * `PermissionDeniedError` means the caller is authenticated but lacks the
+ * required role/ownership for this resource. Typical server messages:
+ *
+ * - `"User is not an owner of the multisig or missing permission"`
+ *   (order create / sign / reject / execute)
+ * - `"Forbidden — not a Master Account"`
+ *   (`/sdk/organization/*` admin routes)
+ *
+ * The raw response body is preserved in `details.responseBody`.
+ *
+ * Note: this is RBAC, not org policy enforcement. The four `ERROR_*` policy
+ * codes (KYC / business hours / address whitelist / daily limit) are a
+ * separate concern and are not yet mapped to a typed error.
+ */
+declare class PermissionDeniedError extends AfridaxBaseError {
+    constructor(message: string, options?: {
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when the server rejects a request because of an organization
+ * security policy (KYC, business hours, address whitelist, daily limit).
+ *
+ * Distinct from `PermissionDeniedError` (RBAC / ownership): policy
+ * rejections only happen for **non-Master** members of an organization with
+ * the corresponding policy turned on. Master accounts are exempt
+ * server-side, individuals never have policies attached, and SDK 2FA bypass
+ * is unchanged by this layer.
+ *
+ * The discriminator is `platformCode` — one of the four stable strings in
+ * `OrgPolicyCode`. The full response body is preserved in
+ * `details.responseBody` so integrators can surface human-readable copy
+ * the server may also return (e.g. localized message, retry-after hint).
+ *
+ * Step 7.1 / 7.3 note: mapping is currently gated behind the
+ * `ORG_POLICY_MAPPING_ENABLED` toggle in `src/api/client.ts` because the
+ * exact JSON field name(s) staging uses for the code is still TBD. Once a
+ * staging capture is recorded in `docs/api-contract-clarifications.md`,
+ * flip the toggle to `true` (and update `extractOrgPolicyCode` below if
+ * the discriminator field doesn't match any of the candidates already
+ * probed).
+ */
+declare class OrgPolicyRejectedError extends AfridaxBaseError {
+    readonly platformCode: OrgPolicyCode;
+    readonly statusCode?: number;
+    readonly responseBody?: unknown;
+    constructor(message: string, options: {
+        platformCode: OrgPolicyCode;
+        statusCode?: number;
+        responseBody?: unknown;
+        operation?: string;
+        chain?: ChainType;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    toJSON(): SDKError & {
+        platformCode: OrgPolicyCode;
+        statusCode?: number;
+    };
+}
+/**
+ * Error thrown when a resource is not found.
+ */
+declare class NotFoundError extends AfridaxBaseError {
+    readonly resourceType: 'order' | 'multisig' | 'wallet';
+    readonly resourceId: string;
+    constructor(message: string, options: {
+        resourceType: 'order' | 'multisig' | 'wallet';
+        resourceId: string;
+        chain?: ChainType;
+        operation?: string;
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * Type guard to check if an error is an AfridaxBaseError
+ */
+declare function isAfridaxError(error: unknown): error is AfridaxBaseError;
+
+export { type ActivateMultisigInput, type ActivateMultisigOutput, type ActivateXrpTrustLineInput, type ActivateXrpTrustLineOutput, type AdaNativeInstruction, type AdaTokenInstruction, type AddOrgAddressResponse, type AddressBookEntry, type AddressBookEntryType, type AddressTypeResponse, AfridaxBaseError, AfridaxSDK, ApiError, type AssignOrgWalletInput, type AssignOrgWalletResponse, type ChainIdValue, ChainNotSupportedError, type ChainType, type CreateAddressBookEntryInput, type CreateMultisigInput, type CreateOrderInput, type CreateOrderOutput, type CreateOrgAddressInput, type CreateWalletInput, type CreateWalletOutput, type CreateWalletResponse, type DeleteAddressBookEntryInput, type DeleteMultisigInput, type DeleteOrderInput, type DeleteOrgAddressBookEntryInput, type DeleteResponse, type DeleteWalletInput, EAdaInstructionType, EAddressBookEntryType, EChainType, EXrpOrderType, type EstimateActivationFeeInput, type EstimateFeeInput, type EstimateOrderExecutionFeeInput, type EstimatedFee, type ExecuteOrderInput, type ExecuteOrderOutput, type ExportWalletInput, type ExportWalletOutput, type GetAddressBookEntriesInput, type GetAddressTypeInput, type GetMultisigByIdInput, type GetMultisigTxHistoryInput, type GetMultisigsInput, type GetOrderByIdInput, type GetOrdersInput, type GetOrgAuditLogsInput, type GetPaginatedMultisigsInput, type GetPortfolioInput, type GetSupportedTokensInput, type GetWalletHistoryInput, type GetWalletInput, type GetWalletsInput, type GetXrpAccountReserveInput, type GetXrpTrustLinesInput, type GroupedMultisigResponseDTO, type HistoryResponse, type ImportWalletInput, InsufficientBalanceError, InvalidInputError, type InviteOrgMemberInput, type InviteOrgMemberResponse, KeyMismatchError, type ListOrgMemberWalletsInput, MEMO_MAX_LENGTH, MEMO_SUPPORTED_CHAINS, type MemoValidationResult, type MultisigBaseDTO, MultisigStatus, type MultisigsItem, NetworkError, NotFoundError, ORG_POLICY_CODES, type Order, type OrderInstruction, type OrderMethodType, type OrderParamsAda, type OrderParamsXrp, type OrderSigner, OrderStatus, type OrgAddressBookEntry, type OrgAddressRecipientType, type OrgAddressWalletType, type OrgAuditEventType, type OrgAuditLogItem, type OrgAuditLogsResponse, type OrgMemberKycStatus, type OrgMemberRole, type OrgMemberStatus, type OrgPolicy, type OrgPolicyCode, OrgPolicyRejectedError, type OrgTeamDirectoryResponse, type OrgTeamMember, type OrgWalletItem, type OrgWalletsResponse, type PaginatedMultisigsWithTokensResponse, type PaginatedOrdersResponse, type PaginatedWalletsResponse, PermissionDeniedError, type RejectOrderInput, type RemoveOrgMemberInput, type SDKConfig, type SendTransactionInput, type SendTransactionOutput, type SignOrderInput, type SignOrderOutput, type SingleWalletDetailsResponse, StatusFilterEnum, type SupportedTokensResponse, type TAdaCommandInstruction, type TWallet, type TXrpCommandInstruction, type TokenInfo, type TotalAssetValueResponse, TransactionEstimatingType, type TransactionHistoryItem, type TxHistoryCombinedResponse, type UnassignOrgWalletInput, UnauthorizedError, type UpdateAddressBookEntryInput, type UpdateMultisigNameInput, type UpdateOrgAddressBookEntryInput, type UpdateOrgAddressInput, type UpdateOrgPolicyInput, type UpdateWalletNameInput, type WalletPortfolioResponse, type WalletRenameResponse, XRP_MAX_DESTINATION_TAG, type XrpAccountReserveInfo, type XrpAssetInstruction, type XrpChangeThresholdInstruction, type XrpNativeInstruction, type XrpRemoveTrustLineInstruction, type XrpSetTrustLineInstruction, type TrustLineInfo as XrpTrustLineInfo, type XrpUpdateOwnerThresholdInstruction, type XrpUpdateOwnersInstruction, AfridaxSDK as default, getBtcChainType, getMemoPlaceholder, isAfridaxError, isMemoSupported, validateMemo };