AtlantisChain API Documentation

 

Introduction

 

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.

 


 

Configuring State Commitment

 

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.

 

Default Commitment

 

If no commitment level is specified in a request, the node defaults to finalized commitment.

 


 

RpcResponse Structure

 

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.

 


 

Parsed Responses

 

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.

 

Supported Programs for JSON Parsing

 

AtlantisChain nodes currently support JSON parsing for the following programs:

 

Native 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.

 

Standard Program Library (SPL) Programs:

 

         Associated Token Account: Facilitates automatic token account creation.

         Memo: Provides transaction memo functionality.

         Token: Supports SPL tokens, including transfers and balances.

 

Example Response with 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

}

 


 

Filter Criteria

 

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.

 


 

RPC HTTP Endpoint

 

AtlantisChain provides an HTTP-based RPC endpoint to facilitate blockchain interactions. The RPC API follows the JSON-RPC 2.0 specification.

 

Base URL

 
https://mainnet.AtlantisChain.net

 

Request Format

 

All requests should be sent as HTTP POST requests with a JSON payload structured as follows:

 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "methodName",
  "params": [ ... ]
}

 

Example Request

 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": ["AccountPublicKey"]
}

 

Example Response

 
{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 123456
    },
    "value": 500000000
  },
  "id": 1
}

 


 

API Methods

 

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.

 


 

Health Check

 

getHealth

         Description: Checks if the node is healthy.

         Response:

o        "ok" if healthy, otherwise an error message.

 


 

Copyright 2021-2025 Atlantis Coin

A USPTO-registered trademark for the AtlantisChain ecosystem under U.S. law.

All rights reserved.