multisigns-sdk 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,1181 @@
+/**
+ * Supported blockchain chain types
+ */
+type ChainType = "EVM" | "SOL" | "TRON" | "BTC" | "BTC_T3";
+declare enum EChainType {
+    EVM = "EVM",
+    SOL = "SOL",
+    TRON = "TRON",
+    BTC = "BTC",
+    BTC_T3 = "BTC_T3"
+}
+/**
+ * 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"
+}
+declare enum MainnetChainId {
+    BASE = "8453",
+    ARBITRUM = "42161",
+    SOLANA = "sol_mainnet",
+    BTC = "btc",
+    BNB = "56",
+    POL = "137",
+    ETH = "1",
+    OPTIMISM = "10",
+    TRON = "tron_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[];
+}
+/**
+ * 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";
+/**
+ * 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"
+}
+/**
+ * EVM method types for Gnosis Safe
+ */
+type EvmMethodType = "execTransaction" | "addOwnerWithThreshold" | "AddOwner" | "removeOwner" | "RemoveOwner" | "changeThreshold" | "ChangeThreshold" | "multiSend" | "MultiSend";
+/**
+ * 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 OrderInstruction {
+    to?: 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;
+}
+interface OrderSigner {
+    address: string;
+    signature?: string;
+    signedAt?: string;
+}
+type OrdersToken = {
+    name: string;
+    symbol: string;
+    logoURL: string;
+    priceUSD: number;
+    price24hChange: number;
+    decimals: number;
+    amount: number;
+};
+type InstructionArg = string | number | boolean;
+interface OrderMethod {
+    method: string;
+    args: InstructionArg[];
+}
+interface OrderInstructions {
+    type?: ESolanaInstructionType | ETronOrderType | EvmMethodType;
+    toPubkey?: string;
+    amount?: string;
+    newThreshold?: number;
+    newOwner?: string;
+    removeOwner?: string;
+    tokenAddress?: string;
+    to?: string;
+    value?: string;
+    data?: string;
+    owners?: string[];
+}
+interface OrderParams {
+    expireTime?: Date;
+    chainType: string;
+    proposalHash: string;
+    transactionIndex: string;
+    instructions: OrderInstructions[];
+    safeTxGas?: string;
+    token?: OrdersToken;
+    methods?: OrderMethod[];
+    operation?: "0" | "1" | string;
+    data?: string;
+    baseGas?: string;
+    gasPrice?: string;
+    gasToken?: string;
+    value?: string;
+    refundReceiver?: string;
+    feeSats?: string;
+    utxo?: Array<{
+        value: number;
+    }>;
+    transaction?: {
+        raw_data_hex?: string;
+    };
+}
+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;
+}
+/**
+ * Input for activateMultisig
+ */
+interface ActivateMultisigInput {
+    chain: ChainType;
+    multisigId: string;
+    multisigAddress: string;
+    walletAddress: string;
+    deviceShare: string;
+    feeQuote: EstimatedFee;
+    chainId?: ChainIdValue;
+    /** Full multisig object for EVM activation */
+    multisig: MultisigsItem;
+    /** Gas limit override */
+    gasLimit?: string;
+    /** Gas price override */
+    gasPrice?: 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",
+    RATE_LIMITED = "RATE_LIMITED",
+    TIMEOUT = "TIMEOUT"
+}
+/**
+ * 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
+ */
+interface RpcOverrides {
+    evm?: Record<number, string>;
+    solana?: string;
+    tron?: string;
+    btc?: 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;
+    rpcOverrides?: RpcOverrides;
+    timeout?: number;
+}
+/**
+ * Wallet rename response
+ */
+interface WalletRenameResponse {
+    data: {
+        wallet: TWallet;
+    };
+}
+/**
+ * Delete operation response
+ */
+interface DeleteResponse {
+    success: boolean;
+}
+
+interface CreateWalletInput {
+    chain: EChainType;
+}
+interface CreateWalletOutput {
+    wallets: TWallet[];
+    deviceShare: string;
+}
+interface ImportWalletInput {
+    chain: EChainType;
+    privateKey: string;
+}
+interface DeleteWalletInput {
+    chain: EChainType;
+    address: string;
+}
+interface GetWalletInput {
+    address: string;
+}
+interface GetWalletsInput {
+    chain?: EChainType;
+    page?: number;
+    limit?: number;
+}
+interface GetPortfolioInput {
+    chain: EChainType;
+    address: string;
+    chainId: ChainIdValue;
+}
+interface SendTransactionInput {
+    chain: EChainType;
+    from: string;
+    to: string;
+    amount: string;
+    deviceShare: string;
+    chainId?: number;
+    feeHint?: EstimatedFee;
+}
+interface SendTransactionOutput {
+    txHash: string;
+    updatedDeviceShare: string | null;
+}
+interface SendTokenInput {
+    chain: EChainType;
+    from: string;
+    to: string;
+    amount: string;
+    tokenAddress: string;
+    decimals: number;
+    deviceShare: string;
+    chainId?: number;
+}
+/** Input for estimateFee */
+interface EstimateFeeInput {
+    chain: EChainType;
+    txType: "send" | "sendToken" | "createOrder" | "signOrder" | "executeOrder" | "activateMultisig";
+    from?: string;
+    to?: string;
+    amount?: string;
+    tokenAddress?: string;
+    decimals?: number;
+    chainId?: number;
+    orderId?: string;
+    multisigId?: string;
+}
+/** Input for exportWallet */
+interface ExportWalletInput {
+    chain: EChainType;
+    address: string;
+    deviceShare: string;
+    format?: "hex" | "wif" | "bs58";
+}
+/** Output for exportWallet */
+interface ExportWalletOutput {
+    privateKey: string;
+    updatedDeviceShare: string | null;
+}
+/** 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;
+    updatedDeviceShare: string | null;
+}
+/** 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;
+    deviceShare: string;
+}
+/** Output for createOrder */
+interface CreateOrderOutput {
+    order: Order;
+    proposalHash?: string;
+    updatedDeviceShare: string | null;
+}
+/** Input for signOrder */
+interface SignOrderInput {
+    chain: EChainType;
+    order: Order;
+    walletAddress: string;
+    deviceShare: string;
+    multisigId?: string;
+}
+/** Output for signOrder */
+interface SignOrderOutput {
+    signature: string;
+    order: Order;
+    updatedDeviceShare: string | null;
+}
+/** Input for rejectOrder */
+interface RejectOrderInput {
+    chain: EChainType;
+    order: Order;
+    multisig: MultisigsItem;
+    walletAddress: string;
+    deviceShare?: string;
+}
+/** Input for executeOrder */
+interface ExecuteOrderInput {
+    chain: EChainType;
+    order: Order;
+    multisig: MultisigsItem;
+    walletAddress: string;
+    deviceShare: string;
+    feeQuote?: EstimatedFee;
+}
+/** Output for executeOrder */
+interface ExecuteOrderOutput {
+    txHash: string;
+    order: Order;
+    updatedDeviceShare: string | null;
+}
+/** 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;
+}
+declare class AfridaxSDK {
+    private readonly resolvedConfig;
+    private readonly client;
+    private readonly walletService;
+    private readonly multisigApi;
+    private readonly orderApi;
+    private readonly blockchainAdapter;
+    private readonly keyManager;
+    private readonly txService;
+    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.8 Send token (ERC20/SPL/TRC20)
+     */
+    sendToken(input: SendTokenInput): Promise<SendTransactionOutput>;
+    /**
+     * 1.9 Estimate transaction fee for any operation
+     */
+    estimateFee(input: EstimateFeeInput): Promise<EstimatedFee>;
+    /**
+     * 1.10 Export private key (reconstructs from shares)
+     * Works with empty deviceShare by fetching recovery+server shares from API
+     */
+    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.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;
+        deviceShare: string;
+        chainId: 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;
+        deviceShare: string;
+    }): 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>;
+}
+
+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 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, AfridaxBaseError, AfridaxSDK, ApiError, type ChainIdValue, ChainNotSupportedError, type ChainType, type CreateMultisigInput, type CreateOrderInput, type CreateOrderOutput, type CreateWalletInput, type CreateWalletOutput, type CreateWalletResponse, type DeleteMultisigInput, type DeleteOrderInput, type DeleteResponse, type DeleteWalletInput, EChainType, type EstimateActivationFeeInput, type EstimateFeeInput, type EstimateOrderExecutionFeeInput, type EstimatedFee, type ExecuteOrderInput, type ExecuteOrderOutput, type ExportWalletInput, type ExportWalletOutput, type GetMultisigByIdInput, type GetMultisigTxHistoryInput, type GetMultisigsInput, type GetOrderByIdInput, type GetOrdersInput, type GetPortfolioInput, type GetSupportedTokensInput, type GetWalletHistoryInput, type GetWalletInput, type GetWalletsInput, type HistoryResponse, type ImportWalletInput, InsufficientBalanceError, InvalidInputError, KeyMismatchError, type MultisigBaseDTO, MultisigStatus, type MultisigsItem, NetworkError, NotFoundError, type Order, type OrderInstruction, type OrderMethodType, type OrderSigner, OrderStatus, type PaginatedOrdersResponse, type PaginatedWalletsResponse, type RejectOrderInput, type SDKConfig, type SendTokenInput, type SendTransactionInput, type SendTransactionOutput, type SignOrderInput, type SignOrderOutput, type SingleWalletDetailsResponse, StatusFilterEnum, type SupportedTokensResponse, type TWallet, type TokenInfo, type TotalAssetValueResponse, type TransactionHistoryItem, type TxHistoryCombinedResponse, UnauthorizedError, type UpdateMultisigNameInput, type UpdateWalletNameInput, type WalletPortfolioResponse, type WalletRenameResponse, AfridaxSDK as default, getBtcChainType, isAfridaxError };