nxt.getMessages: EXPERIMENTAL - Get a set of messages from the NXT blockchain

Description Usage Arguments Value Author(s) See Also

Description

This function queries the NXT blockchain and returns a set of messages meeting a certain set of criteria. Requires attachment info be stored in a special schema in the H2 database, which is not yet in the standard NXT release. See here.

Usage

1
2
3
4
nxt.getMessages(con, sender.ids = NULL, recipient.ids = NULL,
  start.ts = NULL, end.ts = NULL, start.height = NULL,
  end.height = NULL, message.to.char = TRUE, ts.from.db = TRUE,
  id.from.db = TRUE)

Arguments

con

Connection object to the NXT H2 database.

sender.ids

A vector with NXT IDs of senders of the messages.

recipient.ids

A vector with NXT IDs of recipients of messages.

start.ts

Minimum timestamp of transaction. Can be in seconds since genesis or POSIXct format.

end.ts

Maximum timestamp of transaction. Can be in seconds since genesis or POSIXct format.

start.height

Minimum height of block corresponding to transaction.

end.height

Maximum height of block corresponding to transaction.

message.to.char

Boolean. If TRUE (default), will attempt to convert message from a hex string to a normal character string.

ts.from.db

Boolean. If TRUE (default), convert timestamps to POSIXct, otherwise keep them in seconds since genesis block.

id.from.db

Boolean. If TRUE (default), output block and account IDs in canonical NXT format, otherwise leave in signed long format.

Value

A data.frame containing transaction id, sended id, recipient id, blockchain height, transaction timestamp, message as a hex string and possibly message as a character vector (if message.to.char=TRUE).

Author(s)

David M. Kaplan [email protected]

See Also

nxt.dbConnect, nxt.convert.ts, nxt.convert.id, HexStringToRaw


dmkaplan2000/Rxt documentation built on May 15, 2019, 9:35 a.m.