RPC Namespaces

View the full reference for the Abstract JSON-RPC API.

Abstract JSON-RPC API

Abstract

Welcome to the Abstract documentation. Dive into our resources to learn more about the blockchain leading the next generation of consumer crypto.

Introduction

A high-level overview of what Abstract is and how it works.

What is Abstract?

Add Abstract to your wallet or development environment to get started.

Connect to Abstract

Learn how to start developing smart contracts and applications on Abstract.

Getting Started

Learn how to use the ZKsync CLI to interact with Abstract or a local Abstract node.

ZKsync CLI

Learn how to view transactions, blocks, batches, and more on Abstract block explorers.

Block Explorers

Learn how to bridge assets between Abstract and Ethereum.

Bridges

Learn how to easily get testnet funds for development on Abstract.

Faucets

Discover a list of commonly used contracts deployed on Abstract.

Deployed Contracts

Discover Abstract Global Wallet, the smart contract wallet powering the Abstract ecosystem.

Overview

Abstract Global Wallet

Learn how to integrate Abstract Global Wallet into your application.

Learn more about how Abstract Global Wallet works under the hood.

How It Works

Answers to common questions about Abstract Global Wallet.

Frequently Asked Questions

Learn how to integrate Abstract Global Wallet with React.

Native Integration

Learn how to integrate Abstract Global Wallet with ConnectKit.

ConnectKit

Learn how to integrate Abstract Global Wallet with Dynamic.

Dynamic

Learn how to integrate Abstract Global Wallet into an existing Privy application

Privy

Learn how to integrate Abstract Global Wallet with RainbowKit.

RainbowKit

Learn how to integrate Abstract Global Wallet with WalletConnect.

WalletConnect

Learn how to integrate Abstract Global Wallet with Thirdweb.

Thirdweb

The AbstractWalletProvider component is a wrapper component that provides the Abstract Global Wallet context to your application, allowing you to use hooks and components.

AbstractWalletProvider

Hook for signing in and signing out users with Abstract Global Wallet.

useLoginWithAbstract

Hook for creating and managing an Abstract client instance.

useAbstractClient

Hook to get the approved signer of the connected Abstract Global Wallet.

useGlobalWalletSignerAccount

Hook to get a wallet client instance of the approved signer of the connected Abstract Global Wallet.

useGlobalWalletSignerClient

Function to deploy a smart contract from the connected Abstract Global Wallet.

deployContract

Function to sign a transaction using the connected Abstract Global Wallet.

signTransaction

Function to send a transaction using the connected Abstract Global Wallet.

sendTransaction

Function to send a batch of transactions in a single call using the connected Abstract Global Wallet.

sendTransactionBatch

Function to sign messages using the connected Abstract Global Wallet.

signMessage

Function to call functions on a smart contract using the connected Abstract Global Wallet.

writeContract

Hook for interacting with smart contracts using paymasters to cover gas fees.

useWriteContractSponsored

Explore session keys, how to create them, and how to use them with the Abstract Global Wallet.

Session keys

Learn how to use session keys in production on Abstract Mainnet.

Going to Production

Function to create a session key for the connected Abstract Global Wallet.

createSession

useCreateSession

Function to create a new SessionClient without an existing AbstractClient.

createSessionClient

Function to create an AbstractClient using a session key.

toSessionClient

Function to check the current status of a session key from the validator contract.

getSessionStatus

Function to revoke session keys from the connected Abstract Global Wallet.

revokeSessions

useRevokeSessions

Link wallets from Ethereum Mainnet to the Abstract Global Wallet.

Wallet Linking

Function to link an Ethereum Mainnet wallet to an Abstract Global Wallet.

linkToAgw

Function to get all Ethereum wallets linked to an Abstract Global Wallet.

getLinkedAccounts

Function to get the linked Abstract Global Wallet for an Ethereum Mainnet address.

getLinkedAgw

How to read links between Ethereum wallets and Abstract Global Wallets in Solidity.

Reading Wallet Links in Solidity

Function to deterministically derive the deployed Abstract Global Wallet smart account address from the initial signer account.

getSmartAccountAddress FromInitialSigner

Function to transform an EIP1193 provider into an Abstract Global Wallet client.

transformEIP1193Provider

View the automation solutions available on Abstract.

Automation

Move funds from other chains to Abstract and vice versa.

View the indexers and APIs available on Abstract.

Data & Indexing

Discover the interoperability solutions available on Abstract.

Interoperability

Use multi-signature (multi-sig) wallets on Abstract

Multi-Sig Wallets

Discover the Oracle and VRF services available on Abstract.

Oracles

Discover the paymasters solutions available on Abstract.

Paymasters

Discover the relayer solutions available on Abstract.

Relayers

Discover the RPC providers available on Abstract.

RPC Providers

Discover providers for Token Distribution available on Abstract.

Token Distribution

eth_chainId

Executes a new message call immediately without creating a transaction on the blockchain

eth_call

Estimates the amount of gas needed to execute a call

eth_estimateGas

eth_gasPrice

Creates a filter object to notify when the state changes

eth_newFilter

Creates a filter to notify when a new block arrives

eth_newBlockFilter

eth_uninstallFilter

Creates a filter to notify when new pending transactions arrive

eth_newPendingTransactionFilter

Returns logs matching the filter criteria

eth_getLogs

eth_getFilterLogs

eth_getFilterChanges

eth_getBalance

web3_clientVersion

Returns information about a block by number

eth_getBlockByNumber

Returns information about a block by hash

eth_getBlockByHash

Returns the number of transactions in a block by block number

eth_getBlockTransactionCountByNumber

Returns all transaction receipts for a given block

eth_getBlockReceipts

Returns the number of transactions in a block by block hash

eth_getBlockTransactionCountByHash

Returns the code stored at the given address

eth_getCode

Returns the value from a storage position at a given address

eth_getStorageAt

Returns the number of transactions sent from an address

eth_getTransactionCount

Submits a pre-signed transaction for broadcast

eth_sendRawTransaction

Returns a list of addresses owned by the client

eth_accounts

eth_feeHistory

Estimates the fee for a given call request

zks_estimateFee

Estimates the gas required for an L1 to L2 transaction

zks_estimateGasL1ToL2

Retrieves the bridge hub contract address

zks_getBridgehubContract

Retrieves the main contract address, also known as the DiamondProxy

zks_getMainContract

Retrieves the testnet paymaster address, specifically for interactions within the Abstract Sepolia Testnet environment. Note: This method is only applicable for Abstract Sepolia Testnet (i.e. not mainnet).

zks_getTestnetPaymaster

Returns the range of blocks contained within a specified L1 batch. The range is provided by the beginning and end block numbers in hexadecimal.

zks_getL1BatchBlockRange

Returns data pertaining to a specific L1 batch

zks_getL1BatchDetails

zks_L1BatchNumber

Returns the chain id of the underlying L1

zks_L1ChainId

Lists confirmed tokens. Confirmed in the method name means any token bridged to Abstract via the official bridge. The tokens are returned in alphabetical order by their symbol. This means the token id is its position in an alphabetically sorted array of tokens.

zks_getConfirmedTokens

Gets all account balances for a given address. The method returns an object with token addresses as keys and their corresponding balances as values. Each key-value pair represents the balance of a specific token held by the account

zks_getAllAccountBalances

zks_getTransactionDetails

zks_getBlockDetails

Returns the addresses of the bridge contracts on L1 and L2

zks_getBridgeContracts

zks_getBaseTokenL1Address

Retrieves the proof for an L2 to L1 message

zks_getL2ToL1MsgProof

Retrieves the log proof for an L2 to L1 transaction

zks_getL2ToL1LogProof

Lists transactions in a block without processing them

zks_getRawBlockTransactions

Retrieves the bytecode of a transaction by its hash

zks_getBytecodeByHash

zks_getL1GasPrice

zks_getFeeParams

zks_getProtocolVersion

Generates Merkle proofs for one or more storage values associated with a specific account, accompanied by a proof of their authenticity

zks_getProof

Executes a transaction and returns its hash, storage logs, and events that would have been generated if the transaction had already been included in the block. The API has a similar behaviour to eth_sendRawTransaction but with some extra data returned from it. With this API Consumer apps can apply "optimistic" events in their applications instantly without having to wait for ZKsync block confirmation time. It's expected that the optimistic logs of two uncommitted transactions that modify the same state will not have causal relationships between each other.

Namespace	Description	Example
`eth_`	Standard Ethereum JSON-RPC methods.	`eth_chainId`
`zks_`	JSON-RPC methods specific to the ZKsync VM that Abstract uses.	`zks_estimateFee`
`debug_`	JSON-RPC methods useful for debugging purposes.	`debug_traceCall`
`pubsub_`	JSON-RPC methods for subscribing to events via WebSockets	`eth_subscribe`

Overview

Ethereum API

ZKSync API

Debug API

PubSub API

Abstract JSON-RPC API

RPC Namespaces

Ethereum JSON-RPC API

ZKsync JSON-RPC API

Debugging JSON-RPC API

PubSub JSON-RPC API

Overview

Ethereum API

ZKSync API

Debug API

PubSub API

​RPC Namespaces

Ethereum JSON-RPC API

ZKsync JSON-RPC API

Debugging JSON-RPC API

PubSub JSON-RPC API

RPC Namespaces