Class AlephHttpClient

constructor

• new AlephHttpClient(apiServer?: string): AlephHttpClient

  Parameters

  • OptionalapiServer: string

  Returns AlephHttpClient

aggregateClient

forgetClient

instanceClient

messageClient

postClient

programClient

storeClient

downloadFile

• downloadFile(file_hash: string): Promise<ArrayBuffer>

  Downloads a file from the Aleph network.

  Parameters

  • file_hash: string

    The hash of the STORE message of the file to retrieve.

  Returns Promise<ArrayBuffer>

fetchAggregate

• fetchAggregate<T>(address: string, key: string): Promise<T>

  Fetches an aggregate value from the Aleph network. Aggregates are a key-value store on the Aleph network. Aggregates are bound by address and each address can have multiple keys. By default, only the address that signs the aggregate can modify it.

  Type Parameters

  • T

  Parameters

  • address: string

    The address of the aggregate's owner
  • key: string

    The key of the aggregate to fetch

  Returns Promise<T>

fetchAggregates

• fetchAggregates(address: string, keys?: string[]): Promise<Record<string, any>>

  Fetches multiple aggregates from the Aleph network. Aggregates are a key-value store on the Aleph network. Aggregates are bound by address and each address can have multiple keys. By default, only the address that signs the aggregate can modify it.

  Parameters

  • address: string

    The address of the aggregate's owner
  • Optionalkeys: string[]

    The keys of the aggregates to fetch

  Returns Promise<Record<string, any>>

getMessage

• getMessage<T extends MessageType | "any" = "any", Content = any>(
      itemHash: string,
  ): Promise<PublishedMessage<MessageTypeMap<Content>[T]>>

  Tries to fetch a specific message from the Aleph network. Throws an error if the message is not found or forgotten.

  Type Parameters

  • T extends MessageType | "any" = "any"
  • Content = any

  Parameters

  • itemHash: string

    The hash of the message to fetch.

  Returns Promise<PublishedMessage<MessageTypeMap<Content>[T]>>

getMessageError

• getMessageError(itemHash: string): Promise<null | MessageError>

  Fetches the reason why a message has been rejected from the network. If the message has no error, returns null.

  Parameters

  • itemHash: string

    The hash of the message to fetch the error from.

  Returns Promise<null | MessageError>

getMessages

• getMessages(config: GetMessagesConfiguration): Promise<MessagesQueryResponse>

  Retrieves raw messages from the Aleph network. Similar to getPosts, but with more options.

  Parameters

  • config: GetMessagesConfiguration

    The configuration used to fetch messages.

  Returns Promise<MessagesQueryResponse>

getPost

• getPost<T = any>(config: PostGetConfiguration): Promise<PostResponse<T>>

  Fetches a POST message on the Aleph network. POST messages are used to store arbitrary JSON data on the Aleph network. They can be queried by type, channel, reference, address, tag, or hash. POSTs can be modified by amend messages. This endpoint returns the latest version of the POST.

  Type Parameters

  • T = any

  Parameters

  • config: PostGetConfiguration

    The configuration used to fetch a post message.

  Returns Promise<PostResponse<T>>

getPosts

• getPosts<T = any>(config: PostGetConfiguration): Promise<PostQueryResponse<T>>

  Fetches multiple POST messages on the Aleph network. POST messages are used to store arbitrary JSON data on the Aleph network.

  Type Parameters

  • T = any

  Parameters

  • config: PostGetConfiguration

    The configuration used to fetch a post message.

  Returns Promise<PostQueryResponse<T>>

watchMessages

• watchMessages(
      config: Omit<GetMessagesConfiguration, "page" | "pagination">,
  ): Promise<AlephSocket>

  Watches for new messages on the Aleph network. This method returns a socket that can be used to listen for new messages.

  Parameters

  • config: Omit<GetMessagesConfiguration, "page" | "pagination">

    The filters used to watch for new messages, similar to getMessages.

  Returns Promise<AlephSocket>