# Welcome ### Who is OMNIA OMNIA, founded in 2021, is a specialized RPC provider for DeFi traders, developed by cybersecurity, privacy and trading experts. We address DeFi-specific challenges like front-running and MEV exploitation. Our [advanced features,](/defi/features-overview) including real-time pending transaction streams and robust transaction broadcasts, ensure fast and secure transactions. OMNIA’s cutting-edge infrastructure makes it a go-to choice for optimized DeFi trading. {% hint style="info" %} QuickStart {% endhint %} ### What we do OMNIA delivers scalable and reliable blockchain infrastructure and offer seamless access between wallets or dApps and nodes. \ \ We've integrated these wallets to connect into our dashboard: * MetaMask * Coinbase * WalletConnect * BlockWallet Our commitment to innovation and efficiency drives us to ensure uncompromised end-to-end privacy and superior performance. {% hint style="info" %} Check if you've been Frontrunned {% endhint %} ### Why DeFi Traders OMNIA's RPCs attract millions of requests per day. DeFi users have distinct needs and challenges compared to other types of users in the blockchain and cryptocurrency space. 1. [**Front-Running**](/defi/frontrunning-protection)**.** DeFi users are susceptible to front-running attacks, requiring providers to implement preventive measures. 2. **High Volume.** DeFi experiences spikes in transaction volume and volatility, demanding an infrastructure that ensures prompt handling. 3. [**MEV Exploitation**](/defi/mev-cashback)**.** DeFi traders face risks from bots manipulating transaction orders, making MEV mitigation solutions essential. 4. **Smart Contracts.** DeFi involves multiple smart contract interactions, requiring an RPC provider for seamless execution for a secure and safe journey. 5. **Financial Stakes.** High financial stakes in DeFi make transaction security and reliability crucial. 6. **Rapid Changes.** The fast-evolving DeFi landscape necessitates platforms to be agile and adaptive. # Pricing Plans OMNIA offers multiple pricing plans to suit all user requirements. We're in launch phase and offering HUGE discounts across all plans. Get in on our founders launch. ## Pay with credit card or crypto. Monthly or Annual plan.
Free

  • Max RPS 50
  • Daily Requests 100,000
  • Token Approval Security $4,99
  • Advanced Frontrunning Protection Included $4.99
  • Honeypot Protection $4,99
  • Smart Guard Basic
  • Support Level Community
Pro
$31 /month
  • Max RPS 50
  • Daily Requests 300,000
  • Token Approval Security Included
  • Advanced Frontrunning Protection Included
  • MEV Cashback Included
  • Reinforced Transactions Included
  • Honeypot Protection Included
  • Smart Guard Basic
  • Support Level Premium
Pro Growth
$79 /month
  • Max RPS 100
  • Daily Requests 1,000,000
  • Token Approval Security Included
  • Advanced Frontrunning Protection Included
  • MEV Cashback Included
  • Reinforced Transactions Included
  • Honeypot Protection Included
  • Smart Guard Basic
  • Support Level Premium

Pro Elite
$792 /month

  • Max RPS 250
  • Daily Requests 5,000,000
  • Token Approval Security Included
  • Advanced Frontrunning Protection Included
  • MEV Cashback Included
  • Reinforced Transactions Included
  • Honeypot Protection Included
  • Smart Guard Advanced
  • API Uptime 98%
  • Support Level Gold
EnterpriseContact Us
  • Max RPS 500+
  • Daily Requests 10,000,000+
  • Token Approval Security Included
  • Advanced Frontrunning Protection Included
  • MEV Cashback Included
  • Reinforced Transactions Included
  • Honeypot Protection Included
  • Smart Guard Advanced
  • API Uptime 99.9%
  • Support Level Enterprise
{% hint style="info" %} Enterprise Contact us at {% endhint %} ### Free Forever Features Enhanced Privacy, up to Max RPS 50, Up to Daily Requests 100.000 (for Mainnet) and 25.000 for Testnets. Appeals to the DeFi user or Dev that does a moderate or burst amount of activity around the clock. If your requests are spread evenly throughout a 24-hour period, this translates to approximately 1.15 requests per second continuously. ### PRO, PRO Growth and Pro Elite Features up to Max RPS 250, Up to Daily Requests 5.000.000, Guaranteed SLA 98%, Advanced Frontrunning Protection, Honeypot Protection, **MEV Cashback**, Reinforced transaction, Token Approval Security, VIP level support and custom RPC features. ### Enterprise Features Max RPS 500+, Daily Requests 10.000.000+, Guaranteed SLA 99.9%, Advanced Frontrunning Protection, Honeypot Protection, **MEV Cashback**, Reinforced transaction, Token Approval Security, VIP level support, Dedicated Account Manager and custom RPC features. ### Rate Limiting Rate limiting is used to control the amount of incoming traffic or requests from clients. It helps prevent abuse, ensures fair usage, and maintains the stability and performance of the server. For this, each HTTP request has an associated data payload size, which is an average of 800 bytes per request. To calculate the rate limit for Pro plan over the WebSocket connection for a 10-second window, you can use the following formula: Download Limit = (RPS) x (Average Payload Size per Request) x (Window Duration) Download Limit = 25 requests/second x 800 bytes/request x 10 seconds = 200,000 bytes So, the rate limit imposed over the WebSocket connection for a 10-second window is 200 kilobytes (KB). This means that within any given 10-second period, a client or user can download a maximum of 200 KB of data via WebSocket connections to the service without exceeding the rate limit. If the limit is exceeded, additional requests will be throttled or denied to ensure that the service's resources are not overwhelmed. # Public RPC Endpoints OMNIA DeFi-based Endpoints For free Fast and Secure endpoints with Privacy.\ We also offer Advanced Frontrunning protection, Token Approval Security, Honeypot protection, Reinforced Transactions, **MEV Cashback** and so much more with our paid plans, please visit 👇. {% embed url="" fullWidth="false" %} ### Aggregators - Public OMNIA Endpoints

Nodecompare

Chainlist

### *Public EVM-based endpoints with Privacy*
Ethereum Mainnet
https://endpoints.omniatech.io/v1/eth/mainnet/public
Chain ID: 1 (0x1)
Currency: ETH
Ethereum Sepolia
https://endpoints.omniatech.io/v1/eth/sepolia/public
Chain ID: 11155111 (0xaa36a7)
Currency: ETH
Ethereum Holesky
https://endpoints.omniatech.io/v1/eth/holesky/public
Chain ID: 17000 (0x4268)
Currency: ETH
Binance Smart Chain Mainnet
https://endpoints.omniatech.io/v1/bsc/mainnet/public
Chain ID: 56 (0x38)
Currency: BNB
Binance Smart Chain Testnet
https://endpoints.omniatech.io/v1/bsc/testnet/public
Chain ID: 97 (0x61)
Currency: tBNB
Avalanche C-Chain
https://endpoints.omniatech.io/v1/avax/mainnet/public
Chain ID: 43114 (0xa86a)
Currency: AVAX
Avalanche Fuji
https://endpoints.omniatech.io/v1/avax/fuji/public
Chain ID: 43113 (0xa869)
Currency: AVAX
Polygon Mainnet
https://endpoints.omniatech.io/v1/matic/mainnet/public
Chain ID: 137 (0x89)
Currency: MATIC
Polygon Mumbai
https://endpoints.omniatech.io/v1/matic/mumbai/public
Chain ID: 80001 (0x13881)
Currency: MATIC
Polygon-ZKEVM Mainnet
https://endpoints.omniatech.io/v1/polygon-zkevm/mainnet/public
Chain ID: 1101 (0x44d)
Currency: ETH
Polygon-ZKEVM Testnet
https://endpoints.omniatech.io/v1/polygon-zkevm/testnet/public
Chain ID: 1442 (0x5a2)
Currency: ETH
Arbitrum One
https://endpoints.omniatech.io/v1/arbitrum/one/public
Chain ID: 42161 (0xa4b1)
Currency: ETH
Arbitrum Sepolia
https://endpoints.omniatech.io/v1/arbitrum/sepolia/public
Chain ID: 421614 (0x66eee)
Currency: ETH
Optimism Mainnet
https://endpoints.omniatech.io/v1/op/mainnet/public
Chain ID: 10 (0xa)
Currency: ETH
Optimism Sepolia
https://endpoints.omniatech.io/v1/op/sepolia/public
Chain ID: 11155420 (0xaa37dc)
Currency: ETH
Base Mainnet
https://endpoints.omniatech.io/v1/base/mainnet/public
Chain ID: 8453 (0x2105)
Currency: ETH
Base Sepolia
https://endpoints.omniatech.io/v1/base/sepolia/public
Chain ID: 84532 (0x14a34)
Currency: ETH
ZKSync-Era
Mainnet https://endpoints.omniatech.io/v1/zksync-era/mainnet/public
Chain ID: 324 (0x144)
Currency: ETH
ZKSync-Era Sepolia
https://endpoints.omniatech.io/v1/zksync-era/sepolia/public
Chain ID: 300 (0x12c)
Currency: ETH
ZKFair Mainnet
https://endpoints.omniatech.io/v1/zkfair/mainnet/public
Chain ID: 42766 (0xa70e)
Currency: USDC
ZKFair Testnet
https://endpoints.omniatech.io/v1/zkfair/testnet/public
Chain ID: 43851 (0xab4b)
Currency: USDC
Aurora Mainnet
https://endpoints.omniatech.io/v1/aurora/mainnet/public
Chain ID: 1313161554 (0x4e454152)
Currency: ETH
Aurora Testnet
https://endpoints.omniatech.io/v1/aurora/testnet/public
Chain ID: 1313161555 (0x4e454153)
Currency: ETH
Fantom Opera Mainnet
https://endpoints.omniatech.io/v1/fantom/mainnet/public
Chain ID: 250 (0xfa)
Currency: FTM
Fantom Testnet
https://endpoints.omniatech.io/v1/fantom/testnet/public
Chain ID: 4002 (0xfa2)
Currency: FTM
Harmony Shard 0 Mainnet
https://endpoints.omniatech.io/v1/harmony/mainnet-0/public
Chain ID: 1666600000 (0x63564c40)
Currency: ONE
Harmony Shard 0 Testnet
https://endpoints.omniatech.io/v1/harmony/testnet-0/public
Chain ID: 1666700000 (0x6357d2e0)
Currency: ONE
Moonbeam Mainnet
https://endpoints.omniatech.io/v1/moonbeam/mainnet/public
Chain ID: 1284 (0x504)
Currency: GLMR
Gnosis Mainnet
https://endpoints.omniatech.io/v1/gnosis/mainnet/public
Chain ID: 100 (0x64)
Currency: XDAI
Gnosis Chiado
https://endpoints.omniatech.io/v1/gnosis/chiado/public
Chain ID: 10200 (0x27d8)
Currency: XDAI
Tron Mainnet EVM
https://endpoints.omniatech.io/v1/tron/mainnet-evm/public
Chain ID: 728126428
Currency: TRX
### *Non EVM endpoints*
Tron Mainnet
https://endpoints.omniatech.io/v1/tron/mainnet/public
Currency: TRX
Solana Mainnet
https://endpoints.omniatech.io/v1/sol/mainnet/public
Currency: SOL
Solana Devnet
https://endpoints.omniatech.io/v1/sol/devnet/public
Currency: SOL
NEAR Mainnet
https://endpoints.omniatech.io/v1/near/mainnet/public
Currency: NEAR
Near Testnet
https://endpoints.omniatech.io/v1/near/testnet/public
Currency: NEAR
Cosmos Cosmoshub-4
https://endpoints.omniatech.io/v1/cosmos/cosmoshub-4/public
Currency: ATOM
SDK version: Cosmos SDK v0.34.27
dYdX Mainnet
https://endpoints.omniatech.io/v1/dydx/mainnet/public
Currency: dYdX
dYdX Testnet
https://endpoints.omniatech.io/v1/dydx/testnet/public
Currency: dYdX
Starknet Mainnet
https://endpoints.omniatech.io/v1/starknet/mainnet/public
Currency: STRK
Starknet Sepolia
https://endpoints.omniatech.io/v1/starknet/sepolia/public
Currency: STRK
Starknet Sepolia
https://endpoints.omniatech.io/v1/starknet/sepolia/public
Currency: STRK
Aptos Mainnet
https://endpoints.omniatech.io/v1/aptos/mainnet/public
Currency: APT
Aptos Testnet
https://endpoints.omniatech.io/v1/aptos/testnet/public
Currency: APT
Sui Mainnet
https://endpoints.omniatech.io/v1/sui/mainnet/public
Currency: SUI
Sui Testnet
https://endpoints.omniatech.io/v1/sui/testnet/public
Currency: SUI
BNB-Greenfield Mainnet
https://endpoints.omniatech.io/v1/bnb-greenfield/mainnet/public
# Getting support For the fastest support go to Discord or website chat widget. All support requests go through triage. During market volatility, hackathons and airdrops, our timing may be delayed. Before you reach out to us, check Discord, your answer may be there.
TypeLocationChannelResponse Time
Feature requestDiscord​https://discord.com/invite/omniaprotocol​24 - 48 hrs
IssuesEmail or Discordsupport@omniatech.io https://discord.com/invite/omniaprotocol​Immediate - 24 hrs
BillingWebsitebilling@omniatech.io24 - 48 hrs
GeneralWebsite chat widgetBottom-right of omniatech.ioImmediate - 48 hrs
#### Free Forever Plan Support * Community Discord support #### PRO, PRO Growth and Pro Elite Support * Email support * Private Telegram Group Support * Private Discord Group Support * Video Chat Support #### Enterprise Support * PRO Elite support level + * Dedicated Account Manager # Running a Node # How to add OMNIA Endpoints to wallet Blockchain is transparent by nature, so your data is not private by default. OMNIA Protocol provides a secure blockchain nodes infrastructure decentralizing the blockchain node by node, network by network, and bringing privacy, security and compliance to your blockchain transactions. Learn how to create a secure RPC endpoint that will power your privacy in the blockchain, protecting you from malicious threats and enabling frontrunning protection that can actually save you money. ### How to Add Endpoint to MetaMask 1. Launch [app.omniatech.io](https://app.omniatech.io/) 2. Connect your preferred wallet 3. Generate endpoint 4. Select a blockchain and customize subscription. Choose "help me" if unsure. 5. Enable Frontrunning protection, Honeypot protection and agree to T\&C 6. Sign request in MetaMask wallet {% embed url="" %} {% embed url="" %} {% embed url="" %} {% embed url="" %}
{% endembed %} {% embed url="" %} {% embed url="" %} {% embed url="" %} # Features Overview ### Reliability & Performance * Reliable, fast, secure and scalable RPC API services * SLA of 99.9% * Low Latency * Advanced Caching * Decentralized Infrastructure * 24/7 Monitoring and Real-time Alerts * Benchmark HealthCheck Monitor ### MEV Support (Frontrunning and Cashback) * Ethereum * Binance Smart Chain * Polygon * Arbitrum * Aurora * Avalanche ### Honeypot Protection * Ethereum * Binance Smart Chain ### Token Approval Protection * Ethereum * Binance Smart Chain * Optimism * Polygon * Fantom * Avalanche (C-Chain) * Arbitrum ### Connectivity * HTTP/S and WSS endpoints * Graph QL Support * Access to 33+ blockchain nodes for Bitcoin, Ethereum, Binance Smart Chain, Polygon, Avalanche, Aurora, Near, Solana, Fantom, Arbitrum, Harmony, Optimism * Bring a Node, Run a Node ### Security & Transaction Enhancements RPC Protect (DeFi) * [Reinforced Transactions](/defi/reinforced-transactions) * [Frontrunning Protection](/defi/frontrunning-protection) * Private Transactions * Metadata Protection * [Token Approval Protection](/defi/token-approval-protection) * [Honeypot Protection](/defi/honeypot-protection) * [MEV Cashback](/defi/mev-cashback) ### Analytics & Tools * OMNIA Dashboard & Advanced Analytics * Advanced Debugging * Integrated Testnet Faucet on EthSepolia for tOMNIA ### Pricing & Payment Options * Multiple Pricing Tiers. Pay in Crypto or credit card. ### Support * 24/7 Discord Support & Direct Support option # Wallet Integration OMNIA continues to integrate new wallets on the **app.omniatech.io** dashboard to enhance user experience. Users benefit from the flexibility and freedom to choose a wallet that best suits their needs. They can switch between different wallets for various transactions, enjoy enhanced security features from each, or even use multiple wallets for diversification. {% hint style="success" %} Quickstart Connect Wallet on OMNIA's dashboard.\ {% endhint %}
MetaMask MetaMask is one of the most user-friendly and popular Ethereum-based wallets, making it a go-to choice for many DeFi users. Its browser extension feature can directly interact with your RPC, streamlining transactions.
Coinbase Supports multiple cryptocurrencies, making it flexible for users who deal with a range of assets.
WalletConnect WalletConnect supports a multitude of wallets, adding flexibility and choice for your users. Enables users to connect their desktop DApps to their mobile wallets, offering a versatile range of interactions.
BlockWallet BlockWallet is a self-custodial Web3 wallet that honors self-custody and offers features such as built-in swaps, bridges, hardware wallet support, and more
TokenPocket TokenPocket is a non-custodial mobile wallet that generates and securely stores keys and passwords exclusively on your device, ensuring that only you have access to your account and assets. TokenPocket also offers additional security features such as hardware cold wallet support and MultiSig wallet functionality to further enhance the safeguarding of your assets. It provides support for a wide range of cryptocurrencies including BTC, ETH, BSC, TRON, Aptos, Polygon, Solana, Cosmos, Polkadot, EOS, IOST, and more.
MetaTdex As a smart contract based decentralized trading platform, MetaTdex covers Crypto Wallet, DEX, DeFi, DAO, NFT, mining pools and more areas. Their crypto wallet is available on all mobile platforms, serving over 300,000 users globally.
SafePal SafePal wallet offers cross-platform compatibility between their web-based (Chrome) extension, mobile app and hardware wallet. Their open source hardware wallet allow users to take full control of their assets with secure storage while keeping the private keys fully air-gapped and 100% offline.
TrustWallet Trust Wallet is a multi-chain self-custody cryptocurrency wallet and secure gateway to thousands of Web3 decentralized applications (dApps). Trust Wallet is already “trusted” and used by 60+ million people, and is the easiest way to store, send and receive digital assets, manage your NFT collection, explore DeFi, GameFi, and the metaverse.
SubWallet SubWallet is a wallet keen on achieving and protecting core values of Web3: Privacy and Self-custody. It is governed by an open source, self-custody paradigm and cold wallet support. They passed independent audits and integrated phishing prevention solutions such as Polkadot {.js} and ChainPatrol, protecting users from newly developed scams.
Bitget (formerly BitKeep) Bitget is the native wallet of a leading multi-chain ecosystem integrated with 90+ mainnets and serving 12 milion users that swap traded $8 billion so far. They support hardware, MPC, and other wallet types while employing cutting-edge security technology to provide users’ assets with multiple layers of protection and effectively guard against all threats.
Venom Wallet Venom Wallet is a non-custodial wallet and a browser in one. Purchase, send, spend, and trade your digital assets. You may send money to anybody, anywhere or log into websites to exchange assets, swap, bridge, etc.\ Your gateway to Web3 starts with the Venom Wallet. Our blockchain utilizes a Threaded Virtual Machine (TVM), which is a Turing complete virtual machine for smart contract execution. It is designed for infinite scalability with Dynamic Sharding.
SoFi SoFi is mobile banking made easy. If you’re interested in investing, you can get up to $1000 in free stock when you fund a SoFi Invest account. Their app enables you to pay bills, find ATMs, send money, make mobile deposits, invest in crypto assets and more.
OKX OKX is one of the most trusted cryptocurrency exchange apps in the world to buy Bitcoin (BTC), Ethereum (ETH), Ripple XRP, Tether USDT, WorldCoin (WLD), Wall Street Memes (WSM), Shiba Inu (SHIB), and other cryptos.\ \ Their wallet is available on all popular platforms such as mobile, web, desktop and Chrome extension.
Zerion Zerion allows users to manage their DeFi and NFT portfolios, trade across 10+ networks and connect to any decentralized application with one wallet. It helps track entire crypto portfolio across every wallet you own and manage all private keys and sign transactions in one place.
imToken imToken is a secure crypto and bitcoin wallet founded in 2016. It helps to securely manage thousands of tokens, watch DeFi balances grow, transfer NFTs, earn with Ethereum games, experience Layer2 and Eth2 staking. Plus DEX and DApp browsing in one place.
# MEV Cashback ### MEV Cashback: OMNIA Stops Bots and Returns Cash to Your Wallet OMNIA's MEV Cashback tool offers direct cashback on DEX transactions vulnerable to MEV. Instead of letting bots profit off your trades, OMNIA's technology intercepts and returns cash back to your wallets. Get more value from your DeFi activities. {% hint style="success" %} Get MEV Cashback on Ethereum, Binance, Polygon and many more. Plus, your transaction is protected from frontrunning attacks. {% endhint %} #### Don't leave money on the table With backrunning, unlike frontrunning, MEV money is **not** taken directly out of your pocket. The user's transaction goes through as intended, but the price shift has some significance than it allows arbitrage to take place. The user got exactly what they intended (their trade went through), but they unknowingly influenced the market. The searchers and builders have effectively extracted value (MEV) from the user's transaction, but the user may not realize this. ### What is MEV Maximal Extractable Value (MEV) is a measure of the profit usually a bot can make through their ability to arbitrarily include, exclude, or reorder transactions within the blocks they produce.\ \ The MEV landscape has evolved significantly over time. Initially, miners were the only ones who could extract MEV, as they were the ones building and proposing blocks. However, with the advent of new technologies and PoS protocols, the landscape has become more complex. ### MEV infrastructure consists of several key components 1. Public mempool This is where all pending transactions reside. Both regular transactions and those aiming to exploit MEV opportunities can be found here. The public mempool acts as a bucket where all the pending transactions stay 2. Searchers Bots or individuals that look for MEV opportunities in the public mempool. They create strategies and bundles of transactions that, if included in a block in a specific order, can generate profit. Searchers look into the public mempool to find opportunities for arbitrage or front-running. 3. Builders Receive bundles from searchers and assemble them into full blocks. They aim to construct a block that includes the most profitable set of transactions. The builders propose blocks and are part of the new architecture that Ethereum is trying to impose. 4. Relays The relay receives full block proposals from builders and selects the most profitable one to propose to the validator. The relay takes information from a builder who proposes blocks. 5. Validators The relay receives full block proposals from builders and selects the most profitable one to propose to the validator. The relay takes information from a builder who proposes blocks. # Frontrunning Protection Your DEX transactions will not be seen by hungry sandwich bots in the public mempool. ### What is Frontrunning Frontrunning refers to the act of capitalizing on advance knowledge of a trade that will affect an asset's price, aiming to secure a profit by trading ahead of that price movement. In essence, it's about gaining an unfair advantage over other traders. In traditional finance, such practices are deemed illegal and unethical. However, in the open blockchain ecosystem, frontrunning has unfortunately become a prevalent and multi-billion-dollar malpractice. Within the context of decentralized exchanges (DEXs) like Uniswap or Sushiswap, frontrunning happens when someone, often a bot, detects a pending transaction on the blockchain and quickly executes a trade before that transaction is processed. Since all transactions on a DEX are publicly recorded on the blockchain or public mempool, these bots can easily spot and exploit trades to their advantage. \ Use OMNIA's tool to check if you are a victim of frontrunning. {% embed url="" %} ### Omnia Frontrunning Blogs {% embed url="" %} {% embed url="" %} # Reinforced Transactions OMNIA acts as an intermediary between the user and the blockchain. This "reinforced transaction broadcast" is a key differentiator for OMNIA users. It ensures that even if a transaction has a low gas and dropped by nodes or is not seen as an MEV opportunity and does not receive a bid, it will still be broadcasted to the private or public mempool and have a chance to be included in a block. This prevents the user from experiencing a **"transaction not found"** error, which can occur if a transaction is only sent to the private mempool and does not receive a bid. {% hint style="success" %} As an RPC, it is our job to complete the transaction. {% endhint %} OMNIA's approach to addressing the needs of DeFi traders is twofold. If a transaction is not directly included in the mempool or blockchain or is being dropped, OMNIA ensures the transaction still gets processed through its “reinforced transaction” features and broadcasts the transaction to the private/public mempool and private venues until this gets included in the blockchain. This dual approach ensures that traders are covered for transaction completeness. OMNIA is integrated with dozens of OFAs (auction houses). If the auction house successfully monetizes the transaction, it sends a bundle to the block builder and the user receives a cashback in their wallet. If the auction house does not monetize the transaction, OMNIA broadcasts the transaction to the public/private mempool as a fallback (depending on user's choice). {% hint style="success" %} OMNIA makes sure you don't experience the "transaction not found" error when making RPC calls. We ensure our node is fully synced and not being overloaded with requests, plus we're making sure it's being included. {% endhint %} *This is one of OMNIA's guarantees and differentiators: we provide a reinforced transaction broadcast.* Other reasons "transaction not found" error typically arises when you're trying to retrieve information about a transaction that isn't recognized by the network. 1. **Transaction hasn't been mined yet.** When a transaction is submitted to the network, it doesn't get included in the blockchain immediately. It first enters the transaction pool (also known as mempool) where it waits to be picked up. If you query the transaction too quickly after it's been sent, it might not have been mined yet, and therefore might not exist in the blockchain. 2. **Transaction dropped from the transaction pool.** If the network becomes congested, the transaction pool might become full, and transactions with lower gas prices could get dropped. If your transaction gets dropped, it won't be retrievable until it's re-broadcasted to the network. 3. **Invalid transaction hash.** If you're looking up a transaction by its hash, ensure that the hash is correct. An invalid or mistyped hash will also return a "transaction not found" error.
# Honeypot Protection OMNIA's honeypot protection is designed to detect and monitor potential scam tokens.
1. **Smart Contract Auditing**: Before interacting with a smart contract, OMNIA performs an automated audit or analysis of the contract's code to look for common signs of scams. This could include checking for functions that prevent users from selling tokens or withdrawing their funds. 2. **Transaction Monitoring**: OMNIA monitors transactions on the network to identify suspicious activity. For example, if a new token is seeing a large number of buys but no sells, this could be a sign of a honeypot. 3. **User Warnings**: If a potential honeypot is detected, OMNIA can flag the service to warn users before they interact with it. This could be done through the user interface of the application. Users decides then what to do next. 4. **Integration with Security Tools**: OMNIA integrates with a variety of services that specialize in detecting honeypots and other types of scams. ## Honeypot warning When sending transactions to an OMNIA endpoint with Honeypot protection enabled, our services will perform a thorough security analysis on transaction details such as transaction data embedded in it's body and code of smart contracts called in the transaction.\ \ If a call to a known Honeypot smart contract is detected, the endpoint will return a **`HTTP 513`** response with an empty body and will drop the transaction (not forwarding it to the blockchain node). # Token Approval Protection OMNIA's Token Approval Protection secures DeFi traders' funds using our safe RPC Endpoints, halting transactions and providing real-time alerts against malicious tokens. ### What is the "approve" call in the Ethereum ecosystem? The "**approve**" function was firstly introduced in the Ethereum ecosystem by [the ERC-20 standard](https://eips.ethereum.org/EIPS/eip-20#approve) and is a pivotal mechanism that empowers token holders to delegate specific spending permissions to other addresses, referred to as "spenders." When a token holder (wallet user) initiates this function, they specify two crucial parameters: the address of the designated spender and the maximum number of tokens that the spender is permitted to transfer on their behalf.

ERC-20 function "approve" in Mastering Ethereum

### Approve use-cases One of the most common use cases is for decentralized exchanges (DEXs) like Uniswap and SushiSwap. When a user wants to provide liquidity or trade tokens on these platforms, they need to approve the DEX smart contract to spend a specific amount of tokens from their wallet. This approval ensures that the DEX can only access the approved amount of tokens and not the entire balance. Another common use case is in governance and staking protocols. Users approve smart contracts to manage their tokens for voting, delegating, or participating in governance decisions without transferring ownership. This function helps maintain security and control over users' assets while enabling various DeFi and DApp interactions on the Ethereum blockchain. Since then, the **approve** function was added to two additional standards: [ERC-721 (NFT)](https://ethereum.org/en/developers/docs/standards/tokens/erc-721/) and [ERC-1155 (Multi-token)](https://ethereum.org/en/developers/docs/standards/tokens/erc-1155/). For NFTs, the function allows the designated spender to transfer the specified token (NFT) on behalf of the owner. During the execution of the "**approve**" function, several critical checks are conducted to ensure the security and integrity of the transaction. Firstly, the smart contract governing the ERC-20 token verifies that the token holder has sufficient balance to cover the approved amount, preventing any overspending that could lead to an imbalance in the system. ### How does OMNIA protect you? Furthermore, security checks are carried out to scrutinize the spender's address for any involvement in malicious activities. This includes evaluating whether the spender's address has been linked to phishing attempts, blackmail, token theft, money laundering, or financial crimes. Additionally, the transaction checks whether the token in question has been associated with individuals or entities listed on the U.S. Office of Foreign Assets Control (OFAC) sanctions list, aiming to prevent any interactions with sanctioned entities. ### Critical Risks for DeFi Traders, mitigated by OMNIA Here's a brief summary of how each of these activities can affect a DeFi trader: * **Phishing**: Phishing attacks can trick traders into revealing sensitive information or private keys, leading to unauthorized access to their assets and potential loss of funds. * **Blackmail**: Blackmail schemes can coerce traders into making payments or sharing private information, putting their financial security at risk. * **Stealing**: Theft of tokens can result in a direct loss of assets, impacting a trader's portfolio and overall financial stability. * **Money Laundering**: Involvement with money laundering can lead to legal repercussions, potentially freezing or confiscating a trader's assets and restricting their ability to trade. * **Financial Crime**: Participation in financial crimes can also result in legal consequences and damage a trader's reputation within the cryptocurrency community. * **US OFAC International Sanctions**: Traders dealing with tokens associated with individuals or entities on the OFAC sanctions list may face legal issues, asset freezes, and difficulties in conducting transactions with certain counterparties, limiting their trading opportunities and financial freedom. These robust security measures surrounding the "approve" function not only protect token holders from potential misuse of their assets but also help maintain the integrity of the broader cryptocurrency ecosystem, promoting trust and safety for all participants in the DeFi trading space. ### Transaction halting and notification system In the event that any of these checks fail, the transaction is halted, and an HTTP 514 error is returned by the OMNIA RPC endpoint, signaling a potential security issue. A security notification is promptly dispatched to the relevant parties. To receive these critical security notifications, users are encouraged to configure their notification settings within our [Dashboard](https://app.omniatech.io/dashboard). ### Supported networks * Ethereum (ChainID 1) * Binance Smart Chain (ChainID 56) * Optimism (ChainID 10) * Polygon (ChainID 137) * Fantom (ChainID 250) * Avalanche: C-Chain (ChainID 43114) * Arbitrum (ChainID 42161) ### Types of protected assets * Fungible tokens as described by the ERC-20 standard * NFTs as described by the ERC-721 standard * Tokens (fungible and/or non-fungible) as described by the ERC-1155 standard # Security Policy {% hint style="info" %} TBA {% endhint %} # Comprehensive Security Event Detection (Notifications) This page describes the security events detected by OMNIA when analysing transactions made by our users in order to protect them from malicious activities. {% hint style="info" %} **NOTE:** This is an opt-in feature. OMNIA is committed to enhance and protect our users' privacy. {% endhint %} ## Address-Related Security Events #### MaliciousAddressEvent **Indicators:** * Blackmail activities * Stealing attacks * Malicious mining activities * Darkweb transactions * Cybercrime * Money laundering * Financial crime * Blacklist doubts * Mixer usage * Sanctioned addresses * Creation of malicious contracts **Reason:** To prevent interactions with sanctioned or malicious addresses, safeguarding both the user and our platform. #### ScamAddressEvent **Indicators:** * Phishing activities * Fake KYC attempts * Fake standard interfaces **Reason:** To avoid irreversible loss of funds by preventing transactions with scam-involved addresses. #### HackingActivityAddressEvent **Indicators:** * Honeypot-related addresses * Gas abuse * Reinitiation attacks **Reason:** To prevent potential irreversible loss of funds by avoiding interactions with compromised addresses. ## Smart Contract Security Events #### ClosedSourceContractEvent **Indicators:** Closed-source contracts **Reason:** To notify users post-transaction that complete security checks couldn't be applied due to closed-source nature, setting the default interaction as optimistic/permissive. #### SelfDestructContractEvent **Indicators:** Contracts with self-destruct capabilities **Reason:** To inform users of the risks associated with self-destruct functionalities, allowing interaction while acknowledging the potential for assets becoming unavailable. #### ProxyContractEvent **Indicators:** Proxy contracts **Reason:** To notify users post-transaction about the proxy nature of a contract, which can change behavior and make security checks inconsistent. ### Generic Calls #### ERC-20 Contracts **MaliciousOwnershipEvent**\ **Indicators:** * Ownership take-back capabilities * Owner balance alteration * Hidden owner **Reason:** To alert users post-transaction about the potential risks of contract ownership changes. **HackingActivityContractEvent**\ **Indicators:** * External calls with ownership take-back capabilities or hidden owner * Gas abuse **Reason:** To warn users before transaction about the risk of loss due to hacking activities. **ExternalCodeCallEvent**\ **Indicators:** External code calls **Reason:** To inform users post-transaction of the increased risk associated with external, non-audited code calls. **HoneypotContractEvent**\ **Indicators:** Honeypot behavior **Reason:** To prevent interactions with honeypot contracts that can lead to loss of funds. ### Trading-Related Security **RestrictedTradingEvent**\ **Indicators:** * Sell tax * Inability to sell all tokens * Modifiable slippage * Transfer pausability * Trading cooldown * Mintable contracts **Reason:** To notify users post-transaction about trading restrictions that could impact liquidity and token usability. ### Scam-Related Security **ScamTokenEvent**\ **Indicators:** * Airdrop scams * Cloning real tokens **Reason:** To prevent interactions with scam tokens that can lead to irreversible loss. **PotentialRugPullEvent**\ **Indicators:** * Privilege withdrawal * Missing withdrawal with blackhole owner **Reason:** To alert users post-transaction about potential rug pull risks, ensuring they are aware and cautious. ### ERC-721 & ERC-1155 Contracts **MaliciousNFTContractEvent**\ **Indicators:** * Malicious NFT contracts * Privileged burn by EOA * Oversupply minting **Reason:** To prevent interactions with malicious NFT contracts that can lead to immediate loss of assets. ### Scam-Related Security **ScamNFTEvent**\ **Indicators:** * Transfers without approval * Unverified or unfrozen metadata **Reason:** To avoid transactions with scam NFTs, protecting users from potential loss. ### Approval Calls #### MaliciousApprovalEvent **Indicators:** * Malicious address and behavior * Approval abuse **Reason:** To maintain the security of token approvals, ensuring users are protected from malicious approval schemes. # Have I been Frontrunned Tool Use OMNIA's tool to check if you've been frontrunned. {% embed url="" %}
{% embed url="" %} # Atomic Transaction In a decentralized ecosystem, executing multiple Ethereum transactions individually can expose users to various risks. A key challenge is that each transaction is processed in sequence, which could lead to potential vulnerabilities such as failed transactions, partial execution, or losing funds if one of the steps in a complex operation fails. Additionally, malicious actors can exploit **MEV (Miner Extractable Value)** opportunities, reordering or front-running transactions to extract value from users. For developers, managing multiple Ethereum transactions within dApps is often complex, with the need to ensure that every part of a multi-step process completes successfully. Failing to execute a transaction sequence atomically can leave applications in an incomplete or incorrect state. This introduces friction, increased costs, and a poor user experience. ## **What Are Atomic Transactions?** Atomic Transactions allow users to bundle multiple Ethereum transactions together and execute them as a single, inseparable unit. These transactions are submitted to our RPC endpoints within a specific time window. When the window closes, all bundled transactions are sent to the Ethereum RPC node and executed simultaneously. This means that either all transactions in the bundle succeed, or none do. This feature is ideal for use cases where multiple steps must occur in sequence (such as token swaps, approvals, or liquidity provisioning) and ensures that no part of the process can be left incomplete. With Atomic Transactions, you get all-or-nothing execution, safeguarding both funds and the integrity of the operation. ## **What Benefits Do You Get?** * **Funds Security**: With Atomic Transactions, users won’t lose their funds in case one of the transactions fails. If any transaction in the bundle encounters an issue (like insufficient gas or liquidity), none of the transactions will execute, keeping your assets safe. * **Cost Savings**: By bundling transactions, users can reduce the overall gas fees compared to sending multiple individual transactions. This bundling process optimizes gas usage, especially in complex operations involving multiple contract calls. * **Increased Efficiency**: Atomic Transactions streamline complex workflows, eliminating the need to track the success or failure of each transaction in a multi-step process. This saves both time and operational overhead. * **MEV Protection**: By executing all transactions together, the feature can help prevent miners or arbitrage bots from front-running or reordering your transactions for profit, reducing the risk of losing value to **MEV**. * **Convenience**: Developers and users can execute multiple actions with a single operation, simplifying the process and improving the overall user experience. No more manual monitoring of each step in the transaction flow. * **Ease of Use**: Atomic Transactions reduce complexity for developers, as they no longer need to worry about partial execution states or manually managing transaction sequences. Everything happens in one go, simplifying development and reducing potential errors. ## How to use it? Coming soon: Youtube Video on our channel # Chains # Bitcoin {% embed url="" %} # Ethereum ##
Custom JSON-RPC API/pages/IyqUXSOJM5wnKoPPPLaw
Standard JSON-RPC API/pages/GccMYyFyBNgNW7cbNQ7a
# Custom JSON-RPC API # omnia\_getAssetBalance **Returns a list of assets owned by the wallet, including token details and current balance. Receives up to 100 contract addresses used to check the balance of the wallet. If no contract addresses are provided, it will use OMNIA's list of most used contracts per chain.** **Parameters** 1. `DATA`, 20 Bytes - wallet. The wallet address that is checked for it's holdings. REQUIRED 2. `Array of DATA`, 20 Bytes - contracts. The contract addresses of the tokens for which the wallet is checked. **Beta version note:** The feature of not providing a `contracts` and relying solely on OMNIA's token contracts collection is still in beta, so you might experience some **Internal Server Error** responses. To avoid that, until the stable version is released, we recommend explicitly specifying token contract addresses in the `params`field of the request body. **Returns** `Array` - assets. Token holdings of the wallet address. Only tokens for which the balance is > 0 are returned. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_getAssetBalance", "params": [ { "wallet": "0xbBa591C7C9e8460B3EA2b6A9d8980b0237Fd42eC", "contracts": [ "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "0x4d224452801ACEd8B2F0aebE155379bb5D594381" ] } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": { "wallet": "0xbBa591C7C9e8460B3EA2b6A9d8980b0237Fd42eC", "assets": [ { "token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "balance": "1184434877401855", "symbol": "WETH", "decimals": 18 }, { "token": "0x4d224452801ACEd8B2F0aebE155379bb5D594381", "balance": "8990163329569654507", "symbol": "APE", "decimals": 18 } ] } } ``` # omnia\_checkTokenSecurity **Returns security details about the token smart contract. Focused on possible vulnerabilities of a smart contract, the security of the token from a trading standpoint and general info about liquidity, holders and creator.** **Parameters** `DATA`, 20 Bytes - contractAddress. The wallet address that is checked for it's holdings. REQUIRED **Returns** `Object with following details:` #### Smart contract security | Parameter | Description | Notice | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `is_open_source` | Returns "1" if the contract is open-source, "0" if the contract is closed-source. | Closed-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is closed-source, other risk items will return null. | | `is_proxy` |

Returns "1" if the contract is a proxy contract, "0" if the contract is not a proxy contract.
This value will not be returned if the proxy status of the contract is unknown.

|

(1) Will not be returned if "is\_open\_source" is 0.
(2) Most proxy contracts are accompanied by implementation contracts which are modifiable, potentially containing significant risk. When the contract is a proxy, other risk items may not be returned.

| | `is_mintable` |

Returns "1" if the contract has the ability to mint tokens, "0" if the contract does not have the ability to mint tokens.
This value will not be returned if the minting ability of the contract is unknown.

|

(1) Will not be returned if "is\_open\_source" is 0.
(2) May not be returned if "is\_proxy" is 1.
(3) Mint functions can trigger a massive sell-off, causing the coin price to plummet. It is an extremely risky function for a contract to have.
(4) This function generally relies on ownership. When the contract does not have an owner (or if the owner is a black hole address) and the owner cannot be retrieved, this function will most likely be disabled.

| | `owner_address` | This contract's owner address. No value will be returned if the owner address is unknown. An empty sting will be returned if the contract has no owner. |

(1) Will not be returned if "is\_open\_source" is 0.
(2) May not be returned if "is\_proxy" is 1.
(3) Ownership is usually used to adjust the parameters and status of the contract, such as minting, modification of slippage, suspension of trading, setting blacklist, etc. When the contract's owner cannot be retrieved, is a black hole address, or does not have an owner, ownership-related functionality will most likely be disabled.

| | `can_take_back_ownership` | Returns "1" if ownership can be reclaimed; "0" if it cannot. Will not be returned if reclamation data is unknown. |

(1) Will not be returned if "is\_open\_source" is 0.
(2) May not be returned if "is\_proxy" is 1.
(3) Ownership is usually used to adjust the parameters and status of the contract, such as minting, modification of slippage, suspension of trading, setting blacklist, etc. When the contract's owner cannot be retrieved, is a black hole address, or does not have an owner, ownership-related functionality will most likely be disabled. These risky functions may be able to be reactivated if ownership is reclaimed.

| | `owner_change_balance` | Returns "1" if the contract owner can change token holder balances; "0" if it cannot. Will not be returned if reclamation data is unknown. |

(1) Will not be returned if "is\_open\_source" is 0.
(2) May not be returned if "is\_proxy" is 1.
(3) Tokens with this feature allow the owner to modify anyone's balance, resulting in a holder's asset to be changed (i.e. to 0) or a massive minting and sell-off.
(4) This function generally relies on ownership. When the contract's owner cannot be retrieved, is a black hole address, or does not have an owner, ownership-related functionality will most likely be disabled.

| | `hidden_owner` |

Returns "1" if the contract has hidden owners;
"0" if it does not.
Will not be returned if hidden ownership status is unknown.

|

(1) Will not be returned if "is\_open\_source" is 0.
(2) May not be returned if "is\_proxy" is 1.
(3) Hidden ownership is used by developers to maintain ownership ability even after abandoning ownership, and is often an indicator of malicious intent. When a hidden owner exists, it is safe to assume that ownership has not been abandoned.

| | `selfdestruct` |

Returns "1" if the contract can self-destruct;
"0" if it cannot.
Will not be returned if self-destruct data is unknown.

|

(1) Will not be returned if "is\_open\_source" is 0.
(2) When the self-destruct function is triggered, the contract will be destroyed, all of its functions will be unavailable, and all related assets will be erased.

| | `external_call` |

Returns "1" if the contract can call functions in other contracts during the execution of primary methods;
"0" if it does not.
Will not be returned if external call capability is unknown.

|

(1) Will return no data if "is\_open\_source" is 0.
(2) External calls causes the implementation of this contract to be dependent on other external contracts which may or may not be risky.

| | `gas_abuse` |

Return "1" if the contract is using user's gas fee to mint other assets.
No return means no evidence of gas abuse.

| Any interaction with such addresses may result in loss of property. | #### Token trading security | Parameter | Description | Notice | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `is_in_dex` | Returns "1" if the token can be traded in a decentralized exchange; "0" if not. | Only true if the token has a marketing pair with mainstream coins/tokens. | | `buy_tax` | Returns the buy tax of the token on a scale from 0 - 1. An empty string ("") means that the tax is unknown. |

(1) Will not be returned if "is\_in\_dex" is 0.
(2) When buying a token, a buy tax will cause the actual token value received to be less than the amount paid. An excessive buy tax may lead to heavy losses.
(3) A "buy\_tax" of "1", or a 100% buy tax, will result in all purchase funds to go towards the tax. This results in a token that is effectively not able to be purchased.
(4) A token's anti-bot mechanism may affect our sandbox environment, resulting in a "cannot\_buy" of "1". This will cause the "buy\_tax" to also return "1".
(5) Some tokens are designed not to be sold, indicated by the "cannot\_buy" to return "1". A "cannot\_buy" of "1" will cause the display of "buy\_tax" to also be "1".

| | `sell_tax` | It describes the tax when selling the token. An empty string ("") means unknown. |

(1) When "is\_in\_dex": "0", there will be no return.
(2) Sell tax will cause the actual value received when selling a token to be less than expected, and too much buy tax may lead to large losses.
(3) When "sell\_tax": "1", it means sell-tax is 100% or this token cannot be sold.
(4) Sometimes token's trading-cool-down mechanism would affect our sandbox system. When "trading\_cooldown": "1", "sell\_tax" may return "1".

| | `cannot_buy` | It describes whether the Token can be bought. "1" means true; "0" means false; No return means unknown. |

(1) Generally, "cannot\_buy": "1" would be found in Reward Tokens. Such Tokens are issued as rewards for some on-chain applications and cannot be bought directly by users.
(2) Sometimes token's anti-bot mechanism would affect our sandbox system, causing the display of "buy\_tax": "1".
(3) When “cannot\_buy”: "1", our sandbox system might be blocked, causing the display of "buy\_tax": "1" and "sell\_tax": "1"

| | `cannot_sell_all` | It describes whether the contract has the function restricting the token holders from selling all the tokens. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_in\_dex": "0", there will be no return.
(2) This feature means that you will not be able to sell all your tokens in a single sale. Sometimes you need to leave a certain percentage of the token, e.g. 10%, sometimes you need to leave a fixed number of tokens, such as 10 tokens.
(3) When "buy\_tax": "1", there will be no return.

| | `slippage_modifiable` | It describes whether the trading tax can be modifiable by token contract. "1" means true; "0" means false; No return means unknown. |

(1) When When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.
(3) Token with modifiable tax means that the contract owner can modify the buy tax or sell tax of the token. This may cause some losses, especially since some contracts have unlimited modifiable tax rates, which would make the token untradeable.
(4) This function generally relies on ownership. When the contract does not have an owner (or if the owner is a black hole address) and the owner cannot be retrieved, this function will most likely be disabled.

| | `is_honeypot` | It describes whether the token is a honeypot. "HoneyPot" means that the token maybe cannot be sold because of the token contract's function, or the token contains malicious code. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.
(3) High risk, definitely scam.

| | `transfer_pausable` | It describes whether trading can be pausable by token contract. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.
(3) This feature means that the contract owner will be able to suspend trading at any time, after that anyone will not be able to sell, except those who have special authority.
(4) This function generally relies on ownership. When the contract does not have an owner (or if the owner is a black hole address) and the owner cannot be retrieved, this function will most likely be disabled.

| | `is_blacklisted` | It describes whether the blacklist function is not included in the contract. If there is a blacklist, some addresses may not be able to trade normally. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.
(3) The contract owner may add any address to the blacklist, and the token holder in the blacklist will not be able to trade. Abuse of the blacklist function will lead to great risks.
(4) For contracts without an owner (or the owner is a black hole address), the blacklist will not be able to get updated. However, the existing blacklist is still in effect.

| | `is_whitelisted` | It describes whether the whitelist function is not included in the contract. If there is a whitelist, some addresses may not be able to trade normally. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.
(3) Whitelisting is mostly used to allow specific addresses to make early transactions, tax-free, and not affected by transaction suspension.
(4) For contracts without an owner (or the owner is a black hole address), the whitelist will not be able to get updated. However, the existing whitelist is still in effect.

| | `dex` | It describes Dex's information on where the token can be traded. |

(1) When "is\_in\_dex": "0", there will be an empty array.
(2) It only counts when the token has a marketing pair with mainstream coins/tokens.
(3) Liquidity is converted to USDT denomination.

| | `is_anti_whale` | It describes whether the contract has the function to limit the maximum amount of transactions or the maximum token position for a single address. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.

| | `anti_whale_modifiable` | It describes whether the contract has the function to modify the maximum amount of transactions or the maximum token position. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.
(3)When the anti-whale value is set to a very small value, all trading would fail.

| | `trading_cooldown` | It describes whether the contract has a trading-cool-down mechanism that can limit the minimum time between two transactions. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.

| | `personal_slippage_modifiable` | It describes whether the owner can set a different tax rate for every assigned address. "1" means true; "0" means false; No return means unknown. |

(1) When "is\_open\_source": "0", there will be no return.
(2) Sometimes, when "is\_proxy": "1", there will be no return.
(3) The contract owner may set a very outrageous tax rate for an assigned address to block it from trading. Abuse of this function will lead to great risks.
(4) For contracts without an owner (or the owner is a black hole address), this function would not be able to be used. However, the existing tax rate would be still in effect.

| #### Token information security | Parameter | Description | Notice | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `token_name` | | | | `token_symbol` | | | | `holder_count` | It describes the number of token holders. Example:`"holder_count": "4342"` | | | `total_supply` | It describes the supply number of the token. Example:`"total_supply": 100000000` | | | `holders` |

It describes the top 10 holders' info. The info includes:
(1) "address" describes the holder's address; (2) "locked." describes whether the tokens owned by the holder are locked "1" means true; "0" means false;
(3) "tag" describes the address's public tag. Example: Burn Address/Deployer;
(4) "is\_contract" describes whether the holder is a contract "1" means true; "0" means false;
(5) "balance" describes the balance of the holder.
(6) "percent" describes the percentage of tokens held by this holder;
(7) "locked\_detail" is an array, that describes the lock position info of this holder, and only shows when "locked": 1. This Array may contain multiple objects for multiple locking info. In every object, "amount" describes the number of tokens locked, "end\_time" describes when the token will be unlocked, and "opt\_time" describes when the token was locked.

|

(1) About "locked": We only support the token lock addresses or black hole addresses that we have included.
(2) When "locked":0, or lock address is a black hole address, "locked\_detail" will be no return.
(3) About "percent": 1 means 100% here.

| | `owner_balance` |

It describes the balance of the contract owner.
Example:"owner\_balance": 100000000
No return or return empty means there is no ownership or can't find ownership.

| When "owner\_address" returns empty, or no return, there will be no return. | | `owner_percent` |

It describes the percentage of tokens held by the contract owner.
Example: "owner\_balance": "0.1".
No return or return empty means there is no ownership or can't find ownership.

|

(1) 1 means 100% here.
(2) When "owner\_address" returns empty, or no return, there will be no return.

| | `creator_address` | It describes this contract's owner address. | | | `creator_balance` | It describes the balance of the contract owner. Example:`"owner_balance": 100000000`. | | | `creator_percent` | It describes the percentage of tokens held by the contract owner. Example:`"owner_balance": 0.1`. | 1 means 100% here. | | `lp_holder_count` |

It describes the number of LP token holders.
Example: "lp\_holder\_count": "4342".
No return means no LP.

| When "is\_in\_dex": "0", there will be no return. | | `lp_total_supply` |

It describes the supply number of the LP token.
Example: "lp\_total\_supply": "100000000".
No return means no LP.

|

(1) When "is\_in\_dex": "0", there will be no return.
(2) It is LP token number, NOT a token number

| | `lp_holders` |

It describes the top 10 LP holders' info. The info includes:
(1) "address" describes the holder's address;
(2) "locked" describes whether the tokens owned by the holder are locked. "1" means true; "0" means false;
(3) “tag” describes the address's public tag. Example: Burn Address/Deployer;
(4) “is\_contract” describes whether the holder is a contract "1" means true; "0" means false.
(5) “balance” describes the balance of the holder.
(6) "percent" describes the percentage of tokens held by this holder
(7) "locked\_detail" is an array, that describes the lock position info of this holder, and only shows when "locked": "1". This Array may contain multiple objects for multiple locking info. In every object, "amount" describes the number of tokens locked, "end\_time" describes when the token will be unlocked, and "opt\_time" describes when the token was locked.
No return means no LP.

|

(1) When "is\_in\_dex": "0", there will be no return.
(2) About "locked": We only support the token lock addresses or black hole addresses that we have included.
(3) About "percent": 1 means 100% here.
(4) When "locked": "0", or the lock address is a black hole address, "locked\_detail" will be no return.

| | `is_true_token` | It describes whether the token is true or fake. "1" means true token; "0" means fake token; None means no result (Because we did not find decisive information about the truth or falsity) | Only "is\_true\_token": "0" means it is a fake token. | | `is_airdrop_scam` | It describes whether the token is an airdrop scam. "1" means true; "0" means false; None means no result (Because We did not find conclusive information on whether the token is an airdrop scam). | Only "is\_airdrop\_scam": "1" means it is an airdrop scam. | | `trust_list` | It describes whether the token is a famous and trustworthy one. "1" means true; No return no result (Because We did not find conclusive information on whether the token is an airdrop scam). | (1) Only "trust\_list": "1" means it is a famous and trustworthy token. (2) No return doesn't mean it is risky. | | `other_potential_risks` | It describes whether the contract has other potential risks. Example: "other\_potential\_risks": "Owner can set different transaction taxes for each user, which can trigger serious losses." |

(1) If we haven't found any other potential risk yet, there will be no return.
(2) Type: string.

| | `note` | It describes whether the contract has other things investors need to know. Example: "note": "Contract owner is a multisign contract." |

(1) If we haven't found any other thing which is valuable yet, there will be no return.
(2) Type: string.

| ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_checkTokenSecurity", "params": [ { "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7" } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": { "0xdac17f958d2ee523a2206206994597c13d831ec7": { "anti_whale_modifiable": "0", "buy_tax": "0", "can_take_back_ownership": "0", "cannot_buy": "0", "cannot_sell_all": "0", "creator_address": "0x36928500bc1dcd7af6a2b4008875cc336b927d57", "creator_balance": "592.01", "creator_percent": "0.000000", "dex": [ { "name": "UniswapV3", "liquidity": "121353634.2854768255922326298923373", "pair": "0x4e68ccd3e89f51c3074ca5072bbac773960dfa36" }, { "name": "UniswapV3", "liquidity": "88684903.78449084946997178539622143", "pair": "0x11b815efb8f581194ae79006d24e0d814b7697f6" }, { "name": "UniswapV3", "liquidity": "78186131.82040599999999999999999999", "pair": "0x3416cf6c708da44db2624d63ea0aaef7113527c6" }, { "name": "UniswapV2", "liquidity": "29869433.39352680", "pair": "0x0d4a11d5eeaac28ec3f61d100daf4d40471f1852" }, { "name": "UniswapV2", "liquidity": "10898104.61920500", "pair": "0x3041cbd36888becc7bbcbc0045e3b1f144466f5f" }, { "name": "SushiSwapV2", "liquidity": "8785968.68980473", "pair": "0x06da0fd433c1a5d7a4faa01111c044910a184553" }, { "name": "UniswapV2", "liquidity": "40064.85490565", "pair": "0xb20bd5d04be54f870d5c0d3ca85d82b34b836405" }, { "name": "UniswapV2", "liquidity": "2304.67449171", "pair": "0x5ac13261c181a9c3938bfe1b649e65d10f98566b" }, { "name": "SushiSwapV2", "liquidity": "919.48019000", "pair": "0xd86a120a06255df8d4e2248ab04d4267e23adfaa" }, { "name": "SushiSwapV2", "liquidity": "531.28008229", "pair": "0x680a025da7b1be2c204d7745e809919bce074026" }, { "name": "SushiSwapV2", "liquidity": "189.24568912", "pair": "0x055cedfe14bce33f985c41d9a1934b7654611aac" }, { "name": "UniswapV2", "liquidity": "45.67705772", "pair": "0xe3ffab89e53422f468be955e7011932efe80aa26" }, { "name": "SushiSwapV2", "liquidity": "6.95706147", "pair": "0x8b79c78f7aa289a7e9bde311a21ffdba4ab493e3" } ], "external_call": "1", "hidden_owner": "0", "holder_count": "4533111", "holders": [ { "address": "0xf977814e90da44bfa03b6295a0616a897441acec", "tag": "", "is_contract": 0, "balance": "2741694580.187", "percent": "0.070251316723613879", "is_locked": 0 }, { "address": "0x47ac0fb4f2d84898e4d9e7b4dab3c24507a6d503", "tag": "", "is_contract": 0, "balance": "1220000115.495224", "percent": "0.031260452982569192", "is_locked": 0 }, { "address": "0xa7a93fd0a276fc1c0197a5b5623ed117786eed06", "tag": "", "is_contract": 1, "balance": "1006676309.532571", "percent": "0.025794388904656133", "is_locked": 0 }, { "address": "0xcee284f754e854890e311e3280b767f80797180d", "tag": "", "is_contract": 1, "balance": "680125441.408795", "percent": "0.017427071615299356", "is_locked": 0 }, { "address": "0x5754284f345afc66a98fbb0a0afe71e0f007b949", "tag": "", "is_contract": 0, "balance": "572560196.323196", "percent": "0.014670892952814579", "is_locked": 0 }, { "address": "0xd6216fc19db775df9774a6e33526131da7d19a2c", "tag": "", "is_contract": 0, "balance": "552404534.348583", "percent": "0.014154437982452395", "is_locked": 0 }, { "address": "0x40ec5b33f54e0e8a33a975908c5ba1c14e5bbbdf", "tag": "", "is_contract": 1, "balance": "438448917.195829", "percent": "0.011234516773545536", "is_locked": 0 }, { "address": "0x3cc936b795a188f0e246cbb2d74c5bd190aecf18", "tag": "", "is_contract": 0, "balance": "378391577.599446", "percent": "0.009695648361267692", "is_locked": 0 }, { "address": "0xc5451b523d5fffe1351337a221688a62806ad91a", "tag": "", "is_contract": 0, "balance": "300000101.01", "percent": "0.007686998495555328", "is_locked": 0 }, { "address": "0x6fb624b48d9299674022a23d92515e76ba880113", "tag": "", "is_contract": 0, "balance": "300000021.01", "percent": "0.007686996445689752", "is_locked": 0 } ], "honeypot_with_same_creator": "3", "is_anti_whale": "0", "is_blacklisted": "1", "is_honeypot": "0", "is_in_dex": "1", "is_mintable": "1", "is_open_source": "1", "is_proxy": "0", "is_whitelisted": "0", "lp_holder_count": "2580", "lp_holders": [ { "address": "0x9e5405df8a23fa331b8e9c00f39e9b39860bfee4", "tag": "", "is_contract": 0, "balance": "0.190855066915162277", "percent": "0.611670191023440192", "is_locked": 0 }, { "address": "0xd7a51ff8357c210d11499e251b2849d1bb35cbc2", "tag": "", "is_contract": 0, "balance": "0.026735221175764617", "percent": "0.085683540437011625", "is_locked": 0 }, { "address": "0x069d2a5d415894b74c80650a5d67f09e28282b9d", "tag": "", "is_contract": 0, "balance": "0.020327557887362157", "percent": "0.065147661086356319", "is_locked": 0 }, { "address": "0xd916127b40e3383fcc09ab8feaae0f2a6a1300c1", "tag": "", "is_contract": 0, "balance": "0.009332185275495837", "percent": "0.029908661281002600", "is_locked": 0 }, { "address": "0xcc4ea98876f3ee733712ac64137c34e637fc2dae", "tag": "", "is_contract": 0, "balance": "0.007047620804507465", "percent": "0.022586875126925875", "is_locked": 0 }, { "address": "0x5db53185393e3ccacd4bb95733c012ae292758d7", "tag": "", "is_contract": 1, "balance": "0.006552721608886416", "percent": "0.021000775840091457", "is_locked": 0 }, { "address": "0x95f0323bc1efefff9aff3679d2613027f1a263ec", "tag": "", "is_contract": 1, "balance": "0.006370079562330457", "percent": "0.020415427505821374", "is_locked": 0 }, { "address": "0xe114011f16c21ed91b6ae3d3f6433f57bbd6a04f", "tag": "", "is_contract": 0, "balance": "0.004762299208426745", "percent": "0.015262662467452408", "is_locked": 0 }, { "address": "0xfd18d8638c1659b602905c29c0bc0e93c6d2426c", "tag": "", "is_contract": 0, "balance": "0.003625952593339222", "percent": "0.011620792422532967", "is_locked": 0 }, { "address": "0x6c3e4cb2e96b01f4b866965a91ed4437839a121a", "tag": "", "is_contract": 1, "balance": "0.003016134648695324", "percent": "0.009666390767293383", "is_locked": 0 } ], "lp_total_supply": "0.312022834717228196", "owner_address": "0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828", "owner_balance": "108983.76699", "owner_change_balance": "1", "owner_percent": "0.000003", "personal_slippage_modifiable": "0", "selfdestruct": "0", "sell_tax": "0.0001", "slippage_modifiable": "0", "token_name": "Tether USD", "token_symbol": "USDT", "total_supply": "39026949359.163005", "trading_cooldown": "0", "transfer_pausable": "1", "trust_list": "1" } } } ``` # omnia\_checkApproval **Returns security details about the smart contracts for which the `address` issued ERC-20 approvals. Uses a proprietary, up-to-date collection of smart contracts. Can look for approvals issued for ERC-20/ERC-721/ERC-1155 tokens.** **Parameters** 1. `DATA`, 20 Bytes - address. The wallet address that is checked. REQUIRED 2. `DATA, ["erc20" || "erc721" || "erc1155"]` - contractType. The type of contracts for which the wallet address called the ERC-20 approval method. REQUIRED **Returns** `Object with following details:` ## ERC-20 Token Approval Security API | Parameter | Description | Notice | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `token_address` | It describes the token contract address which is approved. | | | `chain_id` | The chain\_id of the blockchain. "1" means Ethereum; "56" means BSC. | | | `token_name` | token\_name | | | `token_symbol` | token\_symbol | | | `decimals` | It describes the token precision. | | | `balance` | It describes the token balance of the address. | The type of return value is string. | | `is_open_source` |

It describes whether this contract is open source.
"1" means true;
"0" means false.

| Un-open-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is not open source, we will not be able to detect other risk items. | | `malicious_address` |

It describes whether this token has performed malicious behaviors.
"1" means true;
"0" means false.

| Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with tokens flagged as Malicious may contain a high level of risk. | | `malicious_behavior:[]` |

It describes specific malicious behaviors.
"honeypot\_related\_address" means that the address is related to honeypot tokens or has created scam tokens.
"phishing\_activities" means that this address has implemented phishing activities.
"blackmail\_activities" means that this address has implemented blackmail activities.
"stealing\_attack" means that this address has implemented stealing attacks.
"fake\_kyc" means that this address is involved in fake KYC.
"malicious\_mining\_activities" means that this address is involved in malicious mining activities.
"darkweb\_transactions" means that this address is involved in darkweb transactions.
"cybercrime" means that this address is involved in cybercrime.
"money\_laundering" means that this address is involved in money laundering.
"financial\_crime" means that this address is involved in financial crime.
"blacklist\_doubt" means that the address is suspected of malicious behavior and is therefore blacklisted.
"mixer" means this address is coin mixer address.
"sanctioned" means this address is sanctioned.
"gas\_abuse" means this address is cheating other user's gas fee to mint other assets.
"reinit" means this address/contract has been deployed more than onces, and can be deployed again.
"fake\_standard\_interface" means this contract contains standard interfaces that do not conform the requirements of the standard protocol.

| Returning **an empty array** means that no malicious behavior was found at that address. | | `approved_contract` | It describes the approved contract. | | | `initial_approval_time` | It describes when is the first time owner approved allowance to the spender. **The value is a timestamp.** | | | `initial_approval_hash` | It describes the initially approved allowance hash of the contract. | | | `approved_time` | It describes the latest allowance changing time of the contract. **The value is a timestamp.** | | | `hash` | It describes the latest allowance changing hash of the contract. | | | `approved_amount` | It describes the approved amount of the contract. | The type of return value is string. | | `"address_info": {"contract_name": , "tag": , "is_contract": , "is_open_source": , "trust_list": , "doubt_list": , "malicious_behavior":[], "creator_address": "", "deployed_time": ,}` | It describes the approved contract info. The info includes: (1) "contract\_name" describes the approved contract name. (2) "tag" describes which dApp uses the contract. Example: "tag": "Compound". (3) "is\_contract" describes whether the address is a contract. "1" means true; "0" means false. (4) "is\_open\_source" describes whether this contract is open source. "1" means true; "0" means false. (5) "trust\_list" describes whether the address is a famous and trustworthy one. "1" means true; "0" means that we have not included this address in the trusted list. (6) "doubt\_list" describes whether the address is a suspected malicious contract. "1" means true; "0" means that we have not found malicious behavior of this address. (7)"malicious\_behavior" describes specific malicious behaviors. (8) "creator\_address" describes the creator address of the contract. (9) "deployed\_time" describes the deployed time of the contract. **The value is presented as a timestamp**. | When the address is not a contract ("is\_contract"=0), "contract\_name", "creator\_address", and "deployed\_time" will return "null". When no malicious behavior was found at that address, "malicious\_behavior" will return **an empty array**. | ## ERC721 NFT Approval Security API | Parameter | Description | Notice | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `nft_address` | It describes the NFT contract address which is approved. | | | `chain_id` | The chain\_id of the blockchain. "1" means Ethereum; "56" means BSC. | | | `nft_name` | NFT name | | | `nft_symbol` | NFT symbol | | | `is_open_source` |

It describes whether this contract is open source.
"1" means true;
"0" means false.

| Un-open-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is not open source, we will not be able to detect other risk items. | | `is_verified` | It describes whether the NFT is verified. "1" means that the NFT is verified; "0" means that we did not find any information about whether the NFT is verified. | | | `malicious_address` |

It describes whether this token has performed malicious behaviors. "1" means true;
"0" means false.

| Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with tokens flagged as Malicious may contain a high level of risk. | | `malicious_behavior:[]` |

It describes specific malicious behaviors.
"honeypot\_related\_address" means that the address is related to honeypot tokens or has created scam tokens.
"phishing\_activities" means that this address has implemented phishing activities.
"blackmail\_activities" means that this address has implemented blackmail activities.
"stealing\_attack" means that this address has implemented stealing attacks.
"fake\_kyc" means that this address is involved in fake KYC.
"malicious\_mining\_activities" means that this address is involved in malicious mining activities.
"darkweb\_transactions" means that this address is involved in dark web transactions.
"cybercrime" means that this address is involved in cybercrime.
"money\_laundering" means that this address is involved in money laundering.
"financial\_crime" means that this address is involved in financial crime.
"blacklist\_doubt" means that the address is suspected of malicious behavior and is therefore blacklisted

| Returning **an empty array** means that no malicious behavior was found at that address. | | `approved_contract` | It describes the approved contract. | | | `initial_approval_time` | It describes when the first time owner approved allowance to the spender. **The value is a timestamp.** | | | `initial_approval_hash` | It describes the initially approved allowance hash of the contract. | | | `approved_time` | It describes the latest allowance changing time of the contract. **The value is a timestamp.** | | | `hash` | It describes the latest allowance changing hash of the contract. | | | `approved_for_all` | It describes the type approved. "1" means "approved for all"; "0" means "approved for single NFT". | The type of return value is bool. Note: Only the ERC721 NFTs have the two types of approved for all /approved for single. The ERC1155 NFTs have only one type - approved for all. | | `approved_token_id` | It describes the token\_id of the approved NFT if the approved type is "approved for single". | When the approved type is "approved for all" ("approved\_for\_all"=1), it will return "null". | | `"address_info": {"contract_name": , "tag": , "is_contract": , "is_open_source": , "trust_list": , "doubt_list": , "malicious_behavior":[], "creator_address": "", "deployed_time": ,}` |

It describes the approved contract info.
The info includes:
(1) "contract\_name" describes the approved contract name.
(2) "tag" describes which dApp uses the contract.
Example: "tag": "Compound".
(3) "is\_contract" describes whether the address is a contract.
"1" means true;
"0" means false.
(4) "is\_open\_source" describes whether this contract is open source.
"1" means true;
"0" means false.
(5) "trust\_list" describes whether the address is a famous and trustworthy one.
"1" means true;
"0" means that we have not included this address in the trusted list.
(6) "doubt\_list" describes whether the address is a suspected malicious contract.
"1" means true;
"0" means that we have not found malicious behavior of this address.
(7)"malicious\_behavior" describes specific malicious behaviors.
(8) "creator\_address" describes the creator address of the contract.
(9) "deployed\_time" describes the deployed time of the contract.
The value is presented as a timestamp.

|

When the address is not a contract ("is\_contract"=0), "contract\_name", "creator\_address", and "deployed\_time" will return "null".

When no malicious behavior was found at that address, "malicious\_behavior" will return an empty array.

| ## ERC1155 NFT Approval Security API | Parameter | Description | Notice | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `nft_address` | It describes the NFT contract address which is approved. | | | `chain_id` | The chain\_id of the blockchain. "1" means Ethereum; "56" means BSC. | | | `nft_name` | NFT name | | | `nft_symbol` | NFT symbol | | | `is_open_source` |

It describes whether this contract is open source. "1" means true;
"0" means false.

| Un-open-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is not open source, we will not be able to detect other risk items. | | `is_verified` |

It describes whether the NFT is verified.
"1" means that the NFT is verified;
"0" means that we did not find any information about whether the NFT is verified.

| | | `malicious_address` |

It describes whether this token has performed malicious behaviors.
"1" means true;
"0" means false.

| Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with tokens flagged as Malicious may contain a high level of risk. | | `malicious_behavior:[]` |

It describes specific malicious behaviors.
"honeypot\_related\_address" means that the address is related to honeypot tokens or has created scam tokens.
"phishing\_activities" means that this address has implemented phishing activities.
"blackmail\_activities" means that this address has implemented blackmail activities.
"stealing\_attack" means that this address has implemented stealing attacks.
"fake\_kyc" means that this address is involved in fake KYC.
"malicious\_mining\_activities" means that this address is involved in malicious mining activities.
"darkweb\_transactions" means that this address is involved in dark web transactions.
"cybercrime" means that this address is involved in cybercrime.
"money\_laundering" means that this address is involved in money laundering.
"financial\_crime" means that this address is involved in financial crime.
"blacklist\_doubt" means that the address is suspected of malicious behavior and is therefore blacklisted

| Returning **an empty array** means that no malicious behavior was found at that address. | | `approved_contract` | It describes the approved contract. | | | `initial_approval_time` | It describes when the first time owner approved allowance to the spender. **The value is a timestamp.** | | | `initial_approval_hash` | It describes the initially approved allowance hash of the contract. | | | `approved_time` | It describes the latest allowance changing time of the contract. **The value is a timestamp.** | | | `hash` | It describes the latest allowance changing hash of the contract. | | | `"address_info": {"contract_name": , "tag": , "is_contract": , "is_open_source": , "trust_list": , "doubt_list": , "malicious_behavior":[], "creator_address": "", "deployed_time": ,}` |

It describes the approved contract info.
The info includes:
(1) "contract\_name" describes the approved contract name.
(2) "tag" describes which dApp uses the contract.
Example: "tag": "Compound".
(3) "is\_contract" describes whether the address is a contract.
"1" means true;
"0" means false.
(4) "is\_open\_source" describes whether this contract is open source.
"1" means true;
"0" means false.
(5) "trust\_list" describes whether the address is a famous and trustworthy one.
"1" means true;
"0" means that we have not included this address in the trusted list.
(6) "doubt\_list" describes whether the address is a suspected malicious contract.
"1" means true;
"0" means that we have not found malicious behavior of this address.
(7)"malicious\_behavior" describes specific malicious behaviors.
(8) "creator\_address" describes the creator address of the contract.
(9) "deployed\_time" describes the deployed time of the contract.
The value is presented as a timestamp.

|

When the address is not a contract ("is\_contract"=0), "contract\_name", "creator\_address", and "deployed\_time" will return "null".

When no malicious behavior was found at that address, "malicious\_behavior" will return an empty array.

| ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_checkApproval", "params": [ { "address": "0x684e1225fd9085582e061FF5154413be3C7EC9DF", "contractType": "erc20" } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": [ { "token_address": "0x4d224452801aced8b2f0aebe155379bb5d594381", "chain_id": "1", "token_name": "ApeCoin", "token_symbol": "APE", "decimals": 18, "balance": "409.99999999999999999", "is_open_source": 1, "malicious_address": 0, "malicious_behavior": [], "approved_list": [ { "token_address": "0xadf0ac3059400edfb6131b9fe65feea6ca83ad76", "chain_id": "1", "token_name": "SHELL", "token_symbol": "SHELL", "decimals": 18, "balance": "7511.292673611111111109", "is_open_source": 1, "malicious_address": 0, "malicious_behavior": [], "approved_list": [ { "approved_contract": "0x6576cfc5b0be296ed30d436c178d17cb59a4a3cd", "approved_amount": "Unlimited", "approved_time": 1662409086, "initial_approval_time": 1662409057, "initial_approval_hash": "0x5d683d9267bbb12de1467e5a22dc706b5c7b851e89e35928a2bf6a40ab37f588", "hash": "0x8974cfcb4d374aa9a6d14fa35086548012dea1ee8dc091b342e2b166d5b8ff41", "address_info": { "contract_name": "CitizensInventory", "tag": null, "creator_address": "0xdcfbfc012a914758c4b62527a2770527b3279826", "is_contract": 1, "doubt_list": 0, "malicious_behavior": [], "deployed_time": 1662408079, "trust_list": 0, "is_open_source": 1 } } ] }, { "token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "chain_id": "1", "token_name": "Wrapped Ether", "token_symbol": "WETH", "decimals": 18, "balance": "0.006", "is_open_source": 1, "malicious_address": 0, "malicious_behavior": [], "approved_list": [ { "approved_contract": "0x1e0049783f008a0085193e00003d00cd54003c71", "approved_amount": "Unlimited", "approved_time": 1671891851, "initial_approval_time": 1671891851, "initial_approval_hash": "0xe981c78057fbf7d31cac15073e221715d8e47ee75c022671432f39ebd9383bea", "hash": "0xe981c78057fbf7d31cac15073e221715d8e47ee75c022671432f39ebd9383bea", "address_info": { "contract_name": "Conduit", "tag": "OpenSea", "creator_address": "0x939c8d89ebc11fa45e576215e2353673ad0ba18a", "is_contract": 1, "doubt_list": 0, "malicious_behavior": [], "deployed_time": 1654994918, "trust_list": 1, "is_open_source": 1 } } ] }, { "token_address": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0", "chain_id": "1", "token_name": "Matic Token", "token_symbol": "MATIC", "decimals": 18, "balance": "0", "is_open_source": 1, "malicious_address": 0, "malicious_behavior": [], "approved_list": [ { "approved_contract": "0x401f6c983ea34274ec46f84d70b31c151321188b", "approved_amount": "Unlimited", "approved_time": 1666041575, "initial_approval_time": 1666041047, "initial_approval_hash": "0xdbd542db25a0de4a610cbcee2cbf769e8ef1c1ba0a0a0cee33ef6da951738cd4", "hash": "0xb719e8cff686b25cf882a8e540586ccc66c0ed0342c67bcb55654aaabd22c282", "address_info": { "contract_name": "DepositManagerProxy", "tag": null, "creator_address": "0xa2d9846c352ca61dcb20d6aad40cec1d1b228a78", "is_contract": 1, "doubt_list": 0, "malicious_behavior": [], "deployed_time": 1590850640, "trust_list": 0, "is_open_source": 1 } } ] } ] } ``` # omnia\_checkNFTSecurity **Returns security details about an NFT (smart contract possible vulnerabilities, community-related risks).** **Parameters** `DATA`, 20 Bytes - contractAddress. The NFT smart contract address that is checked. REQUIRED **Returns** `Object with following details:` | Parameter | Description | Notice | | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `nft_name` | | | | `nft_symbol` | | | | `nft_description` |

It describes the introduction of the NFT.
Return “null” means there is no description of the NFT.

| | | `nft_erc` |

It describes the ERC protocol of the NFT.
Example: "nft\_erc": "erc721"

| | | `creator_address` |

It describes the creator's address of the NFT.
Return “null” means that we didn't find the creator's address.

| | | `create_block_number` |

It describes the number of blocks created for the NFT.
Return “null” means that we didn't find the number of blocks created for the NFT.

| | | `website_url` |

It describes the website URL of the NFT.
Return “null” means there is no website URL or didn't find the website URL.

| | | `discord_url` |

It describes the discord URL of the NFT.
Return “null” means there is no discord URL or didn't find the discord URL.

| | | `github_url` |

It describes the GitHub URL of the NFT.
Return “null” means there is no GitHub URL or didn't find the GitHub URL.

| | | `twitter_url` |

It describes the Twitter URL of the NFT.
Return “null” means there is no Twitter URL or didn't find the Twitter URL.

| | | `medium_url` |

It describes the medium URL of the NFT.
Return “null” means there is no medium URL or didn't find the medium URL.

| | | `telegram_url` |

It describes the telegram URL of the NFT.
Return “null” means there is no telegram URL or didn't find the telegram URL.

| | | `nft_items` | It describes the numbers of the NFT. | | | `nft_owner_number` | It describes the holders of the NFT. | | | `average_price_24h` | It describes the average price of the NFT in 24h. | | | `lowest_price_24h` | It describes the lowest price of the NFT in 24h. | | | `sales_24h` | It describes the sales of the NFT in 24h. | | | `traded_volume_24h` | It describes the trading volume of the NFT in 24h. | | | `total_volume` | It describes the total volume of the NFT. | | | `highest_price` | It describes the highest price of the NFT. | | | `nft_verified` |

It describes whether the NFT is verified.
"1" means that the NFT is verified;
"0" means that we did not find any information about whether the NFT is verified.

| | | `same_nfts` |

It describes the info of other NFTs with duplicate names and symbols.
The info includes:
(1) "nft\_name" describes the name of the NFT;
(2) "nft\_symbol" describes the symbol of the NFT;
(3) “nft\_address” describes the address of the NFTs;
(4) “nft\_owner\_number” describes the holders of the NFT;
(5) “create\_block\_number” describes the number of blocks created for the NFT.
Return "null" means no NFTs with duplicate names and symbols.

| | | `trust_list` |

It describes whether the NFT is a famous and trustworthy one.
"1" means true;
Return "null" means no result.

|

(1) Only "trust\_list": "1" means it is a famous and trustworthy NFT.
(2) Return "null" doesn't mean it is risky.

| | `malicious_nft_contract` |

It describes whether this NFT has performed malicious behaviors.
"1" means true;
"0" means false.

| Malicious behaviors include random additions, blacklist abuse, falsified transactions, and other high-risk behaviors. Interacting with NFTs flagged as Malicious may contain a high level of risk. | | `nft_open_source` |

It describes whether this contract is open source.
"1" means true;
"0" means false.

| Un-open-sourced contracts may hide various unknown mechanisms and are extremely risky. When the contract is not open source, we will not be able to detect other risk items. | | `nft_proxy` |

It describes whether this NFT contract has a proxy contract.
"1" means true;
"0" means false;
"Null" means unknown.

|

(1) When "is\_open\_source": "0", it will return "null".
(2) Most Proxy contracts are accompanied by modifiable implementation contracts, and implementation contracts may contain significant potential risk.

| | `metadata_frozen` |

It describes whether the metadata of this NFT is stored in IPFS, AR, generated by contract, or another decentralized way.
"1" means true;
"0" means false;
"Null" means unknown.

| When "is\_open\_source": "0", it will return "null". | | `privileged_burn` |

It describes whether the NFT owner can burn others' NFT.
(1)value
The "value" describes the status of the risk.
null: the contract is not open source or there is a proxy, it is not possible to detect whether the risk exists. -1: the risk is detected but the ownership gives up. If the detection of a code vulnerability, it can also be considered risk-free.
0: the risk is not detected.
1: the risk is detected, and the owner's address is a common address (EOA), then it can be said that there is a clear risk.
2: The risk is detected, but the owner's address is a contract address, the risk is not significant.
3: The risk is detected, but the owner's address is not detectable / or an array.

(2)owner\_address
Owner\_address describes the owner's address.
null: the owner's address cannot be fetched.

(3)owner\_type
"blackhole": the owner is a blackhole address.
"contract": the owner is a contract.
"eoa": the owner is a common address (eoa).
"multi-address": the owner is an array/list.
null: the address is not detected.

| Privileged\_burn means that the owner can burn others' NFTs directly through the method. | | `transfer_without_approval` |

It describes whether the NFT owner can transfer NFT without approval.
Other contents are the same as above.

|

Transfer\_without\_approval generally means the scammer does not need to get approvals to transfer another address's NFT.
One typical example is sleep\_minting. Sleep\_minting means that the scammer will first add the NFT to a well-known wallet address and then retrieve the NFT. After the value of the NFT has appreciated, it will be put back on the market.

| | `privileged_minting` |

It describes whether the NFT contract has minting methods which can only be triggered by an address with special privileges.
Other contents are the same as above.

| Some minting methods can only be triggered by an address with special privileges. Generally speaking, these are usually for the owner to mint. | | `self_destruct` |

It describes whether this NFT contract can self-destruct.
Other contents are the same as above.

| When the self-destruct function is triggered, this contract will be destroyed, all functions will be unavailable, and all related assets will be erased. | | `restricted_approval` |

It describes whether the NFT contract can restrict the approval, resulting in NFT can not be traded on the NFT DEX.
"1" means true;
"0" means false;
"Null" means unknown.

| If this risk exists, it means that users will not be able to trade the NFT on the exchange and only privileged users in the whitelist will be able to trade normally. | | `oversupply_minting` |

It describes whether this NFT owner can bypass the maximum amount of minting specified in the contract, and continue to mint NFTs beyond this limit.
"1" means true;
"0" means false;
"Null" means unknown.

| Oversupply minting refers to the existence of a special mint method in the NFT contract — the owner can bypass the maximum amount of minting specified in the contract, and continue to mint NFTs beyond this limit. | ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_checknftsecurity", "params": [ { "contractAddress": "0x76BE3b62873462d2142405439777e971754E8E77" } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": { "nft_address": "0x76be3b62873462d2142405439777e971754e8e77", "traded_volume_24h": 19.3307, "red_check_mark": null, "total_volume": 92038.56, "nft_proxy": 0, "restricted_approval": 0, "highest_price": 360, "transfer_without_approval": { "value": 0 }, "discord_url": "https://discord.gg/parallelalpha", "nft_open_source": 1, "privileged_minting": { "owner_address": "0x74db0bbfde94aa80a135c5f8b60c0ca3d17332f2", "value": 1, "owner_type": "eoa" }, "nft_owner_number": 58763, "trust_list": 0, "token_id": null, "lowest_price_24h": 0.0003, "average_price_24h": 0.0732, "nft_erc": "erc1155", "creator_address": "0x74db0bbfde94aa80a135c5f8b60c0ca3d17332f2", "medium_url": null, "malicious_nft_contract": 0, "privileged_burn": { "owner_address": null, "value": 0, "owner_type": null }, "twitter_url": "https://twitter.com/parallelnft", "nft_description": "Sci-fi collectable card game with NFTs.", "nft_symbol": "LL", "self_destruct": { "owner_address": null, "value": 0, "owner_type": null }, "metadata_frozen": null, "token_owner": null, "nft_verified": 1, "same_nfts": [ { "nft_address": "0x4aae6652a96eab7b7be9907c9377044ecc84cf2c", "nft_name": "Parallel", "nft_owner_number": 1, "create_block_number": 14502533, "nft_symbol": "LL" }, { "nft_address": "0x6e642794b0356f1170c65c2fa65b711c6c8c1c63", "nft_name": "parallel", "nft_owner_number": 1, "create_block_number": 14885561, "nft_symbol": "LL" } ], "nft_items": 1069, "oversupply_minting": null, "nft_name": "parallel", "github_url": null, "website_url": "http://www.parallel.life", "telegram_url": null, "sales_24h": 264, "create_block_number": 12097989 } } ``` # omnia\_checkAddress **Returns security details about on-chain behaviour of a given address.** **Parameters** `DATA`, 20 Bytes - address. The wallet address that is checked. REQUIRED **Returns** `Object with following details:` | Parameter | Description | Notice | | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `data_source` | It describes the data source for this address information. For example, GoPlus/SlowMist | | | `honeypot_related_address` | It describes whether this address is related to honeypot tokens or has created scam tokens. "1" means true; "0" means false. | Addresses related to honeypot mean the creators or owners of the honeypot tokens. This is a dangerous address if the address is related to honeypot tokens. | | `phishing_activities` | It describes whether this address has implemented phishing activities. "1" means true; "0" means false. | | | `blackmail_activities` | It describes whether this address has implemented blackmail activities. "1" means true; "0" means false. | | | `stealing_attack` | It describes whether this address has implemented stealing attacks. "1" means true; "0" means false. | | | `fake_kyc` | It describes whether this address is involved in fake KYC. "1" means true; "0" means false. | | | `malicious_mining_activities` | It describes whether this address is involved in malicious mining activities. "1" means true; "0" means false. | | | `darkweb_transactions` | It describes whether this address is involved in dark web transactions. "1" means true; "0" means false. | | | `cybercrime` | It describes whether this address is involved in cybercrime. "1" means true; "0" means false. | | | `money_laundering` | It describes whether this address is involved in money laundering. "1" means true; "0" means false. | | | `financial_crime` | It describes whether this address is involved in financial crime. "1" means true; "0" means false. | | | `blacklist_doubt` | It describes whether this address is suspected of malicious behavior. "1" means true; "0" means false. | | | `contract_address` | It describes whether this address is a contract address. "1" means true; "0" means false. | If only the address is sent to the API and not the chain id, the "contract\_address" will not be returned. This is because there are cases where the same address is a contract in one public chain but not in other public chains. Determining the contract address is achieved by calling a third-party blockchain browser interface. Since it takes time for the browser interface to return, the field may be empty on the first request. Solution: the second call around 5s can return whether the address is the value of the contract normally. | | `mixer` | It describes whether this address is coin mixer address. "1" means true; "0" means false. | Interacting with coin mixer may result in your address being added to the risk list of third-party institutions. | | `sanctioned` | It describes whether this address is sanctioned address. "1" means true; "0" means false. | | | `number_of_malicious_contracts_created` | This parameter describes how many malicious contracts have been created by this address. | | | `gas_abuse` | It describes whether this address is cheating other user's gas fee to mint other assets. | Any interaction with such addresses may result in loss of property. | | `reinit` | It describes whether this address/contract has been deployed more than onces, and can be deployed again. | If a contract can be reinited, the developer can change the contract code whenever he wants. | | `fake_standard_interface` | It describes whether this contract contains standard interfaces that do not conform the requirements of the standard protocol. | Fake Standard Interface is mostly seen in scam assets. | ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_checkaddress", "params": [ { "address": "0x7744446f4fBE3e660AE9206FB8b0D46b8D097176" } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": { "cybercrime": "0", "money_laundering": "0", "number_of_malicious_contracts_created": "0", "gas_abuse": "0", "financial_crime": "0", "darkweb_transactions": "0", "reinit": "0", "phishing_activities": "0", "contract_address": "0", "fake_kyc": "0", "blacklist_doubt": "0", "fake_standard_interface": "0", "data_source": "", "stealing_attack": "0", "blackmail_activities": "0", "sanctioned": "0", "malicious_mining_activities": "0", "mixer": "0", "honeypot_related_address": "0" } } ``` # omnia\_checkRugPull **Returns security details indicating whether the token can generate a Rug pull event or not.** **Note: A rug pull event means a massive sell-off of the token by the first holders, often time by it's creators.** **Parameters** `DATA`, 20 Bytes - contractAddress. The contract address that is checked. REQUIRED **Returns** `Object with following details:` | Parameter | Description | Notice | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | `owner` |

(1) owner\_name - the function name of ownership. (2) owner\_address - owner address of the contract.
(3) owner\_type - "blackhole" means the owner is a blackhole address; "contract" means the owner is a contract; "eoa" means the owner is a common address; "multi-address" means the owner is an array/list. null means the address is not detected. No return means unknown.

| When there is no owner function, or the ownership is unreadable or private, it would return empty. | | `privilege_withdraw` |

It describes whether the contract owner can withdraw all the assets in the contract, without users' permission.
"1" means true;
"0" means false;
"-1" means unknown.

| | | `withdraw_missing` |

It describes whether the contract lacks a withdrawal method. If it is missing, users will be unable to withdraw the assets they have put in.
"1" means true;
"0" means false;
"-1" means unknown.

| | | `is_open_source` |

It describes whether this contract is open source.
"1" means true;
"0" means false.

| | | `blacklist` |

It describes whether the contract has a blacklist function that would block users from withdrawing their assets.
"1" means true;
"0" means false;
"-1" means unknown.

| | | `contract_name` | Name of the contract. | | | `selfdestruct` |

It describes whether this contract can self-destruct.
"1" means true;
"0" means false;
"-1" means unknown.

| | | `approval_abuse` |

It describes whether the owner can spend the allowance obtained by the contract. If so, this function could potentially be abused to steal user assets.
"1" means true;
"0" means false;
"-1" means unknown.

| | | `is_proxy` |

It describes whether this contract has a proxy contract.
"1" means true;
"0" means false;
"-1" means unknown.

| |
## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_checkrugpull", "params": [ { "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7" } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": { "owner": { "owner_name": "owner", "owner_address": "0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828", "owner_type": "contract" }, "privilege_withdraw": 1, "withdraw_missing": -1, "is_open_source": 1, "blacklist": 1, "contract_name": "TetherToken", "selfdestruct": 1, "is_proxy": 0, "approval_abuse": 0 } } ``` # omnia\_checkPhishingSite **Returns security details indicating whether the given url is a phishing site or not.** **Note: This is a chain-agnostic method.** **Parameters** `STRING` - url. The url of the website that is checked. REQUIRED **Returns** `Object with following details:` | Parameter | Description | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `phishing_site` |
  • 1 if the given url leads to a website involved in phishing activities
  • 0 if no phishing activities found
| | `website_contract_security [BETA]` | Applies and returns the same check as [omnia\_checkAddress](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/89/rpc-api-docs/chains/ethereum/custom-json-rpc-api/omnia_checkaddress) |
## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_checkphishingsite", "params": [ { "url": "https://www.c0inbase.com" // notice the '0' instead of 'o' in the domain name } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": { "website_contract_security": [], "phishing_site": 1 } } ``` # omnia\_checkDappSecurity **Returns security details of the web Dapp at the given url.** **Note: This is a chain-agnostic method.** **Parameters** `STRING` - url. The url of the website that is checked. REQUIRED **Returns** `Object with following details:` | Parameter | Description | Notice | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `project_name` | It describes the dApp project name. | | | `url` | It describes the dApp's website link. | | | `contracts_security` |

It describes the security information for this dApp's contracts. The info includes:
(1) chain\_id - describes the chains that contracts are deployed on;
(2) contract\_address - describes the dApp's contract address;
(3) is\_open\_source - describes whether this contract is open source;
(4) malicious\_contract - describes whether the address is a suspected malicious contract;
(5) malicious\_behavior - describes specific malicious behaviors of the contract; (6) deployment\_time - describes the deployed time of the contract;
(7) creator\_address - describes the creator's address of the contract;
(8) malicious\_creator - describes whether the creator is a suspected malicious address;
(9) malicious\_creator\_behavior - describes specific malicious behaviors of the contract creator.

| `malicious_contract` and `malicious_creator` return "0" does not mean the address is completely safe. Maybe we just haven't found its malicious behavior. | | `is_audit` |

It describes whether the dApp was audited by a reputable audit firm.
"1" means true;
"0" means that we have not found audit information for this dApp.

| Return "0" does not mean the dApp was not audited. Maybe we just haven't found audit information for this dApp yet. | | `audit_info` |

It describes the audit information of the dApp. The info includes:
(1) audit\_time - describes the time shown in the latest audit report;
(2) audit\_link - describes the website link of the audit report;
(3) audit\_firm - describes the firm that audited the dApp.

| When the dApp was not audited, (`is_audit`=0), it will return "null". If there are multiple audit reports, the information of the latest audit report is displayed. | | `trust_list` |

It describes whether the dApp is a famous and trustworthy one. "1" means true;
"0" means that this dApp is not yet on our trusted list.

|

(1) Only "trust\_list": "1" means it is a famous and trustworthy dApp.
(2) "0" return doesn't mean it is risky.

|
## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_checkdappsecurity", "params": [ { "url": "https://app.uniswap.org/#/swap" } ] } ' ``` #### Response ``` { "id": 1, "jsonrpc": "2.0", "result": { "project_name": "Uniswap", "url": "https://app.uniswap.org/#/swap", "is_audit": 1, "trust_list": 1, "audit_info": [ { "audit_time": "2019.01.11", "audit_link": "https://github.com/ConsenSys/Uniswap-audit-report-2018-12/blob/master/Uniswap-final.md", "audit_firm": "ConsenSys" } ], "contracts_security": [ { "chain_id": "1", "contracts": [ { "contract_address": "0xc0a47dfe034b400b47bdad5fecda2621de6c4d95", "is_open_source": 1, "creator_address": "0xd1c24f50d05946b3fabefbae3cd0a7e9938c63f2", "malicious_contract": 0, "deployment_time": 1541137042, "malicious_creator": 0, "malicious_creator_behavior": [], "malicious_behavior": [] }, { "contract_address": "0x077d52b047735976dfda76fef74d4d988ac25196", "is_open_source": 1, "creator_address": "0xb8dc24569eed78375c71808a865a8a013bd2cb7c", "malicious_contract": 0, "deployment_time": 1541935097, "malicious_creator": 0, "malicious_creator_behavior": [], "malicious_behavior": [] }, { "contract_address": "0x2e642b8d59b45a1d8c5aef716a84ff44ea665914", "is_open_source": 1, "creator_address": null, "malicious_contract": 0, "deployment_time": null, "malicious_creator": 0, "malicious_creator_behavior": [], "malicious_behavior": [] } ... ] } ] } } ``` # omnia\_decodeTransaction **Returns the Transaction.data field of an Ethereum transaction.** **Parameters** 1. `DATA, 20 bytes` - contract\_address. The address of the smart contract called. 2. `DATA, variable length`- data. Transaction.data field to be decoded. REQUIRED 3. `DATA, 20 bytes` - signer. Address corresponding to the signer of the transaction. **Note**: contract\_address and signer parameters are not required, but providing them might help to recover more details about the decoded input. **Returns** `Object with following details:` | Parameter | Description | Notice | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `method` | It describes the method name in ABI, for example, "transfer". | | | `type` | It describes the parameter type in ABI, for example, "address", "uint256", and "bool". | | | `name` | It describes the parameter name in ABI, for example "\_from", "\_to", "\_value". | | | `input` | It describes the input data in ABI. | | | `address_info` |

It describes the info about the address as a parameter.
The info includes: (1) "is\_contract" describes whether the address is a contract. "1" means true; "0" means false.
(2) "contract\_name" describes the contract name if the address is a contract.
(3) "standard" describes the standard type of the contract. Example:"erc20".
(4) "symbol" describes the token symbol if the address is an ERC20 contract.
(5) "name" describes the token name if the address is an ERC20 contract.
(6) "malicious\_address" describes whether the address is a suspected malicious contract.
"1" means true;
"0" means that we have not found malicious behavior of this address.

|

When the address is not a contract ("is\_contract"=0), "contract\_name", "standard", "symbol", and "name" will return "null".
When the address is a contract but not an erc20 contract, "standard", "symbol", and "name" will return "null".

| | `contract_name` | The name of the contract that the user is interacting with. | | | `contract_description` | Description of the contract. | | | `malicious_contract` | It tells if the contract that the user is interacting with is a malicious contract. | | | `signature_detail` | It explains the function of the method. | | | `risky_signature` | It tells if the transaction that users are signing contains risk. | Even non-malicious, commonly used, well-known contracts can be highly risky if not used properly. | | `risk` | It explains why the transaction that users are signing contains risk. | Even non-malicious, commonly used, well-known contracts can be highly risky if not used properly. |
## Example #### Request ```bash curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "omnia_decodeTransaction", "params": [ { "contract_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7", "data": "0x095ea7b30000000000000000000000009901bac880caecad999e292811db9c1db3e86f8a000000000000000000000000000000000000000000000000000000000001951b", "signer": "0x822FC93407C81BA1401838Cb2991130D2bE36a94" } ] } ' ``` #### Response ```json { "id": 1, "jsonrpc": "2.0", "result": { "method": "approve", "risk": null, "params": [ { "type": "address", "name": "spender", "input": "0x9901bac880caecad999e292811db9c1db3e86f8a", "struct": null, "tuple": null, "address_info": { "standard": "OTHER", "symbol": null, "name": null, "contract_name": null, "malicious_address": 0, "is_contract": 1 } }, { "type": "uint256", "name": "amount", "input": "103707", "struct": null, "tuple": null, "address_info": null } ], "contract_name": null, "contract_description": null, "malicious_contract": null, "signature_detail": null, "risky_signature": null } } ``` # omnia\_disperse **Transfer (disperse) native or ERC-20 tokens to multiple addresses in a single RPC call.** The workflow of the **omnia\_disperse** method is based on a two-stage process in which: 1. The first call is used to create and return an unsinged *disperse* transaction. This transaction will contain the addresses of the recipients, the amounts (values) to be sent to each recipient and the address of the token contract (ERC-20), in case of dispersing ERC-20 tokens, not native ones (Ether, Avax etc.); 2. The signing and starting the disperse. The caller should sign the unsigned *disperse* transaction returned by call in stage 1 and then make another *start disperse* call to launch the disperse aciton on-chain. {% hint style="info" %} **In case of dispersing ERC-20 tokens:** before sending the signed *disperse* transaction, make sure to give the *approve* allowance from the spending wallet to the ERC-20 token contract for the total amount (sum) spent. This is a requirement of the ERC-20 standard. [Follow step-by-step explanation here.](https://support.metamask.io/hc/en-us/articles/6174898326683-What-is-a-token-approval-) {% endhint %} {% hint style="info" %} When dispersing the same amount (value) to all recipients, there's no need to send an array of values with the length of the recipients array. It is enough to send only one amount in the **values** array. {% endhint %} **Parameters** 1. `DATA, ["native" || "efficient" || "tracking"]` - disperseType. The type of disperse operation wanted. REQUIRED * native - used for dispersing native tokens of the specific network. (Ether for Ethereum/Arbitrum/Optimism, BNB for Binance Smart Chain, Avax for Avalanche C-Chain etc.); * efficient - used when dispersing ERC-20 tokens in a more gas-efficient manner. This will generate less gas cost, but will be harder to track/audit for many recipients from the [Disperse smart contract](https://etherscan.io/address/0xd152f549545093347a162dce210e7293f1452150#code); * tracking - this allows tracking every transfer directly from the [Disperse smart contract](https://etherscan.io/address/0xd152f549545093347a162dce210e7293f1452150#code) but increases the gas consumed. 2. `DATA, ["createUnsignedDisperse" || "startDisperse"]` - disperseStage. As the disperse workflow uses two stages, the `createUnsignedDisperse` stage is used for creating the initial unsigned *disperse* transaction, while `startDisperse` stage is used for sending the signed *disperse* transaction. REQUIRED 3. `DATA`, 20 Bytes - spendingAddress. Wallet addres from which the funds will be dispersed to recipients. REQUIRED 4. `DATA`, Bytes - gasLimit. Hex value used overwrite the default gas limit when creating the unsigned *disperse* transaction. Default value: `0xC350` (50,000). 5. `Array of DATA`, 20 Bytes - recipients. The addresses of the wallets receiving the dispersed funds. REQUIRED 6. `Array of DATA`, Bytes - values. The amounts (values) of dispersed funds received by each recipient. SHOULD be provided in Hex format. In case of same value for multiple recipients, see the note above. REQUIRED 7. `DATA`, Bytes - signedTransaction. The signed *disperse* transaction RLP-encoded with 0x prefix. Required only in the `startDisperse` stage. REQUIRED **Returns** 1. Unsigned *disperse* transaction serialised into JSON and ready to be signed. 2. Hash of *disperse* transaction. ## Example #### Driver code (Node.js) ```javascript const ethers = require('ethers'); const axios = require('axios'); async function main() { const omniaRpcUrl = ''; // #region Disperse createUnsignedDisperse const generateDisperseReq = { id: 1, jsonrpc: 2.0, method: "omnia_disperse", params: [{ recipients: ["0xb3Be198329E658547381A2a823732122522D3566"], values: ["0x16345785d8a0000"], tokenAddress: "0x21F8246ECdE66A4F193f4a288371718484256d0a", spendingAddress: "0x6D8A32Fb9210dC8B903347204E105f4De08f0c34", disperseStage: "createUnsignedDisperse", disperseType: "tracking", gasLimit: "0x186A0" }] }; const disperseRes = await axios.default.post(omniaRpcUrl, generateDisperseReq); const unsignedTransaction = JSON.parse(disperseRes.data.result); // #endregion Disperse createUnsignedDisperse // #region Disperse signDisperse const privateKey = ''; const rpcProvider = new ethers.providers.JsonRpcProvider(omniaRpcUrl); const wallet = new ethers.Wallet(privateKey, rpcProvider); const signedTransaction = await wallet.signTransaction(unsignedTransaction); console.log('signedTransaction: ', signedTransaction); const sendSignedDisperseReq = { id: 1, jsonrpc: 2.0, method: "omnia_disperse", params: [{ disperseStage: "startDisperse", signedTransaction }] }; const sendSignedTxRes = await axios.default.post(customRpcUrl, sendSignedDisperseReq, { headers }) // #endregion Disperse signDisperse } main().catch((error) => { console.error(error); process.exitCode = 1; }); ``` #### Response ```json { id: 1, jsonrpc: "2.0", result: '0xf335db1f9534a753180a53f1f82710c2703abfde4a97cc1208cb2b85340dc12b' } ``` # omnia\_getTokenPrice **Return the price of an ERC-20 token.** {% hint style="info" %} **Please make sure that the token address for which the price is requested is corresponding to an ERC-20 token and the token is available on the network (endpoint) the request is sent to.** {% endhint %} **Parameters** 1. `DATA`, 20 Bytes - **tokenAddress**. ERC-20 token address for which the price is requested. REQUIRED 2. `DATA`, positive number - **pricingDecimals**. Number of decimals used for the returned price. Default value: 5. **OPTIONAL** **Returns** 1. tokenAddress: address of the ERC-20 token 2. tokenSymbol: ERC-20 symbol as stored in the token smart contract 3. tokenDecimals: ERC-20 decimals as stored in the token smart contract 4. usdPrice: Positive number representing token price denominated in U.S. dollars. (0 if the price of the token cannot be determined) ## Example ```json { "id": 1, "jsonrpc": "2.0", "method": "omnia_getTokenPrice", "params": [{ "tokenAddress": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "pricingDecimals": 5 }] } ``` #### Response ```json { "id": 1, "jsonrpc": "2.0", "result": { "tokenAddress": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "tokenSymbol": "WETH", "tokenDecimals": 18, "usdPrice": 2022.86554 } } ``` # Standard JSON-RPC API # eth\_accounts **Returns a list of addresses owned by client. Due to privacy reasons, OMNIA does not store private keys, so this will always return an empty response.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_accounts) **Parameters** None **Returns** `Array of DATA`, 20 Bytes - addresses owned by the client. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_accounts" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": [] } ``` # eth\_blockNumber **Returns the number of most recent block.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_blocknumber) **Parameters** None **Returns** `QUANTITY` - integer of the current block number the client is on. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_blockNumber" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x4b7" // 1207 } ``` # eth\_call **Executes a new message call immediately without creating a transaction on the block chain. Often used for executing read-only smart contract functions, ofr example the `balanceOf` for an ERC-20 contract.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_call) **Parameters** 1. `Object` - The transaction call object * `from`: `DATA`, 20 Bytes - (optional) The address the transaction is sent from. * `to`: `DATA`, 20 Bytes - The address the transaction is directed to. REQUIRED * `gas`: `QUANTITY` - (optional) Integer of the gas provided for the transaction execution. eth\_call consumes zero gas, but this parameter may be needed by some executions. * `gasPrice`: `QUANTITY` - (optional) Integer of the gasPrice used for each paid gas * `value`: `QUANTITY` - (optional) Integer of the value sent with this transaction * `data`: `DATA` - (optional) Hash of the method signature and encoded parameters. For details see [Ethereum Contract ABI in the Solidity documentation(opens in a new tab)↗](https://docs.soliditylang.org/en/latest/abi-spec.html) 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `DATA` - the return value of executed contract. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_call", "params": [ { "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x00", "gasPrice": "0x09184e72a000", "value": "0x00", "data": "0x" } ] } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x" } ``` # eth\_chainId **Returns the chain ID used for signing replay-protected transactions.**\ \ Note: for browsing Ethereum chain IDs, one can use [chainlist.org](https://chainlist.org) [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_chainid) **Parameters** `None` **Returns** `chainId`, hexadecimal value as a string representing the integer of the current chain id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_chainId" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x1" } ``` # eth\_estimateGas **Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. The transaction will not be added to the blockchain. Note that the estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_estimategas) **Parameters** See [eth\_call](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_call) parameters, except that all properties are optional. If no gas limit is specified geth uses the block gas limit from the pending block as an upper bound. As a result the returned estimate might not be enough to executed the call/transaction when the amount of gas is higher than the pending block gas limit. **Returns** `QUANTITY` - the amount of gas used. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_estimateGas", "params": [ { "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x00", "gasPrice": "0x09184e72a000", "value": "0x00", "data": "0x" }, { "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x00", "gasPrice": "0x09184e72a000", "value": "0x00", "data": "0x" } ] } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x5208" // 21000 } ``` # eth\_feeHistory **Returns a collection of historical gas information.** **Parameters** * `BLOCKCOUNT` - Number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. Less than requested may be returned if not all blocks are available. REQUIRED * `NEWESTBLOCK` - Highest number block of the requested range. REQUIRED * `REWARDPERCENTILES` - (optional) A monotonically increasing list of percentile values to sample from each block's effective priority fees per gas in ascending order, weighted by gas used. REQUIRED **Returns** `Object` * `OLDESTBLOCK` - Lowest number block of the returned range. * `BASEFEEPERGAS` - An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block. Zeroes are returned for pre-EIP-1559 blocks. * `GASUSEDRATIO` - An array of block gas used ratios. These are calculated as the ratio of `gasUsed` and `gasLimit`. * `REWARD` - (Optional) An array of effective priority fees per gas data points from a single block. All zeroes are returned if the block is empty. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_feeHistory", "params": [4, "latest", [25, 75]] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "oldestBlock": "0x1126e25", "reward": [ [ "0x5f5e100", "0x77359400" ], [ "0x2faf080", "0x77359400" ], [ "0x5f5e100", "0x879a1444" ], [ "0x5f5e100", "0x3b9aca00" ] ], "baseFeePerGas": [ "0x6bfc13a7a", "0x6a447cc2e", "0x6a550c5dd", "0x67834a299", "0x6cf5d92f9" ], "gasUsedRatio": [ 0.43639296666666666, 0.5024350333333333, 0.3939411, 0.7105050666666667 ] } } ``` # eth\_gasPrice **Returns the current gas price on the network in wei.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gasprice) **Parameters** None **Returns** `QUANTITY` - integer of the current gas price in wei. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_gasPrice" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x1dfd14000" // 8049999872 Wei } ``` # eth\_getBalance **Returns the balance of the account of given address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance) **Parameters** 1. `DATA`, 20 Bytes - address to check for balance. REQUIRED 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `QUANTITY` - integer of the current balance in wei. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8", "latest" ], "method": "eth_getBalance" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x0234c8a3397aab58" // 158972490234375000 } ``` # eth\_getBlockByHash **Returns information about a block by hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblockbyhash) **Parameters** 1. `DATA`, 32 Bytes - Hash of a block. REQUIRED 2. `Boolean` - If `true` it returns the full transaction objects, if `false` only the hashes of the transactions. **Returns** `Object` - A block object, or `null` when no block was found: * `number`: `QUANTITY` - the block number. `null` when its pending block. * `hash`: `DATA`, 32 Bytes - hash of the block. `null` when its pending block. * `parentHash`: `DATA`, 32 Bytes - hash of the parent block. * `nonce`: `DATA`, 8 Bytes - hash of the generated proof-of-work. `null` when its pending block. * `sha3Uncles`: `DATA`, 32 Bytes - SHA3 of the uncles data in the block. * `logsBloom`: `DATA`, 256 Bytes - the bloom filter for the logs of the block. `null` when its pending block. * `transactionsRoot`: `DATA`, 32 Bytes - the root of the transaction trie of the block. * `stateRoot`: `DATA`, 32 Bytes - the root of the final state trie of the block. * `receiptsRoot`: `DATA`, 32 Bytes - the root of the receipts trie of the block. * `miner`: `DATA`, 20 Bytes - the address of the beneficiary to whom the mining rewards were given. * `difficulty`: `QUANTITY` - integer of the difficulty for this block. * `totalDifficulty`: `QUANTITY` - integer of the total difficulty of the chain until this block. * `extraData`: `DATA` - the "extra data" field of this block. * `size`: `QUANTITY` - integer the size of this block in bytes. * `gasLimit`: `QUANTITY` - the maximum gas allowed in this block. * `gasUsed`: `QUANTITY` - the total used gas by all transactions in this block. * `timestamp`: `QUANTITY` - the unix timestamp for when the block was collated. * `transactions`: `Array` - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter. * `uncles`: `Array` - Array of uncle hashes. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockByHash", "params": [ "0xe76d777791f48b5995d20789183514f4aa8bbf09e357383e9a44fae025c6c50a", false ] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "baseFeePerGas": "0x2f99b1dd0", "difficulty": "0x0", "extraData": "0x4d616465206f6e20746865206d6f6f6e20627920426c6f636b6e6174697665", "gasLimit": "0x1c9c380", "gasUsed": "0x1699c83", "hash": "0xe76d777791f48b5995d20789183514f4aa8bbf09e357383e9a44fae025c6c50a", "logsBloom": "0x1c243c7f96541e048c0cc481b0ac333461c12804d880990dfe1980c41c2a49aca538425bc4030022419e3fe80ce6a1819e0c8cbccaec3511034bc7c75a6424b148b3809049eb1a8b6a088bc9629304fa84666835856e23084c00b81191002810d6710c00834290e38544008cba206a7bf4891881609a144000d000b00c896c90b21805320683810d20c90c0810064069f4001911c10a0409400c615e0a34316d8b29c9d4298d7b191a6819811f118c01801021715096405280cbaa4326b1460ca46c66432390d05001c0341a2c82305750c027f4d2ae10971254a94321a9f2132090a00e1f0110b18567920180818fc6b1100e8af2e84040a0408c144015d213", "miner": "0xbaf6dc2e647aeb6f510f9e318856a1bcd66c5e19", "mixHash": "0xe8ad228f6a0f7c79bd2f8273f717a06f47b271f41d748718699bb966f710fc9b", "nonce": "0x0000000000000000", "number": "0xf8e3d7", "parentHash": "0xbef5b480684b03c0c3ff58deec762cf6650de5b71da431e85d908cca221a10b2", "receiptsRoot": "0xce65ddb737ae93370c63077c742ba190d917fbe0876a9a1f9d793d5b125fa04a", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x9684", "stateRoot": "0xc57cf792e5cdff63c582e03084a7d21748196f1c6a97171d2b4e07417fa5df2e", "timestamp": "0x63b15d3b", "totalDifficulty": "0xc70d815d562d3cfa955", "transactions": [ "0x501251dd9097bcba3074c7e699be2bc28a343228e321251342188a34e9e54871", "0x1e4009ac7b59a0a64fe3f42918185a160ce22ad666215fa182ea1d927a8e1a22", "0xa04bdde31cba595dbb6749b4b2f4c712119d1f40c94c402592c2922416dd08a1", "0xdc23dd5f6c6ba68d6e73227b5dda9ddd5168beb829fdc3b432ae5d1755022c3b", "0x67c6d7216f8a7acce412dcdecea36bc983e040d16f9a594f4f89d785d9b960a3" ... ], "transactionsRoot": "0x0cf6abfa0c1f1f8e031dad7a314c5b130099dcf340d39d840accc778cb623f64", "uncles": [] } } ``` # eth\_getBlockByNumber **Returns information about a block by block number.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblockbyhash) **Parameters** 1. `QUANTITY|TAG` - integer of a block number, or the string `"earliest"`, `"latest"` or `"pending"`, as in the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block). REQUIRED 2. `Boolean` - If `true` it returns the full transaction objects, if `false` only the hashes of the transactions. REQUIRED **Returns** See [eth\_getBlockByHash](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_getblockbyhash) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockByNumber", "params": [ "0x1b4", true ] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "difficulty": "0x4ea3f27bc", "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32", "gasLimit": "0x1388", "gasUsed": "0x0", "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171", "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843", "nonce": "0x689056015818adbe", "number": "0x1b4", "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54", "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x220", "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d", "timestamp": "0x55ba467c", "totalDifficulty": "0x78ed983323d", "transactions": [], "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "uncles": [] } } ``` # eth\_getBlockTransactionCountByHash **Returns the number of transactions in a block from a block matching the given block hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblocktransactioncountbyhash) **Parameters** `DATA`, 32 Bytes - hash of a block REQUIRED **Returns** `QUANTITY` - integer of the number of transactions in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockTransactionCountByHash" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0xb0" } ``` # eth\_getBlockTransactionCountByNumber **Returns the number of transactions in a block matching the given block number.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblocktransactioncountbyhash) **Parameters** `QUANTITY|TAG` - integer of a block number, or the string `"earliest"`, `"latest"` or `"pending"`, as in the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block). REQUIRED **Returns** `QUANTITY` - integer of the number of transactions in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockTransactionCountByNumber", "params": ["0xe8"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0" } ``` # eth\_getCode **Returns (the smart contract) code at a given address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblocktransactioncountbyhash) **Parameters** 1. `DATA`, 20 Bytes - address REQUIRED 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `DATA` - the code from the given address. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getCode", "params": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "latest"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x60806040526004361061006d576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680633659cfe6146100775780634f1ef286146100ba5780635c60da1b146101085780638f2839701461015f578063f851a440146101a2575b6100756101f9565b005b34801561008357600080fd5b506100b8600480360381019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050610213565b005b610106600480360381019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001908201803590602001919091929391929390505050610268565b005b34801561011457600080fd5b5061011d610308565b604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b34801561016b57600080fd5b506101a0600480360381019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050610360565b005b3480156101ae57600080fd5b506101b761051e565b604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b610201610576565b61021161020c610651565b610682565b565b61021b6106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561025c57610257816106d9565b610265565b6102646101f9565b5b50565b6102706106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102fa576102ac836106d9565b3073ffffffffffffffffffffffffffffffffffffffff163483836040518083838082843782019150509250505060006040518083038185875af19250505015156102f557600080fd5b610303565b6103026101f9565b5b505050565b60006103126106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156103545761034d610651565b905061035d565b61035c6101f9565b5b90565b6103686106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561051257600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614151515610466576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260368152602001807f43616e6e6f74206368616e6765207468652061646d696e206f6620612070726f81526020017f787920746f20746865207a65726f20616464726573730000000000000000000081525060400191505060405180910390fd5b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61048f6106a8565b82604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019250505060405180910390a161050d81610748565b61051b565b61051a6101f9565b5b50565b60006105286106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561056a576105636106a8565b9050610573565b6105726101f9565b5b90565b61057e6106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614151515610647576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260328152602001807f43616e6e6f742063616c6c2066616c6c6261636b2066756e6374696f6e20667281526020017f6f6d207468652070726f78792061646d696e000000000000000000000000000081525060400191505060405180910390fd5b61064f610777565b565b6000807f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c36001029050805491505090565b3660008037600080366000845af43d6000803e80600081146106a3573d6000f35b3d6000fd5b6000807f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b6001029050805491505090565b6106e281610779565b7fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b81604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a150565b60007f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b60010290508181555050565b565b60006107848261084b565b151561081e576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603b8152602001807f43616e6e6f742073657420612070726f787920696d706c656d656e746174696f81526020017f6e20746f2061206e6f6e2d636f6e74726163742061646472657373000000000081525060400191505060405180910390fd5b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c360010290508181555050565b600080823b9050600081119150509190505600a165627a7a72305820a4a547cfc7202c5acaaae74d428e988bc62ad5024eb0165532d3a8f91db4ed240029" } ``` # eth\_getFilterChanges **Polling method for a filter, which returns an array of logs which occurred since last poll.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges) **Parameters** `QUANTITY` - the filter id. REQUIRED **Returns** `Array` - Array of log objects, or an empty array if nothing has changed since last poll. * For filters created with `eth_newBlockFilter` the return are block hashes (`DATA`, 32 Bytes), e.g. `["0x3454645634534..."]`. * For filters created with `eth_newPendingTransactionFilter` the return are transaction hashes (`DATA`, 32 Bytes), e.g. `["0x6345343454645..."]`. * For filters created with `eth_newFilter` logs are objects with following params: * `removed`: `TAG` - `true` when the log was removed, due to a chain reorganization. `false` if its a valid log. * `logIndex`: `QUANTITY` - integer of the log index position in the block. `null` when its pending log. * `transactionIndex`: `QUANTITY` - integer of the transactions index position log was created from. `null` when its pending log. * `transactionHash`: `DATA`, 32 Bytes - hash of the transactions this log was created from. `null` when its pending log. * `blockHash`: `DATA`, 32 Bytes - hash of the block where this log was in. `null` when its pending. `null` when its pending log. * `blockNumber`: `QUANTITY` - the block number where this log was in. `null` when its pending. `null` when its pending log. * `address`: `DATA`, 20 Bytes - address from which this log originated. * `data`: `DATA` - contains one or more 32 Bytes non-indexed arguments of the log. * `topics`: `Array of DATA` - Array of 0 to 4 32 Bytes `DATA` of indexed log arguments. (In *solidity*: The first topic is the *hash* of the signature of the event (e.g. `Deposit(address,bytes32,uint256)`), except you declared the event with the `anonymous` specifier.) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params":["0x16"], "method": "eth_getFilterChanges" } ' ``` #### Response ``` { "id":1, "jsonrpc":"2.0", "result": [{ "logIndex": "0x1", // 1 "blockNumber":"0x1b4", // 436 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d", "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf", "transactionIndex": "0x0", // 0 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d", "data":"0x0000000000000000000000000000000000000000000000000000000000000000", "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"] },{ ... }] } ``` # eth\_getFilterLogs **Returns an array of all logs matching filter with given id.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterlogs) **Parameters** `QUANTITY` - the filter id. REQUIRED **Returns** `Array` - Array of log objects, or an empty array if nothing has changed since last poll. * For filters created with `eth_newBlockFilter` the return are block hashes (`DATA`, 32 Bytes), e.g. `["0x3454645634534..."]`. * For filters created with `eth_newPendingTransactionFilter` the return are transaction hashes (`DATA`, 32 Bytes), e.g. `["0x6345343454645..."]`. * For filters created with `eth_newFilter` logs are objects with following params: * `removed`: `TAG` - `true` when the log was removed, due to a chain reorganization. `false` if its a valid log. * `logIndex`: `QUANTITY` - integer of the log index position in the block. `null` when its pending log. * `transactionIndex`: `QUANTITY` - integer of the transactions index position log was created from. `null` when its pending log. * `transactionHash`: `DATA`, 32 Bytes - hash of the transactions this log was created from. `null` when its pending log. * `blockHash`: `DATA`, 32 Bytes - hash of the block where this log was in. `null` when its pending. `null` when its pending log. * `blockNumber`: `QUANTITY` - the block number where this log was in. `null` when its pending. `null` when its pending log. * `address`: `DATA`, 20 Bytes - address from which this log originated. * `data`: `DATA` - contains one or more 32 Bytes non-indexed arguments of the log. * `topics`: `Array of DATA` - Array of 0 to 4 32 Bytes `DATA` of indexed log arguments. (In *solidity*: The first topic is the *hash* of the signature of the event (e.g. `Deposit(address,bytes32,uint256)`), except you declared the event with the `anonymous` specifier.) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0x1" ], "method": "eth_getFilterLogs" } ' ``` #### Response ``` { "id":1, "jsonrpc":"2.0", "result": [{ "logIndex": "0x1", // 1 "blockNumber":"0x1b4", // 436 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d", "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf", "transactionIndex": "0x0", // 0 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d", "data":"0x0000000000000000000000000000000000000000000000000000000000000000", "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"] },{ ... }] } ``` # eth\_getLogs **Returns an array of all logs matching a given filter object.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getlogs) **Parameters** `QUANTITY` - the filter id. **Returns** `Object` - The filter options: * `fromBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `toBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `address`: `DATA|Array`, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate. * `topics`: `Array of DATA`, - (optional) Array of 32 Bytes `DATA` topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options. * `blockhash`: `DATA`, 32 Bytes - (optional, **future**) With the addition of EIP-234, `blockHash` will be a new filter option which restricts the logs returned to the single block with the 32-byte hash `blockHash`. Using `blockHash` is equivalent to `fromBlock` = `toBlock` = the block number with hash `blockHash`. If `blockHash` is present in the filter criteria, then neither `fromBlock` nor `toBlock` are allowed. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [{"topics":["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]}], "method": "eth_getLogs" } ' ``` #### Response ``` { "id":1, "jsonrpc":"2.0", "result": [{ "logIndex": "0x1", // 1 "blockNumber":"0x1b4", // 436 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d", "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf", "transactionIndex": "0x0", // 0 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d", "data":"0x0000000000000000000000000000000000000000000000000000000000000000", "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"] },{ ... }] } ``` # eth\_getProof **Returns the account and storage values of the specified account including the Merkle-proof. This call can be used to verify that the data you are pulling from is not tampered with.** **Parameters** 1. `DATA`, 20 Bytes - address of the account. REQUIRED 2. `ARRAY`, 32 Bytes - an array of storage-keys that should be proofed and included. See [`eth_getStorageAt`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getstorageat) 3. `QUANTITY|TAG` - integer block number, or the string `"latest"` or `"earliest"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) **Returns** `Object` - A account object: * `balance`: `QUANTITY` - the balance of the account. See[`eth_getBalance`](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_getbalance) * `codeHash`: `DATA`, 32 Bytes - hash of the code of the account. For a simple Account without code it will return `"0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470"` * `nonce`: `QUANTITY`, - nonce of the account. See [`eth_getTransactionCount`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactioncount) * `storageHash`: `DATA`, 32 Bytes - SHA3 of the StorageRoot. All storage will deliver a MerkleProof starting with this `rootHash`. * `accountProof`: `ARRAY` - Array of rlp-serialized MerkleTree-Nodes, starting with the stateRoot-Node, following the path of the SHA3 (address) as key. * `storageProof`: `ARRAY` - Array of storage-entries as requested. Each entry is an object with these properties: * `key`: `QUANTITY` - the requested storage key * `value`: `QUANTITY` - the storage value * `proof`: `ARRAY` - Array of rlp-serialized MerkleTree-Nodes, starting with the storageHash-Node, following the path of the SHA3 (key) as path. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "jsonrpc":"2.0", "method":"eth_getProof", "params":["0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],"latest"], "id":1 } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842", "accountProof": [ "0xf90211a02fc15d4c68a4ad02dfc51b4e4f30eb0aeb246aa43bdd3062e1d4eef602c84eeca06f0f8375607e337ba12c00d074383c79387c0116a76b915d7d9975f0e59c8770a0230e6cf36da8966845ddfcde1878bc51f892b0b279c507140461a21396decfafa08d26cc53d876043cd4836d40df7c97f5ce37d21b5af10069d5adc8014bdf5da7a0be54bac27145c3b67e8f36fb0ddd8e09e3ed326bb9386bfabc7181cc67e9a7e2a06b46918e7188af10e0f742ba03178dba0fe4b664aa6989a3087be6a4f1cedf39a03397313377bd5c329ef76be72544480e017492aafd1d6d2af4b785c75d1614afa0a387f86581aa272e700766c6873b5c62e4ced032c518ecdad5b4c3335ed89ea3a0bf2a8f5daefc9cc9139a852e9821da062386fbfa8bf90ea8460d83f934ff2217a0a5046c96da5d921b748c2be085df0f3bb304706d745bcbbaa8971ecb47c9c1d3a0933cd40363c46cb884def0910afdaaa73f2c5b6a971ad6aafcaeb3713fe7fc77a0f21d7502417571d83e0051aa89a22a9f5db3ed28a156cbed4c834ea6dffb143ea04bc008dff73230d7486ec7e5ee5cebaef0299392c896ac2db5f0b185e9671e38a01b30f2422f319d8fe1b2aa683150eddd70dc20e37ef26c1735310cbfb41efbfba03d1865427b072ade378bd827cd583820f6429156634503bc1725e0cd566742d2a07c746810a754aaff92701c06ed6fa9863a74a926b711ef501f4991eda79de42980", "0xf90211a068f32d6d7be310ff91ef5f5d87942a75da676d6926a2b0f08f0e75ad7d1c3bdca009a16734079febfe9ce97f0163b755ef0ff3038a4bd57215834285e2da6ed47da0928587011b7b11befc260c6c70318af8fd48e95beb9bb6260efeabd1577ec059a092dcab8930458eae86597c32b7ff02db1c32ea374c88f28cb40599e7dbbbdd87a08570b89be0304e8d95aa39e31fcad3d586c4e3b51301d9725a49fc9bb7d91487a0bfd9d6a0d5916475cfe5d19efd8d10ce2a561d64b882bd217279867945b97f8aa003d30f0ff021361287f95e78a51cbb439b64b533c88874d176ce658bfaada589a0c946248d6804c75357462afd7cb8f5a526c02a906ba3b8aa27aceb7513a2519da03d612f56aaf9aaddf6223b1faf7e28d7faf6a38af0a690db5b28ef22d7aac768a0e5d78bf0cdf67ef01dd033122800b3f87b699e9a962bc3fbea647b9cb7575f54a0c05bc8c5687fdbfc57205de7ca9024dd8064303f589f2fb94b8e85e40b9ad7a4a04238550152340e0fc8bcbecf1a7857d9845163157e10d585d29e0ed12b801246a03d5ca4840dc1b7dea2990fdf788db07fe69695cd60e37d3f80d7a3814cc55428a08b791892a8ec895d48547fd5b85962101d7f1ba23d47d5e1776c25e023891a1aa0e3d68c4880db3271a6831273bbae2f37111fe4bda712a4a21b356338273adf90a094c30c6f3a064928dc083147bf655d001918772d3ef71ee214d88fa533e8c77580", "0xf90211a03b779bc68e8d7ef4ac79867dd1411c1b59161d73bdb01407f5b517f86ed91843a01c62a131689b6319b3d4c0ea3a7c81fa8450873f820c32b76283628d30a74b18a0a2e07589e44b0a992f48555b3e2bcf0854d62899be00fa894aeedb68014921c0a0bc517e7bc83bace47d91660e112831e4b0dcb17a120a3db87f9394c28fc762eba0119e2ee871ec0972bf16425ef4c27f1e9413a404dab903debb024d0bff92553fa0815580f49ac6106cd67d24409e441323966567179f1ac7692ce6725a1fa50479a0ce8fb622b646834bd6a67a635326bc7345707e92af1a746850ccc6a4441160b6a05c49ef712bfc4f5ed0c7a32f2e500e8f45211097fa92f1972fb5bf7d200fe210a0aa4bc077e0d246482c19bf71e91b2e746910e7e2d23389939fd2038113c88992a07e00f5fb729f6e82e2623a0896dee11f368bf4ad67f111913c44e04e8f5f1ff6a04a005065b8412bb34792e5ee6f5c93039c81c04bd8497e07a79625a3be192a48a0fdf8b918b1700de6efde24bdfafa526a8c6363cc5968e5ff3913471cc15e47c9a032e582e4cf67c199899cc61190bb6afb633942c7607ae692c16c1634497f15f6a05eee8946aea51f41932011929b066e039d3024eaeaa7bcd01dbb9ec976e7c9c2a0b754855c84c1fbbf161bd264b992700cb44d13f35edafbd6ba33e4c011d72d94a093da6e700ce4260aba0702ec200f66c61290e4b1b75866137946babb0a2317de80", "0xf90211a022f6de99d3782e2f09ae6002686f874110f003885efec3560e7d1ab4bb7ace62a034d21603978a4103fb1447fefdc3b3b878762bc26c495305c3ef652a6675b60fa0049f4b30af24bc74d96a66e6cc3eb89c756b57a2463ae0c1ca58579fb760a4f5a09ae1d19e1ec0965a729343d847114e8cd2d45780d8f7fcaf25684680e31fdee0a0f71219e37d5ad564e67d8d22f48a39783f0486f703da9ae1e42a552ddf32cca6a000193f0fb93a912aa496533def6b395b6f47def956db81a58671ffeab6afc9bda0d95ddf822de993276525abe612d2a9cc37f48fbe1472d584390edd8bcfa9e90aa0f091f18b330e657d660a73c16d597f4985c2b567b17bf98c996443f3255300e9a06ee4724af8509fafe8e3d03715e7c1ce7cc56d16f77fb568b3c1fa8790d15a36a05e7fd0028fd6c1bed2d9bef9391e0e5b2b8f6a76c0828e378e4917c4f67584f1a017fadbf02ee3fe8eb31e5dd7f9da87871ff933d45be5edd11fb0362c5dbe20b1a028c1761bcbf7e63209bb5998470d0d7b946ec7c9f468b2ea5b9e3262b60d2313a02141d2ce04fa234e7dbfafac43b2e31734b1521471c9df85dd360cf28aeefc30a010706899ebcb80fb0787d7e35586269509bc78174bb06dd69c2e3535bd68fae4a027cc8ecfc3a49711c1957f56ca5488f700ffb228203ac7ffb96c3498038862f6a003db32ec2569fc138e8ae78127ecf4544eeece8f1e767c366c0b1cf6a5b9424980", "0xf90211a0fa7d7e47c40b208a0194812fd9a914591fb53268b283c8e0799ac15afd342fe8a05f728301e45a7cd83239cb37498840cb56ec0b0fedb2b29265172f91f57e36f4a088f21559ce5d6b18e1338e9d39f7738f61f55c87e2142254b2200aeaeaf35c91a08cd105716166f90ac8055e44d0eb6adc9548d9e6765b66f33f22cc04eb54964aa08b97a1cfaeb6bf2c0f4435b9d4904480f4f0fce6289171293bcf49d01bd02a86a0a3908598eb5c8caf4d0617bf247b8e03310e3534ca28b208453094fdcf822d1ca0f7776894fb6edbe4cbdd83ee8eb600aca7721a4a254223b1412acd0ea72b37c0a0dcea523e4ad6a92e2ae545c80cc2995dd617a835c547d0d3010804c9b2433732a01f2c7dc737e73cb685ed7c7453e3e0b1867687893b6f5b0cb6b8d1c0d675b547a0e111e3be73207e02fb1c08a5546d4413c56cfa2ac295a478c54330b560cc767da0458ef69d64ef91434095076f15199ab2adc6be6d0493bb37eca718dbba410842a054f67a48cc2a96c260de0222084b9233a3de4b2add87f6ef0d6a4d128743803ca0f8e1f8a2887a8f59e4487683d6eab8c08575e1b3966a4663b91534387daa27d5a03c79b337be774ef15f04e4393f3e418b599fe1d109e21fdfabc189261980a3b3a076ae52d26a3f44cdd9790594bf9399b6a43fceb3528f80f9aa0b23120bde3c36a0a41e87902efd8928abea6414781aa22f52ab183a21681edb308c6f1737fe4ddc80", "0xf90211a0b246f4bf2fd9514025ae2e808433e62bab194b6790af7ad8d7d186281df76722a0bed9429faf021959679e7c0d2bd09d4040ef6476a9ec80cb41e70c4af8946ebea00e5c88ea26113f0295d8c682f1526f2fa7906bc422bfe9cc8b8f869686e179d4a0b94a30e2218afad53a0eacc505ea552a8288457847fcae72555aac638b52c46ea0d6430dd23ef9889e1272e494530d6ec89f080c49bf09f8a6ac634b153fa8ce5ca0e8c4de149f9b385e51fb66516a4d91b62dbd80ddedd4522e14d370da47f63e5aa0fa40fc95a8bdd7126c4db03b0c1a20c654aa22cf6f72024c4a0925d6f29fc9baa036f9144068edd92dfe87ad4d07791274f581e64d2387ebcc80296c895d84dc42a06786a2292778a633b795798f28f9876b5ff496db2e6ae19ae3e79f698c890bf0a0d18e42474e815b62da57cf67bcd8ed1c90d4f8ecf8f6d0b2e66b9656be2686ada0e4dc3683f731f21c0c34a10d7ffac39b20a64ac326269433a5cacaeb90a8a17da0e3f8b04c275387c6222b6536967f2f1e6fc76dc6ee0e705d3e505f3d07e8bdd4a0e165791b28cadfb44915d52906238e2dfcc8cd3b9eca4536bed4aebc5f4cb79da022b542269e108a24dc0ed74e62fc571185dcf398acfbf15a7fb6ce3e8aba50d6a0f29369f8c3d70bc9f472c2175ab5495edcf35a65527f67d391068c0275284307a0c93bd89abbea5ae96496a12d236323d11d2da9cde7a3b9fdb15d504f4ea1eda680", "0xf90151a000595129cf1c67ce97ed615df7184fb47a0d018d9147a2a7952a639e464cdfd380a052081f67d885b439bee62a1c4e09c02a1ec729aef4d92be6584a29141a79c5c7a0d99cae2bc3b6fc3e8e2767b4d7a5884b9b2d9d20da7890318beefcdb9c7346d58080a0f63571735d99e763dafadb03d1abe3a93a98740ecddc8514d13df46a35a8d94680a081870f4697e57436ccdd8bdc1d624d7bc07861748ff8b3a352334df68f2c03ada0f0252504ee8753335ecf0ca1f73cf13d4505783ed5110bf4e9b384a68ad88f69a0d38a18ef7b993c9ad2d848453e7722c26998ff3d63e243b99cdab0dabf84157ea06e5ad479dbda7f1647ed613e35d837f5d2c697ef34160f3665173186553ee9c280a0bf8371cac505b6ea0cb0f67ef744713f306a2455f3f8844cfa527c62db59c69980a0d6d689405b1cf73786c5fdabb55ec22f9b5712d1ba9c0bfcd46d4b93721fcac780", "0xf8669d37f29e142d49f8824d4e7f1735ec3da219687387629b5fccd86812df84b846f8440180a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a01d93f60f105899172f7255c030301c3af4564edd4a48577dbdc448aec7ddb0ac" ], "balance": "0x0", "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470", "nonce": "0x0", "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "storageProof": [ { "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "value": "0x0", "proof": [] } ] } } ``` # eth\_getStorageAt **Returns the value from a storage position at a given address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getstorageat) **Parameters** 1. `DATA`, 20 Bytes - address of the storage. REQUIRED 2. `QUANTITY` - integer of the position in the storage. REQUIRED 3. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `DATA` - the value at this storage position. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0000000000000000000000000000000000000000000000000000000000000000" } ``` # eth\_getTransactionByBlockHashAndIndex **Returns information about a transaction by block hash and transaction index position.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyblockhashandindex) **Parameters** 1. `DATA`, 32 Bytes - hash of a block. REQUIRED 2. `QUANTITY` - integer of the transaction index position. REQUIRED **Returns** `Object` - A transaction object, or `null` when no transaction was found: * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. `null` when its pending. * `blockNumber`: `QUANTITY` - block number where this transaction was in. `null` when its pending. * `from`: `DATA`, 20 Bytes - address of the sender. * `gas`: `QUANTITY` - gas provided by the sender. * `gasPrice`: `QUANTITY` - gas price provided by the sender in Wei. * `hash`: `DATA`, 32 Bytes - hash of the transaction. * `input`: `DATA` - the data send along with the transaction. * `nonce`: `QUANTITY` - the number of transactions made by the sender prior to this one. * `to`: `DATA`, 20 Bytes - address of the receiver. `null` when its a contract creation transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. `null` when its pending. * `value`: `QUANTITY` - value transferred in Wei. * `v`: `QUANTITY` - ECDSA recovery id * `r`: `QUANTITY` - ECDSA signature r * `s`: `QUANTITY` - ECDSA signature s ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getTransactionByBlockHashAndIndex", "params": ["0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "0x0"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "from": "0xae2fc483527b8ef99eb5d9b44875f005ba1fae13", "gas": "0x4515f", "gasPrice": "0x6a44cc24f", "maxFeePerGas": "0x6a44cc24f", "maxPriorityFeePerGas": "0x0", "hash": "0x6ac3b69c7cf01be86bb4600781fc9840e5f46ec714e17c3bd1e1d00fc05c30dc", "input": "0x01341996a0e584d8f99dec32b9d2f4edfa7c2036769c8d0536cfcb391a81a460ea6fd96a73d5672f1f4aa684697d4b44cc038d27280023bc80c92d", "nonce": "0x11f0f9", "to": "0x6b75d8af000000e20b7a7ddf000ba900b4009a80", "transactionIndex": "0x0", "value": "0x34327eb", "type": "0x2", "accessList": [ { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "storageKeys": [ "0x12231cd4c753cb5530a43a74c45106c24765e6f81dc8927d4f4be7e53315d5a8", "0x22005c0d64c5ceb5918f111eba7d3133da5f1edf0b66edb57b7122083bc72305", "0x69cca0f4d624fd4aace8d6acb115f9667fa5fb9dbc2f95c1ba1dac3dfa772a23" ] }, { "address": "0x96a0e584d8f99dec32b9d2f4edfa7c2036769c8d", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006" ] }, { "address": "0x374887ef78222c6bff0b0047e44ad2ed3ace07f3", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000005", "0x59c5a0582853b22cec98b71efaf11d4e6e716112079a141dde18505c4b33c6eb", "0x001ad44e8e7a5296af41ce323084e494eda0e398ff1a7eb16db0503d31de5e6f", "0xfc9f954ca7b2f8f907ce8f2fb41f6b47a0b71f38ddb5bf6d35bf28c11437ce30", "0x000000000000000000000000000000000000000000000000000000000000000e", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x9d47075c5aa4f61816fd5980980bfffbeb5144c1418ad15362d36c673ab74c51", "0x5360a0c34bd7ba8a6e2c5a58cd447e1919ba274a38195a871f7b24f5009b16d4", "0x49d38e34930b9aaa105cc332325d4a561402847e01bf67532467755731c9cb6e" ] }, { "address": "0x81a460ea6fd96a73d5672f1f4aa684697d4b44cc", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006", "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c" ] }, { "address": "0x43d7e65b8ff49698d9550a7f315c87e67344fb59", "storageKeys": [ "0xc2bb861d233e1c95a905a377a41b39fea66a8e7909a8176255695b218b60dd2e", "0x0000000000000000000000000000000000000000000000000000000000000005", "0x0000000000000000000000000000000000000000000000000000000000000006", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x0000000000000000000000000000000000000000000000000000000000000007", "0xa73ce99dd8ac76dea6de890fa71300accfde755b97bf1c541aef9615de6bbc24", "0x9bb3e24e1534bce24e9896f3377327d742d6c1d430477b7ebc070c2eb64e3147" ] } ], "chainId": "0x1", "v": "0x0", "r": "0x93d386d4ce5dc9ea07b3d5a244328ff4af3c3512ac3bd9a84ae57379fc81a9fd", "s": "0x4aba43edb73da88422b9503135efdb5a6df82cc76805992a6413384a3170d78" } } ``` # eth\_getTransactionByBlockNumberAndIndex **Returns information about a transaction by block number and transaction index position.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyblockhashandindex) **Parameters** 1. `QUANTITY|TAG` - a block number, or the string `"earliest"`, `"latest"` or `"pending"`, as in the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block). REQUIRED 2. `QUANTITY` - the transaction index position. REQUIRED **Returns** `Object` - A transaction object, or `null` when no transaction was found: * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. `null` when its pending. * `blockNumber`: `QUANTITY` - block number where this transaction was in. `null` when its pending. * `from`: `DATA`, 20 Bytes - address of the sender. * `gas`: `QUANTITY` - gas provided by the sender. * `gasPrice`: `QUANTITY` - gas price provided by the sender in Wei. * `hash`: `DATA`, 32 Bytes - hash of the transaction. * `input`: `DATA` - the data send along with the transaction. * `nonce`: `QUANTITY` - the number of transactions made by the sender prior to this one. * `to`: `DATA`, 20 Bytes - address of the receiver. `null` when its a contract creation transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. `null` when its pending. * `value`: `QUANTITY` - value transferred in Wei. * `v`: `QUANTITY` - ECDSA recovery id * `r`: `QUANTITY` - ECDSA signature r * `s`: `QUANTITY` - ECDSA signature s ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getTransactionByBlockNumberAndIndex", "params": ["0x1127101", "0x0"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "from": "0xae2fc483527b8ef99eb5d9b44875f005ba1fae13", "gas": "0x4515f", "gasPrice": "0x6a44cc24f", "maxFeePerGas": "0x6a44cc24f", "maxPriorityFeePerGas": "0x0", "hash": "0x6ac3b69c7cf01be86bb4600781fc9840e5f46ec714e17c3bd1e1d00fc05c30dc", "input": "0x01341996a0e584d8f99dec32b9d2f4edfa7c2036769c8d0536cfcb391a81a460ea6fd96a73d5672f1f4aa684697d4b44cc038d27280023bc80c92d", "nonce": "0x11f0f9", "to": "0x6b75d8af000000e20b7a7ddf000ba900b4009a80", "transactionIndex": "0x0", "value": "0x34327eb", "type": "0x2", "accessList": [ { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "storageKeys": [ "0x12231cd4c753cb5530a43a74c45106c24765e6f81dc8927d4f4be7e53315d5a8", "0x22005c0d64c5ceb5918f111eba7d3133da5f1edf0b66edb57b7122083bc72305", "0x69cca0f4d624fd4aace8d6acb115f9667fa5fb9dbc2f95c1ba1dac3dfa772a23" ] }, { "address": "0x96a0e584d8f99dec32b9d2f4edfa7c2036769c8d", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006" ] }, { "address": "0x374887ef78222c6bff0b0047e44ad2ed3ace07f3", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000005", "0x59c5a0582853b22cec98b71efaf11d4e6e716112079a141dde18505c4b33c6eb", "0x001ad44e8e7a5296af41ce323084e494eda0e398ff1a7eb16db0503d31de5e6f", "0xfc9f954ca7b2f8f907ce8f2fb41f6b47a0b71f38ddb5bf6d35bf28c11437ce30", "0x000000000000000000000000000000000000000000000000000000000000000e", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x9d47075c5aa4f61816fd5980980bfffbeb5144c1418ad15362d36c673ab74c51", "0x5360a0c34bd7ba8a6e2c5a58cd447e1919ba274a38195a871f7b24f5009b16d4", "0x49d38e34930b9aaa105cc332325d4a561402847e01bf67532467755731c9cb6e" ] }, { "address": "0x81a460ea6fd96a73d5672f1f4aa684697d4b44cc", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006", "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c" ] }, { "address": "0x43d7e65b8ff49698d9550a7f315c87e67344fb59", "storageKeys": [ "0xc2bb861d233e1c95a905a377a41b39fea66a8e7909a8176255695b218b60dd2e", "0x0000000000000000000000000000000000000000000000000000000000000005", "0x0000000000000000000000000000000000000000000000000000000000000006", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x0000000000000000000000000000000000000000000000000000000000000007", "0xa73ce99dd8ac76dea6de890fa71300accfde755b97bf1c541aef9615de6bbc24", "0x9bb3e24e1534bce24e9896f3377327d742d6c1d430477b7ebc070c2eb64e3147" ] } ], "chainId": "0x1", "v": "0x0", "r": "0x93d386d4ce5dc9ea07b3d5a244328ff4af3c3512ac3bd9a84ae57379fc81a9fd", "s": "0x4aba43edb73da88422b9503135efdb5a6df82cc76805992a6413384a3170d78" } } ``` # eth\_getTransactionByHash **Returns the information about a transaction requested by transaction hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyhash) **Parameters** `DATA`, 32 Bytes - hash of a transaction REQUIRED **Returns** `Object` - A transaction object, or `null` when no transaction was found: * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. `null` when its pending. * `blockNumber`: `QUANTITY` - block number where this transaction was in. `null` when its pending. * `from`: `DATA`, 20 Bytes - address of the sender. * `gas`: `QUANTITY` - gas provided by the sender. * `gasPrice`: `QUANTITY` - gas price provided by the sender in Wei. * `hash`: `DATA`, 32 Bytes - hash of the transaction. * `input`: `DATA` - the data send along with the transaction. * `nonce`: `QUANTITY` - the number of transactions made by the sender prior to this one. * `to`: `DATA`, 20 Bytes - address of the receiver. `null` when its a contract creation transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. `null` when its pending. * `value`: `QUANTITY` - value transferred in Wei. * `v`: `QUANTITY` - ECDSA recovery id * `r`: `QUANTITY` - ECDSA signature r * `s`: `QUANTITY` - ECDSA signature s ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getTransactionByHash", "params": ["0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "from": "0x91aae0aafd9d2d730111b395c6871f248d7bd728", "gas": "0x493ee", "gasPrice": "0x6dfe78c4f", "maxFeePerGas": "0x8aafc45e4", "maxPriorityFeePerGas": "0x3b9aca00", "hash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "input": "0xce2e62ff0000000000000000000000000000000000000000000002394ff4aa9621fc5166000000000000000000000000000000000000000000000000000000005072bc2b0000000000000000000000005fa9569b0ed6aa01e234468e6a15b77988b950df0000000000000000000000005732046a883704404f284ce41ffadd5b007fd66800000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000064e78760", "nonce": "0xb1a68", "to": "0x98c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "transactionIndex": "0x49", "value": "0x0", "type": "0x2", "accessList": [], "chainId": "0x1", "v": "0x0", "r": "0x73c2ae9e22bcd48aacf101051ea98da7c9e60013c51895f8f5b992e4352fb99d", "s": "0x1c1034de7e633dc4d851b2770bd4d9922fde32c53f8647a26ed12df5b20b1551" } } ``` # eth\_getTransactionCount **Returns the number of transactions *****sent***** from an address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactioncount) **Parameters** 1. `DATA`, 20 Bytes - address. REQUIRED 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `QUANTITY` - integer of the number of transactions send from this address. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8", "latest" ], "method": "eth_getTransactionCount" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x31" } ``` # eth\_getTransactionReceipt **Returns the receipt of a transaction by transaction hash.** **Note** That the receipt is not available for pending transactions. [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionreceipt) **Parameters** `DATA`, 32 Bytes - hash of a transaction REQUIRED **Returns** `Object` - A transaction receipt object, or `null` when no receipt was found: * `transactionHash` : `DATA`, 32 Bytes - hash of the transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. * `blockNumber`: `QUANTITY` - block number where this transaction was in. * `from`: `DATA`, 20 Bytes - address of the sender. * `to`: `DATA`, 20 Bytes - address of the receiver. null when its a contract creation transaction. * `cumulativeGasUsed` : `QUANTITY` - The total amount of gas used when this transaction was executed in the block. * `effectiveGasPrice` : `QUANTITY` - The sum of the base fee and tip paid per unit of gas. * `gasUsed` : `QUANTITY` - The amount of gas used by this specific transaction alone. * `contractAddress` : `DATA`, 20 Bytes - The contract address created, if the transaction was a contract creation, otherwise `null`. * `logs`: `Array` - Array of log objects, which this transaction generated. * `logsBloom`: `DATA`, 256 Bytes - Bloom filter for light clients to quickly retrieve related logs. * `type`: `QUANTITY` - integer of the transaction type, `0x0` for legacy transactions, `0x1` for access list types, `0x2` for dynamic fees. It also returns *either* : * `root` : `DATA` 32 bytes of post-transaction stateroot (pre Byzantium) * `status`: `QUANTITY` either `1` (success) or `0` (failure) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4" ], "method": "eth_getTransactionReceipt" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "contractAddress": null, "cumulativeGasUsed": "0x4ee626", "effectiveGasPrice": "0x6dfe78c4f", "from": "0x91aae0aafd9d2d730111b395c6871f248d7bd728", "gasUsed": "0x1bf2a", "logs": [ { "address": "0x5732046a883704404f284ce41ffadd5b007fd668", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "0x0000000000000000000000005fa9569b0ed6aa01e234468e6a15b77988b950df" ], "data": "0x0000000000000000000000000000000000000000000002394ff4aa9621fc5166", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x8e", "removed": false }, { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000005fa9569b0ed6aa01e234468e6a15b77988b950df", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e" ], "data": "0x000000000000000000000000000000000000000000000000000000005075f5dd", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x8f", "removed": false }, { "address": "0x5fa9569b0ed6aa01e234468e6a15b77988b950df", "topics": [ "0x1c411e9a96e071241c2f21f7726b17ae89e3cab4c78be50e062b03a9fffbbad1" ], "data": "0x00000000000000000000000000000000000000000001ae47731be3af5b213fba0000000000000000000000000000000000000000000000000000003cadd1fa4c", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x90", "removed": false }, { "address": "0x5fa9569b0ed6aa01e234468e6a15b77988b950df", "topics": [ "0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e" ], "data": "0x0000000000000000000000000000000000000000000002394ff4aa9621fc516600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005075f5dd", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x91", "removed": false } ], "logsBloom": "0x00200000000000000000000080000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000408000008000000200000000000000000000000000000000000200000000000000000008000000000000000020000000000000010000000000000000000000800000000000000000000000000010000080000004000000000000000000000280000000000000000000000000000000000000000000000000000000002000800000000000000001000000000004000001000000000000000000002000000000000000000000000000000000000000000000000001000000000", "status": "0x1", "to": "0x98c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "type": "0x2" } } ``` # eth\_getUncleCountByBlockHash **Returns the number of uncles in a block from a block matching the given block hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getunclecountbyblockhash) **Parameters** `DATA`, 32 Bytes - hash of a block REQUIRED **Returns** `QUANTITY` - integer of the number of uncles in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getUncleCountByBlockHash", "params": ["0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0" } ``` # eth\_getUncleCountByBlockNumber **Returns the number of uncles in a block from a block matching the given block number.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getunclecountbyblocknumber) **Parameters** `QUANTITY|TAG` - integer of a block number, or the string "latest", "earliest" or "pending", see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `QUANTITY` - integer of the number of uncles in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getUncleCountByBlockNumber", "params": ["0x1127101"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0" } ``` # eth\_maxPriorityFeePerGas **Returns a fee per gas that is an estimate of how much you can pay as a priority fee, or 'tip', to get a transaction included in the current block.** **Parameters** 1. `DATA`, 20 Bytes - address. 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) **Returns** `QUANTITY` - integer of the number of transactions send from this address. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_maxPriorityFeePerGas" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x2faf080" } ``` # eth\_newBlockFilter Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call [eth\_getFilterChanges](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_getfilterchanges). [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newBlockFilter) **Parameters** None **Returns** `QUANTITY` - A filter id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_newBlockFilter" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x87a1252c71f5e32751e3fa806c80100" } ``` # eth\_newFilter Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call [eth\_getFilterChanges](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges). **A note on specifying topic filters:** Topics are order-dependent. A transaction with a log with topics \[A, B] will be matched by the following topic filters: * `[]` "anything" * `[A]` "A in first position (and anything after)" * `[null, B]` "anything in first position AND B in second position (and anything after)" * `[A, B]` "A in first position AND B in second position (and anything after)" * `[[A, B], [A, B]]` "(A OR B) in first position AND (A OR B) in second position (and anything after)" [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newfilter) **Parameters** `Object` - The filter options: * `fromBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `toBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `address`: `DATA|Array`, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate. * `topics`: `Array of DATA`, - (optional) Array of 32 Bytes `DATA` topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options. **Returns** `QUANTITY` - A filter id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_newFilter", "params": [ { "address": [ "0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907" ], "fromBlock": "0x429d3b", "toBlock": "latest", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75", "0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078" ] } ] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0xf3021ac72b556ec65bddf0851683a110" } ``` # eth\_newPendingTransactionFilter Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call [eth\_getFilterChanges](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges). [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newpendingtransactionfilter) **Parameters** None **Returns** `QUANTITY` - A filter id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_newPendingTransactionFilter" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x70da02cfdc54a8b372918200e792b30a" } ``` # eth\_uninstallFilter Uninstalls a filter with given id. Should always be called when watch is no longer needed. Additionally Filters timeout when they aren't requested with [eth\_getFilterChanges](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_getfilterchanges) for a period of time. [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_uninstallfilter) **Parameters** `QUANTITY` - The filter id. **Returns** `Boolean` - `true` if the filter was successfully uninstalled, otherwise `false`. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0x1" ], "method": "eth_uninstallFilter" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": false } ``` # eth\_sendRawTransaction Creates new message call transaction or a contract creation for signed transactions. [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_sendrawtransaction) **Parameters** `DATA`, The signed transaction data. **Returns** `DATA`, 32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available. Use [eth\_getTransactionReceipt](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_gettransactionreceipt) to get the contract address, after the transaction was mined, when you created a contract. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0x02f9013401830b1a68843b9aca008508aafc45e4830493ee9498c3d3183c4b8a650614ad179a1a98be0a8d6b8e80b8c4ce2e62ff0000000000000000000000000000000000000000000002394ff4aa9621fc5166000000000000000000000000000000000000000000000000000000005072bc2b0000000000000000000000005fa9569b0ed6aa01e234468e6a15b77988b950df0000000000000000000000005732046a883704404f284ce41ffadd5b007fd66800000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000064e78760c080a073c2ae9e22bcd48aacf101051ea98da7c9e60013c51895f8f5b992e4352fb99da01c1034de7e633dc4d851b2770bd4d9922fde32c53f8647a26ed12df5b20b1551" ], "method": "eth_sendRawTransaction" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4" } ``` # net\_listening **Returns true if client is actively listening for network connections.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#net_listening) **Parameters** None **Returns** `Boolean` - `true` when listening, otherwise `false`. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "net_listening" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": true } ``` # net\_peerCount **Returns number of peers currently connected to the client.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#net_peercount) **Parameters** None **Returns** `QUANTITY` - integer of the number of connected peers. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "net_peerCount" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x10" } ``` # net\_version **Returns the current network id.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#net_version) **Parameters** None **Returns** `String` - The current network id. The full list of current network IDs is available at [chainlist.org(opens in a new tab)↗](https://chainlist.org/). Some common ones are: * `1`: Ethereum Mainnet * `5`: Goerli testnet * `11155111`: Sepolia testnet ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "net_version" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "1" } ``` # web3\_sha3 **Returns Keccak-256 (*****not***** the standardized SHA3-256) of the given data.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#web3_sha3) **Parameters** `DATA` - the data to convert into a SHA3 hash REQUIRED **Returns** `DATA` - The SHA3 result of the given string. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0x68656c6c6f20776f726c64" ], "method": "web3_sha3" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad" } ``` # web3\_clientVersion **Returns the current client version.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#web3_clientversion) **Parameters** None **Returns** `String` - The current client version ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "web3_clientVersion" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "Geth/v1.12.0-stable-e501b3b0/linux-amd64/go1.20.3" } ``` # Avalanche (C-Chain) # Ethereum Standard JSON-RPC API # eth\_accounts **Returns a list of addresses owned by client. Due to privacy reasons, OMNIA does not store private keys, so this will always return an empty response.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_accounts) **Parameters** None **Returns** `Array of DATA`, 20 Bytes - addresses owned by the client. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_accounts" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": [] } ``` # eth\_blockNumber **Returns the number of most recent block.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_blocknumber) **Parameters** None **Returns** `QUANTITY` - integer of the current block number the client is on. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_blockNumber" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x4b7" // 1207 } ``` # eth\_call **Executes a new message call immediately without creating a transaction on the block chain. Often used for executing read-only smart contract functions, ofr example the `balanceOf` for an ERC-20 contract.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_call) **Parameters** 1. `Object` - The transaction call object * `from`: `DATA`, 20 Bytes - (optional) The address the transaction is sent from. * `to`: `DATA`, 20 Bytes - The address the transaction is directed to. REQUIRED * `gas`: `QUANTITY` - (optional) Integer of the gas provided for the transaction execution. eth\_call consumes zero gas, but this parameter may be needed by some executions. * `gasPrice`: `QUANTITY` - (optional) Integer of the gasPrice used for each paid gas * `value`: `QUANTITY` - (optional) Integer of the value sent with this transaction * `data`: `DATA` - (optional) Hash of the method signature and encoded parameters. For details see [Ethereum Contract ABI in the Solidity documentation(opens in a new tab)↗](https://docs.soliditylang.org/en/latest/abi-spec.html) 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `DATA` - the return value of executed contract. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_call", "params": [ { "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x00", "gasPrice": "0x09184e72a000", "value": "0x00", "data": "0x" } ] } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x" } ``` # eth\_chainId **Returns the chain ID used for signing replay-protected transactions.**\ \ Note: for browsing Ethereum chain IDs, one can use [chainlist.org](https://chainlist.org) [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_chainid) **Parameters** `None` **Returns** `chainId`, hexadecimal value as a string representing the integer of the current chain id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_chainId" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x1" } ``` # eth\_estimateGas **Generates and returns an estimate of how much gas is necessary to allow the transaction to complete. The transaction will not be added to the blockchain. Note that the estimate may be significantly more than the amount of gas actually used by the transaction, for a variety of reasons including EVM mechanics and node performance.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_estimategas) **Parameters** See [eth\_call](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_call) parameters, except that all properties are optional. If no gas limit is specified geth uses the block gas limit from the pending block as an upper bound. As a result the returned estimate might not be enough to executed the call/transaction when the amount of gas is higher than the pending block gas limit. **Returns** `QUANTITY` - the amount of gas used. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_estimateGas", "params": [ { "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x00", "gasPrice": "0x09184e72a000", "value": "0x00", "data": "0x" }, { "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x00", "gasPrice": "0x09184e72a000", "value": "0x00", "data": "0x" } ] } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x5208" // 21000 } ``` # eth\_feeHistory **Returns a collection of historical gas information.** **Parameters** * `BLOCKCOUNT` - Number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. Less than requested may be returned if not all blocks are available. REQUIRED * `NEWESTBLOCK` - Highest number block of the requested range. REQUIRED * `REWARDPERCENTILES` - (optional) A monotonically increasing list of percentile values to sample from each block's effective priority fees per gas in ascending order, weighted by gas used. REQUIRED **Returns** `Object` * `OLDESTBLOCK` - Lowest number block of the returned range. * `BASEFEEPERGAS` - An array of block base fees per gas. This includes the next block after the newest of the returned range, because this value can be derived from the newest block. Zeroes are returned for pre-EIP-1559 blocks. * `GASUSEDRATIO` - An array of block gas used ratios. These are calculated as the ratio of `gasUsed` and `gasLimit`. * `REWARD` - (Optional) An array of effective priority fees per gas data points from a single block. All zeroes are returned if the block is empty. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_feeHistory", "params": [4, "latest", [25, 75]] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "oldestBlock": "0x1126e25", "reward": [ [ "0x5f5e100", "0x77359400" ], [ "0x2faf080", "0x77359400" ], [ "0x5f5e100", "0x879a1444" ], [ "0x5f5e100", "0x3b9aca00" ] ], "baseFeePerGas": [ "0x6bfc13a7a", "0x6a447cc2e", "0x6a550c5dd", "0x67834a299", "0x6cf5d92f9" ], "gasUsedRatio": [ 0.43639296666666666, 0.5024350333333333, 0.3939411, 0.7105050666666667 ] } } ``` # eth\_gasPrice **Returns the current gas price on the network in wei.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gasprice) **Parameters** None **Returns** `QUANTITY` - integer of the current gas price in wei. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_gasPrice" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x1dfd14000" // 8049999872 Wei } ``` # eth\_getBalance **Returns the balance of the account of given address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance) **Parameters** 1. `DATA`, 20 Bytes - address to check for balance. REQUIRED 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `QUANTITY` - integer of the current balance in wei. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8", "latest" ], "method": "eth_getBalance" } ' ``` #### Response ``` { "id":1, "jsonrpc": "2.0", "result": "0x0234c8a3397aab58" // 158972490234375000 } ``` # eth\_getBlockByHash **Returns information about a block by hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblockbyhash) **Parameters** 1. `DATA`, 32 Bytes - Hash of a block. REQUIRED 2. `Boolean` - If `true` it returns the full transaction objects, if `false` only the hashes of the transactions. **Returns** `Object` - A block object, or `null` when no block was found: * `number`: `QUANTITY` - the block number. `null` when its pending block. * `hash`: `DATA`, 32 Bytes - hash of the block. `null` when its pending block. * `parentHash`: `DATA`, 32 Bytes - hash of the parent block. * `nonce`: `DATA`, 8 Bytes - hash of the generated proof-of-work. `null` when its pending block. * `sha3Uncles`: `DATA`, 32 Bytes - SHA3 of the uncles data in the block. * `logsBloom`: `DATA`, 256 Bytes - the bloom filter for the logs of the block. `null` when its pending block. * `transactionsRoot`: `DATA`, 32 Bytes - the root of the transaction trie of the block. * `stateRoot`: `DATA`, 32 Bytes - the root of the final state trie of the block. * `receiptsRoot`: `DATA`, 32 Bytes - the root of the receipts trie of the block. * `miner`: `DATA`, 20 Bytes - the address of the beneficiary to whom the mining rewards were given. * `difficulty`: `QUANTITY` - integer of the difficulty for this block. * `totalDifficulty`: `QUANTITY` - integer of the total difficulty of the chain until this block. * `extraData`: `DATA` - the "extra data" field of this block. * `size`: `QUANTITY` - integer the size of this block in bytes. * `gasLimit`: `QUANTITY` - the maximum gas allowed in this block. * `gasUsed`: `QUANTITY` - the total used gas by all transactions in this block. * `timestamp`: `QUANTITY` - the unix timestamp for when the block was collated. * `transactions`: `Array` - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter. * `uncles`: `Array` - Array of uncle hashes. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockByHash", "params": [ "0xe76d777791f48b5995d20789183514f4aa8bbf09e357383e9a44fae025c6c50a", false ] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "baseFeePerGas": "0x2f99b1dd0", "difficulty": "0x0", "extraData": "0x4d616465206f6e20746865206d6f6f6e20627920426c6f636b6e6174697665", "gasLimit": "0x1c9c380", "gasUsed": "0x1699c83", "hash": "0xe76d777791f48b5995d20789183514f4aa8bbf09e357383e9a44fae025c6c50a", "logsBloom": "0x1c243c7f96541e048c0cc481b0ac333461c12804d880990dfe1980c41c2a49aca538425bc4030022419e3fe80ce6a1819e0c8cbccaec3511034bc7c75a6424b148b3809049eb1a8b6a088bc9629304fa84666835856e23084c00b81191002810d6710c00834290e38544008cba206a7bf4891881609a144000d000b00c896c90b21805320683810d20c90c0810064069f4001911c10a0409400c615e0a34316d8b29c9d4298d7b191a6819811f118c01801021715096405280cbaa4326b1460ca46c66432390d05001c0341a2c82305750c027f4d2ae10971254a94321a9f2132090a00e1f0110b18567920180818fc6b1100e8af2e84040a0408c144015d213", "miner": "0xbaf6dc2e647aeb6f510f9e318856a1bcd66c5e19", "mixHash": "0xe8ad228f6a0f7c79bd2f8273f717a06f47b271f41d748718699bb966f710fc9b", "nonce": "0x0000000000000000", "number": "0xf8e3d7", "parentHash": "0xbef5b480684b03c0c3ff58deec762cf6650de5b71da431e85d908cca221a10b2", "receiptsRoot": "0xce65ddb737ae93370c63077c742ba190d917fbe0876a9a1f9d793d5b125fa04a", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x9684", "stateRoot": "0xc57cf792e5cdff63c582e03084a7d21748196f1c6a97171d2b4e07417fa5df2e", "timestamp": "0x63b15d3b", "totalDifficulty": "0xc70d815d562d3cfa955", "transactions": [ "0x501251dd9097bcba3074c7e699be2bc28a343228e321251342188a34e9e54871", "0x1e4009ac7b59a0a64fe3f42918185a160ce22ad666215fa182ea1d927a8e1a22", "0xa04bdde31cba595dbb6749b4b2f4c712119d1f40c94c402592c2922416dd08a1", "0xdc23dd5f6c6ba68d6e73227b5dda9ddd5168beb829fdc3b432ae5d1755022c3b", "0x67c6d7216f8a7acce412dcdecea36bc983e040d16f9a594f4f89d785d9b960a3" ... ], "transactionsRoot": "0x0cf6abfa0c1f1f8e031dad7a314c5b130099dcf340d39d840accc778cb623f64", "uncles": [] } } ``` # eth\_getBlockByNumber **Returns information about a block by block number.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblockbyhash) **Parameters** 1. `QUANTITY|TAG` - integer of a block number, or the string `"earliest"`, `"latest"` or `"pending"`, as in the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block). REQUIRED 2. `Boolean` - If `true` it returns the full transaction objects, if `false` only the hashes of the transactions. REQUIRED **Returns** See [eth\_getBlockByHash](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_getblockbyhash) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockByNumber", "params": [ "0x1b4", true ] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "difficulty": "0x4ea3f27bc", "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32", "gasLimit": "0x1388", "gasUsed": "0x0", "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171", "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843", "nonce": "0x689056015818adbe", "number": "0x1b4", "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54", "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "size": "0x220", "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d", "timestamp": "0x55ba467c", "totalDifficulty": "0x78ed983323d", "transactions": [], "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "uncles": [] } } ``` # eth\_getBlockTransactionCountByHash **Returns the number of transactions in a block from a block matching the given block hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblocktransactioncountbyhash) **Parameters** `DATA`, 32 Bytes - hash of a block REQUIRED **Returns** `QUANTITY` - integer of the number of transactions in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockTransactionCountByHash" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0xb0" } ``` # eth\_getBlockTransactionCountByNumber **Returns the number of transactions in a block matching the given block number.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblocktransactioncountbyhash) **Parameters** `QUANTITY|TAG` - integer of a block number, or the string `"earliest"`, `"latest"` or `"pending"`, as in the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block). REQUIRED **Returns** `QUANTITY` - integer of the number of transactions in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getBlockTransactionCountByNumber", "params": ["0xe8"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0" } ``` # eth\_getCode **Returns (the smart contract) code at a given address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getblocktransactioncountbyhash) **Parameters** 1. `DATA`, 20 Bytes - address REQUIRED 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `DATA` - the code from the given address. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getCode", "params": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "latest"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x60806040526004361061006d576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff1680633659cfe6146100775780634f1ef286146100ba5780635c60da1b146101085780638f2839701461015f578063f851a440146101a2575b6100756101f9565b005b34801561008357600080fd5b506100b8600480360381019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050610213565b005b610106600480360381019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190803590602001908201803590602001919091929391929390505050610268565b005b34801561011457600080fd5b5061011d610308565b604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b34801561016b57600080fd5b506101a0600480360381019080803573ffffffffffffffffffffffffffffffffffffffff169060200190929190505050610360565b005b3480156101ae57600080fd5b506101b761051e565b604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390f35b610201610576565b61021161020c610651565b610682565b565b61021b6106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561025c57610257816106d9565b610265565b6102646101f9565b5b50565b6102706106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102fa576102ac836106d9565b3073ffffffffffffffffffffffffffffffffffffffff163483836040518083838082843782019150509250505060006040518083038185875af19250505015156102f557600080fd5b610303565b6103026101f9565b5b505050565b60006103126106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156103545761034d610651565b905061035d565b61035c6101f9565b5b90565b6103686106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561051257600073ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614151515610466576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260368152602001807f43616e6e6f74206368616e6765207468652061646d696e206f6620612070726f81526020017f787920746f20746865207a65726f20616464726573730000000000000000000081525060400191505060405180910390fd5b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f61048f6106a8565b82604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019250505060405180910390a161050d81610748565b61051b565b61051a6101f9565b5b50565b60006105286106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16141561056a576105636106a8565b9050610573565b6105726101f9565b5b90565b61057e6106a8565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614151515610647576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260328152602001807f43616e6e6f742063616c6c2066616c6c6261636b2066756e6374696f6e20667281526020017f6f6d207468652070726f78792061646d696e000000000000000000000000000081525060400191505060405180910390fd5b61064f610777565b565b6000807f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c36001029050805491505090565b3660008037600080366000845af43d6000803e80600081146106a3573d6000f35b3d6000fd5b6000807f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b6001029050805491505090565b6106e281610779565b7fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b81604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a150565b60007f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b60010290508181555050565b565b60006107848261084b565b151561081e576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603b8152602001807f43616e6e6f742073657420612070726f787920696d706c656d656e746174696f81526020017f6e20746f2061206e6f6e2d636f6e74726163742061646472657373000000000081525060400191505060405180910390fd5b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c360010290508181555050565b600080823b9050600081119150509190505600a165627a7a72305820a4a547cfc7202c5acaaae74d428e988bc62ad5024eb0165532d3a8f91db4ed240029" } ``` # eth\_getFilterChanges **Polling method for a filter, which returns an array of logs which occurred since last poll.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges) **Parameters** `QUANTITY` - the filter id. REQUIRED **Returns** `Array` - Array of log objects, or an empty array if nothing has changed since last poll. * For filters created with `eth_newBlockFilter` the return are block hashes (`DATA`, 32 Bytes), e.g. `["0x3454645634534..."]`. * For filters created with `eth_newPendingTransactionFilter` the return are transaction hashes (`DATA`, 32 Bytes), e.g. `["0x6345343454645..."]`. * For filters created with `eth_newFilter` logs are objects with following params: * `removed`: `TAG` - `true` when the log was removed, due to a chain reorganization. `false` if its a valid log. * `logIndex`: `QUANTITY` - integer of the log index position in the block. `null` when its pending log. * `transactionIndex`: `QUANTITY` - integer of the transactions index position log was created from. `null` when its pending log. * `transactionHash`: `DATA`, 32 Bytes - hash of the transactions this log was created from. `null` when its pending log. * `blockHash`: `DATA`, 32 Bytes - hash of the block where this log was in. `null` when its pending. `null` when its pending log. * `blockNumber`: `QUANTITY` - the block number where this log was in. `null` when its pending. `null` when its pending log. * `address`: `DATA`, 20 Bytes - address from which this log originated. * `data`: `DATA` - contains one or more 32 Bytes non-indexed arguments of the log. * `topics`: `Array of DATA` - Array of 0 to 4 32 Bytes `DATA` of indexed log arguments. (In *solidity*: The first topic is the *hash* of the signature of the event (e.g. `Deposit(address,bytes32,uint256)`), except you declared the event with the `anonymous` specifier.) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params":["0x16"], "method": "eth_getFilterChanges" } ' ``` #### Response ``` { "id":1, "jsonrpc":"2.0", "result": [{ "logIndex": "0x1", // 1 "blockNumber":"0x1b4", // 436 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d", "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf", "transactionIndex": "0x0", // 0 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d", "data":"0x0000000000000000000000000000000000000000000000000000000000000000", "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"] },{ ... }] } ``` # eth\_getFilterLogs **Returns an array of all logs matching filter with given id.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterlogs) **Parameters** `QUANTITY` - the filter id. REQUIRED **Returns** `Array` - Array of log objects, or an empty array if nothing has changed since last poll. * For filters created with `eth_newBlockFilter` the return are block hashes (`DATA`, 32 Bytes), e.g. `["0x3454645634534..."]`. * For filters created with `eth_newPendingTransactionFilter` the return are transaction hashes (`DATA`, 32 Bytes), e.g. `["0x6345343454645..."]`. * For filters created with `eth_newFilter` logs are objects with following params: * `removed`: `TAG` - `true` when the log was removed, due to a chain reorganization. `false` if its a valid log. * `logIndex`: `QUANTITY` - integer of the log index position in the block. `null` when its pending log. * `transactionIndex`: `QUANTITY` - integer of the transactions index position log was created from. `null` when its pending log. * `transactionHash`: `DATA`, 32 Bytes - hash of the transactions this log was created from. `null` when its pending log. * `blockHash`: `DATA`, 32 Bytes - hash of the block where this log was in. `null` when its pending. `null` when its pending log. * `blockNumber`: `QUANTITY` - the block number where this log was in. `null` when its pending. `null` when its pending log. * `address`: `DATA`, 20 Bytes - address from which this log originated. * `data`: `DATA` - contains one or more 32 Bytes non-indexed arguments of the log. * `topics`: `Array of DATA` - Array of 0 to 4 32 Bytes `DATA` of indexed log arguments. (In *solidity*: The first topic is the *hash* of the signature of the event (e.g. `Deposit(address,bytes32,uint256)`), except you declared the event with the `anonymous` specifier.) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0x1" ], "method": "eth_getFilterLogs" } ' ``` #### Response ``` { "id":1, "jsonrpc":"2.0", "result": [{ "logIndex": "0x1", // 1 "blockNumber":"0x1b4", // 436 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d", "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf", "transactionIndex": "0x0", // 0 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d", "data":"0x0000000000000000000000000000000000000000000000000000000000000000", "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"] },{ ... }] } ``` # eth\_getLogs **Returns an array of all logs matching a given filter object.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getlogs) **Parameters** `QUANTITY` - the filter id. **Returns** `Object` - The filter options: * `fromBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `toBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `address`: `DATA|Array`, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate. * `topics`: `Array of DATA`, - (optional) Array of 32 Bytes `DATA` topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options. * `blockhash`: `DATA`, 32 Bytes - (optional, **future**) With the addition of EIP-234, `blockHash` will be a new filter option which restricts the logs returned to the single block with the 32-byte hash `blockHash`. Using `blockHash` is equivalent to `fromBlock` = `toBlock` = the block number with hash `blockHash`. If `blockHash` is present in the filter criteria, then neither `fromBlock` nor `toBlock` are allowed. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [{"topics":["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]}], "method": "eth_getLogs" } ' ``` #### Response ``` { "id":1, "jsonrpc":"2.0", "result": [{ "logIndex": "0x1", // 1 "blockNumber":"0x1b4", // 436 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d", "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf", "transactionIndex": "0x0", // 0 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d", "data":"0x0000000000000000000000000000000000000000000000000000000000000000", "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"] },{ ... }] } ``` # eth\_getProof **Returns the account and storage values of the specified account including the Merkle-proof. This call can be used to verify that the data you are pulling from is not tampered with.** **Parameters** 1. `DATA`, 20 Bytes - address of the account. REQUIRED 2. `ARRAY`, 32 Bytes - an array of storage-keys that should be proofed and included. See [`eth_getStorageAt`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getstorageat) 3. `QUANTITY|TAG` - integer block number, or the string `"latest"` or `"earliest"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) **Returns** `Object` - A account object: * `balance`: `QUANTITY` - the balance of the account. See[`eth_getBalance`](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_getbalance) * `codeHash`: `DATA`, 32 Bytes - hash of the code of the account. For a simple Account without code it will return `"0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470"` * `nonce`: `QUANTITY`, - nonce of the account. See [`eth_getTransactionCount`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactioncount) * `storageHash`: `DATA`, 32 Bytes - SHA3 of the StorageRoot. All storage will deliver a MerkleProof starting with this `rootHash`. * `accountProof`: `ARRAY` - Array of rlp-serialized MerkleTree-Nodes, starting with the stateRoot-Node, following the path of the SHA3 (address) as key. * `storageProof`: `ARRAY` - Array of storage-entries as requested. Each entry is an object with these properties: * `key`: `QUANTITY` - the requested storage key * `value`: `QUANTITY` - the storage value * `proof`: `ARRAY` - Array of rlp-serialized MerkleTree-Nodes, starting with the storageHash-Node, following the path of the SHA3 (key) as path. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "jsonrpc":"2.0", "method":"eth_getProof", "params":["0x7F0d15C7FAae65896648C8273B6d7E43f58Fa842",["0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"],"latest"], "id":1 } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "address": "0x7f0d15c7faae65896648c8273b6d7e43f58fa842", "accountProof": [ "0xf90211a02fc15d4c68a4ad02dfc51b4e4f30eb0aeb246aa43bdd3062e1d4eef602c84eeca06f0f8375607e337ba12c00d074383c79387c0116a76b915d7d9975f0e59c8770a0230e6cf36da8966845ddfcde1878bc51f892b0b279c507140461a21396decfafa08d26cc53d876043cd4836d40df7c97f5ce37d21b5af10069d5adc8014bdf5da7a0be54bac27145c3b67e8f36fb0ddd8e09e3ed326bb9386bfabc7181cc67e9a7e2a06b46918e7188af10e0f742ba03178dba0fe4b664aa6989a3087be6a4f1cedf39a03397313377bd5c329ef76be72544480e017492aafd1d6d2af4b785c75d1614afa0a387f86581aa272e700766c6873b5c62e4ced032c518ecdad5b4c3335ed89ea3a0bf2a8f5daefc9cc9139a852e9821da062386fbfa8bf90ea8460d83f934ff2217a0a5046c96da5d921b748c2be085df0f3bb304706d745bcbbaa8971ecb47c9c1d3a0933cd40363c46cb884def0910afdaaa73f2c5b6a971ad6aafcaeb3713fe7fc77a0f21d7502417571d83e0051aa89a22a9f5db3ed28a156cbed4c834ea6dffb143ea04bc008dff73230d7486ec7e5ee5cebaef0299392c896ac2db5f0b185e9671e38a01b30f2422f319d8fe1b2aa683150eddd70dc20e37ef26c1735310cbfb41efbfba03d1865427b072ade378bd827cd583820f6429156634503bc1725e0cd566742d2a07c746810a754aaff92701c06ed6fa9863a74a926b711ef501f4991eda79de42980", "0xf90211a068f32d6d7be310ff91ef5f5d87942a75da676d6926a2b0f08f0e75ad7d1c3bdca009a16734079febfe9ce97f0163b755ef0ff3038a4bd57215834285e2da6ed47da0928587011b7b11befc260c6c70318af8fd48e95beb9bb6260efeabd1577ec059a092dcab8930458eae86597c32b7ff02db1c32ea374c88f28cb40599e7dbbbdd87a08570b89be0304e8d95aa39e31fcad3d586c4e3b51301d9725a49fc9bb7d91487a0bfd9d6a0d5916475cfe5d19efd8d10ce2a561d64b882bd217279867945b97f8aa003d30f0ff021361287f95e78a51cbb439b64b533c88874d176ce658bfaada589a0c946248d6804c75357462afd7cb8f5a526c02a906ba3b8aa27aceb7513a2519da03d612f56aaf9aaddf6223b1faf7e28d7faf6a38af0a690db5b28ef22d7aac768a0e5d78bf0cdf67ef01dd033122800b3f87b699e9a962bc3fbea647b9cb7575f54a0c05bc8c5687fdbfc57205de7ca9024dd8064303f589f2fb94b8e85e40b9ad7a4a04238550152340e0fc8bcbecf1a7857d9845163157e10d585d29e0ed12b801246a03d5ca4840dc1b7dea2990fdf788db07fe69695cd60e37d3f80d7a3814cc55428a08b791892a8ec895d48547fd5b85962101d7f1ba23d47d5e1776c25e023891a1aa0e3d68c4880db3271a6831273bbae2f37111fe4bda712a4a21b356338273adf90a094c30c6f3a064928dc083147bf655d001918772d3ef71ee214d88fa533e8c77580", "0xf90211a03b779bc68e8d7ef4ac79867dd1411c1b59161d73bdb01407f5b517f86ed91843a01c62a131689b6319b3d4c0ea3a7c81fa8450873f820c32b76283628d30a74b18a0a2e07589e44b0a992f48555b3e2bcf0854d62899be00fa894aeedb68014921c0a0bc517e7bc83bace47d91660e112831e4b0dcb17a120a3db87f9394c28fc762eba0119e2ee871ec0972bf16425ef4c27f1e9413a404dab903debb024d0bff92553fa0815580f49ac6106cd67d24409e441323966567179f1ac7692ce6725a1fa50479a0ce8fb622b646834bd6a67a635326bc7345707e92af1a746850ccc6a4441160b6a05c49ef712bfc4f5ed0c7a32f2e500e8f45211097fa92f1972fb5bf7d200fe210a0aa4bc077e0d246482c19bf71e91b2e746910e7e2d23389939fd2038113c88992a07e00f5fb729f6e82e2623a0896dee11f368bf4ad67f111913c44e04e8f5f1ff6a04a005065b8412bb34792e5ee6f5c93039c81c04bd8497e07a79625a3be192a48a0fdf8b918b1700de6efde24bdfafa526a8c6363cc5968e5ff3913471cc15e47c9a032e582e4cf67c199899cc61190bb6afb633942c7607ae692c16c1634497f15f6a05eee8946aea51f41932011929b066e039d3024eaeaa7bcd01dbb9ec976e7c9c2a0b754855c84c1fbbf161bd264b992700cb44d13f35edafbd6ba33e4c011d72d94a093da6e700ce4260aba0702ec200f66c61290e4b1b75866137946babb0a2317de80", "0xf90211a022f6de99d3782e2f09ae6002686f874110f003885efec3560e7d1ab4bb7ace62a034d21603978a4103fb1447fefdc3b3b878762bc26c495305c3ef652a6675b60fa0049f4b30af24bc74d96a66e6cc3eb89c756b57a2463ae0c1ca58579fb760a4f5a09ae1d19e1ec0965a729343d847114e8cd2d45780d8f7fcaf25684680e31fdee0a0f71219e37d5ad564e67d8d22f48a39783f0486f703da9ae1e42a552ddf32cca6a000193f0fb93a912aa496533def6b395b6f47def956db81a58671ffeab6afc9bda0d95ddf822de993276525abe612d2a9cc37f48fbe1472d584390edd8bcfa9e90aa0f091f18b330e657d660a73c16d597f4985c2b567b17bf98c996443f3255300e9a06ee4724af8509fafe8e3d03715e7c1ce7cc56d16f77fb568b3c1fa8790d15a36a05e7fd0028fd6c1bed2d9bef9391e0e5b2b8f6a76c0828e378e4917c4f67584f1a017fadbf02ee3fe8eb31e5dd7f9da87871ff933d45be5edd11fb0362c5dbe20b1a028c1761bcbf7e63209bb5998470d0d7b946ec7c9f468b2ea5b9e3262b60d2313a02141d2ce04fa234e7dbfafac43b2e31734b1521471c9df85dd360cf28aeefc30a010706899ebcb80fb0787d7e35586269509bc78174bb06dd69c2e3535bd68fae4a027cc8ecfc3a49711c1957f56ca5488f700ffb228203ac7ffb96c3498038862f6a003db32ec2569fc138e8ae78127ecf4544eeece8f1e767c366c0b1cf6a5b9424980", "0xf90211a0fa7d7e47c40b208a0194812fd9a914591fb53268b283c8e0799ac15afd342fe8a05f728301e45a7cd83239cb37498840cb56ec0b0fedb2b29265172f91f57e36f4a088f21559ce5d6b18e1338e9d39f7738f61f55c87e2142254b2200aeaeaf35c91a08cd105716166f90ac8055e44d0eb6adc9548d9e6765b66f33f22cc04eb54964aa08b97a1cfaeb6bf2c0f4435b9d4904480f4f0fce6289171293bcf49d01bd02a86a0a3908598eb5c8caf4d0617bf247b8e03310e3534ca28b208453094fdcf822d1ca0f7776894fb6edbe4cbdd83ee8eb600aca7721a4a254223b1412acd0ea72b37c0a0dcea523e4ad6a92e2ae545c80cc2995dd617a835c547d0d3010804c9b2433732a01f2c7dc737e73cb685ed7c7453e3e0b1867687893b6f5b0cb6b8d1c0d675b547a0e111e3be73207e02fb1c08a5546d4413c56cfa2ac295a478c54330b560cc767da0458ef69d64ef91434095076f15199ab2adc6be6d0493bb37eca718dbba410842a054f67a48cc2a96c260de0222084b9233a3de4b2add87f6ef0d6a4d128743803ca0f8e1f8a2887a8f59e4487683d6eab8c08575e1b3966a4663b91534387daa27d5a03c79b337be774ef15f04e4393f3e418b599fe1d109e21fdfabc189261980a3b3a076ae52d26a3f44cdd9790594bf9399b6a43fceb3528f80f9aa0b23120bde3c36a0a41e87902efd8928abea6414781aa22f52ab183a21681edb308c6f1737fe4ddc80", "0xf90211a0b246f4bf2fd9514025ae2e808433e62bab194b6790af7ad8d7d186281df76722a0bed9429faf021959679e7c0d2bd09d4040ef6476a9ec80cb41e70c4af8946ebea00e5c88ea26113f0295d8c682f1526f2fa7906bc422bfe9cc8b8f869686e179d4a0b94a30e2218afad53a0eacc505ea552a8288457847fcae72555aac638b52c46ea0d6430dd23ef9889e1272e494530d6ec89f080c49bf09f8a6ac634b153fa8ce5ca0e8c4de149f9b385e51fb66516a4d91b62dbd80ddedd4522e14d370da47f63e5aa0fa40fc95a8bdd7126c4db03b0c1a20c654aa22cf6f72024c4a0925d6f29fc9baa036f9144068edd92dfe87ad4d07791274f581e64d2387ebcc80296c895d84dc42a06786a2292778a633b795798f28f9876b5ff496db2e6ae19ae3e79f698c890bf0a0d18e42474e815b62da57cf67bcd8ed1c90d4f8ecf8f6d0b2e66b9656be2686ada0e4dc3683f731f21c0c34a10d7ffac39b20a64ac326269433a5cacaeb90a8a17da0e3f8b04c275387c6222b6536967f2f1e6fc76dc6ee0e705d3e505f3d07e8bdd4a0e165791b28cadfb44915d52906238e2dfcc8cd3b9eca4536bed4aebc5f4cb79da022b542269e108a24dc0ed74e62fc571185dcf398acfbf15a7fb6ce3e8aba50d6a0f29369f8c3d70bc9f472c2175ab5495edcf35a65527f67d391068c0275284307a0c93bd89abbea5ae96496a12d236323d11d2da9cde7a3b9fdb15d504f4ea1eda680", "0xf90151a000595129cf1c67ce97ed615df7184fb47a0d018d9147a2a7952a639e464cdfd380a052081f67d885b439bee62a1c4e09c02a1ec729aef4d92be6584a29141a79c5c7a0d99cae2bc3b6fc3e8e2767b4d7a5884b9b2d9d20da7890318beefcdb9c7346d58080a0f63571735d99e763dafadb03d1abe3a93a98740ecddc8514d13df46a35a8d94680a081870f4697e57436ccdd8bdc1d624d7bc07861748ff8b3a352334df68f2c03ada0f0252504ee8753335ecf0ca1f73cf13d4505783ed5110bf4e9b384a68ad88f69a0d38a18ef7b993c9ad2d848453e7722c26998ff3d63e243b99cdab0dabf84157ea06e5ad479dbda7f1647ed613e35d837f5d2c697ef34160f3665173186553ee9c280a0bf8371cac505b6ea0cb0f67ef744713f306a2455f3f8844cfa527c62db59c69980a0d6d689405b1cf73786c5fdabb55ec22f9b5712d1ba9c0bfcd46d4b93721fcac780", "0xf8669d37f29e142d49f8824d4e7f1735ec3da219687387629b5fccd86812df84b846f8440180a056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421a01d93f60f105899172f7255c030301c3af4564edd4a48577dbdc448aec7ddb0ac" ], "balance": "0x0", "codeHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470", "nonce": "0x0", "storageHash": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "storageProof": [ { "key": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "value": "0x0", "proof": [] } ] } } ``` # eth\_getStorageAt **Returns the value from a storage position at a given address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getstorageat) **Parameters** 1. `DATA`, 20 Bytes - address of the storage. REQUIRED 2. `QUANTITY` - integer of the position in the storage. REQUIRED 3. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `DATA` - the value at this storage position. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0000000000000000000000000000000000000000000000000000000000000000" } ``` # eth\_getTransactionByBlockHashAndIndex **Returns information about a transaction by block hash and transaction index position.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyblockhashandindex) **Parameters** 1. `DATA`, 32 Bytes - hash of a block. REQUIRED 2. `QUANTITY` - integer of the transaction index position. REQUIRED **Returns** `Object` - A transaction object, or `null` when no transaction was found: * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. `null` when its pending. * `blockNumber`: `QUANTITY` - block number where this transaction was in. `null` when its pending. * `from`: `DATA`, 20 Bytes - address of the sender. * `gas`: `QUANTITY` - gas provided by the sender. * `gasPrice`: `QUANTITY` - gas price provided by the sender in Wei. * `hash`: `DATA`, 32 Bytes - hash of the transaction. * `input`: `DATA` - the data send along with the transaction. * `nonce`: `QUANTITY` - the number of transactions made by the sender prior to this one. * `to`: `DATA`, 20 Bytes - address of the receiver. `null` when its a contract creation transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. `null` when its pending. * `value`: `QUANTITY` - value transferred in Wei. * `v`: `QUANTITY` - ECDSA recovery id * `r`: `QUANTITY` - ECDSA signature r * `s`: `QUANTITY` - ECDSA signature s ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getTransactionByBlockHashAndIndex", "params": ["0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "0x0"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "from": "0xae2fc483527b8ef99eb5d9b44875f005ba1fae13", "gas": "0x4515f", "gasPrice": "0x6a44cc24f", "maxFeePerGas": "0x6a44cc24f", "maxPriorityFeePerGas": "0x0", "hash": "0x6ac3b69c7cf01be86bb4600781fc9840e5f46ec714e17c3bd1e1d00fc05c30dc", "input": "0x01341996a0e584d8f99dec32b9d2f4edfa7c2036769c8d0536cfcb391a81a460ea6fd96a73d5672f1f4aa684697d4b44cc038d27280023bc80c92d", "nonce": "0x11f0f9", "to": "0x6b75d8af000000e20b7a7ddf000ba900b4009a80", "transactionIndex": "0x0", "value": "0x34327eb", "type": "0x2", "accessList": [ { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "storageKeys": [ "0x12231cd4c753cb5530a43a74c45106c24765e6f81dc8927d4f4be7e53315d5a8", "0x22005c0d64c5ceb5918f111eba7d3133da5f1edf0b66edb57b7122083bc72305", "0x69cca0f4d624fd4aace8d6acb115f9667fa5fb9dbc2f95c1ba1dac3dfa772a23" ] }, { "address": "0x96a0e584d8f99dec32b9d2f4edfa7c2036769c8d", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006" ] }, { "address": "0x374887ef78222c6bff0b0047e44ad2ed3ace07f3", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000005", "0x59c5a0582853b22cec98b71efaf11d4e6e716112079a141dde18505c4b33c6eb", "0x001ad44e8e7a5296af41ce323084e494eda0e398ff1a7eb16db0503d31de5e6f", "0xfc9f954ca7b2f8f907ce8f2fb41f6b47a0b71f38ddb5bf6d35bf28c11437ce30", "0x000000000000000000000000000000000000000000000000000000000000000e", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x9d47075c5aa4f61816fd5980980bfffbeb5144c1418ad15362d36c673ab74c51", "0x5360a0c34bd7ba8a6e2c5a58cd447e1919ba274a38195a871f7b24f5009b16d4", "0x49d38e34930b9aaa105cc332325d4a561402847e01bf67532467755731c9cb6e" ] }, { "address": "0x81a460ea6fd96a73d5672f1f4aa684697d4b44cc", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006", "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c" ] }, { "address": "0x43d7e65b8ff49698d9550a7f315c87e67344fb59", "storageKeys": [ "0xc2bb861d233e1c95a905a377a41b39fea66a8e7909a8176255695b218b60dd2e", "0x0000000000000000000000000000000000000000000000000000000000000005", "0x0000000000000000000000000000000000000000000000000000000000000006", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x0000000000000000000000000000000000000000000000000000000000000007", "0xa73ce99dd8ac76dea6de890fa71300accfde755b97bf1c541aef9615de6bbc24", "0x9bb3e24e1534bce24e9896f3377327d742d6c1d430477b7ebc070c2eb64e3147" ] } ], "chainId": "0x1", "v": "0x0", "r": "0x93d386d4ce5dc9ea07b3d5a244328ff4af3c3512ac3bd9a84ae57379fc81a9fd", "s": "0x4aba43edb73da88422b9503135efdb5a6df82cc76805992a6413384a3170d78" } } ``` # eth\_getTransactionByBlockNumberAndIndex **Returns information about a transaction by block number and transaction index position.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyblockhashandindex) **Parameters** 1. `QUANTITY|TAG` - a block number, or the string `"earliest"`, `"latest"` or `"pending"`, as in the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block). REQUIRED 2. `QUANTITY` - the transaction index position. REQUIRED **Returns** `Object` - A transaction object, or `null` when no transaction was found: * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. `null` when its pending. * `blockNumber`: `QUANTITY` - block number where this transaction was in. `null` when its pending. * `from`: `DATA`, 20 Bytes - address of the sender. * `gas`: `QUANTITY` - gas provided by the sender. * `gasPrice`: `QUANTITY` - gas price provided by the sender in Wei. * `hash`: `DATA`, 32 Bytes - hash of the transaction. * `input`: `DATA` - the data send along with the transaction. * `nonce`: `QUANTITY` - the number of transactions made by the sender prior to this one. * `to`: `DATA`, 20 Bytes - address of the receiver. `null` when its a contract creation transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. `null` when its pending. * `value`: `QUANTITY` - value transferred in Wei. * `v`: `QUANTITY` - ECDSA recovery id * `r`: `QUANTITY` - ECDSA signature r * `s`: `QUANTITY` - ECDSA signature s ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getTransactionByBlockNumberAndIndex", "params": ["0x1127101", "0x0"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "from": "0xae2fc483527b8ef99eb5d9b44875f005ba1fae13", "gas": "0x4515f", "gasPrice": "0x6a44cc24f", "maxFeePerGas": "0x6a44cc24f", "maxPriorityFeePerGas": "0x0", "hash": "0x6ac3b69c7cf01be86bb4600781fc9840e5f46ec714e17c3bd1e1d00fc05c30dc", "input": "0x01341996a0e584d8f99dec32b9d2f4edfa7c2036769c8d0536cfcb391a81a460ea6fd96a73d5672f1f4aa684697d4b44cc038d27280023bc80c92d", "nonce": "0x11f0f9", "to": "0x6b75d8af000000e20b7a7ddf000ba900b4009a80", "transactionIndex": "0x0", "value": "0x34327eb", "type": "0x2", "accessList": [ { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "storageKeys": [ "0x12231cd4c753cb5530a43a74c45106c24765e6f81dc8927d4f4be7e53315d5a8", "0x22005c0d64c5ceb5918f111eba7d3133da5f1edf0b66edb57b7122083bc72305", "0x69cca0f4d624fd4aace8d6acb115f9667fa5fb9dbc2f95c1ba1dac3dfa772a23" ] }, { "address": "0x96a0e584d8f99dec32b9d2f4edfa7c2036769c8d", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006" ] }, { "address": "0x374887ef78222c6bff0b0047e44ad2ed3ace07f3", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000005", "0x59c5a0582853b22cec98b71efaf11d4e6e716112079a141dde18505c4b33c6eb", "0x001ad44e8e7a5296af41ce323084e494eda0e398ff1a7eb16db0503d31de5e6f", "0xfc9f954ca7b2f8f907ce8f2fb41f6b47a0b71f38ddb5bf6d35bf28c11437ce30", "0x000000000000000000000000000000000000000000000000000000000000000e", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x0000000000000000000000000000000000000000000000000000000000000008", "0x9d47075c5aa4f61816fd5980980bfffbeb5144c1418ad15362d36c673ab74c51", "0x5360a0c34bd7ba8a6e2c5a58cd447e1919ba274a38195a871f7b24f5009b16d4", "0x49d38e34930b9aaa105cc332325d4a561402847e01bf67532467755731c9cb6e" ] }, { "address": "0x81a460ea6fd96a73d5672f1f4aa684697d4b44cc", "storageKeys": [ "0x0000000000000000000000000000000000000000000000000000000000000008", "0x0000000000000000000000000000000000000000000000000000000000000006", "0x0000000000000000000000000000000000000000000000000000000000000007", "0x0000000000000000000000000000000000000000000000000000000000000009", "0x000000000000000000000000000000000000000000000000000000000000000a", "0x000000000000000000000000000000000000000000000000000000000000000c" ] }, { "address": "0x43d7e65b8ff49698d9550a7f315c87e67344fb59", "storageKeys": [ "0xc2bb861d233e1c95a905a377a41b39fea66a8e7909a8176255695b218b60dd2e", "0x0000000000000000000000000000000000000000000000000000000000000005", "0x0000000000000000000000000000000000000000000000000000000000000006", "0xb39e9ba92c3c47c76d4f70e3bc9c3270ab78d2592718d377c8f5433a34d3470a", "0x0000000000000000000000000000000000000000000000000000000000000007", "0xa73ce99dd8ac76dea6de890fa71300accfde755b97bf1c541aef9615de6bbc24", "0x9bb3e24e1534bce24e9896f3377327d742d6c1d430477b7ebc070c2eb64e3147" ] } ], "chainId": "0x1", "v": "0x0", "r": "0x93d386d4ce5dc9ea07b3d5a244328ff4af3c3512ac3bd9a84ae57379fc81a9fd", "s": "0x4aba43edb73da88422b9503135efdb5a6df82cc76805992a6413384a3170d78" } } ``` # eth\_getTransactionByHash **Returns the information about a transaction requested by transaction hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionbyhash) **Parameters** `DATA`, 32 Bytes - hash of a transaction REQUIRED **Returns** `Object` - A transaction object, or `null` when no transaction was found: * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. `null` when its pending. * `blockNumber`: `QUANTITY` - block number where this transaction was in. `null` when its pending. * `from`: `DATA`, 20 Bytes - address of the sender. * `gas`: `QUANTITY` - gas provided by the sender. * `gasPrice`: `QUANTITY` - gas price provided by the sender in Wei. * `hash`: `DATA`, 32 Bytes - hash of the transaction. * `input`: `DATA` - the data send along with the transaction. * `nonce`: `QUANTITY` - the number of transactions made by the sender prior to this one. * `to`: `DATA`, 20 Bytes - address of the receiver. `null` when its a contract creation transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. `null` when its pending. * `value`: `QUANTITY` - value transferred in Wei. * `v`: `QUANTITY` - ECDSA recovery id * `r`: `QUANTITY` - ECDSA signature r * `s`: `QUANTITY` - ECDSA signature s ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getTransactionByHash", "params": ["0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "from": "0x91aae0aafd9d2d730111b395c6871f248d7bd728", "gas": "0x493ee", "gasPrice": "0x6dfe78c4f", "maxFeePerGas": "0x8aafc45e4", "maxPriorityFeePerGas": "0x3b9aca00", "hash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "input": "0xce2e62ff0000000000000000000000000000000000000000000002394ff4aa9621fc5166000000000000000000000000000000000000000000000000000000005072bc2b0000000000000000000000005fa9569b0ed6aa01e234468e6a15b77988b950df0000000000000000000000005732046a883704404f284ce41ffadd5b007fd66800000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000064e78760", "nonce": "0xb1a68", "to": "0x98c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "transactionIndex": "0x49", "value": "0x0", "type": "0x2", "accessList": [], "chainId": "0x1", "v": "0x0", "r": "0x73c2ae9e22bcd48aacf101051ea98da7c9e60013c51895f8f5b992e4352fb99d", "s": "0x1c1034de7e633dc4d851b2770bd4d9922fde32c53f8647a26ed12df5b20b1551" } } ``` # eth\_getTransactionCount **Returns the number of transactions *****sent***** from an address.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactioncount) **Parameters** 1. `DATA`, 20 Bytes - address. REQUIRED 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `QUANTITY` - integer of the number of transactions send from this address. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8", "latest" ], "method": "eth_getTransactionCount" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x31" } ``` # eth\_getTransactionReceipt **Returns the receipt of a transaction by transaction hash.** **Note** That the receipt is not available for pending transactions. [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactionreceipt) **Parameters** `DATA`, 32 Bytes - hash of a transaction REQUIRED **Returns** `Object` - A transaction receipt object, or `null` when no receipt was found: * `transactionHash` : `DATA`, 32 Bytes - hash of the transaction. * `transactionIndex`: `QUANTITY` - integer of the transactions index position in the block. * `blockHash`: `DATA`, 32 Bytes - hash of the block where this transaction was in. * `blockNumber`: `QUANTITY` - block number where this transaction was in. * `from`: `DATA`, 20 Bytes - address of the sender. * `to`: `DATA`, 20 Bytes - address of the receiver. null when its a contract creation transaction. * `cumulativeGasUsed` : `QUANTITY` - The total amount of gas used when this transaction was executed in the block. * `effectiveGasPrice` : `QUANTITY` - The sum of the base fee and tip paid per unit of gas. * `gasUsed` : `QUANTITY` - The amount of gas used by this specific transaction alone. * `contractAddress` : `DATA`, 20 Bytes - The contract address created, if the transaction was a contract creation, otherwise `null`. * `logs`: `Array` - Array of log objects, which this transaction generated. * `logsBloom`: `DATA`, 256 Bytes - Bloom filter for light clients to quickly retrieve related logs. * `type`: `QUANTITY` - integer of the transaction type, `0x0` for legacy transactions, `0x1` for access list types, `0x2` for dynamic fees. It also returns *either* : * `root` : `DATA` 32 bytes of post-transaction stateroot (pre Byzantium) * `status`: `QUANTITY` either `1` (success) or `0` (failure) ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "params": [ "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4" ], "method": "eth_getTransactionReceipt" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": { "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "blockNumber": "0x1127101", "contractAddress": null, "cumulativeGasUsed": "0x4ee626", "effectiveGasPrice": "0x6dfe78c4f", "from": "0x91aae0aafd9d2d730111b395c6871f248d7bd728", "gasUsed": "0x1bf2a", "logs": [ { "address": "0x5732046a883704404f284ce41ffadd5b007fd668", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "0x0000000000000000000000005fa9569b0ed6aa01e234468e6a15b77988b950df" ], "data": "0x0000000000000000000000000000000000000000000002394ff4aa9621fc5166", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x8e", "removed": false }, { "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x0000000000000000000000005fa9569b0ed6aa01e234468e6a15b77988b950df", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e" ], "data": "0x000000000000000000000000000000000000000000000000000000005075f5dd", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x8f", "removed": false }, { "address": "0x5fa9569b0ed6aa01e234468e6a15b77988b950df", "topics": [ "0x1c411e9a96e071241c2f21f7726b17ae89e3cab4c78be50e062b03a9fffbbad1" ], "data": "0x00000000000000000000000000000000000000000001ae47731be3af5b213fba0000000000000000000000000000000000000000000000000000003cadd1fa4c", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x90", "removed": false }, { "address": "0x5fa9569b0ed6aa01e234468e6a15b77988b950df", "topics": [ "0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "0x00000000000000000000000098c3d3183c4b8a650614ad179a1a98be0a8d6b8e" ], "data": "0x0000000000000000000000000000000000000000000002394ff4aa9621fc516600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005075f5dd", "blockNumber": "0x1127101", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "blockHash": "0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59", "logIndex": "0x91", "removed": false } ], "logsBloom": "0x00200000000000000000000080000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000408000008000000200000000000000000000000000000000000200000000000000000008000000000000000020000000000000010000000000000000000000800000000000000000000000000010000080000004000000000000000000000280000000000000000000000000000000000000000000000000000000002000800000000000000001000000000004000001000000000000000000002000000000000000000000000000000000000000000000000001000000000", "status": "0x1", "to": "0x98c3d3183c4b8a650614ad179a1a98be0a8d6b8e", "transactionHash": "0xad5c35020b1ed10cf03b0caf4308df4703acb87f6beee186db0c0fc95c9bb1b4", "transactionIndex": "0x49", "type": "0x2" } } ``` # eth\_getUncleCountByBlockHash **Returns the number of uncles in a block from a block matching the given block hash.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getunclecountbyblockhash) **Parameters** `DATA`, 32 Bytes - hash of a block REQUIRED **Returns** `QUANTITY` - integer of the number of uncles in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getUncleCountByBlockHash", "params": ["0x14834c13eec4b47be4fb4c8a4190f966af5eb9735b446b7ccd8120b5f5763a59"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0" } ``` # eth\_getUncleCountByBlockNumber **Returns the number of uncles in a block from a block matching the given block number.** [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getunclecountbyblocknumber) **Parameters** `QUANTITY|TAG` - integer of a block number, or the string "latest", "earliest" or "pending", see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) REQUIRED **Returns** `QUANTITY` - integer of the number of uncles in this block. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_getUncleCountByBlockNumber", "params": ["0x1127101"] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x0" } ``` # eth\_maxPriorityFeePerGas **Returns a fee per gas that is an estimate of how much you can pay as a priority fee, or 'tip', to get a transaction included in the current block.** **Parameters** 1. `DATA`, 20 Bytes - address. 2. `QUANTITY|TAG` - integer block number, or the string `"latest"`, `"earliest"` or `"pending"`, see the [default block parameter](https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block) **Returns** `QUANTITY` - integer of the number of transactions send from this address. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_maxPriorityFeePerGas" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x2faf080" } ``` # eth\_newBlockFilter Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call [eth\_getFilterChanges](https://app.gitbook.com/o/-Ml9lAiUWtXZF3GXO6N3/s/iLoE65E22qMx9VF67gCT/~/changes/83/rpc-api-docs/chains/ethereum/standard-json-rpc-api/eth_getfilterchanges). [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newBlockFilter) **Parameters** None **Returns** `QUANTITY` - A filter id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_newBlockFilter" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x87a1252c71f5e32751e3fa806c80100" } ``` # eth\_newFilter Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call [eth\_getFilterChanges](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges). **A note on specifying topic filters:** Topics are order-dependent. A transaction with a log with topics \[A, B] will be matched by the following topic filters: * `[]` "anything" * `[A]` "A in first position (and anything after)" * `[null, B]` "anything in first position AND B in second position (and anything after)" * `[A, B]` "A in first position AND B in second position (and anything after)" * `[[A, B], [A, B]]` "(A OR B) in first position AND (A OR B) in second position (and anything after)" [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newfilter) **Parameters** `Object` - The filter options: * `fromBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `toBlock`: `QUANTITY|TAG` - (optional, default: `"latest"`) Integer block number, or `"latest"` for the last mined block or `"pending"`, `"earliest"` for not yet mined transactions. * `address`: `DATA|Array`, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate. * `topics`: `Array of DATA`, - (optional) Array of 32 Bytes `DATA` topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options. **Returns** `QUANTITY` - A filter id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_newFilter", "params": [ { "address": [ "0xb59f67a8bff5d8cd03f6ac17265c550ed8f33907" ], "fromBlock": "0x429d3b", "toBlock": "latest", "topics": [ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000000b46c2526e227482e2ebb8f4c69e4674d262e75", "0x00000000000000000000000054a2d42a40f51259dedd1978f6c118a0f0eff078" ] } ] } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0xf3021ac72b556ec65bddf0851683a110" } ``` # eth\_newPendingTransactionFilter Creates a filter in the node, to notify when new pending transactions arrive. To check if the state has changed, call [eth\_getFilterChanges](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges). [**Ethereum.org API Reference**](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newpendingtransactionfilter) **Parameters** None **Returns** `QUANTITY` - A filter id. ## Example #### Request ``` curl --request POST \ --url https://endpoints.omniatech.io/v1/RPC_ENDPOINT \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "id": 1, "jsonrpc": "2.0", "method": "eth_newPendingTransactionFilter" } ' ``` #### Response ``` { "jsonrpc": "2.0", "id": 1, "result": "0x70da02cfdc54a8b372918200e792b30a" } ``` --- [Next Page](/llms-full.txt/1)