NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Blocknative connects to a Nagent workspace with an API key. Once it is connected, agents can call 10 Blocknative actions, such as "Get Gas Price Distribution", "Get Gas Oracles" and "Get Gas Prices". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Blocknative, with input parameters and output schema.
BLOCKNATIVE_CONFIGURE_FILTERSTool to configure filters and ABI decoding for Ethereum mempool transactions. Use after establishing a Blocknative WebSocket connection to set up event filters and decoding.
Input parameters
Nested object defining scope, filters, ABI decode and watch settings.
Must be the literal string 'put'.
Must be the literal string 'configs'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_GET_GAS_DISTRIBUTIONTool to retrieve the current mempool gas price distribution breakdown. Use when analyzing gas price trends or preparing fee strategies.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_GET_GAS_ORACLESTool to retrieve metadata on supported gas oracles per chain. Use when you need to dynamically discover all available on-chain gas estimation oracles across networks.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_GET_GAS_PRICESTool to fetch gas price estimates for specific inclusion probabilities. Use when you need gas price ranges for the next block or next ~10 seconds.
Input parameters
The chain ecosystem (e.g., 'ethereum', 'story', 'polygon').
The network chain ID. Default is 1 (Ethereum Mainnet).
The specific network within the system (e.g., 'mainnet', 'sepolia').
Up to 5 custom confidence levels to override defaults (99,95,90,80,70). For Ethereum Mainnet, values 1-99; for other chains, select from (99,95,90,80,70,50).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_GET_SUPPORTED_CHAINSTool to retrieve supported chains metadata. Use when discovering available networks for Blocknative gas services.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_PREDICTION_API_BASEFEE_ESTIMATESGet real-time gas fee predictions for Ethereum mainnet's next 5 blocks. Returns base fee, blob base fee, and priority fee estimates at multiple confidence levels (99% and 50%). Essential for optimizing transaction costs and timing. Predictions include current block context (block number, time since last block) and estimated fees in gwei.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_SUBSCRIBE_MULTICHAINGenerate WebSocket connection details to subscribe to real-time blockchain events (transactions or account activity) across multiple chains via Blocknative's Multichain API. Returns the WebSocket URL and subscription message payload needed to establish the connection and start receiving event notifications for a specific transaction hash or account address on any supported blockchain.
Input parameters
Transaction hash or account address to subscribe to (hex string starting with '0x').
(Account only) Optional JSON ABI array to decode contract input data on account events.
Type of subscription: 'transaction' for transaction events, 'account' for address events.
Hex-encoded chain ID, e.g. '0x1' for Ethereum Mainnet.
(Account only) Optional array of JSQL filter expressions to apply to account events.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_SUBSCRIBE_TRANSACTION_HASHTool to subscribe to transaction state change events of an Ethereum transaction hash. Use after establishing a Blocknative WebSocket connection to prepare the subscription message.
Input parameters
Ethereum transaction hash to monitor (must be in format: 0x followed by 64 hexadecimal characters).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_UNSUBSCRIBE_MULTICHAINTool to unsubscribe from events across multiple chains using the Multichain SDK. Use after stopping monitoring of an address or transaction to clean up resources, e.g., call: blocknative.unsubscribe({ id: '0x..', chainId: '0x1' }).
Input parameters
Transaction hash or account address to stop monitoring across chains.
Hex-encoded chain ID where the subscription exists, e.g. '0x1'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
BLOCKNATIVE_UNSUBSCRIBE_TRANSACTION_HASHTool to unsubscribe from transaction state change events for an Ethereum transaction hash. Use after establishing a Blocknative WebSocket connection to prepare the unsubscription message.
Input parameters
Ethereum transaction hash to unsubscribe from. Must be a valid 66-character hex string starting with '0x' (e.g., '0x0b4c94c414f71ddd5e7a625fcaa83ff1f93e9a7ca37e0f577b488ac8fd786655').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 10 Blocknative actions on Nagent, including "Get Gas Price Distribution", "Get Gas Oracles" and "Get Gas Prices". Get Gas Price Distribution: Retrieve the current mempool gas price distribution breakdown. Each action is listed on this page with its input parameters and its output.
Blocknative connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.