@trac-network/tap-reader

0.13.40-beta • Public • Published

Trac Core Reader for TAP Protocol

Trac Core Reader for TAP Protocol is a NodeJS-based application that provides decentralized access to indexed TAP Protocol data.

The reader basically represents a decentralized API to build upon Bitcoin Ordinal's TAP Protocol.

It sits on top of Holepunch (https://github.com/holepunchto), a set of libraries that enables decentralized data-storage and distribution.

You may run this reader within various restricted networks. Through holepunching, it will try to connect with its peers on the network through any means necessary, helping to maintain steady availability.

As a project/developer, you may use this reader in 3 different ways:

  • Utilizing the TracManager's native methods (see below)
  • Enabling REST Endpoints
  • Using websocket-based streaming
  • ... or all of the above combined.

If you do not intend to develop with this package but want to support the project, you may just run it in the background to help strengthen the network.

Trac Core Reader for TAP Protocol is open-source (MIT license) and in beta state, use it on your own risk as stated in the license.

How it works

The reader connects to the Trac network by subscribing to a channel to request indexing data. Currently the indexers behind this channel are not part of the entire Trac Core release yet but will be released at a later point (the actual writers).

Once a channel has been picked (in the config or upon start), the reader will try to look for peers and starts to share data, similar to how it works with for example with Bittorrent.

This data can then be used through the different APIs that this package provides for further processing within your apps.

Channel Hopping

Should indexer upgrades require a new channel to hop on, the new channel will be broadcasted through different means by the Trac project.

Ultimately, Trac will carefully roll out an entire system that allows for automated channel hopping as well as decentralized upgrade broadcasts.

The most recent channel is always pre-defined in the reader's config of this repo.

Requirements

  • Linux, Windows, MacOS
  • NodeJS 20+
  • 2-4 CPU Cores, 8GB RAM
  • 500GB SSD drive (make sure it's a good one)

Should work perfectly on Pi 3-5 and low Watts.

Installation

Either download this package using git clone or install it through npmjs (if you use npmjs, you'll need to specify your entry point yourself):

git clone https://github.com/Trac-Systems/tap-reader.git
npm i

Then CD into the package folder's root and start it using:

npm start

API Usage

Either use the reader diretly like so from within your application (please note that your app process will have exclusive access to the reader's db):

import TracManager from "./TracManager.mjs";

// Create an instance of TracManager
let tracCore = new TracManager();

// Initialize the reader for the TAP Protocol
await tracCore.initReader();

// Example: Retrieve transfer amount by inscription
let amount = await tracCore.tapProtocol.getTransferAmountByInscription('1b8e21761557bbf66c06ae3d8109764d0d8ec5d431b8291160b59ef28ffaab7ai0');

If rest is enabled, you can instead use the exposed endpoints. You may test these endpoints like this if REST is enabled in the config:

http://localhost:5099/docs

In case websockets are enabled, you can access their endpoints according to this documentation:

https://github.com/BennyTheDev/trac-tap-public-endpoint

Just swap out the given domain in that endpoint example above with your websocket url and port.

Configuration File

Defaults to ./config/default.json file, enabling websocket server if needed.

{
  "enableRest": true,
  "restPort": 5099,
  "enableWebsockets": false,
  "websocketPort": 5095,
  "websocketCORS": "*",
  "channel": "53d2e64fa7a09e9dc74fc52ee9e9feb9d59b3e2cff4a25dfb543ec3b0bf4b281",
  "channelProduction": "53d2e64fa7a09e9dc74fc52ee9e9feb9d59b3e2cff4a25dfb543ec3b0bf4b281"
}

Distributed Data Channel "53d2e64fa7a09e9dc74fc52ee9e9feb9d59b3e2cff4a25dfb543ec3b0bf4b281" is the currently active one for TAP Protocol.

Important note

Installing with npm i triggers the postinstall script, which patches hypercore library. This is yet necessary before the stable release of the reader.

"scripts": {
    "postinstall": "patch-package"
},

Trac Core Manager API

initReader([server], [client], [rangeStart], [rangeEnd])Promise.<void>

Initializes the reader for the TAP Protocol, setting up corestore and hyperswarm. Also configures the Hyperbee database and, optionally, a websocket and REST server.

initHyperswarm(server, client)Promise.<void>

Initializes a Hyperswarm network connection for data synchronization.

initReader([server], [client], [rangeStart], [rangeEnd]) ⇒ Promise.<void>

Initializes the reader for the TAP Protocol, setting up corestore and hyperswarm. Also configures the Hyperbee database and, optionally, a websocket server.

Kind: global function
Returns: Promise.<void> - A promise that resolves when initialization is complete.

Param Type Default Description
[server] boolean true Whether to start as a server in the Hyperswarm network.
[client] boolean true Whether to start as a client in the Hyperswarm network.
[rangeStart] number -1 The starting index for range-based data download.
[rangeEnd] number -1 The ending index for range-based data download.

initHyperswarm(server, client) ⇒ Promise.<void>

Initializes a Hyperswarm network connection for data synchronization.

Kind: global function
Returns: Promise.<void> - A promise that resolves when the network is initialized.

Param Type Description
server boolean Indicates if this instance should act as a server.
client boolean Indicates if this instance should act as a client.

Tap Protocol API

getTransferAmountByInscription(inscription_id)Promise.<(number|null)>

Retrieves the transfer amount for a given inscription ID.

getDeploymentsLength()Promise.<number>

Gets the total number of deployments.

getDeployments([offset], [max])Promise.<Array>

Retrieves a list of deployments.

getDeployment(ticker)Promise.<(Object|null)>

Retrieves details of a specific deployment based on its ticker.

getMintTokensLeft(ticker)Promise.<(number|null)>

Gets the remaining number of tokens that can be minted for a given ticker.

getBalance(address, ticker)Promise.<(number|null)>

Retrieves the balance of a specific address for a given ticker.

getTransferable(address, ticker)Promise.<(number|null)>

Retrieves the transferable amount for a specific address and ticker.

getHoldersLength(ticker)Promise.<number>

Gets the total number of holders for a given ticker.

getHolders(ticker, [offset], [max])Promise.<Array>

Retrieves a list of holders for a specific ticker.

getAccountTokensLength(address)Promise.<number>

Gets the total number of tokens held by a specific address.

getAccountTokens(address, [offset], [max])Promise.<Array>

Retrieves a list of tokens held by a specific address.

getDmtElementsListLength()Promise.<number>

Gets the total number of DMT elements.

getDmtElementsList([offset], [max])Promise.<Array>

Retrieves a list of DMT elements.

getAccountMintListLength(address, ticker)Promise.<number>

Gets the total number of mints performed by a specific address for a given ticker.

getAccountMintList(address, ticker)Promise.<number>

Gets the total number of mints performed by a specific address for a given ticker.

getTickerMintListLength(address, ticker)Promise.<number>

Gets the total number of mints performed by a specific address for a given ticker.

getTickerMintList(address, ticker, [offset], [max])Promise.<Array>

Retrieves a list of mint records for a specific address and ticker.

getMintListLength(ticker)Promise.<number>

Gets the total number of mints for a given ticker.

getMintList([offset], [max])Promise.<Array>

Retrieves a list of all mint records across all tickers.

getTrade(inscription_id)Promise.<(Object|null)>

Retrieves details of a specific trade based on its inscription ID.

getAccountTradesListLength(address, ticker)Promise.<number>

Gets the total number of trades for a specific address and ticker.

getAccountTradesList(address, ticker, [offset], [max])Promise.<Array>

Retrieves a list of trades for a specific address and ticker.

getAuthCancelled(inscription_id)Promise.<boolean>

Checks if a given token-auth inscription has been cancelled.

getAuthHashExists(hash)Promise.<boolean>

Checks if a given hash exists in the token-auth system.

getRedeemListLength()Promise.<number>

Gets the total number of redeems across all tokens.

getRedeemList([offset], [max])Promise.<Array>

Retrieves a list of all redeem records across all tokens.

getAccountRedeemListLength(address)Promise.<number>

Gets the total number of redeems performed by a specific address.

getAccountRedeemList(address, [offset], [max])Promise.<Array>

Retrieves a list of redeem records for a specific address.

getAccountAuthListLength(address)Promise.<number>

Gets the total number of auth records for a specific address.

getAccountAuthList(address, [offset], [max])Promise.<Array>

Retrieves a list of auth records for a specific address.

getAuthListLength()Promise.<number>

Gets the total number of auth records across all addresses.

getAuthList([offset], [max])Promise.<Array>

Retrieves a list of all auth records across all addresses.

getTickerTradesListLength(ticker)Promise.<number>

Gets the total number of trades for a specific ticker.

getTickerTradesList(ticker, [offset], [max])Promise.<Array>

Retrieves a list of trades for a specific ticker.

getTradesListLength()Promise.<number>

Gets the total number of trades across all tickers.

getTradesList([offset], [max])Promise.<Array>

Retrieves a list of all trade records across all tickers.

getAccountTransferListLength(address, ticker)Promise.<number>

Gets the total number of transfers for a specific address and ticker.

getAccountTransferList(address, ticker, [offset], [max])Promise.<Array>

Retrieves a list of transfer records for a specific address and ticker.

getTickerTransferListLength(ticker)Promise.<number>

Gets the total number of transfers for a given ticker.

getTickerTransferList(ticker, [offset], [max])Promise.<Array>

Retrieves a list of transfer records for a specific ticker.

getTransferListLength()Promise.<number>

Gets the total number of transfers across all tickers.

getTransferList([offset], [max])Promise.<Array>

Retrieves a list of all transfer records across all tickers.

getAccountSentListLength(address, ticker)Promise.<number>

Gets the total number of sent transactions for a specific address and ticker.

getAccountSentList(address, ticker, [offset], [max])Promise.<Array>

Retrieves a list of sent transaction records for a specific address and ticker.

getAccountReceiveTradesFilledListLength(address, ticker)Promise.<number>

Gets the total number of received trades filled for a specific address and ticker.

getAccountReceiveTradesFilledList(address, ticker, [offset], [max])Promise.<Array>

Retrieves a list of received trades filled for a specific address and ticker.

getAccountTradesFilledListLength(address, ticker)Promise.<number>

Gets the total number of trades filled for a specific address and ticker.

getAccountTradesFilledList(address, ticker, [offset], [max])Promise.<Array>

Retrieves a list of trades filled for a specific address and ticker.

getTickerTradesFilledListLength(ticker)Promise.<number>

Gets the total number of trades filled for a specific ticker.

getTickerTradesFilledList(ticker, [offset], [max])Promise.<Array>

Retrieves a list of filled trade records for a specific ticker.

getTradesFilledListLength()Promise.<number>

Gets the total number of filled trades across all tickers.

getTradesFilledList([offset], [max])Promise.<(Array|Object)>

Asynchronously retrieves a list of trades that have been filled.

getAccountReceiveListLength(address, ticker)Promise.<number>

Gets the length of the account receive list for a given address and ticker.

getAccountReceiveList(address, ticker, [offset], [max])Promise.<(Array|Object)>

Retrieves a list of received transactions for a specific account and ticker.

getTickerSentListLength(ticker)Promise.<number>

Gets the length of the sent list for a specific ticker.

getTickerSentList(ticker, [offset], [max])Promise.<(Array|Object)>

Retrieves a list of sent transactions for a specific ticker.

getSentListLength()Promise.<number>

Gets the total length of the sent transactions list.

getSentList([offset], [max])Promise.<(Array|Object)>

Retrieves the list of all sent transactions.

getAccumulator(inscription)Promise.<(Object|null)>

Retrieves the accumulator object for a given inscription.

getAccountAccumulatorListLength(address)Promise.<number>

Gets the total number of accumulator entries for a specific Bitcoin address.

getAccountAccumulatorList(address, [offset], [max])Promise.<(Array|Object)>

Retrieves a list of accumulator records for a specified address.

getAccumulatorListLength()Promise.<number>

Retrieves the total length of the accumulator list.

getAccumulatorList([offset], [max])Promise.<(Array|Object)>

Retrieves a list of accumulators.

getListRecords(length_key, iterator_key, offset, max, return_json)Promise.<(Array|Object|string)>

Asynchronously retrieves a batch of list records based on specified keys and limits.

getLength(length_key)Promise.<number>

Gets the length of a list based on a specified key.

getTransferAmountByInscription(inscription_id) ⇒ Promise.<(number|null)>

Retrieves the transfer amount for a given inscription ID.

Kind: global function
Returns: Promise.<(number|null)> - The transfer amount or null if not found.

Param Type Description
inscription_id string The ID of the inscription to query.

getDeploymentsLength() ⇒ Promise.<number>

Gets the total number of deployments.

Kind: global function
Returns: Promise.<number> - The total number of deployments.

getDeployments([offset], [max]) ⇒ Promise.<Array>

Retrieves a list of deployments.

Kind: global function
Returns: Promise.<Array> - An array of deployment records.

Param Type Default Description
[offset] number 0 The starting index for retrieving deployments.
[max] number 500 The maximum number of deployments to retrieve.

getDeployment(ticker) ⇒ Promise.<(Object|null)>

Retrieves details of a specific deployment based on its ticker.

Kind: global function
Returns: Promise.<(Object|null)> - Deployment details or null if not found.

Param Type Description
ticker string The ticker of the deployment to retrieve.

getMintTokensLeft(ticker) ⇒ Promise.<(number|null)>

Gets the remaining number of tokens that can be minted for a given ticker.

Kind: global function
Returns: Promise.<(number|null)> - The number of tokens left to mint or null if not available.

Param Type Description
ticker string The ticker for which to retrieve the remaining mintable tokens.

getBalance(address, ticker) ⇒ Promise.<(number|null)>

Retrieves the balance of a specific address for a given ticker.

Kind: global function
Returns: Promise.<(number|null)> - The balance of the address or null if not found.

Param Type Description
address string The address for which to retrieve the balance.
ticker string The ticker of the token.

getTransferable(address, ticker) ⇒ Promise.<(number|null)>

Retrieves the transferable amount for a specific address and ticker.

Kind: global function
Returns: Promise.<(number|null)> - The transferable amount or null if not found.

Param Type Description
address string The address for which to retrieve the transferable amount.
ticker string The ticker of the token.

getHoldersLength(ticker) ⇒ Promise.<number>

Gets the total number of holders for a given ticker.

Kind: global function
Returns: Promise.<number> - The number of holders for the specified ticker.

Param Type Description
ticker string The ticker for which to retrieve the number of holders.

getHolders(ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of holders for a specific ticker.

Kind: global function
Returns: Promise.<Array> - An array of holder records.

Param Type Default Description
ticker string The ticker for which to retrieve holders.
[offset] number 0 The starting index for retrieving holders.
[max] number 500 The maximum number of holders to retrieve.

getAccountTokensLength(address) ⇒ Promise.<number>

Gets the total number of tokens held by a specific address.

Kind: global function
Returns: Promise.<number> - The number of tokens held by the specified address.

Param Type Description
address string The address for which to retrieve the token count.

getAccountTokens(address, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of tokens held by a specific address.

Kind: global function
Returns: Promise.<Array> - An array of token tickers.

Param Type Default Description
address string The address for which to retrieve tokens.
[offset] number 0 The starting index for retrieving tokens.
[max] number 500 The maximum number of tokens to retrieve.

getDmtElementsListLength() ⇒ Promise.<number>

Gets the total number of DMT elements.

Kind: global function
Returns: Promise.<number> - The total number of DMT elements.

getDmtElementsList([offset], [max]) ⇒ Promise.<Array>

Retrieves a list of DMT elements.

Kind: global function
Returns: Promise.<Array> - An array of DMT element records.

Param Type Default Description
[offset] number 0 The starting index for retrieving DMT elements.
[max] number 500 The maximum number of DMT elements to retrieve.

getAccountMintListLength(address, ticker) ⇒ Promise.<number>

Gets the total number of mints performed by a specific address for a given ticker.

Kind: global function
Returns: Promise.<number> - The number of mints performed by the address for the specified ticker.

Param Type Description
address string The address for which to retrieve the mint count.
ticker string The ticker of the token.

getAccountMintList(address, ticker) ⇒ Promise.<number>

Gets the total number of mints performed by a specific address for a given ticker.

Kind: global function
Returns: Promise.<number> - The number of mints performed by the address for the specified ticker.

Param Type Description
address string The address for which to retrieve the mint count.
ticker string The ticker of the token.

getTickerMintListLength(address, ticker) ⇒ Promise.<number>

Gets the total number of mints performed by a specific address for a given ticker.

Kind: global function
Returns: Promise.<number> - The number of mints performed by the address for the specified ticker.

Param Type Description
address string The address for which to retrieve the mint count.
ticker string The ticker of the token.

getTickerMintList(address, ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of mint records for a specific address and ticker.

Kind: global function
Returns: Promise.<Array> - An array of mint records.

Param Type Default Description
address string The address for which to retrieve mint records.
ticker string The ticker of the token.
[offset] number 0 The starting index for retrieving mint records.
[max] number 500 The maximum number of mint records to retrieve.

getMintListLength(ticker) ⇒ Promise.<number>

Gets the total number of mints for a given ticker.

Kind: global function
Returns: Promise.<number> - The number of mints for the specified ticker.

Param Type Description
ticker string The ticker for which to retrieve the mint count.

getMintList([offset], [max]) ⇒ Promise.<Array>

Retrieves a list of all mint records across all tickers.

Kind: global function
Returns: Promise.<Array> - An array of mint records.

Param Type Default Description
[offset] number 0 The starting index for retrieving mint records.
[max] number 500 The maximum number of mint records to retrieve.

getTrade(inscription_id) ⇒ Promise.<(Object|null)>

Retrieves details of a specific trade based on its inscription ID.

Kind: global function
Returns: Promise.<(Object|null)> - Trade details or null if not found.

Param Type Description
inscription_id string The ID of the trade inscription to query.

getAccountTradesListLength(address, ticker) ⇒ Promise.<number>

Gets the total number of trades for a specific address and ticker.

Kind: global function
Returns: Promise.<number> - The number of trades for the specified address and ticker.

Param Type Description
address string The address for which to retrieve the trade count.
ticker string The ticker of the token.

getAccountTradesList(address, ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of trades for a specific address and ticker.

Kind: global function
Returns: Promise.<Array> - An array of trade records.

Param Type Default Description
address string The address for which to retrieve trades.
ticker string The ticker of the token.
[offset] number 0 The starting index for retrieving trades.
[max] number 500 The maximum number of trades to retrieve.

getAuthCancelled(inscription_id) ⇒ Promise.<boolean>

Checks if a given token-auth inscription has been cancelled.

Kind: global function
Returns: Promise.<boolean> - True if the inscription is cancelled, false otherwise.

Param Type Description
inscription_id string The ID of the token-auth inscription to check.

getAuthHashExists(hash) ⇒ Promise.<boolean>

Checks if a given hash exists in the token-auth system.

Kind: global function
Returns: Promise.<boolean> - True if the hash exists, false otherwise.

Param Type Description
hash string The hash to check for existence.

getRedeemListLength() ⇒ Promise.<number>

Gets the total number of redeems across all tokens.

Kind: global function
Returns: Promise.<number> - The total number of redeems.

getRedeemList([offset], [max]) ⇒ Promise.<Array>

Retrieves a list of all redeem records across all tokens.

Kind: global function
Returns: Promise.<Array> - An array of redeem records.

Param Type Default Description
[offset] number 0 The starting index for retrieving redeem records.
[max] number 500 The maximum number of redeem records to retrieve.

getAccountRedeemListLength(address) ⇒ Promise.<number>

Gets the total number of redeems performed by a specific address.

Kind: global function
Returns: Promise.<number> - The number of redeems performed by the specified address.

Param Type Description
address string The address for which to retrieve the redeem count.

getAccountRedeemList(address, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of redeem records for a specific address.

Kind: global function
Returns: Promise.<Array> - An array of redeem records for the specified address.

Param Type Default Description
address string The address for which to retrieve redeem records.
[offset] number 0 The starting index for retrieving redeem records.
[max] number 500 The maximum number of redeem records to retrieve.

getAccountAuthListLength(address) ⇒ Promise.<number>

Gets the total number of auth records for a specific address.

Kind: global function
Returns: Promise.<number> - The number of auth records for the specified address.

Param Type Description
address string The address for which to retrieve the auth count.

getAccountAuthList(address, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of auth records for a specific address.

Kind: global function
Returns: Promise.<Array> - An array of auth records for the specified address.

Param Type Default Description
address string The address for which to retrieve auth records.
[offset] number 0 The starting index for retrieving auth records.
[max] number 500 The maximum number of auth records to retrieve.

getAuthListLength() ⇒ Promise.<number>

Gets the total number of auth records across all addresses.

Kind: global function
Returns: Promise.<number> - The total number of auth records.

getAuthList([offset], [max]) ⇒ Promise.<Array>

Retrieves a list of all auth records across all addresses.

Kind: global function
Returns: Promise.<Array> - An array of auth records.

Param Type Default Description
[offset] number 0 The starting index for retrieving auth records.
[max] number 500 The maximum number of auth records to retrieve.

getTickerTradesListLength(ticker) ⇒ Promise.<number>

Gets the total number of trades for a specific ticker.

Kind: global function
Returns: Promise.<number> - The number of trades for the specified ticker.

Param Type Description
ticker string The ticker for which to retrieve the trade count.

getTickerTradesList(ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of trades for a specific ticker.

Kind: global function
Returns: Promise.<Array> - An array of trade records for the specified ticker.

Param Type Default Description
ticker string The ticker for which to retrieve trades.
[offset] number 0 The starting index for retrieving trades.
[max] number 500 The maximum number of trades to retrieve.

getTradesListLength() ⇒ Promise.<number>

Gets the total number of trades across all tickers.

Kind: global function
Returns: Promise.<number> - The total number of trades.

getTradesList([offset], [max]) ⇒ Promise.<Array>

Retrieves a list of all trade records across all tickers.

Kind: global function
Returns: Promise.<Array> - An array of all trade records.

Param Type Default Description
[offset] number 0 The starting index for retrieving trade records.
[max] number 500 The maximum number of trade records to retrieve.

getAccountTransferListLength(address, ticker) ⇒ Promise.<number>

Gets the total number of transfers for a specific address and ticker.

Kind: global function
Returns: Promise.<number> - The number of transfers for the specified address and ticker.

Param Type Description
address string The address for which to retrieve the transfer count.
ticker string The ticker of the token.

getAccountTransferList(address, ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of transfer records for a specific address and ticker.

Kind: global function
Returns: Promise.<Array> - An array of transfer records for the specified address and ticker.

Param Type Default Description
address string The address for which to retrieve transfer records.
ticker string The ticker of the token.
[offset] number 0 The starting index for retrieving transfer records.
[max] number 500 The maximum number of transfer records to retrieve.

getTickerTransferListLength(ticker) ⇒ Promise.<number>

Gets the total number of transfers for a given ticker.

Kind: global function
Returns: Promise.<number> - The number of transfers for the specified ticker.

Param Type Description
ticker string The ticker for which to retrieve the transfer count.

getTickerTransferList(ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of transfer records for a specific ticker.

Kind: global function
Returns: Promise.<Array> - An array of transfer records for the specified ticker.

Param Type Default Description
ticker string The ticker for which to retrieve transfer records.
[offset] number 0 The starting index for retrieving transfer records.
[max] number 500 The maximum number of transfer records to retrieve.

getTransferListLength() ⇒ Promise.<number>

Gets the total number of transfers across all tickers.

Kind: global function
Returns: Promise.<number> - The total number of transfers.

getTransferList([offset], [max]) ⇒ Promise.<Array>

Retrieves a list of all transfer records across all tickers.

Kind: global function
Returns: Promise.<Array> - An array of all transfer records.

Param Type Default Description
[offset] number 0 The starting index for retrieving transfer records.
[max] number 500 The maximum number of transfer records to retrieve.

getAccountSentListLength(address, ticker) ⇒ Promise.<number>

Gets the total number of sent transactions for a specific address and ticker.

Kind: global function
Returns: Promise.<number> - The number of sent transactions for the specified address and ticker.

Param Type Description
address string The address for which to retrieve the sent count.
ticker string The ticker of the token.

getAccountSentList(address, ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of sent transaction records for a specific address and ticker.

Kind: global function
Returns: Promise.<Array> - An array of sent transaction records for the specified address and ticker.

Param Type Default Description
address string The address for which to retrieve sent transaction records.
ticker string The ticker of the token.
[offset] number 0 The starting index for retrieving sent transaction records.
[max] number 500 The maximum number of sent transaction records to retrieve.

getAccountReceiveTradesFilledListLength(address, ticker) ⇒ Promise.<number>

Gets the total number of received trades filled for a specific address and ticker.

Kind: global function
Returns: Promise.<number> - The number of received trades filled for the specified address and ticker.

Param Type Description
address string The address for which to retrieve the count.
ticker string The ticker of the token.

getAccountReceiveTradesFilledList(address, ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of received trades filled for a specific address and ticker.

Kind: global function
Returns: Promise.<Array> - An array of received trades filled records for the specified address and ticker.

Param Type Default Description
address string The address for which to retrieve records.
ticker string The ticker of the token.
[offset] number 0 The starting index for retrieving records.
[max] number 500 The maximum number of records to retrieve.

getAccountTradesFilledListLength(address, ticker) ⇒ Promise.<number>

Gets the total number of trades filled for a specific address and ticker.

Kind: global function
Returns: Promise.<number> - The number of trades filled for the specified address and ticker.

Param Type Description
address string The address for which to retrieve the trade count.
ticker string The ticker of the token.

getAccountTradesFilledList(address, ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of trades filled for a specific address and ticker.

Kind: global function
Returns: Promise.<Array> - An array of filled trade records for the specified address and ticker.

Param Type Default Description
address string The address for which to retrieve filled trades.
ticker string The ticker of the token.
[offset] number 0 The starting index for retrieving filled trades.
[max] number 500 The maximum number of filled trades to retrieve.

getTickerTradesFilledListLength(ticker) ⇒ Promise.<number>

Gets the total number of trades filled for a specific ticker.

Kind: global function
Returns: Promise.<number> - The number of filled trades for the specified ticker.

Param Type Description
ticker string The ticker for which to retrieve the filled trade count.

getTickerTradesFilledList(ticker, [offset], [max]) ⇒ Promise.<Array>

Retrieves a list of filled trade records for a specific ticker.

Kind: global function
Returns: Promise.<Array> - An array of filled trade records for the specified ticker.

Param Type Default Description
ticker string The ticker for which to retrieve filled trades.
[offset] number 0 The starting index for retrieving filled trade records.
[max] number 500 The maximum number of filled trade records to retrieve.

getTradesFilledListLength() ⇒ Promise.<number>

Gets the total number of filled trades across all tickers.

Kind: global function
Returns: Promise.<number> - The total number of filled trades.

getTradesFilledList([offset], [max]) ⇒ Promise.<(Array|Object)>

Asynchronously retrieves a list of trades that have been filled.

Kind: global function
Returns: Promise.<(Array|Object)> - A promise that resolves to an array of trade records.

Param Type Default Description
[offset] number 0 The starting index for retrieving records.
[max] number 500 The maximum number of records to retrieve.

getAccountReceiveListLength(address, ticker) ⇒ Promise.<number>

Gets the length of the account receive list for a given address and ticker.

Kind: global function
Returns: Promise.<number> - A promise that resolves to the length of the receive list.

Param Type Description
address string The Bitcoin address to query.
ticker string The ticker symbol for the token.

getAccountReceiveList(address, ticker, [offset], [max]) ⇒ Promise.<(Array|Object)>

Retrieves a list of received transactions for a specific account and ticker.

Kind: global function
Returns: Promise.<(Array|Object)> - A promise that resolves to an array of receive transaction records.

Param Type Default Description
address string The Bitcoin address to query.
ticker string The ticker symbol for the token.
[offset] number 0 The starting index for retrieving records.
[max] number 500 The maximum number of records to retrieve.

getTickerSentListLength(ticker) ⇒ Promise.<number>

Gets the length of the sent list for a specific ticker.

Kind: global function
Returns: Promise.<number> - A promise that resolves to the length of the sent list.

Param Type Description
ticker string The ticker symbol for the token.

getTickerSentList(ticker, [offset], [max]) ⇒ Promise.<(Array|Object)>

Retrieves a list of sent transactions for a specific ticker.

Kind: global function
Returns: Promise.<(Array|Object)> - A promise that resolves to an array of sent transaction records.

Param Type Default Description
ticker string The ticker symbol for the token.
[offset] number 0 The starting index for retrieving records.
[max] number 500 The maximum number of records to retrieve.

getSentListLength() ⇒ Promise.<number>

Gets the total length of the sent transactions list.

Kind: global function
Returns: Promise.<number> - A promise that resolves to the total length of the sent list.

getSentList([offset], [max]) ⇒ Promise.<(Array|Object)>

Retrieves the list of all sent transactions.

Kind: global function
Returns: Promise.<(Array|Object)> - A promise that resolves to an array of all sent transaction records.

Param Type Default Description
[offset] number 0 The starting index for retrieving records.
[max] number 500 The maximum number of records to retrieve.

getAccumulator(inscription) ⇒ Promise.<(Object|null)>

Retrieves the accumulator object for a given inscription.

Kind: global function
Returns: Promise.<(Object|null)> - A promise that resolves to the accumulator object, or null if not found.

Param Type Description
inscription string The inscription identifier.

getAccountAccumulatorListLength(address) ⇒ Promise.<number>

Gets the total number of accumulator entries for a specific Bitcoin address.

Kind: global function
Returns: Promise.<number> - A promise that resolves to the number of accumulator entries.

Param Type Description
address string The Bitcoin address to query.

getAccountAccumulatorList(address, [offset], [max]) ⇒ Promise.<(Array|Object)>

Retrieves a list of accumulator records for a specified address.

Kind: global function
Returns: Promise.<(Array|Object)> - A promise that resolves to an array of accumulator records. If an error occurs, returns the error object.

Param Type Default Description
address string The Bitcoin address to query.
[offset] number 0 The starting index for retrieving records.
[max] number 500 The maximum number of records to retrieve.

getAccumulatorListLength() ⇒ Promise.<number>

Retrieves the total length of the accumulator list.

Kind: global function
Returns: Promise.<number> - A promise that resolves to the total length of the accumulator list.

getAccumulatorList([offset], [max]) ⇒ Promise.<(Array|Object)>

Retrieves a list of accumulators.

Kind: global function
Returns: Promise.<(Array|Object)> - A promise that resolves to an array of accumulator records. If an error occurs, returns the error object.

Param Type Default Description
[offset] number 0 The starting index for retrieving accumulator records.
[max] number 500 The maximum number of accumulators to retrieve.

getListRecords(length_key, iterator_key, offset, max, return_json) ⇒ Promise.<(Array|Object|string)>

Asynchronously retrieves a batch of list records based on specified keys and limits.

Kind: global function
Returns: Promise.<(Array|Object|string)> - A promise that resolves to an array of records, an error object, or a string message in case of invalid parameters.

Param Type Description
length_key string The key to determine the length of the list.
iterator_key string The key used for iterating over the list.
offset number The starting index for retrieving records.
max number The maximum number of records to retrieve.
return_json boolean Whether to return the records as JSON objects.

getLength(length_key) ⇒ Promise.<number>

Gets the length of a list based on a specified key.

Kind: global function
Returns: Promise.<number> - A promise that resolves to the length of the list.

Param Type Description
length_key string The key to determine the length of the list.

Package Sidebar

Install

npm i @trac-network/tap-reader

Weekly Downloads

1

Version

0.13.40-beta

License

MIT

Unpacked Size

252 kB

Total Files

14

Last publish

Collaborators

  • trac-systems
  • elixtrac