Circular SDK
  • Getting Started
    • Circular APIs
      • Setting Up a Wallet
      • Get you NAG Access Key
      • Select a Programming Language
  • API Docs
    • APIs
      • Check Wallet Existence
      • Get Wallet Content
      • Get Wallet Balance
      • Get Wallet Nonce
      • Call a Smart Contract Function
      • Get a Domain
      • Get the Asset List
      • Get Asset
      • Get the Asset Supply
      • Get a range of Blocks
      • Get a Block
      • Get the number of Blocks
      • Get the Blockchain Analytics
      • Get the available blockchains
      • Get a Transaction by its TxID
      • Get transactions processed by a node
      • Get a transaction by an involved address
      • Get transactions by a range of dates
      • Submit a new Transaction
      • Registering a New Wallet
      • Transferring an Asset
    • Node.js
      • Mainnet Integration
      • checkWallet()
      • getWallet()
      • getWalletBalance()
      • getWalletNonce()
      • callContract()
      • testContract()
      • registerWallet()
      • getDomain()
      • getAssetList()
      • getAsset()
      • getAssetSupply()
      • getBlockRange()
      • getBlock()
      • getBlockCount()
      • getAnalytics()
      • getBlockchains()
      • getTransactionbyID()
      • getTransactionbyNode()
      • getTransactionbyAddress()
      • getTransactionbyDate()
      • getTransactionOutcome()
      • getPendingTransaction()
      • sendTransaction()
      • signMessage()
      • verifySignature()
      • getPublicKey()
      • stringToHex()
      • hexToString()
      • hexFix()
      • setNAGKey()
      • setNAGURL()
      • getFormattedTimestamp()
    • Javascript
      • Mainnet Integration
      • checkWallet()
      • getWallet()
      • getWalletBalance()
      • getWalletNonce()
      • callContract()
      • testContract()
      • registerWallet()
      • getDomain()
      • getAssetList()
      • getAsset()
      • getAssetSupply()
      • getBlockRange()
      • getBlock()
      • getBlockCount()
      • getAnalytics()
      • getBlockchains()
      • getTransactionbyID()
      • getTransactionbyNode()
      • getTransactionbyAddress()
      • getTransactionbyDate()
      • getTransactionOutcome()
      • getPendingTransaction()
      • sendTransaction()
      • signMessage()
      • verifySignature()
      • getPublicKey()
      • stringToHex()
      • hexToString()
      • hexFix()
      • setNAGKey()
      • setNAGURL()
      • getFormattedTimestamp()
    • Typescript
      • Including TypeScript Library
      • SetNAGKey & SetNAGURL
      • GetWallet
      • RegisterWallet
      • GetAsset
      • GetAssetSupply
      • GetBlock
      • SendTransaction
      • SignMessage
      • getFormattedTimestamp
      • Transferring an Asset
    • Python
      • Mainnet Integration
      • checkWallet()
      • getWallet()
      • getWalletBalance()
      • getWalletNonce()
      • callContract()
      • registerWallet()
      • getDomain()
      • getAssetList()
      • getAsset()
      • getAssetSupply()
      • getBlockRange()
      • getBlock()
      • getBlockCount()
      • getAnalytics()
      • getBlockchains()
      • getTransactionByID()
      • getTransactionByNode()
      • getTransactionByAddress()
      • getTransactionByDate()
      • getTransactionOutcome()
      • sendTransaction()
    • Dart
      • checkWallet()
      • getWallet()
      • getWalletBalance()
      • getWalletNonce()
      • callContract()
      • callContractWithPlainConsoleOutput()
      • registerWallet()
      • getDomain()
      • getAssetList()
      • getAsset()
      • getAssetSupply()
      • getBlockRange()
      • getBlock()
      • getBlockCount()
      • getAnalytics()
      • getBlockchains()
      • getTransactionByID()
      • getTransactionByNode()
      • getTransactionByAddress()
      • getTransactionByDate()
      • sendTransaction()
      • signMessage()
      • verifySignature()
      • getPublicKey()
      • getKeysFromString()
      • getKeysFromListOfStrings()
    • Go
      • Mainnet Integration
      • CheckWallet()
      • GetWallet()
      • GetWalletBalance()
      • GetWalletNonce()
      • CallContract()
      • RegisterWallet()
      • GetDomain()
      • GetAssetList()
      • GetAsset()
      • GetAssetSupply()
      • GetBlockRange()
      • GetBlock()
      • GetBlockCount()
      • GetAnalytics()
      • GetBlockchains()
      • GetTransactionByID()
      • GetTransactionByNode()
      • GetTransactionByAddress()
      • GetTransactionByDate()
      • GetTransactionOutcome()
      • SendTransaction()
      • SignMessage()
      • VerifySignature()
      • GetPublicKey()
      • GetKeysFromString()
    • PHP
      • Mainnet Integration
      • checkWallet()
      • getWallet()
      • getWalletBalance()
      • getWalletNonce()
      • callContract()
      • registerWallet()
      • getDomain()
      • getAssetList()
      • getAsset()
      • getAssetSupply()
      • getBlockRange()
      • getBlock()
      • getBlockCount()
      • getAnalytics()
      • getBlockchains()
      • getTransactionByID()
      • getTransactionByNode()
      • getTransactionByAddress()
      • getTransactionByDate()
      • getTransactionOutcome()
      • sendTransaction()
      • signMessage()
      • verifySignature()
      • getPublicKey()
      • stringToHex()
      • hexToString()
      • hexFix()
      • setNAGKey()
      • setNAGURL()
      • getFormattedTimestamp()
    • C++
    • C#
    • Rust
    • Arduino
Powered by GitBook
On this page
  1. API Docs
  2. Node.js

getBlock()

Retrieving a blockchain block is not a transaction; it's simply a request executed by a single node. Sometimes, it might be necessary to send the same request multiple times to obtain the right copy

Method Signature

async function getBlock(blockchain, num)

Parameters

Name
Type
Description

blockchain

string

Blockchain address in hex

blockNumber

int

The number of the block you're looking for

Example

var blockchain = "0x8a20baa40c45dc5055aeb26197c203e576ef389d9acb171bd62da11dc5ad72b2";

var block = await CircularProtocolAPI.getBlock(blockchain, 29);

Result

The result will be of type JSON.

{
    "Result": 200,
    "Response": {
        "Block": {
            "BlockID": 29,
            "Blockchain": "8a20baa40c45dc5055aeb26197c203e576ef389d9acb171bd62da11dc5ad72b2",
            "Nonce": 1530,
            "Node": "7bb5bd50729d6857942701d5673ea70ca1625f883230d8543970a452d1abe1c4",
            "PreviousBlockHash": "0002e21b0a2e2eaa8dfecb9925ab4dbbcf95c0411c0ce2b706df7ffce9ed18eb",
            "TimeStamp": "2024:04:08-21:31:10",
            "Payload": {
                "Transactions": [
                    {
                        "ID": "64583b70f57f47640b25d42df6ba99dd6956db6d9972b3c71a9400fc374e46dc",
                        "From": "e2e86db8f44ceae4750a2a055b38cb3ae326bc1c282f09e7c0cc1f585984bdf2",
                        "To": "e2e86db8f44ceae4750a2a055b38cb3ae326bc1c282f09e7c0cc1f585984bdf2",
                        "Timestamp": "2024:04:08-21:30:57",
                        "Type": "C_TYPE_ASSET",
                        "Payload": "7b22416374696f6e223a2243505f435245415445222c224e616d65223a224d544b222c224465736372697074696f6e223a2231222c2254797065223a224352435f544f4b454e5f30313233222c2255524c223a22222c2255524c54797065223a224e6f6e65222c22416d6f756e74223a22313131222c2256616c7565223a2231222c22456e61626c6553776170223a2253776170222c22526f79616c74696573223a2230227d",
                        "Nonce": "17",
                        "OSignature": "304502206113c781fc6c88b787b2fb1219bbaef2ce8559dadcdaad3af4c8ffc41b803a0c022100db0bb7b78d001291d039f23b04a2959415d1a66b08bf4d1101d73ae2fba8a589",
                        "NodeID": "7bb5bd50729d6857942701d5673ea70ca1625f883230d8543970a452d1abe1c4",
                        "GasLimit": 0.000000,
                        "NagFee": 0.000000,
                        "BroadcastFee": 0.000000,
                        "ProcessingFee": 0.000000,
                        "DeveloperFee": 0.000000,
                        "ProtocolFee": 0.000000,
                        "Instructions": 0,
                        "Status": "Rejected: Asset Already Minted"
                    }
                ],
                "BlockReward": 166.670000
            }
        },
        "Hash": "00054c1dd524137cfdad62c491a2f975a564b89523850420e239afdcd83dce21",
        "Signature": "30460221009164d45e5a78324eb7d6d473e2cecd6e3075678c58b1e2acc2401d1f5cc23d3a022100b425ec6a01023fab21765cbd6c7a6e685072f1aaa26674a14ef8b7b857b26254",
        "SelectedNode": "fc8fe5ee103dafe353c98ce90a1cb2956fd51a109512e074bd3d26a06d268e81"
    },
    "Node": "7bb5bd50729d6857942701d5673ea70ca1625f883230d8543970a452d1abe1c4"
}

Block not found:

{
    "Result": 116,
    "Response": "Block Not Found",
    "Node": "7bb5bd50729d6857942701d5673ea70ca1625f883230d8543970a452d1abe1c4"
}

Wrong blockchain address:

{
    "Result": 117,
    "Response": "Blockchain Not Found",
    "Node": "fc8fe5ee103dafe353c98ce90a1cb2956fd51a109512e074bd3d26a06d268e81"
}

Last updated 7 months ago