// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

import { APIResource } from '../../core/resource';
import { APIPromise } from '../../core/api-promise';
import { RequestOptions } from '../../internal/request-options';

export class Message extends APIResource {
  /**
   * Gets a transaction and returns a full simulation indicating what will happen in
   * the transaction together with a recommended action and some textual reasons of
   * why the transaction was flagged that way.
   *
   * @example
   * ```ts
   * const response = await client.solana.message.scan({
   *   account_address:
   *     '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
   *   metadata: { url: 'https://example.com' },
   *   transactions: [
   *     'vxBNpvao9QJmLKXUThbbjRnxm3ufu4Wku97kHd5a67FDjSqeHwcPrBKTjAHp4ECr61eWwoxvUEVTuuWX65P9bCNDJrTJpX64vjdtpHA8cogA4C92Ubj813wUUA8Ey4Bvcrdj5c1bSTrGZVzb8QmCKyzMu9kMiSWpFtaFrNN8zb9grr81N3R3njrFgxCxNSjboFtomLyZ3iUQBaBkRF1DyzGyc1r1kd8FnptaDWteNCXJHUYFeH8wBDwZJzNZfz71CiugXhxBTJSAqSNC8JEWm7kmCqwjUqLd23L2x2s',
   *   ],
   *   chain: 'mainnet',
   *   encoding: 'base58',
   *   method: 'signAndSendTransaction',
   *   options: ['simulation', 'validation'],
   * });
   * ```
   */
  scan(body: MessageScanParams, options?: RequestOptions): APIPromise<MessageScanResponse> {
    return this._client.post('/v0/solana/message/scan', { body, ...options });
  }
}

export interface MessageScanResponse {
  encoding: 'base58' | 'base64';

  /**
   * Unique identifier of the request
   */
  request_id: string | null;

  status: 'SUCCESS' | 'ERROR';

  /**
   * Error message if the simulation failed
   */
  error?: string | null;

  /**
   * Error details
   */
  error_details?:
    | MessageScanResponse.SolanamodulesTransactionScanningControllersSchemasErrorAPIErrorDetails
    | MessageScanResponse.SolanamodulesTransactionScanningControllersSchemasErrorTransactionErrorDetails
    | MessageScanResponse.SolanamodulesTransactionScanningControllersSchemasErrorInstructionErrorDetails
    | null;

  /**
   * Result of the request
   */
  result?: MessageScanResponse.Result | null;
}

export namespace MessageScanResponse {
  export interface SolanamodulesTransactionScanningControllersSchemasErrorAPIErrorDetails {
    category?: 'NODE_ERROR';

    /**
     * Advanced message of the error
     */
    message?: string;

    type?: 'ApiError';

    [k: string]: unknown;
  }

  export interface SolanamodulesTransactionScanningControllersSchemasErrorTransactionErrorDetails {
    /**
     * Index of the transaction in the bulk
     */
    transaction_index: number;

    category?: 'REVERT';

    /**
     * Advanced message of the error
     */
    message?: string;

    type?: 'TransactionError';

    [k: string]: unknown;
  }

  export interface SolanamodulesTransactionScanningControllersSchemasErrorInstructionErrorDetails {
    /**
     * Index of the instruction in the transaction
     */
    instruction_index: number;

    /**
     * Index of the transaction in the bulk
     */
    transaction_index: number;

    category?: 'REVERT';

    /**
     * Machine readable error code
     */
    code?: string | null;

    /**
     * Human readable error
     */
    message?: string;

    /**
     * Error number
     */
    number?: number | null;

    /**
     * The program account that caused the error
     */
    program_account?: string | null;

    type?: 'InstructionError';

    [k: string]: unknown;
  }

  /**
   * Result of the request
   */
  export interface Result {
    /**
     * Transaction Simulation Result
     */
    simulation: Result.Simulation | null;

    /**
     * Transaction Validation Result
     */
    validation: Result.Validation | null;
  }

  export namespace Result {
    /**
     * Transaction Simulation Result
     */
    export interface Simulation {
      /**
       * Summary of the actions and asset transfers that were made by the requested
       * account address
       */
      account_summary: Simulation.AccountSummary;

      /**
       * Ownership diffs of the account addresses
       */
      assets_ownership_diff: {
        [key: string]: Array<
          | Simulation.SolanaNativeSolOwnershipDiff
          | Simulation.SolanaStakedSolOwnershipDiff
          | Simulation.SolanaFungibleSolOwnershipDiff
          | Simulation.SolanaNonFungibleSolOwnershipDiff
        >;
      };

      /**
       * Details of addresses involved in the transaction
       */
      accounts_details?: Array<
        | Simulation.SolanaPdaAccountSchema
        | Simulation.SolanaSystemAccountDetailsSchema
        | Simulation.SolanaProgramAccountDetailsSchema
        | Simulation.SolanaTokenAccountDetailsSchema
        | Simulation.SolanaFungibleMintAccountDetailsSchema
        | Simulation.SolanaNonFungibleMintAccountDetailsSchema
        | Simulation.SolanaCnftMintAccountDetailsSchema
      >;

      /**
       * Mapping between the address of an account to the assets diff during the
       * transaction
       */
      assets_diff?: {
        [key: string]: Array<
          | Simulation.SolanaNativeAssetDiff
          | Simulation.SolanaSplFungibleAssetDiff
          | Simulation.SolanaSplNonFungibleAssetDiff
          | Simulation.SolanaCnftAssetDiff
        >;
      };

      /**
       * Mapping between the address of an account to the exposure of the assets during
       * the transaction
       */
      delegations?: {
        [key: string]: Array<
          | Simulation.SolanaCnftDelegation
          | Simulation.SolanaFungibleSplTokenDelegation
          | Simulation.SolanaNonFungibleSplTokenDelegation
        >;
      };

      transaction_actions?: Array<
        | 'native_wrap'
        | 'native_transfer'
        | 'token_transfer'
        | 'swap'
        | 'mint'
        | 'stake'
        | 'approval'
        | 'proxy_upgrade'
        | 'ownership_change'
        | 'set_code_account'
        | (string & {})
      > | null;
    }

    export namespace Simulation {
      /**
       * Summary of the actions and asset transfers that were made by the requested
       * account address
       */
      export interface AccountSummary {
        /**
         * Exposures made by the requested account address
         */
        account_delegations: Array<
          | AccountSummary.SolanaCnftDelegation
          | AccountSummary.SolanaFungibleSplTokenDelegation
          | AccountSummary.SolanaNonFungibleSplTokenDelegation
        >;

        /**
         * Ownership diffs of the requested account address
         */
        account_ownerships_diff: Array<
          | AccountSummary.SolanaNativeSolOwnershipDiff
          | AccountSummary.SolanaStakedSolOwnershipDiff
          | AccountSummary.SolanaFungibleSolOwnershipDiff
          | AccountSummary.SolanaNonFungibleSolOwnershipDiff
        >;

        /**
         * Total USD diff for the requested account address
         */
        total_usd_diff: AccountSummary.TotalUsdDiff;

        /**
         * Assets diffs of the requested account address
         */
        account_assets_diff?: Array<
          | AccountSummary.SolanaNativeAssetDiff
          | AccountSummary.SolanaSplFungibleAssetDiff
          | AccountSummary.SolanaSplNonFungibleAssetDiff
          | AccountSummary.SolanaCnftAssetDiff
        >;

        /**
         * Total USD exposure for each of the spender addresses during the transaction
         */
        total_usd_exposure?: { [key: string]: number };
      }

      export namespace AccountSummary {
        export interface SolanaCnftDelegation {
          asset: SolanaCnftDelegation.Asset;

          asset_type: string;

          delegate: string;

          delegation: SolanaCnftDelegation.Delegation;
        }

        export namespace SolanaCnftDelegation {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            decimals?: 0;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'CNFT';
          }

          export interface Delegation {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaFungibleSplTokenDelegation {
          asset: SolanaFungibleSplTokenDelegation.Asset;

          asset_type: string;

          delegate: string;

          delegation: SolanaFungibleSplTokenDelegation.Delegation;
        }

        export namespace SolanaFungibleSplTokenDelegation {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's decimals
             */
            decimals: number;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'TOKEN';
          }

          export interface Delegation {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaNonFungibleSplTokenDelegation {
          asset: SolanaNonFungibleSplTokenDelegation.Asset;

          asset_type: string;

          delegate: string;

          delegation: SolanaNonFungibleSplTokenDelegation.Delegation;
        }

        export namespace SolanaNonFungibleSplTokenDelegation {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            decimals?: 0;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'NFT';
          }

          export interface Delegation {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaNativeSolOwnershipDiff {
          asset: SolanaNativeSolOwnershipDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * The owner post the transaction
           */
          post_owner: string | null;

          /**
           * The owner prior to the transaction
           */
          pre_owner: string | null;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaNativeSolOwnershipDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaNativeSolOwnershipDiff.Out | null;
        }

        export namespace SolanaNativeSolOwnershipDiff {
          export interface Asset {
            decimals: number;

            /**
             * Type of the asset (`"NativeToken"`)
             */
            type: 'SOL' | 'ETH';

            /**
             * Logo of SOL
             */
            logo?: string | null;
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaStakedSolOwnershipDiff {
          asset: SolanaStakedSolOwnershipDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * The owner post the transaction
           */
          post_owner: string | null;

          /**
           * The owner prior to the transaction
           */
          pre_owner: string | null;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaStakedSolOwnershipDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaStakedSolOwnershipDiff.Out | null;
        }

        export namespace SolanaStakedSolOwnershipDiff {
          export interface Asset {
            decimals: number;

            /**
             * Type of the asset (`"StakedNative"`)
             */
            type: 'STAKED_SOL' | 'STAKED_ETH';

            /**
             * Logo of SOL
             */
            logo?: string | null;
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaFungibleSolOwnershipDiff {
          asset: SolanaFungibleSolOwnershipDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * The owner post the transaction
           */
          post_owner: string | null;

          /**
           * The owner prior to the transaction
           */
          pre_owner: string | null;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaFungibleSolOwnershipDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaFungibleSolOwnershipDiff.Out | null;
        }

        export namespace SolanaFungibleSolOwnershipDiff {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's decimals
             */
            decimals: number;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'TOKEN';
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaNonFungibleSolOwnershipDiff {
          asset: SolanaNonFungibleSolOwnershipDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * The owner post the transaction
           */
          post_owner: string | null;

          /**
           * The owner prior to the transaction
           */
          pre_owner: string | null;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaNonFungibleSolOwnershipDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaNonFungibleSolOwnershipDiff.Out | null;
        }

        export namespace SolanaNonFungibleSolOwnershipDiff {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            decimals?: 0;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'NFT';
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        /**
         * Total USD diff for the requested account address
         */
        export interface TotalUsdDiff {
          /**
           * Total incoming USD transfers
           */
          in: number;

          /**
           * Total outgoing USD transfers
           */
          out: number;

          /**
           * Total USD transfers
           */
          total?: number;
        }

        export interface SolanaNativeAssetDiff {
          asset: SolanaNativeAssetDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaNativeAssetDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaNativeAssetDiff.Out | null;
        }

        export namespace SolanaNativeAssetDiff {
          export interface Asset {
            decimals: number;

            /**
             * Type of the asset (`"NativeToken"`)
             */
            type: 'SOL' | 'ETH';

            /**
             * Logo of SOL
             */
            logo?: string | null;
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaSplFungibleAssetDiff {
          asset: SolanaSplFungibleAssetDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaSplFungibleAssetDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaSplFungibleAssetDiff.Out | null;
        }

        export namespace SolanaSplFungibleAssetDiff {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's decimals
             */
            decimals: number;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'TOKEN';
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaSplNonFungibleAssetDiff {
          asset: SolanaSplNonFungibleAssetDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaSplNonFungibleAssetDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaSplNonFungibleAssetDiff.Out | null;
        }

        export namespace SolanaSplNonFungibleAssetDiff {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            decimals?: 0;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'NFT';
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }

        export interface SolanaCnftAssetDiff {
          asset: SolanaCnftAssetDiff.Asset;

          /**
           * The type of the assets in this diff
           */
          asset_type: string;

          /**
           * Details of the incoming transfer
           */
          in?: SolanaCnftAssetDiff.In | null;

          /**
           * Details of the outgoing transfer
           */
          out?: SolanaCnftAssetDiff.Out | null;
        }

        export namespace SolanaCnftAssetDiff {
          export interface Asset {
            /**
             * Address of the token's contract
             */
            address: string;

            /**
             * token's name
             */
            name: string;

            /**
             * token's symbol
             */
            symbol: string;

            decimals?: 0;

            /**
             * URL of the asset's logo
             */
            logo?: string | null;

            type?: 'CNFT';
          }

          /**
           * Details of the incoming transfer
           */
          export interface In {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }

          /**
           * Details of the outgoing transfer
           */
          export interface Out {
            /**
             * Raw value of the transfer
             */
            raw_value: number;

            /**
             * Value of the transfer
             */
            value: number;

            /**
             * Summarized description of the transfer
             */
            summary?: string | null;

            /**
             * USD price of the asset
             */
            usd_price?: number | null;
          }
        }
      }

      export interface SolanaNativeSolOwnershipDiff {
        asset: SolanaNativeSolOwnershipDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * The owner post the transaction
         */
        post_owner: string | null;

        /**
         * The owner prior to the transaction
         */
        pre_owner: string | null;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaNativeSolOwnershipDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaNativeSolOwnershipDiff.Out | null;
      }

      export namespace SolanaNativeSolOwnershipDiff {
        export interface Asset {
          decimals: number;

          /**
           * Type of the asset (`"NativeToken"`)
           */
          type: 'SOL' | 'ETH';

          /**
           * Logo of SOL
           */
          logo?: string | null;
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaStakedSolOwnershipDiff {
        asset: SolanaStakedSolOwnershipDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * The owner post the transaction
         */
        post_owner: string | null;

        /**
         * The owner prior to the transaction
         */
        pre_owner: string | null;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaStakedSolOwnershipDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaStakedSolOwnershipDiff.Out | null;
      }

      export namespace SolanaStakedSolOwnershipDiff {
        export interface Asset {
          decimals: number;

          /**
           * Type of the asset (`"StakedNative"`)
           */
          type: 'STAKED_SOL' | 'STAKED_ETH';

          /**
           * Logo of SOL
           */
          logo?: string | null;
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaFungibleSolOwnershipDiff {
        asset: SolanaFungibleSolOwnershipDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * The owner post the transaction
         */
        post_owner: string | null;

        /**
         * The owner prior to the transaction
         */
        pre_owner: string | null;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaFungibleSolOwnershipDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaFungibleSolOwnershipDiff.Out | null;
      }

      export namespace SolanaFungibleSolOwnershipDiff {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's decimals
           */
          decimals: number;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'TOKEN';
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaNonFungibleSolOwnershipDiff {
        asset: SolanaNonFungibleSolOwnershipDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * The owner post the transaction
         */
        post_owner: string | null;

        /**
         * The owner prior to the transaction
         */
        pre_owner: string | null;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaNonFungibleSolOwnershipDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaNonFungibleSolOwnershipDiff.Out | null;
      }

      export namespace SolanaNonFungibleSolOwnershipDiff {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          decimals?: 0;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'NFT';
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaPdaAccountSchema {
        /**
         * Encoded public key of the account
         */
        account_address: string;

        /**
         * The address of the owning program
         */
        owner: string;

        was_written_to: boolean;

        /**
         * Description of the account
         */
        description?: string | null;

        type?: 'PDA';
      }

      export interface SolanaSystemAccountDetailsSchema {
        /**
         * Encoded public key of the account
         */
        account_address: string;

        was_written_to: boolean;

        /**
         * Description of the account
         */
        description?: string | null;

        type?: 'SYSTEM_ACCOUNT';
      }

      export interface SolanaProgramAccountDetailsSchema {
        /**
         * Encoded public key of the account
         */
        account_address: string;

        was_written_to: boolean;

        /**
         * Description of the account
         */
        description?: string | null;

        type?: 'PROGRAM' | 'NATIVE_PROGRAM';
      }

      export interface SolanaTokenAccountDetailsSchema {
        /**
         * Encoded public key of the account
         */
        account_address: string;

        /**
         * Encoded public key of the mint
         */
        mint_address: string;

        /**
         * Encoded public key of the owner
         */
        owner_address: string;

        was_written_to: boolean;

        /**
         * Description of the account
         */
        description?: string | null;

        type?: 'TOKEN_ACCOUNT';
      }

      export interface SolanaFungibleMintAccountDetailsSchema {
        /**
         * Encoded public key of the account
         */
        account_address: string;

        /**
         * Logo of the mint
         */
        logo: string | null;

        /**
         * Name of the mint
         */
        name: string;

        /**
         * Symbol of the mint
         */
        symbol: string;

        was_written_to: boolean;

        /**
         * Description of the account
         */
        description?: string | null;

        type?: 'FUNGIBLE_MINT_ACCOUNT';
      }

      export interface SolanaNonFungibleMintAccountDetailsSchema {
        /**
         * Encoded public key of the account
         */
        account_address: string;

        /**
         * Logo of the mint
         */
        logo: string | null;

        /**
         * Name of the mint
         */
        name: string;

        /**
         * Symbol of the mint
         */
        symbol: string;

        /**
         * URI of the mint
         */
        uri: string;

        was_written_to: boolean;

        /**
         * Description of the account
         */
        description?: string | null;

        type?: 'NON_FUNGIBLE_MINT_ACCOUNT';
      }

      export interface SolanaCnftMintAccountDetailsSchema {
        /**
         * Encoded public key of the account
         */
        account_address: string;

        /**
         * Logo of the mint
         */
        logo: string | null;

        /**
         * Name of the mint
         */
        name: string;

        /**
         * Symbol of the mint
         */
        symbol: string;

        /**
         * URI of the mint
         */
        uri: string;

        was_written_to: boolean;

        /**
         * Description of the account
         */
        description?: string | null;

        type?: 'CNFT_MINT_ACCOUNT';
      }

      export interface SolanaNativeAssetDiff {
        asset: SolanaNativeAssetDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaNativeAssetDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaNativeAssetDiff.Out | null;
      }

      export namespace SolanaNativeAssetDiff {
        export interface Asset {
          decimals: number;

          /**
           * Type of the asset (`"NativeToken"`)
           */
          type: 'SOL' | 'ETH';

          /**
           * Logo of SOL
           */
          logo?: string | null;
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaSplFungibleAssetDiff {
        asset: SolanaSplFungibleAssetDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaSplFungibleAssetDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaSplFungibleAssetDiff.Out | null;
      }

      export namespace SolanaSplFungibleAssetDiff {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's decimals
           */
          decimals: number;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'TOKEN';
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaSplNonFungibleAssetDiff {
        asset: SolanaSplNonFungibleAssetDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaSplNonFungibleAssetDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaSplNonFungibleAssetDiff.Out | null;
      }

      export namespace SolanaSplNonFungibleAssetDiff {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          decimals?: 0;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'NFT';
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaCnftAssetDiff {
        asset: SolanaCnftAssetDiff.Asset;

        /**
         * The type of the assets in this diff
         */
        asset_type: string;

        /**
         * Details of the incoming transfer
         */
        in?: SolanaCnftAssetDiff.In | null;

        /**
         * Details of the outgoing transfer
         */
        out?: SolanaCnftAssetDiff.Out | null;
      }

      export namespace SolanaCnftAssetDiff {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          decimals?: 0;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'CNFT';
        }

        /**
         * Details of the incoming transfer
         */
        export interface In {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }

        /**
         * Details of the outgoing transfer
         */
        export interface Out {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaCnftDelegation {
        asset: SolanaCnftDelegation.Asset;

        asset_type: string;

        delegate: string;

        delegation: SolanaCnftDelegation.Delegation;
      }

      export namespace SolanaCnftDelegation {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          decimals?: 0;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'CNFT';
        }

        export interface Delegation {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaFungibleSplTokenDelegation {
        asset: SolanaFungibleSplTokenDelegation.Asset;

        asset_type: string;

        delegate: string;

        delegation: SolanaFungibleSplTokenDelegation.Delegation;
      }

      export namespace SolanaFungibleSplTokenDelegation {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's decimals
           */
          decimals: number;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'TOKEN';
        }

        export interface Delegation {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }

      export interface SolanaNonFungibleSplTokenDelegation {
        asset: SolanaNonFungibleSplTokenDelegation.Asset;

        asset_type: string;

        delegate: string;

        delegation: SolanaNonFungibleSplTokenDelegation.Delegation;
      }

      export namespace SolanaNonFungibleSplTokenDelegation {
        export interface Asset {
          /**
           * Address of the token's contract
           */
          address: string;

          /**
           * token's name
           */
          name: string;

          /**
           * token's symbol
           */
          symbol: string;

          decimals?: 0;

          /**
           * URL of the asset's logo
           */
          logo?: string | null;

          type?: 'NFT';
        }

        export interface Delegation {
          /**
           * Raw value of the transfer
           */
          raw_value: number;

          /**
           * Value of the transfer
           */
          value: number;

          /**
           * Summarized description of the transfer
           */
          summary?: string | null;

          /**
           * USD price of the asset
           */
          usd_price?: number | null;
        }
      }
    }

    /**
     * Transaction Validation Result
     */
    export interface Validation {
      /**
       * A textual classification that can be presented to the user explaining the
       * reason.
       */
      classification: string;

      /**
       * A textual description about the validation result
       */
      description: string;

      /**
       * A list of features explaining what is happening in the transaction in different
       * levels of severity
       */
      extended_features: Array<Validation.ExtendedFeature>;

      /**
       * A list of features about this transaction explaining the validation
       */
      features: Array<string>;

      /**
       * A textual description about the reasons the transaction was flagged with
       * result_type
       */
      reason: string;

      /**
       * Verdict of the validation
       */
      result_type: 'Benign' | 'Warning' | 'Malicious' | 'Error';
    }

    export namespace Validation {
      export interface ExtendedFeature {
        /**
         * Address the feature refers to
         */
        address: string | null;

        /**
         * Textual description
         */
        description: string;

        feature_id: string;

        /**
         * Feature Classification
         */
        type: 'Benign' | 'Warning' | 'Malicious' | 'Info';
      }
    }
  }
}

export interface MessageScanParams {
  account_address: string;

  metadata: MessageScanParams.Metadata;

  /**
   * Transactions to scan
   */
  transactions: Array<string>;

  chain?:
    | 'mainnet'
    | 'testnet'
    | 'devnet'
    | 'eclipse_mainnet'
    | 'eclipse_devnet'
    | 'sonic_mainnet'
    | '5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp'
    | 'EtWTRABZaYq6iMfeYKouRu166VU2xqa1'
    | 'EAQLJCV2mh23BsK2P9oYpV5CHVLDNHTxY';

  encoding?: 'base58' | 'base64';

  /**
   * The execution mode for the transaction(s). Use `jito_bundle` when the
   * transactions are intended to be submitted as a Jito bundle. In bundle mode,
   * simulation uses pre/post account state diffs instead of instruction-level
   * parsing, and validation allows the `account_address` to appear in any (not
   * necessarily all) of the bundle's transactions.
   */
  execution_mode?: 'standard' | 'jito_bundle';

  /**
   * The RPC method used by the dApp to propose the transaction
   */
  method?: string;

  /**
   * List of options to include in the response
   *
   * - `Options.validation`: Include Options.validation output in the response
   *
   * - `Options.simulation`: Include Options.simulation output in the response
   */
  options?: Array<'validation' | 'simulation'>;
}

export namespace MessageScanParams {
  export interface Metadata {
    /**
     * Account information associated with the request
     */
    account?: Metadata.Account;

    /**
     * Connection metadata including user agent and IP information
     */
    connection?: Metadata.Connection;

    /**
     * URL of the dApp that originated the transaction
     */
    url?: string | null;
  }

  export namespace Metadata {
    /**
     * Account information associated with the request
     */
    export interface Account {
      /**
       * Unique identifier for the account.
       */
      account_id: string;

      /**
       * Timestamp when the account was created.
       */
      account_creation_timestamp?: string;

      /**
       * Age of the user in years
       */
      user_age?: number;

      /**
       * ISO country code of the user's location.
       */
      user_country_code?: string;
    }

    /**
     * Connection metadata including user agent and IP information
     */
    export interface Connection {
      /**
       * IP address of the customer making the request.
       */
      ip_address: string;

      /**
       * User agent string from the client's browser or application.
       */
      user_agent?: string;
    }
  }
}

export declare namespace Message {
  export { type MessageScanResponse as MessageScanResponse, type MessageScanParams as MessageScanParams };
}