Class AlgorandService

Index

Constructors

Methods

discoverPublicKey discoverPublicKeyWithMetadata fetchConversations fetchMessages getBalance publishKey sendMessage sendReply transactionExists waitForConfirmation waitForIndexer

Constructors

constructor

new AlgorandService(config: AlgorandConfig): AlgorandService
Parameters
- config: AlgorandConfig
Returns AlgorandService
- Defined in src/services/algorand.service.ts:49

Methods

discoverPublicKey

discoverPublicKey(
address: string,
searchDepth?: number,
): Promise<Uint8Array<ArrayBufferLike>>
Discovers a user's encryption public key from their transaction history
Parameters
- address: string
  Algorand address to discover key for
- searchDepth: number = 200
  Maximum transactions to search (default: 200)
Returns Promise<Uint8Array<ArrayBufferLike>>
- Defined in src/services/algorand.service.ts:328

discoverPublicKeyWithMetadata

discoverPublicKeyWithMetadata(
address: string,
searchDepth?: number,
): Promise<DiscoveredKey>
Discovers a user's encryption public key with full metadata
Parameters
- address: string
  Algorand address to discover key for
- searchDepth: number = 200
  Maximum transactions to search (default: 200)
Returns Promise<DiscoveredKey>
- Defined in src/services/algorand.service.ts:339

fetchConversations

fetchConversations(
chatAccount: ChatAccount,
limit?: number,
): Promise<ConversationData[]>
Fetches all conversations for an account

Scans transaction history and groups messages by participant. Returns conversations sorted by most recent message.
Parameters
- chatAccount: ChatAccount
- limit: number = 100
Returns Promise<ConversationData[]>
- Defined in src/services/algorand.service.ts:420

fetchMessages

fetchMessages(
    chatAccount: ChatAccount,
    participantAddress: string,
    afterRound?: number,
    limit?: number,
    beforeRound?: number,
): Promise<Message[]>
Fetches messages with a participant
Parameters
- chatAccount: ChatAccount
  The user's chat account
- participantAddress: string
  Address of the conversation participant
- OptionalafterRound: number
  Only fetch messages after this round (for polling new messages)
- limit: number = 50
  Maximum number of messages to fetch
- OptionalbeforeRound: number
  Only fetch messages before this round (for pagination/loading older)
Returns Promise<Message[]>
- Defined in src/services/algorand.service.ts:229

getBalance

getBalance(address: string): Promise<bigint>
Gets account balance in microAlgos
Parameters
- address: string
Returns Promise<bigint>
- Defined in src/services/algorand.service.ts:409

publishKey

publishKey(chatAccount: ChatAccount): Promise<string>
Publishes the account's encryption key to the blockchain
Parameters
- chatAccount: ChatAccount
Returns Promise<string>
- Defined in src/services/algorand.service.ts:378

sendMessage

sendMessage(
    chatAccount: ChatAccount,
    recipientAddress: string,
    recipientPublicKey: Uint8Array,
    message: string,
    options?: SendOptions,
): Promise<SendResult>
Sends an encrypted message to a recipient
Parameters
- chatAccount: ChatAccount
  The sender's chat account
- recipientAddress: string
  Recipient's Algorand address
- recipientPublicKey: Uint8Array
  Recipient's encryption public key
- message: string
  Message content
- options: SendOptions = {}
  Send options (waitForConfirmation, waitForIndexer, etc.)
Returns Promise<SendResult>
- Defined in src/services/algorand.service.ts:73

sendReply

sendReply(
    chatAccount: ChatAccount,
    recipientAddress: string,
    recipientPublicKey: Uint8Array,
    message: string,
    replyToTxid: string,
    replyToPreview: string,
    options?: SendOptions,
): Promise<SendResult>
Sends a reply to a message
Parameters
- chatAccount: ChatAccount
  The sender's chat account
- recipientAddress: string
  Recipient's Algorand address
- recipientPublicKey: Uint8Array
  Recipient's encryption public key
- message: string
  Message content
- replyToTxid: string
  Transaction ID of the message being replied to
- replyToPreview: string
  Preview text of the message being replied to
- options: SendOptions = {}
  Send options (waitForConfirmation, waitForIndexer, etc.)
Returns Promise<SendResult>
- Defined in src/services/algorand.service.ts:151

transactionExists

transactionExists(txid: string): Promise<boolean>
Checks if a transaction exists in the indexer
Parameters
- txid: string
  Transaction ID to check
Returns Promise<boolean>
- Defined in src/services/algorand.service.ts:587

waitForConfirmation

waitForConfirmation(txid: string, timeout?: number): Promise<number>
Waits for transaction confirmation
Parameters
- txid: string
  Transaction ID to wait for
- timeout: number = 10
  Timeout in rounds (default: 10)
Returns Promise<number>
Confirmed round number
- Defined in src/services/algorand.service.ts:528

waitForIndexer

waitForIndexer(
    txid: string,
    timeout?: number,
    initialInterval?: number,
    maxInterval?: number,
    backoffMultiplier?: number,
): Promise<boolean>
Waits for a transaction to be indexed

Uses exponential backoff with jitter for efficient polling.
Parameters
- txid: string
  Transaction ID to wait for
- timeout: number = 30000
  Timeout in milliseconds (default: 30000)
- initialInterval: number = 500
  Initial polling interval (default: 500ms)
- maxInterval: number = 5000
  Maximum polling interval (default: 5000ms)
- backoffMultiplier: number = 1.5
  Backoff multiplier (default: 1.5)
Returns Promise<boolean>
true if indexed, false if timeout
- Defined in src/services/algorand.service.ts:545

Class AlgorandService

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns AlgorandService

Methods

discoverPublicKey

Parameters

Returns Promise<Uint8Array<ArrayBufferLike>>

discoverPublicKeyWithMetadata

Parameters

Returns Promise<DiscoveredKey>

fetchConversations

Parameters

Returns Promise<ConversationData[]>

fetchMessages

Parameters

Returns Promise<Message[]>

getBalance

Parameters

Returns Promise<bigint>

publishKey

Parameters

Returns Promise<string>

sendMessage

Parameters

Returns Promise<SendResult>

sendReply

Parameters

Returns Promise<SendResult>

transactionExists

Parameters

Returns Promise<boolean>

waitForConfirmation

Parameters

Returns Promise<number>

waitForIndexer

Parameters

Returns Promise<boolean>

Settings

On This Page