import { APIResource } from "../../core/resource.js";
import * as BitcoinAPI from "./bitcoin.js";
import { APIPromise } from "../../core/api-promise.js";
import { RequestOptions } from "../../internal/request-options.js";
export declare class TransactionRaw extends APIResource {
    /**
     * Submit an appeal or false-positive report for a Bitcoin transaction scan. Use
     * when you believe a scan result was incorrect (e.g. should_be_benign,
     * should_be_malicious, wrong_simulation_result).
     */
    report(body: TransactionRawReportParams, options?: RequestOptions): APIPromise<TransactionRawReportResponse>;
    /**
     * Scan a raw Bitcoin transaction for security risks before signing. Returns a
     * validation verdict (Benign, Warning, or Malicious) and, when requested, a
     * simulation of asset changes.
     */
    scan(body: TransactionRawScanParams, options?: RequestOptions): APIPromise<BitcoinAPI.BitcoinTransactionScanResponse>;
}
export type TransactionRawReportResponse = number;
export interface TransactionRawReportParams {
    /**
     * Free-text explanation or context for the report.
     */
    details: string;
    /**
     * Type of appeal: what you believe was wrong with the scan result.
     */
    event: 'should_be_malicious' | 'should_be_benign' | 'wrong_simulation_result';
    /**
     * Either a prior scan request ID or the full transaction parameters being
     * reported.
     */
    report: TransactionRawReportParams.BitcoinAppealRequestID | TransactionRawReportParams.BitcoinAppealTransactionDataReport;
}
export declare namespace TransactionRawReportParams {
    interface BitcoinAppealRequestID {
        /**
         * Request ID from a previous transaction scan response.
         */
        id: string;
        /**
         * Discriminator; use "request_id" when referencing a prior scan.
         */
        type?: 'request_id';
    }
    interface BitcoinAppealTransactionDataReport {
        /**
         * Full transaction scan request (same shape as the scan endpoint).
         */
        params: BitcoinAPI.BitcoinTransactionScanRequest;
        /**
         * Discriminator; use "params" when supplying full transaction data.
         */
        type?: 'params';
    }
}
export interface TransactionRawScanParams {
    /**
     * The Bitcoin address that owns the UTXOs being spent.
     */
    account_address: string;
    chain: 'bitcoin';
    /**
     * Context of where the transaction was initiated: use wallet metadata when the
     * user is signing in a wallet for an external site; use in-app metadata when the
     * transaction is created within your own app.
     *
     * Choosing the correct type improves risk analysis and reporting.
     */
    metadata: TransactionRawScanParams.BitcoinWalletRequestMetadata | TransactionRawScanParams.BitcoinInAppRequestMetadata;
    /**
     * The raw unsigned transaction in hexadecimal, as produced by the wallet or your
     * app. This is the same payload the user would sign.
     */
    transaction: string;
    /**
     * Which parts of the response you need:
     *
     * - **validation** — Security verdict (Benign/Warning/Malicious) and risk
     *   explanation. Use when deciding whether to block or warn.
     * - **simulation** — Predicted summary of balance and asset changes (e.g. "You
     *   will send 0.01 BTC to bc1q..."). Use when showing the user what the
     *   transaction does.
     *
     * You can request one or both; default is both.
     */
    options?: Array<'validation' | 'simulation'>;
}
export declare namespace TransactionRawScanParams {
    interface BitcoinWalletRequestMetadata {
        /**
         * Identifies the request as a wallet signing a transaction on behalf of an
         * external dApp. The type improves threat context and helps attribute risk to
         * specific origins.
         */
        type: 'wallet';
        /**
         * The full URL of the dApp or page where the user initiated the transaction (e.g.
         * https://app.example.com/swap).
         */
        url: string;
        /**
         * Account information associated with the request
         */
        account?: BitcoinWalletRequestMetadata.Account;
        /**
         * Connection metadata including user agent and IP information
         */
        connection?: BitcoinWalletRequestMetadata.Connection;
    }
    namespace BitcoinWalletRequestMetadata {
        /**
         * Account information associated with the request
         */
        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
         */
        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;
        }
    }
    interface BitcoinInAppRequestMetadata {
        /**
         * Account information associated with the request
         */
        account?: BitcoinInAppRequestMetadata.Account;
        /**
         * Connection metadata including user agent and IP information
         */
        connection?: BitcoinInAppRequestMetadata.Connection;
        /**
         * Identifies the request as coming from your own app (e.g. in-app send, swap, or
         * internal flow).
         */
        type?: 'in_app';
    }
    namespace BitcoinInAppRequestMetadata {
        /**
         * Account information associated with the request
         */
        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
         */
        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 TransactionRaw {
    export { type TransactionRawReportResponse as TransactionRawReportResponse, type TransactionRawReportParams as TransactionRawReportParams, type TransactionRawScanParams as TransactionRawScanParams, };
}
//# sourceMappingURL=transaction-raw.d.ts.map