# Using default APIs

@hiveio/wax provides an object-oriented interface for making and verifying API requests and responses. Hive API requests are arranged into various API categories:

account_by_key_api: API requests related to reading account keys.
block_api: API requests for fetching blockchain blocks.
database_api: API requests for reading Hive state information.
network_broadcast_api: API requests for broadcasting transactions to write to the blockchain.
rc_api: API requests for reading/analyzing resource contrstraings (rc).

# Regular Usage

Wax uses class-validator and class-transformer for requests and responses validation. It may throw if a server responds with an unexpected value.

The syntax for making an API call is:

chainInstance.api[apiType][apiMethod](dataToSend);

# Fetching the first blockchain block

Using chain interface, you can retrieve a blockchain block. In the example below we use block_api as apiType and get_block as apiMethod:

Test it yourself: src/typescript/api/default-api/retrieve-block.ts

import { createHiveChain } from '@hiveio/wax';

const chain = await createHiveChain();

const output = await chain.api.block_api.get_block({ block_num: 1 });

console.log(output);

{
  block: {
    block_id: '0000000109833ce528d5bbfb3f6225b39ee10086',
    extensions: [],
    previous: '0000000000000000000000000000000000000000',
    signing_key: 'STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX',
    timestamp: '2016-03-24T16:05:00',
    transaction_ids: [],
    transaction_merkle_root: '0000000000000000000000000000000000000000',
    transactions: [],
    witness: 'initminer',
    witness_signature: '204f8ad56a8f5cf722a02b035a61b500aa59b9519b2c33c77a80c0a714680a5a5a7a340d909d19996613c5e4ae92146b9add8a7a663eef37d837ef881477313043'
  }
}

# Changing Wax root's API server (endpointUrl)

Sometimes you may want to call database_api from a local API endpoint, while get_block from some of the well-known API endpoint URLs. You can achieve it using setEndpointUrl (or by directly setting the endpointUrl property as in the example below):

Test it yourself: src/typescript/api/default-api/set-endpoint.ts

import { createHiveChain } from '@hiveio/wax';

const chain = await createHiveChain();

chain.api.database_api.endpointUrl = "https://best.honey.provider"; // Custom endpoint URL for database_api

chain.endpointUrl = "https://api.hive.blog"; // This is default for all APIs

console.log(chain.api.database_api.endpointUrl);

https://best.honey.provider