AtlantisChain is the world s FASTEST blockchain, capable of processing up to 2,100,000 transactions per second (TPS).
It is built as a Layer-ZERO infrastructure, serving as the foundational layer for all future blockchains and decentralized applications (dApp).
As a globally accessible open network, AtlantisChain offers the LOWEST transaction fees in the world, making it ideal for high-performance applications at scale.
To empower developers, platforms, businesses, government agencies, and all interested entities, AtlantisChain provides a robust JSON-RPC 2.0 API that enables seamless interaction with the network via both HTTP and WebSocket protocols.
This API supports a wide range of operations, including querying account details, retrieving block and transaction data, and submitting transactions to the network.
State commitment determines the level of assurance regarding the finality of queried data. AtlantisChain supports the following commitment levels, listed from most to least finalized:
finalized: Queries the most recent block confirmed by a supermajority of the cluster, recognized as finalized.
confirmed: Queries the most recent block voted on by a supermajority of the cluster. This level balances speed with rollback safety.
processed: Queries the node's most recent block, which may still be subject to rollback.
If no
commitment level is specified in a request, the node defaults to finalized
commitment.
Responses to methods that accept a commitment parameter are structured as follows:
context: An object containing a slot
field
indicating the slot at which the operation was evaluated.
value: The result of the operation.
Some API
methods allow for responses to be returned in a parsed JSON format to provide
more human-readable data structures. When specifying "encoding":"jsonParsed"
in the request, the response will be decoded and formatted accordingly.
AtlantisChain nodes currently support JSON parsing for the following programs:
Address Lookup Table: Stores lookup tables for reducing transaction size.
BPF Loader: Manages smart contract (program) deployments.
BPF Upgradeable Loader: Enables upgradeable smart contracts.
Config: Stores on-chain configuration parameters.
Stake: Handles staking and delegation functionality.
Vote: Manages validator voting data.
Associated Token Account: Facilitates automatic token account creation.
Memo: Provides transaction memo functionality.
Token: Supports SPL tokens, including transfers and balances.
jsonParsed
{
"jsonrpc": "2.0",
"result": {
"context": {
"slot": 123456
},
"value": {
"owner": "TokenProgram1111111111111111111111111111111",
"lamports": 500000000,
"data": {
"parsed": {
"type": "account",
"info": {
"mint": "TokenMintAddress1111111111111111111111111111",
"owner": "OwnerAddress1111111111111111111111111111",
"amount": "1000"
}
}
}
}
},
"id": 1
}
Filters are
used in API calls such as getProgramAccounts
,
getTokenAccountsByOwner
,
and getTokenAccountsByDelegate
to narrow down query results. Certain methods allow filtering to refine the
results based on specified conditions.
The available filter types include:
memcmp: Allows filtering based on byte comparisons at specific offsets within an account's data.
o offset (integer): The byte offset in the account data to start comparison.
o bytes (string): The byte sequence to match, encoded as base58 or base64.
o encoding (string, optional): Encoding format (default: base58).
dataSize: Filters accounts based on their data size.
o size (integer): The exact size of the account data (in bytes).
programId: Retrieves all accounts owned by a specific program.
o programId (string): The public key of the program to filter by.
AtlantisChain provides an HTTP-based RPC endpoint to facilitate blockchain interactions. The RPC API follows the JSON-RPC 2.0 specification.
https://mainnet.AtlantisChain.net
All requests should be sent as HTTP POST requests with a JSON payload structured as follows:
{
"jsonrpc": "2.0",
"id": 1,
"method": "methodName",
"params": [ ... ]
}
{
"jsonrpc": "2.0",
"id": 1,
"method": "getBalance",
"params": ["AccountPublicKey"]
}
{
"jsonrpc": "2.0",
"result": {
"context": {
"slot": 123456
},
"value": 500000000
},
"id": 1
}
getAccountInfo
Description: Returns information about a specified account.
Parameters:
o
account
(string, required): Base58-encoded
public key of the account.
o
config
(object, optional): Configuration
object including commitment and encoding.
Response:
o
data
: Account data including lamports
and owner.
getBalance
Description: Returns the balance of an account in lamports.
Parameters:
o
account
(string, required): Base58-encoded
public key.
Response:
o
lamports
:
Balance in smallest currency
unit.
getBlock
Description: Returns information about a confirmed block.
Parameters:
o
slot
(integer, required): Slot number of the block.
o
config
(object, optional): Configuration object for commitment level.
Response:
o
blockhash
:
Block hash.
o
parentSlot
:
Parent block slot number.
o
transactions
:
List of transactions in the block.
getBlockCommitment
Description: Returns commitment information for a block.
Parameters:
o
slot
(integer, required): Slot number of the block.
Response:
o
commitment
:
Commitment levels for the block.
getBlockHeight
Description: Returns the current block height of the network.
Response:
o
blockHeight
(integer): The latest block height.
getBlockProduction
Description: Returns recent block production statistics.
Response:
o
leaders
: A
list of validators producing blocks.
o
production
: The
count of blocks produced per validator.
getBlockTime
Description: Returns the estimated Unix timestamp of a block.
Parameters:
o
slot
(integer, required): The slot
number of the block.
Response:
o
timestamp
(integer): Unix
timestamp.
getBlocks
Description: Returns a list of confirmed blocks in a given range.
Parameters:
o
startSlot
(integer, required): First slot in
range.
o
endSlot
(integer, optional): Last slot in
range.
Response:
o
blocks
:
List of block slots.
getBlocksWithLimit
Description: Returns a list of confirmed blocks within a limit.
Parameters:
o
startSlot
(integer, required): First slot in
range.
o
limit
(integer, required): Maximum
number of blocks.
Response:
o
blocks
:
List of block slots.
getClusterNodes
Description: Returns information about all nodes in the cluster.
Response:
o
nodes
: List of node details, including public key,
gossip address, and version.
getEpochInfo
Description: Returns information about the current epoch.
Response:
o
epoch
: Current epoch number.
o
slotIndex
:
Current slot within epoch.
o
slotsInEpoch
:
Total slots per epoch.
getEpochSchedule
Description: Returns details on epoch length and leader schedule.
Response:
o
slotsPerEpoch
:
Number of slots in each epoch.
getFeeForMessage
Description: Returns the estimated fee for a given transaction message.
Parameters:
o
message
(string, required): Base64-encoded
transaction message.
Response:
o
fee
: Fee in lamports.
getGenesisHash
Description: Returns the genesis hash of the blockchain.
Response:
o
genesisHash
:
Base58-encoded hash.
getLatestBlockhash
Description: Returns the latest blockhash.
Response:
o
blockhash
:
Latest block hash.
getTransaction
Description: Returns transaction details for a given signature.
Parameters:
o
signature
(string, required): Transaction
signature.
Response:
o
transaction
:
Transaction details.
getVersion
Description: Returns the current software version of the node.
Response:
o
version
:
Version string.
requestAirdrop
Description: Requests an airdrop of lamports to a given account.
Parameters:
o
account
(string, required): Base58-encoded
public key.
o
amount
(integer, required): Amount in
lamports.
Response:
o
signature
:
Transaction signature.
sendTransaction
Description: Sends a signed transaction to the network.
Parameters:
o
transaction
(string, required): Base64-encoded
signed transaction.
Response:
o
signature
:
Transaction signature.
simulateTransaction
Description: Simulates a transaction without broadcasting it.
Parameters:
o
transaction
(string, required): Base64-encoded
signed transaction.
Response:
o
result
:
Simulation result including
logs and fee calculations.
getHealth
Description: Checks if the node is healthy.
Response:
o
"ok"
if healthy, otherwise an error
message.
All rights reserved.