/screen

Screen is an advanced endpoint that works similarly to /preview, but includes additional security features.

It will screen the destination contract / address, tokens that will be involved in the transaction, as well as the origin URL for the transaction (if provided).

The screening is comprehensive and aggregates data from a variety of sources, including: sanction lists (e.g. OFAC), various repositories of scam contracts and tokens, and malicious domain names.

It takes an optional stateOverrides object, which allows you to customize the state of the chain before the transaction is simulated. Refer to the /preview endpoint for more information.

The output includes a human-friendly simulation, with a transaction type and an English description of the action that is about to take place. All asset transfers are tagged with an action field that explains why the token will move.

It also includes a risk analysis for the destination address (whether it's a contract or an EOA), and of the tokens that will be involved in the transaction.

If any of the following is detected, it will be listed in the risks array:

  • Bad actor address
  • Malicious contract
  • OFAC-sanctioned address
  • Malicious domain

For tokens, in addition to reporting if the token contract is malicious, the following is also reported

  • Fee on transfer token (for tokens that take a fee for buying/selling it)
  • Token with admin privileges for minting / changing balance (not necessarily malicious, but common in custodial tokens)
Path Params
string
required

The chain name, as listed in the /chains endpoint.

Query Params
string

The account address from which perspective the transaction will be simulate (optional). Leave blank to use the raw from of the transaction object.

int64

The block number to simulate the transaction at (optional). Leave blank to use the current state of the chain.

string

The URL of the Dapp that triggered the transaction (optional).

Body Params

The unsigned transaction object, modeled after the standard format used by multiple EVM wallets.

transaction
object
stateOverrides
object | null
Headers
string
required
Defaults to demokey

API Key for Foresight API. To get an API Key, visit https://app.noves.fi/register

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json