dequanto 0.1.7 → 0.1.13

package/lib/cjs/explorer/IBlockChainExplorer.d.ts

@@ -0,0 +1,82 @@
+import { IContractDetails } from '../models/IContractDetails';
+import { IAbiProvider } from './IAbiProvider';
+import { TEth } from '../models/TEth';
+import { TAddress } from '../models/TAddress';
+export interface IBlockChainExplorer extends IAbiProvider {
+    localDb: IContractDetails[];
+    getContractMeta(q: string): Promise<IContractDetails>;
+    getContractCreation(address: TEth.Address): Promise<{
+        creator: TEth.Address;
+        txHash: TEth.Hex;
+    }>;
+    getContractAbi(address: TEth.Address, opts?: {
+        implementation?: string;
+    }): Promise<{
+        abi: string;
+        implementation: TEth.Address;
+    }>;
+    getContractSource(address: TEth.Address): Promise<{
+        SourceCode: {
+            contractName: string;
+            files: {
+                [filename: string]: {
+                    content: string;
+                };
+            };
+        };
+        ContractName: string;
+        ABI: string;
+    }>;
+    submitContractVerification(contractData: {
+        address: TAddress;
+        sourceCode: string | any;
+        contractName: any;
+        compilerVersion: any;
+        optimizer?: {
+            enabled?: boolean;
+            runs: number;
+        };
+        arguments?: TEth.Hex;
+    }): Promise<string>;
+    checkContractVerificationSubmission(submission: {
+        guid: any;
+    }): Promise<string>;
+    submitContractProxyVerification(contractData: {
+        address: TAddress;
+        expectedImplementation?: TAddress;
+    }): Promise<string>;
+    checkContractProxyVerificationSubmission(submission: {
+        guid: any;
+    }): Promise<string>;
+    getTransactions(address: TEth.Address, params?: {
+        fromBlockNumber?: number;
+        page?: number;
+        size?: number;
+    }): Promise<TEth.TxLike[]>;
+    getTransactionsAll(address: TEth.Address): Promise<TEth.TxLike[]>;
+    getInternalTransactions(address: TEth.Address, params?: {
+        fromBlockNumber?: number;
+        page?: number;
+        size?: number;
+    }): Promise<TEth.TxLike[]>;
+    getInternalTransactionsAll(address: TEth.Address): Promise<TEth.TxLike[]>;
+    getErc20Transfers(address: TEth.Address, fromBlockNumber?: number): Promise<IBlockChainTransferEvent[]>;
+    getErc20TransfersAll(address: TEth.Address, fromBlockNumber?: number): Promise<IBlockChainTransferEvent[]>;
+    registerAbi(abis: {
+        name: any;
+        address: any;
+        abi: any;
+    }[]): any;
+}
+export interface IBlockChainTransferEvent {
+    blockNumber: number;
+    timeStamp: Date;
+    hash: string;
+    from: string;
+    contractAddress: string;
+    to: string;
+    value: bigint;
+    tokenName: string;
+    tokenSymbol: string;
+    tokenDecimal: number;
+}

package/lib/cjs/explorer/IBlockChainExplorer.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IBlockChainExplorer.js.map
+//# sourceMappingURL=IBlockChainExplorer.ts.map

package/lib/cjs/explorer/IBlockChainExplorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBlockChainExplorer.js","sourceRoot":"","sources":["../../../src/explorer/IBlockChainExplorer.ts"],"names":[],"mappings":""}

package/lib/cjs/explorer/Polyscan.d.ts

@@ -0,0 +1,4 @@
+declare const Polyscan_base: import("atma-utils/class").Constructor<import("./IBlockChainExplorer").IBlockChainExplorer>;
+export declare class Polyscan extends Polyscan_base {
+}
+export {};

package/lib/cjs/explorer/Polyscan.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Polyscan = void 0;
+const a_di_1 = __importDefault(require("a-di"));
+const BlockChainExplorerFactory_1 = require("./BlockChainExplorerFactory.js");
+const _config_1 = require("../utils/$config.js");
+const PolyWeb3Client_1 = require("../clients/PolyWeb3Client.js");
+const contracts = _config_1.$config.get('contracts.polygon', []);
+class Polyscan extends BlockChainExplorerFactory_1.BlockChainExplorerFactory.create({
+    ABI_CACHE: `./cache/poly/abis.json`,
+    CONTRACTS: contracts,
+    getWeb3() {
+        return a_di_1.default.resolve(PolyWeb3Client_1.PolyWeb3Client);
+    },
+    getConfig() {
+        const config = _config_1.$config.get('blockchainExplorer.polygon');
+        return {
+            key: config?.key,
+            host: config?.host,
+            www: config?.www,
+        };
+    }
+}) {
+}
+exports.Polyscan = Polyscan;
+//# sourceMappingURL=Polyscan.js.map
+//# sourceMappingURL=Polyscan.ts.map

package/lib/cjs/explorer/Polyscan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Polyscan.js","sourceRoot":"","sources":["../../../src/explorer/Polyscan.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAsB;AACtB,2EAAwE;AACxE,qDAAkD;AAClD,qEAAkE;AAElE,MAAM,SAAS,GAAG,iBAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;AAEvD,MAAa,QAAS,SAAQ,qDAAyB,CAAC,MAAM,CAAC;IAC3D,SAAS,EAAE,wBAAwB;IACnC,SAAS,EAAE,SAAS;IACpB,OAAO;QACH,OAAO,cAAE,CAAC,OAAO,CAAC,+BAAc,CAAC,CAAA;IACrC,CAAC;IACD,SAAS;QACL,MAAM,MAAM,GAAG,iBAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACzD,OAAO;YACH,GAAG,EAAE,MAAM,EAAE,GAAG;YAChB,IAAI,EAAE,MAAM,EAAE,IAAI;YAClB,GAAG,EAAE,MAAM,EAAE,GAAG;SACnB,CAAC;IACN,CAAC;CACJ,CAAC;CAED;AAhBD,4BAgBC"}

package/lib/cjs/explorer/verifiers/FsHtmlVerifier.d.ts

@@ -0,0 +1,55 @@
+import { TEth } from '../../models/TEth';
+import { IBlockChainExplorerConfig } from '../BlockChainExplorerFactory';
+import { IVerifier } from './IVerifier';
+import { IBlockChainTransferEvent } from '../IBlockChainExplorer';
+export declare class FsHtmlVerifier implements IVerifier {
+    platform: any;
+    config: IBlockChainExplorerConfig;
+    private key;
+    private enabled;
+    constructor(platform: any, config: IBlockChainExplorerConfig);
+    submitContractVerification(contractData: {
+        address: `0x${string}`;
+        sourceCode: any;
+        contractName: any;
+        compilerVersion: any;
+        optimizer?: {
+            enabled?: boolean;
+            runs: number;
+        };
+        arguments?: `0x${string}`;
+    }): Promise<string>;
+    private saveContractVerification;
+    checkContractVerificationSubmission(submission: {
+        guid: any;
+    }): Promise<string>;
+    submitContractProxyVerification(contractData: {
+        address: `0x${string}`;
+        expectedImplementation?: `0x${string}`;
+    }): Promise<string>;
+    private saveProxyVerification;
+    checkContractProxyVerificationSubmission(submission: {
+        guid: any;
+    }): Promise<string>;
+    getTransactions(address: `0x${string}`, params?: {
+        fromBlockNumber?: number;
+        page?: number;
+        size?: number;
+    }): Promise<TEth.DataLike<TEth.Tx>[]>;
+    getTransactionsAll(address: `0x${string}`): Promise<TEth.DataLike<TEth.Tx>[]>;
+    getInternalTransactions(address: `0x${string}`, params?: {
+        fromBlockNumber?: number;
+        page?: number;
+        size?: number;
+    }): Promise<TEth.DataLike<TEth.Tx>[]>;
+    getInternalTransactionsAll(address: `0x${string}`): Promise<TEth.DataLike<TEth.Tx>[]>;
+    getErc20Transfers(address: `0x${string}`, fromBlockNumber?: number): Promise<IBlockChainTransferEvent[]>;
+    getErc20TransfersAll(address: `0x${string}`, fromBlockNumber?: number): Promise<IBlockChainTransferEvent[]>;
+    registerAbi(abis: {
+        name: any;
+        address: any;
+        abi: any;
+    }[]): void;
+    private extractHostKey;
+    private extractContractName;
+}

package/lib/cjs/explorer/verifiers/FsHtmlVerifier.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FsHtmlVerifier = void 0;
+const atma_io_1 = require("atma-io");
+const _platform_1 = require("../../utils/$platform.js");
+const PATH_ROOT = `./data/0xc/verification`;
+const PATH_TEMPLATE = `${PATH_ROOT}/template.html`;
+const PATH_TEMPLATE_PROXY = `${PATH_ROOT}/template-proxy.html`;
+const TEMPLATE_DEFAULT = `
+<h1>__name__</h1>
+<form method="post" action="__host__">
+  <input type="hidden" name="apikey" value="__apikey__" />
+  <input type="hidden" name="module" value="contract" />
+  <input type="hidden" name="action" value="verifysourcecode" />
+  <input
+    type="hidden"
+    name="contractaddress"
+    value="__contractaddress__"
+  />
+  <input type="hidden" name="sourceCode" />
+  <input type="hidden" name="codeformat" value="solidity-standard-json-input" />
+  <input
+    type="hidden"
+    name="contractname"
+    value="__contractname__"
+  />
+  <input type="hidden" name="compilerversion" value="v0.8.20+commit.a1b79de6" />
+  <input type="hidden" name="optimizationUsed" value="1" />
+  <input type="hidden" name="runs" value="200" />
+  <input type="hidden" name="constructorArguements" value="__constructorArguements__" />
+  <input type="submit" value="Submit" />
+</form>
+<script>
+  var data = __JSON__;
+  document.querySelector('input[name="sourceCode"]').value = JSON.stringify(data);
+</script>
+`;
+const TEMPLATE_PROXY_DEFAULT = `
+    <h1>__name__</h1>
+    <form method="post" action="__host__">
+    <input type="hidden" name="apikey" value="__apikey__" />
+    <input type="hidden" name="module" value="contract" />
+    <input type="hidden" name="action" value="verifyproxycontract" />
+    <input
+        type="hidden"
+        name="address"
+        value="__contractaddress__"
+    />
+    <input
+        type="hidden"
+        name="expectedimplementation"
+        value="__expectedImplementation__"
+    />
+    <input type="submit" value="Submit" />
+    </form>
+
+`;
+class FsHtmlVerifier {
+    constructor(platform, config) {
+        this.platform = platform;
+        this.config = config;
+        this.enabled = Boolean(config.api);
+        this.key = _platform_1.$platform.toPath(platform ?? /** fallback */ 'eth');
+    }
+    async submitContractVerification(contractData) {
+        if (this.enabled) {
+            await this.saveContractVerification(contractData);
+        }
+        return null;
+    }
+    async saveContractVerification(contractData) {
+        let name = this.extractContractName(contractData);
+        let hostKey = this.extractHostKey(this.config);
+        let filename = `${PATH_ROOT}/${this.key}/${name}-${contractData.address}-${hostKey}.html`;
+        let filenameSources = filename.replace(/html$/, 'json');
+        let template = await atma_io_1.File.existsAsync(PATH_TEMPLATE)
+            ? await atma_io_1.File.readAsync(PATH_TEMPLATE)
+            : TEMPLATE_DEFAULT;
+        let html = template
+            .replace('__host__', this.config.api)
+            .replace('__name__', contractData.contractName)
+            .replace('__JSON__', contractData.sourceCode)
+            .replace('__contractaddress__', contractData.address)
+            .replace('__contractname__', contractData.contractName)
+            .replace('__apikey__', this.config.key ?? '')
+            .replace('__constructorArguements__', contractData.arguments?.replace(/^0x/, '') || '');
+        if (contractData.contractName.includes('Utils/Proxy')) {
+            // fix Proxy, rename contract duplicates
+            html = html.replaceAll('contracts/Utils/Proxy.sol:Proxy', 'contracts/Utils/TUProxy.sol:TUProxy');
+            html = html.replace('Utils/Proxy.sol":', 'Utils/TUProxy.sol":');
+            html = html.replace('contract Proxy is ', 'contract TUProxy is ');
+        }
+        await atma_io_1.File.writeAsync(filename, html);
+        await atma_io_1.File.writeAsync(filenameSources, contractData.sourceCode);
+        return null;
+    }
+    async checkContractVerificationSubmission(submission) {
+        return `verified`;
+    }
+    async submitContractProxyVerification(contractData) {
+        if (this.enabled) {
+            await this.saveProxyVerification(contractData);
+        }
+        return null;
+    }
+    async saveProxyVerification(contractData) {
+        let hostKey = this.extractHostKey(this.config);
+        let template = await await atma_io_1.File.existsAsync(PATH_TEMPLATE_PROXY)
+            ? await atma_io_1.File.readAsync(PATH_TEMPLATE_PROXY)
+            : TEMPLATE_PROXY_DEFAULT;
+        let name = this.extractContractName(contractData, 'proxy');
+        let filename = `${PATH_ROOT}/${this.key}/${name}-${contractData.address}-${hostKey}.html`;
+        let html = template
+            .replace('__host__', this.config.api)
+            .replace('__contractaddress__', contractData.address)
+            .replace('__apikey__', this.config.key ?? '')
+            .replace('__expectedImplementation__', contractData.expectedImplementation ?? '');
+        await atma_io_1.File.writeAsync(filename, html);
+        return "guid";
+    }
+    async checkContractProxyVerificationSubmission(submission) {
+        return `verified`;
+    }
+    getTransactions(address, params) {
+        throw new Error('Method not implemented.');
+    }
+    getTransactionsAll(address) {
+        throw new Error('Method not implemented.');
+    }
+    getInternalTransactions(address, params) {
+        throw new Error('Method not implemented.');
+    }
+    getInternalTransactionsAll(address) {
+        throw new Error('Method not implemented.');
+    }
+    getErc20Transfers(address, fromBlockNumber) {
+        throw new Error('Method not implemented.');
+    }
+    getErc20TransfersAll(address, fromBlockNumber) {
+        throw new Error('Method not implemented.');
+    }
+    registerAbi(abis) {
+        throw new Error('Method not implemented.');
+    }
+    extractHostKey(config) {
+        let hostKey = /\.(?<hostkey>[\w\-]+)\.\w+($|\/)/.exec(config.api ?? config.host).groups.hostkey;
+        return hostKey;
+    }
+    extractContractName(contractData, defaultPfx) {
+        if (contractData.contractName) {
+            let name = /:(\w+)$/.exec(contractData.contractName)[1];
+            if (name) {
+                return name;
+            }
+        }
+        let pfx = defaultPfx ? (`${defaultPfx}-`) : '';
+        return `${pfx}${contractData.address}`;
+    }
+}
+exports.FsHtmlVerifier = FsHtmlVerifier;
+//# sourceMappingURL=FsHtmlVerifier.js.map
+//# sourceMappingURL=FsHtmlVerifier.ts.map

package/lib/cjs/explorer/verifiers/FsHtmlVerifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FsHtmlVerifier.js","sourceRoot":"","sources":["../../../../src/explorer/verifiers/FsHtmlVerifier.ts"],"names":[],"mappings":"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"}

package/lib/cjs/explorer/verifiers/IVerifier.d.ts

@@ -0,0 +1,23 @@
+export interface IVerifier {
+    submitContractVerification(contractData: {
+        address: `0x${string}`;
+        sourceCode: any;
+        contractName: any;
+        compilerVersion: any;
+        optimizer?: {
+            enabled?: boolean;
+            runs: number;
+        };
+        arguments?: `0x${string}`;
+    }): Promise<string>;
+    checkContractVerificationSubmission(submission: {
+        guid: any;
+    }): Promise<string | 'verified'>;
+    submitContractProxyVerification(contractData: {
+        address: `0x${string}`;
+        expectedImplementation?: `0x${string}`;
+    }): Promise<string>;
+    checkContractProxyVerificationSubmission(submission: {
+        guid: any;
+    }): Promise<string | 'verified'>;
+}

package/lib/cjs/explorer/verifiers/IVerifier.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IVerifier.js.map
+//# sourceMappingURL=IVerifier.ts.map

package/lib/cjs/explorer/verifiers/IVerifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IVerifier.js","sourceRoot":"","sources":["../../../../src/explorer/verifiers/IVerifier.ts"],"names":[],"mappings":""}

package/lib/cjs/flashbots/FlashbotWeb3Client.d.ts

@@ -0,0 +1,10 @@
+import { Web3Client } from '../clients/Web3Client';
+import { TPlatform } from '../models/TPlatform';
+export declare class FlashbotWeb3Client extends Web3Client {
+    platform: TPlatform;
+    chainId: number;
+    chainToken: string;
+    TIMEOUT: number;
+    defaultGasLimit: number;
+    constructor(opts: any);
+}

package/lib/cjs/flashbots/FlashbotWeb3Client.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlashbotWeb3Client = void 0;
+const Web3Client_1 = require("../clients/Web3Client.js");
+// https://docs.flashbots.net/flashbots-auction/advanced/rpc-endpoint
+class FlashbotWeb3Client extends Web3Client_1.Web3Client {
+    constructor(opts) {
+        super(opts);
+        this.platform = 'hardhat';
+        this.chainId = this.options.chainId ?? 1337;
+        this.chainToken = 'ETH';
+        this.TIMEOUT = 5 * 60 * 1000;
+        this.defaultGasLimit = 2000000;
+        throw new Error('Not Implemented. Use generic Web3Clients and submit transactions via FlashbotsProvider ');
+    }
+}
+exports.FlashbotWeb3Client = FlashbotWeb3Client;
+//# sourceMappingURL=FlashbotWeb3Client.js.map
+//# sourceMappingURL=FlashbotWeb3Client.ts.map

package/lib/cjs/flashbots/FlashbotWeb3Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlashbotWeb3Client.js","sourceRoot":"","sources":["../../../src/flashbots/FlashbotWeb3Client.ts"],"names":[],"mappings":";;;AACA,sDAAmD;AAMnD,qEAAqE;AAErE,MAAa,kBAAmB,SAAQ,uBAAU;IAQ9C,YAAa,IAAI;QACb,KAAK,CAAC,IAAI,CAAC,CAAC;QAPhB,aAAQ,GAAc,SAAS,CAAA;QAC/B,YAAO,GAAW,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAA;QAC9C,eAAU,GAAG,KAAK,CAAC;QACnB,YAAO,GAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAChC,oBAAe,GAAG,OAAS,CAAA;QAKvB,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC/G,CAAC;CAEJ;AAdD,gDAcC"}

package/lib/cjs/flashbots/FlashbotsProvider.d.ts

@@ -0,0 +1,87 @@
+import { Web3Client } from '../clients/Web3Client';
+import { EoAccount } from '../models/TAccount';
+import { TEth } from '../models/TEth';
+import { RpcTypes } from '../rpc/Rpc';
+import { DeepPartial } from '../utils/types';
+import { IConfigData } from '../config/interface/IConfigData';
+/**
+ * Submits transaction to Flashbots network
+ *
+ * The signed raw transactions could be generated by Contract Classes with `$signed()` getter: e.g.:
+ *
+ * ```ts
+ * let foo = new ERC20();
+ * let tx = await foo.$signed().transfer(from, to);
+ * ```
+ */
+export declare class FlashbotsProvider {
+    account: EoAccount;
+    config: IConfigData['flashbots'][''];
+    private client;
+    private rpc;
+    protected constructor(account: EoAccount, config: IConfigData['flashbots'][''], client: Web3Client);
+    sendMevBundle(bundle: DeepPartial<RpcTypes.FlashbotsMevBundleRequest>): Promise<{
+        bundleHash: TEth.Hex;
+        uuid: string;
+        block: `0x${string}`;
+    }>;
+    simMevBundle(bundle: DeepPartial<RpcTypes.FlashbotsMevBundleRequest>): Promise<{
+        success: boolean;
+        stateBlock: string;
+        mevGasPrice: string;
+        profit: string;
+        refundableValue: string;
+        gasUsed: string;
+        logs: {
+            [key: string]: any;
+        }[];
+        uuid: string;
+        block: `0x${string}`;
+    }>;
+    sendBundle(bundle: DeepPartial<RpcTypes.FlashbotsBundleRequest>): Promise<{
+        bundleHash: TEth.Hex;
+        bundleGasPrice: bigint;
+        coinbaseDiff: bigint;
+        ethSentToCoinbase: bigint;
+        gasFees: bigint;
+        stateBlockNumber: number;
+        totalGasUsed: number;
+        results: any[];
+        uuid: string;
+        block: `0x${string}`;
+    }>;
+    callBundle(bundle: DeepPartial<RpcTypes.FlashbotsBundleRequest>): Promise<{
+        bundleHash: TEth.Hex;
+        bundleGasPrice: bigint;
+        coinbaseDiff: bigint;
+        ethSentToCoinbase: bigint;
+        gasFees: bigint;
+        stateBlockNumber: number;
+        totalGasUsed: number;
+        results: any[];
+        uuid: string;
+        block: `0x${string}`;
+    }>;
+    sendPrivateTransaction(bundle: DeepPartial<RpcTypes.FlashbotsSingleBundleReq>): Promise<string>;
+    getBundleStats(bundle: {
+        bundleHash: TEth.Hex;
+        blockNumber: number | TEth.Hex;
+    }): Promise<{
+        isHighPriority: boolean;
+        isSimulated: boolean;
+        simulatedAt: string;
+        receivedAt: string;
+        consideredByBuildersAt: {
+            pubkey: string;
+            timestamp: string;
+        }[];
+        sealedByBuildersAt: {
+            pubkey: string;
+            timestamp: string;
+        }[];
+    }>;
+    cancelBundle(uuid: string): Promise<string>;
+    private prepareMevBundle;
+    private prepareBundle;
+    static create(client: Web3Client, account: EoAccount): Promise<FlashbotsProvider>;
+}

package/lib/cjs/flashbots/FlashbotsProvider.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlashbotsProvider = void 0;
+const Config_1 = require("../config/Config.js");
+const Rpc_1 = require("../rpc/Rpc.js");
+const _contract_1 = require("../utils/$contract.js");
+const _hex_1 = require("../utils/$hex.js");
+const _require_1 = require("../utils/$require.js");
+const _sig_1 = require("../utils/$sig.js");
+const _buffer_1 = require("../utils/$buffer.js");
+const _crypto_1 = require("../utils/$crypto.js");
+/**
+ * Submits transaction to Flashbots network
+ *
+ * The signed raw transactions could be generated by Contract Classes with `$signed()` getter: e.g.:
+ *
+ * ```ts
+ * let foo = new ERC20();
+ * let tx = await foo.$signed().transfer(from, to);
+ * ```
+ */
+class FlashbotsProvider {
+    constructor(account, config, client) {
+        this.account = account;
+        this.config = config;
+        this.client = client;
+        this.rpc = new Rpc_1.Rpc({
+            url: this.config.url,
+            headers: {
+                'X-Flashbots-Signature': async (req) => {
+                    let body = req.body;
+                    let str = _buffer_1.$buffer.fromString(_contract_1.$contract.keccak256(body), 'utf8');
+                    let sig = await _sig_1.$sig.signMessage(str, account);
+                    let header = `${account.address}:${sig.signature}`;
+                    return header;
+                }
+            }
+        });
+    }
+    async sendMevBundle(bundle) {
+        bundle = await this.prepareMevBundle(bundle);
+        let result = await this.rpc.mev_sendBundle(bundle);
+        return {
+            uuid: bundle.metadata.originId,
+            block: bundle.inclusion.block,
+            ...result
+        };
+    }
+    async simMevBundle(bundle) {
+        bundle = await this.prepareMevBundle(bundle);
+        let result = await this.rpc.mev_simBundle(bundle);
+        return {
+            uuid: bundle.metadata.originId,
+            block: bundle.inclusion.block,
+            ...result
+        };
+    }
+    async sendBundle(bundle) {
+        bundle = await this.prepareBundle(bundle);
+        let result = await this.rpc.eth_sendBundle(bundle);
+        return {
+            uuid: bundle.replacementUuid,
+            block: bundle.blockNumber,
+            ...result
+        };
+    }
+    async callBundle(bundle) {
+        bundle = await this.prepareBundle(bundle);
+        let result = await this.rpc.eth_callBundle(bundle);
+        return {
+            uuid: bundle.replacementUuid,
+            block: bundle.blockNumber,
+            ...result
+        };
+    }
+    async sendPrivateTransaction(bundle) {
+        _require_1.$require.Hex(bundle.tx, 'Expects signed raw transaction');
+        let result = await this.rpc.eth_sendPrivateTransaction(bundle);
+        return result;
+    }
+    async getBundleStats(bundle) {
+        _require_1.$require.Hex(bundle.bundleHash, `Expects returned value by the flashbots api when calling eth_sendBundle`);
+        _require_1.$require.notNull(bundle.blockNumber, `Expects the block number the bundle was targeting`);
+        let blockNumberHex = _hex_1.$hex.ensure(bundle.blockNumber);
+        let result = await this.rpc.flashbots_getBundleStatsV2({
+            bundleHash: bundle.bundleHash,
+            blockNumber: blockNumberHex
+        });
+        return result;
+    }
+    async cancelBundle(uuid) {
+        let result = await this.rpc.eth_cancelBundle({
+            replacementUuid: uuid
+        });
+        return result;
+    }
+    async prepareMevBundle(bundle) {
+        _require_1.$require.gt(bundle.body?.length, 0, 'Bundle should contain at least one transaction');
+        if (bundle.version == null) {
+            bundle.version = 'v0.1';
+        }
+        if (bundle.inclusion == null) {
+            bundle.inclusion = {};
+        }
+        if (bundle.inclusion.block == null) {
+            bundle.inclusion.block = _hex_1.$hex.ensure(await this.client.getBlockNumber() + 1);
+        }
+        if (bundle.inclusion.maxBlock != null) {
+            bundle.inclusion.maxBlock = _hex_1.$hex.ensure(bundle.inclusion.maxBlock);
+        }
+        if (bundle.metadata == null) {
+            bundle.metadata = {};
+        }
+        if (bundle.metadata.originId == null) {
+            bundle.metadata.originId = _crypto_1.$crypto.randomUUID();
+        }
+        return bundle;
+    }
+    async prepareBundle(bundle) {
+        _require_1.$require.gt(bundle.txs?.length, 0, 'Bundle should contain at least one transaction');
+        if (bundle.blockNumber == null) {
+            bundle.blockNumber = _hex_1.$hex.ensure(await this.client.getBlockNumber() + 1);
+        }
+        if (bundle.replacementUuid == null) {
+            bundle.replacementUuid = _crypto_1.$crypto.randomUUID();
+        }
+        return bundle;
+    }
+    static async create(client, account) {
+        let platform = client.platform;
+        let cfg = await Config_1.Config.get();
+        let flashbotsCfg = _require_1.$require.notNull(cfg.flashbots?.[platform], `Flashbots configuration not found for platform ${platform}`);
+        _require_1.$require.notEmpty(flashbotsCfg.url, `Flashbots URL not set for platform ${platform}`);
+        return new FlashbotsProvider(account, flashbotsCfg, client);
+    }
+}
+exports.FlashbotsProvider = FlashbotsProvider;
+//# sourceMappingURL=FlashbotsProvider.js.map
+//# sourceMappingURL=FlashbotsProvider.ts.map

package/lib/cjs/flashbots/FlashbotsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlashbotsProvider.js","sourceRoot":"","sources":["../../../src/flashbots/FlashbotsProvider.ts"],"names":[],"mappings":"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"}