1 of 25

Invisium

Invisium: INTRODUCTION

Introduction: Unleashing the Power of Web3 Infrastructure

Introduction: Revolutionizing Web3 with Invisium

Welcome to a realm where innovation knows no bounds, where blockchain technology reigns supreme, and where the promise of Web3 beckons us towards a new era of digital possibilities.

Where data is secured not by a centralized authority but by a global network of nodes, where transactions are executed with unparalleled transparency, and where smart contracts govern interactions with unbreakable precision.

The Invisium, a visionary in the Web3 infrastructure space, invites you to embark on a journey that transcends the ordinary and embraces the extraordinary. With the precision of a blockchain and the finesse of a finely-tuned orchestra, we introduce you to a world where innovation knows no bounds and where decentralized applications (dApps) flourish.

What is "Bundle Simulation" and "State Overriding"?

Unlock the full potential of blockchain technology. Whether you are a seasoned blockchain enthusiast or a newcomer eager to explore the decentralized frontier, Invisium is your trusted companion on this epic adventure.

At the core of APIs: "Bundle Simulation" and "State Overriding." These innovative features redefine the possibilities of Web3 infrastructure and grant you unprecedented leverage.

Bundle Simulation: Imagine the ability to simulate not just individual transactions but entire bundles of transactions. With "Bundle Simulation," you gain the power to orchestrate complex interactions on the blockchain, optimizing your strategies and ensuring the utmost efficiency.
State Overriding: In the world of blockchain, control over the state is paramount. "State Overriding" puts you in the driver's seat, allowing you to manipulate the blockchain's state to suit your needs. It's a game-changer for developers, enabling advanced testing, debugging, and experimentation.

These features are not just tools; they are catalysts for innovation. As you delve into the depths of this documentation, you will uncover a treasure trove of insights, resources, and tools that empower you to harness the true power of Web3 infrastructure.

A Symphony of Innovation

Our Dashboard UI orchestrates seamless interactions, while our Custom Geth RPC service conducts the blockchain with precision and flexibility. Pricing plans tailored to your needs ensure affordability, and an FAQ section stands ready to answer your queries.

But that's not all. Our roadmap reveals a future brimming with promise, where upcoming releases promise to push the boundaries of what is possible in the Web3 universe. This is not merely a documentation; it's a gateway to a world of limitless opportunities.

Join the Decentralized Revolution

Welcome to Invisium — where the future of Web3 begins, powered by the revolutionary capabilities of "Bundle Simulation" and "State Overriding."

Invisium: TECHNICAL DOCUMENTATION

Invisium: Integration Flow

Beautiful documentation starts with the content you create — and GitBook makes it easy to get started with any pre-existing content.

Import

GitBook supports importing content from many popular writing tools and formats. If your content already exists, you can upload a file or group of files to be imported.

Sync a repository

GitBook also allows you to set up a bi-directional sync with an existing repository on GitHub or GitLab. Setting up Git Sync allows you and your team to write content in GitBook or in code, and never have to worry about your content becoming out of sync.

Who can integrate?

Once you’ve finished writing, editing, or importing your content, you can publish your work to the web as a docs site. Once published, your site will be accessible online only to your selected audience.

You can publish your site and find related settings from your docs site's homepage.

The List of Features

Trading API

Uniswap V2 Reserves Extraction

Extract Uniswap V2 Reserves supplying a list of pools. ro and r1 represent balanceOf of tokens t0 and t1 correspondingly.

Up to 100,000 pools per request can be extracted. The reserves state is always bound to latest Ethereum block (always fresh).

Request Example:

curl --location 'https://api.invisium.com/extract-v2-pools' \
--header 'Content-Type: application/json' \
--data '[
    "0xA76A9bAa3cC9DAcd86852bea6C4aE8C63E70C4A4",
    "0x3885fbe4CD8aeD7b7e9625923927Fa1CE30662A3",
    "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852"
]'

Response Example:

[
    {
        "pool_addr": "0xa76a9baa3cc9dacd86852bea6c4ae8c63e70c4a4",
        "r0": "54074576583112057058",
        "r1": "1633180149092520560561",
        "t0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "t1": "0xd555498a524612c67f286df0e0a9a64a73a7cdc7"
    },
    {
        "pool_addr": "0x3885fbe4cd8aed7b7e9625923927fa1ce30662a3",
        "r0": "357764429975839288350",
        "r1": "10667207088607431",
        "t0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "t1": "0xee2a03aa6dacf51c18679c516ad5283d8e7c2637"
    },
    {
        "pool_addr": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852",
        "r0": "26934266390055623275757",
        "r1": "62180123406483",
        "t0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "t1": "0xdac17f958d2ee523a2206206994597c13d831ec7"
    }
]

Curve Finance: Amount Out After Trade

Supply (StableSwap, StableSwapNG, Pool, TriPool supported) pool address, input & output tokens and amountIn and get real amountOut.

Request Example:

Response Output:

Uniswap V3: Amount Out After Trade

Supply Uniswap V3 (Solidly or Pancake V3 supported too) pool address, input & output tokens and amountIn and get real amountOut.

Request Example:

curl --location 'https://api.invisium.com/get-amount-out-v3' \
--header 'Content-Type: application/json' \
--data '{
    "poolAddress": "0x109830a1aaad605bbf02a9dfa7b0b92ec2fb7daa",
    "tokenIn": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "tokenOut": "0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
    "amountIn": 1000000000000000000
}'

Response Example:

{
    "amountOut": "848478764525971171"
}

Complex Path Trade Simulation

Simulate Complex Path (Ethereum only ATM). Performs trade using real swap method inside the liquidity pool, sets real balanceOf of the startAsset for the trade.

The Request limit is 100,000,000 gas units per request. Supported Exchanges: uniswapV2, uniswapV3, curvePool.

Request Example:

curl --location 'https://api.invisium.com/compute-complex-path' \
--header 'Content-Type: application/json' \
--data '{
    "startAsset": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "startAmount": 1000000000000000000,
    "steps": [
        {
            "uniswapV3": {
                "pool": "88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
                "token_in": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "token_out": "A0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
            }
        },
        {
            "uniswapV2": {
                "pool": "b4e16d0168e52d35cacd2c6185b44281ec28c9dc",
                "token_in": "A0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
                "token_out": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
            }
        }
    ]
}'

Response Example:

{
    "amountOut": "997913322637794544",
    "amountOutHops": [
        "2311389439",
        "997913322637794544"
    ],
    "totalGasUsed": "182971"
}

Custom Node RPC

In the grand theater of Web3, where the curtains never fall and innovation takes center stage, we present to you the maestro of the blockchain symphony—the CGP. Step beyond the ordinary into a world where blockchain isn't just technology; it's an art form, and you are the virtuoso.

Crafting the Web3 Experience

Web3 isn't just a buzzword; it's a movement—an evolution that transcends the digital realm. At CGP, we recognize that true Web3 mastery demands more than passive participation; it demands the tools to compose, orchestrate, and innovate.

Simulation as Your Canvas

Enter the realm of the extraordinary — "Custom Geth RPC." Here, simulation isn't just a feature; it's your canvas for blockchain artistry. Imagine the power to not only simulate single transactions but entire symphonies of blockchain interactions. It's here that you fine-tune your strategies, test your innovations, and ensure that your blockchain endeavors are nothing short of masterpieces.

Mastering the Blockchain's State

But we offer you more than just a canvas; we offer you the palette of "State Overriding." In the blockchain's tapestry, state control is the artist's signature. With "State Overriding," you become the master, manipulating the blockchain's state to craft your vision. It's a revelation for developers, enabling advanced testing, debugging, and experimentation.

Seamless Integration, Infinite Innovation

Yet, it's not just about control; it's about seamless integration. Our Custom Geth RPC effortlessly blends with your applications, tools, and services, igniting a synergy that fosters limitless innovation. Whether you're crafting MEV (Miner Extractable Value) marvels, pioneering blockchain analytics, or venturing into uncharted territories, the Custom Geth RPC is your compass on this epic journey.

Cracking the Web3 Code

As you navigate this documentation, you'll unravel a treasure trove of wisdom, technical wizardry, and real-world insights. Each page is a revelation—a guide to decoding the enigma of Web3's inner workings. Here, you won't just find answers to 'how'; you'll uncover the 'why' and 'what if' that propel you beyond the frontiers of blockchain artistry.

Compose Your Blockchain Overture

Prepare to take the stage as the composer, conductor, and audience of your blockchain overture. The CGP Custom Geth RPC is your instrument, and the blockchain is your grand theater. Together, you'll craft harmonies that echo across the digital realm—a symphony of innovation, creativity, and boundless possibilities.

Welcome to the future of Web3, where the blockchain is your canvas, and the Custom Geth RPC is your baton. Let the symphony of blockchain brilliance commence.

Feel free to customize and fine-tune this introduction to resonate with your project's unique identity and branding, infusing it with the spirit of creativity and innovation that defines your Custom Geth RPC service.

State Override

State Override: Crafting Blockchain Realities

The code snippet from Go-Ethereum:

// OverrideAccount indicates the overriding fields of account during the execution
// of a message call.
// Note, state and stateDiff can't be specified at the same time. If state is
// set, message execution will only use the data in the given state. Otherwise
// if statDiff is set, all diff will be applied first and then execute the call
// message.
type OverrideAccount struct {
	Nonce     *hexutil.Uint64              `json:"nonce"`
	Code      *hexutil.Bytes               `json:"code"`
	Balance   **hexutil.Big                `json:"balance"`
	State     *map[common.Hash]common.Hash `json:"state"`
	StateDiff *map[common.Hash]common.Hash `json:"stateDiff"`
}

// StateOverride is the collection of overridden accounts.
type StateOverride map[common.Address]OverrideAccount

In the vast landscape of blockchain, the "State Override" feature is your artistic brushstroke, allowing you to paint the canvas of the Ethereum network with your own vision. It empowers you to transcend the boundaries of conventional transactions, ushering in a realm of endless possibilities.

Overriding Account Elements

At the heart of this functionality lies the "OverrideAccount" structure—a palette of possibilities. With its elements, you have the power to redefine the very essence of accounts during message execution:

Nonce: Mold the transaction sequence to your liking by setting a custom nonce. Take control of the account's transaction history, shaping its narrative.
Code: Inject your own bytecode into the account, transforming it into a smart contract of your design. This is where innovation takes root.
Balance: Shape the financial landscape by assigning the desired balance to the account. Bring abundance or scarcity as you see fit.
State: Immerse yourself in the world of Ethereum's state trie. By providing a custom state map, you can redefine the account's storage, crafting a unique reality within the blockchain.
StateDiff: Opt for granular control by specifying state differences. Modify specific storage slots to reflect your desired changes, sculpting the blockchain to your vision.

Masterpiece in the Making

Assemble these elements into the "StateOverride" collection, where each overridden account becomes a character in your blockchain narrative. This collection serves as your canvas, and you are the artist.

Endless Possibilities

With "State Override," you're not just executing transactions; you're forging a new path. It's where creativity meets code, and innovation blooms. Whether you're simulating complex scenarios, testing the resilience of smart contracts, or simply exploring the boundaries of Ethereum's state, the "State Override" feature invites you to craft your own blockchain reality.

Unlock Your Imagination

Elevate your blockchain endeavors with "State Override." Imprint your creativity on the Ethereum network, and let your imagination run wild. This is where blockchain becomes your canvas, and you are the brushstroke that brings it to life.

Dive into the world of "State Override," and let your ideas reshape the blockchain's destiny. The possibilities are as boundless as your imagination.

Simulations

Block Estimation State

The BlockEstimationState type is used to represent different block numbers or block states when interacting with the Ethereum/EVM blockchain.

Here's an explanation of each of the predefined constants:

"safe": this constant represents a block number that is considered safe or finalized. It typically indicates a block that has undergone multiple confirmations and is unlikely to be reorganized or changed in the blockchain's history.
"finalized": this constant represents a block number that is considered finalized. It signifies a block that has passed a certain level of consensus and security checks.
"latest": This constant represents the latest or most recent block in the Ethereum blockchain. When used as a parameter, it refers to the current block at the time of the request.
"pending": This constant represents a special state where the block number is not specified. When used, it typically indicates that the request should be executed in the context of the pending block or the next block to be mined.
"earliest": This constant represents the earliest block in the Ethereum blockchain. When used as a parameter, it refers to the very first block (genesis block) in the blockchain's history.

These constants provide a convenient way to specify the block number or state when making requests to the Ethereum blockchain. For example, when querying for the balance of an Ethereum address at the "latest", you would get the current balance. When using "safe" or "finalized" you would query for a block that is considered secure and unlikely to change in the future.

By using these constants, Ethereum developers can interact with the blockchain at different points in its history, depending on their specific needs and use cases.

Simulate Transaction - cgp_simulateTransaction

Prepare to embark on an expedition into the heart of blockchain transactions with the cgp_simulateTransaction method—an extraordinary tool that empowers you to decode the cryptic language of the blockchain.

Method Payload Signature:

[
      // Either raw tx or unsigned TransactionArgs message
      {
            "from":"0x9718eCd4E97f4332F9652D0Ba224f228B55ec543",
            "to":"0x3a220f351252089d385b29beca14e27f204c296a",
            "gas":"0x393870",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "value":null,
            "nonce":null,
            "data":"0xa9059cbb0000000000000000000000005b9ca044794b2752a12c67d280c70ef595ce57fe00000000000000000000000000000000000000000000000000000000000f4240",
            "input":null
      },
      // Block Estimation State
      "pending",
      // Geth Tracer
      {
            "tracer": "callTracer"
      }
]

Request Example:

curl --location 'https://dev1.cgp.xyz/rpc/mainnet/eth-reth' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "cgp_simulateTransaction",
    "params": [
        {
            "accessList": [],
            "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
            "gasLimit": "0x092a1b00000000",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "to": null,
            "value": "0x0",
            "data": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000"
        },
        "pending",
        null,
        {
            "0x3718ecd4e97f4332f9652d0ba224f228b55ec543": {
                "balance": "0x5af3107a400fff0",
                "state": {
                    "0x0000000000000000000000000000000000000000000000000000000000000001": "0x0000000000000000000000000000000000000000000000000000000000000002"
                }
            }
        },
        {
            "tracer": "callTracer"
        }
    ],
    "id": 0
}'

Response Example:

{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        "totalGasUsed": 600603,
        "traceDebugInfo": [
            {
                "from": "0x0000000000000000000000000000000000000000",
                "gas": "0x0",
                "gasUsed": "0x0",
                "input": "0x",
                "type": "STOP"
            }
        ],
        "trieHashAfter": "0x",
        "trieHashBefore": "0x",
        "txLogs": {},
        "txReceipts": [
            {
                "blockHash": "0x025b4e54163d833fc4bc83ae06cf4d70d383c37314866e0fbc864f647dd97d41",
                "blockNumber": "0x824c34",
                "cumulativeGasUsed": "0x92a1b",
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "gasUsed": "0x92a1b",
                "isSuccessful": true,
                "logs": [
                    {
                        "address": "0xa98b3745d77d886185eed558f3b23145e077cd9c",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                        "blockNumber": "0x824c35",
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": "0xa6c88ec2bffd62a4ef13eeb4c2233a616df921a93adcf9be03d036bfb887202c",
                        "logIndex": "0x0",
                        "removed": false
                    },
                    {
                        "address": "0xa98b3745d77d886185eed558f3b23145e077cd9c",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                        "blockNumber": "0x824c35",
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": "0xa6c88ec2bffd62a4ef13eeb4c2233a616df921a93adcf9be03d036bfb887202c",
                        "logIndex": "0x1",
                        "removed": false
                    },
                    {
                        "address": "0xa98b3745d77d886185eed558f3b23145e077cd9c",
                        "topics": [
                            "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                        "blockNumber": "0x824c35",
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": "0xa6c88ec2bffd62a4ef13eeb4c2233a616df921a93adcf9be03d036bfb887202c",
                        "logIndex": "0x2",
                        "removed": false
                    }
                ],
                "logsBloom": "0x00000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000010000000000020000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000800000000000020000080000000000000000000000000000000000001000000000000000000000000000010000000000000000000000",
                "status": "0x1",
                "to": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": 0,
                "txLogs": {
                    "0": {
                        "contractAddress": "0xa98B3745d77d886185EED558F3B23145e077Cd9c",
                        "data": "000000000000000000000000000000000000000000000000000000136e720741",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
                    },
                    "1": {
                        "contractAddress": "0xa98B3745d77d886185EED558F3B23145e077Cd9c",
                        "data": "0000000000000000000000000000000000000000000000000000000000008825",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
                    },
                    "2": {
                        "contractAddress": "0xa98B3745d77d886185EED558F3B23145e077Cd9c",
                        "data": "0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                        "topics": [
                            "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                        ],
                        "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
                    }
                },
                "type": "0xff"
            }
        ]
    }
}

Simulate Single Transaction With Override

The method cgp_simulateTransaction allows simulating the single transaction/tx message against the overriden blockchain state, thanks to Go-Ethereum struct StateAccount.

OverrideAccount definition

The code snippet from Go-Ethereum:

// OverrideAccount indicates the overriding fields of account during the execution
// of a message call.
// Note, state and stateDiff can't be specified at the same time. If state is
// set, message execution will only use the data in the given state. Otherwise
// if statDiff is set, all diff will be applied first and then execute the call
// message.
type OverrideAccount struct {
	Nonce     *hexutil.Uint64              `json:"nonce"`
	Code      *hexutil.Bytes               `json:"code"`
	Balance   **hexutil.Big                `json:"balance"`
	State     *map[common.Hash]common.Hash `json:"state"`
	StateDiff *map[common.Hash]common.Hash `json:"stateDiff"`
}

// StateOverride is the collection of overridden accounts.
type StateOverride map[common.Address]OverrideAccount

OverrideAccount is a struct in Go-Ethereum for overriding account fields during message call execution:

Nonce: It allows you to specify a custom nonce for the account.
Code: You can provide custom bytecode for the account's code.
Balance: This field lets you specify a custom balance for the account.
State: You can set a custom state for the account using this field.
StateDiff: If you prefer, you can apply a state differential (changes to the account state) instead.

StateOverride is a map where you can specify multiple accounts to override with OverrideAccount configurations.

BlockOverrides definition

The code snippet from Go-Ethereum:

// BlockOverrides is a set of header fields to override.
type BlockOverrides struct {
	Number     *hexutil.Big
	Difficulty *hexutil.Big
	Time       *hexutil.Uint64
	GasLimit   *hexutil.Uint64
	Coinbase   *common.Address
	Random     *common.Hash
	BaseFee    *hexutil.Big
}

Number: It represents the block number to override.
Difficulty: It allows you to specify a custom block difficulty.
Time: You can set a custom timestamp for the block using this field.
GasLimit: It lets you specify a custom gas limit for the block.
Coinbase: You can set a custom address as the coinbase (beneficiary) of the block.
Random: This field allows you to set a custom random value for the block.
BaseFee: It lets you specify a custom base fee for the block.

Method Payload Signature:

[
      // Either raw tx or unsigned TransactionArgs message
      {
            "from":"0x9718eCd4E97f4332F9652D0Ba224f228B55ec543",
            "to":"0x3a220f351252089d385b29beca14e27f204c296a",
            "gas":"0x393870",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "value":null,
            "nonce":null,
            "data":"0xa9059cbb0000000000000000000000005b9ca044794b2752a12c67d280c70ef595ce57fe00000000000000000000000000000000000000000000000000000000000f4240",
            "input":null
      },
      // Block Estimation State
      "pending",
      // state overriding
      {
            "0x9718eCd4E97f4332F9652D0Ba224f228B55ec543": {
                  "balance": "0x3242123",
                  "code": "0x....f1",
                  "state": {
                        // hash to hash
                        // storage slots layout mapping
                        "0x000..1": "0xfff..ff"
                  }
            }
      },
      // block headers overriding (may be null)
      {
            // block.number
            "number": "0x1173FF5",
            // block.timestamp
            "time": "0x1173ff5"
      },
      // Geth Tracer
      {
            "tracer": "callTracer"
      }
]

Request Example:

curl --location 'https://dev1.cgp.xyz/rpc/mainnet/eth-reth' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "cgp_simulateTransaction",
    "params": [
        {
            "accessList": [],
            "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
            "gasLimit": "0x092a1b00000000",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "to": null,
            "value": "0x0",
            "data": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000"
        },
        "pending",
        null,
        {
            "0x3718ecd4e97f4332f9652d0ba224f228b55ec543": {
                "balance": "0x5af3107a400fff0",
                "state": {
                    "0x0000000000000000000000000000000000000000000000000000000000000001": "0x0000000000000000000000000000000000000000000000000000000000000002"
                }
            }
        },
        {
            "tracer": "callTracer"
        }
    ],
    "id": 0
}'

Response Example:

{
    "jsonrpc": "2.0",
    "result": {
        "traceDebugInfo": [
            {
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "gas": "0x2faf080",
                "gasUsed": "0x92b1b",
                "to": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "input": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                "output": "0x608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c63430008110033",
                "value": "0x0",
                "type": "CREATE"
            }
        ],
        "totalGasUsed": 600859,
        "trieHashAfter": "",
        "trieHashBefore": "",
        "txLogs": [
            {
                "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "topics": [
                    "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                    "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                ],
                "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                "blockHash": null,
                "blockNumber": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "logIndex": "0x0",
                "removed": false
            },
            {
                "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "topics": [
                    "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                    "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                ],
                "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                "blockHash": null,
                "blockNumber": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "logIndex": "0x1",
                "removed": false
            },
            {
                "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "topics": [
                    "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                ],
                "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                "blockHash": null,
                "blockNumber": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "logIndex": "0x2",
                "removed": false
            }
        ],
        "txReceipts": [
            {
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "blockHash": null,
                "blockNumber": null,
                "cumulativeGasUsed": "0x92b1b",
                "gasUsed": "0x92b1b",
                "effectiveGasPrice": "0x0",
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "to": null,
                "contractAddress": null,
                "logs": [
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                        "blockHash": null,
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "logIndex": "0x0",
                        "removed": false
                    },
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                        "blockHash": null,
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "logIndex": "0x1",
                        "removed": false
                    },
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                        "blockHash": null,
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "logIndex": "0x2",
                        "removed": false
                    }
                ],
                "logsBloom": "0x00000000000000800000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000100000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000800000000000000000080000000000000000000000000000000000001000000000000000008000000000010000000000000000000000",
                "status": "0x1",
                "type": "0xff"
            }
        ]
    },
    "id": 0
}

Bundle Simulation - cgp_simulateTransactionsBundle

The method cgp_simulateTransactionsBundle allows simulating the a transaction/tx message bundles against the overriden blockchain state, thanks to Go-Ethereum struct StateAccount.

OverrideAccount definition

The code snippet from Go-Ethereum:

OverrideAccount is a struct in Go-Ethereum for overriding account fields during message call execution:

Nonce: It allows you to specify a custom nonce for the account.
Code: You can provide custom bytecode for the account's code.
Balance: This field lets you specify a custom balance for the account.
State: You can set a custom state for the account using this field.
StateDiff: If you prefer, you can apply a state differential (changes to the account state) instead.

StateOverride is a map where you can specify multiple accounts to override with OverrideAccount configurations.

BlockOverrides definition

The code snippet from Go-Ethereum:

Number: It represents the block number to override.
Difficulty: It allows you to specify a custom block difficulty.
Time: You can set a custom timestamp for the block using this field.
GasLimit: It lets you specify a custom gas limit for the block.
Coinbase: You can set a custom address as the coinbase (beneficiary) of the block.
Random: This field allows you to set a custom random value for the block.
BaseFee: It lets you specify a custom base fee for the block.

Method Payload Signature:

Request Example:

Response Example:

Supported Chains List

Invisium API Supported Chains and Execution Clients:

Ethereum:
- Geth Client: The Go-Ethereum client, a widely used implementation of the Ethereum protocol.
- Testnets Supported: Ethereum's Goerli and Sepolia testnets for efficient development and testing.
Base Chain. The foundational blockchain supported by CGP API, catering to various decentralized applications.
Arbitrum (Legacy and Nitro): A Layer 2 scaling solution for Ethereum, enhancing scalability and reducing transaction costs.
Optimism L2 (op-reth and op-geth): A Layer 2 scaling solution offering faster and more cost-effective transactions for Ethereum-based applications.
Linea L2: A Layer 2 solution providing scalability benefits for Ethereum applications.
Scroll L2: Another Layer 2 scaling solution contributing to the performance optimization of Ethereum applications.
Blast L2: Blast L2 is an innovative Ethereum Layer 2 (L2) scaling solution offering unique features such as native yield generation for ETH and stablecoins. Developed by Pacman, the founder of the NFT marketplace Blur, Blast L2 has quickly gained traction within the cryptocurrency community.
Manta Network: - a modular blockchain ecosystem designed for building scalable decentralized applications using zero-knowledge (ZK) cryptography. It consists of two main networks.
Binance Smart Chain (BSC):
- Geth Client for BSC: The Go-Ethereum client adapted for Binance Smart Chain, ensuring compatibility with BSC-based projects.
Polygon PoS.

Upcoming Chains & Node Clients:

X1.
Metis.
Polygon zkEVM.
ZKSync Era Mainnet.
Avalanche C-Chain.

The CGP API supports a comprehensive array of execution clients and blockchain solutions, including prominent Layer 2 scaling solutions and the popular Binance Smart Chain. By accommodating various networks and testnets, CGP facilitates a versatile development environment for blockchain projects.

Invisium: Pricing & Roadmap

Pricing: The Canvas Of Possibility

In the ever-evolving realm of blockchain and Web3, your journey is as unique as your fingerprint. Our pricing structure is not a mere transaction — it's a masterpiece that adapts to your aspirations. Picture a canvas upon which we paint the artistry of value, one stroke at a time.

Three Tiers, Infinite Potential

Imagine our pricing as a triptych — a three-panel masterpiece, each with its own allure:

Free Tier - The Genesis: This is your entry point, the first brushstroke on your canvas of exploration. With a generous allocation of Compute Units (CU), you can start your journey with 300 Million CUs at your disposal. It's your invitation to step into the world of limitless possibilities, one request per second and payloads of up to 1024KB.
Professional Tier - The Impression: When you're ready to deepen your exploration, the Professional Tier awaits. Here, your canvas expands to accommodate 500 Million CUs. It's your chance to unlock the symphony of 15 requests per second, with payloads stretching to 3,000 KB. Your masterpiece evolves.

Craft Your Masterpiece

But this is no ordinary canvas; it's adaptable and customizable to your needs. The Compute Units table is your palette, allowing you to configure your usage and pricing as if you were mixing colors on an artist's palette. Your masterpiece is as unique as your vision.

Transparency and Assurance

Our pricing is as transparent as a clear sky. We believe in fairness and clarity. What you see is what you get—no hidden fees, no surprises. The canvas is yours to paint, and you'll always know the cost.

Your Canvas Awaits

In the world of Web3, pricing is not a barrier; it's a brushstroke in your masterpiece. It's your ticket to explore, experiment, and excel. It's the tool that unlocks the full potential of your blockchain dreams.

Join the Gallery

Join us in this gallery of innovation and possibility. Our pricing is the key to unlocking your creative potential in the Web3 universe. Your canvas is ready, and the artistry of pricing is your guide.

Paint Your Future

Paint your future with pricing that adjusts to your needs and aspirations. Let your masterpiece be a testament to the limitless potential of Web3. The gallery is open, and your exhibition begins now.

Compute Units Table: The Art of Efficiency

This table provides a breakdown of Compute Units (CUs) associated with various Ethereum RPC requests. CUs are a measure of resource consumption, allowing users to understand and manage their usage effectively.

RPC Compute Units Table

Note: All the other existing methods in clients are measured as 300 CU per request.

WebSockets Compute Units Cost

WebSocket API usage is priced based on bandwidth, which is the amount of data delivered as part of the subscription.

Invisium: SLAs & Limits

SLAs

Service Level Agreements (SLAs) for Invisium API Services:

Availability:
- Invisium API Services guarantee a high level of availability, typically exceeding 99.9%.
- Downtime is minimized to ensure continuous access for customers, with scheduled maintenance communicated in advance.
Performance:
- Fast and reliable response times ensure optimal performance for API requests.
- Invisium monitors and optimizes performance to meet industry standards and user expectations.
Scalability:
- Designed to scale horizontally, Invisium API Services can accommodate increased user demand effortlessly.
- Auto-scaling mechanisms ensure seamless performance even during traffic spikes.
Security:
- Robust security measures, including encryption protocols and authentication mechanisms, safeguard user data and API interactions.
- Regular security audits and updates maintain the integrity of the API services.
Support:
- Responsive customer support is available to address queries and issues promptly.
- A comprehensive knowledge base and documentation facilitate self-service for users.
Data Integrity:
- Invisium API Services prioritize data integrity, employing redundancy and backup strategies.
- Continuous monitoring detects and mitigates potential data inconsistencies.
Compliance:
- Adherence to industry standards and compliance with data protection regulations, ensuring a secure and compliant API environment.
Notifications:
- Users receive timely notifications regarding scheduled maintenance, updates, or any incidents affecting the API services.
- Transparent communication keeps users informed about the status of the services.
Uptime Credits:
- SLA breach compensation, in the form of uptime credits, is offered to users in the rare event of service unavailability exceeding agreed-upon thresholds.
Continuous Improvement:
- Invisium is committed to continuous improvement, incorporating user feedback and technological advancements to enhance API services.

These SLAs underscore Invisium's dedication to providing a reliable, high-performance, and secure API environment, fostering trust and satisfaction among its customers.

API Limits

There are only 2 types of limits for the RPC API at the moment: Rate Limits and Payload Size Limits.

Free

Advanced

Enterprise

Rate Limits (Requests Per Second)

60 RPS

500 RPS

Unlimited

Payload Size Limits

3 KB

10 KB

Unlimited

Simulate Transaction - cgp_simulateTransaction

Method Payload Signature:

[
      // Either raw tx or unsigned TransactionArgs message
      {
            "from":"0x9718eCd4E97f4332F9652D0Ba224f228B55ec543",
            "to":"0x3a220f351252089d385b29beca14e27f204c296a",
            "gas":"0x393870",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "value":null,
            "nonce":null,
            "data":"0xa9059cbb0000000000000000000000005b9ca044794b2752a12c67d280c70ef595ce57fe00000000000000000000000000000000000000000000000000000000000f4240",
            "input":null
      },
      // Block Estimation State
      "pending",
      // Geth Tracer
      {
            "tracer": "callTracer"
      }
]

Request Example:

curl --location 'https://dev1.cgp.xyz/rpc/mainnet/eth-reth' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "cgp_simulateTransaction",
    "params": [
        {
            "accessList": [],
            "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
            "gasLimit": "0x092a1b00000000",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "to": null,
            "value": "0x0",
            "data": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000"
        },
        "pending",
        null,
        {
            "0x3718ecd4e97f4332f9652d0ba224f228b55ec543": {
                "balance": "0x5af3107a400fff0",
                "state": {
                    "0x0000000000000000000000000000000000000000000000000000000000000001": "0x0000000000000000000000000000000000000000000000000000000000000002"
                }
            }
        },
        {
            "tracer": "callTracer"
        }
    ],
    "id": 0
}'

Response Example:

{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        "totalGasUsed": 600603,
        "traceDebugInfo": [
            {
                "from": "0x0000000000000000000000000000000000000000",
                "gas": "0x0",
                "gasUsed": "0x0",
                "input": "0x",
                "type": "STOP"
            }
        ],
        "trieHashAfter": "0x",
        "trieHashBefore": "0x",
        "txLogs": {},
        "txReceipts": [
            {
                "blockHash": "0x025b4e54163d833fc4bc83ae06cf4d70d383c37314866e0fbc864f647dd97d41",
                "blockNumber": "0x824c34",
                "cumulativeGasUsed": "0x92a1b",
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "gasUsed": "0x92a1b",
                "isSuccessful": true,
                "logs": [
                    {
                        "address": "0xa98b3745d77d886185eed558f3b23145e077cd9c",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                        "blockNumber": "0x824c35",
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": "0xa6c88ec2bffd62a4ef13eeb4c2233a616df921a93adcf9be03d036bfb887202c",
                        "logIndex": "0x0",
                        "removed": false
                    },
                    {
                        "address": "0xa98b3745d77d886185eed558f3b23145e077cd9c",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                        "blockNumber": "0x824c35",
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": "0xa6c88ec2bffd62a4ef13eeb4c2233a616df921a93adcf9be03d036bfb887202c",
                        "logIndex": "0x1",
                        "removed": false
                    },
                    {
                        "address": "0xa98b3745d77d886185eed558f3b23145e077cd9c",
                        "topics": [
                            "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                        "blockNumber": "0x824c35",
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": "0xa6c88ec2bffd62a4ef13eeb4c2233a616df921a93adcf9be03d036bfb887202c",
                        "logIndex": "0x2",
                        "removed": false
                    }
                ],
                "logsBloom": "0x00000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000010000000000020000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000800000000000020000080000000000000000000000000000000000001000000000000000000000000000010000000000000000000000",
                "status": "0x1",
                "to": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": 0,
                "txLogs": {
                    "0": {
                        "contractAddress": "0xa98B3745d77d886185EED558F3B23145e077Cd9c",
                        "data": "000000000000000000000000000000000000000000000000000000136e720741",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
                    },
                    "1": {
                        "contractAddress": "0xa98B3745d77d886185EED558F3B23145e077Cd9c",
                        "data": "0000000000000000000000000000000000000000000000000000000000008825",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
                    },
                    "2": {
                        "contractAddress": "0xa98B3745d77d886185EED558F3B23145e077Cd9c",
                        "data": "0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                        "topics": [
                            "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                        ],
                        "txHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
                    }
                },
                "type": "0xff"
            }
        ]
    }
}

Simulate Single Transaction With Override

The method cgp_simulateTransaction allows simulating the single transaction/tx message against the overriden blockchain state, thanks to Go-Ethereum struct StateAccount.

OverrideAccount definition

The code snippet from Go-Ethereum:

// OverrideAccount indicates the overriding fields of account during the execution
// of a message call.
// Note, state and stateDiff can't be specified at the same time. If state is
// set, message execution will only use the data in the given state. Otherwise
// if statDiff is set, all diff will be applied first and then execute the call
// message.
type OverrideAccount struct {
	Nonce     *hexutil.Uint64              `json:"nonce"`
	Code      *hexutil.Bytes               `json:"code"`
	Balance   **hexutil.Big                `json:"balance"`
	State     *map[common.Hash]common.Hash `json:"state"`
	StateDiff *map[common.Hash]common.Hash `json:"stateDiff"`
}

// StateOverride is the collection of overridden accounts.
type StateOverride map[common.Address]OverrideAccount

OverrideAccount is a struct in Go-Ethereum for overriding account fields during message call execution:

Nonce: It allows you to specify a custom nonce for the account.
Code: You can provide custom bytecode for the account's code.
Balance: This field lets you specify a custom balance for the account.
State: You can set a custom state for the account using this field.
StateDiff: If you prefer, you can apply a state differential (changes to the account state) instead.

StateOverride is a map where you can specify multiple accounts to override with OverrideAccount configurations.

BlockOverrides definition

The code snippet from Go-Ethereum:

// BlockOverrides is a set of header fields to override.
type BlockOverrides struct {
	Number     *hexutil.Big
	Difficulty *hexutil.Big
	Time       *hexutil.Uint64
	GasLimit   *hexutil.Uint64
	Coinbase   *common.Address
	Random     *common.Hash
	BaseFee    *hexutil.Big
}

Number: It represents the block number to override.
Difficulty: It allows you to specify a custom block difficulty.
Time: You can set a custom timestamp for the block using this field.
GasLimit: It lets you specify a custom gas limit for the block.
Coinbase: You can set a custom address as the coinbase (beneficiary) of the block.
Random: This field allows you to set a custom random value for the block.
BaseFee: It lets you specify a custom base fee for the block.

Method Payload Signature:

[
      // Either raw tx or unsigned TransactionArgs message
      {
            "from":"0x9718eCd4E97f4332F9652D0Ba224f228B55ec543",
            "to":"0x3a220f351252089d385b29beca14e27f204c296a",
            "gas":"0x393870",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "value":null,
            "nonce":null,
            "data":"0xa9059cbb0000000000000000000000005b9ca044794b2752a12c67d280c70ef595ce57fe00000000000000000000000000000000000000000000000000000000000f4240",
            "input":null
      },
      // Block Estimation State
      "pending",
      // state overriding
      {
            "0x9718eCd4E97f4332F9652D0Ba224f228B55ec543": {
                  "balance": "0x3242123",
                  "code": "0x....f1",
                  "state": {
                        // hash to hash
                        // storage slots layout mapping
                        "0x000..1": "0xfff..ff"
                  }
            }
      },
      // block headers overriding (may be null)
      {
            // block.number
            "number": "0x1173FF5",
            // block.timestamp
            "time": "0x1173ff5"
      },
      // Geth Tracer
      {
            "tracer": "callTracer"
      }
]

Request Example:

curl --location 'https://dev1.cgp.xyz/rpc/mainnet/eth-reth' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "cgp_simulateTransaction",
    "params": [
        {
            "accessList": [],
            "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
            "gasLimit": "0x092a1b00000000",
            "maxFeePerGas":null,
            "maxPriorityFeePerGas":null,
            "to": null,
            "value": "0x0",
            "data": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000"
        },
        "pending",
        null,
        {
            "0x3718ecd4e97f4332f9652d0ba224f228b55ec543": {
                "balance": "0x5af3107a400fff0",
                "state": {
                    "0x0000000000000000000000000000000000000000000000000000000000000001": "0x0000000000000000000000000000000000000000000000000000000000000002"
                }
            }
        },
        {
            "tracer": "callTracer"
        }
    ],
    "id": 0
}'

Response Example:

{
    "jsonrpc": "2.0",
    "result": {
        "traceDebugInfo": [
            {
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "gas": "0x2faf080",
                "gasUsed": "0x92b1b",
                "to": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "input": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                "output": "0x608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c63430008110033",
                "value": "0x0",
                "type": "CREATE"
            }
        ],
        "totalGasUsed": 600859,
        "trieHashAfter": "",
        "trieHashBefore": "",
        "txLogs": [
            {
                "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "topics": [
                    "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                    "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                ],
                "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                "blockHash": null,
                "blockNumber": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "logIndex": "0x0",
                "removed": false
            },
            {
                "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "topics": [
                    "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                    "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                ],
                "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                "blockHash": null,
                "blockNumber": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "logIndex": "0x1",
                "removed": false
            },
            {
                "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "topics": [
                    "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                ],
                "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                "blockHash": null,
                "blockNumber": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "logIndex": "0x2",
                "removed": false
            }
        ],
        "txReceipts": [
            {
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": "0x0",
                "blockHash": null,
                "blockNumber": null,
                "cumulativeGasUsed": "0x92b1b",
                "gasUsed": "0x92b1b",
                "effectiveGasPrice": "0x0",
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "to": null,
                "contractAddress": null,
                "logs": [
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                        "blockHash": null,
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "logIndex": "0x0",
                        "removed": false
                    },
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                        "blockHash": null,
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "logIndex": "0x1",
                        "removed": false
                    },
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                        "blockHash": null,
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "logIndex": "0x2",
                        "removed": false
                    }
                ],
                "logsBloom": "0x00000000000000800000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000100000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000800000000000000000080000000000000000000000000000000000001000000000000000008000000000010000000000000000000000",
                "status": "0x1",
                "type": "0xff"
            }
        ]
    },
    "id": 0
}

Bundle Simulation - cgp_simulateTransactionsBundle

The method cgp_simulateTransactionsBundle allows simulating the a transaction/tx message bundles against the overriden blockchain state, thanks to Go-Ethereum struct StateAccount.

OverrideAccount definition

The code snippet from Go-Ethereum:

// OverrideAccount indicates the overriding fields of account during the execution
// of a message call.
// Note, state and stateDiff can't be specified at the same time. If state is
// set, message execution will only use the data in the given state. Otherwise
// if statDiff is set, all diff will be applied first and then execute the call
// message.
type OverrideAccount struct {
	Nonce     *hexutil.Uint64              `json:"nonce"`
	Code      *hexutil.Bytes               `json:"code"`
	Balance   **hexutil.Big                `json:"balance"`
	State     *map[common.Hash]common.Hash `json:"state"`
	StateDiff *map[common.Hash]common.Hash `json:"stateDiff"`
}

// StateOverride is the collection of overridden accounts.
type StateOverride map[common.Address]OverrideAccount

OverrideAccount is a struct in Go-Ethereum for overriding account fields during message call execution:

Nonce: It allows you to specify a custom nonce for the account.
Code: You can provide custom bytecode for the account's code.
Balance: This field lets you specify a custom balance for the account.
State: You can set a custom state for the account using this field.
StateDiff: If you prefer, you can apply a state differential (changes to the account state) instead.

StateOverride is a map where you can specify multiple accounts to override with OverrideAccount configurations.

BlockOverrides definition

The code snippet from Go-Ethereum:

// BlockOverrides is a set of header fields to override.
type BlockOverrides struct {
	Number     *hexutil.Big
	Difficulty *hexutil.Big
	Time       *hexutil.Uint64
	GasLimit   *hexutil.Uint64
	Coinbase   *common.Address
	Random     *common.Hash
	BaseFee    *hexutil.Big
}

Number: It represents the block number to override.
Difficulty: It allows you to specify a custom block difficulty.
Time: You can set a custom timestamp for the block using this field.
GasLimit: It lets you specify a custom gas limit for the block.
Coinbase: You can set a custom address as the coinbase (beneficiary) of the block.
Random: This field allows you to set a custom random value for the block.
BaseFee: It lets you specify a custom base fee for the block.

Method Payload Signature:

[
      // List of either raw tx or unsigned TransactionArgs message
      [
            {
                  "from":"0x9718eCd4E97f4332F9652D0Ba224f228B55ec543",
                  "to":"0x3a220f351252089d385b29beca14e27f204c296a",
                  "gas":"0x393870",
                  "maxFeePerGas":null,
                  "maxPriorityFeePerGas":null,
                  "value":null,
                  "nonce":null,
                  "data":"0xa9059cbb0000000000000000000000005b9ca044794b2752a12c67d280c70ef595ce57fe00000000000000000000000000000000000000000000000000000000000f4240",
                  "input":null
            },
            ...
      ]
      // Block Estimation State
      "pending",
      // State overriding (may be null)
      {
            "0x9718eCd4E97f4332F9652D0Ba224f228B55ec543": {
                  "balance": "0x3242123",
                  "code": "0x....f1",
                  "state": {
                        // hash to hash
                        // storage slots layout mapping
                        "0x000..1": "0xfff..ff"
                  }
            }
      },
      // BlockOverrides definition (may be null)
      {
            // block.number
            "number": "0x1173FF5",
            // block.timestamp
            "time": "0x1173ff5"
      },
      // Geth Tracer
      {
            "tracer": "callTracer"
      }
]

Request Example:

curl --location 'https://dev1.cgp.xyz/rpc/mainnet/eth-reth' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "cgp_simulateTransactionsBundle",
    "params": [
        [
            {
                "accessList": [],
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "gasLimit": "0x092a1b00000000",
                "maxFeePerGas":null,
                "maxPriorityFeePerGas":null,
                "to": null,
                "value": "0x0",
                "data": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000"
            }
        ],
        "pending",
        null,
        {
            "0x3718ecd4e97f4332f9652d0ba224f228b55ec543": {
                "balance": "0x5af3107a400fff0",
                "state": {
                    "0x0000000000000000000000000000000000000000000000000000000000000001": "0x0000000000000000000000000000000000000000000000000000000000000002"
                }
            }
        },
        {
            "tracer": "callTracer"
        }
    ],
    "id": 0
}'

Response Example:

{
    "jsonrpc": "2.0",
    "id": 0,
    "result": {
        "totalGasUsed": 600859,
        "trieHashAfter": "",
        "trieHashBefore": "",
        "traceDebugInfo": [
            {
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "gas": "0x2faf080",
                "gasUsed": "0x92b1b",
                "to": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                "input": "0x60806040523480156200001157600080fd5b5060405162000f6438038062000f648339818101604052810190620000379190620002f2565b80600090816200004891906200058e565b506001808190555073390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329764136e720741604051620000b19190620006b8565b60405180910390a273390d81d6262c6d9080b180408a621715a83a417273ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d05329761882560405162000117919062000718565b60405180910390a27fa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f8160405162000150919062000787565b60405180910390a150620007ab565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b6000601f19601f8301169050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b620001c8826200017d565b810181811067ffffffffffffffff82111715620001ea57620001e96200018e565b5b80604052505050565b6000620001ff6200015f565b90506200020d8282620001bd565b919050565b600067ffffffffffffffff82111562000230576200022f6200018e565b5b6200023b826200017d565b9050602081019050919050565b60005b83811015620002685780820151818401526020810190506200024b565b60008484015250505050565b60006200028b620002858462000212565b620001f3565b905082815260208101848484011115620002aa57620002a962000178565b5b620002b784828562000248565b509392505050565b600082601f830112620002d757620002d662000173565b5b8151620002e984826020860162000274565b91505092915050565b6000602082840312156200030b576200030a62000169565b5b600082015167ffffffffffffffff8111156200032c576200032b6200016e565b5b6200033a84828501620002bf565b91505092915050565b600081519050919050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806200039657607f821691505b602082108103620003ac57620003ab6200034e565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b600060088302620004167fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82620003d7565b620004228683620003d7565b95508019841693508086168417925050509392505050565b6000819050919050565b6000819050919050565b60006200046f6200046962000463846200043a565b62000444565b6200043a565b9050919050565b6000819050919050565b6200048b836200044e565b620004a36200049a8262000476565b848454620003e4565b825550505050565b600090565b620004ba620004ab565b620004c781848462000480565b505050565b5b81811015620004ef57620004e3600082620004b0565b600181019050620004cd565b5050565b601f8211156200053e576200050881620003b2565b6200051384620003c7565b8101602085101562000523578190505b6200053b6200053285620003c7565b830182620004cc565b50505b505050565b600082821c905092915050565b6000620005636000198460080262000543565b1980831691505092915050565b60006200057e838362000550565b9150826002028217905092915050565b620005998262000343565b67ffffffffffffffff811115620005b557620005b46200018e565b5b620005c182546200037d565b620005ce828285620004f3565b600060209050601f831160018114620006065760008415620005f1578287015190505b620005fd858262000570565b8655506200066d565b601f1984166200061686620003b2565b60005b82811015620006405784890151825560018201915060208501945060208101905062000619565b868310156200066057848901516200065c601f89168262000550565b8355505b6001600288020188555050505b505050505050565b6000819050919050565b6000620006a06200069a620006948462000675565b62000444565b6200043a565b9050919050565b620006b2816200067f565b82525050565b6000602082019050620006cf6000830184620006a7565b92915050565b6000819050919050565b600062000700620006fa620006f484620006d5565b62000444565b6200043a565b9050919050565b6200071281620006df565b82525050565b60006020820190506200072f600083018462000707565b92915050565b600082825260208201905092915050565b6000620007538262000343565b6200075f818562000735565b93506200077181856020860162000248565b6200077c816200017d565b840191505092915050565b60006020820190508181036000830152620007a3818462000746565b905092915050565b6107a980620007bb6000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80636a59694614610046578063a413686214610064578063cfae321714610080575b600080fd5b61004e61009e565b60405161005b919061024a565b60405180910390f35b61007e600480360381019061007991906103b5565b610115565b005b610088610128565b604051610095919061024a565b60405180910390f35b60606100a8610128565b503373ffffffffffffffffffffffffffffffffffffffff167fb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d0532976001546040516100f19190610417565b60405180910390a2600180600082825461010b9190610461565b9250508190555090565b806000908161012491906106a1565b5050565b606060008054610137906104c4565b80601f0160208091040260200160405190810160405280929190818152602001828054610163906104c4565b80156101b05780601f10610185576101008083540402835291602001916101b0565b820191906000526020600020905b81548152906001019060200180831161019357829003601f168201915b5050505050905090565b600081519050919050565b600082825260208201905092915050565b60005b838110156101f45780820151818401526020810190506101d9565b60008484015250505050565b6000601f19601f8301169050919050565b600061021c826101ba565b61022681856101c5565b93506102368185602086016101d6565b61023f81610200565b840191505092915050565b600060208201905081810360008301526102648184610211565b905092915050565b6000604051905090565b600080fd5b600080fd5b600080fd5b600080fd5b7f4e487b7100000000000000000000000000000000000000000000000000000000600052604160045260246000fd5b6102c282610200565b810181811067ffffffffffffffff821117156102e1576102e061028a565b5b80604052505050565b60006102f461026c565b905061030082826102b9565b919050565b600067ffffffffffffffff8211156103205761031f61028a565b5b61032982610200565b9050602081019050919050565b82818337600083830152505050565b600061035861035384610305565b6102ea565b90508281526020810184848401111561037457610373610285565b5b61037f848285610336565b509392505050565b600082601f83011261039c5761039b610280565b5b81356103ac848260208601610345565b91505092915050565b6000602082840312156103cb576103ca610276565b5b600082013567ffffffffffffffff8111156103e9576103e861027b565b5b6103f584828501610387565b91505092915050565b6000819050919050565b610411816103fe565b82525050565b600060208201905061042c6000830184610408565b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052601160045260246000fd5b600061046c826103fe565b9150610477836103fe565b925082820190508082111561048f5761048e610432565b5b92915050565b7f4e487b7100000000000000000000000000000000000000000000000000000000600052602260045260246000fd5b600060028204905060018216806104dc57607f821691505b6020821081036104ef576104ee610495565b5b50919050565b60008190508160005260206000209050919050565b60006020601f8301049050919050565b600082821b905092915050565b6000600883026105577fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261051a565b610561868361051a565b95508019841693508086168417925050509392505050565b6000819050919050565b600061059e610599610594846103fe565b610579565b6103fe565b9050919050565b6000819050919050565b6105b883610583565b6105cc6105c4826105a5565b848454610527565b825550505050565b600090565b6105e16105d4565b6105ec8184846105af565b505050565b5b81811015610610576106056000826105d9565b6001810190506105f2565b5050565b601f82111561065557610626816104f5565b61062f8461050a565b8101602085101561063e578190505b61065261064a8561050a565b8301826105f1565b50505b505050565b600082821c905092915050565b60006106786000198460080261065a565b1980831691505092915050565b60006106918383610667565b9150826002028217905092915050565b6106aa826101ba565b67ffffffffffffffff8111156106c3576106c261028a565b5b6106cd82546104c4565b6106d8828285610614565b600060209050601f83116001811461070b57600084156106f9578287015190505b6107038582610685565b86555061076b565b601f198416610719866104f5565b60005b828110156107415784890151825560018201915060208501945060208101905061071c565b8683101561075e578489015161075a601f891682610667565b8355505b6001600288020188555050505b50505050505056fea2646970667358221220d457475b933f5e68a3579e1dac3c6f734b0b7c37bae05b70eec618cb32e0df0864736f6c634300081100330000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                "calls": null,
                "value": "0x0",
                "type": "CREATE"
            }
        ],
        "txLogs": {
            "1": {
                "contractAddress": null,
                "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                "topics": [
                    "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                    "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                ],
                "txHash": null
            },
            "0": {
                "contractAddress": null,
                "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                "topics": [
                    "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                    "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                ],
                "txHash": null
            },
            "2": {
                "contractAddress": null,
                "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                "topics": [
                    "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                ],
                "txHash": null
            }
        },
        "txReceipts": [
            {
                "blockHash": null,
                "blockNumber": null,
                "cumulativeGasUsed": "0x92b1b",
                "from": "0x3718ecd4e97f4332f9652d0ba224f228b55ec543",
                "gasUsed": "0x92b1b",
                "isSuccessful": null,
                "logs": [
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x000000000000000000000000000000000000000000000000000000136e720741",
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": null,
                        "logIndex": "0x0",
                        "removed": false
                    },
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xb44a177f4cc6099a375ea1187f4bab9c40dc670fdcd35d6d09b357525d053297",
                            "0x000000000000000000000000390d81d6262c6d9080b180408a621715a83a4172"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000008825",
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": null,
                        "logIndex": "0x1",
                        "removed": false
                    },
                    {
                        "address": "0x8f10d01670cc16ba5c582ee38cd7a79c299c4445",
                        "topics": [
                            "0xa95e6e2a182411e7a6f9ed114a85c3761d87f9b8f453d842c71235aa64fff99f"
                        ],
                        "data": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002a30783366633931613361666437303339356364343936633634376435613663633964346232623766616400000000000000000000000000000000000000000000",
                        "blockNumber": null,
                        "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                        "transactionIndex": "0x0",
                        "blockHash": null,
                        "logIndex": "0x2",
                        "removed": false
                    }
                ],
                "logsBloom": "0x00000000000000800000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000100000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000800000000000000000080000000000000000000000000000000000001000000000000000008000000000010000000000000000000000",
                "status": "0x1",
                "to": null,
                "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
                "transactionIndex": 0,
                "type": "0xff"
            }
        ]
    }
}